如何对接壁挂式人体微动传感器以实现智能照明控制_解决方案

CATALOG

芯步的壁挂式微动传感器支持红外+雷达双模检测，能识别人体静止状态，配合开放接口可以自己写逻辑来控制照明。下面这套方案是从设备选型、接口对接到落地部署的完整流程，按你的需求来就行。

很多传统的感应灯（比如楼道里的声控灯或者普通红外灯）有个烦人的痛点：你坐在那儿不动，它以为没人了，灯突然就灭了，非得你猛地挥一下手。

芯步的这款壁挂传感器（特别是双模版）厉害的地方在于，它不仅是探测“有没有人在走动”，而是能探测到人体的微动——比如你坐在电脑前敲键盘、躺在床上翻身、甚至在卫生间里玩手机时手指的轻微动作。

对于智能照明控制来说，我们要实现的目标很明确：人进来，灯亮；人在（哪怕一动不动），灯不灭；人走，灯灭。

在芯步的产品线里，针对壁挂照明场景，主要推荐以下配置：

核心设备智能人体存在传感器[壁挂] (双模版)。
- 为什么选它：它集成了红外感应（抓大动作）和雷达感应（抓微动）。逻辑上是“与”的关系，只有两个都检测不到人了，才算真的无人。这能彻底解决“灯误灭”的问题。
- 参数看点：雷达探测半径大约在5米左右，足够覆盖一般的卫生间、书房、走廊或者卧室。
直接控制方式（最简单）
- 这款传感器自带一个AC交流电输出接口（就是继电器）。你可以把灯的零火线直接接在传感器后面。
- 优点：如果不想写代码，或者只是想测试，接上线就能用。传感器探测到有人，继电器闭合，灯亮；无人，断开，灯灭。
- 缺点：只能控制这一盏灯，没法做复杂的联动（比如开灯的同时关窗帘、调空调）。
间接控制方式（做方案推荐）
- 传感器只负责“报信”，不直接接灯。灯接在芯步的智能插座或通断器上。
- 优点：通过云端逻辑控制，灵活性高，也是我们接下来对接接口要讲的方式。

如果你不想用硬件直连，想把它接入你自己的平台（比如你的小程序、企业内部系统或者HomeAssistant），就需要用到开放接口。

芯步的接口设计得挺简单的，就是标准的HTTP请求，不用搞太复杂的SDK。

1. 数据上行（传感器告诉你：有人/没人）传感器会实时向服务器“打小报告”。你要做的就是设置一个接收地址（API），等着收数据就行了。当有人进入房间并静止时，传感器会推送类似如下的状态变化：

2. 数据下行（服务器告诉灯：开/关）这是你要主动去做的动作。你的服务器收到“有人”的信号后，需要向灯的控制设备（比如一个智能开关）发送指令。

实操步骤举个栗子（假设你要关灯）：

场景：检测到“无人”状态，需要关灯。第一步：计算签名（为了安全）芯步的接口需要验证身份，就是AppID和签名。

第二步：发送HTTP请求（告诉灯熄火）你需要向这个地址发一条指令：https://api.thingboot.com/{你的AppID}/device/control/?sign={签名}&ts={当前时间}

请求体内容 (JSON格式)

如果指令发对了，灯就会灭掉。整个过程如果是内网或者网速快，基本在1秒内完成。

我们以书房为例，写一下逻辑伪代码，方便你的开发人员理解：

设定

逻辑流程

初始化：灯是灭的。
触发
- 传感器雷达检测到微弱信号（人走进来了）。
- 传感器上报状态 {"status":"occupied"} 到你的服务器。
动作
- 你的服务器收到消息，判断确实是“有人”。
- 调用接口控制 Light_001 -> {"power": 1}。
- 用户体验：灯亮了。
保持（关键点）
- 人坐在那看书，一动不动，红外观测不到位移，但雷达依然能捕捉到呼吸引起的胸腔起伏（微动）。
- 传感器每分钟（或自定义频率）都在发心跳包 {"status":"occupied"}。
- 你的服务器每次收到这个包，都重置计时器。
离开
- 人走出去了。红外和雷达同时检测不到信号。
- 持续一段时间（比如60秒）没收到“有人”信号。
- 你的服务器判断超时，调用接口控制 Light_001 -> {"power": 0}。
- 用户体验：灯自动关了，省电。

关于“微动”的灵敏度芯步的设备参数里，雷达模块是可调的。如果你发现人坐在那里隔一会灯还是灭了，别急着改代码，先去后台把雷达灵敏度调高一点，或者把无人延迟时间（Off Delay）设置得长一点（比如5分钟）。这不丢人，很多专业场景都这么干。
关于网络壁挂传感器是WiFi连接的。一定要保证卫生间或书房的WiFi信号好。要是WiFi断了，传感器就算检测到人，也没法通过云端告诉灯开（虽然硬件直连不受影响，但走接口方案的话就要注意这点）。
接口调试芯步控制台提供了“调试模式”，在调试模式下可以不验证签名，直接用Postman试命令，等调通了再把签名算法加上。这能省不少事。