芯步的高精度人体微动传感器采用“设备主动上报+HTTP API反向控制”架构。以下方案涵盖硬件选型、上报接收、签名计算及常见问题处理，帮助快速完成对接。
解决方案：基于芯步开放接口对接高精度人体微动传感器
1. 概述
本方案的目标是指导开发者如何利用芯步提供的开放 HTTP 接口，将 高精度人体微动传感器（如雷达传感器）集成到自有系统中。
核心逻辑
设备侧：传感器实时探测区域内的人体存在状态（运动/微动/静止/无人）。
上报侧：状态发生变化时，传感器通过芯步云端，向你的服务器推送状态数据。
控制侧：你的服务器可反向调用接口查询状态或控制传感器参数（如灵敏度）。
2. 硬件选型
针对“高精度”和“微动”需求，选用以下类型的设备（基于芯步产品线）：
| 设备类型 | 核心探测能力 | 适用场景 | 关键特性 |
|---|---|---|---|
| 智能人体存在雷达传感器2 [壁挂] | 4米内人体微动，6米内运动感应 | 卫生间、卧室、办公室 | 体积小，纯雷达探测，隐私性好 |
| 智能人体存在传感器[吸顶][雷达版] | 5米内人体微动 | 会议室、走廊、大堂 | 吸顶安装，覆盖角度广，美观 |
| 智能人体存在传感器[壁挂] (双模) | 红外+雷达双重确认 | 高可靠性场所（如机房） | 降低误报，需两者同时判定无人 |
技术特性
微动检测：能够检测到呼吸等胸腔起伏动作，避免“静坐不动被判定为无人”的尴尬。
上报机制：支持实时状态上报（HTTP/HTTPS）。
3. 对接流程详解
3.1 前置准备
在芯步开放平台完成以下步骤：
注册/登录：进入芯步开放平台控制台。
获取凭证：在“开发设置”中获取
AppID和AppSecret。这是所有API调用的钥匙。设置推送URL：在“消息推送”配置中，填写你的服务器公网接收地址（例如
http(s)://yourdomain.com/api/sensor/callback）。添加设备：在控制台绑定你的高精度传感器硬件，获取
Device ID。
3.2 数据上行：接收人体存在状态上报
这是最重要的一环。当有人进入或离开探测区域时，芯步云端会主动向你的服务器发起请求。
请求方式：HTTP POST
Content-Type：application/json
推送数据结构示例
服务器处理要求
接收请求后，解析 JSON 中的
message.data字段。根据
radar或presence字段值判断有人/无人。重要：你的服务器必须在 5 秒内返回
HTTP 200 OK状态码，无其他返回值要求。若不返回，平台判定推送失败 。
3.3 下行控制：反向配置与查询
系统可以通过 HTTP 接口反向控制传感器（如开关雷达模块）。
请求地址
https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}签名算法
将
AppSecret进行一次 MD5 加密：secret_md5 = md5(AppSecret)。拼接时间戳：
sign_str = secret_md5 + ts。再次进行 MD5：
sign = md5(sign_str)。注：ts为 Unix 时间戳（秒）。
场景示例：关闭雷达模块（停止探测）
4. 典型应用场景联动逻辑
以智能卫生间管理为例：
设备安装：在天花板安装“吸顶雷达版”传感器，接入市电，连接排气扇/灯具到传感器负载端。
状态上报
无人 -> 有人：传感器上报
radar:1，服务器记录“开始使用”，开启灯光。有人（静止/微动）：持续上报存在，保持灯光。
有人 -> 无人：传感器上报
radar:0，服务器记录“结束使用”，关闭灯光和排风扇。
代码逻辑伪代码
5. 注意事项与最佳实践
1. 双模传感器的处理如果使用的是 红外+雷达双模 传感器，data 数组中可能包含两个判定结果。此时逻辑为：只要雷达检测到有人（radar:1）则判定为有人；若雷达为 0 且红外为 0，才判定为无人，以提高抗干扰能力 。
2. 网络稳定性
设备仅支持 WiFi 2.4GHz，不支持 5G 。
支持局域网通信，若你的服务器与设备在同一局域网，可配置局域网 IP 直接通信，降低延迟且不依赖外网。
3. 微动探测距离
严格注意“微动”和“运动”的区别。宣称 6 米通常是挥手等大动作，4 米 以内才能稳定检测到静坐、呼吸等微动 。安装高度在 2-3 米左右。
4. 防误报
避免传感器正对空调出风口、暖气片、大幅摆动的窗帘或宠物活动区，这些可能会触发雷达误报 。
通过以上步骤，你可以快速将芯步的高精度雷达传感器无缝融入现有系统，实现真正的“存在级”智能感知，而非简单的“运动感应”。