OpenGW 接入
本教程用一块 DLT698 电表演示：配置 OpenGW 网关，注册电表子设备，在联犀物联网后台核对读数和日志，最后到能耗中心查看同一块表的数据。
边缘网关实物参考。接口和接线以实际型号为准，下面通过 OpenGW 后台配置接入。
接入完成后的数据路径是：电表 → OpenGW 采集与上报 → 联犀物联网 → 能耗中心。本例已在能耗中心查到同一设备的累计电量记录，分别为 513.2700、513.2900 kWh。
首次按下面六步配置；通道和模型准备好后，同类设备可以复用，重点操作就是“选择设备 → 注册 → 核对数据”。
需要下载五类表计模型、继续配置能耗统计，或将 AI 画面绑定到总览、数字孪生与区域配电图，请继续阅读能耗管理完整实操；网关模板在这里下载。
需要核对通道身份、子设备注册和云端同步结果时，直接看OpenGW 云边协同与子设备同步，含当前后台的通道配置、节点身份与注册入口截图。
开始前
- 准备可登录 OpenGW 的账号，以及可管理自己联犀企业、项目和设备的账号；企业需有足够设备额度。
- 完成电表接线和网关联网，备好设备通信资料、表计地址及串口或网络参数。
- 使用自己的 SaaS 企业或私有部署环境。查看能耗页面还需要账号已开通能耗中心，并具有对应项目权限。
本文后台截图采集于 2026 年 10 月 14 日，展示的是同一电表的实际接入记录；实物图为硬件参考。截图保留各页面原始时间显示，不同页面可能使用不同的时间格式或时区。
1. 准备平台产品、网关身份和区域
操作位置：联犀物联网 → 设备接入 → 产品管理、设备管理。
- 直接选择平台已有的 opengw网关 产品，无需重新创建网关产品。
- 进入设备管理，在该产品下新建一台网关设备。选择自己的项目和区域，记录产品 ID 和网关设备编号。
- 打开该网关的 设备详情 → 设备接入，取得 MQTT 地址、端口、ClientID、用户名、密码，以及配置所需的设备密钥。连接参数由平台生成，不要手工拼接或复用其他设备的身份。
- 直接选择平台预置的 电表 产品并记录产品 ID；物模型与差值处理已经准备好。本例不新建产品或手工补物模型。水、气、热、煤也有对应的预置产品，见五类产品的选择位置。
这一步先创建网关设备、选定预置电表产品；电表子设备留到第 4 步从 OpenGW 注册，不必提前在云端再建一次。
本例使用独立项目“OpenGW 电表接入实采”和区域“实采电表”，便于与其他演示数据区分。自己的项目可以沿用已有区域。
| 信息 | 本例对应值 | 自己接入时从哪里取得 |
|---|---|---|
| 网关产品 ID | 65 | 网关产品详情 |
| 网关设备编号 | opengw-tutorial-20261014 | 刚创建的网关设备详情 |
| 电表产品 ID | 66 | 电表产品详情 |
| 电表设备编号 | opengw-meter-20261014 | 为该电表确定一个不与已有设备重复的编号 |
| MQTT 连接参数、设备密钥 | 不公开 | 自己的网关设备接入页面 |
检查结果：平台已有网关设备与电表产品，网关归属正确的项目、区域，连接参数可以取得。表中的编号只用于解释后续截图，不是可直接套用的公共接入参数。
2. 配置现场电表采集，先确认本地读数
操作位置：OpenGW → 下行通信 → 对应采集接口。
- 选择与现场设备一致的协议。本例为 DLT698，采集设备名称为“DLT698电表”。
- 配置或打开采集接口，按现场连接方式填写串口或网络参数；添加电表时，核对表计地址和设备模型。接线、地址、通信速率等以设备说明书和现场设置为准。
- 打开这台电表的 查看变量，检查累计电量、电压等属性是否有值，刷新后确认采集时间继续更新。
本例已经具备 DLT698 采集接口和电表模型。接入另一种型号时，应先完成其采集模型配置，再继续上报。
实采变量：TotalEnergy 为累计电量，单位 kWh；TotalEnergyRate1～4 是分费率电量。查看属性值时一起核对时间，避免把缓存值当作最新采集结果。
检查结果：本地能够持续读取电表数据。此时只证明网关采集正常，云端是否收到数据还要继续验证。
3. 配置联犀上报通道
操作位置：OpenGW → 上行通信 → 上报通道 → MQTT 转发。
添加服务，协议类型选择 联犀物联网平台，再填写第 1 步取得的网关参数。
| OpenGW 配置项 | 填写内容 |
|---|---|
| 服务名称 | 自己可辨认的名称，如“联犀-电表采集” |
| 服务地址、端口 | 自己平台提供的 MQTT 主机和端口，不填管理后台网页地址 |
| 设备上报周期 | 按业务需要设置；本例为 300 秒 |
| 用户名、密码 | 平台为这台网关生成的 MQTT 用户名和密码 |
| 客户端名称 | 平台生成的 ClientID |
| 产品 ID、设备 ID、设备密钥 | 网关产品 ID、网关设备编号及对应密钥，不是电表子设备的身份 |
本次配置界面，密码已遮挡；密钥未公开。页面中的编号对应本例网关，实际使用自己的连接参数。
保存后按页面提示重载网关服务，等待连接恢复，再检查上报通道状态和平台网关设备状态。已有其他采集任务时，应安排好服务重载时间。
检查结果：OpenGW 的联犀通道在线，联犀平台的这台网关也在线。本例新增了电表专用通道；已有共享通道时，先确认其用途，避免直接替换其他设备正在使用的连接身份。
4. 添加电表上报节点并注册子设备
操作位置：这条联犀上报通道 → 查看上报设备。
- 点击 添加设备，展开 DLT698 采集接口，勾选已能读到值的电表。
- 选择对应的上报模型。本例使用“DLT698模型”。
- 填写 电表产品 ID 和为该电表确定的 设备 ID，确认保存。这里填写子设备身份，与第 3 步的网关身份分开。
本例电表产品为 66，设备编号为 opengw-meter-20261014。新电表使用各自的设备编号，同型号设备可以复用模型。
先核对上报模型中的属性名称与平台电表物模型标识一致，例如：
| 上报字段 | 含义 | 单位 |
|---|---|---|
TotalEnergy | 累计电量 | kWh |
P | 总有功功率 | kW |
Ua | A 相电压 | V |
名称、类型和单位需要对应。已有相同模型可以复用；不同型号应按实际字段适配，不能只修改设备编号就假定数据含义相同。
然后在列表勾选电表，点击 注册设备到平台。
本次实际注册的电表节点，关联 DLT698 采集接口和模型；上方提供注册与手动上报入口。
回到联犀设备管理，按刚填写的电表设备编号查找子设备，打开 所属网关，确认关联到第 1 步的网关，并检查项目、区域归属。
检查结果：平台出现对应的电表子设备，所属网关和区域正确。若提示身份已存在，先核对已有记录，不要反复换编号注册同一块表。
5. 核对物联网数据和日志
操作位置：联犀物联网 → 设备接入 → 设备管理 → 该电表详情。
- 等待一个上报周期；需要立即核对时，可在 OpenGW 的该电表行点击 上报。
- 打开 日志 → 属性，检查累计电量、电压等字段的值、质量、数据时间和接收时间。
- 手动刷新或启用页面自动刷新，等待下一次上报，确认时间持续更新。需要回看时，进入对应属性的历史数据。
本次同一电表的云端实录：TotalEnergy 为 513.3 kWh，并有电压等属性及接收时间。具体值随现场读数变化，不要求与截图完全相同。
检查结果：设备编号一致，字段含义和单位正确，云端持续接收该电表的数据。只有“在线”或网关缓存有值，还不足以证明属性上报已经接通。
6. 在能耗中心查看同一电表
操作位置：能耗中心 → 电力集抄 → 电力数据。
- 切换到这块电表所属项目。本例为“OpenGW 电表接入实采”。
- 选择电表所在区域。本例为“实采电表”；再确认回路选择的是同一设备编号。
- 选择覆盖接入时间的查询范围，字段选择 总电能（TotalEnergy），设置查询间隔后点击 查询。
本次电力数据实录：同一电表的累计电量记录为 513.2700、513.2900 kWh。这里是累计读数，不是两个时段各自的用电量。
检查结果：能耗中心能查到同一电表的记录，数据与物联网侧的字段对应。更多查询方式见电力集抄说明。
累计电量与用电量怎么区分
TotalEnergy 是电表累计读数；P 是瞬时功率，二者不能混用，也不能把 513.3 kWh 直接当作当天用电量。
本例使用了已配置电量差值处理的产品链路：TotalEnergyChange 字段定义已预先导入；连续上报后，已启用并绑定的差值脚本根据相邻累计读数计算该字段的数值，供用能统计使用。首次接入先建立基准；两次读数未增长时，差值为 0。
自建产品时，仅增加 TotalEnergyChange 字段不会自动完成差值计算，还需要对应的处理配置。先确认电力数据正常，再核对差值字段是否收到有效上报；处理方式可参考协议脚本说明。
常见问题
网关通道一直离线
先确认网关能够访问 MQTT 服务地址和端口，再核对 ClientID、用户名、密码及其有效期。确认这些参数属于当前网关，并检查保存后是否按提示重载。管理后台能够登录，不等于 MQTT 服务已经连通。
点击注册后，平台找不到电表
确认勾选的是正确的电表节点，上报通道已在线；核对电表产品 ID、设备编号、产品注册与绑定条件。再检查当前登录企业和项目筛选，必要时在本企业设备列表按设备编号查找，不要只凭别名判断。
设备在线，但没有属性数据
先在 OpenGW 查看变量，确认本地采集时间仍在更新；再检查该电表是否关闭上报、是否已到上报周期，以及上报属性名称、类型和单位是否与平台模型对应。手动上报一次后，在云端刷新属性日志核对接收时间。
物联网有数据，能耗页面却为空
先检查能耗应用权限、当前项目、区域和回路，再检查查询时间范围及所选字段。累计电量能查到而用电量统计为空时，继续核对差值处理、连续上报和首次基准，不能用补造历史数据代替排查。
相关资料
更新日志
2026/10/27 13:18
查看所有更新日志
bf77e-于2b7ea-于7e927-于bddea-于dfe3a-于74719-于33dd7-于d4fa0-于82830-于4066c-于26b22-于