芯步的壁挂式人体存在传感器支持HTTP接口数据上报和设备控制，配备雷达模组可探测4米内微动、6米内运动感应。以下方案涵盖设备选型、接口对接、状态监测实现及联动配置。
1 概述
本方案的目标是指导开发者如何利用芯步开放平台，将智能人体存在传感器（壁挂） 快速接入自有软件系统，实现对特定区域人体存在状态的远程实时监测。通过开放的HTTP接口，用户可实时获取人员进出、在座/离座状态，并联动其他智能设备，适用于办公节能、居家看护、公共场所客流分析等多种场景。整个对接过程无需复杂网关，传感器通过WiFi 2.4GHz直连网络，具备“高精度探测”和“灵活部署”的特点。
2 适用硬件特性
为实现准确对接，需明确所选用传感器的核心能力。芯步提供的壁挂式人体存在传感器主要分为单雷达版和红外+雷达双模版。两者的关键参数和探测逻辑对比如下：
| 特性维度 | 智能人体存在雷达传感器2[壁挂] | 智能人体存在红外和雷达传感器[壁挂] |
|---|---|---|
| 探测技术 | 雷达毫米波（高精度） | 红外 + 雷达“双模” |
| 探测距离 | 存在（微动）：≤4m； 运动：≤6m | 人体存在：≤5m |
| 独特功能 | 纯雷达探测，灵敏度高 | 双模逻辑（双路均无人判定为空） |
| 负载控制 | 仅信号探测，无直接输出 | 自带1路继电器输出（AC 100-250V） |
| 适用场景 | 对微动（如静坐呼吸）敏感度要求高的场景 | 需要防止误报（如窗帘晃动）或需直接控制照明的场景 |
探测逻辑：传感器主要上报三种状态：“有人进入/移动”、“静止存在（微动）” 和 “无人离开” 。相比普通红外传感器，雷达技术能检测到静坐人体微弱的胸腔起伏，避免了“人静坐灯灭”的尴尬。
数据上报机制：设备状态变化时刻触发实时上报（HTTP API推送），而非定时上报，确保了监测的实时性。
3 对接环境准备
在编写代码前，需完成平台侧的配置，获取必要的身份验证信息。
账号注册：访问芯步官网完成开发者账号注册。
创建应用：登录后进入“物联网控制台”，创建一个新的工作台/项目。系统将自动生成唯一的 AppID 和 AppSecret，这是后续API调用的身份凭证。
设备配网
确保传感器通电，并处于配网模式（指示灯闪烁）。
通过“芯步小程序”或“控制台”的配网工具，将传感器的WiFi配置为现场2.4GHz频段的WiFi网络。
配网成功后，在控制台的设备列表中即可看到该传感器的唯一 Device ID（设备ID）。
4 API对接核心实现
芯步开放接口基于HTTP协议，支持GET/POST请求，数据格式支持JSON。对接主要涉及“接收设备上报数据”和“主动查询/控制”两个方面。
4.1 配置数据接收服务器（状态上报）
如何让设备知道向哪个服务器地址推送数据？
设置HTTP回调URL：在物联网控制台中，找到对应的传感器设备，配置“消息推送URL”为你的公网服务器地址（例如：
https://yourdomain.com/api/yoyo/callback）。接收数据示例：当有人进入探测区域时，设备会主动向该地址推送数据。服务器端需准备接口接收POST请求。推送的数据格式通常如下所示（参考字段）：
响应要求：为确认接收成功，服务器需在收到请求后返回 HTTP 200 状态码。若返回非200码或超时，平台会触发重推机制。
4.2 主动查询与设备控制（API调用）
在实现远程监测时，通常也需要主动获取设备当前状态或进行远程布防/撤防。
接口地址http(s)：//api.thingboot.com/{AppID}/device/control/？sign={sign}&ts={ts}
核心参数说明
AppID：控制台获取的应用标识。
sign：签名。算法通常为
MD5（MD5（AppSecret）+ ts），用于身份验证。ts：Unix时间戳，用于防止请求重放。
device：目标设备的Device ID。
Java请求示例（主动关闭传感器蜂鸣器或重启雷达） ：
常用指令集（Order字段） ：
| 功能描述 | 指令格式（JSON） | 说明 |
|---|---|---|
| 开启雷达探测 | {“radar_enable”：1} | 启用人体探测功能 |
| 关闭雷达探测 | {“radar_enable”：0} | 关闭探测，停止上报 |
| 开启/关闭指示灯 | {“led”：1} | 控制设备上的LED状态 |
| 重启设备 | {“restart”：1} | 远程重启传感器 |
数据来源：结合产品手册与开放文档
5 远程监测实现架构
为了实现完整的远程监测，系统架构通常分为三层：感知层、平台接入层和业务应用层。
5.1 数据流转路径
感知层：壁挂传感器通过雷达波实时采集区域内状态变化。
平台层：传感器通过WiFi将状态推送到芯步云平台，平台负责鉴权并转发至用户服务器。
应用层：用户服务器接收数据落库，前端通过WebSocket或轮询读取数据库展示实时状态。
5.2 状态判定逻辑（业务侧处理）
在业务服务器中建立状态机来处理上报的原始数据：
进入事件：收到
radar_status = “on”或presence = true。维持事件：若设备支持“存在”信号，此期间状态维持“有人”但无移动。
离开事件：连续收到
radar_status = “off”或超时未收到“存在”信号。注意：若使用双模版本，设备判定逻辑为“红外触发 且 雷达触发”时才上报有人，可大幅减少因空调、窗帘等干扰引起的误报。
6 联动场景配置示例
远程监测的最终目的是实现智能联动。以下是两种典型的编程逻辑示例：
第一种场景：无人自动关灯/关空调（节能）
逻辑：监听传感器上报的“无人”状态事件。
执行：触发HTTP请求调用“智能墙壁开关”的关灯接口，或调用空调API设定温度。
代码伪指令
第二种场景：远程看护告警（养老/婴儿看护）
逻辑：设置定时任务，检查特定时间段（如深夜）是否长时间无人移动，或监测特定区域持续时间。
执行：若在设定时段内有人，则保持静默；若长时间无人活动，调用短信接口或语音喇叭接口进行提醒。
7 注意事项
WiFi信号强度：传感器依赖2.4G WiFi，安装位置需确保信号强度。若安装在金属弱电箱附近或信号死角，可能导致掉线。
安装高度与角度：壁挂式离地约2米，探测角度约120°。安装时避免正对出风口（冷/热气流可能干扰雷达波）或大幅摆动的植物。
签名机制：所有主动调用接口必须携带正确的sign，ts与服务器时间误差不要超过5分钟，否则请求将被拒绝。
异步处理：设备执行命令（如断电重启）可能需要几秒钟，调用接口返回200仅代表指令下发成功，设备是否真正执行可在异步消息中查看或通过日志分析。