芯步60A导轨式智能断路器的开放接口基于HTTP协议，签名机制清晰，支持远程通断控制、定时任务和状态反馈。以下方案涵盖接口接入、命令下发、状态获取及典型场景实现。

1. 产品与接口概述

芯步的60A智能断路器（型号如UNI-DLQ-M-60A）是一款支持WiFi直连的导轨式大功率设备，无需网关即可接入网络。其核心开放能力基于HTTP接口，具有以下特点：

• 接口地址https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

• 请求方式：POST

• 数据格式：JSON

• 签名机制：MD5双重加密，保证接口调用安全

• 设备响应时间：约80-120ms，满足实时控制需求

要实现“电路状态反馈控制”，意味着系统不仅能下发“通”或“断”的指令，还能实时获知断路器当前的开关状态、电量参数（如电压、电流、功率），并根据这些状态触发相应的自动化逻辑。

2. 准备工作：获取密钥与设备ID

在开发前，需要准备以下信息：

1. AppID 和 AppSecret：登录芯步控制台，在“开发设置”页面获取。

2. 设备ID (Device ID)：在控制台设备列表或设备外壳标签上获取。

3. 网络配置：确保断路器已通过WiFi 2.4G网络联网（蓝灯常亮或快闪状态）。

3. 核心开发：签名生成与接口调用

3.1 签名算法

这是接口调用的安全门槛。签名的计算规则如下：

• ts：当前的Unix时间戳（秒级，10位数字）。

• md5()：标准的32位小写MD5加密函数。

示例说明假设 AppSecret = “abc123”，当前时间戳 ts = “1704067200”。

1. 计算 md5(AppSecret) = md5(“abc123”) = e99a18c428cb38d5f260853678922e03。

2. 拼接字符串得到：e99a18c428cb38d5f260853678922e03 + 1704067200。

3. 计算最终签名：Sign = md5(“e99a18c428cb38d5f260853678922e031704067200”) = 6bb21e9c6c8a0c9d6b7a8b5c4d3e2f1a。

3.2 下发控制命令

这是实现“控制”的核心。60A断路器主要支持以下命令格式

基础通断控制

复杂电路保护逻辑断路器支持“先通后断”或“先断后通”的时序控制，这在切换电机正反转或进行设备复位时非常实用。

• 先断后通 (复位)：先断开电路，等待设定时间（毫秒）后自动重新接通。常用于需要重启的路由器、通信设备。

  {"reset": 5000} // 立即断开，5秒（5000毫秒）后重新通电

• 先通后断 (点动)：瞬间通电后断开。常用于测试或触发门禁电插锁。

  {"point": 1000} // 通电1秒，然后断开

代码示例：使用Python实现控制

4. 进阶实现：状态反馈与数据监控

仅下发指令是不够的，我们需要知道命令执行后电路是否真的响应了，或者查看实时的电流负载情况。

4.1 获取实时状态

对于计量数显版断路器（支持实时显示功率、电压、电流），可以通过特定的命令拉取设备当前状态，或者通过控制台API查询设备最新快照。

通常，获取状态可以通过两种途径：

1. 主动查询：调用设备信息查询接口（如拉取设备详情），获取 metering 数据。

2. 被动接收：配置消息服务器（私有化部署或公网回调）。当设备状态变化或达到阈值告警时，芯步平台会主动推送数据到指定的URL。

状态数据示例（基于计量版产品页面说明）：

注：具体字段需参阅设备对应的产品手册。

4.2 高级控制策略

结合状态反馈，可以在业务系统中实现闭环控制，例如：

• 超载自动断开：若监测到电流 > 55A 持续 10秒，自动执行 {“power”: 0} 并锁定，防止过载。

• 定时休眠：下发 {“power”: 0} 后，系统记录状态，并在特定时间段（如夜间）禁止自动开启。

5. 架构落地：三种典型的二次开发模式

根据应用场景的不同，可以选择不同的集成架构：

模式一：纯公网SaaS模式（最简单）

• 架构：业务系统服务器 -> 芯步开放API -> 设备。

• 适用：跨地域的设备管理（如分布式充电桩、全国连锁店灯光控制）。

• 优点：无需维护物联网设施，开发仅需HTTP请求。

• 注意：需遵守速率限制（1次/秒/设备）。

模式二：MQTT实时订阅模式（推荐用于实时性要求高的场景）

• 架构：业务系统 -> MQTT Broker () -> 设备。

• 适用：需要毫秒级状态同步或大规模设备群控（如工厂生产线）。

• 优势：发布/订阅模式解耦，无需轮询即可获取设备上报的状态数据。

• 认证Username = AppID， Password = AppSecret。

模式三：私有化局域网模式（最安全）

• 架构：业务系统 <-> 局域网路由器 <-> 设备。

• 适用：政府、军工、实验室等内网环境，或对公网依赖有严格限制的场所。

• 优点：所有API请求在内网完成，不经过外网，数据物理隔离且响应最快。

6. 总结

二次开发芯步60A智能断路器的核心在于利用其 标准HTTP API 实现业务逻辑与物理电路的联动。开发者只需关注签名算法与命令格式，即可快速集成。

一个完整的闭环控制流程如下：

1. 感知：业务系统通过API查询或MQTT订阅，获知断路器电流过高。

2. 决策：业务逻辑判断电流超限，触发保护阈值。

3. 执行：调用 {“power”: 0} 命令断开电路。

4. 反馈：再次查询状态确认“断开”成功，并向管理员发送告警。

通过这种方式，能将传统的配电元件无缝升级为可编程、可观测的智能节点，支撑各类能源管理与智能运维场景。