怎样二次开发智能分体控制箱|16路来实现多回路电源集中管理_解决方案

CATALOG

一、概述

在共享自习室、棋牌室、茶室、创客工坊以及售货柜、沙盘模型等场景中，多回路电源的集中管理是实现自动化运营的基础。传统方案依赖多个独立定时器或人工操作，不仅部署复杂，还无法与订单系统、门禁系统形成联动。芯步智能通用控制器16路（型号：UNI-KZQ-TY-16）通过开放HTTP接口，可无缝接入您的管理平台，实现16路独立回路的远程通断控制、场景批量管理、订单联动启停等自动化功能。

核心能力

16路独立分控：单设备可管理16条独立线路，满足中型项目需求
开放HTTP API：适用于任何支持HTTP请求的编程语言，10分钟完成对接
多种控制模式：支持单路控制、批量控制、先通后断（脉冲）、先断后通（重启）
平台定时任务：控制台内置定时任务，无需开发即可实现自动启停
私有化部署：支持局域网运行，数据安全可控
即装即用：WiFi直连无需网关，可设定5组WiFi自动切换

典型16路电源分配方案

回路	控制对象	负载类型	管理策略
回路1-4	区域照明	阻性/感性	定时开关
回路5-8	工位设备电源	阻性	订单联动
回路9-12	空调/新风	感性	定时+联动
回路13-14	广告屏/宣传设备	阻性	营业时段自动
回路15-16	备用/扩展	-	预留

二、产品核心特性

2.1 智能通用控制器16路规格

芯步智能通用控制器16路（UNI-KZQ-TY-16）专为多回路集中控制场景设计

特性	参数
产品型号	UNI-KZQ-TY-16
控制路数	16路独立分控
工作电压	DC 12V 2A（直流）
额定电流	MAX 20A（总）
单路最大负载	2200W（阻性）/ 350W（感性）
总额定功率	4400W（阻性）/ 700W（感性）
待机功耗	1.1（全断）- 5.2（全通）W
产品尺寸	宽119.4mm × 长95.0mm × 厚65.2mm
产品净重	360g
无线连接	WiFi 2.4GHz
外壳材质	防火V0级PC，耐高温，符合安规标准

2.2 负载类型与功率限制

负载类型	每路最大功率	总额定功率	常见设备	注意事项
阻性负载	2200W	4400W	白炽灯、电热器、普通电器	直接控制
感性负载	350W	700W	LED灯、节能灯、电机、风扇	需降额使用

⚠️ 重要提示：LED灯、节能灯、电机属于感性负载，每路不得超过350W；全接通时总负载不得超过4400W（阻性）/700W（感性）.

2.3 产品核心优势

设备开放HTTP接口，适用于任何支持HTTP请求的编程语言。接口简单、清晰、友好，仅需在接口携带签名以及设备ID，即可向设备下发命令。支持接入任何形式的软件项目：Web、APP/小程序、窗体软件以及SaaS/低代码等平台.

其他特性

私有化部署：支持自建消息服务器，可运行在纯局域网环境
无需网关：设备使用WiFi 2.4G无线网络，采用WiFi直接方式
多网络备份：可设定5组WiFi网络，优先连接信号最强的进行连接
支持远程定时任务：可在平台设置定时任务，实现自动化管理
支持自定义联动操作：可根据业务需求编排联动逻辑

三、16路集中管理架构

3.1 系统架构图

┌─────────────────────────────────────────────────────────────────┐
│                    管理系统 / 运维平台                          │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐               │
│  │  集中控制台  │  │  场景管理   │  │  状态看板   │               │
│  └─────────────┘  └─────────────┘  └─────────────┘               │
└─────────────────────────────────────────────────────────────────┘
                              │
                              │ HTTP API调用（携带MD5签名）
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│                     芯步云平台 / 私有化服务器                  │
└─────────────────────────────────────────────────────────────────┘
                              │
                              │ WiFi 2.4GHz
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│                智能通用控制器16路（配电箱安装）                    │
│  ┌────┬────┬────┬────┬────┬────┬────┬────┬────┬────┬────┬────┐   │
│  │ 1  │ 2  │ 3  │ 4  │ 5  │ 6  │ 7  │ 8  │ 9  │10  │11  │12  │   │
│  └────┴────┴────┴────┴────┴────┴────┴────┴────┴────┴────┴────┘   │
│  ┌────┬────┬────┬────┐                                         │
│  │13  │14  │15  │16  │                                         │
│  └────┴────┴────┴────┘                                         │
│   照明组   工位组   空调组   广告组   备用                        │
└─────────────────────────────────────────────────────────────────┘

3.2 16路电源分配方案

回路组	回路范围	控制对象	管理策略	典型场景
照明组	1-4	区域照明	定时自动开关	工坊/自习室照明
工位组	5-8	工位设备电源	订单联动	共享工位电源管理
空调组	9-12	空调/新风系统	定时+温度联动	中央空调分区控制
广告组	13-14	广告屏/宣传设备	营业时段自动	广告投放管理
备用	15-16	扩展预留	按需配置	灵活扩展

3.3 大负载扩展方案

对于功率超过控制器直接承载能力的设备（如3匹以上空调、大功率电机），可通过外接交流接触器的方式进行控制：

控制器输出（12V/24V小电流）→ 交流接触器线圈 → 接触器主触点 → 大功率设备

示例:
回路1输出（12V）→ 接触器KM1线圈 → KM1主触点 → 3匹空调

扩展优势：控制器控制小电流信号，接触器控制大电流负载，实现以小控大
适用场景：大功率空调、工业设备、大型电机等超过2200W的负载

四、API接口接入详解

4.1 接口地址与签名计算

请求地址

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

参数说明

参数	说明	示例
{AppId}	应用ID（控制台获取）	`qtyVWcgeMq`
{ts}	当前Unix时间戳（秒）	`1747212640`
{sign}	签名	`c484eb97...`

签名计算公式

sign = md5( md5(AppSecret) + ts )

将开发者密码（AppSecret）进行一次MD5
将这个结果拼接上时间戳ts
对整个拼接后的字符串再做一次MD5

开发提示：如果仅为测试对接，可以在控制台「开发设置」中打开“调试模式”，此时不检查sign和ts的值，方便快速测试.

4.2 核心命令详解

4.2.1 单路独立控制

控制某一回路单独设备：

命名字段说明power1~power16分别对应16路输出控制

4.2.2 批量控制——核心功能

批量控制可同时控制任意组合的回路，适用于场景模式切换（如一键开馆/闭馆）：

4.2.3 先通后断（脉冲控制）

适用于临时通电测试、门禁开门等需要短暂通电的场景：

4.2.4 先断后通（远程重启）

适用于设备死机时的远程复位：

4.2.5 分组控制（多设备管理）

通过分组ID控制多个设备，无需维护设备ID列表

请求地址

https://api.thingboot.com/{AppID}/group/control/?sign={sign}&ts={ts}

请求示例

4.2.6 携带业务标识

在命令中携带订单号等业务信息，便于追踪：

extra只支持32位以内的大小写英文字母和数字（a-zA-Z0-9），会在消息推送中原样返回

4.3 多语言代码示例

Python

import requests
import time
import hashlib
from typing import List

class MultiChannelController:
    """16路智能控制器（多回路集中管理）"""
    
    def __init__(self, app_id: str, app_secret: str, device_id: str):
        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: int) -> str:
        md5_secret = hashlib.md5(self.app_secret.encode()).hexdigest()
        sign_str = md5_secret + str(ts)
        return hashlib.md5(sign_str.encode()).hexdigest()
    
    def _send_command(self, order: dict) -> dict:
        ts = int(time.time())
        sign = self._generate_sign(ts)
        url = f"{self.base_url}?sign={sign}&ts={ts}"
        payload = {"device": self.device_id, "order": order}
        
        response = requests.post(url, json=payload, timeout=5)
        return response.json()
    
    # ========== 单路控制 ==========
    def control_channel(self, channel: int, on: bool) -> dict:
        """控制单个回路（1-16）"""
        return self._send_command({f"power{channel}": "1" if on else "0"})
    
    # ========== 批量控制 ==========
    def batch_control(self, channels: List[int], on: bool) -> dict:
        """批量控制多个回路"""
        order = {
            "batch": {
                "relay": channels,
                "power": "1" if on else "0"
            }
        }
        return self._send_command(order)
    
    # ========== 场景管理 ==========
    def scene_open(self) -> dict:
        """开馆/营业场景:开启照明和基础设备"""
        return self.batch_control([1, 2, 3, 4, 13, 14], True)
    
    def scene_close(self) -> dict:
        """闭馆/闭店场景:关闭所有设备"""
        return self.batch_control(list(range(1, 17)), False)
    
    def scene_energy_save(self) -> dict:
        """节能模式:关闭非必要设备，保留基础照明"""
        self.batch_control([5, 6, 7, 8, 9, 10, 11, 12, 15, 16], False)
        return self.batch_control([1, 2], True)  # 保留两路基础照明
    
    # ========== 脉冲/重启 ==========
    def pulse_channel(self, channel: int, duration_ms: int = 3000) -> dict:
        """临时通电（先通后断）"""
        return self._send_command({
            "point": {"relay": [channel], "interval": duration_ms}
        })
    
    def reboot_channel(self, channel: int, delay_ms: int = 10000) -> dict:
        """远程重启（先断后通）"""
        return self._send_command({
            "reset": {"relay": [channel], "interval": delay_ms}
        })

# 使用示例
controller = MultiChannelController("your_app_id", "your_app_secret", "controller_16_01")

# 开馆:开启照明和广告设备
controller.scene_open()

# 闭馆:关闭所有设备
controller.scene_close()

# 工位5设备死机，远程重启
controller.reboot_channel(5, 10000)

# 临时通电测试回路7
controller.pulse_channel(7, 5000)

JavaScript/Node.js

const crypto = require('crypto');
const axios = require('axios');

class MultiChannelController {
    constructor(appId, appSecret, deviceId) {
        this.appId = appId;
        this.appSecret = appSecret;
        this.deviceId = deviceId;
        this.baseUrl = `https://api.thingboot.com/${appId}/device/control/`;
    }
    
    _generateSign(ts) {
        const md5Secret = crypto.createHash('md5').update(this.appSecret).digest('hex');
        const signStr = md5Secret + ts;
        return crypto.createHash('md5').update(signStr).digest('hex');
    }
    
    async sendCommand(order) {
        const ts = Math.floor(Date.now() / 1000);
        const sign = this._generateSign(ts);
        const url = `${this.baseUrl}?sign=${sign}&ts=${ts}`;
        
        const payload = { device: this.deviceId, order };
        const response = await axios.post(url, payload);
        return response.data;
    }
    
    async batchControl(channels, powerOn) {
        return this.sendCommand({
            batch: { relay: channels, power: powerOn ? "1" : "0" }
        });
    }
    
    async sceneOpen() {
        return this.batchControl([1,2,3,4,13,14], true);
    }
    
    async sceneClose() {
        const allChannels = Array.from({length: 16}, (_, i) => i + 1);
        return this.batchControl(allChannels, false);
    }
}

Shell（curl）- 快速测试

五、二次开发场景实战

5.1 第一种场景：营业时间自动启停

需求：根据工坊/自习室营业时间自动开关多路照明和设备电源。

实现的方式是：平台内置定时任务，无需代码

任务名称	执行时间	命令	说明
开馆准备	08:30	`{"batch":{"relay":[1,2,3,4,13,14],"power":"1"}}`	开启照明+广告
设备供电	09:00	`{"batch":{"relay":[5,6,7,8,9,10],"power":"1"}}`	开启工位设备
午休节能	12:00-13:00	`{"power5":"0","power6":"0"}`	关闭部分设备
闭馆关电	22:00	`{"batch":{"relay":[1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16],"power":"0"}}`	全关

5.2 第二种场景：共享工位预约联动

需求：用户通过小程序预约某个工位，预约时段内该工位自动通电，结束后自动断电。

5.3 第三种场景：多区域第一种场景键切换

需求：工坊管理员在后台一键切换全馆、半馆、节能等场景模式。

5.4 场景四：设备运行状态监控

需求：监控各回路设备运行状态，异常时自动告警。

实现的方式是：配置消息推送，接收设备状态变化

5.5 场景五：连锁场所集中管理

需求：连锁品牌总部远程管理所有门店的16路控制器。

六、私有化部署方案

对于数据安全要求较高的场景，16路控制器支持纯局域网运行。

部署模式对比

特性	公有云模式	私有化模式
设备联网	WiFi连接互联网	连接内网WiFi
API地址	`api.thingboot.com`	自建服务器IP
数据流向	经过芯步云端	内网直连，数据不出场地
网络依赖	需要互联网	仅需局域网

私有化配置要点

设备支持配置5组WiFi网络，自动连接信号最强的网络
需自建HTTP服务，所有API调用在内网完成
支持自建消息服务器，接收设备状态回调

七、设备安装部署指南

7.1 安装要求

项目	要求
安装方式	标准配电箱/DIN导轨安装
工作电压	DC 12V 2A（产品附带电源）
单路负载	阻性≤2200W，感性≤350W
总额定功率	4400W（阻性）/ 700W（感性）
网络要求	WiFi 2.4GHz信号覆盖良好
外壳材质	防火V0级PC，耐高温

7.2 16路回路分配

回路范围	推荐用途	注意事项
1-4	区域照明	LED灯负载<300W/路
5-8	工位/设备电源	感性负载<350W/路
9-12	空调/新风	感性负载<350W或外接触控器
13-14	广告屏/宣传设备	阻性负载<2200W
15-16	备用/扩展	预留，按需配置

7.3 大负载扩展方案

场景	推荐方案	说明
单路大功率设备（>2200W）	加交流接触器	控制器驱动接触器线圈
多设备集中控制	分组管理	按区域或功能分组
三相设备控制	加三相接触器	控制器控制接触器，接触器控制三相电

7.4 安装注意事项

LED灯特殊要求：用于LED或节能灯泡时，单路负载应小于300W
总额定功率限制：全接通时总负载不得超过4400W（阻性）
WiFi信号：金属配电箱可能屏蔽信号，可选择外置天线版本
配网指示：绿灯常亮表示设备工作，蓝灯闪烁表示未连接网络，蓝灯熄灭表示已连接网络
电源要求：使用产品附带的DC 12V 2A电源适配器

八、常见问题与排障

问题	可能原因	解决方案
设备不在线	WiFi信号弱	检查2.4GHz WiFi覆盖，设备支持5组WiFi自动切换
单路无输出	负载超限	检查该路负载是否超过2200W
总额定功率超限	多路同时高负载	分时启动大功率设备
LED灯闪烁	感性负载超限	LED灯每路不超过300W，或并联补偿电容
命令下发成功但无动作	设备离线	200仅表示平台接收，需确认设备在线状态
签名验证失败	参数错误	确认ts为秒级时间戳，公式为`md5(md5(AppSecret)+ts)`

九、总结

本方案基于芯步16路智能通用控制器，实现了多回路电源的集中管理与自动化控制

能力	实现的方式是
16路独立分控	每路独立API控制通断
场景批量管理	`batch`命令一键切换场景
定时自动启停	平台内置定时任务
设备远程重启	`reset`先断后通命令
脉冲控制	`point`先通后断命令
连锁集中管理	分组控制或设备列表批量操作
大负载扩展	外接交流接触器

核心应用场景

共享自习室：工位电源预约联动、照明定时控制
共享棋牌室：包间设备集中管理、订单联动启停
创客工坊：设备分区控制、节能场景切换
售货柜/沙盘模型：多回路独立控制

集成核心步骤

获取AppID/AppSecret，实现MD5签名算法
规划16路回路分配（照明/设备/空调/广告）
开发HTTP调用模块，封装批量控制和场景切换函数
配置定时任务或对接预约系统
物理安装控制器，按回路接线

方案优势

✅ 16路大容量：单设备管理16条独立线路
✅ 接口统一：标准HTTP API，10分钟完成对接
✅ 超低延迟：80-120ms响应
✅ 多种控制模式：单路/批量/脉冲/重启，适配全场景
✅ 即装即用：DC 12V供电，DIN导轨安装
✅ 大负载扩展：外接触器可控制大功率设备
✅ 私有化支持：数据安全可控，适合内网部署

如需详细的产品手册和API文档，请访问查阅或联系技术支持团队获取。

一、概述

二、产品核心特性

2.1 智能通用控制器16路规格

2.2 负载类型与功率限制

2.3 产品核心优势

三、16路集中管理架构

3.1 系统架构图

3.2 16路电源分配方案

3.3 大负载扩展方案

四、API接口接入详解

4.1 接口地址与签名计算

4.2 核心命令详解

4.2.1 单路独立控制

4.2.2 批量控制——核心功能

4.2.3 先通后断（脉冲控制）

4.2.4 先断后通（远程重启）

4.2.5 分组控制（多设备管理）

4.2.6 携带业务标识

4.3 多语言代码示例

Python

JavaScript/Node.js

Shell（curl）- 快速测试

五、二次开发场景实战

5.1 第一种场景：营业时间自动启停

5.2 第二种场景：共享工位预约联动

5.3 第三种场景：多区域第一种场景键切换

5.4 场景四：设备运行状态监控

5.5 场景五：连锁场所集中管理

六、私有化部署方案

七、设备安装部署指南

7.1 安装要求

7.2 16路回路分配

7.3 大负载扩展方案

7.4 安装注意事项

八、常见问题与排障

九、总结

断路器产品方案：

如何在园区路灯电路管理中接入智能硬件以实现过压欠压保护控制

怎么在办公设备电源管理中对接智能硬件以实现HTTP接口远程通断控制

实验室电源管理：怎么将智能断路器35A接入到自己的项目中

写字楼办公区电路管理：怎样将40A 智能断路器接入到软件项目中

如何接入智能断路器20A来实现远程通断控制

回路场景方案：

物联网设备回路集中监控中：如何将12路分体远程控制开关箱接入到项目中

办公室插座回路保护：怎么将35A远程开关控制器集成到软件项目中

实验室多回路设备集中控制：如何把16路分体智能配电控制箱对接到软件项目中

咖啡厅咖啡机回路保护：怎么把40A大功率智能断路器对接到软件项目中

怎样在共享自习室门禁联动中对接智能设备以实现多回路照明集中管理

集中用途方案：

怎样在创客工坊设备照明管理中接入智能硬件以实现线路状态集中反馈控制

怎样在共享自习室门禁联动中对接智能设备以实现多回路照明集中管理

怎样在运动场馆多路设备控制中接入智能硬件来实现多线路集中通断控制

怎样对接12路分体智能电源管理箱以实现线路状态集中反馈

怎么在仓储设备机柜电源管理中接入智能设备以实现集中一键控制5路设备电源