芯步的“双模”式人体雷达烟感集成了毫米波雷达与光电感烟两种探测技术,核心价值在于通过雷达感知“是否有人”来决策火灾报警策略——有人时优先本地声光报警引导逃生,无人时立即远程通知并可由系统自动处理。以下方案详细说明如何通过其开放HTTP接口完成对接。
1. 解决概述
在智能家居与安防领域,误报率是衡量系统可靠性的关键指标。传统的单一烟感探测器因厨房油烟、灰尘等因素常产生误报,而单纯的雷达传感器无法识别环境危险性。“双模”式人体雷达烟感通过“毫米波雷达+光电感烟”的双重验证机制,能同时感知“是否有人”与“是否有烟”,为火灾预警提供了更立体的决策依据。
1.1 核心逻辑
无人状态:若检测到烟雾浓度超标但雷达判定无人,系统自动触发远程报警通知(APP推送/电话),并联动切断总电源或煤气阀门,等待物业或邻居查看。
有人状态:若检测到烟雾且雷达判定室内有人,系统不仅远程报警,还会强制触发本地高音喇叭与语音播报,指导人员逃生,同时打开应急照明线路。
防误报:短时间的油烟干扰(如烹饪)结合雷达探测到的人在移动,系统可通过算法延迟判定,减少误报。
1.2 产品核心参数
本项目基于芯步的 “智能人体存在雷达和烟雾传感器[壁挂]” 产品,该设备开放API接口,支持二次开发。
| 模块 | 检测类型 | 核心功能 | 接口控制参数 |
|---|---|---|---|
| 雷达模块 | 人体存在/微动 | 判定房间是否有人,区分移动与微动(如呼吸) | radar_enable |
| 烟感模块 | 烟雾浓度 | 光电式烟雾探测 | mq_enable |
| 执行器 | 蜂鸣器/语音 | 本地高分贝报警与状态提示 | buzzer , play:gbk |
2. 技术对接设计
为了实现低延迟联动,采用 “设备上行触发 → 云端业务逻辑裁决 → 下行指令联动” 的闭环架构。
2.1 通信协议
芯步平台提供标准的 HTTP API 接口,设备状态变化通过 HTTP 推送 到你的服务器,控制指令通过 HTTP 下发。
数据上行:设备检测到烟雾浓度变化或雷达状态改变时,主动推送至指定URL。
指令下行:业务服务器接收到报警后,通过调用
api.thingboot.com/{AppID}/device/control/接口控制设备报警或联动第三方设备。
2.2 签名与鉴权机制
所有API调用需携带动态签名,封装一个通用的签名工具类。签名生成规则为:Sign = md5( md5(AppSecret) + ts )
3. 核心功能实现步骤
3.1 设备激活与消息接收配置
获取凭证:在芯步控制台获取
AppID和AppSecret,并绑定设备ID。配置推送地址:在开放平台设置
消息推送URL(你的公网服务器地址)。当烟感状态变化时,芯步云将POST数据至此地址。
3.2 重点:人体感应与火灾逻辑判定
你的服务器端需要解析设备上报的JSON数据。典型的上报数据包含 smoke_value(烟雾值)和 radar_status(有人/无人)。
业务逻辑处理流程:
收到
smoke_value超过阈值(如 >100ppm)的上报。读取最新
radar_status若
radar_status == "none"(无人):判定为 “无人火警”。若
radar_status == "dynamic" or "micro"(有人):判定为 “有人火警”。
执行差异化联动指令。
3.3 执行层:本地声光与远程控制联动
一旦判定为真实火警,需立即通过HTTP接口向设备下发控制指令。由于芯步接口响应极快(约80-120ms),可实现近乎实时的联动。
示例场景:发现火情且判定有人,需要关闭烟感蜂鸣器的静默模式并强制拉响警报。
请求地址
https://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}Method:POST
Body (JSON)
4. 扩展联动与场景配置
该传感器作为安防生态的入口,可结合芯步生态内的其他硬件实现全屋自动化。
4.1 联动智能断路器(断电保护)
场景:无人状态下发生火灾,首要任务是切断火势蔓延的动力(电力)。方案:服务器收到“无人+烟雾”信号后,调用控制器接口切断总闸。指令示例:控制智能4路控制器切断非消防线路。{“device”: “Controller_ID”, “order”: {“power1”: 0, “power2”: 0}}
4.2 联动语音音柱(分区广播)
场景:别墅或多居室场景,仅在失火房间报警不够,需全屋播报。方案:在客厅安装芯步智能语音音柱。当卧室烟感触发时,服务器同时向客厅音柱下发播报指令。指令示例{“device”: “Speaker_ID”, “order”: {“play:gbk:16”:“卧室检测到烟雾,请立即查看”}}
4.3 防误报机制优化
痛点:厨房烹饪短暂油烟易触发误报。优化逻辑:服务器收到报警后不立即触发惊天动地的警报,而是先执行 “1分钟延迟确认”。
若1分钟内烟雾回落且雷达持续探测到人在正常移动(非恐慌状态),则判定为误报,仅推送消息提醒,不拉响警报。
若烟雾持续上升或雷达探测到人静止不动(晕倒),立即升级为最高级别告警。
5. 代码实现核心示例
以下展示核心的签名生成与火警联动指令下发(伪代码/逻辑示意,基于HTTP通用方法)。
第一步:解析设备上报(以Node.js为例)
第二步:下发控制命令(核心签名逻辑)无论使用何种语言(Java、PHP、C#),签名逻辑均遵循标准
str1 = md5(AppSecret)str2 = str1 + tssign = md5(str2)URL = api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}携带JSON Body发起POST请求。
6. 总结
通过对接芯步的“双模”式人体雷达烟感,开发者可以构建一个 “有温度的智能安防系统”。该系统不再仅仅是冰冷的报警器,而是能通过“雷达感知”区分“财产损失”与“生命安全”,从而执行更精准的策略:无人时自动断电报险以减少损失,有人时优先语音指引疏散以保障生命。
其开放的HTTP API接口设计降低了集成门槛,开发者无需关心底层硬件协议,只需专注于业务逻辑(如防误报算法、差异化联动策略)的实现,即可快速落地商用级智能家居安防方案。