CATALOG

壁挂式存在传感器与红外传感器最大的区别在于:红外只能感知“移动”,人静坐或入睡时会误判为无人;而雷达传感器通过微动检测,能真正判断“是否存在”。以下方案以芯步双模/雷达传感器为例,涵盖配网、接口对接、状态订阅及联动控制的完整流程。

1. 背景与产品选型

在智能办公、节能改造或智慧安防场景中,传统的红外传感器(PIR)往往无法识别静坐、睡眠等静态人体,容易导致“人在灯灭”或“安防漏报”的糟糕体验。

芯步提供的壁挂式智能存在传感器(含红外+雷达双模版及纯雷达版)正是为解决此痛点而设计。其核心优势在于:

  • 微动检测:不仅能感知大幅移动,更能探测到人的呼吸、心跳引起的胸腔起伏(微动),真正实现“存在”监测

  • 双模逻辑:双模版本采用“红外+雷达”双重确认机制,只有当两种技术均判定为无人时才上报“无人”,极大降低了误报率

  • 本地联动:设备自带一路大功率继电器输出,即使断网也可直接控制灯具或插座,实现“人來灯亮,人走灯灭”

2. 接口对接架构

芯步的硬件采用 WiFi(2.4GHz)直连 方案,无需额外网关。对接架构分为三层:

  1. 设备层:壁挂传感器负责采集数据,执行继电器通断。

  2. 接口层:开放 HTTP API 接口,支持云端 API 调用和局域网内本地推送。

  3. 应用层:用户的服务器(SaaS/私有化部署)接收设备上报的状态,或向设备下发指令。

3. 对接前的准备工作

在开始开发前,需完成设备的物理安装与网络配置:

  1. 注册与创建:在芯步官网注册账号,并创建“工作台”与“应用”,获取唯一的 AppID 和 AppSecret。

  2. 设备配网

    • 使用“芯步小程序”或“物联网控制台”进行配网。

    • 注意:仅支持 2.4G WiFi,需在手机设置中开启 2.4G 热点频段辅助设备连接

  3. 设置上报服务器:在控制台配置“自定义服务器地址”(即你的公网接收地址),设备状态发生变化时,会将数据主动 HTTP POST 至此地址。

4. 数据接收与人休存在判定(核心对接)

传感器对接的核心在于正确处理设备推送的“上行消息”。当传感器探测到人体状态变化时(有人/无人),会实时向你的服务器推送数据。

4.1 接收传感器状态推送

设备会按照你配置的服务器地址发送 JSON 数据包。你需要开发一个接收接口,解析如下关键参数:

推送示例(关键字段)

4.2 业务逻辑处理

你的业务系统需要根据 radar_target 字段进行逻辑判断,而非仅依赖红外 infrared_target

  • 判定为“有人”:只要 radar_target == 1(存在微动)或 infrared_target == 1(移动),即可判定区域有人。对于办公室、卫生间场景,radar_target 为准

  • 判定为“无人”:当 radar_target == 0infrared_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 天内快速实现“真存在感应”系统。该方案利用雷达技术解决了传统红外感应的静默误判痛点,结合其开放的物模型接口,无论是做简单的灯控联动,还是复杂的能耗分析系统,都能提供可靠、实时的人体存在数据源。