芯步的壁挂式双功能传感器（红外+雷达）通过开放 HTTP 接口，可方便地集成到第三方系统中实现人体存在监测。以下是完整的对接方案，涵盖设备原理、接口对接流程、签名算法及典型应用场景。
1. 背景与设备概述
在智能楼宇、节能办公、智慧安防等场景中，准确监测人体是否存在是自动化控制的基础。传统的红外传感器（PIR）在人体静止时容易产生误判（例如人员静坐办公时判定为无人），而单纯的雷达传感器虽然能感知微动，但在某些场景下可能存在干扰。
芯步的 壁挂式双功能传感器（型号：UNI-CGQ-RT-H-BG）结合了红外传感与雷达传感双模技术。其核心特性如下：
双重确认机制：红外检测人体移动，雷达检测人体微动（如呼吸、心跳或微小肢体动作）。只有当两者均判定为无人时，才确认“无人”状态。这解决了人员静坐或睡眠状态下传感器误报“无人”的痛点 。
本地联动执行：设备自带一路 AC 输出（可控继电器），可直接接照明或排插。即使断网，也可根据本地探测逻辑执行“人走灯灭”或“人走断电”。
API 驱动：支持通过 HTTP 接口远程读取状态、下发命令及设置联动场景 。
2. 对接准备与前置条件
在开始对接开发前，请完成以下物理与账号层面的准备工作：
设备安装与配网
接线：设备需接入 AC 100-250V 市电。请请一定要在断电状态下，将火线、零线接入对应端口。如需控制灯负载，将负载线接入继电器输出端 。
联网：使用“芯步”小程序或物联网控制台，为设备配置 2.4GHz WiFi 网络。
注册与凭证获取
登录芯步官网并注册账号，创建一个“工作台”。
在“物联网控制台”的“开发设置”中，获取以下关键凭证：
AppID：应用的唯一标识。
AppSecret：用于接口签名加密的密钥（请妥善保管）。
设备ID：在控制台设备列表中，获取传感器的唯一标识符（Device ID）。
3. 接口对接核心流程
该设备的开放接口基于 HTTP 协议，任何支持 HTTP 请求的编程语言（Java, Python, PHP, Node.js, C#等）均可轻松集成。
3.1. 签名机制
为防止接口被恶意篡改，每次请求都需要携带动态签名。签名生成逻辑如下：
将
AppSecret进行一次 MD5 加密。将加密后的字符串拼接当前时间戳
ts（秒级）。再将拼接后的字符串整体进行 MD5 加密，得到最终签名
sign。
公式Sign = md5( md5(AppSecret) + ts )
验证：后端接收到请求后，会以同样的算法计算签名，若一致则请求合法。
3.2. 方案一：被动接收数据（推荐）
为了实时获取人体感应的变化，在控制台设置 “消息推送URL” （Webhook）。当传感器探测到有人或无人时，平台会主动向你的服务器推送状态变化数据。这种方式下，你无需频繁轮询，服务器压力最小。
推送数据示例：当有人进入探测区，你的服务器会收到类似
{"device_id":"xxx", "status":"someone", "type":"radar+infrared"...}的 JSON 数据包。
3.3. 方案二：主动查询与控制
当你需要主动获取当前传感器状态或设置传感器参数时，调用 HTTP 接口。
请求地址
https://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}请求方式：POST
请求头
Content-Type: application/json
场景 1：查询/控制继电器输出
如果你想远程关闭该传感器所控制的灯光，可以下发 power 命令。
请求体
场景 2：调节传感器灵敏度/开关
有时候你需要远程禁用雷达模块以防止误报（例如在有风扇摆动的区域）。虽然设备本身通过逻辑判定“有人”，但管理员可通过 API 强制调整模块状态。
请求体
4. 典型应用场景解决方案
以下是利用该传感器 API 解决实际问题的两个经典案例：
第一种场景：办公室/宿舍节能策略（人走断电）
痛点：下班后空调或照明未关，造成能源浪费。方案逻辑
状态获取：你的后端服务器接收传感器上报的“无人”事件。
延时确认：系统收到“无人”事件后，等待 5-10 分钟（防止短暂离开），再次通过 API 查询一次设备状态以作双重确认。
执行动作：确认无人后，你的系统调用控制接口，向智能插座或智能墙壁开关下发关闭指令
{"power":0}。
第二种场景：卫生间/更衣室灯光自动化
痛点：人坐在马桶上不动，普通红外灯灭了，需要挥手才能重新亮起。方案逻辑
双模判定：传感器双模逻辑在本地生效（红外+雷达）。当人静止时，雷达依然能探测到存在，传感器本地判定状态为“有人”。
状态同步：设备将“有人”状态通过 HTTP 推送给服务器。
保持供电：系统无需额外处理，因为设备本地的继电器在逻辑判定为“有人”时保持闭合，灯光常亮。当人离开且雷达确认无微动后，继电器断开 。
5. 开发调试和需要注意的点
错误码处理
调用接口时若返回
5006，表示bad sign，请检查 MD5 拼接顺序（先 MD5 密码再拼接时间戳）。若返回
5008，表示 IP 不在白名单，请在控制台将你的服务器出口 IP 加入白名单 。
数据格式
无论是下发指令还是接收推送，涉及中文或特殊字符时，请确保使用 UTF-8 编码。
时间戳
ts使用东八区时间。
多设备管理
device参数支持批量控制，格式如"device": "1001,1002,1003"，可同时控制多个传感器或联动设备 。
MQTT 接入（进阶）
如果对实时性要求比较高，芯步也支持 MQTT 协议接入。端口
1883，用户名密码即为 AppID 和 AppSecret，订阅主题即可实时收到设备上报 。
6. 总结
通过对接芯步壁挂式双功能传感器，开发者可以利用标准 HTTP 协议快速实现“人体存在感知”能力。该方案的核心优势在于：
高可靠性：红外+雷达“双模”技术，有效避免静止误判。
低成本对接：签名逻辑简单，只要有基础网络编程能力即可完成。
软硬一体：既能软件上报数据，又能硬件本地执行，断网不断逻辑。
开发者在对接初期，先在芯步控制台进行命令调试，确认设备响应正常后再着手编写代码逻辑。