# 能源网关上报模板

适用：OpenGW V1.19.2「上行通信 → 上报模型」，2026-10-27 核对。五份模板均按默认导入的物模型生成，只排除由差值脚本计算数值的增量字段。平台中的累计量和增量字段定义均已预先导入。

| 文件 | 平台属性数 | XLSX 属性数 | 不放入网关模板的差值字段 |
| --- | --- | --- | --- |
| DLT645电表.xlsx | 36 | 35 | TotalEnergyChange |
| CJT188水表-上报模型.xlsx | 4 | 3 | PostiveFluxChange |
| 燃气表-通用上报模型.xlsx | 2 | 1 | TotalGasChange |
| 热量表-通用上报模型.xlsx | 2 | 1 | TotalHeatChange |
| 煤耗计量-通用上报模型.xlsx | 2 | 1 | TotalCoalChange |

## 与默认物模型对应的属性

- 电表：`TotalEnergy`、`TotalEnergyRate1～4`；`EP`、`EPRate1～4`；`EQ`；`Ua/Ub/Uc`；`Ia/Ib/Ic`；`P/Pa/Pb/Pc`；`Q/Qa/Qb/Qc`；`S/Sa/Sb/Sc`；`PF/PFa/PFb/PFc`；`Freq`；`Relay`，共 35 项。范围写法代表多个独立标识符。
- 水表：`PostiveFlux`（累计流量，m³）、`ValveStatus`（阀门状态：0 开、1 关、2 异常）、`ValveCtrl`（阀门控制：0 开阀、1 关阀），共 3 项。
- 气表：`TotalGas`（累计用气量，m³）。
- 热表：`TotalHeat`（累计热量，kWh）。
- 煤表：`TotalCoal`（累计用煤量，t）。

水、气、热、煤模板的累计量按默认物模型 step=0.01 设置为 double、2 位小数；水表两个枚举按电表 Relay 的表示方式使用 uint32、0 位小数。表头没有读写权限或枚举映射列，权限及枚举含义以平台物模型和设备资料为准。Relay、ValveCtrl 是默认产品中已有属性，模板包含属性映射不代表执行控制；本教程不进行跳闸或阀门控制。

## 尖峰平谷与分时电量

| 默认费率序号 | 用途 | 正向累计电量 | 当前设置与复费率报表读取的组合累计电量 |
| --- | --- | --- | --- |
| 1 | 尖 | EPRate1 | TotalEnergyRate1 |
| 2 | 峰 | EPRate2 | TotalEnergyRate2 |
| 3 | 平 | EPRate3 | TotalEnergyRate3 |
| 4 | 谷 | EPRate4 | TotalEnergyRate4 |

两组字段均为 kWh 累计量，不是电价或区间增量。采集时核对电表自身的费率序号、时段和计量口径；当前平台设置及复费率报表读取 TotalEnergyRate1～4，仅上报 EPRate1～4 不会自动填充另一组字段。不要未核对正向／组合口径就直接复制数值。费用按各费率期末与期初读数的差值乘以对应电价计算，不把整段历史累计量直接计费。

## 导入入口与需要修改的参数

1. 在自己的网关进入「上行通信 → 上报模型」，选择自己的上报模型；没有模型时添加。
2. 点击「从xlsx导入」，选择对应文件并核对后上传。它是上报属性映射，不是「下行通信 → 模型管理」的协议采集属性表，也不是平台产品物模型 JSON 导入文件。
3. 第二行保持 `Index/Name/Label/UploadName/Type/Decimals/Min/Max/MinMaxAlarm/Step/StepAlarm` 共 11 列。
4. `Name` 按实际采集变量名修改，`UploadName` 与默认物模型标识符一一对应并保持大小写。`PostiveFlux` 沿用平台拼写。Label 为显示说明，Index 唯一。
5. 子设备产品 ID、设备编号、关联的采集设备与模型、上报周期在上报节点配置；串口、设备地址和协议点位在下行采集侧配置，不填写到本表。

单位：电量 kWh、功率 kW、水／气 m³、热量 kWh、煤耗 t。按需换算：Wh→kWh、W→kW、L→m³、kg→t 均除以 1000；GJ→kWh 乘以 1000/3.6。倍率只应用一次。

`*Change` 字段定义已导入，其数值由绑定到网关产品且已启用的差值脚本计算；模板去掉这些字段，网关不重复计算。现场没有的点位不伪造数值，按设备实际采集能力选择属性。

## 验证范围

已核对实际网关导出的 11 列表头、五类默认物模型的字段集合与类型、单位、小数位、源文件与下载副本、ZIP 及 SHA-256。平台侧 MQTT 注册、拓扑及差值在隔离联犀中使用模拟量验证。远端网关仅只读查看；模板实际导入和现场五类表计采集尚未验证。