芯步的40A物联网计量断路器提供开放的HTTP接口，支持实时上报电压、电流、功率、电能等数据。以下方案说明如何通过对接这些接口，实现从数据接收到能耗报表生成的全流程。

1. 背景与概述

随着企业数字化转型的深入，用电能耗的精细化管理成为成本控制和节能减排的关键。芯步推出的智能大功率断路器[计量版]（型号：UNI-DLQ-M-40A-P），不仅具备传统的过载保护和远程通断控制功能，还集成了高精度的电能计量模块。

本方案的目标是指导开发者如何利用该产品完全开放的HTTP接口，将其无缝对接至企业内部系统（如ERP、能源管理系统或自研SaaS平台），实现自动化生成用电能耗报表。

通过本方案，企业将能够实现：

• 实时数据采集：自动获取设备的电压、电流、功率及累计电能。

• 报表周期管理：按小时、日、月、年维度自动生成能耗统计报表。

• 决策支持：通过数据分析识别高能耗设备或用电异常时段，为节能优化提供数据依据。

2. 对接技术架构

本方案采用 “设备直连+服务器接收+业务处理” 的简化架构。由于芯步断路器支持WiFi 2.4G直连且无需网关，极大降低了硬件成本和故障节点。

• 设备层：40A物联网计量断路器，负责采集电气参数并执行分合闸指令。

• 传输层：设备通过WiFi网络，使用HTTP/HTTPS协议主动推送数据到指定的公网或私有化服务器。

• 数据接收层：企业内部服务器（或云服务器）上的API接口，负责接收并校验设备上报的数据。

• 数据持久化层：时序数据库（TimescaleDB, InfluxDB等），用于存储海量的连续电能数据。

• 应用层：报表服务与前端可视化界面（ECharts/Tableau），生成最终报表并提供查询服务。

3. 前期准备与配置

在开始编码对接前，请完成以下准备工作，整个过程通常可在10分钟内完成

1. 注册与创建应用：在芯步开发者平台注册账号，进入工作台获取 AppID（开发者ID）和 AppSecret（开发者密码）。这是后续API调用和数据验证的身份凭证。

2. 设备配网与激活

   • 给40A断路器接通电源。

   • 参照产品手册，通过设备自带的配网模式（或扫码），将设备连接到本地2.4G WiFi网络。

   • 确保设备在平台“设备列表”中显示为“在线”状态，此时设备已具备互联网通信能力。

3. 开发环境设置

   • 确定服务器地址：确定您的公网或内网服务器可访问地址（如 http(s)://yourdomain.com/api）作为数据接收端点。

   • 配置消息推送：在芯步控制台中，“开发设置”里配置 消息推送URL。将设备的实时数据上报地址指向您的服务器。

   • 签名与安全：在生产环境中，请请一定要规范计算sign签名（通常是将AppSecret配合时间戳ts进行MD5或SHA加密），以防止非法数据注入；开发测试阶段可开启“调试模式”暂时屏蔽签名校验以便快速打通流程。

4. 数据对接与处理流程

4.1 设备上行数据接收（核心环节）

设备对接的核心在于处理断路器主动上报的计量数据。芯步的设备在状态变化或定时心跳时，会向您配置的URL推送JSON格式的数据。

典型的上报数据模型示例（开发者需据此设计数据库表结构）：

服务器端处理逻辑

1. 接收与验签：编写POST接口接收JSON数据。如果未开启调试模式，需验证Header或URL参数中的签名是否正确，防止伪数据。

2. 数据清洗：检查数据是否越界（电压为0或负数则丢弃）。

3. 入库存储

   • 使用时序数据库。因为断路器会产生无限连续的数据点，时序数据库的写入性能远优于传统MySQL。

   • 存储粒度：保存每一笔上报的原始数据（原始数据用于回溯），并同步更新设备的最新状态表。

4.2 下行控制与参数设置（辅助功能）

生成报表不仅仅是被动看数据，有时也需要主动获取数据或控制负载。

• 主动查询：若某时段网络波动导致数据缺失，可以通过HTTP接口主动查询设备的当前状态。

• 远程分合闸：在报表发现异常高功率运行时，可通过调用控制接口远程跳闸保护。

接口调用示例（向设备下发命令）：

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

• Method：POST

• Body

（注：具体的命令格式请以官方最新产品手册为准）

5. 能耗报表生成实现

当数据稳定流入数据库后，报表生成的难点在于统计算法的设计与查询优化。以下是几种典型报表的SQL逻辑（伪代码）定义：

5.1 日报表（按小时/半小时颗粒度）

目标：分析一天内各时段的用电高峰。逻辑

1. 取出该设备某天内所有上报点的 energy（累计电能）值。

2. 计算能耗增量当前小时最后一条数据的energy - 当前小时第一条数据的energy。

3. 补充边界处理：如果设备在某个时间段离线或未上报数据，系统需进行插值处理或标记为“数据缺失”。

5.2 月报表（按天颗粒度）

目标：对比本月每天的用电趋势。逻辑

1. 获取本月每日的起始累计电能和结束累计电能。

2. 日用电量 = 本日结束累计电能 - 上日结束累计电能。

3. 环比计算(当日用电 - 昨日用电) / 昨日用电，用于发现某天用电突增。

5.3 自动告警与异常标注

在生成报表的同时，增加能耗异常检测功能，使报表更具业务价值：

• 阈值告警：设定单日超过100kWh则自动标红。

• 时段异常：非工作时间（如凌晨）如果功率大于50W，系统自动在报表备注中生成“疑似待机耗电过高”的。

6. 报表可视化展示

通过前端框架将处理好的数据渲染为图表，构建能源看板：

1. 实时仪表盘：展示当前总功率、今日累计用电、实时电流电压。

2. 趋势折线图：展示功率曲线，结合时序数据库的查询接口，秒级响应展示一天内的负荷变化。

3. 能耗柱状堆叠图：展示周/月/年各回路的用电对比。

4. 导出功能：将上述计算结果（如每日用电明细表）导出为Excel/CSV格式，供财务部门进行成本分摊。

7. 总结

通过对接芯步40A物联网计量断路器的开放HTTP接口，开发者并不需要理解复杂的嵌入式协议，只需关注数据的接收（HTTP Server） 与对累计电能（energy字段）的差值计算逻辑。

该系统一旦落地，不仅能为企业提供了准确的用电能耗报表，同时也保留了远程控制的能力，实现了从“数据监控”到“智能执行”的管理闭环。