从网关接入到能耗与画面绑定
约 12278 字大约 41 分钟
能耗管理OpenGW网关模板大屏
2026-10-27
这篇教程带你走完:现场表计 → OpenGW → 物联网设备与数据 → 能耗统计 → AI 制作画面 → 发布并绑定到能耗管理。平台应用菜单目前显示为“能耗中心”,本文的“能耗管理”均指该应用。
第一次实施,请顺序阅读。已经接通设备的,可以直接看能耗配置、AI 制作画面;需要文件的,直接到五类网关模板下载。
先分清三种画面绑定
| 想做什么 | 在哪里配置 | 保存到哪里 | 日常怎么看 |
|---|---|---|---|
| 项目能源总览 | 能耗中心 → 大屏 → 能源大屏配置 | 当前项目 | 进入“大屏”,展示默认方案或选定的自定义画面 |
| 项目数字孪生 | 能耗中心 → 电力集抄 → 配电图 → 孪生 | 当前项目 | 在“孪生”页签查看整个项目的空间或设备场景 |
| 不同区域的配电图 | 能耗中心 → 电力集抄 → 配电图 → 区域 | 选中的区域 | 切换区域,查看该区域绑定的画面 |
组件绑定数据决定画面里显示哪台设备、哪个字段;页面绑定画面决定从哪个业务入口打开这张画面。两步都完成,才能从业务页面看到正确数据。三处展示配置分别保存,不会互相代填。
开始前准备
准备可管理企业项目的账号,确认已开通物联网、能耗中心及所需大屏管理权限。平台管理员身份不自动等于企业大屏管理权限;菜单不可见时,请管理员核对应用与角色授权。
先确认浏览器时区与平台统计日界一致。本次按北京时间(Asia/Shanghai,UTC+8)核对;跨时区浏览器不会自动改写平台的日统计口径,时区不一致会影响“今日/昨日”等范围。网关报文保留真实采集时间,不为匹配图表修改设备时间。
以“一台网关、一块电表、一个独立区域”为最小起点,记录:
| 资料 | 用途 |
|---|---|
| 平台地址、企业、项目、区域 | 让物联网、能耗查询与画面使用同一业务范围 |
| 网关产品标识、网关设备标识 | 取得该网关专属的连接身份 |
| 电表产品标识、电表设备标识 | 注册子设备、查询数据及绑定图上对象 |
| 电表型号、协议、地址、串口或网络参数 | 配置现场采集,不能从平台设备编号推断 |
| 物模型标识、单位与倍率 | 对齐采集字段与能耗统计 |
先在物联网项目管理中准备项目、区域;已有项目直接复用。在能耗中心切换到同一项目,在“设备空间 → 区域管理”核对区域与设备归属。设备分组用于检索和管理,不替代区域或计量关系。详细页面说明见设备空间。
直接使用预置的五类产品
平台已经提前创建好电表、水表、气表、热表、煤表五类能源产品,累计量和增量量的物模型定义均已预先导入,对应差值脚本及绑定也已准备。首次接入直接选用,不需要再逐类新建产品、添加物模型或编写差值脚本。
- 进入“物联网 → 设备接入 → 产品管理”,在“产品名称”输入“表”并搜索,找到带“公共产品”标记的电表、水表、气表、热表、煤表。接入网关时另行搜索已有的“opengw网关”产品。
- 点击对应产品名称进入详情,记录产品 ID。网关上报节点注册电表填电表产品 ID,注册水表填水表产品 ID,其余类型同理;不要填网关产品 ID。
- 按下一节下载对应的网关上报模型,在 OpenGW 中关联实际采集变量。平台预置产品负责云端的字段和统计,上报模型负责网关侧的字段对应,两者不是同一个导入步骤。
- 设备编号由你为每台表分别确定。产品可以复用,同一产品下的不同表计使用各自的设备编号。

2026-10-27,SaaS 演示账号的产品列表。按产品名称找到五类表计,使用自己环境页面显示的产品 ID;不照抄截图中的编号。

2026-10-27,本机 KVM 隔离联犀,默认电表产品 → 通用物模型。未设置列筛选,页脚显示“共 36 条记录”,列表分页展示;这一张用于核对完整属性数量,不是只有一个模型字段。产品 ID 使用自己环境的值。
查看顺序:先清空“物模型类型/功能名称/标识符”列的筛选,核对总数;再按标识符分别筛选 TotalEnergy 与 TotalEnergyChange,查看下列两项已有定义。这里只查询,不点击“导入物模型”或“新建自定义功能”。

2026-10-27,本机 KVM 隔离联犀。按标识符筛选 TotalEnergy,显示已预先导入的累计电量字段,类型 float、单位 kWh。这里是字段定义,不是电表实时读数;筛选后“共 1 条记录”只表示匹配一项。

2026-10-27,本机 KVM 隔离联犀。按标识符筛选 TotalEnergyChange,显示已预先导入的增量字段,类型 float、单位 kWh。字段定义一直存在;差值脚本计算并写入的是它的数值。这里只核对定义,数值要到设备属性日志查看。其他四类产品按同样方式核对累计与增量字段。
默认物模型与模板的对应关系
一份电表模板包含多个属性,并与默认电表产品的物模型逐项对应。 2026-10-27 核对默认初始化定义及本机隔离平台:默认“电表”产品共有 36 项属性,下载文件包含其中 35 项,标识符与平台完全一致;剩余的 TotalEnergyChange 字段定义也已导入,只是其数值由已启用并绑定的差值脚本计算,因此不放入网关上报模板。物模型定义与数据计算是两步:导入字段本身不会自动产生增量数值。
| 电表属性组 | 平台标识符,也是模板的 UploadName | 项数 |
|---|---|---|
| 组合有功电能及分费率 | TotalEnergy、TotalEnergyRate1、TotalEnergyRate2、TotalEnergyRate3、TotalEnergyRate4 | 5 |
| 正向有功电能及分费率 | EP、EPRate1、EPRate2、EPRate3、EPRate4 | 5 |
| 反向有功电能 | EQ | 1 |
| 三相电压 | Ua、Ub、Uc | 3 |
| 三相电流 | Ia、Ib、Ic | 3 |
| 总及各相有功功率 | P、Pa、Pb、Pc | 4 |
| 总及各相无功功率 | Q、Qa、Qb、Qc | 4 |
| 总及各相视在功率 | S、Sa、Sb、Sc | 4 |
| 总及各相功率因素 | PF、PFa、PFb、PFc | 4 |
| 电网频率 | Freq | 1 |
| 跳合闸属性 | Relay,本教程不执行控制 | 1 |
| 已导入、数值由脚本计算的电量增量 | TotalEnergyChange,不放入网关模板 | 1 |
五类模板均与当前默认导入的物模型逐项对应,只去掉数值由差值脚本计算的增量字段。水表同时保留默认的累计流量、阀门状态和阀门控制属性。
| 默认产品 | 平台属性总数 | XLSX 上报属性数 | 已导入但由脚本计算数值、不在 XLSX 中 |
|---|---|---|---|
| 电表 | 36 | 35 | TotalEnergyChange |
| 水表 | 4 | 3 | PostiveFluxChange |
| 气表 | 2 | 1 | TotalGasChange |
| 热表 | 2 | 1 | TotalHeatChange |
| 煤表 | 2 | 1 | TotalCoalChange |
同一默认产品可以供多台表计复用,每台表使用各自的设备编号;不用为每台表重新建产品或物模型。现场设备没有的点位不要伪造数值,按实际采集能力选用模板中的对应属性。判断模板是否配套,应核对 UploadName 与默认物模型标识符,并按实际采集能力使用。
五类网关模板下载
下载当前五类模板,导入 OpenGW 的「上行通信 → 上报模型」,直接使用平台默认产品。 文件已按 OpenGW V1.19.2 实际导出的上报属性表头核对,更新日期为 2026-10-27。
| 能源类型 | 单独下载 | 目标累计量/单位 | 文件说明 |
|---|---|---|---|
| 电 | 电表默认物模型配套模板(35 项)(在新窗口打开) | TotalEnergy/kWh;P/kW 等 | 对应默认电表 35 项属性,不含差值字段 |
| 水 | 水表默认物模型配套模板(3 项)(在新窗口打开) | PostiveFlux/m³ | 累计流量、ValveStatus、ValveCtrl |
| 气 | 气表默认物模型配套模板(1 项)(在新窗口打开) | TotalGas/m³ | 对应默认物模型,去掉差值字段 |
| 热 | 热表默认物模型配套模板(1 项)(在新窗口打开) | TotalHeat/kWh | 对应默认物模型,去掉差值字段 |
| 煤 | 煤表默认物模型配套模板(1 项)(在新窗口打开) | TotalCoal/t | 对应默认物模型,去掉差值字段 |
下载五类模板 ZIP 合集(在新窗口打开) · 使用说明(在新窗口打开) · SHA-256 校验清单(在新窗口打开)
水表包含 PostiveFlux、ValveStatus、ValveCtrl 三项;气、热、煤各保留默认累计量。累计量使用 double、2 位小数,水表枚举使用 uint32、0 位小数,与默认物模型及电表模板的枚举表示方式对应。它们是上报属性映射表,不包含采集寄存器或设备地址;现场协议与点位另行配置。水表枚举分别为 ValveStatus:0 开、1 关、2 异常;ValveCtrl:0 开阀、1 关阀。模板包含控制属性不代表执行控制。
导入入口与字段映射
- 在自己的 OpenGW 进入「上行通信 → 上报模型」,选中自己的测试上报模型;没有模型时先在自己的环境添加。点击属性区的「从xlsx导入」,打开“导入模型属性”弹窗。
- 选择本节对应文件,核对后上传。第二行应为
Index/Name/Label/UploadName/Type/Decimals/Min/Max/MinMaxAlarm/Step/StepAlarm共 11 列。当前版本弹窗没有空模板下载按钮;其他版本先与其自身导出表头核对。 Name对应实际采集变量名,按本地“查看变量”调整;UploadName对应平台物模型标识,保持下表拼写。Label为显示说明,序号唯一,计量类型使用 double。不要把PostiveFlux改成PositiveFlux。- 此表没有单位和读写权限列。目标单位写在新模型标签与配套说明中,平台直接使用预置计量物模型;不要自行添加不受支持的列。在下行采集侧按真实表计配置协议、设备地址、串口或网络参数及单位换算。
- 在上报节点关联实际采集设备和本次上报模型,填写自己的子设备产品 ID、设备编号和上报周期,再执行后文的「注册设备到平台」。这些连接参数不在本表中填写。

2026-10-27,用户提供的 OpenGW V1.19.2,只读打开弹窗并取消,未选择文件或上传。背景为已有上报模型,不要求使用截图中的模型名称。
| 上报目标 | 应关联的采集量 | 类型与单位 | 换算提示 |
|---|---|---|---|
TotalEnergy | 所需计量口径的累计有功电量 | double,kWh | Wh 转 kWh 除以 1000;核对组合/正向电量的区别 |
P | 总有功功率 | double,kW | W 转 kW 除以 1000 |
PostiveFlux | 累计用水量 | double,m³ | L 转 m³ 除以 1000 |
TotalGas | 累计用气量 | double,m³ | 工况量与标况量先统一口径,不只检查单位名称 |
TotalHeat | 累计热量 | double,kWh | GJ 转 kWh 乘以 1000 / 3.6 |
TotalCoal | 累计用煤质量 | double,t | kg 转 t 除以 1000 |
倍率只应用一次;设备、采集模型已经转换过的,不在上报模型再乘一遍。TotalEnergyChange 等增量字段已预先导入,其数值由差值脚本计算,不要把累计读数直接映射过去。
电表模板含 Relay,水表模板含 ValveCtrl,本教程只使用计量读取,不执行设备控制。增量字段的数值由差值脚本计算,不把累计读数直接映射到 *Change。
适用范围与采集协议
这些文件用于当前 OpenGW 的上报属性入口;DLT645、CJT188 文件名不表示它们可以代替下行采集驱动。实采示例使用 DLT698,采集协议、数据标识和设备地址仍按真实表计配置,字段映射按默认物模型核对。
验证范围:已核对实际导出表头、五类默认物模型与模板字段集合、类型、小数位、单位说明及下载副本;平台侧五类 MQTT 注册和差值已在隔离联犀中使用模拟量验证。远端网关没有执行导入、保存或注册,模板实际导入和现场五类表计采集仍未验证。
接入 OpenGW 并核对同一块电表
以下沿用 OpenGW 电表接入教程的实际链路;截图采集于 2026-10-14,不要求自己的读数与图片相同。
1. 准备网关与子设备产品
在“物联网 → 设备接入 → 产品管理”直接选择已有“opengw网关”和“电表”产品,记录两者各自的产品 ID。水、气、热、煤接入时改选对应的预置表计产品,均不需要重复创建产品或物模型。
在“设备管理”创建自己的网关,设置项目和区域。打开“网关设备详情 → 设备接入”,取得平台生成的 MQTT 主机、端口、ClientID、用户名、密码及所需密钥。这里是网关身份,后面注册电表时使用的是另一组子设备产品与设备标识。
2. 本地采集与上报通道
在 OpenGW“下行通信”的采集接口选择现场协议,填写表计地址、串口或网络参数、采集模型。打开“查看变量”,核对累计电量、电压等读数及持续更新的采集时间。本地无数时先解决通信,不继续改平台配置。

DLT698 电表历史实采截图,关注字段、单位和时间。
再到“上行通信 → 上报通道 → MQTT 转发”,选择“联犀物联网平台”,填写网关连接参数与上报周期。服务地址使用 MQTT 地址,不使用管理后台网页地址。按网关提示保存、重载后,检查通道与平台网关状态。

3. 关联上报节点并注册
进入该通道的“查看上报设备 → 添加设备”,选择已采到读数的电表及匹配的上报模型,填写自己的电表产品标识、设备标识。核对 TotalEnergy、P、Ua 等字段后,勾选设备执行“注册设备到平台”。云端注册完成前不必再手工创建一遍同一子设备。

回到物联网,按电表设备标识查找,核对所属网关、项目和区域。遇到身份已存在,先检查现有记录,不反复换编号注册同一块表。注册及拓扑机制见网关子设备。
4. 在云端确认持续收到数据
打开“电表详情 → 日志 → 属性”,等待上报周期,检查同一设备的字段值、数据时间与接收时间;再等待下一次上报,确认时间继续变化。需要即时验证时,在自己的网关节点执行一次上报。

通过条件:本地采集、平台设备身份、字段与单位一致,并且云端持续收到新数据。“在线”或网关缓存有值,不能单独证明子设备属性已上报。
OpenGW 云边协同与子设备同步
这里的云边协同,是 OpenGW 本地采集、联犀通道传输、云端设备与能耗应用使用同一批数据。下面沿用 OpenGW V1.19.2 的实际页面;其他版本的入口名称可能略有不同。
先配置通道,再同步子设备
进入“上行通信 → 上报通道 → MQTT 转发”,在联犀通道的编辑弹窗中核对协议为“联犀物联网平台”。连接身份来自云端网关,服务地址与端口来自该环境的 MQTT 接入配置;设备上报周期控制表计数据的发送频率。已有可用通道直接复用。

2026-10-27,用户提供的 OpenGW 演示后台,只打开既有通道查看后取消;连接凭据已遮挡。图中参数仅为演示环境的现有配置。
点击该通道“查看上报设备”,再打开目标表计的“编辑”,核对采集接口、设备、上报模型,以及以下对应关系:
| OpenGW 页面/上报参数 | 联犀物联网对应资料 | 填写要点 |
|---|---|---|
| 通道中的产品 ID、设备 ID | 网关产品 ID、网关设备标识 | 用于网关连接,不能换成表计身份 |
节点中的产品 ID(productKey) | 对应能源产品 ID | 电表选电表,水表选水表,其余同理 |
节点中的设备 ID(deviceKey) | 子设备标识 deviceName | 每块表独立编号;同一块表持续沿用原编号 |
| 设备名称、设备标签 | 本地采集节点与显示名称 | 名称相同不能代替产品+设备标识的核对 |
| 上报模型中的属性名 | 云端物模型标识符 | 如 TotalEnergy;大小写、类型、单位均需对齐 |

2026-10-27,只读查看。截图中的产品编号和电表地址不是通用默认值,接入时使用自己的资料。
勾选自己的上报节点,再执行“注册设备到平台”。这一步会通过网关向云端申请子设备身份;不要把“导入设备”或本地“添加设备”当作已经完成云端同步。首次创建的子设备应核对企业、项目、区域和所属网关,随后检查拓扑及属性数据。

2026-10-27,演示后台已有 DLT698 节点。此次只定位并截图入口,没有点击注册、即抄或上报。
在云端检查同步的三层结果
| 要核对的结果 | 在哪里看 | 通过条件 |
|---|---|---|
| 子设备身份与归属 | 物联网 → 设备管理,按节点中的设备 ID 搜索 | 产品+设备标识一致;新设备在预期企业、项目和区域 |
| 网关与子设备关系 | 网关详情的子设备列表,以及子设备详情的所属网关 | 两边指向同一对设备;只有设备记录、没有拓扑时不能算同步完成 |
| 属性与实际数据 | 子设备物模型、属性与属性日志 | 标识符、类型、单位一致,且持续收到新的数值和接收时间 |
五类预置产品已含计量字段,正常接入不需要再自动创建一套同名物模型。设备注册/拓扑同步、物模型定义和属性数据上报分别检查:同步了设备清单不代表已经采到数据;本地变量有值也不代表云端已接收。

2026-10-27,只读查看已有节点的缓存值。529.61 kWh 是当时的累计电量,不能当作当天用电量,也不是本机 KVM 的模拟读数。
需要排查物模型同步时,在云端网关详情“设备接入 → 网关子设备”查看当前环境的拓扑与物模型协议说明。预置能源产品通常直接使用已有字段;非标准点位才单独核对设备物模型权限与映射,不要把网关 Excel 文件直接导入平台 JSON 入口。
重复同步、断线与归属调整
- 重试注册:持续使用同一产品+设备标识,先检查每个子设备的返回结果,再查设备数量与拓扑;不要每次重试换编号。若设备已属于另一台网关,先核实实际归属,不用新编号绕过冲突。
- 调整项目或区域:首次自动创建设备时会按网关归属处理;已有子设备不会因再次注册就自动搬到新项目、新区域。迁移后分别核对网关、子设备、能耗查询和画面内部取数范围。
- 断线恢复:先检查通道恢复在线,再检查子设备新报文。只有网关开启并支持断线续传、且存在缓存记录时,才可能补传;不能把重新连接等同于历史数据已补齐。
- 新增或更换表计:新表使用独立设备身份并确认累计量基准;不要直接沿用旧表的历史累计值计算差值。
详细上报节点操作可对照 OpenGW 官方联犀 MQTT 转发说明。
配置能耗统计
品类、累计量与增量量
使用预置产品时,这部分配置已经准备好,直接查看上报数据并继续做能耗核验即可。 下表帮助你读懂字段,不是要求手工重建产品或配置差值脚本。能耗页面按能源品类和规定字段查询,设备别名叫“电表”并不足以被统计。
| 能源 | 品类编码 | 累计字段 | 增量字段 | 单位 |
|---|---|---|---|---|
| 电 | dianbiao(及对应电表子品类) | TotalEnergy | TotalEnergyChange | kWh |
| 水 | shuibiao | PostiveFlux | PostiveFluxChange | m³ |
| 气 | ranqibiao | TotalGas | TotalGasChange | m³ |
| 热 | liangrebiao | TotalHeat | TotalHeatChange | kWh |
| 煤 | meibiao | TotalCoal | TotalCoalChange | t |
预置链路会将连续上报的累计量转换为对应增量量。网关注册和属性上报正常后,直接检查字段数据;仅在出现问题时,按文末排障表核对差值处理。
补充:仅自建产品或更换网关产品时需要的配置
标准预置产品接入可以跳过此节。只有自行定义产品、替换默认网关产品或需要适配非标准字段时,才按以下步骤配置:
- 将表产品归到对应品类,核对累计量、增量量均为数值属性且单位一致;产品实际物模型也应包含这些字段。
- 在“物联网 → 设备接入 → 协议脚本”检查对应差值脚本;需要自建时参考协议脚本使用说明。选择上报预处理、物模型属性处理,并确认脚本支持网关
packReport内的子设备报文。 - 对本教程的 OpenGW 打包上报链路,脚本绑定到实际发送报文的网关产品,不是只绑定电表子产品。脚本和绑定均需启用;水、气、热、煤分别核对对应累计字段的处理。
- 保证子设备与网关拓扑已绑定。连续上报后,查看增量字段日志,确认计算发生。只增加一个名为
TotalEnergyChange的物模型属性不会自动产生用电量。
累计量 513.27 → 513.29 kWh,相邻增量为 0.02 kWh;513.29 不是当天用电量,P 也不是电量。首次采集需建立真实基准,没有变化时增量可能为 0。换表、清零或读数回退时应核对原始数据和差值处理,不能把整块表的历史累计量算成首日用量。
分时电量、尖峰平谷与电价设置
EPRate1、EPRate2、EPRate3、EPRate4 是正向分费率累计电量,不是四种电价。当前默认设置按费率 1/2/3/4 分别对应 尖/峰/平/谷;平台还预置了组合分费率累计电量 TotalEnergyRate1~4,当前电价配置及复费率报表读取这一组字段。
| 默认费率 | 时段名称 | 正向累计电量字段 | 当前设置与复费率报表读取的组合累计电量字段 | 单位 |
|---|---|---|---|---|
| 1 | 尖 | EPRate1 | TotalEnergyRate1 | kWh |
| 2 | 峰 | EPRate2 | TotalEnergyRate2 | kWh |
| 3 | 平 | EPRate3 | TotalEnergyRate3 | kWh |
| 4 | 谷 | EPRate4 | TotalEnergyRate4 | kWh |
- 进入“能耗中心 → 预付费管理 → 系统设置”,查看“峰谷电价”;在自己的实施环境启用后,填写尖、峰、平、谷的单价(元/kWh)并保存。
- 按表计说明书核对费率序号、时段和累计量的正向/组合口径,在网关中关联对应采集变量。这些是电表累计读数,电价设置不会修改电表自身的时段表,也不会替设备产生缺失的分时读数。
- 连续上报后,在设备属性日志分别查询
TotalEnergyRate1~4,再到“能耗分析 → 复费率报表”选择同一项目、区域和时间范围,核对各时段用量与费用。

2026-10-27,本机 KVM 隔离联犀。仅在浏览器临时展开“峰谷电价”表单和提示,未填写或保存价格;退出后回读,原单一电价配置不变。截图用于定位入口,不代表已经启用分时计费。
例如某时段峰电量期初为 100 kWh、期末为 102 kWh,峰用量为 2 kWh,再乘峰单价计算该时段费用。不要把期末累计量 102 kWh 全部计入本期。只上报 EPRate1~4 不会自动填充 TotalEnergyRate1~4;也不要未经计量口径核对就将正向电量复制成组合电量。查看报表前先确认它实际查询的四个字段已有有效历史。
在能耗中心核验
- 选择电表所属项目,进入“电力集抄 → 电力数据”。
- 选择区域与同一设备/回路,时间覆盖实际接入时段,字段先选“总电能(TotalEnergy)”并查询。
- 再查询增量字段,核对连续上报与差值结果;进入“能耗分析 → 用能概况/能耗趋势”,选择正确能源类型、区域及时间。
- 用能报表用于周期汇总;集抄明细结合起止累计读数核对。不同页面的字段、时间粒度与统计范围可能不同,不要求累计量表格与增量汇总逐格相等。

2026-10-14 历史实采:513.2700、513.2900 kWh 是累计读数。
新接入项目没有完整的昨日、上月或去年同期数据,同比环比可能为空;无需补造历史数据。总表已经覆盖下级回路时,不再把总表与全部分表相加。区域负责组织空间,计量覆盖关系仍需要根据现场总分表资料确认。更多页面用法见能耗分析与电力集抄。
让 AI 制作并绑定数据
以 WorkBuddy 为例,使用能读取文件、执行 CLI 并安装联犀 Skills 的 AI 工具。按本地 AI 安装教程安装、授权后重启工具。下面的方括号替换为自己的资料。
先查询目标与设备
按联犀本地 AI 安装教程检查 CLI 与 Skills;已有有效认证就复用。
先确认平台地址、当前企业与可访问应用,暂不修改业务数据。
目标是企业 [企业名]、项目 [项目名]、区域 [区域名]。
查询该范围的设备,整理产品标识、设备标识、区域、品类、
可用属性、单位、最新数据时间以及历史数据覆盖范围。
选定 [设备标识] 作为本次已接通的电表;重名和不确定映射单列。
请区分能源项目标识与大屏资源标识,不猜测 ID。制作总览、孪生与配电图
使用联犀大屏可视化 Skills,为已确认项目准备三种展示内容:
1. 能源总览:实时功率、今日用电、用电趋势。
2. 数字孪生:根据所给空间资料制作可点选设备的场景。
3. 区域配电图:根据所给一次图保留电气关系,在对应回路叠加读数。
已有适用模板时可复用;没有资料时先做总览,不猜测柜列与接线。
三者最终均须能通过平台已发布的 screen 大屏资源打开;
独立 HTML、模型文件或 3D 场景包还需要完成平台支持的接入和数据桥。
创建新资源前列出名称与所属项目;不覆盖现有大屏,不修改设备归属。
先完成本地方案和预览,列出拟创建或修改的内容供我确认,不发布、不绑定业务页面。没有图纸也可以先完成总览;2D/3D 的资料准备、授权截图及成品参考见用 WorkBuddy 制作配电室组态。不必为三种用途制作完全不同的技术系统,但每个用途应核对合适的画面、资源身份和设备范围。
给组件绑定正确的数据
| 示例组件 | 字段 | 取数方式 | 核对点 |
|---|---|---|---|
| 实时功率卡 | P | 已选电表的最新值,kW | 数据时间跟随实际上报,不把缓存当持续在线 |
| 今日用电卡 | TotalEnergyChange | 当天范围求和,kWh | 起止时间与时区一致,不对累计电量求和 |
| 用电趋势 | TotalEnergyChange | 选定时间按小时/天求和 | 历史不足显示空缺,桶粒度适合所选时间 |
| 图上电压标签 | Ua 等实际存在的属性 | 对应设备最新值,V | 图上回路与产品/设备唯一身份对应 |
请先输出“图上对象/组件 → 项目/区域 → 产品标识+设备标识 → 字段 → 单位”对应表。
按上表分别配置最新值、增量求和和历史趋势,明确时间范围、时区和刷新间隔。
刷新间隔与现场上报周期匹配;不要把刷新更快理解为采集更快。
聚合时只计入已确认的表计范围,避免总分表和多个画面重复计量。
无权限、无数据、过期和查询失败分开提示,不填正常数值或 0。
请验证数据绑定并提供预览,与平台设备详情和能耗查询结果逐项对照。
交付大屏资源名称与 ID、所属项目、对应表、仍待确认的映射;不交付访问密钥。手工核对时,在大屏设计器选中组件,打开右侧“数据”,检查 IoT 数据源、产品/设备或区域、字段、时间和聚合配置。详细操作见数据绑定。把画面绑定到某区域,不会自动把所有组件的数据范围改成该区域。
保存、预览、发布
预览中抽查同一块电表的读数、单位、更新时间与趋势;再检查空数据和窗口缩放。确认要发布的资源及项目后,才让 AI 或操作人员执行保存、发布。画面需是企业下可访问且已发布的 screen 资源,系统模板本身不能直接作为业务大屏选用。
修改后先保存,再重新发布并核对发布页面。预览更新不等于发布版本已更新;不要通过重复新建同名大屏解决缓存或版本问题。发布访问仍需遵循当前平台鉴权与数据权限,不能将发布理解为所有数据都免登录。更多见预览与发布。
绑定能源总览大屏
- 进入能耗中心,核对左下角当前项目,再打开“大屏”。
- 默认方案中,在 1.5 秒内连续点击顶部“能源管理数据大屏”文字 5 次,打开“能源大屏配置”。当前已是自定义画面、没有标题时,按 F12 在浏览器控制台执行
ccd();也可执行openEnergyDashboardSetting()。 - 选择“自定义大屏”,搜索并选中刚确认的已发布大屏。核对名称及资源 ID,不只靠相同封面判断。
- 点击“保存”,等待页面加载,检查实际展示的画面与组件数据。
- 更换画面时重新打开配置、选中另一个资源并保存。恢复默认时选择“默认大屏”并保存;它会恢复内置总览,不删除自定义画面。

2026-10-27,SaaS 现有演示项目的只读截图;本次仅打开并取消弹窗,未保存配置。

现有自定义画面,含模拟表计数据,不代表现场采集或节能成效。
配置属于当前项目;切到另一个项目时读取另一个项目自己的设置,返回原项目会读取原设置。选择同一张大屏也不会自动替换其内部设备。若加载失败回退默认大屏,先检查资源可用性与权限,不把回退当成保存成功。
绑定数字孪生
- 确认孪生内容已接入为可打开的已发布大屏资源,并核对设备映射。独立 3D 模型或本地网页还不是可选资源。
- 进入“电力集抄 → 配电图”,点击左侧“孪生”页签;这处是项目级绑定,不先选择某个楼层来绑定整个项目。
- 未绑定时点击“绑定大屏”;已有绑定时在左侧卡片点击“更换绑定”。
- 在弹窗搜索、选择目标资源,点击“确定”后即保存绑定,不需要再找另一处“保存”。右侧加载选中画面,左侧显示当前绑定名称。
- 点选场景中的仪表,核对产品/设备身份、读数、单位、时间与趋势;场景支持的旋转、漫游等交互由画面自身提供。
- 需要更换时重复选择;不再展示时点击“解除绑定”。该操作直接清除本项目的孪生绑定,不删除大屏或设备。操作前确认当前项目。

2026-10-27,SaaS 已有“联犀智慧园区”孪生配置;画面为演示场景,本次未改绑定。

本次只查看候选资源并取消,没有点击“确定”。总览设置使用“保存”,此弹窗使用“确定”。
重新进入配电图或切换项目时,该项目若已有孪生绑定,页面默认显示孪生;没有绑定则默认显示区域。本次页面内手动切换页签后,不会因后台加载完成而强制跳回孪生。孪生绑定与“大屏”菜单的总览绑定分别保存。
绑定区域配电图
- 准备对应区域的配电画面,确认图上的回路、设备和字段映射,保存并发布为大屏资源。
- 进入“电力集抄 → 配电图”,点击“区域”页签,在左侧搜索并选中实际区域。右侧标题应变为该区域名称;再次点击已选节点可能取消选择,若出现“请选择区域”,重新点选目标节点。
- 未绑定时点击“绑定大屏”。当前区域页没有独立的“更换绑定”按钮;更换已有画面时,先记录原资源名称与 ID,点击“解除绑定”,再点击“绑定大屏”选择新画面。中间会短暂显示未绑定。
- 搜索并选中该区域的画面,点击“确定”即保存。检查右侧画面和取数范围。
- 切换其他区域,分别配置各自画面;父区域绑定不等于所有子区域自动继承。回到原区域,确认原绑定仍能打开。
- “解除绑定”点击后直接清除当前选中区域的绑定,不删除大屏或设备,也不影响项目孪生、项目总览及其他区域;操作前确认右侧区域名称。

2026-10-27 的现有演示区域;未为截图补建区域或补绑画面。

只打开弹窗后取消。实际绑定需要确认区域,再选择符合用途的资源;列表里的画面不一定都是配电图。
查看时用工具栏“放大/缩小”“重置缩放”“全屏”,放大到 100% 以上后可拖拽平移,也可收起左侧区域面板。复位回到适配容器的 100%,不是把原画布按物理像素铺满;比例不同会有留白。画面自身的 3D 摄像机复位与外层画布缩放复位是不同操作。
一次图与配电图的关系
一次图是一种电气关系表达方式,区域配电图是本教程实际承载和绑定画面的业务入口。旧说明中的“能耗分析 → 一次图”不应理解为另一套已完成的绑定入口:当前能耗应用未提供该独立菜单,相关历史页面仍为空状态。需要使用 2D 一次图时,先制作成可用的大屏,再按本节绑定到对应区域;3D 配电室可按上一节绑定到项目孪生。
取消发布与解除绑定的区别
当前实现中,取消发布会使资源从已发布候选列表隐藏;资源仍在且账号有权限时,已有绑定仍会读取此前的发布快照。要停止某个业务入口的展示,应在该入口解除绑定或恢复默认,不把取消发布当作解绑。保存编辑内容也不会覆盖发布快照,改完需再次发布,并重新打开或刷新业务页面。
排障与交付检查
| 现象 | 按顺序检查 |
|---|---|
| 注册返回“只允许管理员操作”(100012) | 本次隔离验收发现平台自动注册内部权限校验会阻塞合法网关,已在验证版修复;请平台管理员确认已包含该修复。不要向网关连接身份中填写用户管理员令牌,换编号或重导模型也不能修复平台权限问题 |
| 注册后没有子设备/拓扑 | 节点产品 ID 与设备 ID、动态注册权限、逐设备注册结果、所属网关;同名显示名不代表同一设备 |
| 网关有读数,物联网没有 | 通道在线、上报节点启用、子设备身份与拓扑、属性拼写/类型/单位、云端接收时间 |
| 能查累计量,用能统计为空 | 产品品类、增量属性、网关产品上的差值脚本及启用绑定、连续上报、首次基准、查询时间 |
| 当日数据落到昨日同期 | 核对浏览器与平台日统计时区。本次 UTC 浏览器曾出现此现象,按平台业务时区 UTC+8 核对后恢复正确;不要改设备采集时间或补造历史 |
| 统计明显偏大 | 累计字段是否误求和、倍率是否重复、总分表是否重复、首报是否误作增量 |
| 大屏候选列表为空 | 当前项目、企业与权限、资源类型为 screen、是否已发布、搜索条件;有模板但无业务大屏时先从模板创建 |
| 有数据,但图上没数据 | 对照图上对象的产品+设备身份、字段、单位、时间和权限;更换展示绑定不修复组件绑定 |
| 切换区域仍是原来的设备 | 检查当前区域绑定的大屏,以及其组件是否仍固定为原设备;页面切换不自动改写取数配置 |
| 配电图显示“请选择区域” | 检查左侧是否仍选中区域;再次点击已选节点可能取消选择,重新点选目标区域 |
| 资源不存在或没有权限 | 先核对资源和权限,在孪生/区域页使用“重新绑定”恢复;总览可能回退默认,回退不等于已改写保存的配置 |
| 编辑器改了,展示页没变 | 同一资源 ID、是否保存并重新发布、发布版本是否更新,再刷新业务页面 |
| 进入配电图先看到孪生 | 当前项目已有孪生绑定,属于默认展示规则;需要区域时点击“区域”页签 |
| 图纸或 3D 文件不在候选列表 | 先完成平台支持的场景接入与大屏资源创建,单独文件/模板不等于已发布 screen |
交付前逐项核对:
- 从网关变量到平台日志、能耗查询、图上对象,始终是同一台设备。
- 功率与电量、累计量与区间用量分清;单位、时区、时间范围及聚合一致。
- 设备离线、数据过期、无权限、无数据不会被正常读数或 0 掩盖。
- 总览、项目孪生、区域配电图分别检查当前绑定;不要以一处成功代替三处验收。
- 保存资源名称与 ID、所属项目、区域绑定清单、组件设备对应表、发布版本和未确认事项。
本次隔离验证与适用边界
2026-10-27,新建本机 KVM 部署联犀,使用普通企业账号、预置五类产品和真实 MQTT 连接,模拟网关注册、拓扑与累计量上报。以下读数为模拟量,不是现场实采;远端 OpenGW 仅只读查看,没有改接测试平台。 平台注册权限阻塞修复后,下列链路通过验证。

本机隔离平台的五类子设备。测试客户端已关闭,所以显示离线;不是通过手工创建五台子设备代替网关注册。产品与设备编号以自己的环境为准。

同一电表最新 TotalEnergy=100.5、TotalEnergyChange=0.25,单位来自产品物模型 kWh。网关上报累计量,增量数值由已启用并绑定的差值脚本计算。
| 类型 | 三次上报的累计量 | 最新增量 | 后两次增量合计 | 单位 |
|---|---|---|---|---|
| 电 | 100 → 100.25 → 100.5 | 0.25 | 0.5 | kWh |
| 水 | 200 → 200.5 → 201 | 0.5 | 1 | m³ |
| 气 | 300 → 300.75 → 301.5 | 0.75 | 1.5 | m³ |
| 热 | 400 → 401 → 402 | 1 | 2 | kWh |
| 煤 | 500 → 501.25 → 502.5 | 1.25 | 2.5 | t |
在“能耗分析 → 用能概况”选择同一区域,按平台业务时区核对,今日电/水/气/热/煤分别为 0.50 kWh、1.00 m³、1.50 m³、2.00 kWh、2.50 t,与上表区间增量合计一致;昨日同期没有历史,显示缺数,不把累计量当作用量。

本机隔离模拟数据,浏览器与平台统计日界均按 UTC+8 核对。累计电量 100.5 kWh 对应本次两次变化产生的用电量 0.5 kWh,不应混用。
重复注册未产生重复身份;首次创建继承网关项目与区域;网关更换区域后重复注册不迁移已有子设备;另一网关不能重复认领已有子设备。子设备的“所属网关”也已从浏览器核对。

本机隔离验证,模拟电表关联到本轮模拟网关 A,不代表远端现场设备。
总览大屏、项目孪生、区域配电图已分别验证保存、解除、恢复和更换流程;另验证项目切换、区域切换、空列表、坏引用提示与恢复、发布快照更新,以及放大、平移、复位和全屏。画面组件读取同一模拟电表,业务入口切换不会改写组件内的设备身份。

这是核对累计量 100.5 kWh 的极简测试画面,不是 AI 设计成果;本次孪生入口复用二维画面验证绑定机制,没有把它描述成 3D 场景制作或漫游验收。
| 验证层次 | 本次结果 |
|---|---|
| v2 五份文件、字段与单位说明、下载及 ZIP | 通过;表头与当前 OpenGW 只读导出文件一致 |
| 平台 MQTT 注册、拓扑、归属、冲突、五类差值 | 通过;使用模拟累计量 |
| 五类能耗概况 | 通过;浏览器按平台业务时区 UTC+8 核对当日用量,跨时区浏览器自动适配不在本轮修复范围 |
| 三类绑定与浏览器使用 | 通过;配置写入仅发生在本机隔离平台 |
| 网关实际上传/导入五份 XLSX | 未执行,远端网关保持只读 |
| 五类现场表计采集 | 未执行;历史电表记录单独注明来源 |
| WorkBuddy 在线生成、3D 制作与漫游 | 未执行;本次未为新 KVM 配置模型服务凭据 |
素材与验证说明
| 素材 | 来源与范围 |
|---|---|
| OpenGW 联犀通道、节点身份、注册入口与变量截图 | 2026-10-27 用户提供的 OpenGW V1.19.2 后台,只读查看;编辑弹窗截图后取消,未注册、同步、重载或控制 |
| 网关注册、上报与电力数据截图 | OpenGW 接入,2026-10-14 同一电表的历史实采记录 |
| 物联网预置产品列表,以及总览、孪生、区域和选择弹窗 | 2026-10-27 SaaS 现有演示项目,只读查看与截图,未保存、发布、解绑、导入或控制设备 |
| AI 操作方法 | 整合既有 OpenGW、能源 AI 与 WorkBuddy 公众号存稿,按当前配置流程重写;配电室材料见WorkBuddy 教程 |
| 五类下载模板 | 按当前 OpenGW 实际导出的 11 列上报格式与默认物模型逐项核对,分别排除对应差值字段;实际导入状态见模板说明 |
| 尖峰平谷设置截图 | 2026-10-27 本机 KVM 隔离联犀,临时展开表单、未保存;字段映射与当前设置和复费率报表实现核对 |
| 默认电表完整列表、累计与增量字段定义 | 2026-10-27 本机 KVM 隔离联犀,默认导入的 36 项属性;只读切换页签和筛选,未新增、导入、修改或删除物模型 |
| KVM 子设备、所属网关、日志与极简画面 | 2026-10-27 本机隔离联犀,真实 MQTT 协议、模拟读数;不代表现场实采,未改 SaaS 演示数据或远端通道 |
截图中的计量值只说明当时界面;演示模拟数据、历史实采和本教程配置步骤分别标注,不将其拼成同一次完整实施实录。
更新日志
2026/10/27 13:18
查看所有更新日志
bf77e-docs(能耗管理): 完整接入教程、默认模板与三类画面绑定于
