一、背景与需求
培训教室作为人员密集场所，消防安全是日常运营的重中之重。传统烟感报警器存在两大痛点：一是报警声响起后无法快速定位具体教室位置；二是孤岛式运行，警情无法同步到管理后台和安保人员手机端。
本方案的目标是解决以下核心问题：
实时感知：烟雾浓度超标时秒级上报
远程联动：自动触发语音告警、推送通知
系统集成：将传感器数据无缝接入现有教务/安防平台
芯步的智能烟雾传感器提供标准HTTP开放接口，支持数据主动上报和远程控制，可快速集成到任意支持HTTP协议的软件项目中。
二、整体架构
数据流向说明
烟雾传感器检测到异常 → 状态变化触发上报 → 芯步平台推送至你的服务器
你的服务器处理告警逻辑 → 可反向调用控制接口 → 联动语音设备播报“xx教室发生火警”
三、接入准备工作
3.1 设备选型
推荐使用芯步智能烟雾传感器（型号参考：UNI-SD-X），具备以下特性：
烟雾浓度实时监测，采用光电式感烟技术
支持HTTP API远程控制（蜂鸣器自检、灵敏度调节）
低功耗设计，电池供电也可部署
3.2 平台配置
注册账号：访问芯步官网完成注册
创建工作台：进入控制台创建项目空间
获取凭证：在“开发设置”中获取
AppID和AppSecret，这是后续API调用的身份凭证配置消息推送URL：设置你的服务器接收地址，例如
https://yourdomain.com/api/yoyo/callback
⚠️ 消息推送URL需为公网可访问地址，支持HTTP/HTTPS协议。平台仅判断HTTP状态码是否为200，无需特定返回值。
3.3 设备激活
将烟雾传感器通电联网后，在控制台设备列表中获取 device ID（如 830212），后续所有操作均依赖此ID。
四、核心接口详解
4.1 数据上报接口（接收告警）
这是最核心的对接环节——当烟雾浓度超阈值或设备状态变化时，芯步平台会主动推送消息到你配置的服务器地址。
推送消息格式（HTTP POST）
字段解析
| 字段 | 说明 | 示例值 |
|---|---|---|
device | 设备唯一ID，用于定位具体教室 | 830212 |
type | 固定为"state"，表示状态上报 | state |
message.data[].smoke_value | 烟雾浓度数值（单位：ppm或百分比，以产品规格为准） | 358 |
message.data[].smoke_alarm | 告警标志：0=正常，1=告警 | 1 |
message.data[].battery | 电量百分比 | 95 |
你的服务器需要做的
返回HTTP 200状态码（不要求特定响应体）
解析
device字段映射到具体教室（需预先建立设备ID与教室的对应关系）根据
smoke_alarm=1触发告警流程
4.2 设备控制接口（下发指令）
当接收到告警后，可反向调用控制接口，实现远程联动。例如：触发语音音柱播报“301教室发生火情，请立即撤离”。
请求地址
签名算法（重要）
其中 ts 为Unix时间戳（秒），md5() 为32位小写哈希。
请求示例（控制蜂鸣器鸣响）：
成功响应
⚠️ 返回200仅表示平台成功接收指令，不代表设备已执行。设备离线时指令会失败，如需确认执行结果，应监听异步消息推送。
4.3 仿真测试
芯步控制台提供在线调试功能，可在“设备管理”页面直接下发 {"buzzer":1} 测试蜂鸣器是否正常工作，无需编写代码。
五、项目集成步骤
5.1 创建告警接收服务（Node.js示例）
5.2 实现语音联动
假设培训教室已部署芯步智能语音音柱（支持HTTP控制），可在告警时自动调用：
5.3 设备-教室映射管理
在数据库中维护以下结构：
| 设备ID | 教室名称 | 教学楼 | 楼层 | 负责人电话 |
|---|---|---|---|---|
| 830212 | 培训301 | A座 | 3F | 138****1234 |
| 830215 | 培训302 | A座 | 3F | 138****1235 |
六、告警与联动策略
6.1 分级告警规则
| 烟雾浓度阈值 | 告警级别 | 联动动作 |
|---|---|---|
| 50-150 | 提示级 | 仅记录日志，控制台显示 |
| 150-300 | 预警级 | APP推送 + 现场蜂鸣器间歇鸣响 |
| >300 | 紧急级 | 语音音柱播报 + 短信/电话通知负责人 + 蜂鸣器持续鸣响 |
6.2 消警与自检
远程消音：管理员确认误报后，调用
{"buzzer":0}停止蜂鸣定时自检：每日凌晨调用
{"mq_enable":1}测试传感器是否正常
七、常见问题和需要注意的点
Q1：消息推送收不到怎么办？
排查步骤
确认服务器URL公网可达（可用curl测试）
检查服务器是否正常返回HTTP 200
平台推送超时时间为5秒，请确保接口响应快速
可在控制台“消息推送日志”中查看失败记录
Q2：设备ID在哪里获取？
设备外壳上的标签、物联网控制台的设备列表、或通过设备列表接口拉取。
Q3：一个教室部署多个传感器如何管理？
芯步支持向多个设备批量下发指令，device 参数用 | 或 , 分隔即可，如 device=830212,830213。
Q4：是否支持局域网私有化部署？
部分芯步产品（如语音音柱）支持纯局域网运行，需在企业版合同中约定。
八、方案总结
通过芯步的开放HTTP接口，可以低成本、高效率地将烟雾传感器集成到培训教室的安全监控系统中。核心工作仅需三步：
配置消息推送：在平台设置你的服务器接收地址
实现告警接收：解析推送数据，匹配教室信息，触发通知
反向联动控制：调用控制接口实现语音播报、远程消音
完整的接口调用链路为：传感器上报 → 平台推送 → 自建服务处理 → 反向控制联动设备。整个过程延迟可控（通常在2秒以内），满足培训教室场景的安全响应要求。