怎样接入壁挂式人体存在监测模块来实现自定义联动操作_解决方案

CATALOG

壁挂式人体存在传感器区别于普通红外传感器的地方在于，它能检测“静态存在”——人静坐、小憩甚至熟睡时也能感知，而非只有移动时才触发。这一特性使得它非常适合办公节能、老人看护等精细化场景。以下方案围绕芯步开放接口，阐述如何将传感器数据接入自有系统并实现自定义联动。

1. 背景与产品概述

在智能家居和楼宇自动化的应用中，传统的红外传感器往往只能检测“移动”的人体，一旦用户处于静坐、睡眠等静止状态，设备容易发生误判，导致灯光熄灭或场景中断。为了解决这一痛点，芯步推出了基于毫米波雷达技术的壁挂式人体存在传感器。

该传感器不仅支持WiFi直连（无需网关），更重要的是开放了底层的HTTP API接口。这意味着开发者可以完全抛弃厂商自带的小程序，将该传感器无缝集成到企业自有的SaaS平台、APP或本地化智能中控系统中，实现“有人真存在”与“无人”的精准判断，并触发任意自定义动作。

2. 核心技术架构

为了实现完全自定义的联动操作，采用服务端直连或局域网本地化架构。不依赖芯步官方云端的规则引擎，而是将数据直接推送到开发者自己的服务器。

设备层：壁挂式人体存在传感器（UNI系列），具备雷达/红外“双模”探测能力。
网络层：设备通过2.4G WiFi联网，支持配置多组备用WiFi，保障网络稳定性。
数据层（自建服务器） ：用户自建公网或本地服务器，接收设备的HTTP POST回调。
执行层：任何支持HTTP请求的设备（如芯步系列智能开关、窗帘电机、第三方音响等）。

工作流程如下

传感器探测到“有人存在”或“无人超时”。
传感器将状态变化（如 presence: true）推送到开发者预设的自建服务器地址。
开发者服务器解析数据，执行自定义逻辑判断。
服务器下发HTTP指令给智能开关或场景控制器，完成通电/断电操作。

3. 接口接入详解

芯步的开放接口设计遵循简单的RESTful风格，关键点在于签名计算与回调配置。

3.1 设备初始化与回调配置

设备配网后，需要告知它数据往哪发。在芯步的控制台或设备配网软AP模式下，配置 “数据上报URL”。

配置项HTTP/HTTPS 地址。
触发时机：当雷达探测到存在状态发生改变（从无人变有人，或从有人变无人）时，设备会立刻向该地址发送一个POST请求。
数据格式
{ "device_id": "12345678", "type": "presence_status", "status": "true", // true: 有人, false: 无人 "timestamp": 1620000000, "illuminance": 320 // 附带光照数据（若硬件支持） }

3.2 服务器端接收与签名验证（安全机制）

为了防止伪造数据干扰系统，开发者需在服务器端实现签名验证。设备在推送数据时会携带 sign 和 ts 参数。

验证逻辑：服务器收到请求后，利用AppSecret（与设备预设一致）和请求携带的ts，按照 md5(md5(AppSecret) + ts) 规则重新计算签名，与请求中的sign比对。一致则认为是合法设备。

3.3 下发联动指令（控制执行器）

当服务器确认状态为“有人”且需要开灯时，需向智能开关下发控制命令。

请求地址https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}
请求方法：POST
请求体示例（控制单路灯打开） ：
{ "device": "820720", // 目标智能开关的ID "order": {"power": 1} // 1为开，0为关 }
高级指令：对于多路开关，可控制具体某一路，如 {"power3": 1} 表示打开第三路线路。

4. 自定义联动场景实施方案

基于上述接口能力，我们可以实现比传统智能家居更复杂的逻辑。以下是两个典型的深度自定义案例：

第一种场景：办公室“人来灯亮，人走灯灭”但要求静坐不熄灯

痛点：普通传感器检测到人不动就关灯，导致员工不敢动。解决方案

传感器部署：工位上方部署壁挂/吸顶人体存在传感器。
自定义逻辑（写在你的服务器） ：
- 收到 status: true -> 发送 {"power":1} 给办公室灯控开关。
- 收到 status: false -> 不立即关灯。启动一个 15分钟的计时器。
- 计时期间内若再次收到 true，重置计时器；若15分钟内持续收到 false（真无人），再发送 {"power":0}。
代码逻辑伪代码
if data['status'] == 'false': # 延迟15分钟执行关灯任务 schedule_delayed_task(device_light, turn_off, delay=900) else: # 有人，取消之前的关灯任务，立即开灯 cancel_pending_task(device_light) send_command(device_light, 'on')

第二种场景：全屋离家联动与安防布控

痛点：用户离家时忘记关空调或关窗户。解决方案

布防逻辑：用户通过APP点击“离家模式”，系统记录布防状态。
探测联动
- 若所有房间的壁挂传感器在布防后超过 30分钟 均处于 无人 状态。
- 服务器自动轮询所有传感器状态，确认无人 -> 发送指令关闭总闸/空调插座。
异常报警：若布防期间，某非授权区域（如仓库）传感器状态变为 有人，服务器立即通过HTTP调用第三方短信平台或语音平台告警。

第三种场景：私有化局域网联动（高安全性）

适用：医院ICU、实验室、保密会议室。这些环境不允许数据上公网。方案：由于芯步设备支持私有化部署，开发者可在本地服务器（如树莓派或Windows工控机）上搭建服务端程序。

网络：所有设备连接同一个局域网路由器，不上外网。
流程：传感器 -> 本地服务器（逻辑判断） -> 智能开关。

5. 实施步骤小结

硬件准备：采购芯步壁挂人体存在传感器及对应执行器（如智能开关）。
环境搭建：准备一台具备公网IP或域名（局域网则不需要）的服务器，开发接收程序。
平台配置：登录芯步工作台，获取 AppId 和 AppSecret。在控制台将设备（传感器和开关）绑定到该账户下，获取 device_id。
代码开发
- 编写API接收端（处理传感器上报）。
- 编写API调用端（控制开关）。
- 实现业务逻辑（延时、条件判断）。
联调：将传感器的“数据上报URL”配置为你的服务器地址，观察服务器日志，确认数据收发自如。

6. 总结

利用芯步壁挂式人体存在监测模块的开放接口，开发者完全摆脱了公版APP的功能限制。通过直连HTTP API和私有化服务器，可以构建出反应速度快、逻辑深度强（如延时关灯、全屋联动）的自动化系统。无论是打造高端全宅智能，还是集成进复杂的商业楼宇节能方案，这种“数据自己收，指令自己发”的模式都提供了极大的灵活性。