35A导轨式智能断路器支持通过HTTP接口进行远程控制和自定义联动开发。以下方案涵盖签名认证、单设备/批量控制、定时任务和传感器联动等核心场景,并提供Python和PHP代码示例。
解决方案:基于芯步35A导轨式智能断路器的自定义联动逻辑控制系统
1. 概述
本方案的目标是指导开发者如何利用芯步提供的开放API接口,对 UNI-DLQ-35A 型导轨式智能断路器(35A版本)进行二次开发。通过标准的HTTP协议,用户可以绕过传统的App手动控制,根据特定业务场景(如传感器触发、时间计划、设备状态联动)编写逻辑代码,实现对电力通断的自动化、智能化管理。
适用场景:
智慧充电桩/电动车棚: 检测到充满或过载,自动断电。
无人值守机房/基站: 环境温度过高或烟雾报警时,自动切断非关键设备电源并重启。
共享空间/智能家居: 结合人体传感器,实现“人走断电”节能控制。
工业自动化: 根据生产线PLC信号,联动控制断路器分合闸。
2. 核心设备与接口特性
35A导轨式智能断路器具备以下关键开放能力,是实现自定义逻辑的基石:
控制方式: Wi-Fi 2.4G直连,无需网关,降低架构复杂度。
接口协议: 全开放HTTP接口,支持任何编程语言(Python, Java, PHP, Node.js等)。
核心能力:
远程分合闸(开关)。
支持定时任务与自定义联动。
支持私有化部署与局域网纯环境运行,确保数据安全。
3. 接入准备
在开发之前,请准备以下信息(注册登录芯步控制台后获取):
AppID 与 AppSecret: 应用的唯一标识与密钥,用于生成签名。
设备ID (Device ID): 35A断路器的唯一编号(可在设备外壳或控制台查看)。
API 地址:
https://api.thingboot.com。
4. 自定义联动逻辑开发指南
本节将展示如何通过编写代码,将“事件”与“断路器动作”绑定。
4.1 基础认证(签名机制)
在调用接口进行控制前,必须解决认证问题。芯步接口使用 sign 和 ts(时间戳)进行防盗用验证。签名生成规则如下(以伪代码为例):
注:具体签名规则请严格参照官方最新文档,部分旧版示例可能不同,通过控制台验证。
4.2 实现单路及多路控制
35A断路器的主要操作指令通过 order 参数传递。
第一种场景:基础通断控制最简单的联动逻辑是直接下发“闭合”或“断开”命令。
API 路径
POST /{AppID}/device/control/请求体示例 (JSON)
由于35A通常控制大功率线路,部分型号可能支持单路或多路,具体字段名(如power1)请查阅设备的产品功能列表。
第二种场景:脉冲信号(点动)在测试电路或控制卷帘门、电机等设备时,通常需要“点动”功能(先合闸,延时,再分闸)。这可以通过自定义逻辑实现:
需求: 让断路器接通2秒后自动断开。
自定义逻辑代码(Node.js示例,基于
setTimeout) :
注:虽然部分产品手册提到了硬件级的point指令,但开发者自行在服务端实现逻辑拥有更高的灵活性和跨设备兼容性。
4.3 跨设备复杂联动
这是“自定义联动”的核心价值:A设备发生状态变化 -> 服务端接收并处理 -> 控制B设备。
典型场景:人流感应控制灯光/电源假设你有一个芯步的人体存在传感器和35A断路器。逻辑为:10分钟无人,自动断开断路器。
实现步骤(Webhook/消息推送模式):
接收消息:在芯步控制台配置“消息推送”地址(你的服务器公网IP或域名)。
解析数据:传感器检测到“无人”状态,平台会主动
POST数据到你的服务器。业务判断:你的服务端代码解析数据,判断是否连续触发无人状态。
下发指令:调用第4.2节中的控制接口,关闭断路器。
伪代码实现(处理传感器消息并联动断路器):
4.4 时间计划与定时任务
如果联动逻辑是基于时间的(例如:晚上11点自动断开充电桩电源),可以利用云平台提供的定时任务功能,也可以在你的服务器上使用Cron定时脚本调用API。
PHP示例(Cron Job):
5. 高级功能应用
5.1 分组控制
若需控制多个断路器(如整层楼的照明),在控制台将它们加入同一个分组。通过分组接口可一次指令控制所有设备,效率远高于循环单控。
请求地址
POST /{AppID}/group/control/请求参数
{"group":123, "power":"0"}(关闭整组)
5.2 状态反馈与可靠性
在自动化系统中,确认执行结果非常重要。
同步响应:API返回
200只代表指令被平台接收,不代表断路器已动作。异步确认:强烈配置消息推送服务。当断路器实际执行动作后(如合闸成功或跳闸),设备会上报最新状态,平台会推送到你的服务器,这才是真正的“闭环控制”。
6. 总结
通过接入芯步的开放接口,35A导轨式智能断路器不再是一个孤立的硬件,而是一个可编程的执行单元。开发者只需掌握 HTTP请求 与 JSON解析,即可构建出响应速度快、逻辑复杂的能源管理系统,实现从“人工运维”到“自动策略运维”的转变。
注:本文所述接口参数(如power1、batch结构)在不同固件版本中可能存在细微差异,开发调试时请以 最新页面参数为准。