芯步的壁挂式“双模”雷达烟雾报警器通过HTTP接口开放设备能力，可快速对接到培训机构现有系统中。以下方案涵盖接口对接流程、数据模型设计、告警联动策略和实际部署注意事项。
1. 背景与需求分析
1.1 行业痛点
在培训机构场景中，教室安全存在两大痛点：
入侵/滞留监测：课后时段或假期，需防止无关人员闯入或学员滞留在密闭教室，存在安全盲区。
火灾隐患：培训机构人员密集，电气设备多，传统的独立式烟感无法实现远程集中报警，一旦发生火情无法第一时间通知管理人员。
1.2 解决概述
本方案利用芯步的 “智能人体存在雷达和烟雾传感器[壁挂]” ，该设备集成了毫米波雷达（检测人体存在/移动）与烟雾感应模块。通过其开放的 HTTP API接口，将设备数据无缝对接到培训机构的教务管理系统或第三方可视化平台中，实现“人防+技防”的智能化升级。
2. 硬件选型与接口分析
2.1 设备核心功能
雷达模块 (radar_enable)：基于毫米波技术，可探测微动甚至呼吸体征，区分空置与有人状态，避免误报。
烟感模块 (mq_enable)：检测烟雾浓度，判断火情。
蜂鸣器 (buzzer)：支持远程触发本地声光报警。
2.2 开放接口特性
芯步提供的接口具有比较高的集成友好性
协议：标准 HTTP/HTTPS。
数据格式：JSON。
接入方式：支持任何能发起 HTTP 请求的编程语言（如 Java, Python, PHP, Node.js，或低代码平台）。
鉴权方式：采用 MD5 双重加密机制，需计算
Sign值。
3. 系统设计
为了实现流畅的数据流转，采用以下架构：
感知层：部署壁挂式“双模”雷达烟雾报警器，通过 4G/Wi-Fi 联网。
传输/云层：利用芯步的 API 网关。设备主动上报数据或服务器下发指令。
业务层（培训机构服务器）
API 对接模块：处理设备上报的数据，计算签名下发控制指令。
业务逻辑模块：根据雷达和烟感数据进行逻辑判断（如：无人时自动关闭电源监测；有人+ 烟雾= 火灾报警）。
管理后台：教室看板、设备列表、历史记录。
展示/通知层：教务人员大屏看板、手机 APP 推送、短信报警。
4. 详细对接实施步骤
4.1 前期准备
在芯步控制台获取
AppID和AppSecret。在控制台中添加设备，获取唯一的
Device ID（如示例中的 1878）。安装硬件：壁挂安装于教室墙角，离地约 2-2.5 米，确保无金属遮挡干扰雷达波。
4.2 API 对接技术点
所有接口请求的核心是 签名（Sign）计算。根据官方文档，步骤如下：
获取 AppSecret。
MD5 加密一次
Secret_MD5 = MD5(AppSecret)拼接时间戳
String_Sign = Secret_MD5 + ts(当前时间戳)最终签名
Sign = MD5(String_Sign)
代码逻辑示例（伪代码/Python 思路）
请求 URL：
https://api.thingboot.com/{AppID}/device/control/?sign={Sign}&ts={ts}请求 Body：
4.3 关键数据交互流程
第一种场景：设备上报数据（被动接收）
芯步平台支持 HTTP 推送，开发人员需在控制台配置 消息推送 URL（回调地址）。
数据流向：设备检测到异常 -> 芯步云 -> HTTP POST -> 培训机构服务器。
数据解析：服务器接收 JSON 包，解析
radar_status和smoke_status字段。若
radar_status=1且教室状态为“空闲”，触发“有人闯入”告警。若
smoke_status > 阈值，触发“火灾”告警。
第二种场景：平台主动控制（下发命令）
教务人员通过管理后台查看某个教室状态时，可以主动下发命令（如远程消音）。
指令构造
order = {"buzzer":0}(关闭蜂鸣器)。执行：调用上述的
/device/control/接口。
5. 业务逻辑实现
5.1 无人值守模式（“双模”雷达的核心价值）
在培训机构放学后，系统自动进入“布防”模式：
逻辑：利用雷达的“存在探测”功能，即便是静止坐着的入侵者也能被探测到。
联动：若 23:00 - 06:00 时间段内雷达探测到“有人”，系统立即通过 WebSocket 推送消息至保安室大屏，并调用 API 接口联动本地声光报警器。
5.2 火情确认与防误报
逻辑：单纯的烟雾浓度高可能由灰尘或水蒸气引起。利用雷达辅助判断：
情况 A：烟雾高 + 雷达无人 -> 可能是设备故障或灰尘，仅记录日志并提醒清洁。
情况 B：烟雾高 + 雷达有人 -> 确认为火灾，立即启动紧急预案，切断该教室电源（若对接智能空开），并拨打负责人电话。
6. 部署与实施
安装位置
雷达波可穿透石膏板，但无法穿透厚实墙体。安装时需调整角度，确保覆盖教室主要活动区域。
烟感部分应避免安装在油烟口或通风口正上方。
网络保障
设备依赖 Wi-Fi，培训机构的 Wi-Fi 信道可能存在拥堵。为每个设备设置静态 IP 或确保 Wi-Fi 信号强度大于 -65dBm。
平台代码集成
由于芯步使用 MD5 签名，安全性较高。在集成时，请一定要在服务器端（而非前端网页）计算 Sign 和存储 AppSecret，以防密钥泄露。
可视化管理后台
在后台做一张 “培训机构安全地图”。
绿色表示安全无人/无烟；红色表示报警。
单击设备图标，可查看该教室最后一次雷达探测到人的时间，方便保洁或安保复盘。
7. 预期效益
响应速度提升：从传统的“现场发现”变为“手机/平台秒级推送”，响应时间缩短至 5 秒内。
降低人力成本：安保人员无需逐个教室巡查，通过后台即可查看所有教室的“有人/无人”状态及烟雾状况。
隐患前置发现：在火源初起阶段（阴燃）即可通过烟雾报警发现，避免酿成大祸。
注：本方案引用的接口规范基于“智能人体存在雷达和烟雾传感器[壁挂]”的通用 HTTP 接口文档。具体开发时，请以最新设备的产品手册和 API 更新日志为准。