如何二次开发24 路远程交直流输出控制器以实现自定义场景联动控制_解决方案

CATALOG

芯步这款24路控制器开放了HTTP接口，支持单路/批量控制和场景联动。下面从接口对接、签名计算到场景脚本实现，给你一份实操导向的解决方案。

解决方案：基于芯步24路控制器实现自定义场景联动

大家好，今天咱们来聊聊怎么“折腾”芯步那款24路的远程控制器。

这个东西其实挺给力的，硬件上有24个口，能控制交直流小负载，接个接触器还能带大功率设备。但真正让它变“聪明”的，是它那个开放的HTTP接口。说白了，就是厂家把“遥控器”的按钮功能通过代码暴露给你了，你想怎么按，完全看你心情。

下面我就以 “搭建一个简易的智能沙盘或展厅联动” 为例，手把手教你怎么做二次开发。

第一步：先让“电脑”和“盒子”能说上话

要控制它，得先拿到它的门牌号和暗号。

准备工具
- 你得先把这24路控制器通电、连上网（它只支持2.4G WiFi）。
- 登录芯步的后台，找到你这个设备的 设备ID 和 AppSecret（这相当于你家大门的钥匙）。
搞懂签名机制这个接口为了安全，每次发指令都得带上一个动态的签名。公式看着唬人，其实逻辑很简单：md5( md5(你的密钥) + 当前时间戳 )。
- 不用怕：大部分代码都有现成的库。你在后台复制一下代码示例，把AppSecret和设备ID填进去就行。
测试一把先用 Postman 或者 Curl 发个指令试试手。
- 地址https://api.thingboot.com/{你的AppID}/device/control/
- 参数device=你的设备ID
- Body{"order": {"power1": 1}}如果第1路继电器“咔哒”一声响了，恭喜你，路铺好了。

第二步：理解怎么“玩”这24个口

打通了网络通道，剩下的就是发命令的事了。这个控制器的逻辑非常直接

单路控制：想开第3路，就发 {"power3": 1}；想关第5路，发 {"power5": 0}。
批量控制：想同时把所有灯关了，不用写24行代码，直接发 {"batch": 0}。
互锁模式：如果你控制的是电机正反转（比如卷帘门），需要先断开一路再接通另一路，可以用 point 命令，防止短路。
定时与场景：在后台的“物联网控制台”里，你可以直接设置定时任务，比如让第1路每天早上6点自动开灯。

第三步：核心干货 —— 如何实现自定义场景联动

这才是重头戏。所谓的“自定义场景”，就是用代码逻辑替代人工按键。

场景设定假设你有一个科技展厅，有一个“一键讲解”模式。

动作1：关闭所有灯光（除了演讲台那一路）。
动作2：打开投影幕布（接在第10路）。
动作3：音响系统通电（接在第12路）。
动作4：沙盘灯光按顺序流水灯闪一圈（第15-24路）然后常亮。

如果不做二次开发：你得在平板上点5次，或者让后台执行一个死的定时任务。做了二次开发：写个脚本，一键搞定。

代码逻辑实现（Python伪代码示例）

你可以用任何语言（Python, Node.js, Go）来写这个逻辑。这里用 Python 举个栗子，很直白：

import requests
import time
import hashlib

# 配置你的信息 (从后台抄过来)
APP_ID = "你的AppID"
SECRET = "你的AppSecret" 
DEVICE_ID = "你的设备ID"
API_URL = f"https://api.thingboot.com/{APP_ID}/device/control/"

# 这是一开始那个签名算法，封装成一个函数
def get_sign(ts):
    md5_secret = hashlib.md5(SECRET.encode()).hexdigest()
    return hashlib.md5((md5_secret + str(ts)).encode()).hexdigest()

# 核心:发命令的函数
def send_command(order_dict):
    ts = int(time.time())
    sign = get_sign(ts)
    # 组装参数，注意order这里要转成json字符串
    payload = {
        "device": DEVICE_ID,
        "order": order_dict
    }
    # 发送POST请求
    res = requests.post(API_URL, params={"sign": sign, "ts": ts}, json=payload)
    print(f"发送指令 {order_dict} ，服务器说: {res.text}")

# ----------------- 开始编排你的"联动场景" -----------------

def scene_presentation_mode():
    print(">>> 开启演讲模式，正在自动布场...")
    
    # 1. 场景复位:先把所有路都关了 (0是关，1是开)
    send_command({"batch": 0})
    time.sleep(0.5) # 稍微停顿一下，给继电器反应时间
    
    # 2. 执行关键动作
    # 打开演讲台射灯(第1路)
    send_command({"power1": 1})
    # 打开投影幕布(第10路)
    send_command({"power10": 1})
    # 功放通电(第12路)
    send_command({"power12": 1})
    
    # 3. 炫技环节:沙盘流水灯闪一圈 (第15路到第24路)
    print(">>> 沙盘灯光自检中...")
    for i in range(15, 25):
        # 逐个点亮
        send_command({f"power{i}": 1})
        time.sleep(0.2)
        # 如果是流水效果，可以紧接着关掉上一个，这里为了演示就全开了
    print(">>> 布场完毕，请开始你的演讲！")

# 运行一下就完事了
# scene_presentation_mode()

这段代码跑起来，你只需要按一次按钮（或者甚至用语音、传感器触发这个函数），整个展厅的设备就会按照你设定的顺序和逻辑自动运行。

第四步：进阶玩法（局域网与私有化）

如果你的项目要求断外网也能用（比如在保密单位或者信号差的地下室），这盒子也支持本地化控制。你只需要在代码里把请求地址从 api.thingboot.com 换成设备本地的IP地址，比如 http://192.168.1.100/control，其他命令逻辑完全一样。甚至不需要过云端服务器，速度和稳定性会更高。

总结一下思路

搞定网络：连上网，拿到后台的密钥和ID。
熟悉接口：会用 power1 控制第1路，会发POST请求。
写脚本：把一系列 power1、power2 按你的时间逻辑组合起来。

当你把这24路继电器和你的业务代码结合起来时，这个盒子就不再是一个简单的“遥控开关”了，而是你软件系统的一部分，指哪打哪。