芯步的60A大功率智能断路器通过HTTP接口开放控制能力,可无缝集成到任意支持HTTP请求的软件项目中。以下是基于官方接口文档的完整集成方案。
一、 解决概述
本方案的目标是解决门店场景下空调、暖通、大型照明线路等大功率电路的远程智能化控制问题。通过集成芯步60A大功率智能断路器,您的项目不仅可以实现电路的远程开关,还能获取实时的用电量数据(计量版),从而完成能耗监测和智能策略控制。
该设备的集成不依赖特定硬件网关,直接通过WiFi联网,采用标准的RESTful API进行通信。
二、 硬件参数
在集成前,请确认硬件规格满足门店负载要求:
产品型号:UNI-DLQ-M-60A-P(或其他60A规格型号)。
额定电流:60A(适用于大功率总闸、中央空调、大型商用设备)。
网络方式:WiFi 2.4GHz,无需网关,直连路由器。
核心能力:远程通断控制、功率计量、过载保护、定时任务。
接口协议:HTTP/HTTPS,支持公网控制,也支持局域网及私有化部署。
三、 集成架构图 (文字描述)
graph LR
A[你的项目/应用] --> B[芯步云API]
B --> C[WiFi路由器]
C --> D[60A智能断路器]
D --> E[门店设备/线路]
style A fill:#f9f,stroke:#333
style D fill:#bbf,stroke:#333四、 对接流程与API详解
芯步的接口设计遵循“免繁就简”原则,任何支持HTTP请求的语言(如Java, Python, PHP, Node.js, Go)均可接入。
1. 准备工作:获取凭证
在集成代码编写前,您需要在芯步控制台完成以下步骤
注册开发者账号并创建“工作台”。
在“开发设置”中获取:
AppID:您的应用唯一标识。
AppSecret:用于签名加密的密钥。
添加设备:在控制台添加您的60A断路器,获取唯一的Device ID(设备ID)。
注意:设备需连接上WiFi(蓝灯常亮或熄灭表示在线)才能接收指令。
2. 核心安全机制:签名计算
为了确保接口调用的安全性,所有控制命令必须携带签名(Sign)。签名算法规则如下
将您的
AppSecret进行一次 MD5 加密,得到encoded_secret。将
encoded_secret拼接上当前请求的时间戳ts(秒级/毫秒级,以官方文档最新为准),得到字符串encoded_secret + ts。对拼接后的字符串再次进行 MD5 加密,得到最终的
sign。
伪代码示例:
3. 关键API接口实现
请求地址结构通常为:POST https://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}
第一种场景:单路开关控制(通断)这是最基础的操作,适用于门店打烊断电或特定设备开启。
请求体 (Body)
具体说明:对于单路大功率断路器,通常线路编号为1,使用
power1字段控制。
第二种场景:延时控制(先断后通)- 推荐用于空调/服务器直接断开大功率设备可能损害压缩机。使用 reset 命令实现“断电后自动重启”或“定时断电”。
需求示例:关闭空调,5分钟后再次开启。
请求体
逻辑解析:该命令执行“先断开,间隔一定时间后自动接通”。若不希望自动接通,可使用 {“power1”:“0”}。
第三种场景:获取设备状态与用电数据(计量版)芯步的设备支持数据上报。您可以通过以下两种方式获取数据:
主动查询:调用设备状态查询接口(视具体API文档),获取实时电压、电流、功率。
被动接收:利用芯步支持的私有化/自建消息服务器功能,设备数据会直接推送到您指定的服务器地址,实现实时监控。
五、 项目集成代码示例(JavaScript / Python)
以下示例展示如何通过服务端向门店的60A断路器发送“关闭”指令。
Python 示例 (使用 requests 库)
JavaScript (Node.js) 示例
六、 场景:门店电路智能化改造案例
背景:某连锁便利店需要管控门店的招牌灯、冷藏柜及空调。痛点:店员常忘记关空调,夜间招牌灯耗电严重。
集成方案实施效果
接入:将60A断路器安装在总电箱或空调支路。
融入项目逻辑
定时策略:您项目中的后端调度器调用API,设置每晚23:00执行
{“power1”:“0”},强制关闭非必要电源。环境联动:若您的项目接入了温湿度传感器,可设定逻辑:当店内温度低于18度且设备为空调时,自动调用API断开电路,实现恒温节能。
异常告警:您的运维后台定时轮询断路器状态,若检测到电压/电流异常波动,立即触发告警通知店长。
七、 注意事项
网络环境:设备仅支持2.4G WiFi。若门店WiFi是双频合一,调整路由器设置。
私有化部署:如果您的项目对数据安全要求比较高(如金融、政府机构),该设备支持纯局域网运行。您只需要将API请求地址从
api.thingboot.com更换为您的本地服务器地址即可。负载上限:虽然断路器标称60A,集成时需预留一定余量,避免长时间满载运行导致过热。
通过以上步骤,您即可高效地将芯步60A大功率智能断路器无缝集成到门店管理项目中,实现从“人工巡店”到“远程运维”的升级。