sharp_power —电源模块

class sharp_power.Backlight

基类：object

√ 背光板模块类

• 参数

• 返回

• 注意

  需要实例化

• raise : 无

ALL_En_Flag = 1

BackLight_ILedAlarmValue(ch, iMax, iMin)

设置ILED背光电流报警值

• 参数

  • ch: 背光通道

  • iMax: 电流上限值,以mA为单位,精度0.1mA若不监控此项需赋值为 LIMITNULL

  • iMin: 电流下限值,以mA为单位,精度0.1mA若不监控此项需赋值为 LIMITNULL

• 返回

  • >=0: 设置成功

  • <0: 设置失败

• raise : 无

BackLight_StartAlarm()

开启背光板报警功能。设置通道限定值後，需调用此函数才能开启报警功能

• 参数

• 返回

  • =0 成功

  • <0 失败

• raise : 无

BackLight_StopAlarm()

关闭背光板报警功能

• 参数

  • group :选择板子 范围 POWER_1 POWER_2 POWER_3 POWER_4（可或）

• 返回

  • =0 成功

  • <0 失败

• raise : 无

BackLight_SumILedAlarmValue(iMax, iMin)

设置ILED总的背光电流报警值

• 参数

  • iMax: 电流上限值,以mA为单位,精度0.1mA若不监控此项需赋值为 LIMITNULL

  • iMin: 电流下限值,以mA为单位,精度0.1mA若不监控此项需赋值为 LIMITNULL

• 返回

  • >=0: 设置成功

  • <0: 设置失败

• raise : 无

BackLight_SumVLedAlarmValue(vMax, vMin)

设置VLED总的背光电压报警值

• 参数

  • vMax: 电压上限值,单位V,精度0.1V,若不监控此项需赋值为 LIMITNULL

  • vMin: 电压下限值,单位V,精度0.1V,若不监控此项需赋值为 LIMITNULL

• 返回

  • >=0: 设置成功

  • <0: 设置失败

• raise : 无

BackLight_VLedAlarmValue(ch, vMax, vMin)

设置VLED背光电压报警值

• 参数

  • ch: 背光通道

  • vMax: 电压上限值,单位V,精度0.1V,若不监控此项需赋值为 LIMITNULL

  • vMin: 电压下限值,单位V,精度0.1V,若不监控此项需赋值为 LIMITNULL

• 返回

  • >=0: 设置成功

  • <0: 设置失败

• raise : 无

Backlight_EN = 0

Backlight_ID = 0

Board_EN = 0

Board_EN_list = []

LED_Clear_AlarmValue()

清除背光板所有卡控值 * 参数

• group :选择板子 范围 POWER_1 POWER_2 POWER_3 POWER_4（可或）

• 返回

  • =0 成功

  • <0 失败

• raise : 无

LED_ExPWMOff()

关闭 使用外部PWM控制背光电流的功能(默认为关闭)

• 参数

• 返回

  • =0 成功

  • <0 失败

• raise : 无

LED_ExPWMOn()

开启 使用外部PWM控制背光电流(默认为关闭)

• 参数

*返回

• =0 成功

• <0 失败

• raise : 无

LED_GetVersion()

获取背光板的软硬件版本号

• 参数

  • group : 选择板子 范围 POWER_1 , POWER_2 , POWER_3 , POWER_4 （不可或）

• 返回

  • =0 成功

  • <0 失败

• raise : 无

LED_Get_Board_Type()

获取背光板类型 (用户不需要调用)

• 参数

  • group :选择板子 范围 POWER_1 POWER_2 POWER_3 POWER_4

• 返回

  • =0 - 设置成功

  • <0 - 失败

• raise : 无

LED_OFF()

关灭LED背光

• 参数

• 返回

  • >=0: 关灭成功

  • <0: 关灭失败

• raise : 无

LED_ON(chs=1)

开启LED背光,背光通道设置电流後要调用此函数才会通电

• 参数

  • chs: 0x01 LED1, 0x02 LED2, 0x04 LED3, …可或

• 返回

  • 0-成功

  • <0-失败

  • -49: 断路

  • -17: 阳极短地

  • -33: 阳极短高

  • -65: 阴极短地

• raise : 无

LED_SetI(ledx, mA)

设置某LED通道电流

• 参数

  • ledx: LED通道号 1~12

  • mA: 电流值,单位mA,精度0.1mA

• 返回

  • >=0: 设置成功

  • <0: 设置失败

• raise : 无

LED_SetVoltage(backVol)

直接设置LED背光电压,LED+对GND的电压,设置为0是自动升压

• 参数

  • backVol: 电压值,单位V

• 返回

  • >=0: 设置成功

  • <0: 设置失败

• raise : 无

POWER_GetLEDMea()

回读LED所有通道的测量值,报警状态

• 参数

• 返回

  • <0 读取失败

  • >=0 LEDMeasure :LED所有通道的测量值,报警状态,具体请看 LEDMeasureTypeDef 类定义

• raise : 无

Set_blHorL(value)

设置需要高功率的高电压背光或者低功率的低电压背光

• 参数

  • value: 1: 为切换到设置高功率的高电压背光, 0: 为切换到设置低功率的低电压背光

• 返回

  • >=0: 设置成功

  • <0: 设置失败

• raise : 无

restart_BackLight()

软件重启背光板

• 参数

  • group :选择板子 范围 POWER_1 POWER_2 POWER_3 POWER_4（可或）

*返回

• =0 成功

• <0 失败

• raise : 无

class sharp_power.LEDMeasureTypeDef

基类：object

LED背光测量值 类对象

LED_I()

背光总电流

LED_I_Alarm()

背光总电流报警状态标志

LED_V()

背光电压

LED_V_Alarm()

背光电压报警状态标志。=0x0无报警, =0x1上限报警，=0x2下限报警

class sharp_power.LEDTotalMeasureTypeDef

基类：object

背光总电压电流 类对象

ITotal_error()

背光总电流报警状态标志

TotalLEDi()

背光总电流

TotalLEDv()

背光总电压

VTotal_error()

背光总电压报警状态标志

class sharp_power.Power

基类：object

√ 电源板模块类

• 参数

• 返回

• 注意

  需要实例化

• raise : 无

ALL_En_Flag = 1

:

Board_EN = 0

Board_EN_list = []

Get_VDD_Sync_Signal()

获取顺序上电同步信号

• 参数

• 返回 : =0 返回同步消息，=1 未返回同步消息，=-1 参数错误

• raise : 无

IOVOL_Set(v)

设置IO输出电压设定, =模组IOVCC

• 参数

  • v: 要输出的电压值,单位V,精度 0.1V

• 返回

  • >=0: 设置成功

  • <0: 设置失败

• raise : 无

MAX_ALARM = 1

MIN_ALARM = 2

MONITOR_SetBee(bee_onoff)

蜂鸣器控制

• 参数

  • bee_onoff: 蜂鸣器状态, =1 响蜂鸣器, =0 关蜂鸣器

• 返回

  • >=0: 控制成功

  • <0: 控制失败

• raise : 无

MONITOR_SetName(type, name)

设置各通道显示的名称

• 参数

  • channels: (1-6)通道类型和通道号,请用上面的”通道类型和通道号宏定义”

  • name: 名称字符串

• 返回

  • >=0: 设置成功

  • <0: 设置失败

• raise : 无

NUL_ALARM = 0

POWER_Clear_MinMax()

清除电源板所有卡控值

• 参数

  • group :选择板子 范围 POWER_1 POWER_2 POWER_3 POWER_4（可或）

• 返回

  • =0 初始化成功

  • <0 失败

• raise : 无

POWER_GetPowerMea()

回读VDD的测量值和报警状态

• 参数

• 返回

  • <0: 读取失败

  • =0:返回测量结构体 VDD的测量值和报警状态,具体请看 PowerMeasureTypeDef 类定义

• raise : 无

POWER_GetVersion()

读取MONITOR板版本号(固件版本号(x.x.x),硬件版本号(x.x))

• 参数

• 返回

  • MONITOR板版本号(元组,格式: ((1,0,0), (1,0)))

  • <0: 读取失败’

• raise : 无

POWER_OFF_ALL_VDD()

快速关闭所有VDD通道电压

• 参数

• 返回

  • =0 初始化成功

  • <0 失败

• raise : 无

POWER_SetIxAlarmValueMA(ch, iMax, iMin)

设置某通道,某端口的电流报警限定值,毫安为单位

• 参数

  • ch: 通道号,值范围1~8, =1 代表VDD1

  • iMax: 电流上限值,以mA为单位,精度0.1mA若不监控此项需赋值为 LIMITNULL

  • iMin: 电流下限值,以mA为单位,精度0.1mA若不监控此项需赋值为 LIMITNULL

• 返回

  • >=0: 设置成功

  • <0: 设置失败

• raise : 无

POWER_SetIxAlarmValueUA(ch, iMax, iMin)

设置某通道,某端口的电流报警限定值,微安为单位

• 参数

  • ch: 通道号,值范围1~8, =1 代表VDD1

  • iMax: 电流上限值,以mA为单位,精度0.1uA若不监控此项需赋值为 LIMITNULL

  • iMin: 电流下限值,以mA为单位,精度0.1uA若不监控此项需赋值为 LIMITNULL

• 返回

  • >=0: 设置成功

  • <0: 设置失败

• raise : 无

POWER_SetIxMeaRange(ch, range_type)

设置某通道,某端口的电流报警限定值,微安为单位

• 参数

  • ch: 通道号,值范围1~8, =1 代表VDD1

  • range_type: 量程, =RANGE_MA mA量程, =RANGE_UA uA量程

• 返回

  • >=0: 设置成功

  • <0: 设置失败

• raise : 无

POWER_SetVDD(ch, v)

设置某VDD通道电压

• 参数

  • ch: 通道号, =1 代表VDD1

  • v: 要输出的电压值,单位V,精度 0.1V

• 返回

  • >=0: 设置成功

  • <0: 设置失败

• PS :

  使用前先确认需要用到多大的电流 默认保护电流为：VDD1-VDD6默认为400mA,VDD7-VDD8默认为200mA 若使用的电流大于默认值需要调用 POWER_SetVDDLimit(); 设置其保护电流

• raise : 无

POWER_SetVDDG(ch, v)

设置延长上电的时间 电压越大延长时间越大

• 参数

  • ch :通道数

  • v :最大值为5V 且不能大于设置VDD设置的电压值-2V

• 返回

• =0 初始化成功

• <0 失败

• raise : 无

POWER_SetVDDLimit(ch, mA)

设置某VDD通道达到多大电流时断电保护,（VDD1-VDD6默认为400mA,VDD7-VDD8默认为200mA）

• 参数

  • ch: 通道号,值范围1~8, =1 代表VDD1

  • mA: 要设置的电流保护值,单位mA

• 返回

  • >=0: 设置成功

  • <0: 设置失败

• raise : 无

POWER_SetVDDx_FB_EN(ch, onoff)

开启或者关闭补偿功能(硬件版本大于2.0的电源板才有此功能)

• 参数

  • ch : 通道号，值范围1~6。 =1 代表VDD1

  • onoff : 1-开启补偿功能，0-关闭补偿 （默认开启）

*返回

• =0 设置成功

• <0 失败

• raise : 无

POWER_SetVs(ch, ms)

设置是否启用顺序上电

• 参数

  • OnOff : 0-关闭顺序上电 1-启用顺序上电

• 返回

  • =0 设置成功

  • <0 失败

*PS :

使用顺序上电功能需要用到以下接口 方法一: POWER_SetVs(); 开启顺序上/下电功能 POWER_VDD_SquenceConfig(); 顺序上/下电配置 POWER_VDD_Squence_ON(); 执行顺序上/下电

方法二: (已不推荐使用这个方式) POWER_SetVs(); 开启顺序上电功能 POWER_SetVDD(); 设置某VDD通道电压 Power_setVsquence(); 设置上电顺序 POWER_SetVtime(); 设置上电间隔时间 POWER_VDD_Squence_ON(); 执行顺序上电

• raise : 无

POWER_SetVtime(ch, ms)

表示设置VDD通道之间 上电间隔的时间

• 参数

  • ch : 通道号，值范围1~8。 =1 代表VDD1

  • ms : 间隔的时间 (可设0)

*返回

• =0 设置成功

• <0 失败

*PS :

使用顺序上电功能需要用到以下接口 POWER_SetVs(); 开启顺序上电功能 POWER_SetVDD(); 设置某VDD通道电压 Power_setVsquence(); 设置上电顺序 POWER_SetVtime(); 设置上电间隔时间 POWER_VDD_Squence_ON(); 执行顺序上电

• raise : 无

POWER_SetVxAlarmValue(ch, vMax, vMin)

设置某通道,电压报警限定值

• 参数

  • ch: 通道号,值范围1~8, =1 代表VDD1

  • vMax: 电压上限值,单位V,精度0.01V,若不监控此项需赋值为 LIMITNULL

  • vMin: 电压下限值,单位V,精度0.01V,若不监控此项需赋值为 LIMITNULL

• 返回

  • >=0: 设置成功

  • <0: 设置失败

• raise : 无

POWER_SpVDDG(OnOff)

是否开启延长上电的时间

• 参数

  • OnOff :1 为 开启 0 为 关闭

• 返回

  • =0 初始化成功

  • <0 失败

• raise : 无

POWER_StartAlarm()

开启报警功能,设置通道限定值後,需调用此函数才能开启报警功能

• 参数

• 返回

  • >=0: 开启成功

  • <0: 开启失败

• raise : 无

POWER_Start_BeepT(waitTime)

响起蜂鸣器,报警一段时间

• 参数

  • alarmTime: 报警持续时间（ms）

• 返回

  • =0 设置成功

  • <0 失败

• raise : 无

POWER_StopAlarm()

关闭报警功能

• 参数

• 返回

  • >=0: 关闭成功

  • <0: 关闭失败

• raise : 无

POWER_VDD_SquenceConfig(ch, SetV, sequence, time)

顺序上下电配置

• 参数

  • ch : 通道号，值范围1~8。 =1 代表VDD1

  • SetV : 设置的电压(V)

  • sequence: 执行顺序(范围1到8)

  • time: : 执行下一个的间隔时间(ms)

• 返回

  • =0 设置成功

  • <0 失败

• PS :

  使用顺序上电功能需要用到以下接口 POWER_SetVs(); 开启顺序上/下电功能 POWER_VDD_SquenceConfig(); 顺序上/下电配置 POWER_VDD_Squence_ON(); 执行顺序上/下电

*/

• raise : 无

POWER_VDD_Squence_ON(waitTime)

按照设置的上下电顺序 顺序 上/下 电 * 参数

• waitTime :等待超时时间 ms(为0不等待，可用while(get_VDD_sync_signal()==0);来进行等待)

*返回

• =0 执行成

• =-2 超时

*PS :

使用顺序上电功能需要用到以下接口 POWER_SetVs(); 开启顺序上电功能 POWER_SetVDD(); 设置某VDD通道电压 Power_setVsquence(); 设置上电顺序 POWER_SetVtime(); 设置上电间隔时间 POWER_VDD_Squence_ON(); 执行顺序上电

*/

• raise : 无

Power_EN = 0

板载电源板ID

Power_ID = 0

Power_setVsquence(Vsquence)

发送上电顺序的函数

*参数

• power_squence :8路VDD的上电顺序 可以只设其中的几路

• power_squence[上电顺序(0-7)]=VDDx;

*返回

• =0 初始化成功

• <0 失败

*PSVsquence – 以列表形式传入

使用顺序上电功能需要用到以下接口

POWER_SetVs(); 开启顺序上电功能 POWER_SetVDD(); 设置某VDD通道电压 Power_setVsquence(); 设置上电顺序 POWER_SetVtime(); 设置上电间隔时间 POWER_VDD_Squence_ON(); 执行顺序上电

• raise : 无

Set_offj(flag)

用于关掉VDD后端继电器

• 参数

  • flag: 1: 关掉继电器, 0: 不关掉继电器也不打开继电器

• 返回

  • >=0: 设置成功

  • <0: 设置失败

• raise : 无

VDD1_NAME = 1

VDD2_NAME = 2

VDD3_NAME = 3

VDD4_NAME = 4

VDD5_NAME = 5

VDD6_NAME = 6

电流量程宏定义

WAVE_GetMeasure()

回读方波,ID(电压/电阻型)测量值,报警状态

• 参数

• 返回

  • 方波,ID(电压/电阻型)测量值,报警状态,具体请看 WaveMeasureTypeDef 类定义

  • <0: 读取失败

• raise : 无

WAVE_SetDutyxAlarmValue(ch, dMax, dMin)

设置某通道 占空比的限定范围

• 参数

  • ch: 通道号,值范围1~2, =1 代表WAVE1

  • dMax: 上限值,取值范围0~100.0,若不监控此项需赋值为 LIMITNULL

  • dMin: 下限值,取值范围0~100.0,若不监控此项需赋值为 LIMITNULL

• 返回

  • >=0: 设置成功

  • <0: 设置失败

• raise : 无

WAVE_SetFreqxAlarmValue(ch, fMax, fMin)

设置某通道,频率的限定范围

• 参数

  • ch: 通道号,值范围1~2, =1 代表WAVE1

  • fMax: 上限值,取值范围20~500000.0,若不监控此项需赋值为 LIMITNULL

  • fMin: 下限值,取值范围20~500000.0,若不监控此项需赋值为 LIMITNULL

• 返回

  • >=0: 设置成功

  • <0: 设置失败

• raise : 无

WAVE_SetIDRAlarmValue(rMax, rMin)

设置IDR报警限定值

• 参数

  • rMax: 电阻上限值,单位千欧,精度0.1k,若不监控此项需赋值为 LIMITNULL

  • rMin: 电阻下限值,单位千欧,精度0.1k,若不监控此项需赋值为 LIMITNULL

• 返回>=0: 设置成功

  <0: 设置失败

• raise : 无

WAVE_SetIDVAlarmValue(vMax, vMin)

设置IDV报警限定值

• 参数

  • vMax: 电压上限值,单位V,精度0.01V,若不监控此项需赋值为 LIMITNULL

  • vMin: 电压下限值,单位V,精度0.01V,若不监控此项需赋值为 LIMITNULL

• 返回

  • >=0: 设置成功

  • <0: 设置失败

• raise : 无

restart_power()

软件重启电源板

• 参数

• 返回

  • >=0: 重启成功

  • <0: 重启失败

• raise : 无

class sharp_power.PowerMeasureTypeDef

基类：object

VDD 测量值 类对象

VDD_I_Alarm()

VDD 电流报警状态，=0x0无报警, =0x1上限报警，=0x2下限报警，参看上面宏定义”报警状态宏定义”

VDD_I_mA()

VDD 电流测量值 以mA为单位 I_mA = I_uA/1000

VDD_I_uA()

VDD 电流测量值 以uA为单位 I_uA = I_mA*1000

VDD_V()

VDD 电压测量值 单位V

VDD_V_Alarm()

VDD 电压报警状态

sharp_power.SHARP_BackLight_ILedAlarmValue(group, ch, iMax, iMin)

设置ILED背光电流报警值

• 参数

  • group :选择板子 范围 POWER_1 POWER_2 POWER_3 POWER_4（可或）

  • ch: 背光通道

  • iMax: 电流上限值,以mA为单位,精度0.1mA若不监控此项需赋值为 LIMITNULL

  • iMin: 电流下限值,以mA为单位,精度0.1mA若不监控此项需赋值为 LIMITNULL

• 返回

  • >=0: 设置成功

  • <0: 设置失败

• raise : 无

sharp_power.SHARP_BackLight_StartAlarm(group)

开启背光板报警功能。设置通道限定值後，需调用此函数才能开启报警功能

• 参数

  • group :选择板子 范围 POWER_1 POWER_2 POWER_3 POWER_4（可或）

• 返回

  • =0 成功

  • <0 失败

• raise : 无

sharp_power.SHARP_BackLight_StopAlarm(group)

关闭背光板报警功能

• 参数

  • group :选择板子 范围 POWER_1 POWER_2 POWER_3 POWER_4（可或）

• 返回

  • =0 成功

  • <0 失败

• raise : 无

sharp_power.SHARP_BackLight_SumILedAlarmValue(group, iMax, iMin)

设置ILED总的背光电流报警值

• 参数

  • group:选择板子 范围 POWER_1 POWER_2 POWER_3 POWER_4（可或）

  • iMax: 电流上限值,以mA为单位,精度0.1mA若不监控此项需赋值为 LIMITNULL

  • iMin: 电流下限值,以mA为单位,精度0.1mA若不监控此项需赋值为 LIMITNULL

• 返回

  • >=0: 设置成功

  • <0: 设置失败

• raise : 无

sharp_power.SHARP_BackLight_SumVLedAlarmValue(group, vMax, vMin)

设置VLED总的背光电压报警值

• 参数

  • group :选择板子 范围 POWER_1 POWER_2 POWER_3 POWER_4（可或）

  • vMax: 电压上限值,单位V,精度0.1V,若不监控此项需赋值为 LIMITNULL

  • vMin: 电压下限值,单位V,精度0.1V,若不监控此项需赋值为 LIMITNULL

• 返回

  • >=0: 设置成功

  • <0: 设置失败

• raise : 无

sharp_power.SHARP_BackLight_VLedAlarmValue(group, ch, vMax, vMin)

设置VLED背光电压报警值

• 参数

  • group :选择板子 范围 POWER_1 POWER_2 POWER_3 POWER_4（可或）

  • ch: 背光通道

  • vMax: 电压上限值,单位V,精度0.1V,若不监控此项需赋值为 LIMITNULL

  • vMin: 电压下限值,单位V,精度0.1V,若不监控此项需赋值为 LIMITNULL

• 返回

  • >=0: 设置成功

  • <0: 设置失败

• raise : 无

sharp_power.SHARP_Backlight_Init()

背光板初始化 (用户不需要调用)

• 参数 : 无

• 返回

  • 分配失败的板子相应的位会置1，可用如下方式进行判断

  • if(ret&(1<<1)): SHARP_DEBUG(“第1块背光板id分配失败”)

  • if(ret&(1<<2)): SHARP_DEBUG(“第2块背光板id分配失败”);

  • if(ret&(1<<3)): SHARP_DEBUG(“第3块背光板id分配失败”);

  • if(ret&(1<<3)): SHARP_DEBUG(“第3块背光板id分配失败”);

  • if(ret&(1<<4)): SHARP_DEBUG(“第4块背光板id分配失败”);

• raise : 无

sharp_power.SHARP_Get_VDD_Sync_Signal(group)

获取顺序上电同步信号

• 参数 group: 选择板子 范围 POWER_1 POWER_2 POWER_3 POWER_4（不可或）

• 返回 : =0 返回同步消息，=1 未返回同步消息，=-1 参数错误

• raise : 无

sharp_power.SHARP_IOVOL_Set(group, v)

设置IO输出电压设定, =模组IOVCC

• 参数

  • group: 选择板子 范围 POWER_1 , POWER_2 , POWER_3 , POWER_4（可或）

  • v: 要输出的电压值,单位V,精度 0.1V

• 返回

  • >=0: 设置成功

  • <0: 设置失败

• raise : 无

sharp_power.SHARP_LED_Clear_AlarmValue(group)

清除背光板所有卡控值 * 参数

• group :选择板子 范围 POWER_1 POWER_2 POWER_3 POWER_4（可或）

• 返回

  • =0 成功

  • <0 失败

• raise : 无

sharp_power.SHARP_LED_ExPWMOff(group)

关闭 使用外部PWM控制背光电流的功能(默认为关闭)

• 参数

  • group :选择板子 范围 POWER_1 POWER_2 POWER_3 POWER_4（可或）

• 返回

  • =0 成功

  • <0 失败

• raise : 无

sharp_power.SHARP_LED_ExPWMOn(group)

开启 使用外部PWM控制背光电流(默认为关闭)

• 参数

  • group :选择板子 范围 POWER_1 POWER_2 POWER_3 POWER_4（可或）

*返回

• =0 成功

• <0 失败

• raise : 无

sharp_power.SHARP_LED_GetVersion(group)

获取背光板的软硬件版本号

• 参数

  • group : 选择板子 范围 POWER_1 , POWER_2 , POWER_3 , POWER_4 （不可或）

• 返回

  • =0 成功

  • <0 失败

• raise : 无

sharp_power.SHARP_LED_Get_Board_Type(group)

获取背光板类型 (用户不需要调用)

• 参数

  • group :选择板子 范围 POWER_1 POWER_2 POWER_3 POWER_4

• 返回

  • =0 - 设置成功

  • <0 - 失败

• raise : 无

sharp_power.SHARP_LED_OFF(group)

关灭LED背光

• 参数

  • group :选择板子 范围 POWER_1 POWER_2 POWER_3 POWER_4（可或）

• 返回

  • >=0: 关灭成功

  • <0: 关灭失败

• raise : 无

sharp_power.SHARP_LED_ON(group, chs)

开启LED背光,背光通道设置电流後要调用此函数才会通电

• 参数

  • group :选择板子 范围 POWER_1 POWER_2 POWER_3 POWER_4（可或）

  • chs: 0x01 LED1, 0x02 LED2, 0x04 LED3, …可或

• 返回

  • 0-成功

  • <0-失败

  • -49: 断路

  • -17: 阳极短地

  • -33: 阳极短高

  • -65: 阴极短地

• raise : 无

sharp_power.SHARP_LED_SetI(group, ledx, mA)

设置某LED通道电流

• 参数

  • group :选择板子 范围 POWER_1 POWER_2 POWER_3 POWER_4（可或）

  • ledx: LED通道号 1~12

  • mA: 电流值,单位mA,精度0.1mA

• 返回

  • >=0: 设置成功

  • <0: 设置失败

• raise : 无

sharp_power.SHARP_LED_SetVoltage(group, backVol)

直接设置LED背光电压,LED+对GND的电压,设置为0是自动升压

• 参数

  • group :选择板子 范围 POWER_1 POWER_2 POWER_3 POWER_4（可或）

  • backVol: 电压值,单位V

• 返回

  • >=0: 设置成功

  • <0: 设置失败

• raise : 无

sharp_power.SHARP_MONITOR_SetBee(group, bee_onoff)

蜂鸣器控制

• 参数

  • group 选择板子 范围 POWER_1 , POWER_2 , POWER_3 , POWER_4（可或）

  • bee_onoff: 蜂鸣器状态, =1 响蜂鸣器, =0 关蜂鸣器

• 返回

  • >=0: 控制成功

  • <0: 控制失败

• raise : 无

sharp_power.SHARP_MONITOR_SetName(group, channels, name)

设置各通道显示的名称

• 参数

  • group :选择板子 范围 POWER_1 POWER_2 POWER_3 POWER_4（可或）

  • channels: (1-6)通道类型和通道号,请用上面的”通道类型和通道号宏定义”

  • name: 名称字符串

• 返回

  • >=0: 设置成功

  • <0: 设置失败

• raise : 无

sharp_power.SHARP_POWER_Clear_MinMax(group)

清除电源板所有卡控值

• 参数

  • group :选择板子 范围 POWER_1 POWER_2 POWER_3 POWER_4（可或）

• 返回

  • =0 初始化成功

  • <0 失败

• raise : 无

sharp_power.SHARP_POWER_GetLEDMea(group)

回读LED所有通道的测量值,报警状态

• 参数

  • group :选择板子 范围 POWER_1 POWER_2 POWER_3 POWER_4（可或）

• 返回

  • <0 读取失败

  • >=0 LEDMeasure :LED所有通道的测量值,报警状态,具体请看 LEDMeasureTypeDef 类定义

• raise : 无

sharp_power.SHARP_POWER_GetLEDMea_(group)

回读LED所有通道的测量值,报警状态

• 函数差异: 返回参数的方式不同

• 参数

  • group :选择板子 范围 POWER_1 POWER_2 POWER_3 POWER_4（可或）

• 返回

  • ret <0 读取失败

  • ret >=0 读取成功

  • LEDMeasure :LED所有通道的测量值,报警状态,具体请看 LEDMeasureTypeDef 类定义

• raise : 无

sharp_power.SHARP_POWER_GetPowerMea(group)

回读VDD的测量值和报警状态

• 参数

  • group:选择板子 范围 POWER_1 , POWER_2 , POWER_3 , POWER_4（可或）

• 返回

  • <0: 读取失败

  • =0:返回测量结构体 VDD的测量值和报警状态,具体请看 PowerMeasureTypeDef 类定义

• raise : 无

sharp_power.SHARP_POWER_GetPowerMea_(group)

回读VDD的测量值和报警状态

• 函数差异: 返回参数的方式不同

• 参数

  • group:选择板子 范围 POWER_1 , POWER_2 , POWER_3 , POWER_4（可或）

• 返回

  • ret < 0: 读取失败

  • ret = 0:读取成功

  • PowerMeasure: VDD的测量值和报警状态,具体请看 PowerMeasureTypeDef 类定义

• raise : 无

sharp_power.SHARP_POWER_GetVersion(group)

读取MONITOR板版本号(固件版本号(x.x.x),硬件版本号(x.x))

• 参数

  • group: 选择板子 范围 POWER_1 , POWER_2 , POWER_3 , POWER_4 （不可或）

• 返回

  • MONITOR板版本号(元组,格式: ((1,0,0), (1,0)))

  • <0: 读取失败’

• raise : 无

sharp_power.SHARP_POWER_Get_Board_Type(group)

获取电源板 (用户不需要调用)

• 参数

  • group :选择板子 范围 POWER_1 POWER_2 POWER_3 POWER_4

• 返回

  • =0 - 设置成功

  • <0 - 失败

• raise : 无

sharp_power.SHARP_POWER_OFF_ALL_VDD(group)

快速关闭所有VDD通道电压

• 参数

  • group :选择板子 范围 POWER_1 POWER_2 POWER_3 POWER_4（可或）

• 返回

  • =0 初始化成功

  • <0 失败

• raise : 无

sharp_power.SHARP_POWER_SetIxAlarmValueMA(group, ch, iMax, iMin)

设置某通道,某端口的电流报警限定值,毫安为单位

• 参数

  • group: 选择板子 范围 POWER_1 , POWER_2 , POWER_3 , POWER_4（可或）

  • ch: 通道号,值范围1~8, =1 代表VDD1

  • iMax: 电流上限值,以mA为单位,精度0.1mA若不监控此项需赋值为 LIMITNULL

  • iMin: 电流下限值,以mA为单位,精度0.1mA若不监控此项需赋值为 LIMITNULL

• 返回

  • >=0: 设置成功

  • <0: 设置失败

• raise : 无

sharp_power.SHARP_POWER_SetIxAlarmValueUA(group, ch, iMax, iMin)

设置某通道,某端口的电流报警限定值,微安为单位

• 参数

  • group: 选择板子 范围 POWER_1 , POWER_2 , POWER_3 , POWER_4（可或）

  • ch: 通道号,值范围1~8, =1 代表VDD1

  • iMax: 电流上限值,以mA为单位,精度0.1uA若不监控此项需赋值为 LIMITNULL

  • iMin: 电流下限值,以mA为单位,精度0.1uA若不监控此项需赋值为 LIMITNULL

• 返回

  • >=0: 设置成功

  • <0: 设置失败

• raise : 无

sharp_power.SHARP_POWER_SetIxMeaRange(group, ch, range_type)

设置某通道,某端口的电流报警限定值,微安为单位

• 参数

  • group :选择板子 范围 POWER_1 POWER_2 POWER_3 POWER_4（可或）

  • ch: 通道号,值范围1~8, =1 代表VDD1

  • range_type: 量程, =RANGE_MA mA量程, =RANGE_UA uA量程

• 返回

  • >=0: 设置成功

  • <0: 设置失败

• raise : 无

sharp_power.SHARP_POWER_SetVDD(group, ch, v)

设置某VDD通道电压

• 参数

  • group: 选择板子 范围 POWER_1 , POWER_2 , POWER_3 , POWER_4（可或）

  • ch: 通道号, =1 代表VDD1

  • v: 要输出的电压值,单位V,精度 0.1V

• 返回

  • >=0: 设置成功

  • <0: 设置失败

• PS :

  使用前先确认需要用到多大的电流 默认保护电流为：VDD1-VDD6默认为400mA,VDD7-VDD8默认为200mA 若使用的电流大于默认值需要调用 POWER_SetVDDLimit(); 设置其保护电流

• raise : 无

sharp_power.SHARP_POWER_SetVDDG(group, ch, v)

设置延长上电的时间 电压越大延长时间越大

• 参数

  • group :选择板子 范围 POWER_1 POWER_2 POWER_3 POWER_4（可或）

  • ch :通道数

  • v :最大值为5V 且不能大于设置VDD设置的电压值-2V

• 返回

• =0 初始化成功

• <0 失败

• raise : 无

sharp_power.SHARP_POWER_SetVDDLimit(group, ch, mA)

设置某VDD通道达到多大电流时断电保护,（VDD1-VDD6默认为400mA,VDD7-VDD8默认为200mA）

• 参数

  • group: 选择板子 范围 POWER_1 POWER_2 POWER_3 POWER_4（可或）

  • ch: 通道号,值范围1~8, =1 代表VDD1

  • mA: 要设置的电流保护值,单位mA

• 返回

  • >=0: 设置成功

  • <0: 设置失败

• raise : 无

sharp_power.SHARP_POWER_SetVDDx_EN(group, ch, onoff)

开启或者关闭VDD使能

• 参数

  • group: 选择板子 范围 POWER_1 , POWER_2 , POWER_3 , POWER_4（可或）

  • ch: 通道号, =1 代表VDD1

  • onoff: 1-使能VDD，0-失能VDD

• 返回

  • >=0: 设置成功

  • <0: 设置失败

• raise : 无

sharp_power.SHARP_POWER_SetVDDx_FB_EN(group, ch, onoff)

开启或者关闭补偿功能(硬件版本大于2.0的电源板才有此功能)

• 参数

  • group : 选择板子 范围 POWER_1 POWER_2 POWER_3 POWER_4（可或）

  • ch : 通道号，值范围1~6。 =1 代表VDD1

  • onoff : 1-开启补偿功能，0-关闭补偿 （默认开启）

*返回

• =0 设置成功

• <0 失败

• raise : 无

sharp_power.SHARP_POWER_SetVs(group, OnOff)

设置是否启用顺序上电

• 参数

  • group: 选择板子 范围 POWER_1 POWER_2 POWER_3 POWER_4（可或）

  • OnOff : 0-关闭顺序上电 1-启用顺序上电

• 返回

  • =0 设置成功

  • <0 失败

*PS :

使用顺序上电功能需要用到以下接口 方法一: POWER_SetVs(); 开启顺序上/下电功能 POWER_VDD_SquenceConfig(); 顺序上/下电配置 POWER_VDD_Squence_ON(); 执行顺序上/下电

方法二: (已不推荐使用这个方式) POWER_SetVs(); 开启顺序上电功能 POWER_SetVDD(); 设置某VDD通道电压 Power_setVsquence(); 设置上电顺序 POWER_SetVtime(); 设置上电间隔时间 POWER_VDD_Squence_ON(); 执行顺序上电

• raise : 无

sharp_power.SHARP_POWER_SetVtime(group, ch, ms)

表示设置VDD通道之间 上电间隔的时间

• 参数

  • group : 选择板子 范围 POWER_1 POWER_2 POWER_3 POWER_4（可或）

  • ch : 通道号，值范围1~8。 =1 代表VDD1

  • ms : 间隔的时间 (可设0)

*返回

• =0 设置成功

• <0 失败

*PS :

使用顺序上电功能需要用到以下接口 POWER_SetVs(); 开启顺序上电功能 POWER_SetVDD(); 设置某VDD通道电压 Power_setVsquence(); 设置上电顺序 POWER_SetVtime(); 设置上电间隔时间 POWER_VDD_Squence_ON(); 执行顺序上电

• raise : 无

sharp_power.SHARP_POWER_SetVxAlarmValue(group, ch, vMax, vMin)

设置某通道,电压报警限定值

• 参数

  • group: 选择板子 范围 POWER_1 , POWER_2 , POWER_3 , POWER_4（可或）

  • ch: 通道号,值范围1~8, =1 代表VDD1

  • vMax: 电压上限值,单位V,精度0.01V,若不监控此项需赋值为 LIMITNULL

  • vMin: 电压下限值,单位V,精度0.01V,若不监控此项需赋值为 LIMITNULL

• 返回

  • >=0: 设置成功

  • <0: 设置失败

• raise : 无

sharp_power.SHARP_POWER_Set_IndicatorLight(group, LEDx, onoff)

设置电源板指示灯 (用户不需要调用)

• 参数

  • group :选择板子 范围 POWER_1 POWER_2 POWER_3 POWER_4

  • LEDx :选择LED 范围 1到5

  • onoff :1-开启，0-关闭

*返回

• =0 - 设置成功

• <0 - 失败

• raise : 无

sharp_power.SHARP_POWER_SpVDDG(group, OnOff)

是否开启延长上电的时间

• 参数

  • group :选择板子 范围 POWER_1 POWER_2 POWER_3 POWER_4（可或）

  • OnOff :1 为 开启 0 为 关闭

• 返回

  • =0 初始化成功

  • <0 失败

• raise : 无

sharp_power.SHARP_POWER_StartAlarm(group)

开启报警功能,设置通道限定值後,需调用此函数才能开启报警功能

• 参数

  • group:选择板子 范围 POWER_1 , POWER_2 , POWER_3 , POWER_4（可或）

• 返回

  • >=0: 开启成功

  • <0: 开启失败

• raise : 无

sharp_power.SHARP_POWER_Start_BeepT(group, waitTime)

响起蜂鸣器,报警一段时间

• 参数

  • group : 选择板子 范围 POWER_1 POWER_2 POWER_3 POWER_4（可或）

  • alarmTime: 报警持续时间（ms）

• 返回

  • =0 设置成功

  • <0 失败

• raise : 无

sharp_power.SHARP_POWER_StopAlarm(group)

关闭报警功能

• 参数

  • group:选择板子 范围 POWER_1 , POWER_2 , POWER_3 , POWER_4（可或）

• 返回

  • >=0: 关闭成功

  • <0: 关闭失败

• raise : 无

sharp_power.SHARP_POWER_VDD_SquenceConfig(group, ch, SetV, sequence, time)

顺序上下电配置

• 参数

  • group : 选择板子 范围 POWER_1 POWER_2 POWER_3 POWER_4（可或）

  • ch : 通道号，值范围1~8。 =1 代表VDD1

  • SetV : 设置的电压(V)

  • sequence: 执行顺序(范围1到8)

  • time: : 执行下一个的间隔时间(ms)

• 返回

  • =0 设置成功

  • <0 失败

• PS :

  使用顺序上电功能需要用到以下接口 POWER_SetVs(); 开启顺序上/下电功能 POWER_VDD_SquenceConfig(); 顺序上/下电配置 POWER_VDD_Squence_ON(); 执行顺序上/下电

*/

• raise : 无

sharp_power.SHARP_POWER_VDD_Squence_ON(group, waitTime)

按照设置的上下电顺序 顺序 上/下 电 * 参数

• group 选择板子 范围 POWER_1 POWER_2 POWER_3 POWER_4（可或）

• waitTime :等待超时时间 ms(为0不等待，可用while(get_VDD_sync_signal()==0);来进行等待)

*返回

• =0 执行成

• =-2 超时

*PS :

使用顺序上电功能需要用到以下接口 POWER_SetVs(); 开启顺序上电功能 POWER_SetVDD(); 设置某VDD通道电压 Power_setVsquence(); 设置上电顺序 POWER_SetVtime(); 设置上电间隔时间 POWER_VDD_Squence_ON(); 执行顺序上电

*/

• raise : 无

sharp_power.SHARP_Power_Init()

电源板初始化 (用户不需要调用)

• 参数 : 无

• 返回

  分配失败的板子相应的位会置1，可用如下方式进行判断 ret=assignment_bus_ID(recType); if(ret&(1<<1)): SHARP_DEBUG(“第1块电源板id分配失败”) if(ret&(1<<2)): SHARP_DEBUG(“第2块电源板id分配失败”) if(ret&(1<<3)): SHARP_DEBUG(“第3块电源板id分配失败”) if(ret&(1<<4)): SHARP_DEBUG(“第4块电源板id分配失败”)

• raise : 无

sharp_power.SHARP_Power_setVsquence(group, Vsquence)

发送上电顺序的函数

*参数

• group :选择板子 范围 POWER_1 POWER_2 POWER_3 POWER_4（可或）

• power_squence :8路VDD的上电顺序 可以只设其中的几路

• power_squence[上电顺序(0-7)]=VDDx;

*返回

• =0 初始化成功

• <0 失败

*PSVsquence – 以列表形式传入

使用顺序上电功能需要用到以下接口

POWER_SetVs(); 开启顺序上电功能 POWER_SetVDD(); 设置某VDD通道电压 Power_setVsquence(); 设置上电顺序 POWER_SetVtime(); 设置上电间隔时间 POWER_VDD_Squence_ON(); 执行顺序上电

• raise : 无

sharp_power.SHARP_Set_blHorL(group, value)

设置需要高功率的高电压背光或者低功率的低电压背光

• 参数

  • group :选择板子 范围 POWER_1 POWER_2 POWER_3 POWER_4（可或）

  • value: 1: 为切换到设置高功率的高电压背光, 0: 为切换到设置低功率的低电压背光

• 返回

  • >=0: 设置成功

  • <0: 设置失败

• raise : 无

sharp_power.SHARP_Set_offj(group, flag)

用于关掉VDD后端继电器

• 参数

  • group: 选择板子 范围 POWER_1 , POWER_2 , POWER_3 , POWER_4（可或）

  • flag: 1: 关掉继电器, 0: 不关掉继电器也不打开继电器

• 返回

  • >=0: 设置成功

  • <0: 设置失败

• raise : 无

sharp_power.SHARP_WAVE_GetMeasure(group)

回读方波,ID(电压/电阻型)测量值,报警状态

• 参数

  • group : 选择板子 范围 POWER_1 , POWER_2 , POWER_3 , POWER_4（不可或）

• 返回

  • 方波,ID(电压/电阻型)测量值,报警状态,具体请看 WaveMeasureTypeDef 类定义

  • <0: 读取失败

• raise : 无

sharp_power.SHARP_WAVE_GetMeasure_(group)

回读方波,ID(电压/电阻型)测量值,报警状态

• 函数差异: 返回参数的方式不同

• 参数

  • group : 选择板子 范围 POWER_1 , POWER_2 , POWER_3 , POWER_4（不可或）

• 返回

  • ret >=0: 控制成功

  • ret <0: 控制失败

  • WaveMeasure: 方波,ID(电压/电阻型)测量值,报警状态,具体请看 WaveMeasureTypeDef 类定义

• raise : 无

sharp_power.SHARP_WAVE_SetDutyxAlarmValue(group, ch, dMax, dMin)

设置某通道 占空比的限定范围

• 参数

  • group: 选择板子 范围 POWER_1 , POWER_2 , POWER_3 , POWER_4（可或）

  • ch: 通道号,值范围1~2, =1 代表WAVE1

  • dMax: 上限值,取值范围0~100.0,若不监控此项需赋值为 LIMITNULL

  • dMin: 下限值,取值范围0~100.0,若不监控此项需赋值为 LIMITNULL

• 返回

  • >=0: 设置成功

  • <0: 设置失败

• raise : 无

sharp_power.SHARP_WAVE_SetFreqxAlarmValue(group, ch, fMax, fMin)

设置某通道,频率的限定范围

• 参数

  • group : 选择板子 范围 POWER_1 , POWER_2 , POWER_3 , POWER_4（可或）

  • ch: 通道号,值范围1~2, =1 代表WAVE1

  • fMax: 上限值,取值范围20~500000.0,若不监控此项需赋值为 LIMITNULL

  • fMin: 下限值,取值范围20~500000.0,若不监控此项需赋值为 LIMITNULL

• 返回

  • >=0: 设置成功

  • <0: 设置失败

• raise : 无

sharp_power.SHARP_WAVE_SetIDRAlarmValue(group, rMax, rMin)

设置IDR报警限定值

• 参数

  • group: 选择板子 范围 POWER_1 , POWER_2 , POWER_3 , POWER_4（可或）

  • rMax: 电阻上限值,单位千欧,精度0.1k,若不监控此项需赋值为 LIMITNULL

  • rMin: 电阻下限值,单位千欧,精度0.1k,若不监控此项需赋值为 LIMITNULL

• 返回>=0: 设置成功

  <0: 设置失败

• raise : 无

sharp_power.SHARP_WAVE_SetIDVAlarmValue(group, vMax, vMin)

设置IDV报警限定值

• 参数

  • group: 选择板子 范围 POWER_1 , POWER_2 , POWER_3 , POWER_4（可或）

  • vMax: 电压上限值,单位V,精度0.01V,若不监控此项需赋值为 LIMITNULL

  • vMin: 电压下限值,单位V,精度0.01V,若不监控此项需赋值为 LIMITNULL

• 返回

  • >=0: 设置成功

  • <0: 设置失败

• raise : 无

sharp_power.SHARP_restart_BackLight(group)

软件重启背光板

• 参数

  • group :选择板子 范围 POWER_1 POWER_2 POWER_3 POWER_4（可或）

*返回

• =0 成功

• <0 失败

• raise : 无

sharp_power.SHARP_restart_power(group)

软件重启电源板

• 参数

  • group 选择板子 范围 POWER_1 , POWER_2 , POWER_3 , POWER_4（可或）

• 返回

  • >=0: 重启成功

  • <0: 重启失败

• raise : 无

class sharp_power.WaveMeasureTypeDef

基类：object

方波测量值与电阻型ID 和 电压型ID

ID_R()

电阻型ID 单位 kohm

ID_R_Alarm()

电阻型ID报警状态

ID_V()

电压型ID 单位 V

ID_V_Alarm()

电压型ID报警状态

WAVE_D()

方波占空比 单位 %

WAVE_D_Alarm()

方波占空比报警状态

WAVE_F()

方波频率 单位 Hz

WAVE_F_Alarm()

方波频率报警状态