CATALOG

智能断路器60A的对接核心在于通过HTTP请求调用芯步的开放接口,实现电路状态的实时反馈与控制。以下方案涵盖接口调用流程、状态反馈机制及典型场景实现。

解决方案:基于芯步开放接口对接智能断路器60A实现电路状态反馈与控制

1. 概述

芯步的智能大功率断路器60A(型号:UNI-DLQ-M-60A)适用于工厂、机房或大型设备电路保护。本方案的目标是指导开发者如何利用其开放 API,通过 HTTP/HTTPS 请求,实现对设备状态的获取(反馈)以及对电路通断的控制(分合闸)。

核心优势:

  • 无网关依赖:设备直连 WiFi 2.4G。

  • 接口标准化:采用 HTTP 协议,与编程语言无关。

  • 实时性:支持秒级指令下发与状态同步。

2. 对接前准备

在开始编码前,您需要完成以下准备工作以获取必要的凭证:

  1. 获取 AppID 与 AppSecret

    • 登录芯步物联网控制台。

    • 进入“开发设置”页面,获取开发者ID(AppID)和密码(AppSecret)。这是后续接口鉴权的核心参数

  2. 设备配网与 ID 获取

    • 参照产品手册为 60A 断路器通电并配置 Wi-Fi。

    • 在控制台的“设备列表”中找到该设备,记录下唯一的 设备ID(或设备编号)。

  3. 查阅指令集

    • 在设备详情页的产品手册中,确认该型号断路器的控制指令(例如:power=1 代表开启/吸合,power=0 代表关闭/断开)

3. 接口鉴权与安全机制

为防止接口被恶意调用,芯步采用 动态签名 机制。每次请求需携带 signts 参数。

  • 签名算法核心要素:AppID、AppSecret、请求数据Body、时间戳(ts)。

  • 本地测试:在开发阶段,可在控制台“开发设置”中开启 调试模式。该模式下系统将暂时忽略签名和时间的校验,方便快速验证业务逻辑。上线前请一定要关闭并严格校验签名

4. 电路状态反馈与控制实现

本方案主要分为单向控制和状态同步两个环节。

4.1 下发控制指令(断开/闭合电路)

通过调用“执行命令”接口,修改设备的 power 属性。

  • 请求地址http(s)://api.thingboot.com/{AppID}/tag/control/

  • 请求方法:POST(推荐,参数较长时)或 GET

  • 核心参数

    • device_id:目标断路器的ID。

    • power1为闭合(通电),0为断开(断电)。

代码逻辑示例(伪代码思路):

  1. 构建 JSON 请求体 {"device_id": "设备ID", "power": 1}

  2. 加入时间戳和生成的签名。

  3. 发送 HTTPS 请求。

  4. 接收返回结果,code 200 表示指令下发成功。

4.2 电路状态反馈获取

电路状态的反馈通常有两种获取方式,推荐使用第一种以实现实时监控:

方式 A:被动接收(消息推送)当断路器因本地手动操作、过载跳闸或远程控制导致状态变化时,平台会主动推送状态数据到您预设的服务器地址(需在控制台配置消息接收URL)。推送内容示例:包含设备ID、当前状态(power值)、电压、电流等实时读数。

方式 B:主动查询(设备详情接口)如果无法配置公网接收服务器,可以采用轮询方式,主动调用接口查询设备最新状态。

5. 关键场景应用详解

5.1 强制断电与恢复

场景:工厂设备出现异常高温,需紧急断电,故障排除后远程恢复。实施

  1. 断电:调用接口下发 power=0。失败时增加重试机制(如间隔5秒重试3次)。

  2. 状态监控:若开启消息推送,会收到设备返回的 power 状态变更为 0 的确认信息。

  3. 恢复:维修完成后,下发 power=1

5.2 定时或自动化策略

虽然标准 API 可用于单次控制,但复杂的自动化(如“每晚11点断电”)利用芯步控制台内置的 场景联动定时任务 功能。

  • 做法:在云端配置规则,到时间自动触发接口调用,减少本地服务器负担。

5.3 局域网本地控制(私有化部署)

适用场景:工厂内网不允许连接外网,或要求极低延迟。方案:该60A断路器支持 私有化部署自建消息服务器

  • 设备可配置为仅与本地局域网内的 MQTT Broker 或 HTTP Server 通信,完全脱离外网运行

6. 异常处理与调试技巧

在对接过程中,若遇到指令执行失败,请按以下清单排查:

  1. 签名错误 (code 50xx):检查 AppSecret 是否复制了多余空格,确认参数排序规则。

  2. 设备离线 (code 504)

    • 检查设备指示灯状态,确认 2.4G Wi-Fi 密码是否含特殊字符(简化测试)。

    • 确认设备是否开启了5G Wi-Fi(仅支持2.4G)

  3. 指令无法识别

    • 确认使用的命令字段名是否为 power(部分老型号可能不同,需查阅该设备的产品手册)。

    • 使用控制台的“设备调试”功能先行测试指令格式

  4. 网络延迟:若身处复杂电磁环境,可利用设备多Wi-Fi热备功能,预设多个信号源

7. 总结

对接芯步智能断路器60A的核心在于 “HTTP指令调用”“状态回调监听” 。开发者只需掌握基础的 REST API 调用逻辑,即可在10分钟内完成从注册到首次控制的全流程。对于高安全要求的工业场景,其私有化部署能力提供了充分的灵活性。

断路器产品方案:
如何接入35A大功率智能断路器以实现过流自动断电控制
查看 >>
校园设备电源控制:怎样将60A联动控制智能空开接入到软件项目中
查看 >>
宿舍楼限电控制:怎么将20A大电流智能断路器对接到软件项目中
查看 >>
便利店收银机电源管理:怎么将40A带计量数显智能空开集成到软件项目中
查看 >>
如何二次开发智能大功率断路器计量版50A来实现短路保护控制
查看 >>
电路场景方案:
共享充电宝柜电路管理:怎样将60A带计量数显远程智能空开对接到项目中
查看 >>
共享台球室电路保护:如何将25A额定 5500W 断路器对接到项目中
查看 >>
怎样在自动贩卖机电路管理中对接智能硬件以实现过流自动断电控制
查看 >>
小型商铺总控电路:怎么将20A联动控制智能空开对接到自己的项目中
查看 >>
园区路灯电路管理:怎样把20A智能限流断路器对接到项目中
查看 >>
反馈用途方案:
怎么在景观亮化工程电源管理中接入智能硬件来实现电路状态反馈控制
查看 >>
如何在共享充电站照明管理中对接智能硬件来实现照明状态反馈控制
查看 >>
怎么在调度站语音播报中接入智能设备以实现设备状态语音反馈
查看 >>
怎样对接20W壁挂TTS语音播放器以实现设备状态语音反馈
查看 >>
如何在车间设备机柜电源控制中对接智能设备来实现线路状态反馈控制
查看 >>