CATALOG

芯步的智能断路器开放标准HTTP接口,对接门槛很低——核心就是签名计算和设备命令下发。40A型号与20A产品使用同一套接口规范,以下方案可直接用于实际开发。

1. 核心对接原理

在开始编码前,需要明确一个概念:芯步的接口设计是“云云对接”或“应用直连”。你的服务器直接调用芯步的开放API,平台收到指令后会通过WiFi瞬间推送给现场的40A断路器。

整个流程遵循 HTTP POST 请求,数据格式为 JSON,签名算法为 MD5

1.1 接口地址结构

https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}
  • AppId:用于标识你的应用,在芯步控制台生成。

  • ts:当前Unix时间戳(秒),用于防重放攻击。

  • sign:签名,用于身份验证。

1.2 签名算法

这是对接中最关键的环节,签名生成规则如下:sign = md5( md5(AppSecret) + ts )即:先将你的密钥进行一次MD5,得到字符串A;再将字符串A与时间戳拼接,对拼接后的字符串再次进行MD5。

1.3 请求体

2. “远程参数配置”实战

对于大功率断路器(40A),远程参数配置并非简单的通断,而是包括:设置开机状态、配置按钮行为、设定过载阈值等。

以下通过具体的HTTP请求示例,展示如何在你的业务系统中实现这些功能。

2.1 基础环境准备

  • 编程语言:任意(以下以Bash + Curl为例,便于测试,可无缝转为Python/Java/Go)。

  • 前提

    1. 已注册芯步账号并获取 AppIdAppSecret

    2. 40A断路器已上电并配网成功

    3. 已知设备ID。

2.2 配置断路器参数

断路器内部有Flash存储,支持写入配置。虽然官方不在频繁读写场景下批量修改,但在运维调试时极为有用

第一种场景:配置“断电重启后”的状态

40A断路器通常用于充电桩、机房等关键设备。如果断电重启,你希望它是保持断开(安全)还是自动闭合(业务恢复)?

  • 配置项:开机状态 (relay1)

  • 目标:设置为 “通” ,即恢复供电后自动合闸。

  • 请求示例

第二种场景:配置“物理按钮”的行为

在40A设备上,物理按钮默认用于开关。但在某些不允许随意断电的场合,你需要屏蔽物理按钮,防止误触导致生产事故。

  • 配置项:按钮动作 (action1)

  • 目标禁用 物理按钮。

  • 请求示例

  • 扩展:如果只是希望长按才断电,可以配合 time1 参数设置延时(例如设置 time1:5000 代表长按5秒才动作)

第三种场景:设置超负荷断电阈值

虽然是40A断路器,但一些老旧线路可能在达到30A时就已发热严重。你可以远程调整其预警阈值(视固件支持情况,通常计量版支持):

2.3 配置“定时任务”与“自复位”(特色功能)

芯步的接口支持单次定时,这非常适合远程运维场景。

  • 场景:设备出现通讯故障,需要远程重启(断电再通电)。

  • 需求:断开10秒后自动重新接通,避免人员到场。

  • 指令reset 指令。

这种“先断后通”的模式非常适合远程重启路由器或死机的工控机。

2.4 主动查询运行数据

参数配置完成后,主动拉取一次设备状态,确认配置生效并监控电流。

  • 指令:查询瞬时数据(以智能通断器类产品通用指令为例)。

预期返回效果设备会返回当前 电压电流(40A量程下需要注意单位换算)、功率用电量

3. 开发集成步骤

如果你正在撰写正式的解决方案文档,将以下流程纳入其中:

第一步:环境搭建

  1. 登录芯步官网,进入控制台。

  2. 在“开发设置”中获取 AppIdAppSecret

  3. 在“设备管理”中记录下你要配置的那台40A断路器的 Device ID

第二步:核心代码封装

不在每个业务逻辑里都写一遍签名算法。应封装一个底层的 YoyoClient 类,负责处理签名计算和HTTP发送。

第三步:异常处理闭环

由于是远程配置,网络波动可能导致指令丢失或设备离线。

  1. 重试机制:单条指令发送失败后,间隔5秒重试3次。

  2. 日志审计:所有参数的修改(谁、在什么时间、把电流阈值改成了多少)必须有数据库记录,这是工业场景的合规要求。

4. 总结

芯步的40A断路器将复杂的物联网通信抽象成了简单的HTTP请求。开发者无需关心MQTT长连接或WiFi配网细节,只需要遵循 “签名计算 -> 构造JSON -> POST请求” 三步,即可完成对40A大功率设备的深度管理和参数配置。

无论是通过手机App、Web后台还是自动化脚本,这套方案都能显著降低硬件对接门槛,让开发者更专注于业务逻辑的实现。