如何二次开发2路智能直流控制模块来实现2路独立直流线路控制_解决方案

CATALOG

2路智能直流控制模块的二次开发，核心在于理解芯步开放的HTTP接口协议——通过构造携带签名鉴权的POST请求，即可实现对两路直流线路的独立通断控制。以下是具体的技术实现方案。

解决方案：基于芯步开放接口的2路直流控制模块二次开发

1. 背景与概述

芯步的智能直流控制模块（2路）支持通过标准的HTTP协议进行远程控制。在物流分拣线、智能灯光系统或双电机设备等场景中，开发者往往需要将该模块集成到现有的上位机软件、调度系统或手机APP中。

本方案的目标是指导开发者如何利用模块开放的API接口，实现对两路直流输出的独立控制、独立状态查询以及批量操作，无需关心底层无线通信协议。

2. 核心对接准备（准备工作）

在开始编码之前，需要完成以下三项准备：

获取凭证：登录芯步工作台，进入“物联网控制台” -> “开发设置”。记录下 AppID (开发者ID) 和 AppSecret (开发者密码)。
获取设备ID：在控制台的设备列表中，找到已配网的“2路智能直流控制器”，复制其Device ID（如 12345678）。
接口协议
- 请求方式： POST
- Content-Type： application/json
- 地址： https://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}

3. 签名机制详解（安全层）

为了避免接口被恶意调用，芯步采用了动态签名验证。构造 sign 参数的公式如下

$Sign = MD5( MD5(AppSecret) + ts )$

具体步骤：

将 AppSecret 进行第一次MD5加密，得到字符串 S1。
将 S1 与当前的Unix时间戳 ts （秒级）进行拼接，得到字符串 S2。
将 S2 进行第二次MD5加密，得到最终的 sign。

注：开发调试阶段，可以在控制台打开“调试模式”暂时忽略签名校验。

4. 实现2路独立控制（业务逻辑层）

该模块的核心优势在于 “2路独立” 。通过修改 order 参数中的 power1 和 power2 字段，可以精准地控制继电器通断，互不干扰。

4.1 核心代码示例（Python）

以下代码演示如何封装一个函数，实现对任意一路的开关控制。

import requests
import hashlib
import time
import json

class YoYoDualRelay:
    def __init__(self, app_id, app_secret):
        self.app_id = app_id
        self.app_secret = app_secret

def _generate_sign(self, ts):
        # 1. 对AppSecret进行MD5
        md5_once = hashlib.md5(self.app_secret.encode()).hexdigest()
        # 2. 拼接时间戳并再次MD5
        sign_str = md5_once + str(ts)
        final_sign = hashlib.md5(sign_str.encode()).hexdigest()
        return final_sign

def control(self, device_id, power1_state, power2_state):
        """
        二次开发核心函数:控制2路独立状态
        :param device_id: 设备ID
        :param power1_state: 线路1状态 (1=接通/开, 0=断开/关)
        :param power2_state: 线路2状态 (1=接通/开, 0=断开/关)
        """
        ts = int(time.time())
        sign = self._generate_sign(ts)
        
        url = f"https://api.thingboot.com/{self.app_id}/device/control/"
        params = {
            "sign": sign,
            "ts": ts
        }
        
        # 核心订单数据:同时构建两个线路的命令
        order_payload = {
            "power1": power1_state,  # 控制第一路
            "power2": power2_state   # 控制第二路
        }
        
        body = {
            "device": device_id,
            "order": json.dumps(order_payload)  # 注意需要转为JSON字符串
        }
        
        response = requests.post(url, params=params, json=body)
        print(f"控制结果: {response.text}")

# 二次开发调用示例
if __name__ == "__main__":
    # 初始化
    relay = YoYoDualRelay("YOUR_AppID", "YOUR_AppSecret")
    
    # 场景1: 只打开第一路，关闭第二路（独立控制）
    relay.control("1878", 1, 0)
    
    # 场景2: 两路全开（独立、并发）
    relay.control("1878", 1, 1)
    
    # 场景3: 第一路开，第二路保持原状（需结合状态查询或上次状态）
    # relay.control("1878", 1, None) # 代码中可根据需要调整逻辑

4.2 关键命令字段说明

在二次开发构建JSON订单时，你可以使用以下三类命令模式

命令字段 (Key)	功能描述	二次开发应用场景
`power1` / `power2`	独立控制`1`为吸合/开启，`0`为释放/关闭。	标准控制，如打开电机A、关闭电机B。
`batch`	批量控制：一次性发送多个指令参数。	用于紧急停止场景，同时关闭所有输出。
`point1` / `point2`	先通后断：参数为毫秒数，如 `{"point1": 2000}`。	控制闸机或门禁，触发后2秒自动复位。
`reset1` / `reset2`	先断后通：参数为毫秒数，如 `{"reset2": 5000}`。	设备重启或系统复位逻辑。

5. 异常处理与最佳实践

在实际工程应用中，为了提高鲁棒性，在二次开发时增加以下处理逻辑：

状态同步：HTTP请求是无状态的。在你的业务数据库中维护当前两路开关的状态，或者每次操作前先调用状态查询接口（如 /device/status/）获取最新设备影子，防止状态漂移。
设备ID数组支持：芯步的接口支持一次请求控制多个设备。如果你的系统需要控制多个控制器，可以在 device 参数中传值 "123,456"，这样可以并发控制多条流水线。
响应码校验
- 检查HTTP Status Code是否为200。
- 检查返回的JSON中 code 字段。若非0（成功），需根据 msg 进行重试或告警。
网络超时设置：鉴于工业现场网络环境的复杂性，设置HTTP请求超时时间为5-10秒，并配置重试机制（通常重试3次，每次间隔2秒）。

6. 总结

通过芯步提供的开放接口，开发者只需掌握简单的 HTTP POST 请求和 MD5签名计算，即可在30分钟内完成对2路直流控制模块的二次开发。上述方案通过参数化 power1 和 power2，完美实现了对两路直流输出的解耦与独立控制，适用于智能家居、工业自动化及远程设备运维等多种场景。

注：以上代码中的AppID、AppSecret及Device ID需替换为你控制台中的真实数据。