怎样对接智能大功率断路器[计量数显版]|60A以实现远程参数配置管理_解决方案

CATALOG

芯步智能大功率断路器[计量数显版]|60A 通过开放的 HTTP API 接口，支持远程参数配置、实时计量读取和开关控制。以下方案详细说明对接流程、签名算法及核心命令示例。

1. 解决概述

1.1 产品特性

核心功能：支持远程通断控制、实时读取电压/电流/功率/电能等计量数据、过载保护阈值设定。
通讯方式：Wi-Fi 2.4GHz直连，无需网关，支持5组WiFi备选。
接口开放度：提供全量HTTP API接口，支持公网/SaaS及局域网私有化部署。
适用场景：充电桩运营、基站远程重启、大型设备能耗监测、智慧园区用电管理。

1.2 技术架构

对接协议：HTTP/HTTPS
数据格式：JSON
鉴权方式：动态MD5签名（AppID + Sign + Timestamp）
响应：指令下发至执行约 80-120ms

2. 对接准备

在开始开发前，需完成以下账户与硬件准备：

注册开发者账户：登录芯步官网，进入“物联网控制台”，获取专属的 AppId 和 AppSecret。
硬件配网
- 将60A断路器接通电源。
- 在控制台中通过“网络配置”功能，将设备的WiFi模块连接到现场局域网（2.4G频段）。
获取设备ID：在控制台设备列表页面查看并记录目标设备的 DeviceId（例如：820720）。

3. 核心技术：双环境对接方式

3.1 公网云模式（SaaS）

此为标准模式，设备连接芯步官方云端，开发者通过调用官方API接口进行管理。

优点：免服务器运维、即插即用。
缺点：依赖公网，数据传输需经过第三方平台。

3.2 私有化模式（局域网/纯内网）

针对数据安全性高或网络隔离的场景，支持将设备完全运行在局域网内。

机制：设备通过DHCP获取内网IP，开发者直接向该IP发送HTTP命令，或自建接收服务器。
优点：0延迟抖动、0数据丢失风险、无公网带宽费用。

4. 接口鉴权与签名算法

无论哪种模式，调用公网API或私有化设备时，HTTP Header中通常需包含签名验证。芯步采用 动态MD5签名（即通过加盐哈希保障接口不被盗用）。

签名生成规则（伪代码）：

sign = MD5( MD5(AppSecret) + ts )

请求示例

5. 断路器对接关键命令详解

针对“智能大功率断路器[计量数显版]|60A”，主要包括 控制类 与 参数配置类 命令，下面基于文档总结其调用逻辑。

5.1 远程开关控制

控制断路器吸合/分断。这是最基础的接口调用。

说明：下发电源控制命令。
命令示例
{ "device": "12025678", "order": {"power": 1} // 1=闭合（通电），0=断开（断电） }
进阶功能（定时）：利用 reset 参数实现“点动控制”。
- 场景：远程重启路由器（断电5秒后自动通电）。
- 命令{"reset": 5000} （先断开，5000毫秒后自动闭合）。

5.2 远程参数配置

此产品支持远程修改保护阈值，无需现场操作。这是实现“远程参数配置管理”需求的核心环节。

场景：根据负载变化，远程调整过载电流限制。
核心命令：通常通过 order 中的特定参数修改寄存器值。
配置示例
{ "device": "12025678", "order": { "threshold_current": 50, // 将过载电流阈值设为50A（低于60A额定值以保护线路） "over_voltage": 264, // 过压保护值设为264V "under_voltage": 176 // 欠压保护值设为176V } }

5.3 计量数据实时读取

远程参数配置不仅指“写入”，也包括“读取当前状态”。需轮询读取电压、电流及功率数据。

命令：拉取设备详情接口。
返回数据解析示例
// 假设的返回结构，依据真实手册字段为准 { "voltage": 220.5, // 当前电压 (V) "current": 12.8, // 当前电流 (A) "power": 2816, // 当前功率 (W) "energy": 12345.6 // 累计电能 (kWh) }

6. 对接流程时序图

下图展示了一次完整的“远程调整参数->获取执行结果”的交互流程：

sequenceDiagram
    participant App as 客户业务系统
    participant API as 芯步API网关
    participant Device as 智能断路器(60A)

    Note over App,Device: 1. 远程参数配置阶段
    App->>API: POST /control (含设备ID,配置名值对,签名)
    API->>API: 校验签名 & 设备归属
    API->>Device: 透传JSON配置指令 (MQTT/HTTP)
    Device->>Device: 写入Flash并执行(如调整过载阈值)
    Device-->>API: 返回配置成功后状态
    API-->>App: 返回下发成功状态

    Note over App,Device: 2. 状态读取与主动上报
    Device->>Device: 实时监测电压/电流/温度
    Device-->>API: 定时/阈值触发上报监测值
    API-->>App: 推送监测数据 (Webhook/轮询)