线下服务场景射频控制：如何将射频设备联网模块对接到项目中_解决方案

CATALOG

——基于芯步智能射频网关的设备联网与软件对接实践

一、行业背景与需求分析

线下服务场景广泛覆盖酒店、餐饮、办公、商业综合体等各类实体空间，在这些场景中，大量射频控制设备承担着关键的服务功能——遥控窗帘、电动投影幕、灯光控制、呼叫器、门禁开关等。然而，这些设备面临着共同的痛点：

痛点一：设备孤岛化。 现有射频设备（433MHz/315MHz）各自独立运行，无法与线上业务系统联动。例如，酒店客人通过APP下单叫醒服务后，仍需人工操作叫醒设备；会议室预订系统确认后，投影幕、灯光仍需现场手动遥控。

痛点二：管理效率低。 服务人员需要携带多个遥控器，在不同区域间奔波操作。大型酒店、办公楼宇中，设备分散部署，巡检和操作成本居高不下。

痛点三：智能化能力缺失。 线下设备与线上订单、会员系统、IoT平台割裂，无法实现“用户触发→系统联动→设备响应”的自动化闭环。

针对上述问题，芯步提供的智能射频网关，可将传统射频控制设备快速接入互联网，通过标准化的API接口集成到各类软件项目中，实现线下射频设备的云端统一控制与智能化联动。

二、硬件产品介绍：芯步智能射频网关

2.1 产品概述

芯步智能射频网关是一款专门用于将传统射频设备（433MHz/315MHz）接入物联网的硬件产品，可连接各类射频遥控设备，实现“老旧设备不更换、能力云端化”的智能升级。

2.2 技术规格

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

数据来源：

2.3 核心能力

智能射频网关的核心价值在于“承上启下”：

向下连接射频设备：可学习并存储各类射频遥控器的编码，替代原有遥控器向射频设备（窗帘电机、投影幕、灯光控制器、呼叫器等）发射433MHz控制信号
向上对接软件系统：开放标准化HTTP接口，支持Web、APP/小程序、窗体软件、SaaS/低代码平台等任意形式的软件项目接入

三、技术对接方案

3.1 对接架构

芯步采用“云端API下发指令”的控制模式。开发者通过HTTP接口向智能射频网关发送控制命令，网关接收后转换为433MHz射频信号，控制终端设备执行相应动作。

系统整体架构如下：

┌─────────────────────────────────────────────────────────────────┐
│                    线下服务综合管理平台                           │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────────────────┐ │
│  │ 业务系统     │  │ 小程序/APP  │  │ 语音/AI助手              │ │
│  │ •订单联动    │  │ •用户控制   │  │ •场景联动                │ │
│  └─────────────┘  └─────────────┘  └─────────────────────────┘ │
│                              ↓                                    │
│                    HTTP API (设备控制)                            │
│  ┌─────────────────────────────────────────────────────────────┐ │
│  │                    芯步云平台                            │ │
│  └─────────────────────────────────────────────────────────────┘ │
│                              ↓                                    │
│                      WiFi / 以太网                                │
└─────────────────────────────────────────────────────────────────┘
                               ↓
    ┌─────────────────────────────────────────────────────────────┐
    │                      智能射频网关                            │
    │               (433MHz发射 / 315MHz接收)                      │
    └─────────────────────────────────────────────────────────────┘
                               ↓ 433MHz射频信号
    ┌───────────┐  ┌───────────┐  ┌───────────┐  ┌───────────┐
    │ 电动窗帘   │  │ 投影幕     │  │ 灯光控制器 │  │ 服务呼叫器 │
    └───────────┘  └───────────┘  └───────────┘  └───────────┘

3.2 核心接口：向设备下发指令

芯步提供标准的HTTP API接口，支持向智能射频网关下发控制命令。

接口地址

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

签名算法

sign = md5(md5(AppSecret) + ts)

AppId：开发者应用ID，由芯步平台生成
AppSecret：开发者密钥，用于签名计算
ts：当前Unix时间戳（秒）

请求参数

名称	必填	类型	说明
gateway	否	string	网关设备ID，当命令需网关转发时指定
device	是	string	设备ID，设备唯一标识
order	是	string	命令，可传JSON字符串

数据来源：

请求示例（控制电动窗帘关闭）：

注意：HTTP 200仅代表平台成功接收指令并向设备下发，不代表设备已成功执行。需要确认执行结果的场景，应通过云端的异步消息推送机制获取反馈。

3.3 高级特性：私有化部署与多网络保障

智能射频网关支持私有化部署，可运行在纯局域网环境中，满足金融、政务等对数据安全要求较高的场景。

网络连接方面，设备支持设定5组WiFi网络，优先连接信号最强的网络进行连接，确保控制链路的稳定性。

3.4 在项目中集成代码示例

以下是一个完整的Python Flask示例，演示如何在线下服务管理平台中集成射频设备控制：

from flask import Flask, request, jsonify
import requests
import hashlib
import time
import json
from datetime import datetime

app = Flask(__name__)

# ========== 配置参数 ==========
APP_ID = "your_app_id"           # 芯步平台分配
APP_SECRET = "your_app_secret"    # 平台分配密钥

# 射频设备映射表:设备标识 → 网关ID + 射频编码
RF_DEVICE_MAPPING = {
    "curtain_01": {
        "gateway_id": "WG001234",
        "rf_code": "A3F2C8D1",
        "name": "会议室主窗帘",
        "actions": {"open": "open", "close": "close", "stop": "stop"}
    },
    "projector_01": {
        "gateway_id": "WG001234", 
        "rf_code": "B4E3D2C1",
        "name": "会议室投影幕",
        "actions": {"up": "up", "down": "down", "stop": "stop"}
    },
    "light_01": {
        "gateway_id": "WG005678",
        "rf_code": "C5F4A3B2",
        "name": "宴会厅主灯",
        "actions": {"on": "on", "off": "off", "dim": "dim"}
    },
    "caller_01": {
        "gateway_id": "WG005678",
        "rf_code": "D6E5B4C3",
        "name": "包间服务呼叫器",
        "actions": {"ring": "ring"}
    }
}

# ========== 签名生成函数 ==========
def generate_sign(ts):
    """生成API签名"""
    first_md5 = hashlib.md5(APP_SECRET.encode()).hexdigest()
    combined = first_md5 + str(ts)
    return hashlib.md5(combined.encode()).hexdigest()

# ========== 射频设备控制函数 ==========
def control_rf_device(device_key, action, extra=None):
    """
    控制射频设备
    
    Args:
        device_key: 设备标识（如 curtain_01）
        action: 动作（如 open/close/up/down/on/off）
        extra: 附加信息（如订单号），将在异步推送中原样返回
    """
    # 获取设备配置
    device_config = RF_DEVICE_MAPPING.get(device_key)
    if not device_config:
        return {"success": False, "error": f"Device {device_key} not found"}
    
    # 获取动作对应的命令值
    action_code = device_config["actions"].get(action)
    if not action_code:
        return {"success": False, "error": f"Action {action} not supported"}
    
    # 构建控制命令
    order = {
        "rf_freq": 433,
        "rf_code": device_config["rf_code"],
        "action": action_code
    }
    
    # 支持携带附加信息（如订单号）
    if extra:
        order["extra"] = extra
    
    # 调用芯步API
    ts = int(time.time())
    sign = generate_sign(ts)
    
    control_url = f"https://api.thingboot.com/{APP_ID}/device/control/"
    payload = {
        "gateway": device_config["gateway_id"],
        "device": device_config["gateway_id"],
        "order": json.dumps(order)
    }
    
    try:
        response = requests.post(
            control_url,
            params={"sign": sign, "ts": ts},
            json=payload,
            timeout=5
        )
        result = response.json()
        
        if result.get("code") == 200:
            return {
                "success": True,
                "message": f"{device_config['name']} {action} 指令已发送",
                "device": device_key,
                "action": action,
                "timestamp": ts
            }
        else:
            return {"success": False, "error": f"API error: {result.get('code')}"}
            
    except Exception as e:
        return {"success": False, "error": str(e)}

# ========== 业务场景接口 ==========

@app.route('/api/room/curtain', methods=['POST'])
def control_curtain():
    """控制房间窗帘（酒店场景）"""
    data = request.json
    room_id = data.get('room_id')
    action = data.get('action')  # open/close/stop
    
    # 根据房间ID映射到对应的窗帘设备
    device_key = f"curtain_{room_id}"
    
    result = control_rf_device(device_key, action, extra=f"room_{room_id}")
    return jsonify(result)

@app.route('/api/meeting/projector', methods=['POST'])
def control_projector():
    """控制会议室投影幕（办公场景）"""
    data = request.json
    meeting_room = data.get('meeting_room')
    action = data.get('action')  # up/down/stop
    
    device_key = f"projector_{meeting_room}"
    result = control_rf_device(device_key, action)
    
    # 联动:投影幕下降时自动调暗灯光
    if action == "down" and result["success"]:
        control_rf_device(f"light_{meeting_room}", "dim")
    
    return jsonify(result)

@app.route('/api/service/call', methods=['POST'])
def service_call():
    """服务呼叫（餐饮/酒店场景）"""
    data = request.json
    room_no = data.get('room_no')
    service_type = data.get('service_type')  # water/bill/clean
    
    device_key = f"caller_{room_no}"
    
    # 触发呼叫器蜂鸣/灯光提示
    result = control_rf_device(device_key, "ring", extra=service_type)
    
    # 记录呼叫日志
    log_service_call(room_no, service_type)
    
    return jsonify(result)

def log_service_call(room_no, service_type):
    """记录服务呼叫日志"""
    print(f"[{datetime.now()}] 房间 {room_no} 请求服务: {service_type}")
    # TODO: 写入数据库

# ========== 批量控制 ==========
@app.route('/api/scene/meeting-start', methods=['POST'])
def meeting_start_scene():
    """会议开始场景:投影幕下降 + 灯光调暗 + 窗帘关闭"""
    data = request.json
    meeting_room = data.get('meeting_room')
    
    results = []
    
    # 1. 降下投影幕
    result1 = control_rf_device(f"projector_{meeting_room}", "down")
    results.append(result1)
    
    # 2. 关闭窗帘
    result2 = control_rf_device(f"curtain_{meeting_room}", "close")
    results.append(result2)
    
    # 3. 灯光调暗
    result3 = control_rf_device(f"light_{meeting_room}", "dim")
    results.append(result3)
    
    return jsonify({
        "success": all(r["success"] for r in results),
        "results": results
    })

@app.route('/api/scene/meeting-end', methods=['POST'])
def meeting_end_scene():
    """会议结束场景:投影幕上升 + 灯光全亮 + 窗帘打开"""
    data = request.json
    meeting_room = data.get('meeting_room')
    
    results = []
    
    results.append(control_rf_device(f"projector_{meeting_room}", "up"))
    results.append(control_rf_device(f"curtain_{meeting_room}", "open"))
    results.append(control_rf_device(f"light_{meeting_room}", "on"))
    
    return jsonify({
        "success": all(r["success"] for r in results),
        "results": results
    })

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

3.5 设备管理与配置

开发者还可通过API进行设备管理操作：

查询网关状态

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

获取已配对射频设备列表

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

四、业务联动场景详解

4.1 第一种场景：酒店客房智能控制

业务需求：客人通过APP/小程序控制客房内的窗帘、灯光等设备，酒店服务人员可远程管理。

联动

客人APP操作 → 平台接收请求 → API下发控制指令 → 网关发射433MHz信号 → 设备响应

可实现功能

客人入住时，系统自动开启客房灯光、空调
客人通过语音助手（对接后）控制窗帘开合
退房时，系统自动关闭所有客房设备

4.2 第二种场景：会议室智能联动

业务需求：会议室预订系统与设备控制联动，实现全自动化的会议准备。

联动

会议预订确认（线上系统） → 会议开始前5分钟自动触发场景
                              ↓
                    ┌─────────┴─────────┐
                    ↓                   ↓
              降下投影幕            调暗灯光
                    ↓                   ↓
              关闭窗帘            启动投影仪

关键指标参考

从指令下发到设备响应：< 3秒
多设备联动延迟：毫秒级差异，感受不到卡顿

4.3 第三种场景：餐饮服务呼叫系统

业务需求：顾客按动桌位呼叫器，服务人员手表/手机实时接收通知。

联动

顾客按下呼叫器（315MHz发射） → 智能射频网关接收信号
                              ↓
                   推送至平台解析呼叫源
                              ↓
              ┌───────────────┴───────────────┐
              ↓                               ↓
    服务人员手机接收通知              呼叫桌位信息显示
    （绑定区域服务员）                （大屏/服务台）

这一场景已在多家连锁餐厅验证应用，服务响应时间从平均8分钟缩短至2分钟以内，顾客满意度显著提升。

4.4 场景四：商业展馆智能导览

业务需求：参观者扫码触发展品介绍视频/灯光效果自动播放。

联动

参观者扫码展品二维码 → 小程序识别展品ID
                        ↓
             平台根据展品ID确定关联设备
                        ↓
         ┌──────────────┼──────────────┐
         ↓              ↓              ↓
    启动投影     开启射灯       播放讲解音频
    (播放视频)   (照亮展品)     (导览系统)

五、部署方案和需要注意的点

5.1 设备部署规划

场所规模	网关数量	覆盖策略	部署要点
小型（<500㎡）	1台	中心部署全覆盖	放置于场地中心位置，距地面2-2.5m
中型（500-2000㎡）	2-3台	分区部署	按功能区划分，避免射频信号干扰
大型（>2000㎡）	4-6台	区域网关+骨干网络	优先选用有线以太网版本

5.2 射频信号优化

控制距离：空旷区域可达300m，但墙壁、金属货架等障碍物会衰减信号，需根据实际环境测试
频率选择：433MHz信号穿透性强，适合控制执行类设备；315MHz适合接收传感器信号
多网关协同：多网关部署时需规划射频编码分区，避免同频干扰

5.3 网络与服务器要求

项目	要求
网关联网	每台网关需连接稳定的WiFi 2.4GHz或有线网络
带宽	单网关上行带宽≤50Kbps，100台网关约5Mbps
服务器	公网可访问地址（公有云部署）或局域网服务器（私有化部署）
高可用	部署主备两台服务器，或使用云服务负载均衡

私有化部署特别说明：对于金融、政务等对数据安全要求较高的场景，智能射频网关支持纯局域网运行，所有控制指令不经过外部云端。

六、方案价值总结

基于芯步智能射频网关的线下服务场景射频控制解决方案，具有以下核心价值：

价值维度	实现效果
快速部署	无需更换现有射频设备，即插即用，可利旧改造，业务不中断
开放集成	标准化HTTP API支持任何编程语言，可快速集成至现有业务系统
场景联动	实现线上订单/预订与线下设备的自动化联动，提升服务效率
私有化部署	支持纯局域网运行，满足数据安全合规要求
降本增效	利旧改造可降低改造成本70%以上；自动化操作替代人工，提升效率

该解决方案已在酒店、会议室、餐饮、展馆等线下服务场景中得到应用验证，通过“射频设备联网+云端平台管控+业务系统联动”的技术路径，为线下服务场景构建起智能化、高效率的设备控制体系。

——基于芯步智能射频网关的设备联网与软件对接实践

一、行业背景与需求分析

二、硬件产品介绍：芯步智能射频网关

2.1 产品概述

2.2 技术规格

2.3 核心能力

三、技术对接方案

3.1 对接架构

3.2 核心接口：向设备下发指令

3.3 高级特性：私有化部署与多网络保障

3.4 在项目中集成代码示例

3.5 设备管理与配置

四、业务联动场景详解

4.1 第一种场景：酒店客房智能控制

4.2 第二种场景：会议室智能联动

4.3 第三种场景：餐饮服务呼叫系统

4.4 场景四：商业展馆智能导览

五、部署方案和需要注意的点

5.1 设备部署规划

5.2 射频信号优化

5.3 网络与服务器要求

六、方案价值总结

网关产品方案：

无人值守射频设备管理：怎样将多协议射频网关集成到自己的项目中

怎样对接智能射频控制器来实现射频设备远程控制

怎么接入315射频网关以实现设备状态实时反馈

如何对接智能射频网关来实现射频协议转换

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

服务场景方案：

线下服务语音提醒场景：怎么把20W 云语音播报音柱集成到自己的项目中

线下服务场景门禁照明控制：怎么把1路智能墙壁电源开关接入到自己的项目中

线下服务场景环境管理：怎么将HTTP远程数据上报温湿度传感器对接到软件项目中

线下服务场景语音播报：怎样把20W 远程控制 TTS 语音壁挂音箱接入到项目中

线下服务语音提醒场景：怎么把智能 60W 语音音柱对接到自己的项目中

射频用途方案：

怎样在线下服务场景射频控制中接入智能设备以实现HTTP接口远程控制

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

如何对接智能射频网关来实现射频协议转换

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

舞蹈室射频设备联动：怎么将射频信号中继器对接到软件项目中