智能断路器60A的对接核心在于通过HTTP请求调用芯步的开放接口,实现电路状态的实时反馈与控制。以下方案涵盖接口调用流程、状态反馈机制及典型场景实现。
解决方案:基于芯步开放接口对接智能断路器60A实现电路状态反馈与控制
1. 概述
芯步的智能大功率断路器60A(型号:UNI-DLQ-M-60A)适用于工厂、机房或大型设备电路保护。本方案的目标是指导开发者如何利用其开放 API,通过 HTTP/HTTPS 请求,实现对设备状态的获取(反馈)以及对电路通断的控制(分合闸)。
核心优势:
无网关依赖:设备直连 WiFi 2.4G。
接口标准化:采用 HTTP 协议,与编程语言无关。
实时性:支持秒级指令下发与状态同步。
2. 对接前准备
在开始编码前,您需要完成以下准备工作以获取必要的凭证:
获取 AppID 与 AppSecret
登录芯步物联网控制台。
进入“开发设置”页面,获取开发者ID(AppID)和密码(AppSecret)。这是后续接口鉴权的核心参数。
设备配网与 ID 获取
参照产品手册为 60A 断路器通电并配置 Wi-Fi。
在控制台的“设备列表”中找到该设备,记录下唯一的 设备ID(或设备编号)。
查阅指令集
在设备详情页的产品手册中,确认该型号断路器的控制指令(例如:
power=1代表开启/吸合,power=0代表关闭/断开)。
3. 接口鉴权与安全机制
为防止接口被恶意调用,芯步采用 动态签名 机制。每次请求需携带 sign 和 ts 参数。
签名算法核心要素:AppID、AppSecret、请求数据Body、时间戳(ts)。
本地测试:在开发阶段,可在控制台“开发设置”中开启 调试模式。该模式下系统将暂时忽略签名和时间的校验,方便快速验证业务逻辑。上线前请一定要关闭并严格校验签名。
4. 电路状态反馈与控制实现
本方案主要分为单向控制和状态同步两个环节。
4.1 下发控制指令(断开/闭合电路)
通过调用“执行命令”接口,修改设备的 power 属性。
请求地址
http(s)://api.thingboot.com/{AppID}/tag/control/请求方法:POST(推荐,参数较长时)或 GET
核心参数
device_id:目标断路器的ID。power1为闭合(通电),0为断开(断电)。
代码逻辑示例(伪代码思路):
构建 JSON 请求体
{"device_id": "设备ID", "power": 1}。加入时间戳和生成的签名。
发送 HTTPS 请求。
接收返回结果,
code 200表示指令下发成功。
4.2 电路状态反馈获取
电路状态的反馈通常有两种获取方式,推荐使用第一种以实现实时监控:
方式 A:被动接收(消息推送)当断路器因本地手动操作、过载跳闸或远程控制导致状态变化时,平台会主动推送状态数据到您预设的服务器地址(需在控制台配置消息接收URL)。推送内容示例:包含设备ID、当前状态(power值)、电压、电流等实时读数。
方式 B:主动查询(设备详情接口)如果无法配置公网接收服务器,可以采用轮询方式,主动调用接口查询设备最新状态。
5. 关键场景应用详解
5.1 强制断电与恢复
场景:工厂设备出现异常高温,需紧急断电,故障排除后远程恢复。实施
断电:调用接口下发
power=0。失败时增加重试机制(如间隔5秒重试3次)。状态监控:若开启消息推送,会收到设备返回的
power状态变更为0的确认信息。恢复:维修完成后,下发
power=1。
5.2 定时或自动化策略
虽然标准 API 可用于单次控制,但复杂的自动化(如“每晚11点断电”)利用芯步控制台内置的 场景联动 或 定时任务 功能。
做法:在云端配置规则,到时间自动触发接口调用,减少本地服务器负担。
5.3 局域网本地控制(私有化部署)
适用场景:工厂内网不允许连接外网,或要求极低延迟。方案:该60A断路器支持 私有化部署 和 自建消息服务器。
设备可配置为仅与本地局域网内的 MQTT Broker 或 HTTP Server 通信,完全脱离外网运行。
6. 异常处理与调试技巧
在对接过程中,若遇到指令执行失败,请按以下清单排查:
签名错误 (code 50xx):检查 AppSecret 是否复制了多余空格,确认参数排序规则。
设备离线 (code 504)
检查设备指示灯状态,确认 2.4G Wi-Fi 密码是否含特殊字符(简化测试)。
确认设备是否开启了5G Wi-Fi(仅支持2.4G)。
指令无法识别
确认使用的命令字段名是否为
power(部分老型号可能不同,需查阅该设备的产品手册)。使用控制台的“设备调试”功能先行测试指令格式。
网络延迟:若身处复杂电磁环境,可利用设备多Wi-Fi热备功能,预设多个信号源。
7. 总结
对接芯步智能断路器60A的核心在于 “HTTP指令调用” 与 “状态回调监听” 。开发者只需掌握基础的 REST API 调用逻辑,即可在10分钟内完成从注册到首次控制的全流程。对于高安全要求的工业场景,其私有化部署能力提供了充分的灵活性。