24路扩展型智能控制器的核心价值在于:通过开放HTTP接口,将传统硬件设备“改造”为可通过API编程控制的智能终端。以下方案从硬件准备、接口对接、场景应用到最佳实践,完整呈现如何实现远程自定义控制。
1. 概述
本方案的目标是指导开发者或集成商如何利用芯步 24路扩展型智能控制器(UNI-KZQ-TY-24) 的开放接口,通过HTTP协议实现远程、自定义的设备控制。
该控制器不仅支持单路独立控制,还支持批量控制、延时联动等高级自定义逻辑。结合其开放的API,用户可以将其集成到现有的Web系统、APP、小程序或企业中控平台中。
2. 硬件准备与参数解析
在开始开发前,需了解硬件的核心特性以确保适配场景。
核心参数
型号:UNI-KZQ-TY-24。
控制路数:24路(独立控制)。
工作电压:DC 12V 2A。
负载能力:单路最大支持2200W(阻性负载),总功率最大4400W。
通信方式:Wi-Fi 2.4GHz(无需网关)。
适用场景:沙盘模型灯光控制、智能售货柜、工厂自动化设备、实验室电源管理、大型商业照明等。
3. 接口对接技术方案
芯步的接口设计遵循简单、开放原则,支持公网与局域网(私有化部署)两种模式。
3.1 接口基本逻辑
所有控制指令均通过HTTP POST请求发送。系统架构如下:第三方系统 -> 芯步云API -> 设备云端 -> 24路控制器 -> 执行动作。
3.2 签名认证(鉴权)
为了安全,每次调用都需要携带动态签名。签名算法规则如下:
拼接字符串:
str = md5(AppSecret) + ts(ts为当前Unix时间戳)。计算签名:
sign = md5(str)。参数说明
AppID:应用ID,在控制台获取。AppSecret:开发者密码,用于加密。
3.3 核心API调用示例
以下通过 Shell + Curl 演示如何下发指令,这对后端集成具有直接参考价值。
4. 实现 “自定义控制” 的四种命令模式
为了实现复杂的自动化逻辑,不能仅依赖简单的“开/关”。该控制器提供了进阶命令集,是实现“自定义控制”的核心。
4.1 独立控制
最基础的模式,针对特定线路操作。
示例:打开第3路,关闭第5路。
命令
{"power3": 1, "power5": 0}。
4.2 批量控制
适用于需要一键启动生产线或多组灯带的场景。
示例:同时关闭第1、3、5路。
命令
{"batch": {"relay": [1, 3, 5], "power": 0}}。
4.3 时序联动控制
这是实现“智能化”的关键,允许设置线路切换的时间间隔。
先通后断 (Point):用于防止短路或瞬间过载。例如打开新线路前,先断开旧线路。
示例:先接通第2路,延迟1000毫秒后,再断开第1路。
命令
{"point": {"relay": [1,2], "interval": 1000}}。
先断后通 (Reset):用于设备重启或复位操作。
示例:断开第4路,延迟500毫秒,再次接通。
命令
{"reset": {"relay": [4], "interval": 500}}。
5. 典型应用场景解决方案
5.1 第一种场景:共享棋牌室/自习室自助通电
需求:用户下单后,自动给对应包间的总电和灯光通电;用户离开现场时后自动断电。实现逻辑
将包间总闸接入控制器第1路,照明接入第2路,插座接入第3路。
用户支付成功,业务系统回调:
发送命令
{"power1": 1, "power2": 1, "power3": 1}。
用户点击“暂时离开”或“结束订单”:
发送命令
{"batch": {"relay": [1,2,3], "power": 0}}。
5.2 第二种场景:沙盘模型/展厅灯光秀
需求:依次点亮不同区域的灯光,形成流水效果。实现逻辑业务系统循环发送延时指令,或使用控制器的 “先通后断” 组合命令。
启动命令:
{"power1": 1}-> 延迟200ms ->{"power2": 1}-> 延迟200ms ->{"power3": 1}。替代方案:使用
{"point":{"relay":[1,2,3,4],"interval":200}}实现流水灯效果。
5.3 第三种场景:远程机房维护(IPMI替代方案)
需求:远程重启死机的服务器或网络设备。实现逻辑
将设备电源插头接入控制器对应路数。
业务系统发送 “先断后通” 命令:
{"reset": {"relay": [5], "interval": 5000}}(断开第5路5秒后自动重启)。
6. 局域网与私有化部署(高安全性)
对于不允许接入外网的生产环境,该控制器支持局域网通信和私有化部署。
局域网模式:设备与服务器处于同一网段时,可直接通过设备IP进行HTTP调用,不经过云API,响应速度更快(毫秒级),数据完全不流出企业内网。
配置方式:在设备配网时,通过控制台将数据路由指向本地服务器IP地址。
7. 最佳实践和需要注意的点
感性负载处理:如果控制电机、LED灯带或节能灯,负载功率需降额使用(控制在阻性负载的1/3以内),否则可能导致触点粘连。该设备单路感性负载不超过350W。
Wi-Fi信号强度:该设备仅支持2.4GHz Wi-Fi。在安装24路控制器的弱电箱或机柜内,确保Wi-Fi信号强度在2格以上,否则增设AP。
并发控制:API接口支持批量控制(如
batch命令),在一次请求中完成多路操作,避免在循环中逐个发送单路指令,以提高执行效率并减少网络延迟。状态同步:控制器状态变更后,可通过芯步提供的回调机制(Webhook)将状态推送到业务服务器,避免频繁轮询。
总结
通过芯步24路智能控制器的开放HTTP API,开发者可以轻松地将物理世界的控制能力集成到软件系统中。无论是简单的独立开关,还是复杂的时序联动(点控/复位),都能通过标准化的JSON命令实现,从而快速构建从“智能家居”到“工业自动化”的各种自定义控制解决方案。