怎么对接吸顶式高精度红外传感器以实现人体移动探测_解决方案

CATALOG

芯步的吸顶式红外传感器采用 HTTP 直接对接模式，无需网关即可通过 WiFi 接入你的服务器。以下从设备能力、对接流程、事件处理三个维度展开说明。

本方案基于芯步 UNI-CGQ-RT-XD-H 型号的吸顶式高精度红外传感器。该设备无需网关，直连 WiFi 2.4G 网络，完全开放 HTTP 接口，支持公网与私有化部署。

本方案的目标是指导开发者如何通过接口获取设备上报的“有人/无人”状态，并将其集成到用户的现有业务系统（如楼宇自动化、智慧办公、安防联动）中。

在对接前，需明确该设备的“物模型”。这是数据交互的标准。该传感器的核心逻辑围绕红外感应展开。

对接过程主要分为“设备配网激活”、“服务端接收数据”、“服务端下发指令”三个环节。

设备上电：设备支持 DC 5V/9V/12V/24V 宽电压供电，接入电源后指示灯亮起。
配网模式：长按设备侧方按键（或通过扫码），进入 AirKiss/AP 配网模式。
- 注意：设备仅支持 WiFi 2.4G，不支持 5G 频段。
- 可预先配置 5 组 WiFi 信息，设备会自动选择信号最强的网络连接。
注册上线：设备连接 WiFi 成功后，会自动向芯步云平台发起注册，此时用户在控制台可看到设备状态为“在线”。

该传感器的主要职责是“上行”（即探测到环境变化后通知服务器）。芯步提供两种主流对接模式，根据项目环境选择：

方式A：HTTP 消息推送（标准 SaaS 模式）
- 在芯步控制台中，配置用户的 接收服务器 URL。
- 当传感器探测到有人/无人变化时，平台会立即向该 URL 发送 POST 请求。
- 数据格式：JSON。
- 典型 Payload 示例（模拟当有人进入时）：
  { "device_id": "110774", "protocol": "http", "events": [ { "event_name": "infrared_detect", "timestamp": 1713254630, "current_state": { "infrared_target": 1, "power": 1 } } ] }
方式B：私有化部署 MQTT/HTTP（局域网模式）
- 若数据不能上公网，需要按照芯步提供的 私有化 SDK 进行部署。
- 在控制台将设备的“数据目的地”指向自建的服务器地址（局域网 IP 或域名）。
- 此时，所有探测数据将直接发送至用户自有服务器，不经过芯步公有云，满足内网隔离要求。

虽然主要被动接收数据，但有时需要修改传感器的灵敏度或手动重启。任何支持 HTTP 请求的编程语言均可调用。

接口地址： http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}
请求方法： POST
请求头： Content-Type: application/json

第一种场景：远程关闭红外探测（禁用模块）若需在某时间段忽略人体感应，可下发关闭红外模块指令：

第二种场景：调整“无人”延迟时间（防误报）默认无人延迟可能较短（如30秒），若需判定“无人”需持续 5 分钟无动作调整为：

在实际项目中，如果直接对接后发现误报较多或联动不顺畅，通常需要对配置项进行调整。

配置项	推荐值	作用说明
红外开机状态 (`infrared`)	`1` (打开)	确保设备断电重启后自动进入工作状态。
有人触发持续时间 (`infrared_change_1`)	`0` (马上)	移动探测必须毫秒级响应，无需延迟。
无人触发持续时间 (`infrared_change_0`)	`30-120` 秒	根据场景定。走廊设 30 秒，办公室设 120 秒。防止人静止不动时被误判为“无人”。
LED灯 (`led`)	`0` (长灭)	隐蔽安装时关闭 LED 指示灯，避免光污染。

联动逻辑

开灯：当 infrared_target 由 0 变为 1 时，服务器收到 infrared_detect 事件，立即向灯光控制器下发 power:1 指令。
关灯：当 infrared_target 维持 0 状态超过设定的 infrared_change_0 秒数后，服务器下发关灯指令。