智能化改造人体感应场景：怎么将壁挂式智能人体感应器对接到自己的项目中_解决方案

CATALOG

芯步的壁挂式人体传感器采用HTTP API + 消息推送的双向通信模式，上行（传感数据）和下行（设备控制）分离，集成逻辑清晰。以下方案涵盖设备选型、接口对接、数据接收和场景联动四个环节。

在开始对接前，需要对芯步的 UNI-CGQ-RT-BG-HL（红外+雷达）或类似壁挂型号进行技术评估。

核心优势
- 免网关直连：设备自带WiFi模块，直接连接2.4G网络，减少了网关硬件成本和故障点。
- 混合探测：结合了PIR（被动红外）和雷达（毫米波）技术。相比纯红外，雷达能探测微动（如呼吸、翻书），解决红外传感器在“人静坐不动”时误报为“无人”的痛点。
- 私有化部署：支持将消息推送至你自建的服务器（Private Server），数据不经芯步云端，满足企业数据安全合规要求。
架构模型
- 上行（数据上报）：传感器探测到有人/无人变化时，主动 HTTP POST 你的公网服务器地址。
- 下行（远程控制）：你的服务器通过调用芯步API，修改传感器参数（如灵敏度、LED指示灯开关）。

在编写代码前，需要在芯步开放平台完成以下预备步骤，这是打通数据流的关键：

注册与创建工作台：登录芯步官网，进入控制台。
获取密钥（AppID / AppSecret）
- 在“开发设置”页面，获取 AppID 和 AppSecret。
- 签名算法：后续API调用需携带签名 sign = md5(md5(AppSecret) + ts)。这是一种防篡改机制，确保请求合法性。
配置消息推送URL（关键步骤）
- 在控制台设置 HTTP推送地址。例如：https://api.yourdomain.com/api/sensor/callback。
- 这一步相当于告诉芯步云：“以后这个设备的数据，都发到这个网址”。
设备配网：给壁挂传感器上电，用手机App或微信小程序配置WiFi，确保设备在线。

本场景的核心是实现“环境感知 -> 数据通讯 -> 业务触发”的闭环。

当有人走过或雷达检测到微动时，设备状态改变，芯步云会立即向你的服务器推送如下结构的JSON数据

服务器处理逻辑（伪代码示例）：

有时候你需要反查设备状态（如定时巡检）或远程修改灵敏度。

请求示例：

地址https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}
Method：POST
Body (JSON)
{ "device": "155171", "order": { "radar_enable": 1, // 启用雷达模块 "led": 0, // 关闭LED指示灯（防止光污染） "relay_change_0": "no" // 无人时线路无动作 } }
注意：不同型号（壁挂/吸顶）支持的命令略有差异，可通过控制台的“产品手册”查看具体物模型，如“红外有人触发持续时间”等可配置参数。

如果你要求数据绝对不能出公司内网（如涉密实验室、数据中心）：

场景：智慧办公室节能与安防联动

人 vs. 存在的区别：该传感器同时具备红外和雷达，红外适合探测“移动的人”，雷达适合探测“静止的人”（如睡觉、办公）。业务逻辑中优先判断 radar_target，或做“或”运算，以减少漏报。
去抖动处理：传感器可能在“有人/无人”边界频繁跳变（例如窗帘飘动）。在服务器端引入 延时确认 逻辑，例如连续3次（3秒内）均为“无人”，才确认“无人”事件，避免频繁触发关闭指令。
调试模式：开发阶段，在控制台打开“调试模式”（此时不校验时间戳和签名），可以先用Postman快速调试通业务逻辑，最后再开启鉴权上线。
数据安全：签名算法 md5(md5(AppSecret) + ts) 中，ts 是Unix时间戳（秒）。请一定要确保你服务器时间与北京时间同步，误差过大会导致 bad ts 错误。