芯步的壁挂式“双模”传感器同时提供红外和雷达数据，配合开放的HTTP接口，可以实现比传统PIR更精细的联动逻辑——比如判定“有人静止但未离开”或“无人持续时间达到阈值后再关灯”。以下方案涵盖从物模型理解、数据接收到自定义触发规则的全流程，可直接落地到你的系统里。
1. 解决概述
壁挂式“双模”人体存在传感器（红外+雷达）相比传统的红外传感器，最大的优势在于能识别“人体存在”而不仅仅是“人体移动”。通过对接芯步开放的HTTP接口，您可以接收设备上报的实时状态，并结合业务需求（如办公室、仓库、智能家居）编写自定义逻辑。
核心价值：
高可靠性：红外与雷达双模验证，只有当两者均判定“无人”时才触发无人事件，避免空调/灯光误关。
实时响应：状态变化触发HTTP推送（毫秒级）。
可控性强：支持通过API远程控制设备自带的线路输出（如控制灯光或排风扇）。
2. 准备工作与环境配置
在开始代码开发前，您需要完成以下基础配置。
获取API凭证
登录芯步控制台，获取
AppID和AppSecret。这是所有API调用和接收推送的凭证。
设备配网与激活
参照产品手册将传感器连接至2.4GHz WiFi网络。该设备无需网关，直连路由器。
配置消息推送服务器（关键步骤）
在控制台设置您的服务器接收地址（URL）。当传感器探测到有人/无人时，平台会向该地址发送POST请求。
3. 数据接收与物模型解析
要实现自定义联动，您首先需要看懂设备发来的数据。
3.1 状态属性定义（物模型）
当环境变化时，设备会推送以下核心字段。根据设备型号（如UNI-CGQ-RT-H-BG），推送的JSON数据通常包含以下状态
| 字段标识符 | 说明 | 值含义 |
|---|---|---|
infrared_target | 红外感应状态 | 1=有人移动， 0=无人移动 |
radar_target | 雷达感应状态 | 1=探测到微动/存在， 0=无存在 |
presence_status | 综合存在状态 | 逻辑算法：红外或雷达任一为1时，通常判定为有人。 |
power | 线路输出状态 | 1=接通（负载工作）， 0=断开 |
3.2 什么是““双模””逻辑？
在您的自定义代码中，不仅依赖红外信号。由于红外对静止人体不敏感，若只依赖红外会频繁出现“有人却关灯”的情况。
推荐逻辑：
判定为“有人”
infrared_target == 1或radar_target == 1。判定为“无人”
infrared_target == 0且radar_target == 0（两者均为无人）。
4. 核心实现：自定义联动逻辑
为了满足不同场景，我们需要在服务器端（或云函数）编写规则引擎。以下是两种典型的自定义联动场景实现。
4.1 第一种场景：灵敏模式 vs 节能模式（防误判）
需求：在办公室，人员伏案工作不动时，灯不能灭；在走廊，人离开后灯即刻灭。
解决方案代码逻辑（伪代码）：
4.2 第二种场景：联动排风扇与安防（利用线路输出）
该传感器自带一路AC输出（继电器），可直接控制小型电器。但如果您需要联动网络上的其他设备（如音箱、空调），则需要通过API调用。
需求：当探测到“无人”持续10分钟，不仅关闭本地灯光，还要通过API关闭远端空调并发送微信通知。
实施步骤：
接收数据：服务器收到
radar_target=0且infrared_target=0。计时等待：设定计时器。如果在10分钟内收到“有人”信号，则重置计时器。
执行联动
控制自身设备：调用控制接口，下发
{"power":0}关闭本设备连接的负载。控制第三方设备：调用芯步其他设备的API（如智能插座），或调用企业微信/钉钉接口发送告警。
5. 对接开发实战：API接口调用
当自定义逻辑判定需要执行动作时（如远程关灯或切换灵敏度），您需要调用芯步的设备控制接口。
5.1 接口调试与签名
该平台接口采用动态签名验证。以下是基于Python的请求示例，演示如何向壁挂传感器下发指令（例如开启/关闭雷达模块）。
注：在实际场景中，该接口通常用于维修重置或主动场景切换，大多数联动逻辑应由设备自动上报触发，无需主动查询。
5.2 配置设备自身逻辑（边缘计算）
为了降低服务器压力，该传感器支持本地配置。您可以直接通过API修改设备的配置项，让设备在没有互联网的情况下也能执行简单逻辑。
配置项示例 (
配置项字段):relay_change_1(探测到有人时线路动作): 可设为1(打开) 或no(无动作)。relay_change_0(探测到无人时线路动作): 可设为0(关闭) 或no。infrared_change_0(红外无人触发持续时间): 可设为30(30秒) 或60(1分钟)。
自定义联动技巧：如果你希望在“无人5分钟后”再断电，而不想修改服务器代码，可以直接下发配置修改设备的 infrared_change_0 参数，实现边缘端触发。
6. 高级联动逻辑示例
| 业务场景 | 联动逻辑规则 (If-Then) | 涉及接口/动作 |
|---|---|---|
| 智能会议室预约 | IF 红外=0 AND 雷达=0 AND 时间>5分钟 THEN 释放会议室资源，关闭投影仪。 | 1. 接收上报2. 调用会议室系统API释放订单3. 调用红外控制API关闭设备 |
| 鱼缸/宠物喂食器 | IF 雷达=1 (有宠物靠近) THEN 触发语音警告：“宠物勿动电源”。 | 1. 接收雷达上报2. 调用语音喇叭API播放指定文字 |
| 仓库安防布防 | IF 布防模式开启 AND 雷达=1 (夜间非工作时间有人) THEN 触发蜂鸣器报警。 | 1. 接收上报2. 下发命令 {"buzzer":1} 让传感器本地蜂鸣 |
7. 总结
通过对接芯步壁挂式“双模”人体存在传感器，您可以打破厂商固化的逻辑限制。核心实施路径如下：
利用双模优势：结合红外（快速响应移动）和雷达（感知静止存在），自行编写防误报算法。
标准化对接：通过配置消息推送URL接收实时数据，通过签名机制调用控制API。
混合逻辑：将简单的延时判断写入设备配置项（边缘端），将复杂的跨设备联动放在服务器端（云端）。