这份方案将围绕芯步生态（ThingBoot Open）的标准API规范，针对 “UNI-DLQ-M-50A-PD”（即50A带计量数显远程智能空开）的接入场景，提供从硬件配置到软件集成的全流程技术解决方案。
1. 项目概述与目标
在家庭配电箱改造场景中，引入“50A带计量数显远程智能空开”主要解决三个痛点：
能源可视化：实时监测大功率回路（如中央空调、即热式热水器、总闸）的电压、电流、功率。
远程控制：在离家忘关电器或紧急情况下，通过软件远程分合闸。
安全保护：设定电力阈值，当电流/电压异常时自动断电并推送告警。
本方案基于芯步开放平台标准协议，旨在将硬件设备无缝集成至现有的物业管理APP、后勤SaaS系统或智能家居平台中。
2. 硬件选型与接口特性
本方案核心选用 “智能大功率断路器[计量数显版]50A” ，型号：UNI-DLQ-M-50A-PD。
电气参数：额定电流50A，适用于家庭入户总闸或大功率空调主线。
计量功能：内置计费级互感器，可采集高精度电压、电流、有功功率、电量数据，并在设备端LED屏幕本地显示，同时通过API上报。
通信方式：支持2.4G WiFi直连，无需额外网关，但需确保配电箱内信号强度（安装点WiFi信号RSSI值 > -70dBm）。
接口协议：遵循 ThingBoot Open API 标准，采用HTTPS POST/GET请求，数据格式为JSON，签名验证机制。
3. 软件接入方案架构
3.1 网络拓扑
智能空开(50A) <--(WiFi)--> 家庭路由器 <--(互联网)--> 芯步云API <--(HTTP调用)--> 您的应用服务器 <--(数据展示)--> APP/Web前端
3.2 对接核心流程
设备端：配网并绑定至用户账户。
云端接口层：调用芯步开放接口进行控制与数据拉取。
业务层：处理数据入库、告警逻辑、权限管理。
4. 详细实施步骤
4.1 物理安装与配网（前期准备）
断电安装：将空开卡入配电箱导轨，注意上进下出原则——上方端子接入户火线（L）/零线（N），下方端子接出线至家庭负载端。由于是50A大功率设备，需拧紧接线端子防止发热。
设备激活（扫码配网）
下载“芯步”或对应品牌的控制台APP。
长按空开上的物理按键（或通过蓝牙唤醒），进入配网模式（指示灯快闪）。
使用APP扫描设备机身二维码，输入家庭WiFi密码。注意：仅支持2.4G频段，需关闭路由器的5G优选功能。
4.2 API接口对接开发（软件侧核心）
芯步采用标准的HTTP API，需在控制台获取 AppID 和 AppSecret 用于生成签名。
4.2.1 获取设备实时状态（数据可视化）
场景：软件主界面需要显示当前的总电压、电流和功率。请求示例
返回数据解析：服务器将返回类似{"voltage":"220.5", "current":"12.3", "power":"2700", "energy":"10.5"}的数据。前端拿到后可直接渲染仪表盘。
4.2.2 远程分合闸控制（断路器通断）
场景：用户出门后，通过App点击“关闭空调回路”。请求示例
细节说明：50A断路器内部通常采用磁保持继电器，动作瞬间会有“咔哒”声，属于正常物理现象。
4.2.3 阈值告警设置（过载保护）
场景：设置当电流超过40A或功率超过8000W时，自动触发软件告警或自动断电。实现的方式是：通常采用轮询+本地逻辑结合。
方案A（本地执行）：通过API下发保护参数写入设备flash，设备检测到过载立即跳闸（毫秒级）。
方案B（云端执行）：服务器定时轮询，发现电流值超限，调用控制接口拉闸（秒级）。推荐走本地执行，更安全。
4.3 私有化部署与局域网控制（进阶）
如果是高端别墅项目或涉密单位，数据不能经过外网。芯步开放平台支持私有化部署。
机制：设备支持修改API域名，将数据上报地址改为项目本地的服务器IP。
操作：在设备配网时，通过特定指令将下发地址指向本地部署的
api.thingboot.com镜像服务，实现纯局域网内的断网控制。
5. 软件功能模块设计
| 模块 | 功能点 | 技术实现备注 |
|---|---|---|
| 实时看板 | 电压、电流、功率、今日电量图表 | 利用device/status接口轮询，间隔2-5秒，避免频繁调用被封IP |
| 历史记录 | 每日/每月用电量统计 | 需自行搭建数据库，定时拉取电表读数存储，计算差值 |
| 智能联动 | 配合温湿度传感器或烟感，异常时自动断电 | 监听传感器推送的消息，触发device/control指令 |
| 权限管理 | 家庭管理员可操作，访客只读 | 软件层逻辑，API调用时需校验操作者Token |
6. 故障排查与优化
6.1 接口调用常见报错
Sign Error（签名错误）：芯步的签名算法通常涉及参数排序和时间戳（ts）。请核对官方SDK，确保参数按字母升序排列后再拼接SecretKey进行MD5或SHA加密。
Device Offline（设备离线）：检查配电箱内的WiFi信号。50A空开通常安装在金属铁箱内，对信号屏蔽极强。优化方案：若信号弱，需外接WiFi中继器或将天线通过延长线引出配电箱。
6.2 大功率稳定性处理
由于是50A大电流设备，合闸瞬间会产生浪涌电流（可能瞬间达到100A以上）。软件逻辑上应避免在重负载运行时频繁调用“通断”指令，以免继电器触点粘连。
7. 效益总结
通过以上改造方案，家庭配电箱不再是单纯的物理开关，而是具备“数字化灵魂”的能源节点：
安全性：软件实时监控线缆温度与电流，实现“电弧监测”与“过载预警告警”，防患于未“燃”。
节能性：通过精细化电量统计，精准找到家庭“电老虎”，辅助制定节能策略。
便利性：彻底解决了传统配电箱必须手动推闸的痛点，支持全屋一键断电/恢复。
开发提示：对接过程中可充分利用芯步物控控制台的 API调试工具 先行验证指令格式，再进行代码编写。