壁挂式存在传感器与红外传感器最大的区别在于:红外只能感知“移动”,人静坐或入睡时会误判为无人;而雷达传感器通过微动检测,能真正判断“是否存在”。以下方案以芯步双模/雷达传感器为例,涵盖配网、接口对接、状态订阅及联动控制的完整流程。
1. 背景与产品选型
在智能办公、节能改造或智慧安防场景中,传统的红外传感器(PIR)往往无法识别静坐、睡眠等静态人体,容易导致“人在灯灭”或“安防漏报”的糟糕体验。
芯步提供的壁挂式智能存在传感器(含红外+雷达双模版及纯雷达版)正是为解决此痛点而设计。其核心优势在于:
微动检测:不仅能感知大幅移动,更能探测到人的呼吸、心跳引起的胸腔起伏(微动),真正实现“存在”监测 。
双模逻辑:双模版本采用“红外+雷达”双重确认机制,只有当两种技术均判定为无人时才上报“无人”,极大降低了误报率 。
本地联动:设备自带一路大功率继电器输出,即使断网也可直接控制灯具或插座,实现“人來灯亮,人走灯灭” 。
2. 接口对接架构
芯步的硬件采用 WiFi(2.4GHz)直连 方案,无需额外网关。对接架构分为三层:
设备层:壁挂传感器负责采集数据,执行继电器通断。
接口层:开放 HTTP API 接口,支持云端 API 调用和局域网内本地推送。
应用层:用户的服务器(SaaS/私有化部署)接收设备上报的状态,或向设备下发指令。
3. 对接前的准备工作
在开始开发前,需完成设备的物理安装与网络配置:
注册与创建:在芯步官网注册账号,并创建“工作台”与“应用”,获取唯一的 AppID 和 AppSecret。
设备配网
使用“芯步小程序”或“物联网控制台”进行配网。
注意:仅支持 2.4G WiFi,需在手机设置中开启 2.4G 热点频段辅助设备连接 。
设置上报服务器:在控制台配置“自定义服务器地址”(即你的公网接收地址),设备状态发生变化时,会将数据主动 HTTP POST 至此地址。
4. 数据接收与人休存在判定(核心对接)
传感器对接的核心在于正确处理设备推送的“上行消息”。当传感器探测到人体状态变化时(有人/无人),会实时向你的服务器推送数据。
4.1 接收传感器状态推送
设备会按照你配置的服务器地址发送 JSON 数据包。你需要开发一个接收接口,解析如下关键参数:
推送示例(关键字段)
4.2 业务逻辑处理
你的业务系统需要根据 radar_target 字段进行逻辑判断,而非仅依赖红外 infrared_target
判定为“有人”:只要
radar_target == 1(存在微动)或infrared_target == 1(移动),即可判定区域有人。对于办公室、卫生间场景,以radar_target为准。判定为“无人”:当
radar_target == 0且infrared_target == 0持续一段时间(如30秒,此延时可在设备配置项中调整),判定为无人 。应用联动
有人:你的系统记录“有人”,并向灯光控制设备发送“开灯”指令;或者无需系统介入,传感器自带的 Power 线路 会自动通电点亮灯具 。
无人:系统记录“无人”,下发“关灯/关空调”指令,实现节能。
5. 反向控制与参数配置(下行指令)
除了接收数据,你可能需要通过系统远程控制传感器(如关闭感应、设置灵敏度)。这通过调用芯步的 设备控制 API 实现。
5.1 接口调用方法
请求地址
http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}请求方式:POST (JSON)
5.2 典型指令示例
第一种场景:强制关闭/打开继电器输出(远程控灯)即便传感器未感应到人,你也可以强制开启负载。
第二种场景:修改无人判定延时为了避免人短暂离开(如上厕所)导致灯光立即关闭,可以修改配置。
(注:通过修改物模型中的 infrared_change_0 配置项,可设定无人延迟时间)
第三种场景:重启设备
(注:软重启指令通常用于设备维护)
6. 私有化部署与内网集成
对于数据安全性要求较高的企业(如政府、实验室),芯步支持 私有化部署方案 :
局域网通信:设备支持配置局域网内的本地服务器地址,数据完全不经过芯步的公网云,直接发送到你的内网业务系统。
纯内网运行:在物理隔离的网络环境中,通过本地 Broker 或直接 HTTP 接口实现设备配网与控制,保证数据物理不外泄 。
7. 调试与常见问题
签名错误 (sign):芯步 API 签名规则为
md5(md5(AppSecret) + ts)。请确保时间戳(ts)为 Unix 时间戳(秒级),且服务器时间与标准时间误差不宜过大 。状态上报延迟:雷达传感器在判断“无人”时为了防误报,默认存在几秒到几分钟的延迟。你可以在设备的产品手册中调整“无人触发持续时间”参数来修改延时灵敏度 。
WiFi 断连:设备支持自动重连。若网络环境复杂,可在控制台开启“信号强度上报”,监控设备 RSSI 值,确保信号良好。
8. 总结
通过对接芯步壁挂式存在传感器的 HTTP API,开发者可以在 1-2 天内快速实现“真存在感应”系统。该方案利用雷达技术解决了传统红外感应的静默误判痛点,结合其开放的物模型接口,无论是做简单的灯控联动,还是复杂的能耗分析系统,都能提供可靠、实时的人体存在数据源。