AC4-30A 是一款支持 HTTP 接口远程控制的工业级大功率通断器（6600W），其开放 API 允许开发者将其接入自有系统，实现基于传感器、定时任务或业务规则的自动化联动。以下是详细的接入方案。
1. 解决概述
1.1 产品简介
AC4-30A是芯步推出的一款支持WiFi通信的大功率智能通断器。其核心优势在于：
大功率支持：额定电流30A，支持阻性负载6600W，可覆盖空调、大功率电机、中央热水器等工业/商业设备。
接口开放性：提供标准的HTTP API接口，支持任何编程语言（Python, Java, Go, PHP等）或低代码平台调用。
多重控制模式：支持基本通断、先通后断、先断后通等多种时序逻辑。
1.2 适用场景
环境联动：根据传感器（温湿度、烟雾）状态自动排风或断电。
设备互锁：A设备关闭后延时开启B设备。
自定义定时：实现周计划、倒计时或循环开关（秒级精准）。
安防联动：检测到入侵信号时，联动开启大功率警报器。
2. 准备工作
在开始开发前，请确保完成以下步骤：
硬件上电：将AC4-30A接入220V电路，确认指示灯状态（慢闪表示等待配网）。
注册与添加设备
在芯步开放平台注册开发者账号。
将AC4-30A通过“扫码配网”或“AP配网”添加至账号下，记录下设备ID（Device ID）。
获取密钥
在控制台获取您的 AppID 和 App Secret，用于生成接口签名。
3. API接口详解
AC4-30A的核心控制逻辑基于HTTP协议。所有指令通过向特定URL发送POST请求实现。
3.1 请求地址与鉴权
请求URL：
http(s)://api.thingboot.com/{AppID}/device/control/鉴权方式：URL参数签名（Sign）
必填参数
sign（签名）、ts（时间戳）
*注：具体的签名算法（MD5/SHA256）请参考官方《鉴权文档》，通常是将App Secret与参数拼接后加密。*
3.2 核心指令集
针对AC4-30A，order 字段是控制的核心。
| 命令名称 | 参数Key | 数值示例 | 功能描述 |
|---|---|---|---|
| 线路控制 | power | "1" (开) / "0" (关) | 立即改变继电器的通断状态 |
| 先通后断 | point | "5000" (毫秒) | 立即接通，延时指定时间后自动断开（脉冲信号） |
| 先断后通 | reset | "5000" (毫秒) | 立即断开，延时指定时间后自动接通（重启模式） |
3.3 请求示例
场景：控制AC4-30A开启电源
返回结果
注意：code 200仅表示平台接收指令成功，若需确认设备真实执行状态，需配合“消息推送”功能监听设备回调。
4. 自定义联动逻辑实现
为了实现“自定义联动逻辑”，我们通常需要搭建一个业务服务器。该服务器接收传感数据，根据预设的算法规则，决定何时向AC4-30A下发指令。
4.1 架构原理
数据采集：传感器（温度/门磁/红外）将数据上报到业务服务器。
逻辑判断：服务器执行代码逻辑（
if(温度 > 50 && 电流 > 20A)）。指令执行：满足条件时，服务器调用AC4-30A的控制接口。
4.2 方案 A：基于定时任务的定时开关
需求：工作日 9:00 开启设备，18:00 关闭设备。实现逻辑：在服务器上设置Cron Job（定时任务）。伪代码示例
4.3 方案 B：传感器联动
需求：当仓库温度超过40℃时，自动开启排风扇（接在AC4-30A上）；低于30℃时关闭。实现逻辑：接收温度传感器的HTTP上报。流程图
温湿度传感器上报
{"temperature": 42}到/api/temperature_callback。服务器收到数据，判断
42 > 40。服务器调用AC4-30A的
power: "1"接口。服务器记录状态，避免重复触发。
伪代码示例
4.4 方案 C：复杂逻辑——设备互锁与延时
需求：控制电机正反转（需要两个AC4-30A，A控制正转，B控制反转）。严禁A和B同时闭合。实现逻辑
通过代码逻辑保证下发指令时的互斥性。
利用
point（先通后断）指令避免同时闭合。
代码逻辑
4.5 方案 D：局域网/私有化部署
对于高实时性要求（如工业自动化）或内网环境：
AC4-30A开放了局域网API。
服务器可以直接通过
http://[AC4-30A的局域网IP]/control进行控制，绕过云端，将延时降低至10ms以内。
5. 高级功能与状态同步
5.1 获取设备当前状态
在自定义联动中，往往需要知道设备当前是开还是关，才能决定下一步动作。
方法一：云端查询：调用芯步的
设备状态查询API（通常伴随控制接口提供）。方法二：消息订阅：在服务器开放一个接口（URL Callback），当设备状态发生变化时（无论是程序控制还是手动按键），云端会主动推送当前状态到服务器。采用此方案以保持数据库状态实时准确。
5.2 指令中携带Extra字段
需要在业务中追溯指令来源（例如工单号、操作员ID）时，可以使用 extra 字段。
这在审计日志和异步回调校验中非常有用。
6. 常见问题与排障
| 问题现象 | 可能原因 | 解决方案 |
|---|---|---|
| 下发指令返回200，但设备不动 | 网络不通或MQTT长连接断开 | 1. 检查AC4-30A指示灯是否为常亮（已联网）。2. 聆听继电器是否有“哒”一声，无声音说明供电或硬件故障。 |
| sign签名错误 | 参数排序错误或Secret错误 | 严格按照官方文档的顺序拼接字符串，注意处理编码问题。 |
| 联动延迟过高 | 云端往返+轮询机制较慢 | 对于秒级响应的场景（如停车场道闸），切换到局域网API模式进行控制。 |
| 手动按键与远程冲突 | 用户误触可能导致逻辑紊乱 | 可通过API或App设置屏蔽设备上的物理按键，仅允许远程控制。 |
7. 总结
通过对接芯步AC4-30A的开放接口，开发者可以极大地扩展其应用边界。从简单的定时任务，到复杂的传感器阈值联动，再到工业标准的电机互锁控制，AC4-30A配合自定义的业务逻辑服务器，能够构建出一套强大、可靠的自动化控制系统。核心实施路径总结为：获取设备ID -> 理解Power/Point/Reset指令语义 -> 搭建业务Server进行状态机维护 -> 精准下发指令。