芯步的智能空开采用标准HTTP API接口，支持远程控制、电量采集和实时告警，可快速集成到各类软件项目中。以下方案涵盖设备选型、接口对接流程及核心功能实现逻辑。

1. 背景与需求分析

在连锁门店的运营管理中，电力能耗的监控与电路的安全控制是两大痛点。传统门店的配电箱往往依赖人工巡检，无法实时感知线路是否过载、漏电，也无法在闭店后确认空调、照明等大功率设备是否完全关闭。

为实现门店的智能化与节能化，引入具备远程控制与电能计量功能的智能硬件成为必然选择。芯步推出的50A带计量远程智能空开（智能大功率断路器[计量版]），不仅能承载门店大功率设备的通断，还能实时采集电压、电流、功率因数等数据。

本方案的目标是详细阐述如何利用该设备的开放接口，将其无缝对接到现有的（或新建的）软件后台中，构建“云+边+端”的用电管理体系。

2. 硬件选型与核心参数确认

在对接到软件项目之前，首先需要明确硬件的具体型号与技术特性。结合需求，选用芯步 智能大功率断路器[计量版] 50A 型号。

关键特性：该设备不仅支持远程开/关（继电器控制），更核心的是具备电能计量和过载保护功能。当软件监测到电流超过50A阈值时，不仅可以由硬件自动脱扣，软件后台也可以发出报警并执行远程分闸。

3. 对接设计

要将物理设备与软件项目打通，整体架构分为四层：

3.1 端（设备层）

即50A智能空开，安装在门店配电箱内。它负责收集电压、电流、温度等原始数据，并接收云端下发的指令。

3.2 边/网（传输层）

设备通过WiFi/4G连接网络。这里有两种网络拓扑形式：

• 直连模式：设备直接连接芯步的全球云服务器。

• 局域网模式：若门店网络需要高安全性且带宽有限，可利用芯步支持的“私有化部署”功能，将数据发送至指定的企业内部服务器。

3.3 云（平台层）

• 芯步开放平台：处理设备连接状态、数据解析、消息转发。它提供了统一的API接口和消息推送机制。

• 用户自建业务平台：即开发者自己的软件后台。这是逻辑处理中心，负责接收设备数据并调用接口下发控制指令。

3.4 应用层

包括内部ERP系统、微信小程序、Web后台或APP，供店长或运维人员操作。

4. 接口对接核心流程

芯步的开放接口基于HTTP/HTTPS协议，采用POST请求，数据格式为JSON。其核心优势在于接口签名机制（Sign）带来的安全性，以及对多平台兼容性（无需特定SDK，原生HTTP即可对接）。

4.1 准备工作：获取凭证

在芯步开发者后台（ThingBoot Open）创建项目，获取三个关键凭证：

• AppId：应用的唯一标识。

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

• deviceId：每台50A智能空开的唯一ID（通常在设备贴纸上）。

4.2 鉴权与请求地址

所有接口请求都需要携带签名和时间戳，防止请求被篡改。请求模板如下

• ts：Unix时间戳（秒），用于防止重放攻击。

• signmd5(AppSecret + ts) 或其他约定的加密算法。

4.3 核心接口实施：远程分合闸

这是最为关键的控制功能。在软件项目中，若需关闭门店的总电或某一回路，后台应构造如下JSON请求体：

请求示例 (控制设备断电)：

逻辑细节

1. 状态同步：在界面上点击“关闭”按钮时，应首先请求该接口。

2. 反馈确认：接口会同步返回成功或失败信息。为了保证状态绝对准确，在收到接口返回“指令下发成功”后，延迟500ms再次调用“设备状态查询接口”以确认线路已物理断开。

3. 异常处理：若空开处于“过载保护”或“漏电”锁定状态，软件应收到对应的错误码，并提示运维人员现场排除故障后再手动复位，不能强制远程合闸。

4.4 数据上报：接收计量数据

设备不会等待软件来问，而是自动主动推送数据。开发者需要在自建服务器中设置一个接收地址。

数据流流程

1. 设备每隔1-5分钟（可配置）自动上报电压、电流、功率、今日累计电量等数据。

2. 芯步平台通过HTTP POST请求，将消息推送到开发者设置的URL中。

上报数据格式参考

落地应用在软件项目中，可以将接收到的 current 值与设定的安全阈值比较。例如，如果某设备额定功率是3000W，若连续3次上报功率超过3000W，系统自动触发告警并推送短信给店长。

4.5 私有化部署与局域网控制

对于数据隐私要求比较高的连锁企业（如金融网点、高端零售），芯步支持私有化部署。

• 实施方式：开发者将软件项目部署在自己的服务器上，芯步提供HTTP SDK或MQTT Broker对接方案。

• 优势：所有电流电压数据不经过第三方云，直接落入企业内网数据库，极大提升数据安全等级。

5. 技术实现细节

5.1 电量统计与账单分析

利用上报的 energy_today 或 energy_month 数据，软件可以实现“一线路一核算”。

• 峰谷平策略：在软件后台配置电价模板（例如：峰时1.2元/度，谷时0.4元/度），结合不同时段上报的电量，自动计算出每家门店每日的电费成本，省去人工抄表。

5.2 定时与联动策略

基于接口，软件可以实现复杂的自动化逻辑：

• 定时任务：编写定时脚本，每晚22：00调用控制接口，强制断开所有非必要电源（如广告灯箱、收银机外设），22：00执行power=0；次日早上8：00执行power=1。

• 联动控制：若软件集成了温湿度传感器，当检测到门店温度低于5℃且空开处于开启状态时，可自动执行断开空调电源，防止设备空转浪费。

6. 异常处理与可靠性

在集成过程中，软件项目必须处理物联网场景下的各种异常：

6.1 断网与重连机制

• 场景：门店WiFi故障，导致软件下发“关闭”指令失败。

• 对策：利用设备本身的掉电/断网保护机制。50A智能空开具备本地存储功能，如果网络中断，其执行的断电指令会暂存于边缘侧，或由硬件本地定时策略继续执行，无需依赖云端。软件端需轮询设备状态，若显示离线，应在前端提示“设备离线，指令待执行”。

6.2 控制安全锁定

门店配电涉及人身安全，软件设计应包含“控制等级”逻辑（锁定机制）：

• 当维修人员在现场作业时，可通过本地物理按钮将空开锁死在“分闸”状态。

• 此时，软件后台虽然可以下发“合闸”指令，但硬件会因锁定机制拒绝执行。

• 软件表现：调用合闸接口返回“本地锁定，无法远程操作”，这实际上是一种安全保护，软件需明确记录此状态防止误判。

7. 总结

将芯步50A带计量远程智能空开对接到软件项目中，本质上是利用其标准化的HTTP API打通数据孤岛。通过上述架构，开发者可以在一个月内完成从硬件选型、接口调试到软件上线的全流程。最终实现的“门店电路控制”系统不仅能带来“一键关店”的便捷，更能通过精准的电量数据为门店的节能降耗提供数据决策支持，实现从“被动维修”到“主动运维”的转变。

注：具体的接口鉴权参数、实时消息推送的JSON结构体定义，请参阅芯步官方最新《开放平台设备接入文档》。