芯步的24路智能分体控制器支持HTTP接口调用,可独立控制每路交直流输出。以下方案涵盖设备选型对比、接口签名算法、单路/批量控制实现代码,以及延时控制等高级功能。
解决方案:基于芯步开放平台接入24路智能分体控制器实现远程集约化控制
1. 背景与选型
在许多工业自动化、智能农业、共享空间(如台球厅、自习室)及沙盘模型中,常常需要对大量分散的设备(如灯具、电机、电磁阀、水泵)进行集中且独立的逻辑控制。芯步提供的24路智能分体控制器及通用控制器,结合其开放的HTTP API接口,能够快速实现对24路交直流负载的远程、精准控制。
核心设备选型:
智能分体控制器 (UNI-KZQ-FT): 适合强电环境(AC 220V),内置电源,支持有线/无线双保障,单路负载高达5000W,适合灯具、空调等强电设备 。
智能通用控制器 (UNI-KZQ-TY-24): 适合弱电或嵌入式集成,体积小巧(160*95mm),DC 12V供电,需外接接触器控制大功率设备 。
| 特性 | 智能分体控制器 | 智能通用控制器 |
|---|---|---|
| 工作电压 | AC 85-265V (市电直供) | DC 12V (适配器供电) |
| 单路最大负载 | 5000W (阻性) / 800W (感性) | 2200W (阻性) / 350W (感性) |
| 联网方式 | 以太网 + WiFi 2.4G | WiFi 2.4G |
| 适用场景 | 标准控制柜、大功率设备集中控制 | 小型设备内部集成、小负载控制 |
2. 接入设计
采用标准的 “云-端”架构,业务系统无需直连硬件,通过芯步开放平台进行信令交互。
设备层: 24路分体控制器,继电器输出(常开触点),控制24个回路。
网络层: 设备通过Wi-Fi/以太网连接至芯步云网关,支持2.4GHz频段,具备超强穿透力 。
平台层: 芯步开放平台(
api.thingboot.com),处理设备状态维持、签名验证与消息转发。应用层: 用户自有的SaaS平台、App或WinForm程序,通过HTTP请求调用接口。
3. 接口对接详解
芯步的接口采用极简的 HTTP 格式,支持公网与局域网(私有化部署)两种模式。
3.1 签名算法与鉴权
为了安全,所有API请求需携带签名(sign)和时间戳(ts)。签名生成公式(通用):sign = md5( md5(AppSecret) + ts )
AppSecret: 在芯步控制台获取的开发者密钥。
ts: 当前的Unix时间戳(秒)。
流程: 先将AppSecret进行一次MD5加密,再将得到的字符串拼接上时间戳,最后整体再进行一次MD5加密 。
3.2 单路独立控制 (核心指令)
通过指定 order 参数中的 powerX 字段,实现对特定通道的开关。请求地址:POST https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}
请求示例 (控制第1路开启):
控制第8路关闭:
技术特点: 该接口支持任何支持HTTP请求的编程语言(如Java, Python, PHP, C#),且响应速度极快(约80-120ms)。
3.3 批量控制 (高效并发)
若需同时控制多路输出,使用 batch 命令配合二进制位操作,可显著减少网络请求次数。Bit定义规则: 位值 1 为通,0 为断。Bit0 对应 power1,Bit1 对应 power2 ... Bit23 对应 power24。
请求示例 (同时开启所有24路):
(注:二进制 24个1 转换为十进制即为 16777215)
请求示例 (仅开启第1路和第24路):二进制为 100000000000000000000001,对应十进制 8388609。
3.4 延时与联动控制
针对需要定时关断的场景,可使用 “先通后断(point)” 指令,特别适用于电机点动或临时照明。请求示例 (第1路开启,延时10秒后自动关闭):
该指令下发后,设备内部芯片执行计时,无需应用服务器持续维持连接,即使断网也会在计时结束后执行 。
4. 硬件接线和需要注意的点
交直流负载接线:
直流负载: 控制器支持DC 0-24V直接控制。将负载正极接COM(公共端),负极接NO(常开端)。
交流负载(220V): 控制器触点支持AC 220V/110V。将火线接入公共端,负载接常开端。由于控制器内部为继电器物理隔离,交直流可混用 。
大功率扩展:若单路负载超过额定值(例如通用控制器2200W的限制),必须外接交流接触器。将控制器的输出作为接触器线圈的开关信号。
供电要求:
分体控制箱:直接接入AC 220V市电。
通用控制器:必须使用配套的DC 12V/2A电源,供电不稳定会导致WiFi模块重启。
5. 总结
极低成本接入: 无需学习复杂的MQTT协议或嵌入式固件开发,仅需熟悉HTTP Get/Post即可完成集成,开发周期通常小于1天 。
部署灵活: 支持纯局域网私有化部署。若客户机房无外网,设备可切换至“局域网模式”,直接向客户内网服务器上报数据,保障数据绝对安全 。
高扩展性: 该接口体系通用,未来若需增加传感器(如温湿度、人体雷达),可使用同一套AppID和签名算法接入,实现传感器触发自动控制24路设备(如“人来灯亮”)。
通过以上方案,用户可以快速构建具备24路独立控制能力的远程管理系统,实现从“功能机”到“智能机”的升级。