CATALOG

芯步的50A智能限流断路器本身就提供开放的HTTP API接口,这意味着你不需要编写复杂的驱动或处理底层通信协议,直接用项目后端的HTTP请求就能完成控制。以下是完整的技术实现方案:

解决方案:基于HTTP API的50A智能限流断路器软件对接方案

1. 硬件与通信概览

在开始对接前,需明确硬件的基础属性。芯步的50A智能断路器(型号如UNI-DLQ-M-50A)具备以下特点,这决定了我们的对接策略:

  • 通信方式:支持 Wi-Fi 2.4G 直连(无需网关)或 4G 版本(视具体型号而定)。门店环境优先选用Wi-Fi版,成本更低且响应快。

  • 控制协议HTTP/HTTPS 协议。设备云端开放标准的RESTful API接口。

  • 核心能力:除了简单的通断,还支持电量计量过载保护(50A额定)、定时任务功率限制等功能

2. 软件对接设计

要将设备集成到你的门店管理软件(Web端、移动端或PC端),推荐采用 “业务系统 -> 芯步云平台 -> 设备” 的标准三层架构,避免软件直接穿透内网,提高安全性。

  • 软件项目层:你的门店管理系统、APP或小程序。负责业务逻辑(如排班、权限、能耗分析)。

  • 云平台层:芯步云端 API。负责设备状态维护、命令转发、数据存储。

  • 设备层:门店电箱内的50A智能断路器。执行通断电指令并上报电流、电压等数据。

3. 对接核心步骤:从注册到控制

第一步:获取密钥与设备ID在芯步开发者后台创建应用,获取 AppIdAppSecret。同时,将设备配网绑定至账号下,获取唯一的 device ID(如 820720

第二步:签名生成(关键安全环节)所有API请求需携带动态签名以防止接口被恶意篡改。签名算法如下:

Sign = MD5( MD5(AppSecret) + ts )

(注:ts 为Unix时间戳,秒级。此机制确保了每次请求的签名都不同且有时效性)

第三步:下发控制指令向接口地址 POST https://api.thingboot.com/{AppId}/device/control/ 发送JSON数据。这是对接中最核心的代码逻辑:

  • 请求体示例:控制断路器“闭合/通电”。

  • 预期响应:设备通常在 80-120ms 内执行动作,非常适合需要即时反馈的门店场景

第四步:获取实时状态与数据如果需要监测门店当前的真实功耗或判断断路器是否跳闸,可通过查询接口获取设备最新上报的数据,包括:实时电压/电流、功率(负载功率)、今日用电量、开关状态等

4. 软件功能实现详解

基于上述接口,你可以在软件项目中实现以下具体的业务功能:

功能模块技术实现方案应用场景(门店价值)
远程分合闸调用控制接口(power:1/0店长下班忘记关灯/关空调,远程一键断电,节省电费。
定时策略调用定时接口(reset 或云端定时任务)设置开店前10分钟自动开启招牌灯、收银系统;闭店后自动切断非必要电源
过载保护与联动读取设备状态码 + 主动断电当检测到电流超过50A或温度过高时,软件界面弹出告警并自动切断电路,防止火灾。
能耗统计调用历史数据接口生成各门店的《月度电费报表》,分析空调、冰柜等设备的能耗是否异常。

5. 针对“限流”特性的特殊处理

本方案的重点在于“50A智能限流”。与传统断路器不同,这款设备允许你在软件层面设定限流阈值,而不必等到物理过载才跳闸:

  • 软限流设置:在API命令中加入 max_power 或电流阈值参数。例如,如果门店总负荷上限为40A(预留10A余量),你可通过软件下发指令将断路器阈值设为40A。

  • 优先级策略:当多个设备同时使用时,若软件监测到总功率接近50A,可自动根据优先级(如:暂时切断非核心的广告机电源)来柔性降低负载,避免主闸跳闸导致收银系统瘫痪。

6. 部署与排障

  • 网络要求:门店Wi-Fi信号需覆盖电表箱位置。若电箱位于金属铁盒内(信号屏蔽强),选用4G版本的断路器,插卡即用,无需门店Wi-Fi

  • 对接语言:无论你的软件项目是用Java、Python、PHP还是Node.js编写,只需支持 HTTP 库,即可复用上述签名和请求逻辑,无需引入复杂的SDK

总结

通过对接芯步标准化的HTTP API接口,可以在不修改硬件固件的情况下,将门店的电路控制深度集成到软件业务流中。核心工作量集中在 “签名生成”“业务逻辑触发(如定时/权限)” 的开发上,通常仅需数小时即可完成原型测试。