CATALOG

芯步的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. 准备工作:获取凭证

在集成代码编写前,您需要在芯步控制台完成以下步骤

  1. 注册开发者账号并创建“工作台”。

  2. 在“开发设置”中获取:

    • AppID:您的应用唯一标识。

    • AppSecret:用于签名加密的密钥。

  3. 添加设备:在控制台添加您的60A断路器,获取唯一的Device ID(设备ID)。

    • 注意:设备需连接上WiFi(蓝灯常亮或熄灭表示在线)才能接收指令

2. 核心安全机制:签名计算

为了确保接口调用的安全性,所有控制命令必须携带签名(Sign)。签名算法规则如下

  1. 将您的 AppSecret 进行一次 MD5 加密,得到 encoded_secret

  2. encoded_secret 拼接上当前请求的时间戳 ts(秒级/毫秒级,以官方文档最新为准),得到字符串 encoded_secret + ts

  3. 对拼接后的字符串再次进行 MD5 加密,得到最终的 sign

伪代码示例:

3. 关键API接口实现

请求地址结构通常为:POST https://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}

第一种场景:单路开关控制(通断)这是最基础的操作,适用于门店打烊断电或特定设备开启。

  • 请求体 (Body)

  • 具体说明:对于单路大功率断路器,通常线路编号为1,使用 power1 字段控制

第二种场景:延时控制(先断后通)- 推荐用于空调/服务器直接断开大功率设备可能损害压缩机。使用 reset 命令实现“断电后自动重启”或“定时断电”。

  • 需求示例:关闭空调,5分钟后再次开启。

  • 请求体

逻辑解析:该命令执行“先断开,间隔一定时间后自动接通”。若不希望自动接通,可使用 {“power1”:“0”}

第三种场景:获取设备状态与用电数据(计量版)芯步的设备支持数据上报。您可以通过以下两种方式获取数据:

  1. 主动查询:调用设备状态查询接口(视具体API文档),获取实时电压、电流、功率。

  2. 被动接收:利用芯步支持的私有化/自建消息服务器功能,设备数据会直接推送到您指定的服务器地址,实现实时监控

五、 项目集成代码示例(JavaScript / Python)

以下示例展示如何通过服务端向门店的60A断路器发送“关闭”指令。

Python 示例 (使用 requests 库)

JavaScript (Node.js) 示例

六、 场景:门店电路智能化改造案例

背景:某连锁便利店需要管控门店的招牌灯、冷藏柜及空调。痛点:店员常忘记关空调,夜间招牌灯耗电严重。

集成方案实施效果

  1. 接入:将60A断路器安装在总电箱或空调支路。

  2. 融入项目逻辑

    • 定时策略:您项目中的后端调度器调用API,设置每晚23:00执行 {“power1”:“0”},强制关闭非必要电源。

    • 环境联动:若您的项目接入了温湿度传感器,可设定逻辑:当店内温度低于18度且设备为空调时,自动调用API断开电路,实现恒温节能。

    • 异常告警:您的运维后台定时轮询断路器状态,若检测到电压/电流异常波动,立即触发告警通知店长

七、 注意事项

  1. 网络环境:设备仅支持2.4G WiFi。若门店WiFi是双频合一,调整路由器设置

  2. 私有化部署:如果您的项目对数据安全要求比较高(如金融、政府机构),该设备支持纯局域网运行。您只需要将API请求地址从 api.thingboot.com 更换为您的本地服务器地址即可

  3. 负载上限:虽然断路器标称60A,集成时需预留一定余量,避免长时间满载运行导致过热。

通过以上步骤,您即可高效地将芯步60A大功率智能断路器无缝集成到门店管理项目中,实现从“人工巡店”到“远程运维”的升级。