一、产品简介
?? 水位监测传感器主要用于测量水位深度的传感器,该传感器测量范围在0cm-4cm,通过使用连接到系统接地的一系列五条裸线来工作。在每两条接地线之间交错插入一条感知线,五条接地线和五条感知线。

引脚定义
- GND:地
- VCC:5V
- NC:不接
- AO:模拟输出
二、技术参数
工作电压:DC5V
工作电流:小于35mA
数据类型:模拟信号
检测面积:40mm x 18mm最深只能测4cm
制作工艺:FR4双面喷锡
工作温度:10°C-30°C
工作湿度:10%-90%无凝结
模块重量:3.5g
板子尺寸:60mm x 22mm
三、软件接口
水位监测传感器HaaS Python驱动:下载地址
WATER4LEVEL(adcObj) - 创建水位监测传感器驱动对象
- 函数原型
waterlevelObj = WATER4LEVEL(adcObj)
- 参数说明
参数 | 类型 | 必选参数? | 说明 |
adcObj | ADC | 是 | 确保在调用此函数之前adcObj对象已处于open状态 |
- 返回值
WATER4LEVEL对象成功,返回WATER4LEVEL对象;WATER4LEVEL对象创建失败,抛出Exception
- 示例代码
import water4level from driver import ADC print("Testing water level ...") adcObj = ADC() adcObj.open("waterlevel") print("waterlevel inited!") waterlevelObj = water4level.WATER4LEVEL(adcObj)
- 输出
Testing water level ... waterlevel inited!
measureLevel() - 单位测量水位值cm
- 函数功能:
单位测量水位值cm
- 函数原型:
WATER4LEVEL.measureLevel()
- 参数说明:
无
- 返回值:
返回测量的水位值(数据类型:整形;单位:cm)
- 示例:
import water4level from driver import ADC import utime print("Testing water level ...") adcObj = ADC() adcObj.open("waterlevel") print("waterlevel inited!") waterlevelObj = water4level.WATER4LEVEL(adcObj) while True: # 无限循环 level = waterlevelObj.measureLevel() print("%d"%level " cm") utime.sleep(1)
- 输出
Testing water level ... waterlevel inited! 0 cm 1 cm 1 cm 1 cm 2 cm 2 cm 3 cm 3 cm 3 cm 3 cm 4 cm 4 cm 4 cm 4 cm
四、接口案例
这个用例子是board.json定义名称WATER4LEVEL的ADC类型对象Python获取脚本中测量的水位值,并在日志中打印。
- 案例代码
{ "name": "board-name", "version": "1.0.0", "io": { "waterlevel": { "type": "ADC", "port": 0, "atten": 2, "width": 3, "sampling": 12000000 }, } }
import water4level from driver import ADC import utime print("Testing water level ...") adcObj = ADC() adcObj.open("waterlevel") print("waterlevel inited!") waterlevelObj = water4level.WATER4LEVEL(adcObj) while True: # 无限循环 level = waterlevelObj.measureLevel() print("%d"%level " cm") utime.sleep(1)
- 输出
Testing water level ... waterlevel inited! 0 cm 1 cm 1 cm 1 cm 2 cm 2 cm 3 cm 3 cm 3 cm 3 cm 4 cm 4 cm 4 cm 4 cm
五、工作原理
?? Water Sensor液位(水位)传感器是一种简单易用、小巧轻便、性价比高的水位/水滴识别检测传感器。它通过一系列暴露的平行导线来测量水滴/水量,从而判断水位。从水量到模拟信号的转换很容易完成,输出的模拟值可以直接应用于程序中的函数,达到水位报警的效果。低功耗和灵敏度是它的另一个主要特点。