车间设备远程管理：如何将智能 24 路分体远程开关控制模块接入到自己的项目中_解决方案

CATALOG

芯步的智能24路控制器采用HTTP接口开放策略，单个API调用即可完成对多达24路继电器的独立控制。以下方案从设计、接口调用、签名鉴权到代码实现，详细说明如何将设备快速集成到自有系统中。

一、背景与选型分析

在智能制造转型过程中，许多工厂面临老旧设备联网难、控制分散的问题。芯步的 智能通用控制器24路 (UNI-KZQ-TY-24) 是基于WiFi 2.4G通信的远程控制模块。

选型优势：

多通道独立控制：支持24路继电器输出，可分别控制24个不同的设备启停。
无网关依赖：设备直连WiFi路由器，减少了购买和配置工业网关的步骤，降低项目初期成本。
接口开放性：提供标准的HTTP API接口，无论您的现有系统是基于Java、Python、C#还是PHP，只需支持HTTP协议即可完成对接。
部署灵活性：支持私有化部署和纯局域网运行，满足工厂对数据安全及网络隔离的严格要求。

二、整体设计

本项目采用“设备直连+云端/本地中转”的架构模式，示意图逻辑如下：

设备层：24路控制器通过WiFi连接至工厂车间交换机/路由器。其下方的继电器触点接入各种电机、阀门、照明或报警器等负载。
传输层
- 控制链路：采用 HTTP 请求（Request/Response）模式。
- 状态链路：采用 MQTT 消息推送模式，设备状态变化实时上报。
应用层：您的 MES（制造执行系统）、WMS（仓储管理系统）或自研的组态软件。

三、接入准备（Preparations）

在编写代码前，需要在芯步平台完成以下配置：

设备配网：给控制器通电。通过手机App或Web端控制台，将设备连接到车间指定的WiFi网络。
获取凭证
- AppID / AppSecret：登录芯步控制台，在“开发设置”中获取。这是调用API的身份凭证。
- Device ID：在设备列表中找到刚才添加的24路控制器，记录其唯一的Device ID。
网络策略：如果您的项目在纯局域网内运行，需确保服务器与设备在同一网段或可达；若通过互联网控制，需确保服务器能访问 api.thingboot.com。

四、核心接口对接详解

1. 接口鉴权机制

芯步的接口采用 sign 签名机制保证安全。每次HTTP请求除了业务参数，还需带上 sign 和 ts（时间戳）。

签名算法：通常为将参数排序后拼接AppSecret进行MD5加密。注意：在开发测试阶段，可以在后台开启“调试模式”暂时绕过签名校验以加快开发进度，上线前请一定要关闭。

2. 下发控制指令

这是集成中最核心的部分。针对24路控制器，我们需要通过HTTP POST请求向设备发送JSON格式的命令。

请求地址http(s)://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}
请求方法：POST
Content-Type：application/json

第一种场景：控制单一路假设你需要关闭第2路（通道2）的电源，开启第5路。

这种模式适合参数明确的场景。

第二种场景：批量控制如果你需要同时重启一组设备（例如通道3、7、12），使用循环发送单条指令效率较低且容易阻塞。可以使用 batch 命令：

这种模式能有效减少HTTP请求次数，提升系统响应速度。

第三种场景：脉冲触发常用于控制电机点动或气缸电磁阀。例如让第1路“通电1秒后自动断开”。

或者使用 reset 实现“断开1秒后自动吸合”，常用于复位逻辑。

3. 同步获取反馈（状态查询）

下发指令后，接口返回 200 仅代表指令被平台接收，不代表设备已执行。如果需要确认设备是否真的“吸合”了，可以采用以下两种方案：

方案A：异步消息推送（推荐）需要有公网地址或可访问的服务器（Endpoint）。在芯步后台配置您的MQTT回调地址或HTTP推送地址。当设备状态变化时（如物理按键被按下，或继电器动作完成），平台会主动推送状态数据到您的服务器。

方案B：主动查询状态如果无法部署公网接收服务，可以在代码中主动查询设备详情。请求参数device=设备ID返回内容：包含设备在线的 status 以及各通道当前的 power 开关状态。

五、代码实现示例（Python + Flask）

以下是一个简单的后端服务集成示例，展示如何在您的项目中封装控制逻辑。

import requests
import hashlib
import time

class YoYoDeviceController:
    def __init__(self, app_id, app_secret, device_id):
        self.app_id = app_id
        self.app_secret = app_secret
        self.device_id = device_id
        self.base_url = f"https://api.thingboot.com/{app_id}/device/control/"

def _generate_sign(self, ts):
        # 这里简化了签名逻辑，实际需按官方文档排序拼接
        raw_str = f"{self.app_id}{self.device_id}{ts}{self.app_secret}"
        return hashlib.md5(raw_str.encode()).hexdigest()

def control_channel(self, channel, action):
        """
        控制单个通道
        :param channel: 1-24
        :param action: "1" 开启, "0" 关闭
        """
        ts = int(time.time())
        sign = self._generate_sign(ts)
        
        # 动态构造参数名 power1, power2...
        payload = {
            "device": self.device_id,
            "order": {f"power{channel}": action}
        }
        
        response = requests.post(self.base_url, params={'sign': sign, 'ts': ts}, json=payload)
        return response.json()

def batch_control(self, channels, action):
        """批量控制"""
        ts = int(time.time())
        sign = self._generate_sign(ts)
        
        payload = {
            "device": self.device_id,
            "order": {
                "batch": {
                    "relay": channels,  # 例如 [2,4,6]
                    "power": action
                }
            }
        }
        # 发送请求...
        pass

# 在您的MES系统业务流程中调用
if __name__ == "__main__":
    # 初始化控制器 (AppID, AppSecret, DeviceID)
    apollo_24 = YoYoDeviceController("YOUR_APP_ID", "YOUR_SECRET", "1234567890")
    
    # 执行远程操作:开启第8路冷却风扇
    result = apollo_24.control_channel(8, "1")
    print(result)

六、项目落地的关键点

网络信号强度：该设备仅支持2.4G WiFi。在工厂复杂电磁环境下，如果车间有金属屏蔽柜或密集设备，需确保信号强度。如果信号弱，需增加AP中继。设备本身支持设定5组WiFi，会优先连接信号最强的，可以利用此特性实现AP冗余。
私有化部署：如果工厂对数据极其敏感（例如军工或核心研发车间），可以要求芯步提供私有化部署包。将服务器软件部署在车间本地的工控机上，甚至无需连接互联网，实现纯内网闭环控制，彻底杜绝外网延迟和风险。
联动逻辑：不要只把控制器当成一个“遥控开关”。结合芯步生态中的温湿度传感器或烟感传感器，可以设置自动化规则：例如检测到车间温度过高，自动通过该控制器闭合第12路风扇继电器；检测到烟雾报警，自动断开第1路总闸。
异常处理：在编写代码时，针对 http error（网络不通）和 code 非200（业务逻辑错误，如设备离线）做区分处理。设备离线通常是因为断电或WiFi断开，程序中应记录日志并触发告警，而不是盲目重试。

通过以上步骤，您可以将芯步的24路远程开关模块无缝集成到现有的车间管理体系中，实现从“人工巡检操作”到“系统一键调度”的智能化升级。