CATALOG

芯步的2路交流控制器提供标准的HTTP API接口,只要按照签名规范构造请求,即可实现远程开关控制。以下方案涵盖从设备配网、签名计算到实际调用的完整流程,代码示例可直接复用。

解决方案:基于芯步开放接口实现2路交流控制器远程指令控制

1. 整体技术架构概述

芯步的智能硬件体系采用设备直连Wi-Fi + 云端HTTP API的架构。对于“智能2路交流物联网控制器”(型号通常为UNI-KZQ-AC-2),开发者无需集成复杂的SDK,只需通过标准的HTTP POST请求,即可对设备进行远程操控

核心流程业务系统 -> 构造HTTP请求 -> 芯步云端API -> WiFi网络 -> 智能控制器 -> 执行开关动作

2. 对接前的准备工作

在开始编码之前,需要完成以下环境准备:

  1. 硬件准备:确保智能2路交流控制器已接通电源,并处于配网模式(通常指示灯闪烁)。

  2. 平台注册:访问芯步官网注册开发者账号,进入“工作台”。

  3. 设备配网

    • 通过微信小程序“芯步”或登录网页控制台,为设备配置现场的2.4G Wi-Fi网络

    • 确认设备在控制台显示为“在线”状态。

  4. 获取密钥:在“物联网控制台” -> “开发设置”中,获取 AppIDAppSecret(开发者密码),并记录设备的唯一标识 Device ID

3. 接口鉴权机制(签名计算)

为了安全起见,所有开放接口均需携带动态签名。签名算法如下(兼容性最强):

  • 参数AppSecret,当前时间戳 ts(秒级)。

  • 公式Sign = md5( md5(AppSecret) + ts )

注:如果仅在测试阶段,可在开发设置中开启“调试模式”以暂时绕过签名校验

4. 远程指令控制实现(代码级示例)

您可以采用任何支持HTTP协议的编程语言进行对接。

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

核心参数(JSON Body)

  • device:字符串,目标设备的Device ID。

  • order:JSON对象,具体命令。

针对2路控制器的命令映射:

  • {"power1": 1}:开启第1路

  • {"power1": 0}:关闭第1路

  • {"power2": 1}:开启第2路

  • {"power2": 0}:关闭第2路

  • {"batch": "11"}:同时开启两路

Bash (cURL) 对接示例

Python 对接示例

5. 高级功能:私有化与局域网部署

对于数据安全要求比较高或网络环境封闭的场景,芯步的该系列控制器支持私有化部署

  • 原理:设备支持配置私有化MQTT或HTTP服务器地址。

  • 效果:控制指令无需经过公网,完全在内部局域网或私有云中闭环流转,实现毫秒级响应

6. 常见问题与排障

  1. 签名错误:提示401或Sign Error。请重点检查时间戳格式是否为秒级(10位),以及md5计算是否包含32位标准格式。

  2. 设备离线:确认设备供电正常,且Wi-Fi网络稳定。设备仅支持2.4G频段,不支持5G Wi-Fi

  3. 指令无响应:确认命令格式是否为JSON字符串。例如 {"power1":1} 而非 {"power":"1"}

通过以上方案,您的业务系统可以在1小时内完成与芯步2路控制器的对接,实现可靠的远程开关控制。