芯步的高精度人体微动传感器基于毫米波雷达技术，可探测呼吸级微小动作，区别于传统红外PIR传感器。其开放HTTP接口支持数据主动上报和指令双向控制，为二次开发提供了灵活的集成基础。

1. 产品内核与技术优势

在开始二次开发之前，理解硬件本身的能力边界是关键。芯步的高精度传感器（如UNI-CGQ-RT-XD-L等型号）与传统红外传感器（PIR）有本质区别：

• 核心技术：采用毫米波雷达，感知的是多普勒频移。这意味着它不仅检测“移动”，还能检测“存在”（如呼吸引起的胸腔起伏）。

• 核心优势：实现“微动”探测（探测距离通常为4-5米），解决了传统传感器下“人静止不动时灯熄灭”的痛点。

• 执行能力：设备自带AC电源输出（继电器），可直接控制灯具或电器。但二次开发的精髓在于利用API绕过物理继电器，实现软件层面的逻辑控制。

2. 二次开发的核心设计

在二次开发中，不直接将传感器数据发送到公网云平台（延时较高），而是采用局域网轮询+边缘网关架构。

推荐架构模式

端侧（传感器） → 边缘网关（运行您的脚本/服务） → 执行设备（控制器/喇叭）

数据流向解析

1. 状态上报：当雷达探测到“有人”或“无人”时，传感器向预设的HTTP服务器（即您的网关）发送实时数据。

2. 逻辑判断：您的网关程序接收数据，执行自定义逻辑（如延时去抖、状态机判断）。

3. 指令下发：逻辑触发后，网关调用芯步API，控制传感器自带的继电器或其他局域网内的智能设备。

3. 环境搭建与签名算法实现

所有二次开发均基于HTTP接口。无论是接收数据还是下发指令，都需要处理身份验证。

3.1 准备凭证

在芯步开发者后台获取：

• AppID：应用的唯一标识。

• AppSecret：用于加密的密钥。

3.2 核心签名算法

为了防止接口被恶意篡改，所有下发指令需动态生成签名 sign。算法逻辑如下

3.3 数据接收（Webhook配置）

传感器数据上报是二次开发的输入源。

• 配置方式：在设备管理后台，将“数据上报URL”指向您的服务器地址：http://<你的网关IP>:8080/sensor/callback

• 上报格式示例

• 处理：程序接收到此JSON后，解析 status 字段，触发后续联动任务。

4. 实现自定义联动操作

这是解决“如何实现自定义逻辑”的核心。不应仅满足于“有人开灯”，可以进行更复杂的逻辑设计。

4.1 第一种场景：无人超时渐进关灯

痛点：雷达探测“无人”通常有延时，且关灯即全黑体验不佳。解决方案：编写“延时状态机”。

4.2 第二种场景：有人但休眠（夜灯模式）

痛点：午休或夜间观影时，检测到微动不应开主灯。解决方案：引入“时间窗口”与“系统状态”变量。

4.3 第三种场景：HTTP接口下发指令

当逻辑判断满足条件时，调用API控制设备。

• 请求地址https://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}

• 请求Body

进阶命令：如果需要让传感器自带的继电器实现“点动”（如按一下门铃响一声），可使用延时命令

5. 高级优化：数据滤波与场景联动

5.1 针对环境抖动的滤波

雷达模块在探测边缘区可能产生状态快速切换（抖动）。在代码中引入确认计数器

5.2 跨设备生态融合

芯步的API是通用的，您可以将人体传感器与8路控制器结合。

• 场景：办公室无人时，不仅关灯，还要通过 {"power2":0} 关闭排插、空调、投影幕布。

• 代码扩展

6. 总结

通过二次开发芯步高精度人体微动传感器，开发者本质上是在构建一个“基于微动雷达的事件驱动架构”。重点是区分运动和微动的不同处理逻辑，利用好签名机制保证接口安全，并将简单的状态上报转化为符合业务场景的、具有延时和滤波特性的自定义动作。