壁挂式“双模”探测器（红外+雷达）的核心价值在于消除“假无人”——比如人员静坐、小憩时，纯红外方案容易误判为无人。对接的关键在于理解物模型中两个模块的协同逻辑，以及如何利用实时上报的事件流来驱动业务决策。
1. 解决概述
1.1 背景与目标
在现代智能化楼宇、办公场所及居家养老场景中，精准的人员存在监测是节能控制与安防管理的痛点。传统的红外传感器仅能感知移动目标，导致人员静坐或熟睡时常发生“误判离线”，造成灯光熄灭或空调关闭等不良体验。
解决方案目标：本方案的目标是指导开发者利用芯步开放的 HTTP API，快速完成“壁挂式高精度“双模”探测器（红外+雷达）”的集成对接。实现毫秒级人体状态上报、有人/无人精准判别以及与执行端设备的联动控制。
1.2 适用产品
本方案主要适用于芯步旗下具备“双模”（红外+雷达）能力的壁挂产品，典型型号包括：
智能人体存在红外和雷达传感器[壁挂] (UNI-CGQ-RT-BG-HL)
智能人体存在雷达传感器2[壁挂]
| 核心能力 | 技术实现 | 业务价值 |
|---|---|---|
| 双重校验机制 | 红外探测大面积移动，雷达捕捉微动（呼吸、心跳） | 消除“假无人”误判，静止存在也能精准锁定 |
| 实时状态上报 | 状态变化时主动 HTTP POST 至服务器 | 无需轮询，降低延迟与服务器负载 |
| 局域网/公网双栈 | 设备配网后同时维护云端与本地通信 | 外网断开时，内网仍可联动控制，系统稳定性高 |
2. 技术对接架构
本方案采用服务端直连模式，即设备数据不经过芯步SaaS业务层，而是直接推送到企业自建的后端服务器。
数据上行（设备 -> 云）： 探测器监测到状态变化（有人/无人），通过芯步云平台，经由 HTTP 回调推送到客户服务器。
数据下行（云 -> 设备）： 客户服务器调用芯步 Open API，对设备进行远程配置（如灵敏度）或查询实时状态。
3. 对接前置准备
3.1 环境与账户配置
注册与登录：访问芯步官网完成开发者注册。
获取密钥：进入工作台 -> 物联网控制台 -> “开发设置”。
记录 AppID（应用唯一标识）。
设置并保存 AppSecret（开发者密码）。注意： 生产环境下，AppSecret 严禁硬编码在前端代码中。
设置消息推送URL：在“开发设置”中配置“消息推送URL”。这是接收设备上报数据的公网地址（如
https://api.yourdomain.com/yoyo/callback）。芯步平台会将设备状态变更推送到此地址。
3.2 设备配网与激活
设备接线：壁挂式探测器通常需接入 100-250V 交流电。请确保按照产品手册完成零火线接入。
Wi-Fi 配网
设备仅支持 2.4GHz Wi-Fi。
在物联网控制台的“网络配置”中，输入现场 Wi-Fi 的 SSID 和密码。
生成配置二维码或通过特定配网模式，使设备连接到互联网。
获取设备ID：设备成功上线后，在控制台的“设备列表”中获取唯一的 Device ID（如 820720），后续所有 API 操作均依赖此 ID。
4. 核心对接开发实践
4.1 数据上行：接收人体存在事件
这是对接中最核心的环节。当人体存在状态发生变化时，芯步会立即向预设的URL推送数据。
回调数据格式解析：服务器端需开发接口接收 POST 请求，解析 JSON 包体。根据物模型定义，主要关注以下字段：
“双模”逻辑判断（关键算法）：为了避免红外静止漏报，企业服务器不应单独依赖 infrared_target，而应采用融合判断
判定为“有人”条件
infrared_target == 1或radar_target == 1。即只要雷达捕捉到微动（如呼吸起伏），即便红外未触发（人体静止），仍判定为有人。判定为“无人”条件
infrared_target == 0且radar_target == 0。且该状态需持续稳定 N 秒（避免瞬时干扰）。
4.2 数据下行：远程查询与配置
除了被动接收，系统还需主动干预。
请求示例：查询设备当前状态当服务器重启或需要同步状态时，可下发查询命令。
接口地址
https://api.thingboot.com/{AppId}/device/control/请求方式：POST
Body参数
{"device":"820720", "order":{"system":"network"}}(查询网络信息) 或{"device":"820720", "order":{"radar_enable":1}}(查询雷达模块状态)
签名机制（生产环境必看）：调用 API 需携带签名 sign 和时间戳 ts。Sign 生成规则：sign = md5( md5(AppSecret) + ts )即：将 AppSecret 进行一次 MD5，拼接上时间戳字符串，再进行一次 MD5。
代码核心逻辑（Python示例）：
4.3 物模型关键指令表
根据 和 整理，常用指令如下：
| 功能分类 | 命令字段 (order) | 参数值 | 说明 |
|---|---|---|---|
| 红外模块 | infrared_enable | 1(开) / 0(关) | 启用/关闭红外探测功能 |
| 雷达模块 | radar_enable | 1(开) / 0(关) | 壁挂“双模”核心，微动检测开关 |
| 存在状态 | infrared_target | 1(有人) / 0(无人) | 上行只读，表示红外判断结果 |
| 存在状态 | radar_target | 1(有人) / 0(无人) | 上行只读，表示雷达判断结果 |
| 联动线路 | power 或 relay1 | 1(通) / 0(断) | 控制传感器自带输出的继电器 |
| 灵敏度配置 | config_get/set | JSON Object | 修改雷达探测灵敏度，避免误报 |
5. 典型场景联动实施
第一种场景：办公室“人来人走”全自动控制
需求：人员进入办公室，灯光自动亮起；人员离开 10 分钟后，自动关灯断电。实施流程
部署：壁挂探测器安装于门侧或墙面，视角覆盖办公区域。
触发
人员进入 ->
radar_target从 0 变 1 -> 平台回调 -> 服务器调用照明插座 API -> 开灯。人员静坐工作 ->
infrared_target可能变 0，但radar_target维持 1 -> 服务器保持亮灯状态。人员离开 -> 两个字段均变 0 -> 服务器启动计时器（600秒）。
计时结束无变化 -> 调用关灯指令。
第二种场景：高校宿舍“节能与安全”
需求：结合智能插座，识别寝室无人时切断电源，消除火灾隐患。实施流程
通过 API 设置壁挂探测器的“无人延时上报”属性（如配置
infrared_change_0为 300秒）。设备判断持续无人 5 分钟后，上报
unoccupied事件。服务器接收到该事件，向该宿舍关联的智能墙壁插座下发
{"power":0}指令。安全冗余：即使外网中断，局域网内通过预设的联动规则（设备与插座同局域网），可实现本地化自动断电。
6. 常见问题与优化
6.1 误报与漏报优化
现象：明明有人，系统报无人。
解决：检查安装高度（ 2-2.5 米）和角度。雷达波具有穿透性（可穿透薄木板、玻璃），但对移动的窗帘、风扇也可能产生误报。可通过 API 下发
radar_sensitivity指令，将灵敏度调至“中”或“低”以滤除干扰。现象：人走很久还显示有人。
解决：雷达对微动极其敏感，若传感器安装位置靠近空调外机或大型通风管道，需调整探测范围或增加“无人确认延时”逻辑。
6.2 网络稳定性
重连机制：芯步设备端 SDK 内置了断网重连机制。若企业服务器收到设备频繁上下线事件，应检查现场 Wi-Fi 信号强度（需 > -70dBm）。
时间同步：API 签名中的
ts参数依赖于服务器时间。请一定要确保生产环境服务器时间与标准 NTP 服务同步，偏差过大会导致签名验证失败。
7. 总结
通过对接芯步壁挂式高精度“双模”探测器的开放接口，企业可以在 1-2 天内快速搭建具备静止存在检测能力的高阶物联网系统。相比于传统单红外设备，该方案解决了“静坐误判”的行业痛点，适用于智慧办公、智能家居、养老监护等高价值场景。开发者仅需专注于业务逻辑（如计时策略、联动规则），无需关心底层通信协议，即可实现稳定的远程人体存在监测。