芯步60A带计量智能断路器支持HTTP API直接控制,可通过签名鉴权方式实现电路状态反馈与远程通断管理。以下方案涵盖接口对接流程、状态获取机制及典型应用场景。
1. 产品概述与核心能力
芯步 智能大功率断路器[计量版] (型号:UNI-DLQ-M-60A-P) 是一款支持 60A 大电流的智能空开设备。该设备具备以下核心对接能力:
通信方式:直连 WiFi 2.4G,无需网关,降低硬件成本与部署复杂度。
接口协议:提供全开放 HTTP API,支持任何支持 HTTP 请求的编程语言(Java, Python, Node.js, PHP 等)。
部署模式:同时支持公有云调用与私有化部署(局域网纯环境),适应企业内部高安全需求。
计量功能:虽搜索结果未明确列出该型号具体的电参量寄存器,但“计量版”通常意味着支持电压、电流、功率、电量等数据的实时读取,用于能耗分析。
2. 对接技术架构
2.1 接口鉴权机制
芯步的 API 采用动态签名验证,提高接口安全性。核心在于正确生成 sign 参数。
签名生成规则sign = md5( md5(AppSecret) + ts )
参数说明
AppSecret: 开发者密码(在平台控制台获取)。
ts: 当前 Unix 时间戳(秒)。
2.2 核心 API 端点
| 功能描述 | Method | URL/Data 结构 |
|---|---|---|
| 设备控制 | POST | https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts} |
| 请求体 | JSON | { "device": "设备ID", "order": {命令} } |
注:设备的唯一 ID (Device ID) 可在物联网控制台查看。
3. 全流程对接步骤
3.1 开发准备
注册芯步账号并创建工作台。
进入“物联网控制台”,获取
AppId和AppSecret。确保 60A 断路器已上电并配置好 WiFi 网络。
3.2 电路状态反馈与数据获取
针对“电路状态反馈”,你需要获取两类核心数据:
1. 开关状态反馈断路器会实时上报当前的通断电状态。为了获取最新状态,通常有两种方式:
主动查询: 调用设备状态查询接口(具体命令需查阅产品手册),获取
power或status字段。被动接收: 配置消息推送。在控制台设置接收服务器 URL,断路器状态变化时(如本地手动推杆、过载跳闸),平台会主动向你的服务器推送状态变更数据,实现实时反馈。
2. 电力计量数据获取要获取电流、电压、电量数据以实现“计量”功能,主要依赖查询接口的返回字段。针对 UNI-DLQ-M-60A-P 型号,预期返回的 JSON 数据中应包含:
voltage: 电压值 (V)current: 电流值 (A)power: 有功功率 (W)energy: 累计电量 (kWh)
(注:具体字段名以实际产品手册为准)。
3.3 远程控制实现
以下为控制断路器通断的底层逻辑实现:
下发命令:向设备发送
{"power": 1}代表合闸/开启,{"power": 0}代表分闸/关闭。批量控制
device字段支持传入多个 ID(用逗号分隔),实现一键断电场景。例如:"device": "ID1,ID2,ID3"。
3.4 代码实现示例
以下代码展示了如何封装签名并发起控制请求。
Python 示例
3.5 错误处理
签名错误:检查
md5结果是否为 32 位小写,以及时间戳ts是否与签名计算时一致。设备离线:如果设备 WiFi 不稳定,控制指令将无法送达,代码中应增加重试机制。
4. 高级应用场景方案
4.1 定时与能耗联动
利用获取到的计量数据,可实现智能化闭环控制:
场景 A(超载预警告警):轮询读取
current值,若电流 > 55A(预警线),发送短信通知管理员;若 > 60A,自动执行{"power": 0}强制断电,保护线路。场景 B(能耗双控):读取
energy日用电量,若超过定额(如 100kWh),自动切断非关键回路。
4.2 局域网私有化部署
针对工厂或机房等对稳定性要求比较高的场景,芯步支持局域网纯环境部署。
操作:在内网服务器上搭建服务,API 请求地址替换为设备在内网的 IP 或私有化网关地址。
优势:即使外网断开,服务器依然能控制断路器状态及读取计量数据。
5. 总结
对接芯步 60A 智能断路器(计量版)的关键在于签名算法的正确实现和状态上报接口的部署。
控制链路:业务系统 -> HTTP API(签名) -> 云端/局域网 -> 断路器(执行分/合闸)。
反馈链路:断路器(传感器采集) -> 云端(解析) -> 业务系统(存储/展示/告警)。
开发者仅需关注 HTTP 协议层面的交互,无需处理复杂的无线通信底层逻辑。通过上述方案,可快速将该设备集成到现有的智慧用电、基站监控或工厂能耗管理系统中。