一、概述
在园区照明、楼宇灯光、生产线设备、售货柜等需要多回路集中控制的场景中，定时自动启停是提升管理效率、降低能耗的核心需求。传统方案依赖人工操作或独立时控开关，不仅配置繁琐，还无法与上位系统联动。芯步智能通用控制器24路（型号：UNI-KZQ-TY-24）通过开放HTTP接口，可无缝接入您的管理平台，实现24路独立回路的定时自动启停、远程集中控制、第一种场景键切换等自动化管理功能。
核心能力
24路独立分控：单台设备可管理24条独立线路，满足大中型项目需求
开放HTTP API：适用于任何支持HTTP请求的编程语言，10分钟完成对接
平台定时任务：控制台内置定时任务功能，无需额外开发即可实现定时启停
多种控制模式：支持单路控制、批量控制、先通后断（脉冲）、先断后通（重启）
私有化部署：支持局域网运行，数据安全可控
即装即用：体积小巧，DC 12V供电，可接入交流/直流小负载，外接接触器可控制大负载
二、产品核心特性
2.1 智能通用控制器24路规格
芯步智能通用控制器24路（UNI-KZQ-TY-24）专为多线路集中控制场景设计。
| 特性 | 参数 |
|---|---|
| 产品型号 | UNI-KZQ-TY-24 |
| 控制路数 | 24路独立分控 |
| 工作电压 | DC 12V 2A（直流） |
| 额定电流 | MAX 20A（总） |
| 单路最大负载 | 2200W（阻性）/ 350W（感性） |
| 总额定功率 | 4400W（阻性）/ 700W（感性） |
| 产品尺寸 | 160.0 × 95.0 × 65.2mm |
| 产品净重 | 516g |
| 外壳材质 | 防火V0级PC，耐高温 |
| 无线连接 | WiFi 2.4GHz |
| 待机功耗 | 1.1（全断）- 5.2（全通）W |
| 控制接口 | HTTP API |
数据来源：
2.2 负载类型说明
| 负载类型 | 每路最大功率 | 总功率限制 | 常见设备 |
|---|---|---|---|
| 阻性负载 | 2200W | 4400W | 白炽灯、电热器、普通照明 |
| 感性负载 | 350W | 700W | LED灯、节能灯、电机、电磁阀 |
小负载直控，大负载扩展：对于功率较大的设备（如空调、大功率电机），可通过控制器驱动交流接触器的方式间接控制，实现小电流控制大电流。
2.3 支持的命令类型
该设备支持以下核心命令
| 命令类型 | 命令格式 | 说明 | 典型应用 |
|---|---|---|---|
| 单路控制 | {"power1":"1"} | 控制单路通断 | 独立设备启停 |
| 批量控制 | {"batch":{"relay":[1,2,3],"power":"1"}} | 同时控制多路 | 场景模式切换 |
| 先通后断 | {"point":{"relay":[1],"interval":3000}} | 接通后自动断开 | 门禁开门、脉冲控制 |
| 先断后通 | {"reset":{"relay":[1],"interval":5000}} | 断开后自动接通 | 设备远程重启 |
2.4 产品核心优势
设备开放HTTP接口，适用于任何支持HTTP请求的编程语言。接口简单、清晰、友好，仅需在接口携带签名以及设备ID，即可向设备下发命令。支持接入任何形式的软件项目：Web、APP/小程序、窗体软件以及SaaS/低代码等平台。
其他特性
私有化部署：支持自建消息服务器，可运行在纯局域网环境
远程定时任务：支持在平台设置定时任务，实现自动化管理
支持自定义联动操作：可根据业务需求编排联动逻辑
无网关设计：设备使用WiFi 2.4G无线网络，采用WiFi直接方式，无需网关支持
多网络备份：可设定5组WiFi网络，优先连接信号最强的进行连接：
三、整体架构
3.1 系统架构图
3.2 24路典型分配方案
| 回路范围 | 控制对象 | 负载类型 | 定时策略 |
|---|---|---|---|
| 回路1-12 | 楼层/区域照明 | 阻性/感性 | 营业时段开，闭店关 |
| 回路13-16 | 空调/新风系统 | 感性（外接触器） | 按温度策略启停 |
| 回路17-20 | 广告灯箱/招牌 | 阻性 | 定时开关 |
| 回路21-22 | 门禁/电磁锁 | 直流负载 | 按需控制 |
| 回路23-24 | 备用/扩展 | - | 预留 |
四、API接口接入详解
4.1 接口地址与签名计算
请求地址
参数说明
| 参数 | 说明 | 示例 |
|---|---|---|
| {AppId} | 应用ID（控制台获取） | qtyVWcgeMq |
| {ts} | 当前Unix时间戳（秒） | 1747212640 |
| {sign} | 签名（见下方计算公式） | c484eb97... |
签名计算公式
sign =
将开发者密码（AppSecret）进行一次MD5
将这个结果拼接上时间戳
ts对整个拼接后的字符串再做一次MD5
签名计算示例
4.2 核心命令详解
4.2.1 单路独立控制
控制某一路单独设备
4.2.2 批量控制（第一种场景键切换）
批量控制可同时控制任意组合的回路，适用于区域照明或场景模式切换
4.2.3 先通后断（脉冲控制）
适用于测试通电、门禁开门等需要短暂通电的场景
4.2.4 先断后通（远程重启）
适用于设备死机时的远程复位
4.2.5 携带业务标识
在一些业务场景，需要在命令里携带订单号等特征信息。可在order中增加一个字段extra，在消息推送中会原样返回此特征信息
extra只支持32位以内的大小写英文字母和数字（a-zA-Z0-9）
4.3 多语言代码示例
Python
JavaScript/Node.js
Shell（curl）- 快速测试
代码参考：
五、定时任务实现（两种方案）
5.1 方案一：平台内置定时任务（零代码）
芯步平台支持远程定时任务，无需任何开发即可实现定时自动启停控制。在控制台配置即可
配置步骤
登录芯步控制台
进入设备管理页面，选择目标24路控制器
点击「定时任务」选项卡
添加定时规则
定时任务配置示例
| 任务名称 | 执行时间 | 命令 | 说明 |
|---|---|---|---|
| 上班开灯 | 周一至周五 08:00 | {"batch":{"relay":[1,2,3,4,5,6],"power":"1"}} | 开启办公区照明 |
| 午休节能 | 周一至周五 12:00 | {"batch":{"relay":[2,3],"power":"0"}} | 关闭部分区域 |
| 下班关灯 | 周一至周五 18:00 | {"batch":{"relay":[1,2,3,4,5,6],"power":"0"}} | 全关 |
5.2 方案二：代码实现定时任务
如需与现有业务系统深度集成，可通过代码实现定时调度：
5.3 与楼宇自控系统联动
六、应用场景实战
6.1 第一种场景：办公大楼分层照明定时控制
需求：根据楼层使用情况和营业时间，自动控制各楼层照明回路。
设备配置：每台24路控制器可管理2-3层楼的照明回路
6.2 第二种场景：园区路灯自动启停
需求：根据日出日落时间自动控制园区路灯开关。
实现的方式是：结合天文时钟API动态设置定时任务
6.3 第三种场景：广告灯箱定时控制
需求：多块广告灯箱需要定时开关，不同灯箱可有不同策略。
设备配置：每块灯箱接入独立回路
6.4 场景四：售货柜多门独立控制
需求：自动售货机/智能货柜需要独立控制每个柜门的电磁锁。
设备配置：24路控制器每路接一个电磁锁
6.5 场景五：生产线设备分批启动
需求：工厂开机时按顺序分批启动设备，减小瞬间电流冲击。
实现的方式是：使用定时延时依次启动各回路
七、私有化部署方案
对于数据安全要求较高的场景，24路控制器支持纯局域网运行。
部署模式对比
| 特性 | 公有云模式 | 私有化模式 |
|---|---|---|
| 设备联网 | WiFi连接互联网 | 连接内网WiFi |
| API地址 | api.thingboot.com | 自建服务器IP |
| 数据流向 | 经过芯步云端 | 内网直连，数据不出机房 |
| 网络依赖 | 需要互联网 | 仅需局域网 |
| 适用场景 | 快速接入 | 政府、金融、数据安全要求高 |
私有化配置要点
设备支持配置5组WiFi网络，自动连接信号最强的网络
需自建HTTP服务，所有API调用在内网完成
支持自建消息服务器，接收设备状态回调
八、设备安装部署指南
8.1 安装要求
| 项目 | 要求 |
|---|---|
| 安装方式 | 标准导轨/配电箱安装 |
| 工作电压 | DC 12V 2A（产品附带电源） |
| 单路负载 | 阻性≤2200W，感性≤350W |
| 总额定功率 | 4400W（阻性）/ 700W（感性） |
| 网络要求 | WiFi 2.4GHz信号覆盖良好 |
| 外壳材质 | 防火V0级PC，耐高温 |
数据来源：
8.2 大负载扩展方案
对于功率超过控制器直接承载能力的设备（如空调、大功率电机），可通过外接接触器的方式进行控制
24路
8.3 接线注意事项
负载类型区分：LED灯、节能灯属于感性负载，每路不得超过350W
总功率限制：全接通时所有负载总和不得超过4400W（阻性）
直流供电：控制器使用DC 12V 2A适配器供电，注意正负极
WiFi信号：金属配电箱可能屏蔽信号，使用外置天线版本或测试信号强度
设备固件：24路控制器经过版本迭代，部分旧批次可能不支持硬件，选择较新型号
九、常见问题与排障
| 问题 | 可能原因 | 解决方案 |
|---|---|---|
| 设备不在线 | WiFi信号弱 | 检查2.4GHz WiFi覆盖，设备支持5组WiFi自动切换 |
| 命令下发成功但无动作 | 设备离线/参数错误 | 200仅表示平台接收，需确认设备在线状态 |
| 某路无法控制 | 负载超限/硬件故障 | 检查该路负载是否超过2200W |
| 总功率跳闸 | 全接通时超负荷 | 检查总额定功率是否超过4400W |
| LED灯闪烁 | 感性负载超限 | LED灯每路不超过350W，或并联补偿电容 |
| 签名验证失败 | 参数错误 | 确认ts为秒级时间戳，公式为md5(md5(AppSecret)+ts) |
| 批量控制部分失败 | 部分设备离线 | device参数中用逗号分隔的ID应逐个在线 |
十、总结
本方案基于芯步智能通用控制器24路，实现了多路设备的定时自动启停控制与集中管理
| 能力 | 实现的方式是 |
|---|---|
| 24路独立分控 | 每路独立API控制通断 |
| 定时自动启停 | 平台内置定时任务或代码定时调度 |
| 区域/楼层集中管理 | 批量控制命令一键切换 |
| 第一种场景键切换 | 预设场景的批量控制 |
| 设备远程重启 | reset先断后通命令 |
| 脉冲控制（开门） | point先通后断命令 |
| 私有化部署 | 内网运行，数据安全可控 |
集成核心步骤
获取AppID/AppSecret，实现MD5签名算法
根据项目需求规划24路回路分配（照明/空调/设备等）
通过平台定时任务或代码实现自动启停逻辑
开发HTTP调用模块，封装批量控制等函数
物理安装设备，按回路分配接线
方案优势
✅ 24路大容量：单设备管理24条独立线路，满足大中型项目需求
✅ 零代码定时：平台内置定时任务，无需开发即可实现自动启停
✅ 接口统一：标准HTTP API，任意编程语言10分钟对接
✅ 多种控制模式：单路/批量/脉冲/重启，适配全场景
✅ 即装即用：DC 12V供电，体积小巧，可安装于配电箱
✅ 大负载扩展：外接触器可控制空调、大功率电机等设备
✅ 私有化支持：数据安全可控，适合政企内网部署
如需详细的产品手册和API文档，请访问查阅或联系技术支持团队获取。