CATALOG

芯步的8路智能控制器提供标准HTTP API接口,单路、批量、时序控制命令都有明确格式。以下方案涵盖前期准备、签名算法、核心命令示例(含PHP/小程序代码),以及安规注意事项——你团队的前后端可直接参考对接。

1. 产品概述与接口优势

芯步推出的 8路智能分体远程电源控制箱(型号:UNI-KZQ-TY-8)是一款高集成度的远程电源管理设备。它支持通过标准 HTTP/HTTPS API 进行控制,具有体积小、负载能力强(单路最大2200W阻性负载)的特点

核心接口优势:

  • 协议通用性:基于 HTTP 协议,JSON 数据格式,支持任何现代编程语言(Java, Python, PHP, Node.js)及物联网平台对接。

  • 响应迅速:实测命令下发到设备执行响应约 80-120ms

  • 双网融合:同时支持 公网(Remote)局域网(LAN) 控制。即使外网断开,只要在同一局域网下,依然可以通过内网 IP 进行控制,保障了业务的稳定性

2. 对接前期准备

在开发之前,请完成以下账户及环境配置:

  1. 注册与登录:访问芯步官网注册企业/开发者账号

  2. 创建实例:在工作台创建新的应用实例,系统将自动分配 AppIDAppSecret(开发者密码)

  3. 设备配网

    • 将控制箱通电,确保其处于配网模式(指示灯快闪)。

    • 通过“芯步”小程序或控制台,为设备配置现场的 2.4GHz WiFi 网络

    • 记录下设备列表中生成的 Device ID(设备唯一标识)

3. API 调用核心逻辑:签名机制

为了安全,所有开放接口均需携带签名(Sign)。具体算法如下(以 Bash/PHP 伪代码为例):

  1. 获取当前时间戳(秒级)ts

  2. AppSecret 进行一次 MD5 加密:step1 = md5(AppSecret)

  3. 拼接 step1tsstep2 = step1 + ts

  4. step2 再次进行 MD5 加密得到最终签名:sign = md5(step2)

请求地址结构:https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

4. 远程指令控制详解(JSON 命令集)

芯步的接口通过 order 参数中的 JSON 字符串来执行具体动作。以下是针对该 8 路控制箱的实用命令示例。

4.1 单路独立控制

最常用的场景,单独控制某一路的“开”或“关”。

动作order 参数值
打开第1路{"power1":1}
关闭第1路{"power1":0}
打开第8路{"power8":1}

引用示例:

4.2 批量多路控制

当需要一键开启或关闭多个回路时,使用 batch 命令可以大幅减少网络请求次数。

  • 全开所有回路{"batch":{"power":1}}

  • 全关所有回路{"batch":{"power":0}}

  • 仅开启奇数路(1,3,5,7){"batch":{"relay":[1,3,5,7],"power":1}}

  • 仅关闭偶数路(2,4,6,8){"batch":{"relay":[2,4,6,8],"power":0}}

4.3 时序控制(Point / Reset)

在某些工业场景下(如机柜服务器重启),需要先断开再接通,中间有时间间隔。可以使用 “先通后断”“先断后通” 指令。

  • 顺序通电(point):按照指定顺序依次接通线路。

    • 示例:对线路2、4、6、8依次通电,每个间隔1秒{"point":{"relay":[2,4,6,8],"interval":1000}}

  • 顺序断电(reset):按照指定顺序依次断开线路。

    • 示例:对所有线路依次断电,间隔500毫秒{"reset":{"interval":500}}

5. 实战代码示例

以下是基于 PHP(适用于后端集成)和 微信小程序(适用于移动端)的对接实例。

5.1 PHP 后端对接示例

代码逻辑参考自芯步开放接口规范

5.2 微信小程序对接示例

适用于管理员在移动端远程运维。

代码逻辑参考微信小程序 API 调用规范

6. 高级集成:本地局域网控制

对于不允许连接外网的保密环境或对延时要求比较高的场景,芯步设备支持局域网控制功能。

如果在物联网控制台中为该设备分配了固定 IP,或者你知晓其在局域网内的 IP 地址,可以直接将上述请求中的域名 api.thingboot.com 替换为该设备的 局域网 IP 地址。

注意:局域网模式下仍需携带 AppId, sign, ts 参数进行身份验证,但数据流量不经过云端,直接发往设备,极大提升了内网吞吐下的稳定性和响应速度

7. 安规与负载注意事项

在进行物理接线和软件控制逻辑设计时,请请一定要遵守以下电气特性,以避免损坏设备或触发保护:

  1. 负载类型区分

    • 阻性负载(白炽灯、电热丝):单路最大 2200W

    • 感性/容性负载(LED灯、电机、节能灯):单路最大 350W。因为启动电流瞬时较大,需预留余量

  2. 总功率上限:整机全接通时,总负载不得超过 4400W(阻性负载)700W(感性负载)

  3. 工作电压:该型号支持 DC 12V 1.5A 供电,接口协议同样适用于交流 85-265V 的交流版本,请根据铭牌选择电源

8. 总结

通过对接芯步标准的 HTTP 开放接口,开发者可以在短时间内为 8 路远程电源控制箱构建定制化的管理系统。从单路的独立控制到复杂的批量时序动作,接口均提供了清晰的支持。无论是将其集成到现有的楼宇自控系统中,还是开发独立的微信小程序进行便携管理,该方案都具备比较高的可靠性和灵活性。