怎么接入40A带计量数显导轨式智能断路器来实现场景联动控制_解决方案

CATALOG

芯步的40A带计量数显导轨式智能断路器通过开放HTTP接口，可快速接入第三方平台实现场景联动。以下是完整的接入方案，涵盖接口协议、签名算法、核心命令和典型联动场景。

1. 解决概述

目标： 将40A智能断路器接入自有管理系统（或SaaS平台），实现基于预设规则或其他传感器数据的自动通断电控制（场景联动）。

核心依据： 芯步全系智能硬件（包括该40A导轨式断路器）均开放标准HTTP接口，支持任何支持HTTP协议的编程语言或开发平台（如小程序、Web应用、边缘网关等）进行调用。

适用场景：

充电桩/车辆管理： 检测到车辆充满电（电流下降）自动断电，防止过充。
大功率设备联动： 当烟雾传感器报警时，远程强制切断车间总闸。
能耗超限保护： 实时读取功率数据，当功率超过设定阈值（如7000W）时自动跳闸，恢复后自动合闸。
环境恒温控制： 连接温控器，当温度低于设定值，自动接通加热设备。

2. 接入准备工作

在开始编码前，需在芯步控制台完成以下配置：

注册账号与工作台： 访问芯步官网注册账号，并创建“工作台” 。
获取凭证：
- AppID： 应用的唯一标识。
- AppSecret： 接口调用的密钥（严禁直接写在客户端代码中）。
添加设备：
- 将40A断路器通电，按说明配网。
- 在工作台的“物联网控制台”中绑定设备，获取唯一的 Device ID（如 18821234）。

3. 核心接口定义与签名机制

芯步的接口采用签名认证机制，确保请求安全。所有控制命令均通过向特定URL发送POST请求实现。

3.1. 请求地址

http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

{AppId}：替换为你的应用ID。
{ts}：当前Unix时间戳（秒）。
{sign}：动态生成的签名。

3.2. 签名生成算法（伪代码）

为了防止请求被伪造，签名算法规则如下：sign = md5( md5(AppSecret) + ts )。具体步骤如下：

将 AppSecret 进行MD5加密，得到 secret_md5。
将 secret_md5 与时间戳 ts （字符串形式）拼接。
将拼接后的字符串再次进行MD5加密，最终得到 sign。

示例（逻辑示意）：

AppSecret = "abc123"
ts = "1678965432"
Step1 Md5_Secret = md5("abc123") = "e99a18c428cb38d5f22e03"
Step2 Sign = md5("e99a18c428cb38d5f22e03" + "1678965432") = "xyz789..."

3.3. 请求头与数据格式

Method：POST
Content-Type：application/json
Body 结构：

4. 40A断路器关键API命令详解

针对“40A带计量数显”型号，设备支持实时状态上报和远程控制。接口响应速度快，通常在80-120ms内执行完成。

4.1. 读取实时电量与参数（场景联动的“眼睛”）

断路器会主动上报计量数据。如果你的服务器接收推送（需配置消息接收服务器），会收到如下格式的实时数据：

（注：若不自建服务器，可通过轮询方式获取，设备推送最为实时）

4.2. 远程通断控制（场景联动的“手”）

断路器最基本的功能是远程分合闸。

命令示例1：远程合闸/开启

适用情况：用户支付成功后自动通电。

命令示例2：定时断开（一次性任务）常用在共享设备场景，通电后允许使用1小时自动断电。

这样的设计无需在服务器维护定时任务队列，由设备硬件直接执行，更加可靠。

4.3. 场景联动编程示例

假设我们要实现逻辑：当实时电流超过35A（接近40A额定值的87.5%）持续5秒时，自动断开电路。

由于设备端可能不具备复杂的边缘计算逻辑，通常需要在你的业务服务器端实现该逻辑：

接收数据： 服务器接收设备上报的 current 值。
逻辑判断：
# 伪代码示例 if current > 35.0: # 累加或延时判断（简单起见，直接预警） send_control_command(device_id, {"power": 0}) # 触发断电保护 send_alert_to_admin("40A断路器过载跳闸，当前电流:" + str(current))
恢复供电： 排除故障后，可通过下发 {"power": 1} 远程合闸（自动重合闸）。

5. 完整对接流程（时序图逻辑）

一个典型的“传感器触发断路器动作”的全链路流程如下：

状态感知： 温湿度传感器检测到温度过高，向服务器上报数据。
业务决策： 你的服务器接收到温度报警，判断需要切断后端连接的40A断路器。
指令下发： 服务器计算签名sign，携带Device_ID和命令{"power":0}，调用API。
云端处理： 芯步云端验证签名，通过MQTT/WiFi协议将指令推送到断路器。
设备执行： 断路器接收指令，磁保持机构动作，电闸断开。
状态反馈： 断路器上报新的状态（power:0）至服务器，确认动作执行成功。

6. 关键注意事项

私有化部署支持： 如果你对数据安全性要求比较高（纯内网环境），芯步支持将整个接口私有化部署到你的服务器上，此时API地址将指向你的内网IP 。
确保命令送达： HTTP接口返回成功通常代表指令已下达至云端，但由于WiFi网络波动，设备可能存在极短的延迟。在关键场景（如紧急断电）中，配合设备的心跳机制确认线路畅通。
签名安全：AppSecret 绝对不能硬编码在前端HTML/JavaScript或小程序前端代码中。所有对断路器的控制请求都必须由你的后端服务器（业务层） 发起，前端仅触发你的后端接口。
数显与UI： 虽然设备自带显示屏，但通过接口读取的数据同样可以渲染在你自己的APP或Web管理后台，实现“电子看板”功能。