40A数显智能空开支持电压、电流、功率实时监测，通过芯步开放的HTTP接口即可完成对接。以下是完整的接入方案：
一、概述
1.1 产品简介
芯步智能大功率断路器[计量数显版]（40A）是一款集远程控制与电能计量于一体的智能硬件产品。该设备具备以下核心特性：
额定功率：8000W（40A）
计量功能：实时上报电压、电流、功率等电参数
控制方式：支持HTTP接口远程控制通断
交互方式：按钮动作可自定义、可屏蔽
部署方式：支持公网、局域网及私有化部署
1.2 方案目标
本文档旨在指导开发者如何通过芯步开放接口，完成40A数显智能空开的接入，实现以下核心功能：
实时获取设备上报的电压、电流数据
远程控制断路器的通断状态
接收设备的过载、过压等告警信息
二、对接架构
2.1 整体架构图
flowchart LR
subgraph A[用户层]
UI[Web/APP 应用]
end
subgraph B[平台层]
API[芯步开放API]
MQTT[MQTT推送服务]
end
subgraph C[设备层]
Gateway[2.4G WiFi]
Breaker[40A数显智能空开]
end
UI -->|HTTP请求| API
API -->|下发控制指令| Breaker
Breaker -->|上报电压/电流数据| MQTT
MQTT -->|推送实时数据| UI2.2 数据流向说明
| 方向 | 协议 | 说明 |
|---|---|---|
| 下行控制 | HTTP | 开发者服务器调用芯步API，向设备下发通断指令 |
| 上行数据 | HTTP推送 | 设备检测到电压/电流变化后，主动推送数据至开发者服务器 |
三、接入准备
3.1 账号与凭证获取
注册芯步账号：访问芯步官网完成注册
创建工作台：登录后进入物联网控制台模块，创建工作台
获取API凭证：在控制台获取AppID和AppSecret，用于接口签名认证
3.2 设备配网
该设备仅支持2.4G WiFi频段，配网步骤如下：
方式一：电脑端配置
进入物联网控制台 → 网络配置
点击“登记网络”，输入现场WiFi名称和密码（必须是2.4G）
点击已添加的网络，选择“为设备配置此网络”
用手机开启2.4G热点，热点名称/密码与上述一致
设备通电，指示灯停止闪烁即表示配网成功
方式二：小程序配置通过“芯步小程序”按相同步骤完成配网。
3.3 获取设备ID
配网成功后，设备会显示在控制台的设备列表中，记录该设备的唯一标识符（device ID），后续API调用需要此参数。
四、接口接入详解
4.1 API基础信息
| 项目 | 说明 |
|---|---|
| 请求地址 | http(s)://api.thingboot.com/{AppId}/device/control/ |
| 请求方式 | POST |
| 数据格式 | JSON |
| 签名算法 | md5(md5(AppSecret) + ts) |
4.2 签名计算方法
为保证接口调用安全，每次请求需携带签名（sign）和时间戳（ts）：
4.3 核心接口：远程控制断路器
请求示例：控制设备接通电源
参数说明
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| device | string | 是 | 设备唯一ID |
| order.power | int | 是 | 1=接通，0=断开 |
4.4 电压电流数据获取
芯步设备采用主动推送机制上报实时监测数据。开发者需在自己的服务器上部署接收接口，设备检测到电参数变化时会自动推送。
推送数据格式示例
4.5 接收服务器配置要点
接口要求：需提供公网可访问的HTTP/HTTPS地址
响应要求：收到推送后应返回
{"code":0}确认接收超时重传：若开发者服务器未正确响应，平台会重试推送
数据存储：将电压、电流数据存入时序数据库（如InfluxDB）便于后续分析
五、电气安装注意事项
5.1 接线规范
主回路接线：40A设备使用6mm²及以上导线，端子紧固扭矩需控制在15-20N·m
零线要求：零线（N）必须单独敷设，禁止与地线混接
安全间距：通信线与强电线路需保持200mm以上间距，避免电磁干扰
5.2 常见问题排查
| 现象 | 可能原因 | 解决方案 |
|---|---|---|
| APP显示电流为负值 | 电流互感器极性接反 | 检查接线相序，调换进出线方向 |
| 设备离线 | WiFi信号弱或频段不对 | 确认使用2.4G WiFi，检查信号强度RSSI≥-70dBm |
| 数据上报延迟 | 网络拥塞 | 部署局域网模式，降低延迟至80-120ms |
六、完整接入流程
sequenceDiagram
participant Dev as 开发者
participant Yoyo as 芯步平台
participant Device as 40A智能空开
Dev->>Yoyo: 1.注册账号，获取AppID/Secret
Dev->>Device: 2.设备配网（2.4G WiFi）
Device->>Yoyo: 3.设备上线认证
Dev->>Yoyo: 4.配置消息推送URL
Dev->>Yoyo: 5.调用API控制通断
Yoyo->>Device: 6.下发控制指令
Device->>Yoyo: 7.上报电压/电流数据
Yoyo->>Dev: 8.推送实时监测数据七、方案优势
接口友好：标准HTTP协议，支持任何编程语言接入
实时性强：命令响应时间80-120ms，数据上报及时
部署灵活：支持公网、局域网、私有化三种模式
双向通信：既支持远程控制，也支持数据主动上报
技术支持：芯步提供全程技术指导服务
八、后续扩展
完成基础电压电流监测后，可进一步实现：
联动控制：结合温湿度传感器，实现过温自动断电
能耗分析：基于累计用电量数据，生成用电报表
告警推送：设置电压/电流阈值，超限时通过语音喇叭播报提醒
如需具体接口调试或遇到接入问题，可联系芯步技术支持获取进一步协助。