50A导轨式智能断路器是工业级负载控制的常用设备,芯步提供了标准的HTTP API接口,对接的核心思路是:签名认证 → 指令下发 → 功率监测 → 联动控制。以下方案按开发流程展开。
1. 背景与目标
在工业自动化、基站能耗管理、智能楼宇等场景中,常常需要对大功率设备(如空调、电机、充电桩)进行远程通断电控制和功率限制。芯步推出的50A导轨式智能断路器(如UNI-DLQ-M-50A系列)提供了标准的HTTP API接口。
本方案的目标是指导开发者如何利用芯步开放平台,对接该型号断路器,实现额定功率负载控制(如过载保护、定时控制、功率限流)。
2. 硬件特性
在对接前,需确认硬件的关键参数,以便制定控制策略:
额定电流:50A(需注意实际使用不超过额定值的80%以保障安全)。
控制方式:WiFi直连(2.4G),无需额外网关。
核心功能:远程通断控制、实时电量计量、过载保护。
接口协议:HTTP API,支持公网SaaS和局域网私有化部署。
3. 对接架构
系统对接架构分为三层:
设备层:50A断路器通过WiFi连接路由器,接入互联网或局域网。
平台层:芯步开放平台(或私有化部署的服务器),负责设备注册、状态维护和指令中转。
应用层:你的业务系统(如ERP、能耗管理系统、自研APP),通过调用API实现控制逻辑。
4. 对接流程详解
4.1 前期准备:获取凭证
首先需要在芯步控制台进行应用创建,获取关键凭证:
AppID:应用的唯一标识。
AppSecret:用于签名加密的密钥,需妥善保管。
设备ID:设备联网配网后,在控制台获取的唯一Device ID。
4.2 接口鉴权:签名生成
芯步的API采用动态签名验证,所有控制请求必须携带sign和ts(时间戳)。签名算法逻辑
将AppSecret进行MD5加密 ->
Secret_Md5拼接字符串:
Secret_Md5+当前时间戳ts将上述拼接字符串再次进行MD5 -> 得到最终的
Sign。
安全提示:时间戳
ts用于防止请求重放攻击,服务器会校验时间戳的有效性(通常为5分钟内)。
4.3 核心控制:下发指令
接口地址(示例):https://api.thingboot.com/{AppID}/device/control/?sign={Sign}&ts={Timestamp}
请求方法:POSTHeaderContent-Type: application/jsonBody参数示例:
针对50A负载控制的进阶命令除了基础的power开关,针对50A大功率场景,通常需要关注计量。
查询功率/电流:可通过接口主动查询或设置数据上报推送。命令示例(依据具体型号手册)通常涉及查询实时电量,如
{"metering":"?"},用于判断当前负载是否超过设定的额定功率阈值。
4.4 关键策略:额定功率负载控制逻辑
要实现“额定功率负载控制”,即当负载功率接近或超过50A额定限制时自动保护,通常有两种实现方式:
方式A:主动轮询监测(推荐用于高精度控制)
业务系统需要定时(例如每5秒)调用设备状态查询接口,获取断路器当前的实时电流/功率值。
逻辑判断
如果 实时电流 > 50A(或设定的阈值):
调用控制接口:
{"power": 0}执行跳闸断电。恢复机制:延时一段时间后,调用
{"power": 1}尝试合闸。如果短路故障未排除,断路器可能因内部机械保护无法合闸或再次立即跳闸,此时系统应锁定并告警。
方式B:云端/规则引擎联动
利用芯步平台提供的“联动规则”功能,可以在平台端设置告警条件,无需业务系统实时轮询:
在平台设置数据流解析规则。
设定条件:当
Current > 50A,触发“设备控制”动作。平台自动向该设备下发
power:0指令。
4.5 消息推送与私有化部署
消息推送:为了获取最实时的电压、电流、功率因数等数据,可以在芯步控制台配置“消息推送”地址(Webhook)。设备状态变化时,平台会主动将数据POST到你的服务器。
局域网控制:如果对时延和安全性要求比较高(如工厂车间),采用支持局域网控制的固件版本。此时API请求直接指向断路器的局域网IP地址,不经过外网,响应速度通常在毫秒级。
5. 实战示例:Python 实现
以下代码展示了如何通过脚本实现一次性拉闸操作:
6. 注意事项与最佳实践
WiFi信号强度:50A断路器多安装在配电箱内,金属箱体会屏蔽WiFi信号。现场测试信号强度(RSSI),若信号弱,需调整路由器位置或使用具备4G备份版本的型号。
感性负载处理:如果后端负载是电机或变压器(感性负载),断开瞬间会产生电弧。虽然断路器内部有灭弧装置,但频繁带载分合闸会缩短触点寿命。结合软启动器或固态继电器作为前置缓冲。
状态同步:除了软件下发指令,用户也可能按压设备上的物理按钮。业务系统应订阅设备状态变化的推送消息,确保UI界面与设备实际状态保持同步。
私有化部署:如果是核心生产设备,强烈申请私有化部署方案。将控制闭环封闭在局域网内,避免了因互联网波动或云平台维护导致的控制失效。
通过以上步骤,你可以快速完成对芯步50A导轨式智能断路器的对接,构建稳定可靠的负载控制和能耗管理系统。