芯步的20A智能通断器支持HTTP API远程控制,适合各类需要单路交流负载控制的场景。以下方案涵盖硬件选型、接口对接和关键代码实现。
1. 硬件选型与概览
在芯步的产品线中,针对20A单路交流负载控制,推荐使用以下两款核心产品。开发者可根据是否需要导轨安装、是否集成物理开关来选择,两者均开放了统一的HTTP API接口。
| 特性 | 智能通断器 AC4-20A | 智能断路器 20A |
|---|---|---|
| 核心功能 | 单路通断控制 | 单路通断控制 + 机械断电保护 |
| 额定功率 | 4400W | 4000W |
| 工作电压 | 交流85-265V | 交流85-265V |
| 安装方式 | 侧方接线,体积小巧,适合内置设备 | 标准导轨式安装,适合配电箱 |
| 特色功能 | 支持“点动”模式(继电器延时复位) | 支持物理按钮控制、更完善的过载保护 |
| 适用场景 | 工业设备远程启停、智能插座、大功率灯具 | 智能电箱、家庭总闸、充电桩远程控制 |
核心优势:这两款设备均支持 HTTP API 和 MQTT 协议,指令响应速度约 80-120ms,且支持局域网和公网两种通信模式。
2. 接入准备
在编写代码前,需要先完成设备的网络配置和开发者凭证的获取。
账号注册:注册并登录。
设备配网:设备支持小程序(SmartConfig)或电脑端控制台配网。
注意:设备仅支持 2.4GHz WiFi。配网时需将手机热点或WiFi设置为2.4G频段。
获取凭证:在“物联网控制台” -> “开发设置”中获取
AppID和AppSecret。获取设备ID:在“设备列表”页面获取目标通断器的
Device ID(例如820720)。
3. API 接口对接详解
芯步的接口采用签名机制保证安全性。所有的控制指令通过HTTP POST发送至统一网关。
3.1 签名算法 (Sign)
为了防止接口被恶意篡改,每次请求都需要携带签名。签名生成规则如下
1. 将 AppSecret 进行 MD5 加密,得到 Secret_MD5。 2. 将 Secret_MD5 与当前 Unix 时间戳 ts 拼接,得到 String_B。 3. 将 String_B 再次进行 MD5 加密,得到最终的 Sign。
3.2 接口地址
3.3 请求体 (JSON)
*注:部分多路控制器使用 power1,对于AC4-20A单路设备,使用 power 即可。*
4. 代码实践示例
以下以 AC4-20A(单路)为例,展示如何通过Python和Shell脚本实现远程闭合(开启)与断开(关闭)。
第一种场景:远程开启负载 (Power On)
Python 实现:
Shell (cURL) 实现:
第二种场景:远程断开负载 (Power Off)
只需修改请求体中的 order 字段:{"power": 0}。
第三种场景:高级功能 —— 定时断开 (点动模式)
在很多工业场景中,需要触发设备开启一段时间后自动关闭(例如控制门禁或水泵)。芯步的通断器支持指令参数,无需在服务器端维护定时任务即可实现。
指令示例(开启并持续1小时后自动断开):
5. 常见问题与排障
设备一直离线?
检查WiFi是否为2.4G频段(不支持5G WiFi)。
确认设备是否已通过“物联网控制台”或小程序成功配网,指示灯常亮代表在线,闪烁代表配网模式或离线。
接口返回
501或502?501:未指定标签ID或设备ID。请检查请求参数中的device字段。502:设备不存在或不在线。请检查设备ID是否正确,或者设备是否断电。
负载过大导致设备损坏?
AC4-20A虽然标称20A/4400W,但主要针对阻性负载(如白炽灯、电热丝)。
如果是 感性负载(如电机、空调压缩机),启动电流极大,降额使用(通常不超过 1/3),或选用带保护功能的智能断路器版本。
如何实现局域网控制?
芯步支持私有化部署和局域网直连。设备在同一局域网下,可直接调用设备本地IP进行控制,无需经过云平台,延迟更低且断外网可用。
通过以上步骤,你可以在10分钟内完成从硬件接线到云端API的对接,实现对20A交流负载的远程智能化管理。