CATALOG

20A远程控制断路器是工业自动化、智能楼宇、充电桩运营等场景中常用的设备。以下方案基于芯步AC4-20A智能通断器的开放接口,梳理从硬件选型到接口对接的完整路径。

1. 背景与选型分析

在许多工业及商业场景中(如电机控制、水泵管理、充电桩运营、老旧小区电改),传统的机械断路器已无法满足精细化管理需求。为了实现 “可视化、可遥控、可自动化” 的电源管理,引入支持API接口的智能断路器成为最佳选择。

推荐硬件:芯步智能通断器 AC4-20A针对20A大功率电流的应用需求,我们选择该型号作为核心执行单元。其关键特性如下

  • 电气参数:额定电流20A,总额定功率高达4400W,足以覆盖大部分工业及商业大功率负载。

  • 控制能力:支持远程通断控制,且具备“按钮动作可自定义/可屏蔽”功能,防止现场误触。

  • 核心优势开放HTTP API接口。这意味着设备不仅能用手机App控制,更能直接通过代码集成到自有系统(如ERP、MES、物业管理后台)。

  • 网络适应性:支持局域网(LAN)通信和私有化部署,保障了数据安全与控制时效性,不依赖外网即可联动。

2. 整体设计

为了将AC4-20A断路器无缝对接到您的自有项目中,推荐采用 “设备+物联网平台+业务系统” 的三层架构。

  1. 感知层:部署AC4-20A断路器,替代原有老旧开关,接入现场2.4G WiFi网络。

  2. 平台层(芯步云/私有化服务器) :设备在此注册,并开放HTTP API接口。这是对接的桥梁,负责处理协议转换和设备状态缓存。

  3. 应用层(您的项目) :您的Web端后台、APP服务器或自动化脚本,通过调用标准HTTP请求,实现指令下发与数据读取。

3. API对接核心流程

芯步的开放接口设计遵循RESTful风格,主要涉及设备控制、状态查询及消息推送三个维度。

3.1 鉴权与初始化

在调用接口前,您需要在芯步控制台获取唯一的身份标识。所有接口均需携带以下参数进行身份验证

  • AppID:您的应用唯一ID。

  • Sign:根据参数生成的签名串,用于防止篡改。

  • Ts:时间戳,用于防止重放攻击。

请求地址示例结构:http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

3.2 核心接口:远程控制通断

这是项目中最高频的操作。您只需要向指定URL POST一个JSON数据包,即可控制千里之外的电路闭合。

需求场景:在管理后台点击“紧急关闭”按钮,切断某台大功率设备电源。

对接实现后台系统构造如下HTTP请求,包含目标设备ID(device)和动作指令(order)。

控制闭合/断开的代码逻辑示意

系统收到指令后,通常在80-120ms内即可完成断路器的动作响应

3.3 状态同步机制:实时获取电流与开关状态

对于电源管理项目,实时了解当前功耗和开关状态至关重要。平台提供了两种获取方式:

  1. 主动查询:您的服务器调用设备状态查询接口,获取断路器当前的开关状态及实时负载(需设备支持计量功能,基础通断器支持状态反馈)。

  2. 被动接收(消息推送) :这是一种更高效的方式。您需要在项目中配置一个接收URL(Webhook)。当断路器状态发生变化(如因过载跳闸或被人按动)时,平台会主动将事件推送到您的服务器,实现实时告警

3.4 高级应用:定时与联动

利用开放接口,您可以轻松构建自动化逻辑,而无需依赖App内置的简单定时。

  • 定时任务:您的服务器通过定时器(如Cron Job)在特定时间(如夜间23:00)调用关闭接口,实现全校或全厂的统一断电管理。

  • 环境联动:结合芯步的传感器(如温度/烟雾传感器)。当传感器检测到机房温度过高时,您的系统逻辑判断后,自动调用断路器的接口切断电源,实现保护

4. 项目实施实战步骤

第一步:硬件安装与配网

  1. 断电接线:严格遵循产品手册,将AC4-20A串入20A电路中。注意火线零线的进出方向(一般为上进下出),接线完成前请一定要保持电源关闭

  2. 网络配置

    • 设备仅支持2.4G WiFi。

    • 通过“芯步小程序”或“PC物联网控制台”进行配网,将现场WiFi凭证写入设备

    • 小技巧:现场WiFi信号强度直接决定控制稳定性,安装位点信号强度高于-70dBm。

第二步:在控制台注册与调试

  1. 登录芯步官网,在“物联网控制台”中确认新上线的断路器显示为“在线”状态。

  2. 利用控制台自带的“API调试工具”直接下发命令,验证网络连通性。

第三步:业务系统开发集成

  1. 查阅文档:对接官方提供的《设备接口调用代码示例》,通常包含Java、Python、PHP等主流语言版本

  2. 封装SDK:在项目中封装断路器控制类,包含connect()disconnect()getStatus()三个基础方法。

  3. 异常处理:请一定要编写针对“设备离线”或“签名错误”的异常捕获逻辑,增强系统的健壮性。

5. 关键注意事项

  • 私有化部署考量:如果您的项目运行在纯内网环境(涉密或工业内网),芯步支持将接口私有化部署到您的Linux服务器上,此时控制指令不经过公网,时延更低且更安全

  • 安全性:虽然按钮可屏蔽,但在设计控制逻辑时增加“二次确认”弹窗,避免误操作导致生产事故。

  • 互锁机制:如果在项目中涉及电机正反转控制,必须通过物理线路互锁,软件逻辑仅作为辅助控制,不可完全替代物理安全措施。

6. 总结

通过将芯步AC4-20A智能断路器接入您的项目,原本需要现场合闸的繁琐工作将转变为毫秒级的API调用。本方案利用了设备开放、标准的HTTP接口,使得即使是复杂的电源管理逻辑——无论是基于时间的峰谷电价控制,还是基于传感器的安全联动——都能通过简单的代码实现,极大降低了研发成本和维护难度。