芯步的雷达人体感应器开放HTTP接口，支持向任意服务器推送状态数据，也支持接收外部指令控制电器通断。以下方案围绕“状态回调+指令下发”的核心链路展开，说明如何在不依赖云平台的情况下，自主搭建联动服务。
解决方案：基于芯步开放接口实现“人走断电”联动控制
1. 概述
本方案的目标是利用芯步智能人体存在雷达传感器（壁挂版） 的精准探测能力，结合其开放的 HTTP API接口，通过用户自有的服务器（或局域网服务器）实现逻辑判断，最终控制智能墙壁插座/开关执行断电/通电操作。
该方案的核心优势在于：数据私有化、低延时、可二次编程，适用于办公室、会议室、卫生间等场景，杜绝电器待机电耗和火灾隐患。
2. 硬件与选型
要实现“人走断电”，需要两类设备配合，均需支持芯步的开放接口协议：
传感设备智能人体存在雷达传感器2[壁挂] （型号：UNI-CGQ-RT-L-BG2）。推荐选择双模版（红外+雷达），能检测微动呼吸，避免“人静坐不动时误判为无人”。
执行设备智能WiFi墙壁插座/开关。用于切断电器的火线。可根据负载选择对应规格，如10A/16A版本。
3. 接入架构原理
采用标准的 “传感-平台-处理-执行” 架构：
状态上报：传感器探测到人体状态变化（有人->无人，或无人->有人）时，立即向用户自建的服务器推送状态数据。
逻辑判断：用户服务器接收到“无人”信号后，不立即断电，而是根据设定的延时时间（如5分钟）进行倒计时，确认持续无人后再下发指令。
指令下发：服务器通过调用芯步的
device/controlHTTP接口，向指定的插座/开关下发{"power":0}命令。
4. 详细接入步骤
4.1 准备工作：获取密钥与设备ID
在开始开发前，需要从芯步控制台获取以下三个关键信息，这是所有接口调用的凭证
AppID：你的应用唯一标识。
AppSecret：接口调用的签名密钥（严禁泄露）。
设备ID （Device ID）
人体传感器的ID（例如：
1100682）。墙壁插座的ID（例如：
1100893）。
4.2 配置消息推送接口（接收传感器数据）
为了让服务器能收到传感器状态，需要配置消息推送URL（Webhook）。
配置方式：在芯步控制台 -> 工作台 -> 项目设置 -> 消息推送中，填入你的服务器公网地址（或局域网地址），例如：
http://your-server-ip：8080/api/sensor/callback。接收的数据格式：当传感器探测到无人时，你的服务器会收到如下JSON格式的POST数据
4.3 业务逻辑：延时断电算法
为了避免在有人短暂离开（如去上厕所）时误断电，需要在服务器端实现延时逻辑。
业务流程图解：
传感器上报
{“radar_target”： 0}（无人）。服务器记录“无人”状态，启动倒计时（如 300秒）。
如果在300秒内收到
{“radar_target”： 1}（有人）：取消倒计时，不做任何操作。如果倒计时归零：执行断电脚本。
4.4 下发断电指令（调用控制接口）
当服务器逻辑判断需要断电时，向芯步API发起请求，控制插座断电。
接口地址：
https://api.thingboot.com/{AppId}/device/control/？sign={sign}&ts={ts}请求方式：
POST请求参数示例假设要将ID为
1100893的插座关闭，命令如下签名算法：为了保证安全性，每次请求需要携带签名。算法为
Sign = md5（md5（AppSecret） + ts）。注意：ts为Unix时间戳，需与请求时间误差在合理范围内。
4.5 局域网与私有化部署（进阶）
如果对数据隐私或网络稳定性要求比较高，可以利用芯步的局域网功能。
做法：设备支持纯局域网工作。在部署时，将传感器、插座、服务器置于同一网段。服务器直接通过设备的局域网IP进行HTTP请求，整个过程不经过芯步外网云端，实现100ms内的极速联动。
5. 关键配置优化
为了提升体验，在控制台或通过接口配置传感器的以下参数
| 配置项 | 推荐值 | 作用 |
|---|---|---|
| 红外无人触发持续时间 | 60s ~ 300s | 调整“无人”状态上报的延迟，避免频繁触发开关动作。 |
| 雷达灵敏度 | 中/高 | 确保检测到办公桌下的微动(如打字、翻身)，防止人在灯灭。 |
| 本地联动（场景联动） | 开启 | 可设置在传感器探测到无人时，插座指示灯变为红色，方便巡检。 |
6. 故障排查与维护
问题1：人还在，电却断了。
原因：雷达传感器安装高度或角度不对，或灵敏度设置过低。
解决：检查安装位置，确保雷达波覆盖主要活动区域；在后台调高雷达灵敏度；适当增加服务器端的“断电延迟”逻辑时间。
问题2：接口调用返回签名错误。
原因：AppSecret拼接顺序错误或MD5计算有误。
解决：严格按照
md5（md5（AppSecret） + ts）的顺序进行双重MD5加密，注意是字符串拼接后再加密。
问题3：设备离线。
原因：WiFi信号弱或断电。
解决：设备仅支持2.4G WiFi，确保覆盖。利用API中的
{“system”：“network”}命令检查设备网络状态。
通过上述方案，你可以在自己的业务系统中快速集成“人走断电”功能。芯步的开放接口极大地降低了硬件对接门槛（标准HTTP协议），使得开发者无需关心底层硬件驱动，只需关注业务逻辑（延时、防误判、统计）即可实现稳定的物联网控制闭环。