Q群:
电话:
邮箱:
地址:
device.Humiture 类是device模块下面的一个硬件类,用于对温湿度模块的配置和控制,并提供对温湿度设备的操作方法。
类型 | 常量名称 | 含义 |
---|---|---|
阈值中断类型 | Humiture.TEMPERATURE_LOW | 温度超出上限阈值产生中断 |
Humiture.TEMPERATURE_HIGH | 温度低于下限阈值产生中断 | |
Humiture.HUMIDITY_LOW | 湿度超出上限阈值产生中断 | |
Humiture.HUMIDITY_HIGH | 湿度低于下限阈值产生中断 | |
数据中断 | Humiture.DATA_READY | 数据采集完成产生中断 |
自动采样周期 | Humiture_SAMPLE_200MS | 采样周期为200MS即每秒5次 |
Humiture_SAMPLE_500MS | 采样周期为500MS即每秒2次 | |
Humiture_SAMPLE_1S | 采样周期为1S即每秒1次 | |
Humiture_SAMPLE_10S | 采样周期为10S即每10秒1次 | |
Humiture_SAMPLE_20S | 采样周期为20S即每20秒1次 | |
Humiture_SAMPLE_60S | 采样周期为60S即每60秒1次 | |
Humiture_SAMPLE_120S | 采样周期为120S即每120秒1次 | |
采样类型 | Humiture.TEMPERATURE | 采样类型为温度采样 |
Humiture.HUMIDITY_LOW | 采样类型为湿度采样 |
构造函数 | class device.Humiture() |
---|---|
功能 | 构造一个Humiture对象 |
参数说明 | 无 |
返回值 | 返回创建的Humiture对象 |
其他说明 | 构造时会对Humiture进行初始化,也可在init方法中进行初始化,该初始化应针对不同的硬件有不同的驱动进行对应设备的初始化动作。 |
device.Humiture类包括如下实例方法
方法名 | 说明 |
---|---|
Humiture.init() | 初始化Humiture对象 |
Humiture.deinit() | 关闭Humiture对象 |
Humiture.isready() | 获取传感器连接状态 |
Humiture.read() | 读取温湿度值 |
Humiture.autocheck() | 设置/获取自动检测时的中断类型及阈值 |
Humiture.autocheck_exit() | 退出自动检测 |
Humiture.getirq_source() | 获取产生中断的中断来源 |
Humiture.sleep() | 设置传感器休眠 |
Humiture.wakeup() | 主动唤醒传感器 |
Humiture.modelname() | 获取模块厂家及型号 |
每个方法的详细说明如下:
方法名称 | Humiture.init() |
---|---|
功能 | 初始化温湿度传感器 |
参数说明 | 无 |
返回值 | 固定返回None |
方法名称 | Humiture.deinit() |
---|---|
功能 | 关闭Humiture对象 |
参数说明 | 无参数 |
返回值 | 固定返回None |
注:关闭Humiture对象后,需重新init才能正常使用Humiture对象。
方法名称 | Humiture.isready() |
---|---|
功能 | 获取传感器连接状态 |
参数说明 | 无参数 |
返回值 | 若传感器连接正常返回True,否则返回False |
方法名称 | Humiture.read([type]) |
---|---|
功能 | 读取温湿度值 |
参数说明 | [type]:采样类型,该参数为可选参数,传入该参数时,功能为获取指定类型的采样值,可选Humiture常量中采样类型部分相关常量; 未传入该参数时,功能为获取温度及湿度的采样值; |
返回值 | 未传入参数时,以字典的形式返回温度和湿度,如{tempture:xxx, humidity:xxx}; 传入参数时,返回指定类型的采样值; 其中,温度单位为℃ ,湿度单位为% |
注:针对一些带低功耗休眠模式的传感器,底层驱动在编写读取温湿度时应针对低功耗休眠模式和唤醒模式做不同的处理方式,但该区别对上层开发者透明。
方法名称 | Humiture.autocheck([period, *,irqmode=-1, t_low=-1,t_high=-1,h_low=-1,h_high=-1]) |
---|---|
功能 | 设置/获取中断模式及阈值 |
参数说明 | period:自动检测采样周期,参数可选Humiture常量中自动采样周期部分相关常量; irqmode:阈值中断类型 t_low:温度下限阈值 t_high:温度上限阈值 h_low:湿度下限阈值 h_high:湿度下限阈值 参数使用注意事项见下方注; |
返回值 | 不传入参数时,以字典的形式返回当前的自动检测周期、中断类型及阈值,如{period:xxx, irqmode:xxx, t_low:xxx, t_high:xxx, h_low:xxx,h_high:xxx},其中irqmode对应值为阈值中断类型部分相关常量对应值或者经过或运算后的值,当获取到的阈值为-1时表示为未设置对应的中断阈值; 传入参数时,固定返回None; |
注:1、使用该方法成功后,模块将进入低功耗自动检测模式;
2、阈值中断类型与上下限阈值必须匹配使用,如设置温度超过上限阈值产生中断,则必须设置对应的t_high值,否则对应中断配置将会无效,其他也同理;当不传入阈值中断类型参数时,则不会产生阈值中断,仅进行数据的定时自动检测,定时周期到时,温湿度模块将产生数据中断以通知应用开发者。
方法名称 | Humiture.autocheck_exit() |
---|---|
功能 | 退出自动检测模式及低功耗状态 |
参数说明 | 无参数 |
返回值 | 固定返回None |
注:该方法应与autocheck()配合使用。
方法名称 | Humiture.getirq_source() |
---|---|
功能 | 获取产生中断的中断来源,当产生中断时,可通过该方法判断中断来源 |
参数说明 | 无参数 |
返回值 | 返回中断触发类型或者数据中断部分相关常量中对应的数值; |
注:1、当设置自动检测数据时,在数据采集完成时会产生数据中断,若设置了阈值中断,则数据满足阈值要求时会产生对应阈值中断;
2、该方法应在产生 Humiture中断时使用。
方法名称 | Humiture.sleep() |
---|---|
功能 | 设置传感器休眠 |
参数说明 | 无 |
返回值 | 固定返回None |
注:设置传感器进入低功耗休眠状态,此时不会进行自动采集动作。
方法名称 | Humiture.wakeup() |
---|---|
功能 | 主动唤醒传感器 |
参数说明 | 无 |
返回值 | 固定返回None |
注:该方法应与sleep()方法配合使用。
方法名称 | Humiture.modelname() |
---|---|
功能 | 获取模块厂家及型号 |
参数说明 | 无 |
返回值 | 返回模块厂家名称及型号 |