CATALOG

芯步AC4-10A智能通断开关的核心优势在于其开放的HTTP接口——无需网关、直接WiFi联网,任何支持HTTP请求的编程语言都能快速接入。以下方案详细说明如何通过接口下发命令,实现对2200W额定功率设备的远程控制,包含签名算法、代码示例及延时控制等高级功能。

1. 产品概述与核心能力

芯步 AC4-10A 智能通断开关 是一款支持WiFi直连的继电器控制模块。该设备采用2.4G WiFi无线网络,无需额外网关即可直接联网

在电气性能方面,该设备适用于 2200W 的额定功率控制场景。设备的核心优势在于其开放的 HTTP接口,仅需携带设备ID和签名即可实现毫秒级响应的远程通断控制,非常适合集成到现有的Web应用、企业内部管理系统或SaaS平台中

2. 接入前提与准备工作

在开始API对接前,需要完成以下硬件配置与信息获取:

  1. 硬件通电与配网

    • 将AC4-10A接入220V电路,输出端连接待控制的负载(注意功率不超过2200W)。

    • 使用微信小程序或官方控制台,为设备配置2.4G WiFi网络,确保设备指示灯常亮(在线状态)

  2. 获取关键凭证

    • AppIDAppSecret:登录芯步开发者控制台后,在“开发设置”页面获取,这是所有API调用的鉴权基础

    • Device ID:在控制台设备列表或设备外壳标签上获取,用于精准定位需要控制的物理设备

3. API 接口对接详解

芯步采用标准的 HTTP POST 请求进行控制,核心逻辑是构建携带签名的URL和包含命令的JSON报文。

3.1 请求地址与鉴权

  • 请求URLhttps://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

  • 请求方法: POST

  • Content-Typeapplication/json

鉴权参数 sign 的生成算法步骤如下:

  1. AppSecret 进行一次 MD5 加密,得到字符串 S1

  2. S1 拼接上当前时间的 Unix时间戳(秒) ts,得到字符串 S2

  3. S2 再次进行 MD5 加密,得到最终的 sign

算法公式sign = MD5( MD5(AppSecret) + ts )

3.2 核心命令下发示例

以下是通过API控制设备 通电(打开)断电(关闭) 的标准示例。通过指定 device 字段来确定目标硬件,通过 order 字段下发 power 指令来控制继电器吸合或断开。

3.3 代码实现示例

以下是一个完整的 Shell + cURL 调用示例,展示了从生成签名到发送命令的全过程。实际开发中可根据需要替换为 Python、Java 或 Node.js 等语言的等效实现。

4. 高级功能:实时状态同步与延时控制

4.1 实时状态同步

AC4-10A 支持 事件上报 机制,当本地物理按键按下或设备状态变化时,平台会主动推送消息。注意:官方文档指出,HTTP命令返回200仅代表平台接收指令成功,若需确认设备是否真的执行(例如排查设备离线情况),必须通过接入 消息推送服务 来异步接收设备状态变更回调

4.2 延时控制

除了即时开关,设备还支持 先断后通(reset)先通后断(point) 功能。

  • 场景举例:控制热水器通电1小时后自动断开。

  • 下发命令{"reset":"3600000"} (注意:时间单位通常为毫秒)。

5. 安全规范与故障排查

在实际部署中需重点关注以下安全与稳定性问题,以保障系统可靠运行。

1. 电气安全

  • 断电操作:接线前请一定要切断总电源。

  • 规范接线:输入端接火线零线,输出端接负载。严禁超载,虽然设备标称10A/2200W,但用于电机或感性负载时需预留余量

2. 接口调用排错

  • 50x 错误:若返回 502504,请首先检查 Device ID 是否正确,并确认设备在控制台处于“在线”状态且IP地址未变动。

  • 签名错误:请核对 sign 生成逻辑,特别注意 ts 是秒级时间戳,且 MD5 结果为 32 位小写十六进制字符串。

6. 总结

通过芯步AC4-10A的HTTP接口,开发者可以在不增加复杂网关设备的情况下,通过几行代码实现 2200W 大功率电器的远程智能化管理。该方案的路径为:获取设备ID -> 生成动态签名 -> 下发 JSON 指令,具有比较高的集成效率,适用于智慧工厂、无人值守机房及商用电器联网改造等场景。