CATALOG

芯步的壁挂式红外雷达联动控制器支持通过HTTP接口远程调节感应灵敏度,核心是修改设备配置项中的infrared_change_1(有人触发持续时间)和infrared_change_0(无人触发持续时间)参数。下面是一份对接方案,偏实操向,可以照着一步步来。

1. 咱们先搞清楚:调节“灵敏度”到底调的是什么?

在开始敲代码之前,我们得先把概念对齐一下。很多客户问我“能不能调灵敏度”,其实在芯步的这个“双模”传感器(红外+雷达)里,没有直接的“灵敏度”旋钮,我们是通过调整触发持续时间来达到类似效果的

简单解释一下:

  • 红外有人触发持续时间 (infrared_change_1):这个参数决定了——传感器只要检测到人,就马上上报“有人”。但是为了防止瞬间误报(比如苍蝇飞过或者窗帘飘动),你可以让它“确认一下”。如果设置为“2s”,那就意味着红外和雷达都连续2秒检测到有活动物体,才上报“有人”。数值越大,对短暂干扰的过滤能力越强,但也越“迟钝”

  • 红外无人触发持续时间 (infrared_change_0):这个参数决定了——人离开后,传感器等多久才上报“无人”。如果你设置成“5m”(5分钟),那人走了之后,灯还会亮5分钟。这在做联动控制(比如关灯、关空调)时非常关键,可以防止人稍微不动就误判为无人。

所以,我们的对接目标,就是通过API修改壁挂式设备的这两个配置项

2. 动手前的准备工作(也就是鉴权,别怕,很简单)

芯步的接口是标准的HTTP API。不管是调灵敏度还是开关设备,核心都是发一条POST请求。你需要先准备好三样东西:

  1. AppID 和 AppSecret:登录芯步工作台 -> 物联网控制台 -> 开发设置。这里就是你的“身份证”

  2. 设备ID (Device ID):在控制台的设备列表里找到你要调的那个壁挂式控制器,设备ID通常是一串数字,直接复制就行

  3. 签名计算 (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. 两点要注意的小细节

在对接过程中,有两个坑稍微注意一下,能省不少事:

  1. 改的是“配置”,不是“状态”:像 infrared_change_1 这类参数属于产品的配置项。芯步的平台为了保护设备存储芯片,没有开放批量修改配置的接口。所以你每次改灵敏度,都需要像上面这样单独发一条指令。不过这对我们业务来说完全足够了。

  2. 私有化部署怎么办?:如果你是把系统部署在纯内网(局域网),用不了云API。别慌,芯步也支持局域网直接控制。这时候你需要找到设备的局域网IP地址,直接POST数据到 http://设备IP/control 就行,格式一模一样

总结

对接“壁挂式红外雷达联动控制器”调节灵敏度,本质上就是学会发两条命令:

  • 调反应快慢:改 infrared_change_1(有人持续时间)。

  • 调延迟长短:改 infrared_change_0(无人持续时间)。

把这个逻辑写进你的后台管理界面里,给用户做个滑动条,比如“延迟关灯:30秒/1分钟/5分钟”,然后后台根据选择自动拼装上述的JSON发出去,整个对接就完成了。