CATALOG

芯步的20A智能通断器支持HTTP API远程控制,适合各类需要单路交流负载控制的场景。以下方案涵盖硬件选型、接口对接和关键代码实现。

1. 硬件选型与概览

在芯步的产品线中,针对20A单路交流负载控制,推荐使用以下两款核心产品。开发者可根据是否需要导轨安装、是否集成物理开关来选择,两者均开放了统一的HTTP API接口。

特性智能通断器 AC4-20A智能断路器 20A
核心功能单路通断控制单路通断控制 + 机械断电保护
额定功率4400W4000W
工作电压交流85-265V交流85-265V
安装方式侧方接线,体积小巧,适合内置设备标准导轨式安装,适合配电箱
特色功能支持“点动”模式(继电器延时复位)支持物理按钮控制、更完善的过载保护
适用场景工业设备远程启停、智能插座、大功率灯具智能电箱、家庭总闸、充电桩远程控制

核心优势:这两款设备均支持 HTTP APIMQTT 协议,指令响应速度约 80-120ms,且支持局域网和公网两种通信模式

2. 接入准备

在编写代码前,需要先完成设备的网络配置和开发者凭证的获取。

  • 账号注册:注册并登录

  • 设备配网:设备支持小程序(SmartConfig)或电脑端控制台配网。

    • 注意:设备仅支持 2.4GHz WiFi。配网时需将手机热点或WiFi设置为2.4G频段

  • 获取凭证:在“物联网控制台” -> “开发设置”中获取 AppIDAppSecret

  • 获取设备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. 常见问题与排障

  1. 设备一直离线?

    • 检查WiFi是否为2.4G频段(不支持5G WiFi)

    • 确认设备是否已通过“物联网控制台”或小程序成功配网,指示灯常亮代表在线,闪烁代表配网模式或离线。

  2. 接口返回 501502

    • 501:未指定标签ID或设备ID。请检查请求参数中的 device 字段

    • 502:设备不存在或不在线。请检查设备ID是否正确,或者设备是否断电。

  3. 负载过大导致设备损坏?

    • AC4-20A虽然标称20A/4400W,但主要针对阻性负载(如白炽灯、电热丝)。

    • 如果是 感性负载(如电机、空调压缩机),启动电流极大,降额使用(通常不超过 1/3),或选用带保护功能的智能断路器版本

  4. 如何实现局域网控制?

    • 芯步支持私有化部署和局域网直连。设备在同一局域网下,可直接调用设备本地IP进行控制,无需经过云平台,延迟更低且断外网可用

通过以上步骤,你可以在10分钟内完成从硬件接线到云端API的对接,实现对20A交流负载的远程智能化管理。

通断器产品方案:
怎么接入DC-10A 设备电源控制器以实现远程定时任务控制
查看 >>
普通灯具系统交流控制:怎样将智能通断器AC1-10A对接到自己的项目中
查看 >>
如何在共享场所直流负载管理中接入智能硬件来实现远程批量控制
查看 >>
怎么在普通灯具系统交流控制中接入智能设备来实现远程批量控制
查看 >>
怎么接入AC4-30A 物联网开关以实现单路交流负载控制
查看 >>
负载场景方案:
怎样对接60A带计量数显物联网断路器来实现额定功率负载控制
查看 >>
怎么二次开发智能 8 路分体远程信号控制箱来实现单路负载25A/5000W控制
查看 >>
实验室低压负载控制:怎么把DC-10A 设备电源控制器接入到自己的项目中
查看 >>
共享场所直流负载管理:怎么将4路直流电路控制器对接到项目中
查看 >>
如何对接24路高集成度控制器以实现负载状态反馈控制
查看 >>
单路用途方案:
如何二次开发8 路智能分体远程多回路控制箱以实现单路负载25A/5000W控制
查看 >>
如何二次开发智能墙壁开关1路以实现单路照明或设备控制
查看 >>
如何在智能办公中对接智能硬件来实现单路照明设备控制
查看 >>
怎么在照明控制中对接智能硬件来实现远程打开关闭单路照明
查看 >>
怎么在共享台球室包间门禁控制中对接智能硬件来实现单路照明或门禁控制
查看 >>