安全节能场景：怎么将智能家居烟雾传感器接入到项目中_解决方案

CATALOG

一、概述

在安全节能场景中，烟雾传感器的核心价值在于实时监测火灾隐患并联动应急响应。传统的烟雾报警器只能本地发声，无人值守时无法及时通知相关人员。芯步智能烟雾传感器通过开放HTTP接口，将烟雾状态实时上报到您的软件系统，实现远程监控和多设备联动。

核心能力

烟雾浓度实时监测，状态变化主动上报
开放HTTP接口/消息推送，无缝集成到现有系统
支持私有化部署，数据不出本地
无需网关，WiFi直连，部署简单

安全节能联动场景示例

触发条件	联动动作	说明
烟雾报警	远程推送告警消息	立即通知管理人员
烟雾报警	切断联动设备电源	智能PDU断电，防止火灾扩大
烟雾报警	触发语音播报	通过音箱提示人员疏散
烟雾解除	自动恢复监控	无需人工复位

二、产品型号与选型

芯步提供多款烟雾传感器，可根据场景需求选择：

产品型号	功能特点	适用场景
UNI-CGQ-YW	纯烟雾检测，壁挂安装，AC供电	厨房、仓库、机房
UNI-CGQ-RT-L-YW-BG	烟雾检测 + 人体存在雷达，二合一	办公室、商铺、住宅

共同技术特性

无线连接：WiFi 2.4GHz（可设定5组网络，自动切换信号最强的网络）
工作电压：AC 100-250V（交流市电）
外壳材质：防火V0级PC，耐高温，符合安规标准
开放HTTP接口，支持任何支持HTTP请求的编程语言

三、接入架构

3.1 整体架构图

┌─────────────────────────────────────────────────────────────────┐
│                    安全管理平台 / 物业系统                        │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐               │
│  │  告看板     │  │  SMS/APP    │  │  工单系统   │               │
│  └─────────────┘  └─────────────┘  └─────────────┘               │
└─────────────────────────────────────────────────────────────────┘
                              ▲
                              │ HTTP消息推送
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│                     芯步云平台 / 私有化服务器                  │
│                     （消息推送配置URL）                           │
└─────────────────────────────────────────────────────────────────┘
                              ▲
                              │ WiFi 2.4GHz（状态上报）
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│                     智能烟雾传感器                               │
│                   （壁挂安装于监测区域）                          │
└─────────────────────────────────────────────────────────────────┘
          ┌───────────────┼───────────────┐
          ▼               ▼               ▼
    智能PDU断电      语音音箱播报      摄像头抓拍
   （联动设备）      （联动设备）      （联动设备）

3.2 两种接入方式对比

方式	说明	适用场景
消息推送（推荐）	设备状态变化时平台主动推送至您的服务器	实时监控、自动化联动
主动查询	通过API主动查询设备状态	定时巡检、非实时场景

本方案重点介绍消息推送方式，实现烟雾报警的毫秒级响应。

四、API接口接入详解

4.1 消息推送配置（核心）

烟雾传感器是上行设备，主要工作是上报状态变化（烟雾报警、浓度变化等）。您需要在芯步控制台配置接收地址，设备状态变化时平台会实时推送。

配置步骤

登录芯步控制台
进入「开发设置」→「消息推送」
配置您的服务器接收URL（如 https://your-domain.com/api/smoke/callback）
选择需要接收的消息类型（选择event事件消息）

消息推送格式（烟雾报警时）

4.2 命令下发（可选功能）

如需远程控制传感器模块开关，可通过HTTP API下发命令

请求地址

https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

签名计算

sign = md5( md5(AppSecret) + ts )

将开发者密码（AppSecret）进行一次MD5
将结果拼接上时间戳ts（秒级）
对整个字符串再做一次MD5

支持的控制命令

命令	参数	说明
`mq_enable`	`1`=开启/`0`=关闭	烟雾检测模块开关
`buzzer`	`1`=打开/`0`=关闭	蜂鸣器控制（远程消音）

4.3 多语言代码示例

Python（消息接收服务）

from flask import Flask, request, jsonify
import requests
import json
import logging

app = Flask(__name__)
logging.basicConfig(level=logging.INFO)

# 联动设备配置
PDU_DEVICE_ID = "pdu_main_01"      # 智能PDU设备ID
SPEAKER_DEVICE_ID = "speaker_01"   # 语音音箱设备ID
APP_ID = "your_app_id"
APP_SECRET = "your_app_secret"

def send_command(device_id, order):
    """下发命令到设备"""
    import time, hashlib
    
    ts = int(time.time())
    md5_secret = hashlib.md5(APP_SECRET.encode()).hexdigest()
    sign = hashlib.md5((md5_secret + str(ts)).encode()).hexdigest()
    
    url = f"https://api.thingboot.com/{APP_ID}/device/control/?sign={sign}&ts={ts}"
    payload = {"device": device_id, "order": order}
    
    response = requests.post(url, json=payload)
    return response.json()

@app.route('/api/smoke/callback', methods=['POST'])
def smoke_callback():
    """接收烟雾传感器消息推送"""
    try:
        data = request.get_json()
        logging.info(f"收到烟雾传感器消息: {json.dumps(data, ensure_ascii=False)}")
        
        device_id = data.get('device')
        msg_type = data.get('type')
        message = data.get('message', {})
        msg_data = message.get('data', [{}])[0]
        
        # 解析烟雾状态
        smoke_status = msg_data.get('smoke_detected')
        
        if smoke_status == "1":
            # 烟雾报警！执行联动
            logging.warning(f"⚠️ 烟雾报警！设备: {device_id}")
            handle_smoke_alarm(device_id)
        else:
            # 烟雾解除
            logging.info(f"✅ 烟雾已解除，设备: {device_id}")
            handle_smoke_clear(device_id)
        
        # 必须返回200 OK，否则平台会重试[citation:6]
        return jsonify({"code": 200}), 200
        
    except Exception as e:
        logging.error(f"处理消息异常: {str(e)}")
        return jsonify({"code": 500}), 500

def handle_smoke_alarm(device_id):
    """烟雾报警联动处理"""
    
    # 1. 发送告警通知（短信/APP推送/企业微信）
    send_alert_message("烟雾告警", f"设备{device_id}检测到烟雾，请立即处理")
    
    # 2. 联动语音播报
    try:
        send_command(SPEAKER_DEVICE_ID, {
            "play:gbk:16": "[alert_1]烟雾告警，请立即疏散"
        })
    except Exception as e:
        logging.error(f"语音播报失败: {e}")
    
    # 3. 联动智能PDU切断电源（安全措施）
    try:
        send_command(PDU_DEVICE_ID, {"power": "0"})
        logging.info("已切断设备电源")
    except Exception as e:
        logging.error(f"断电失败: {e}")

def handle_smoke_clear(device_id):
    """烟雾解除处理"""
    # 可选:发送解除通知
    send_alert_message("烟雾解除", f"设备{device_id}烟雾已解除")
    
    # 可选:恢复电源（需人工确认）
    # send_command(PDU_DEVICE_ID, {"power": "1"})

def send_alert_message(title, content):
    """发送告警消息（可对接钉钉/企业微信/短信等）"""
    # 示例:钉钉机器人
    # requests.post("https://oapi.dingtalk.com/robot/send?access_token=xxx", json={...})
    logging.info(f"告警: {title} - {content}")

if __name__ == '__main__':
    app.run(host='0.0.0.0', port=8080)

Python（主动查询设备状态）

import requests
import time
import hashlib

class SmokeSensorClient:
    """烟雾传感器主动查询客户端"""
    
    def __init__(self, app_id, app_secret):
        self.app_id = app_id
        self.app_secret = app_secret
    
    def _generate_sign(self, ts):
        md5_secret = hashlib.md5(self.app_secret.encode()).hexdigest()
        sign_str = md5_secret + str(ts)
        return hashlib.md5(sign_str.encode()).hexdigest()
    
    def get_device_status(self, device_ids):
        """
        查询设备状态
        注意:主动查询需要通过平台的设备状态查询接口
        """
        # 实际使用请参考官方文档的设备状态查询接口
        pass
    
    def disable_buzzer(self, device_id):
        """远程消音（关闭蜂鸣器）"""
        ts = int(time.time())
        sign = self._generate_sign(ts)
        
        url = f"https://api.thingboot.com/{self.app_id}/device/control/?sign={sign}&ts={ts}"
        payload = {
            "device": device_id,
            "order": {"buzzer": "0"}  # 关闭蜂鸣器[citation:5]
        }
        
        response = requests.post(url, json=payload)
        return response.json()

# 使用示例
client = SmokeSensorClient("your_app_id", "your_app_secret")
client.disable_buzzer("smoke_sensor_01")  # 远程消音

Node.js（消息接收服务）

const express = require('express');
const axios = require('axios');
const crypto = require('crypto');

const app = express();
app.use(express.json());

const APP_ID = 'your_app_id';
const APP_SECRET = 'your_app_secret';
const PDU_DEVICE_ID = 'pdu_main_01';
const SPEAKER_DEVICE_ID = 'speaker_01';

function generateSign(ts) {
    const md5Secret = crypto.createHash('md5').update(APP_SECRET).digest('hex');
    const signStr = md5Secret + ts;
    return crypto.createHash('md5').update(signStr).digest('hex');
}

async function sendCommand(deviceId, order) {
    const ts = Math.floor(Date.now() / 1000);
    const sign = generateSign(ts);
    const url = `https://api.thingboot.com/${APP_ID}/device/control/?sign=${sign}&ts=${ts}`;
    
    const response = await axios.post(url, { device: deviceId, order });
    return response.data;
}

app.post('/api/smoke/callback', async (req, res) => {
    const data = req.body;
    console.log('收到消息:', data);
    
    const smokeStatus = data.message?.data?.[0]?.smoke_detected;
    
    if (smokeStatus === '1') {
        console.log('⚠️ 烟雾报警！');
        
        // 联动语音播报
        await sendCommand(SPEAKER_DEVICE_ID, {
            "play:gbk:16": "[alert_1]烟雾告警，请立即疏散"
        });
        
        // 联动断电
        await sendCommand(PDU_DEVICE_ID, { "power": "0" });
    }
    
    res.status(200).send('ok');
});

app.listen(8080, () => {
    console.log('烟雾传感器接收服务运行在端口 8080');
});

Shell（curl）- 远程消音命令

五、安全节能场景实战

5.1 第一种场景：烟雾报警联动智能PDU断电

需求：厨房/机房检测到烟雾时，自动切断相关设备电源，防止火灾扩大。

设备配置

烟雾传感器 ×1（安装于监测区域）
智能PDU ×1（接入油烟机/排风扇等设备）

联动

烟雾传感器检测到烟雾，状态变为报警
平台推送消息到您的服务器
服务器调用PDU断电API
同时推送告警给管理人员

5.2 第二种场景：烟雾报警联动语音播报

需求：烟雾报警时，通过覆盖全场的音箱播报疏散提示。

设备配置

烟雾传感器 ×1
20W/40W语音音箱 ×n（覆盖各区域）

5.3 第三种场景：烟雾传感器远程自检与消音

需求：管理员可远程执行传感器自检，或在误报时远程关闭蜂鸣器。

5.4 场景四：多传感器集中监控看板

需求：集中监控所有烟雾传感器的状态，异常时实时更新看板。

实现的方式是

所有传感器消息推送到同一服务器
消息入库（存储设备ID、报警状态、时间戳）
前端通过WebSocket或轮询获取实时状态

数据库表结构示例

六、私有化部署方案

对于安全要求较高的场景（如政府机房、金融机构），设备支持纯局域网运行。

部署模式对比

特性	公有云模式	私有化模式
设备联网	WiFi连接互联网	连接内网WiFi
消息推送	平台推送至公网URL	推送至内网服务器
数据流向	经过芯步云端	内网直连，数据不出园区
网络依赖	需要互联网	仅需局域网

私有化配置要点

设备可设定5组WiFi网络，自动连接信号最强的网络
需自建消息接收服务器（HTTP服务）
所有数据在内网传输，无外网依赖

七、安装部署指南

7.1 安装要求

项目	要求
安装方式	壁挂式安装
安装高度	距天花板0.3-1.5米（烟雾上升聚集区域）
供电方式	AC 100-250V交流市电
网络要求	WiFi 2.4GHz信号覆盖良好
安装禁忌	远离通风口、油烟口、蒸汽源

7.2 安装注意事项

避免误报位置：不要安装在厨房灶台正上方、浴室等蒸汽区域
WiFi信号测试：金属结构可能屏蔽信号，安装前测试信号强度
定期测试：每月手动测试一次报警功能
多设备覆盖：大空间每40-60㎡部署1台

八、常见问题与排障

问题	可能原因	解决方案
设备离线	WiFi信号弱	检查2.4GHz WiFi覆盖，支持5组网络自动切换
收不到消息推送	回调地址不可达	检查服务器是否可访问，需5秒内返回200
频繁误报	安装位置不当	远离油烟、蒸汽、灰尘大的位置
蜂鸣器无法远程关闭	命令格式错误	使用`{"buzzer":"0"}`命令
同一网络多设备冲突	IP地址分配	设备通过设备ID区分，无冲突问题

九、总结

本方案基于芯步智能烟雾传感器，实现了火灾隐患的实时监控与自动化联动响应

能力	实现的方式是
烟雾实时监测	传感器检测，状态变化主动推送
远程告警通知	消息推送触发短信/APP/钉钉告警
联动断电阻灾	检测到烟雾自动切断智能PDU电源
联动语音播报	触发音箱播报疏散提示
远程消音	API下发`buzzer`命令关闭蜂鸣器

集成核心步骤

获取AppID/AppSecret
在控制台配置消息推送URL
开发HTTP接收服务，解析烟雾报警状态
实现联动逻辑（告警通知、断电控制、语音播报）

方案优势

✅ 实时监测：烟雾状态变化毫秒级上报
✅ 接口统一：标准HTTP API，任意编程语言可接入
✅ 部署灵活：WiFi直连无需网关，支持私有化部署
✅ 联动丰富：可与PDU、音箱等多种设备联动
✅ 安全可靠：防火V0级外壳，符合安规标准

如需详细的产品手册和API文档，请访问查阅或联系技术支持团队获取。