无人值守射频设备管理：怎么将射频设备联网模块接入到自己的项目中_解决方案

CATALOG

一、概述

在无人值守场景中，如自助洗车机、共享设备柜、远程泵站、无人值守停车场等，设备状态监控和远程告警是关键环节。传统方案依赖本地声光报警，运维人员无法实时获知设备异常，导致故障响应滞后、营收损失。

芯步智能射频网关可将传统的315MHz/433MHz无线传感器和控制设备接入互联网，通过开放的HTTP接口让您的管理系统能够远程接收设备告警、实时监测设备状态，实现无人值守场景的智能化管理。

1.1 核心价值

开放HTTP接口：适用于任何编程语言，10分钟完成对接
无线覆盖：射频控制距离300米（空旷环境），适配大面积无人值守场景
双向通信：支持接收传感器数据（315MHz）+ 控制射频设备（433MHz）
私有化部署：支持纯局域网运行，数据安全可控
⚡ 毫秒级响应：从传感器触发到平台接收仅需毫秒级

1.2 典型无人值守场景

场景	传感器类型	告警内容	联动控制
自助洗车机	水位传感器、泡沫液位传感器	缺液告警	远程锁机
共享设备柜	门磁传感器、震动传感器	非法开门告警	触发声光报警
远程泵站	水浸传感器、压力传感器	漏水/欠压告警	远程关阀
无人停车场	地磁传感器、道闸传感器	车位满/故障告警	远程抬杆

二、产品选型与规格

2.1 智能射频网关核心参数

参数	规格
产品型号	UNI-WG-SP（WiFi版）/ UNI-WG-SP-LAN（有线网版）
发射频率	433MHz
接收频率	315MHz
控制距离	300米（空旷环境）
供电电源	DC 5V (USB Type-C)
待机功耗	0.6W
产品尺寸（WiFi版）	110×66×110mm
产品尺寸（有线版）	110×36×110mm
外壳材质	ABS塑料
联网方式	WiFi 2.4GHz / 10Mbps以太网

2.2 版本对比

版本	联网方式	适用场景
UNI-WG-SP（WiFi版）	WiFi 2.4GHz	无人值守场景WiFi覆盖良好，部署灵活
UNI-WG-SP-LAN（有线版）	有线以太网+WiFi	网络环境复杂，追求更稳定

三、接入架构

3.1 架构

┌─────────────────────────────────────────────────────────────────┐
│                    无人值守设备管理平台                          │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐          │
│  │  运维后台     │  │  告警推送服务 │  │  数据分析平台 │          │
│  └──────┬───────┘  └──────┬───────┘  └──────┬───────┘          │
│         │                  │                  │                  │
│         └──────────────────┼──────────────────┘                  │
│                            │                                     │
│                  ┌─────────▼─────────┐                          │
│                  │   HTTP接口封装层   │                          │
│                  │ （轮询/接收数据）   │                          │
│                  └─────────┬─────────┘                          │
└────────────────────────────┼────────────────────────────────────┘
                             │
                      HTTP/HTTPS
                             │
┌────────────────────────────▼────────────────────────────────────┐
│                      芯步云平台                              │
│                 （或私有化部署的消息服务器）                       │
└────────────────────────────┬────────────────────────────────────┘
                             │
                      WiFi / 以太网
                             │
┌────────────────────────────▼────────────────────────────────────┐
│               智能射频网关（UNI-WG-SP / UNI-WG-SP-LAN）         │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐              │
│  │ 433MHz发射   │  │ 315MHz接收   │  │  控制距离    │              │
│  │ 控制设备     │  │ 采集传感器   │  │   300m      │              │
│  └─────────────┘  └─────────────┘  └─────────────┘              │
└─────────────────────────────────────────────────────────────────┘
                              │
          ┌──────────────────┼──────────────────┐
          ▼                  ▼                  ▼
    ┌─────────┐        ┌─────────┐        ┌─────────┐
    │ 传感器1 │        │ 传感器2 │        │ 控制器  │
    │ 315MHz │        │ 315MHz │        │ 433MHz │
    └─────────┘        └─────────┘        └─────────┘

3.2 数据流向

上行采集：315MHz传感器（水位、门磁、震动等）→ 射频网关 → 云平台 → 您的软件
下行控制：您的软件 → 云平台 → 射频网关 → 433MHz设备（报警器、电磁锁等）

四、快速接入步骤

4.1 准备工作（5分钟）

根据芯步官方开发文档，对接前需要完成以下准备工作

注册开发者账号：访问芯步官网，通过手机号一键注册并登录
获取开发凭证：进入工作台 → 物联网控制台 → 开发设置，获取AppID并设置开发者密码（AppSecret）
开启调试模式（开发阶段）：在控制台打开“调试模式”，此时不检查签名和时间戳，可快速验证接口
设备配网：给射频网关通电，按照《产品手册》引导进行配网
验证设备在线：在控制台设备列表中确认设备状态为“在线”

提示：如果没有实体设备，可以在控制台左侧导航中找到“演示设备”，用于前期对接测试。

4.2 接口规范

根据芯步开发文档，接口采用HTTP协议，使用任何可进行HTTP请求的编程语言均可调用；接口调用的方法完全一致，仅命令不同。

请求地址

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

核心参数

参数	名称	说明
AppId	应用ID	在控制台开发设置中获取，拼接到URL路径
ts	时间戳	请求时间的时间戳（秒），10位数字
sign	签名	详见下方计算方法

签名计算方法

根据芯步官方文档，签名计算方式为两层MD5加密：

第1步:md5_secret = md5(开发者密码)
第2步:sign = md5(md5_secret + ts)   // 直接拼接字符串，无连接符

4.3 请求体格式

具体的命令格式请查看对应产品的《产品手册》。

五、设备管理与命令参考

5.1 子设备管理

射频网关支持添加/移除/列表查询子设备（传感器和控制器）

命令类型	命令说明	用途
`device_list`	查询子设备列表	获取已注册的传感器/控制器
`device_add`	添加子设备	注册新的传感器/控制器
`device_remove`	移除子设备	删除已注册的设备

5.2 传感器数据获取

根据产品需求文档，射频网关通过315MHz频率接收传感器上报数据，有两种获取方式：

方式一（推荐）：平台推送（私有化部署时支持MQTT推送）
方式二：HTTP轮询

5.3 通用封装

根据芯步开发文档，如果仅控制设备，可以只封装一个函数，将设备ID和命令作为参数传入。如果需要更多管理操作（如子设备管理、分组管理等），可以封装一个完整的类。

六、代码集成示例

6.1 Python完整示例

import hashlib
import time
import requests
import json
from typing import Dict, Optional, List
from datetime import datetime

class RFDeviceManager:
    """无人值守射频设备管理器"""
    
    def __init__(self, app_id: str, app_secret: str, gateway_id: str, debug: bool = False):
        self.app_id = app_id
        self.app_secret = app_secret
        self.gateway_id = gateway_id
        self.debug = debug
        self.base_url = "https://api.thingboot.com"
        # 子设备映射
        self.sensors = {}      # 传感器ID -> 传感器信息
        self.actuators = {}    # 控制器ID -> 控制器信息
    
    def _generate_sign(self, timestamp: int) -> str:
        """生成签名:md5(md5(AppSecret) + ts)"""
        if self.debug:
            return "debug_mode"
        md5_secret = hashlib.md5(self.app_secret.encode()).hexdigest()
        sign_str = md5_secret + str(timestamp)
        sign = hashlib.md5(sign_str.encode()).hexdigest()
        return sign
    
    def _send_command(self, order: dict) -> dict:
        """发送命令到射频网关"""
        ts = int(time.time())
        sign = self._generate_sign(ts)
        url = f"{self.base_url}/{self.app_id}/device/control/"
        params = {"sign": sign, "ts": ts}
        data = {"device": self.gateway_id, "order": order}
        
        response = requests.post(url, params=params, json=data)
        return response.json()
    
    # ========== 子设备管理 ==========
    
    def add_sensor(self, sensor_id: int, sensor_type: str, name: str) -> dict:
        """
        添加传感器到网关
        sensor_type: water(水位), door(门磁), vibration(震动), pressure(压力)
        """
        self.sensors[sensor_id] = {
            "id": sensor_id,
            "type": sensor_type,
            "name": name,
            "last_data": None,
            "last_update": None
        }
        
        order = {
            "type": "device_add",
            "device": sensor_id,
            "sensor_type": sensor_type
        }
        return self._send_command(order)
    
    def get_sensor_status(self, sensor_id: int) -> Optional[Dict]:
        """查询传感器最新状态（轮询方式）"""
        order = {
            "type": "query",
            "device": sensor_id,
            "sensor": "status"
        }
        result = self._send_command(order)
        
        if result.get('code') == 200:
            # 更新本地缓存
            self.sensors[sensor_id]['last_data'] = result.get('data')
            self.sensors[sensor_id]['last_update'] = datetime.now()
        
        return result
    
    def get_all_sensors_status(self) -> Dict:
        """获取所有传感器状态"""
        results = {}
        for sensor_id in self.sensors.keys():
            results[sensor_id] = self.get_sensor_status(sensor_id)
        return results
    
    # ========== 射频控制 ==========
    
    def control_device(self, device_id: int, action: str) -> dict:
        """
        控制射频设备
        action: on(开启), off(关闭), trigger(触发)
        """
        order = {
            "type": "control",
            "device": device_id,
            "action": action
        }
        return self._send_command(order)
    
    # ========== 告警处理 ==========
    
    def handle_alert(self, sensor_id: int, alert_data: dict) -> dict:
        """处理传感器告警"""
        sensor = self.sensors.get(sensor_id, {})
        
        alert_info = {
            "sensor_id": sensor_id,
            "sensor_name": sensor.get('name', '未知'),
            "sensor_type": sensor.get('type', '未知'),
            "alert_data": alert_data,
            "timestamp": datetime.now().isoformat()
        }
        
        # 根据传感器类型处理告警
        alert_type = sensor.get('type')
        if alert_type == "water":
            return self._handle_water_alert(alert_info)
        elif alert_type == "door":
            return self._handle_door_alert(alert_info)
        elif alert_type == "vibration":
            return self._handle_vibration_alert(alert_info)
        else:
            return self._handle_general_alert(alert_info)
    
    def _handle_water_alert(self, alert_info: dict) -> dict:
        """处理水浸告警"""
        print(f" 水浸告警: {alert_info['sensor_name']}")
        # 触发联动控制（如关闭进水阀）
        return {"action": "close_valve", "status": "alert"}
    
    def _handle_door_alert(self, alert_info: dict) -> dict:
        """处理门磁告警"""
        print(f" 门磁告警: {alert_info['sensor_name']}")
        # 触发声光报警
        return {"action": "alarm", "status": "alert"}
    
    def _handle_vibration_alert(self, alert_info: dict) -> dict:
        """处理震动告警"""
        print(f" 震动告警: {alert_info['sensor_name']}")
        return {"action": "record", "status": "alert"}
    
    def _handle_general_alert(self, alert_info: dict) -> dict:
        """处理通用告警"""
        print(f"⚠️ 告警: {alert_info['sensor_name']}")
        return {"action": "notify", "status": "alert"}

# ========== 使用示例 ==========
manager = RFDeviceManager(
    app_id="your_app_id",
    app_secret="your_app_secret",
    gateway_id="rf_gateway_01",
    debug=True
)

# 1. 添加传感器
manager.add_sensor(101, "water", "洗车机水箱水位传感器")
manager.add_sensor(102, "door", "设备柜门磁传感器")
manager.add_sensor(103, "vibration", "自助设备震动传感器")

# 2. 查询传感器状态
status = manager.get_sensor_status(101)
print(f"传感器101状态: {status}")

# 3. 处理传感器告警
alert = manager.handle_alert(101, {"level": "low", "value": "10%"})

6.2 cURL命令示例

6.3 无人值守场景告警集成

class UnattendedAlertSystem:
    """无人值守告警系统"""
    
    def __init__(self, manager: RFDeviceManager):
        self.manager = manager
        self.alert_history = []
        self.webhook_url = None
    
    def set_webhook(self, url: str):
        """设置告警推送webhook（钉钉/企业微信）"""
        self.webhook_url = url
    
    def process_sensor_data(self, sensor_id: int, raw_data: dict) -> dict:
        """处理传感器上报数据"""
        # 解析传感器数据
        parsed = self._parse_sensor_data(sensor_id, raw_data)
        
        # 判断是否触发告警
        if parsed['alert_triggered']:
            alert_result = self._dispatch_alert(parsed)
            self.alert_history.append(alert_result)
            return alert_result
        
        return {"status": "normal"}
    
    def _parse_sensor_data(self, sensor_id: int, raw_data: dict) -> dict:
        """解析不同传感器的数据格式（需根据实际传感器手册定义）"""
        sensor = self.manager.sensors.get(sensor_id, {})
        sensor_type = sensor.get('type')
        
        if sensor_type == "water":
            # 水位传感器:水位低于阈值触发告警
            level = raw_data.get('level', 100)
            return {
                "sensor_id": sensor_id,
                "type": "water",
                "value": level,
                "alert_triggered": level < 20,
                "alert_message": f"水位过低:{level}%"
            }
        elif sensor_type == "door":
            # 门磁传感器:门打开触发告警
            status = raw_data.get('status', 'closed')
            return {
                "sensor_id": sensor_id,
                "type": "door",
                "value": status,
                "alert_triggered": status == 'open',
                "alert_message": f"门被异常打开"
            }
        else:
            return {
                "sensor_id": sensor_id,
                "type": "unknown",
                "value": raw_data,
                "alert_triggered": False,
                "alert_message": None
            }
    
    def _dispatch_alert(self, alert: dict) -> dict:
        """分发告警"""
        # 1. 记录告警历史
        alert['timestamp'] = datetime.now().isoformat()
        
        # 2. 推送webhook（钉钉/企业微信）
        if self.webhook_url:
            self._send_webhook(alert)
        
        # 3. 触发联动控制
        self._trigger_action(alert)
        
        return alert
    
    def _send_webhook(self, alert: dict):
        """发送webhook告警"""
        message = {
            "msgtype": "text",
            "text": {"content": f"【无人值守告警】{alert['alert_message']}"}
        }
        try:
            requests.post(self.webhook_url, json=message)
        except Exception as e:
            print(f"Webhook发送失败: {e}")
    
    def _trigger_action(self, alert: dict):
        """触发联动控制"""
        sensor_type = alert.get('type')
        if sensor_type == "water":
            # 低水位告警:触发补液请求
            print("触发补液流程")
        elif sensor_type == "door":
            # 门磁告警:触发声光报警
            self.manager.control_device(201, "trigger")

七、数据获取方式

7.1 轮询方式

通过HTTP接口周期性查询传感器状态：

7.2 消息推送方式（私有化部署）

私有化部署时，射频网关支持将传感器数据直接推送到您的服务器：

在控制台中配置消息推送地址
传感器上报数据时，平台主动推送JSON数据到您的接口
您的系统接收并处理数据

八、私有化部署方案

对于数据安全要求高的无人值守场景，芯步射频网关支持纯局域网私有化部署。设备配网后，可在内网直接控制，无需经过云平台

请求地址http://{设备IP地址}/control

如果配置了密码，需携带sign参数：sign = md5(密码)。

九、无人值守场景部署

9.1 部署规划

场景	设备数量	网关选型	传感器推荐
自助洗车机	1-5台	WiFi版	水位传感器、泡沫液位传感器
共享设备柜	10-20个柜	有线版	门磁传感器、震动传感器
远程泵站	1个站点	有线版	水浸传感器、压力传感器
无人停车场	1-2个进出口	WiFi版	地磁传感器、道闸传感器

9.2 射频覆盖

射频网关控制距离300米（空旷环境）
如有金属设备遮挡，缩短距离或增加网关数量
网关安装高度2-3米，减少障碍物干扰
有线网版（UNI-WG-SP-LAN）厚度仅36mm，更易安装于狭窄空间

9.3 供电与网络要求

项目
供电	DC 5V USB供电，接入UPS
网络	WiFi信号强度≥-70dBm，或使用有线版
温度	工作温度0℃~+50℃

十、常见问题

Q1：射频网关的控制距离是多少？

A：在空旷环境中控制距离可达300米。如有大型金属设备遮挡，实际距离会缩短，测试后确定安装位置。

Q2：支持同时接入多少个传感器？

A：一台射频网关理论上支持接入多个315MHz传感器，具体数量请参考《产品手册》。如需更多传感器，可增加网关数量。

Q3：如何接收传感器数据？

A：有两种方式：

轮询：通过HTTP接口定期查询传感器状态
推送：私有化部署时，传感器数据可主动推送到您的服务器

Q4：是否需要额外的网关或中转设备？

A：不需要。射频网关WiFi直连，无需额外网关。

Q5：没有实体设备可以测试吗？

A：可以。在物联网控制台中有“在线演示设备”可用于接口调试。

Q6：如何判断传感器触发告警？

A：需要在您的软件中定义告警逻辑。射频网关负责接收传感器数据并上报到平台，告警判断和联动处理由您的系统完成。

十一、方案总结

步骤	耗时	要点
1. 设备选型与部署	15分钟	根据场景选择WiFi版或有线版
2. 注册配网	5分钟	获取AppID/Secret，设备通电联网
3. 接口对接	10分钟	实现签名计算和HTTP调用
4. 告警集成	按需	定义传感器告警逻辑、配置推送

技术优势

✅ 无线覆盖：射频300米覆盖，无需布线施工
✅ 双向通信：支持接收传感器数据+控制射频设备
✅ 开放HTTP接口：适用于任何编程语言，10分钟完成对接
✅ 子设备管理：支持添加/移除/查询传感器和控制器
✅ 私有化部署：数据可完全运行在内网环境
✅ 联网可选：WiFi版部署灵活，有线版稳定可靠

适用场景：自助洗车机缺液告警、共享设备柜非法开门报警、远程泵站漏水监测、无人停车场车位检测、设备震动防盗监测、远程设备状态巡检。

如需技术支持，芯步提供免费技术指导——从选型、对接到安装、调试，可随时联系工程师协助对接。

一、概述

1.1 核心价值

1.2 典型无人值守场景

二、产品选型与规格

2.1 智能射频网关核心参数

2.2 版本对比

三、接入架构

3.1 架构

3.2 数据流向

四、快速接入步骤

4.1 准备工作（5分钟）

4.2 接口规范

请求地址

签名计算方法

4.3 请求体格式

五、设备管理与命令参考

5.1 子设备管理

5.2 传感器数据获取

5.3 通用封装

六、代码集成示例

6.1 Python完整示例

6.2 cURL命令示例

6.3 无人值守场景告警集成

七、数据获取方式

7.1 轮询方式

7.2 消息推送方式（私有化部署）

八、私有化部署方案

九、无人值守场景部署

9.1 部署规划

9.2 射频覆盖

9.3 供电与网络要求

十、常见问题

Q1：射频网关的控制距离是多少？

Q2：支持同时接入多少个传感器？

Q3：如何接收传感器数据？

Q4：是否需要额外的网关或中转设备？

Q5：没有实体设备可以测试吗？

Q6：如何判断传感器触发告警？

十一、方案总结

网关产品方案：

如何接入射频信号中继器以实现远程控制射频设备

怎样对接433射频网关以实现无线设备数据上报

怎样二次开发射频转WiFi网关来实现HTTP接口远程控制

门店射频设备管理：怎么将433射频网关接入到自己的项目中

怎样在设备机房射频信号管理中对接智能硬件以实现射频信号转发处理

无人值守场景方案：

怎样在无人值守门店安全管理中对接智能硬件来实现多设备安全联动控制

无人值守空间语音提示：怎么将20W 远程 TTS 语音壁挂音箱对接到项目中

怎样在无人值守门店机柜电源控制中对接智能设备以实现多设备联动控制

无人值守场所安全语音提醒场景：怎样将20W 自动语音通知音箱对接到软件项目中

无人值守空间管理：怎样将智能墙壁复合开关|3路接入到自己的项目中

射频用途方案：

会议室射频设备控制：怎么把射频转WiFi网关接入到项目中

智能家居射频设备管理：怎样将433射频网关对接到软件项目中

舞蹈室射频设备联动：怎么将智能射频通讯网关对接到软件项目中

如何在门店射频设备管理中对接智能硬件来实现射频信号转发处理

安防门禁射频信号接入：怎么将射频转WiFi网关对接到项目中