怎么接入壁挂式商用雷达烟雾监测器以实现烟雾浓度检测_解决方案

CATALOG

芯步的壁挂式商用雷达烟雾监测器支持通过HTTP接口直接获取烟雾浓度数据，采用“设备主动推送 + 业务系统订阅”的架构。以下是具体的接入方案。

1. 接入概述

芯步的智能硬件采用 “设备上报 + 平台推送” 的通信模式。

下行（控制）：你的服务器通过调用芯步开放平台的 HTTP API，向设备下发指令（如：开启蜂鸣器、关闭雷达、自检等）。
上行（数据）：当设备检测到烟雾浓度变化或有人员移动时，会主动将消息推送到你指定的 HTTP 服务器地址。

核心逻辑：你不需要频繁“轮询”设备要数据，设备会在发生危险时（或状态变化时）瞬间把数据“扔”给你的服务器。

2. 准备工作

在开始编码前，请完成以下基础设置：

获取凭证：登录芯步控制台，在“开发设置”页面获取 AppID 和 AppSecret。这是调用接口的身份凭证。
设置推送URL：在控制台中，配置 “消息推送”地址。这是你用来接收烟雾浓度数据的公网接口地址（例如：http(s)://yourdomain.com/api/smoke/report）。
获取设备ID：在控制台“设备列表”中查看设备ID，后续接口调用需要该参数。

3. 接入流程

第一步：配置数据接收服务器

这是接入最关键的一步。你需要搭建一个Web服务器，并在芯步控制台配置该服务器的公网地址。

当烟雾浓度超过阈值或雷达检测到人体时，设备会向该地址发送如下格式的JSON数据（参考同类传感器逻辑）：

你需要做的：后端解析上述JSON中的 smoke_concentration 字段，根据业务逻辑（如浓度>50）触发告警、记录数据库或调用消防系统。

第二步：对接下发指令（可选）

如果你需要远程控制设备（如关闭蜂鸣器、自检），需调用控制接口。

请求地址https://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={timestamp}
签名算法md5( md5(AppSecret) + ts )
请求体示例

4. 代码实现示例

以下是一个Python示例，用于接收设备推送的烟雾数据（基于Flask框架），以及主动向设备下发命令。

import hashlib
import time
import requests
from flask import Flask, request

app = Flask(__name__)

# --- 配置参数 ---
APP_ID = "你的AppID"
APP_SECRET = "你的AppSecret"
DEVICE_ID = "设备ID"

# --- 1. 接收烟雾浓度数据上报 ---
@app.route(‘/api/yoyo/smoke_callback', methods=['POST'])
def smoke_callback():
    data = request.json
    if not data:
        return "error", 400
    
    device_id = data.get('device_id')
    smoke_val = data.get('data', {}).get(‘smoke_concentration')
    radar_val = data.get('data', {}).get('radar_status')
    
    print(f"设备 {device_id} 烟雾浓度: {smoke_val}")
    
    # 业务逻辑:阈值判断
    if smoke_val and int(smoke_val) > 70:
        # 触发火灾告警流程...
        print("⚠️ 检测到高浓度烟雾！启动紧急预案")
        # 可以在这里联动调用其他接口关闭阀门或开门禁
    
    return "OK", 200

# --- 2. 主动下发命令（例如:消音）---
def control_device(order_json, device_id=DEVICE_ID):
    ts = int(time.time())
    
    # 计算签名: md5(md5(AppSecret) + ts)
    m1 = hashlib.md5(APP_SECRET.encode()).hexdigest()
    sign_str = m1 + str(ts)
    sign = hashlib.md5(sign_str.encode()).hexdigest()
    
    url = f"https://api.thingboot.com/{APP_ID}/device/control/"
    params = {
        'sign': sign,
        'ts': ts
    }
    payload = {
        'device': device_id,
        'order': order_json
    }
    
    response = requests.post(url, params=params, json=payload)
    return response.json()

# 示例:如果确认是误报，调用该函数关闭蜂鸣器
def mute_alarm():
    result = control_device({"buzzer": 0})
    print("关闭报警结果:", result)

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

5. 关键命令与参数说明

针对该壁挂式设备，常用的 order 指令如下

命令Key	类型	说明	取值
mq_enable	烟雾模块开关	开启或关闭烟雾浓度检测功能	`1` (开启) / `0` (关闭)
radar_enable	雷达开关	开启或关闭人体存在探测	`1` / `0`
buzzer	蜂鸣器控制	本地声光报警	`1` (响) / `0` (关/消音)
power	线路控制	如果有继电器版本，可切断电源	`1` (通) / `0` (断)

6. 常见问题排查

收不到推送
- 确认你的服务器地址是公网可访问的，且端口开放。
- 检查是否配置了签名（如果是生产环境且开启验证，需要实现签名校验）。在调试模式下，可暂时关闭签名验证方便测试。
误报或探测不准
- 雷达探测距离约为4米内（人体存在）至6米内（运动），安装高度2-3米，避免对着空调出风口或风扇。
- 烟雾传感器是气体传感器，注意避免安装于通风口或油烟直喷处。
签名错误（5006）
- 签名算法是双层MD5md5( md5(Secret) + ts )，请请一定要确认拼接顺序和时间戳单位为秒。

通过以上步骤，你可以快速完成壁挂式商用雷达烟雾监测器的接入，实现烟雾浓度与人员探测的实时监控。