智能大功率断路器[计量版]|60A 的对接核心在于利用芯步开放的 HTTP API 接口。整个过程分为三步:设备配网接入、签名计算调用、命令下发执行。以下方案涵盖设备准备、接口调用流程以及定时/计量功能的实现逻辑。
解决方案:对接智能大功率断路器[计量版]|60A 实现远程定时通断控制
1. 概述
本方案基于芯步开放的 HTTP API 接口,通过标准的 POST 请求,实现对型号为 UNI-DLQ-M-60A-P 的智能大功率断路器进行远程控制。
该方案具有以下特点:
无网关依赖:设备直连 WiFi 2.4G 网络。
接口通用性:支持任何支持 HTTP 请求的编程语言(Python, PHP, Java, Go, C# 等)及环境(Web, APP, 小程序, SaaS)。
低延迟响应:命令下发到设备执行约 80-120ms。
灵活部署:支持公有云调用,也支持纯局域网私有化部署。
2. 准备工作
在开始开发前,需要完成以下物理与账户准备:
硬件上电:按照产品说明书将断路器接入 60A 电路,并确保电源指示灯正常。
设备配网
下载“芯步”小程序或登录官网物联网控制台。
通过“网络配置”功能,将现场 2.4G WiFi 的名称和密码推送至设备进行认证联网。
配网成功后,设备在控制台列表中显示为“在线”状态,并获取唯一的 设备ID(Device ID)。
获取密钥
注册并登录芯步官网。
在“开发设置”中获取 AppID 和 AppSecret(开发者密码),用于生成接口签名。
3. 接口鉴权机制
所有 API 调用均采用动态签名鉴权,计算公式如下,这一机制确保了接口调用的安全性,防止非法访问
参数准备
AppSecret:从控制台获取的密码。ts:当前的 Unix 时间戳(秒级)。
计算步骤
第一步:
step1 = md5(AppSecret)第二步:
sign = md5(step1 + ts)
拼接 URL
http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}
注:所有请求必须包含合法的签名和时间戳,且时间戳与服务器时间误差不宜过大。
4. 核心控制指令实现
本设备的控制核心是向其 order 字段下发特定的 JSON 指令。
| 功能类型 | 指令格式 (JSON) | 功能说明 |
|---|---|---|
| 即时控制 | {"power": 1} | 开启输出,线路导通 |
| 即时控制 | {"power": 0} | 关闭输出,线路断开 |
| 定时(倒计时) | {"reset": 3600000} | 立即断开,并将在 3600000毫秒(1小时)后自动闭合 |
| 定时(倒计时) | {"point": 5000} | 立即闭合,并将在 5000毫秒(5秒)后自动断开 |
| 系统管理 | {"system": "restart"} | 软重启设备 |
以下以几种常见的开发场景举例:
第一种场景:即时控制(Python 示例)该示例实现了请求签名的自动计算,并发送一条“闭合”命令,是远程控制中最基础的操作。
第二种场景:带计量的定时任务断路器支持在命令中直接携带 reset 或 point 参数,无需在服务器端维护定时任务队列,极大简化了系统复杂度。
说明:执行上述命令后,断路器将立即断开电路,同时在 2 小时(7200000毫秒)后自动重新闭合,适用于需定时复位的充电桩或设备测试场景。
5. 数据采集与状态同步
除了控制通断,该“计量版”产品的核心价值在于数据反馈:
主动查询需要获取实时电流电压时,可以下发查询指令,设备会返回当前的计量数据。
被动上报在服务器配置消息推送接收端。当断路器状态改变(如本地手动拨动开关)或达到计量阈值时,平台会主动向配置的 URL 推送状态变更消息。
事件示例:设备上报实时功耗、电压、电流值;设备物理按钮
btn1被按下的触发事件。
6. 注意事项与优化
网络稳定性:60A 断路器常用于大功率主干线路,确保 WiFi 信号强度在 70% 以上。设备支持配置 5 组备用 WiFi,将周边稳定信号全部录入,增强网络容错能力。
私有化部署:若对数据安全要求比较高(如工业内网),可联系芯步技术人员获取私有化部署包。所有 API 接口逻辑与公网一致,仅需修改请求 HOST 为本地服务器 IP。
按钮行为自定义:设备的物理按钮支持功能自定义。可将其配置为“禁用”,以防止现场人员误触导致大功率设备意外断电造成事故。