一、先说痛点：为什么普通人体传感器不够用？
咱们先聊个实际场景。你有没有遇到过这种情况：在书房看书或者卫生间蹲坑，稍微安静一会儿，灯突然灭了？还得挥挥手才能重新亮起来？
这就是普通红外传感器的痛点——红外感应是靠检测人体移动的。一旦你安静下来（比如看书、冥想、蹲坑），红外就“看”不到你了，系统以为没人，就把灯关了。
芯步这款壁挂式红外雷达双模探测器（型号UNI-CGQ-RT-H-BG）就是来解决这个问题的。它除了红外，还加了一个雷达模块。雷达有个好处，它能检测到人体的微动——比如呼吸时胸口的起伏、身体轻微的挪动。哪怕你坐那儿一动不动看书，雷达也知道你在。
双模的逻辑是：红外和雷达同时探测不到人了，才判定为无人。这就大大减少了“误判无人”的情况。
二、硬件长啥样？有啥接口可以用？
这款传感器有几个关键特性，咱们得先搞清楚：
供电方式：直接接AC 100-250V市电，也就是家里/工位的零火线。不用换电池，这点好评。
输出带载：它自带一路电源输出（继电器），可以直接控制照明或其它电器，负载最高2200W阻性负载。换句话说，你可以把灯直接接在它后面，有人亮灯、没人关灯。
通讯方式：WiFi 2.4GHz，直连路由器，不需要网关。这点很方便，家里有个WiFi就能用。
开放接口：这是核心——设备状态变化时（比如有人/无人），它会主动往你的服务器推数据；你也可以通过HTTP接口远程控制它。
咱们主要关心的是怎么把它接到你自己的项目里，对吧？那就接着往下看。
三、接入方案：两种玩法
方案A：设备主动上报（推荐，最省事）
这是最符合“智能家居”思路的方式。传感器的逻辑是这样的：
有人在，红外或雷达触发。
传感器判断状态变化（无人→有人，或有人→无人）。
传感器主动往你配置的服务器地址发一条HTTP POST请求，告诉你当前状态。
你的服务器收到数据后，自己决定要不要开灯、关灯，或者干点别的。
这个方式的优点是：你不用轮询，设备自己会来找你。你只需要搭一个接收接口就行。
具体怎么配置上报地址？通常在芯步的控制台里，把你的设备绑定后，可以设置一个“数据接收URL”。填上你的服务器地址（比如http://你的域名/api/sensor/callback），设备一有变化就会往这儿发。
上报的数据格式大概是这样的（具体以官方文档为准）：
你的后端收到后，存一下状态，然后决定要不要控制灯或其他设备。
方案B：主动查询/远程控制
有些场景下，你可能想主动问一下“现在有没有人”，或者远程强制关掉继电器。这时候就用HTTP接口来下发命令。
芯步的接口设计得还算清爽，核心请求地址是：
签名算法稍微有点绕，我给你捋一下：
先把你的
AppSecret（在控制台拿）做一次MD5。然后把结果拼上当前的时间戳
ts（秒为单位）。再把拼好的字符串整体做一次MD5，这就是
sign。
用伪代码表示：
请求体是JSON格式，需要传device（设备ID）和order（命令）。
常用的命令（针对这款传感器）
| 命令 | 说明 | 取值示例 |
|---|---|---|
power | 控制继电器输出（也就是控制接在上面的灯） | {"power": 1} 开灯；{"power": 0} 关灯 |
radar_enable | 开关雷达模块 | {"radar_enable": 1} 开启；0关闭 |
infrared_enable | 开关红外模块 | {"infrared_enable": 1} 开启；0关闭 |
举个实际的curl例子（假设你已经算好了sign和ts）：
这条命令会远程打开接在传感器上的灯。
四、完整的联动逻辑：画个流程图
咱们把“人来灯亮、人走灯灭”这个最经典的场景串一遍：
实际上，如果你不想写代码，还有一种更简单的做法：直接用传感器自带的继电器。它本身就有AC输出，你把灯的火线串到传感器的输出上，然后在设备里配置一下“有人通电、有人断电”就行。这样完全不用服务器参与，纯硬件就搞定了。
但咱们既然是讲“接入到项目中”，说明你肯定想把数据拿到自己手里，做更多的玩法，比如统计每个房间的使用频率、联动空调、安防报警什么的。
五、一些实战小
1. 安装位置有讲究
这款是壁挂式的，装墙上。雷达可以穿透玻璃、薄木板，但金属和厚墙体不行。卫生间装的话，别正对淋浴喷头——水流也会被雷达误判成“微动”。
2. 双模虽然好，但也别浪费
如果你只需要人来就走、灯就灭的场景（比如走廊），其实单红外就够了。但如果你要做办公室工位占用检测、卫生间蹲位检测这种要求“人不动也不能关灯”的场景，必须上双模。
3. 接口调试注意签名
这是最容易踩坑的地方。芯步的签名是md5(md5(AppSecret) + ts)，不是常见的md5(AppSecret + ts)。多套了一层。调试的时候可以先在控制台看设备日志，确认设备在线，再排查签名。
4. 局域网和私有化部署
如果你项目的服务器和设备在同一个局域网，芯步的设备是支持局域网直接调用的。不需要走云端，延迟更低，也安全。具体做法是把请求地址从api.thingboot.com换成设备的内网IP。
六、总结一下
把这款红外雷达双模传感器接入项目，本质上就三步：
配网：给传感器通上电（接零火线），通过芯步的控制台把它连上WiFi。
配置上报：在控制台设置你的服务器回调地址，让设备状态变化时主动来找你。
写后端逻辑：接收回调数据，处理业务逻辑（比如开灯关灯），必要时调用控制接口。
最核心的好处是开放接口+双模检测：开放接口意味着你拿得到数据，双模意味着数据靠谱（不会误判无人）。把这俩用好，智能照明的体验就能上一个大台阶。
有啥具体问题，可以直接问芯步的工程师——他们号称全程技术指导，别不好意思薅。