芯步的壁挂式红外雷达联动控制器支持通过HTTP接口远程调节感应灵敏度,核心是修改设备配置项中的infrared_change_1(有人触发持续时间)和infrared_change_0(无人触发持续时间)参数。下面是一份对接方案,偏实操向,可以照着一步步来。
1. 咱们先搞清楚:调节“灵敏度”到底调的是什么?
在开始敲代码之前,我们得先把概念对齐一下。很多客户问我“能不能调灵敏度”,其实在芯步的这个“双模”传感器(红外+雷达)里,没有直接的“灵敏度”旋钮,我们是通过调整触发持续时间来达到类似效果的。
简单解释一下:
红外有人触发持续时间 (
infrared_change_1):这个参数决定了——传感器只要检测到人,就马上上报“有人”。但是为了防止瞬间误报(比如苍蝇飞过或者窗帘飘动),你可以让它“确认一下”。如果设置为“2s”,那就意味着红外和雷达都连续2秒检测到有活动物体,才上报“有人”。数值越大,对短暂干扰的过滤能力越强,但也越“迟钝”。红外无人触发持续时间 (
infrared_change_0):这个参数决定了——人离开后,传感器等多久才上报“无人”。如果你设置成“5m”(5分钟),那人走了之后,灯还会亮5分钟。这在做联动控制(比如关灯、关空调)时非常关键,可以防止人稍微不动就误判为无人。
所以,我们的对接目标,就是通过API修改壁挂式设备的这两个配置项。
2. 动手前的准备工作(也就是鉴权,别怕,很简单)
芯步的接口是标准的HTTP API。不管是调灵敏度还是开关设备,核心都是发一条POST请求。你需要先准备好三样东西:
AppID 和 AppSecret:登录芯步工作台 -> 物联网控制台 -> 开发设置。这里就是你的“身份证”。
设备ID (Device ID):在控制台的设备列表里找到你要调的那个壁挂式控制器,设备ID通常是一串数字,直接复制就行。
签名计算 (Sign):官方文档要求一个签名
sign,主要是为了防止接口被别人乱刷。计算规则是:sign = md5( md5(AppSecret) + ts )。碎碎念:看着有点绕对吧?其实就是把你的密钥MD5加密一次,再拼上当前时间戳,整体再MD5一次。大多数后端语言都有现成的MD5函数,复制过去改改就行。
3. 核心操作:下发命令调节灵敏度
我们要用到的接口地址是(注意替换成你自己的AppID):https://api.thingboot.com/{你的AppID}/device/control/?sign={你的签名}&ts={当前时间戳}
请求方式是 POST,Body里带JSON数据。
第一种场景:我想让人体感应变“灵敏”一点(防误报)
需求:比如办公室里有暖气,或者窗帘总是飘,设备老是误报有人。我想让它“迟钝”一点,连续3秒都探测到人才算有人。
这种情况下,我们需要修改 红外有人触发持续时间。
根据芯步的产品手册,这个参数的可选值通常是:0(马上), 1s, 2s, 3s, 5s... 我们把它设为 3。
你需要下发的命令(order)如下:
解析:这里 infrared_change_1 就是“红外有人触发持续时间”,设置为3表示“3秒”。
第二种场景:我想让关灯延迟久一点(无人滞后)
需求:在卫生间或者走廊,不想让人一出门灯马上就灭,想延迟2分钟再关灯。
这种情况下,我们需要修改 红外无人触发持续时间。
查一下手册,infrared_change_0 的值如果是120,代表2分钟(120秒)。
你需要下发的命令(order)如下:
解析:设置为120秒。这样人离开后,设备会等待120秒才会将状态变为“无人”,联动关灯的设备也就不会马上关灯了。
第三种场景:我想一键设置成“全自动模式”
需求:想要反应快,无人延迟短(比如1分钟)。
这就是上面两个参数的组合:
解析:有人持续1秒即触发,人走1分钟后才显示无人。这是比较通用的设置。
4. 实际操作一下(结合代码片段)
为了让你更有感觉,我用 Shell + curl 写个最简单的例子。如果你是用PHP、Python或Java,逻辑是完全一样的。
假设你的设备ID是 115756(你提供的编号),AppSecret 假设是 abc123。
执行后的预期结果:如果返回 {"code": 200} ,说明指令已经成功发送到云端并下发给设备了。这时候设备的配置项其实已经被修改并存入了Flash,即便是断电重启,这个灵敏度值也不会丢。
5. 两点要注意的小细节
在对接过程中,有两个坑稍微注意一下,能省不少事:
改的是“配置”,不是“状态”:像
infrared_change_1这类参数属于产品的配置项。芯步的平台为了保护设备存储芯片,没有开放批量修改配置的接口。所以你每次改灵敏度,都需要像上面这样单独发一条指令。不过这对我们业务来说完全足够了。私有化部署怎么办?:如果你是把系统部署在纯内网(局域网),用不了云API。别慌,芯步也支持局域网直接控制。这时候你需要找到设备的局域网IP地址,直接POST数据到
http://设备IP/control就行,格式一模一样。
总结
对接“壁挂式红外雷达联动控制器”调节灵敏度,本质上就是学会发两条命令:
调反应快慢:改
infrared_change_1(有人持续时间)。调延迟长短:改
infrared_change_0(无人持续时间)。
把这个逻辑写进你的后台管理界面里,给用户做个滑动条,比如“延迟关灯:30秒/1分钟/5分钟”,然后后台根据选择自动拼装上述的JSON发出去,整个对接就完成了。