VRM 数据不显示：GX 网络故障与代码 #150–159

01首先检查

GX 设备屏幕显示电池、太阳能板和负载概览，可在此检查 GX 是否正在采集设备数据。 — GX 设备屏幕显示电池、光伏组件和负载概览，您可在此检查 GX 是否正在采集设备数据。

Last contact（Settings → VRM → Last contact）：与 VRM 门户最后一次联系的时间戳。横线（“--”）表示 GX 设备自上电以来尚未连接到门户。
Stored records：数值为 0 表示所有数据均已成功发送。大于 0 表示存在因连接问题而未发送的日志，通常同时显示错误信息。
Connection error：Ekrano GX 无法与 VRM 数据库通信。
VRM 门户访问权限必须设为 Full（默认）或 Read-only。设为 Off 时，无法向 VRM 传输日志。Remote Console on VRM 也需要此设置。
GX 设备使用最新固件。
GX 是否正在采集设备数据：Ekrano GX 先采集所有已连接产品的数据，再将其发送至 VRM。如果 GX 设备列表中缺少逆变器、MPPT 控制器或电池监控器，请先查看GX 无法识别设备。

02按连接类型排查

笔记本电脑、手机和手表上的 VRM 门户，后续步骤用于排查通过以太网、Wi-Fi 和 LTE 连接时数据缺失的问题。 — 笔记本电脑、手机和手表上的 VRM 门户：后续步骤针对使用 Ethernet、Wi-Fi 和 LTE 时这些数据不显示的问题。

1以太网

插入以太网线之前，请勿将 Ethernet 端口与 VE.Bus 或 VE.Can/BMS-Can 端口混淆：它们均采用 RJ45 接口。
背面 Ethernet RJ45 插头旁的两个指示灯应亮起或闪烁。两个指示灯均熄灭表示连接存在问题。
如果 State 显示 Unplugged，请检查网线及 GX 设备上的连接指示灯。
Ekrano GX 默认通过 DHCP 自动获取 IP 地址。State 应显示 Connected；IP 地址不能以 169 开头；子网掩码、网关和 DNS 服务器均应存在。以 169 开头的地址表示自动分配地址出现问题；请检查网络中的 DHCP 是否正常运行。如果没有 DHCP，请手动配置 IP 地址。
IPv6 仅支持自动配置，不支持手动配置。
Wi-Fi 本身的可靠性低于以太网。条件允许时，请使用以太网。
无论 Wi-Fi 或 LTE 是否可用，以太网始终具有最高的互联网接入优先级。优先级仅取决于接口是否可用，而不取决于该接口是否真正能够访问互联网。每个以太网和 Wi-Fi 接口都有允许其用于互联网接入的选项，关闭该选项会移除默认网关，仅保留本地子网内的通信。无论 IP 设置为 Automatic (DHCP) 还是 Manual，此选项均独立生效。
需要允许通过端口 80 和 443 向 ccgxlogging.victronenergy.com 发起出站 HTTP(S) 连接。不支持代理配置。
请选择适合无人值守运行的路由器。避免使用用于临时接入的廉价消费级路由器。文档中列举的示例包括 Proroute H685 4G LTE 和 Pepwave Industrial 4G Router 系列。

2 Wi-Fi

Ekrano GX 内置 Wi-Fi，可连接采用 WEP、WPA 和 WPA2 的网络。不支持 WPS（WiFi Protected Setup）。
内置 Wi-Fi 仅支持 2.4 GHz。设备可能检测到 5 GHz 网络，但无法连接。
使用 Wi-Fi 连接时，信号强度应至少达到 50%，以保持可靠运行。
Wi-Fi 菜单显示所有可用网络。请选择网络，如果尚未保存密码，请输入密码。若 State 显示 Failure，可能是密码不正确；请使用 Forget network（忘记网络），然后用正确密码重新连接。
出现 No WiFi adapter connected 提示时，请重新插入 Wi-Fi USB 适配器。
当有多个已知网络可用时，Ekrano GX 会自动连接信号最强的网络。如果当前网络的信号明显减弱，设备会切换到信号更强的已知网络，前提是该网络可用。
以太网不可用时，设备会使用 Wi-Fi，无论 LTE 是否可用。GX 设备可以同时连接以太网和 Wi-Fi；此设置不适用于 LTE 接口。
需要通过登录页面或接受使用条款才能接入的网络（captive portal）无法使用，GX 设备无法接入此类网络。
由于可靠性不足，请避免使用网络共享连接和移动热点。可以通过 USB 网络共享使用手机的互联网连接，但文档不建议使用此类连接。
可以连接受支持的外置 USB Wi-Fi 适配器，例如改善设备在机柜内的信号接收。其他适配器可能可以使用，但未经测试，厂家也不提供支持。除官方 GX GSM 和 GX LTE 4G 配件外，Ekrano GX 不支持其他 USB 宽带适配器。
支持的适配器（零件编号和型号）：BPP900100200 — CCGX WiFi Module Simple (Nano USB)；BPP900200300 — Asus USB-N14（从软件 v2.23 起支持）；BPP900200200 — Gembird WNP-UA-002；较旧但仍受支持的型号：BPP900200100 — Startech USB300WN2X2D 和 BPP900100100 — Zyxel NWD2105。远距离模块（Netgear AC1200）支持 Wireless AC、G 和 N（2.4 GHz 和 5 GHz）。文档将同一编号 BPP900200400 同时用于“WiFi module long range (Netgear AC1200)”和“Netgear A6210-100PES”，因此该编号存在歧义。

3 LTE（GX LTE 4G）

GX LTE 4G 是用于 Victron GX 监控产品的蜂窝调制解调器，兼容 2G、3G 和 4G 网络。
它仅为 GX 设备提供互联网连接，不会向笔记本电脑、手机或其他设备共享网络。
GX 设备支持同时连接以太网、Wi-Fi 和 LTE（通过 GX LTE 4G 配件）。只有在以太网和 Wi-Fi 均不可用时，才会使用 LTE。
除官方 GX GSM 和 GX LTE 4G 外，Ekrano GX 不支持其他 USB 宽带适配器。

4 VRM 连接错误代码

临时互联网故障不会导致数据丢失：未发送的日志保存在非易失性存储器中，断电或重启也不会丢失，并会在连接恢复后发送。即使持续丢包率达到 70%，日志仍可传输，但可能出现延迟。
重启后，VRM Online Portal 菜单中的连接状态应显示 No error。
访问 ccgxlogging.victronenergy.com 时出现 403 Forbidden 或 405 Method Not Allowed 错误，可确认 HTTPS 工作正常。
#150 Unexpected response text — HTTP/HTTPS 请求成功，但响应内容不正确。通常返回的是网络登录页面（captive portal）。
#151 Unexpected HTTP Response — 连接成功，但响应的 HTTP 状态码不是成功状态码（通常为 200）；可能被代理拦截。
#152 Connection time-out — 互联网连接质量差，或防火墙限制过严。
#153 Connection error — 可能表示路由存在问题。出现 SSL #153 错误时，请检查 GX 设备的日期、时间和时区；设置不正确会导致 SSL 错误。
#154 DNS Failure — 请在 Ethernet 或 Wi-Fi 菜单中配置正确的 DNS 服务器。
#155 Routing error — 无法访问 VRM；没有通往 VRM 服务器的路由（ICMP 错误）。
#159 Unknown error — 无法直接归类的通用错误。

5 VRM 注册与 Remote Console

系统必须先成功向 VRM 平台发送数据。如果未成功建立连接，您将无法将其注册到 VRM 用户账户。
您可以在实体触摸屏上使用 Settings → VRM 中的二维码，将 GX 设备添加到平台，无需读取标签上的 portal ID。此功能仅适用于 GX Touch 50、GX Touch 70 或 Ekrano GX。
Remote Console on VRM 提供远程访问，让您像在设备旁一样配置系统。如果 VRM 数据日志上传未正常运行，Remote Console on VRM 将无法使用。平台访问权限必须为 Full 或 Read-only，但通过 Remote Console 或 Controls 修改设置需要 Full 模式；Read-only 模式下无法修改 Controls 或 Settings。
默认启用 VRM 完整访问权限（Full），允许通过 Remote Console 或 Controls 面板修改设置。为了提高安全性或减少数据流量，您可以将访问权限设置为 Read-only 或 Off。
可选的 Network Watchdog（网络看门狗，位于 Settings → VRM，默认关闭）会在 GX 设备无法连接 VRM 平台时重启设备。
为减少流量，您可以关闭远程支持（Settings → General → Access & Security → Remote support），并设置 Log interval，使日志记录频率降至可接受的最低值，即选择更长的间隔，降低记录频率。状态变化（例如从充电切换到逆变，或从 bulk 切换到 float）以及报警仍会触发额外的数据传输。

6 VRM 无法接收时的本地日志

内部缓冲区可保存数天的日志。如需延长保存时间，请插入 microSD 卡或 USB 闪存盘。插入外部存储介质后，内部存储中的日志会自动转移，不会丢失数据。
支持的文件系统：FAT（12、16、32）、exFAT、ext3 和 ext4。容量不超过 32 GB、已预先格式化为 FAT12、FAT16 或 FAT32 的 SD 和 SDHC 类型 microSD 卡可直接使用。请勿将其格式化为不支持的文件系统。
日志记录间隔为一分钟时，每月约占用 25 MB 空间，具体取决于连接的设备。1 GB microSD 卡可保存约三年的数据，超过 VRM 的 6 个月数据保留期。存储介质写满后，将不再保存新增数据。
插入多个存储介质时，GX 设备使用最先插入的介质。务必通过 Settings → VRM → Eject storage 正确卸载存储介质，否则可能导致数据丢失或损坏。
手动向 VRM 门户上传 GX 文件时，文件大小上限为 200 MB（Upload GX file）。上传后，请先从存储介质中删除该文件，再将介质插回 GX 设备。
您可以使用 VictronConnect 中的 Venus Log Converter 功能，在本地将日志转换为 Excel 表格。该功能仅适用于 Windows 和 macOS 版 VictronConnect，不适用于 iOS 或 Android。