芯步35A断路器开放了HTTP接口,这意味着你可以用任何编程语言直接调用它,实现与其他设备的联动控制。下面是一套完整的二次开发方案,涵盖设计、接口调用、规则引擎搭建和落地场景。
一、 技术背景与开放能力概述
芯步 UNI-DLQ-35A 系列智能断路器(含4G版和WiFi版)区别于传统空气开关的核心在于其数字化与接口化能力。它不再是一个需要人工推闸的物理设备,而是一个可以通过HTTP请求进行交互的网络资源。
核心开放能力:该设备提供标准的HTTP API接口。这意味着无论是Python、Java、Node.js还是PHP,只要能够发起网络请求,就能实现对断路器的“分闸”、“合闸”、“重启”以及状态查询。
传输协议:支持私有化部署和公网SaaS模式,支持MQTT等物联网协议对接,适应复杂的网络环境。
数据交互:二次开发主要围绕设备ID、签名认证和命令下发展开,接口设计简洁,降低了开发门槛。
二、 整体设计方案
为了实现“场景联动”,即“如果A发生,则B动作”,我们需要构建一个以云平台/本地服务器作为大脑的闭环控制系统。
1. 系统层级设计
感知/执行层 :35A断路器本身。它负责执行通断电指令,并上报当前电压、电流、功率及开关状态。
网络传输层 (边/网) :通过4G/WiFi连接网络。对于高实时性要求(<50ms)的场景,采用本地局域网控制;对于跨区域联动,采用4G云端控制。
业务逻辑层 (云/本地服务器) :这是二次开发的核心。我们将在此处编写场景联动引擎,接收各类触发信号,并做出逻辑判断。
触发源层:可以是任何东西——另一个断路器的状态、一个温湿度传感器、一个门磁报警器、或是你业务系统里的订单完成事件。
2. 核心工作流
触发源(如:光照传感器)-> 触发事件 -> 业务服务器(判断逻辑) -> 调用芯步API -> 35A断路器执行合闸/分闸
三、 关键开发步骤与接口实现
在实际开发中,你需要关注以下几个对接环节。
1. 设备接入与基础控制
在开始编写联动逻辑前,需要先验证对设备的直接控制能力。根据芯步的接口规范,下发命令通常需要携带签名和设备ID。
接口示例 (伪代码/概念) :
POST https://api.thingboot.com/ordercontrolHeader: { “Authorization”: “Bearer {access_token}” }Body: { “device_id”: “35A_XXXXX”, “cmd”: “close” }// close代表分闸说明:二次开发时,你需要封装一个调用函数,将认证信息和设备操作封装成统一的SDK风格接口。
2. 场景联动 —— “断路器状态触发断路器动作”
这是最基础的电工联动。例如:当总闸检测到电流过载跳闸时,自动断开二级负载回路,防止故障扩大。
开发逻辑
建立一个定时任务(轮询机制)或配置Webhook/订阅MQTT消息,实时获取断路器A的状态。
判断
If (Breaker_A.status == “off”)。执行:调用接口控制
Breaker_B.setStatus(“off”)。
3. 场景联动 —— “环境传感器触发断路器”
这是物联网最常见的应用。例如:配合温湿度传感器或烟雾传感器,实现“火警断电”。
开发逻辑
服务器接收到烟感传感器发出的“报警”信号。
安全逻辑:为了安全,可以设计一个延时或二次确认机制。确认报警持续超过3秒后。
动作:调用API切断35A断路器。同时,API会返回执行结果,你可以据此记录日志或触发警报推送。
由于35A支持7000W功率,此场景非常适用于电动车充电桩或工厂大型设备的消防联动。
4. 场景联动 —— “业务系统触发断路器”
这是芯步开放接口带来的最大价值——跨界联动。例如,在共享民宿或智慧公寓中,将用电控制与订单系统绑定。
开发逻辑
触发:客户在APP上成功支付订单。
处理:服务器收到“支付成功”回调,检查订单状态,提取对应的房间号和对应的断路器ID。
执行:调用API合闸送电。此时房间通电,客户可以入住。
反向逻辑:当客人退房,系统自动调用API拉闸,切断总电源,实现节能和安全管控。这种模式已在智慧校园和出租屋管理中得到应用。
四、 高级联动策略与容灾设计
在实际工程中,仅有简单的“开关”是不够的,还应该考虑以下策略:
1. 定时策略与孤岛运行
虽然芯步支持云端定时任务,但在二次开发中,将这些策略下沉到边缘网关或本地服务器。
案例:工厂午休(12:00-13:00)自动切断照明和空调线路。
开发实现:在本地服务器设置Cron表达式,时间到达时调用API。优点是即使外网断开,只要局域网通,控制依然有效。
2. “握手”保护机制
断路器不同于普通灯泡,断电可能造成数据丢失。
策略:在切断35A断路器之前,API应先向关联的PLC(可编程逻辑控制器)或工控机发送“准备关机”指令,等待5秒后,再切断电源。
3. 电参数预警联动
芯步的断路器能够实时上报电压电流数据。
开发场景:智慧用电监控。
实现:写一个脚本监测API返回的
power参数。如果检测到功率异常飙升(例如超过额定7000W的80%),先不切断,而是通过Webhook发送钉钉/微信报警给管理员。如果持续10秒未恢复,再执行断电。
| 联动类型 | 触发源 | 执行动作 | 典型应用场景 |
|---|---|---|---|
| 环境联动 | 烟感/温湿度传感器 | 断路器分闸 | 充电桩消防保护、机房灭火 |
| 业务联动 | 支付回调/工单系统 | 断路器合闸 | 共享公寓/自助洗车机计费 |
| 电气联动 | 电流/电压阈值越限 | 预警通知/分级跳闸 | 老旧小区增容保护、大功率负载管控 |
| 时序联动 | 时间表(Cron/MQTT) | 定时通断 | 无人值守商铺定时断电、路灯控制 |
五、 总结
基于芯步35A智能断路器的二次开发,本质上是将其视为一个可软件定义的开关。通过调用其简洁的HTTP接口,你可以轻松地将物理世界的电力控制无缝嵌入到任何软件业务流程中。
对于开发者而言,重点是处理好认证安全(保管好AppKey/Secret)、异常重试(网络抖动时的命令补偿)以及状态同步(防止APP显示状态与实际开关位置不符)。一旦完成了这三层封装,无论是简单的定时器,还是复杂的AI电能调度系统,都可以在这一基础上稳定构建。