CATALOG

芯步的60A计量数显空开通过标准HTTP API开放接口,可将通断控制、电量读取、电压电流监测等功能无缝集成到现有软件系统中。以下方案涵盖硬件选型、接口协议、签名机制和核心代码实现。

解决方案:基于芯步开放接口的60A智能空开软件集成方案

1. 背景与选型

在门店电路数字化管理中,需要实时监测大功率设备的能耗、电压波动及过载风险。芯步智能大功率断路器[计量数显版]|60A 是理想的执行单元。其核心参数符合门店总进线或中央空调等大功率设备控制需求

  • 额定电流:60A(支持MAX 60A),适用于大功率总路控制。

  • 负载能力:阻性负载最高 12000W,感性负载最高 2000W。

  • 关键特性:支持电能计量(计量版)与数码管数显(数显版),便于现场巡视。

  • 联网与控制:支持 WiFi/4G 双模通信(根据型号),兼容 HTTP API 远程控制及 433MHz 遥控。

2. 整体设计

系统采用标准的物联网三层架构,利用芯步成熟的开放平台作为中间层,降低开发难度:

  1. 设备层:60A智能空开替换原有传统断路器,接入门店现有 WiFi(2.4GHz)或通过 4G 联网。

  2. 平台层:芯步云端。设备数据自动同步至该平台,负责设备连接、状态存储及高并发处理。

  3. 应用层:您的门店管理软件(WEB端/APP/小程序)。通过调用芯步开放的 HTTP API,实现控制指令下发与数据拉取。

3. 核心集成流程

3.1 前期准备:设备配网与凭证获取

在开始编码前,需完成硬件初始化

  1. 注册与创建:在芯步官网注册账号并创建“工作台”,进入“物联网控制台”。

  2. 设备配网:给60A空加上电。使用“芯步”小程序或控制台进行 2.4G WiFi 配网(若选择4G版本则自动联网)。

  3. 获取凭证

    • AppIDAppSecret:在控制台的“开发设置”中获取,这是API调用的钥匙。

    • Device ID:在设备列表页查看该空开的唯一ID(如 1878820720

3.2 接口鉴权机制

芯步的API采用动态签名验证,所有请求需携带 signts(时间戳)。算法规则为双重MD5加密:Sign = MD5( MD5(AppSecret) + ts )

注意事项:

  • 时间戳ts 需精确到,且与服务器时间误差不宜过大。

  • 开发测试阶段可在控制台开启“调试模式”以临时绕过签名校验,生产环境请一定要关闭调试模式,严格按此算法生成签名

3.3 接口详细定义

核心API地址(通用):POST http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

请求头 (Headers)Content-Type: application/json

请求体 (Body)

4. 针对60A计量数显空开的软件实现逻辑

4.1 远程通断控制

这是最基础的功能,用于在非营业时段切断电源或紧急情况下的远程跳闸。根据产品手册,单路大功率设备的控制命令通常使用 power1 字段

  • 开启输出{"power1": 1}

  • 关闭输出{"power1": 0}

代码示例(Python)

4.2 读取计量数据(电能监测)

门店管理软件的核心需求是“能耗可视化”。虽然控制指令通过API下发,但数据的读取通常有两种主流方案:

方案A:主动查询(推荐用于即刻显示)利用芯步提供的 设备状态查询接口(具体路径见开放平台文档),主动拉取设备的当前电量、电压、电流数据。应用场景:管理员手动点击“查看详情”时实时刷新。

方案B:被动接收(推荐用于告警与报表)配置 HTTP 推送(Webhook)。在控制台的“开发设置”中配置您的服务器接收地址。应用场景

  1. 实时告警:当电压超过250V或电流超过60A阈值时,云端毫秒级推送告警至您的服务器,门店软件收到后弹窗提示店长。

  2. 定时报表:系统每隔5分钟(或自定义频率)推送一次电参数据,您的软件接收后存入数据库,用于生成日/月电费报表。

4.3 批量与定时控制

针对连锁门店场景,软件需支持批量操作

  • 批量下发device 参数支持逗号分隔多设备ID。可实现“一键打烊”,总闸空开控制代码改造通过一条API请求关闭所有门店的电路。

  • 定时任务:若不希望软件维护复杂的定时队列,可直接调用芯步的 定时接口(或控制台设置)。设置好 Cron 表达式后,由云端自动执行通断,不受本地服务器宕机影响。

5. 关键难点与规避方案

1. 计量精度的同步

  • 问题:HTTP请求是异步的,直接从API获取的瞬时电压值可能存在波动。

  • 解决方案:在软件前端或后端逻辑中对数据进行滤波处理(如取最近3次请求的平均值)。对于电费统计,基于云端推送的历史数据(累计电量)做差值计算,而非累加瞬时功率。

2. 签名算法的封装

  • 问题:每个请求都需手动拼接 md5(md5(secret)+ts),容易出错。

  • 解决:在软件中封装一个统一的 HTTP 请求函数。该函数自动拦截请求,动态生成时间戳和签名,填充 Header,避免业务代码侵入

3. 网络中断处理

  • 问题:WiFi 断开或云平台波动导致指令未送达。

  • 解决:软件需实现异步任务状态查询机制。下发命令后,不要立即假设设备已动作,应调用一次状态查询接口确认 power1 的返回值是否为期望值。

6. 总结

通过上述方案,开发者可在 最低代码侵入 的情况下,将工业级的60A强电控制能力集成进现有的门店管理软件中。核心工作量集中在:

  1. 封装签名工具类。

  2. 实现 “通断控制” 与 “数据拉取/推送” 两个核心模块。

  3. 针对计量数据设计对应的数据库表结构(电压、电流、功率因数等)。

依托芯步标准化的 HTTP 接口,一个具备远程跳闸、能耗分析、过载保护的智慧用电系统可在短时间内完成搭建并上线