CATALOG

芯步的智能断路器采用HTTP接口开放策略,这使得定时控制可以通过标准的云端API调用轻松实现,无需复杂的嵌入式开发。以下方案从硬件准备、接口调用逻辑到代码示例,完整说明如何搭建一个可靠的定时通断控制系统。

解决方案:基于芯步开放接口实现40A计量数显智能断路器定时通断控制

1. 解决概述

本方案的目标是利用芯步提供的标准HTTP开放接口,将型号为 UNI-DLQ-M-40A-PD 的智能大功率断路器(40A计量数显版)集成至用户的第三方系统(如自有云平台、手机APP或本地SCADA系统)中。

核心目标是实现通过软件程序对该断路器进行定时通断控制。方案采用了云端API调度+设备端执行的架构,用户无需维护底层通信协议,只需调用简单的HTTP接口即可完成电路的远程分合闸操作

2. 硬件与接口特性

  • 硬件型号:智能大功率断路器[计量数显版] 40A

  • 关键参数:额定功率8000W,支持导轨式安装,内置WiFi模块(2.4GHz),无需额外网关即可联网

  • 接口开放性

    • 协议:标准HTTP/HTTPS协议。

    • 鉴权:签名机制或Token鉴权。

    • 数据格式:JSON。

    • 特点:接口简单清晰,仅需携带设备ID和签名即可下发指令,支持Windows、Linux、Web及嵌入式系统调用

3. 技术实现原理

要实现定时控制,本质是利用程序的定时任务机制,在特定时间点向设备发送“通”或“断”的指令。

  • 架构模式:采用“请求-响应”模式。业务服务器作为客户端,芯步云平台作为服务端,断路器作为执行单元。

  • 控制链路:业务服务器 -> HTTP API -> 芯步云 -> WiFi -> 智能断路器(执行分合闸)。

  • 定时机制:利用操作系统的cron任务、编程语言自带的定时器(Timer)或第三方调度框架(如Quartz),在预定的时间触发HTTP POST请求。

4. 详细接入步骤

第一步:设备上电与配网

  1. 按照产品手册安装40A断路器,接通电源。

  2. 设备支持WiFi直连,通过芯步官方提供的配网工具(如微信小程序或配置工具),将设备连接至本地2.4G WiFi网络

  3. 记录下设备的唯一标识 Device IDAPI Key(通常在设备标签或配网成功后获得)。

第二步:接口鉴权与准备芯步开放接口通常需要在请求头(Header)中携带签名。通用的签名算法逻辑如下:

  • 参数device_id(设备ID)、timestamp(时间戳)、api_key(用户密钥)。

  • 签名生成:将参数按字典序排序后拼接,进行MD5或SHA256加密。

  • 注:具体签名规则请参考芯步官方最新的《HTTP接口对接文档》,不同批次的设备对签名时效性的要求可能不同。

第三步:控制指令下发(核心API)这是实现通断控制的核心接口,用于立即或受控地改变断路器的状态。

  • 接口地址https://api.yoyoiot.com/ordercontrol

  • 请求方法:POST

  • 请求参数示例(JSON Body)

  • 响应说明:接口返回{"code":200, "message":"success"}即代表指令已下发至云平台。

第四步:定时调度逻辑(以Python为例)在服务器端编写脚本,利用schedule库或系统cron实现无人值守的定时控制。

  • 应用场景:每天上午8:00自动通电,下午20:00自动断电。

  • 实现逻辑

  • 高精度延时的替代方案:若需要毫秒级或相对时间延时,可以在代码中利用threading.Timerasyncio.sleep来实现,例如闭合后延时2小时再断开

第五步:状态监测与反馈(进阶功能)由于设备是“计量数显版”,除了控制通断,还可以获取电量数据用于逻辑联动。

  • 查询电量接口:调用查询状态API获取实时电压、电流、功率数据。

  • 应用场景:设定“定时关断”的同时,可以设定“过载关断”作为保护。例如利用监控数据,若检测到设备虽然是通电状态但电流为0,可判定负载故障并报警

5. 技术参数配置

为了确保定时控制的稳定性和安全性,在部署时注意以下配置:

  • 断网重连机制:该设备支持自动重连WiFi,且支持设定5组备用WiFi网络,确保网络故障恢复后设备仍在线

  • 控制优先级与锁定:在高安全性场景下,可以利用本地锁定功能。如果本地手柄处于“锁定”状态,远程API下发的“定时断开”指令可能无效,这能有效防止远程误操作导致维修人员触电

  • 本地容错:虽然本方案依赖云端API,但设备本身内置时钟计时电路。对于精准的定时任务,通过服务器下发NTP时间校准指令,确保设备本地时间与服务器时间同步,避免因网络波动导致执行延迟

6. 常见问题与处理

  • 问:定时任务执行了,但设备没反应?

    • 排查:检查API返回码。如果返回成功但设备不动作,检查设备在芯步云平台的状态是否显示“离线”。如果是离线,检查本地WiFi信号强度,该设备对2.4G频段兼容性最佳

  • 问:如何实现循环定时(如每工作1小时停10分钟)?

    • 实现:不需要复杂的硬件逻辑,只需在代码中编写状态机。调用“合闸”API -> 延时3600秒 -> 调用“分闸”API -> 延时600秒 -> 循环调用。

  • 问:设备断电重启后会保持之前的定时状态吗?

    • 功能:设备具备上电状态自定义功能。可以配置为“断电恢复后保持断电”或“断电恢复后自动合闸”,根据你的场景(如无人值守机房)选择合适的默认状态

7. 总结

通过芯步开放的HTTP接口接入该40A断路器,开发者无需编写任何嵌入式设备端代码,只需关注业务层的定时逻辑。这种“设备云化”的方案极大降低了开发门槛,同时保证了8000W大功率负载控制的稳定性与安全性。