这是一份关于接入芯步智能人体存在传感器[吸顶][雷达版]（型号：UNI-CGQ-RT-XD-L）来实现人体微动探测的解决方案。
我们会从硬件准备、接口原理、代码实操到场景联动，一步步说清楚。尽量说得白话一点，让你拿起来就能用。
一、 我们到底要解决什么问题？
在开始敲代码之前，咱们先对齐一下目标。你买的这款吸顶雷达传感器，和普通的几十块钱的人体红外传感器（那种动不动就误判、人坐着不动就变“无人”的）最大的区别在于：它能探测到“微动”。
传统红外（PIR）：只能探测移动。如果你在办公室敲键盘、在沙发上看书，稍微动作小点，它就以为你走了，结果灯灭了，空调关了，体验很差。
这款雷达传感器：探测存在。它是通过毫米波雷达技术，能感知呼吸带来的胸腔起伏这种极其微小的动作。只要你人在房间，不管是站着、躺着还是在睡觉，它都能判定为“有人”。
所以，我们的核心任务就是：把这台设备接入你自己的服务器，实时接收它上报的“有人/无人”状态，或者主动去问它“屋里到底有没有人”。
二、 准备工作：硬件与接口认知
在动手写代码前，我们先确认一下手头的家伙事儿。
1. 硬件特点
安装：吸顶安装，也就是装在吊顶上。
供电：接的是家里的 AC 100-250V（也就是市电220V） ，它内部有一路继电器输出，如果不想写代码，可以直接接灯线实现“人来灯亮”；如果你是想搞软件集成，那根线可以不接。
连网：只支持 WiFi 2.4G，不需要网关，直接连路由器就行。
2. 核心接口机制这款产品最良心的地方是开放HTTP接口，而且支持私有化部署。这意味着：
数据不经过芯步的云（当然也可以用他们的调试），直接推送到你自己的服务器IP或域名上。
只要是支持HTTP请求的语言（Java, Python, PHP, Node.js, C#...）都能接。
三、 接入逻辑：推（上报） vs 拉（控制）
接入物联网设备主要分两步走，搞清楚这两步，你就算掌握精髓了。
第一步：让设备找到你家（设置上报URL）设备上电联网后，它得知道把数据发到哪里去。你需要在芯步的后台或者通过配网，把设备的数据上报地址设置为 http://你的服务器IP/api/report 。一旦设置好，只要传感器探测到“从无人变成有人”或“从有人变成无人”，它就会立刻给你这个地址发一个POST请求。
第二步：你主动去问它（下发查询/控制命令）有时候你不想等它上报，比如系统启动时想知道当前状态，或者你想远程关闭雷达模块省电。这时候你需要调用芯步的开放API接口，向设备下发命令。
四、 实战演练：如何对接“微动探测”
这里我们分为 “接收数据” （被动）和 “发送指令” （主动）两部分。
第一种场景：接收数据——感知“谁进来了”
这是最常用的场景。当有人进入吸顶雷达下方5米范围内，或者哪怕只是安静地坐在那里，设备状态变化了，它会主动喊你。
1. 设备会发什么数据？设备会向你的服务器发送一个JSON包，里面包含了当前的“状态属性”。
根据产品手册，核心字段如下
| 属性 | 值 | 含义（这就是你需要的核心逻辑） |
|---|---|---|
infrared_target | 1 / 0 | （注：吸顶雷达版主要看雷达参数，但物模型通常兼容） 如果是纯雷达版，主要看雷达事件。 |
radar_target （推测/逻辑） | 1 / 0 | 1 = 探测到人体微动（有人）；0 = 无人。 |
power | 1 / 0 | 1=线路接通（如果接了灯，灯亮）；0=断开。 |
小提示：对于雷达版，重点抓取人体存在探测相关的字段。只要雷达判定有人，radar_target 就会是 1。
2. 写代码接收数据（Python Flask 示例）假设你用Python，写一个极简的web服务来接收传感器的“告白”。
第二种场景：下发命令——主动“问一句”或“调个参”
有时候你需要主动控制，比如老板来了，你想强制开启雷达探测模式；或者你想重启设备。
1. 接口鉴权（必看，稍微有点绕）芯步的接口安全性做得不错，需要携带签名 sign。签名的生成规则是sign = md5( md5(AppSecret) + ts )
翻译一下：先把你的密钥（AppSecret）做一次MD5，得到一个字符串，然后在这个字符串后面拼接上当前的时间戳（ts），把拼接后的新字符串再做一次MD5。
2. 发送“查询状态”命令假设你想立刻知道现在房间里有没有人。
请求地址https://api.thingboot.com/{你的AppId}/device/control/?sign={你的签名}&ts={当前时间戳}
请求体 (JSON)
3. 设置“灵敏度”或“节能模式”虽然雷达是硬件级微动探测，但你可以通过命令关闭它。如果你想在上班时间关闭探测（省电）：
五、 避坑指南与最佳实践
这些经验你不实际摸一把可能不知道，我提前告诉你：
“微动”不是“不动”虽然是雷达，能探测呼吸，但它对安装高度和角度有要求。吸顶安装时，安装高度在 2.5米 - 3米 左右。装太高了，正下方的人呼吸幅度可能难以捕捉；装太低了，探测范围小。
私有化部署很爽如果你对数据隐私要求高（比如是商业项目或者自己就是极客），这款设备支持局域网纯内网通信。设备配网时，把数据服务器地址填成你电脑的局域网IP就行（比如
http://192.168.1.100:8080），即使断外网它也照常工作。关于去抖（Debounce）普通红外人一走过，状态乱跳。雷达版比较稳，但也可能在“有人”和“无人”的临界点波动。在接收端（你的代码里）做一个延时逻辑。例如：收到“无人”信号后，不要立即关灯，等待 30秒 如果期间没有再收到“有人”，再去执行关灯动作。
利用 AC 输出做本地联动（备选方案）这款设备自带一路220V 输出。如果你只是为了实现人来灯亮，人走灯灭（且灯功率不超过 300W LED），完全不需要写代码！直接把火线进线接在输入端，灯的火线接在设备的“输出端”即可。写代码是为了把数据送到你的 HomeAssistant、Node-RED 或者你自己的 SaaS 平台。
六、 总结
接入芯步这款雷达传感器，其实就是一句话：配置好URL，接收 POST 请求，解析 JSON 里的雷达状态字段。
它的雷达技术能让你彻底告别“坐着不动就熄灯”的尴尬。先去后台把 AppID 和 Secret 拿到手，搭一个简单的 Web Server 打印一下 print(request.data)，看到数据推过来的一瞬间，你就会觉得：也就这么回事嘛！