01在哪里查看代码

- 在 GX 设备屏幕上——错误和警告以通知(Notification)形式显示。从 v2.30 起,Error #42 也会显示在 VRM 门户中。
- VRM 连接错误(#150–#159)——位于 Settings → VRM → Connection error。如果 Wi-Fi 状态为 Failure,可能是密码错误;请选择 Forget network,并使用正确密码重新连接。
- ESS 状态(#1–#7)——显示在 GX 设备的图形概览和 VRM 中,位于充电状态旁。这些不是错误,而是说明系统为何限制充电或放电。
- WS500 调节器代码——位于 GX 设备上的调节器菜单中,显示在 Error 字段。GX 会报告所有 WS500 代码;此处介绍 GX 手册中说明的两个代码(#91、#92),其余代码请参阅 Wakespeed Communications and Configuration Guide。
- VRM 门户代码(1403–1520)——这些是 VRM 门户本身的消息(服务器响应),而非 GX 设备的消息。
- 其他设备的代码——GX 也会显示已连接设备的代码:MultiPlus 和 Quattro(VE.Bus)以及 MPPT 控制器。在 ESS 系统中断开 BMS 后,MPPT 控制器会停止工作并显示错误 67。
- VE.Bus 通知——在 Settings → Devices → [VE.Bus 设备] → Alarm setup 中,您可以设置 GX 仅显示报警(默认设置)、显示报警和警告,或不显示任何通知(不建议)。
GX 设备代码来自 Ekrano GX、Cerbo GX、Cerbo-S GX 和 Venus GX 的共用手册。该手册也将 MultiPlus-II GX 和 EasySolar-II GX 归为 GX 设备。
02GX 设备错误
内部存储器损坏
GX 设备的内部闪存已损坏。这部分存储器保存设置、序列号和 Wi-Fi 登录信息。
影响:无法保存设置,重启后所有设置都会恢复为出厂默认值,可能导致进一步的问题。
处理方法:设备必须送修或更换。软件更新或现场维修无法排除此故障,请联系您购买设备的经销商。
适用范围:v2.30 及之后的软件版本;更早版本不会报告此错误。从 v2.30 起,此错误会显示在 GX 屏幕和 VRM 门户中(手册 FAQ 中称为 Hardware fault)。
原文:Storage corrupt · Victron 来源 · FAQ:Error #42
数据分区已满
当数据分区剩余空间过少时,会出现此报警。分区已满可能影响 Venus OS 系统运行,并阻止服务启动。
最常见原因:附加应用程序(例如 Node-RED 或 Signal K)写入的数据。您可在 Settings → General → Support status 中查看已安装的应用程序列表。
处理方法(依据 Venus OS Large 页面):删除 Node-RED 流程(flows)和已安装的节点包(palettes);在 Signal K 中删除日志文件,并检查是否启用了 Keep only most recent data log files(仅保留最新数据日志文件)选项(Signal K → Server → Settings)。作为最后手段,可按 GX 手册使用 venus-data.tgz 文件将 GX 恢复出厂设置,随后需要重新配置设备。
来源差异:GX 手册给出的阈值是剩余空间低于 10%,Venus OS Large 页面则为低于 5%。根据后者,您可在 Settings → General → Modifications 中查看准确的剩余空间。
原文:Data partition full · Victron 来源 · Venus OS Large——数据分区已满
数据分区异常
GX 设备的内部存储器可能已损坏,导致设备丢失配置。
处理方法:请联系您购买设备的经销商或安装商。
原文:Data partition issue · Victron 来源
DVCC 与固件不兼容
DVCC 已启用,但系统中并非所有设备的固件都兼容 DVCC。从 Venus OS v2.40 起,GX 设备会显示此消息。
处理方法:请根据表格检查固件版本并更新设备。制造商建议:系统调试时安装最新固件,出现问题时先进行更新。如果不满足要求,请勿使用 DVCC。
| Victron 设备 | 最低固件版本 |
|---|---|
| Multi / Quattro | 422 |
| MultiGrid | 424 |
| Multi RS、Inverter RS、MPPT RS | v1.08 |
| GX 设备 | v2.12 |
| VE.Direct MPPT 控制器 | v1.46 |
| 带 VE.Direct 端口的 VE.Can MPPT 控制器 | v1.04 |
| 旧款 VE.Can MPPT 控制器(带显示屏) | 不可使用 |
| Lynx Ion + Shunt | v2.04 |
| Lynx Ion BMS | v1.09 |
| Lynx Smart BMS | v1.02 |
| Lynx BMS NG | v1.10 |
| Orion XS | v1.00 |
带 CAN-bus 通信的电池:只有当 Battery Compatibility(电池兼容性)指南明确列出该电池支持 DVCC 时,才可启用 DVCC。在配备 Lynx Smart BMS 和 Lynx BMS NG 的系统中,DVCC 会自动启用,且无法关闭。
Pylontech 和 BMZ 电池:从 Venus OS v2.80 起,这些电池强制启用 DVCC,因此旧系统可能显示此错误。手册建议:关闭自动更新(Settings → General → Firmware → Online updates → Auto update),回退至 v2.73(从 SD 卡或 USB 存储设备安装指定版本),然后请安装商更新所有设备的固件。
BYD、MG Energy Systems 电池及 Victron Lynx Ion BMS:从 v2.40 起,系统会针对受支持的 BMS 自动启用 DVCC,而旧系统可能缺少所需组件。手册建议:关闭自动更新,回退至 v2.33,并确保 DVCC 已关闭。请与安装商确认系统是否采用双线控制(早期替代 DVCC 的方案)。如果 BMS、逆变充电器和控制器之间没有充放电控制线,则这些电池必须使用 DVCC,同时满足最低固件版本要求。
ESS 系统:ESS Assistant 必须为 164 或更新版本(2017 年 11 月);更早版本不兼容 DVCC。
原文:DVCC with incompatible firmware · Victron 来源 · DVCC 要求
未找到电网电表
在选择了 External Grid Meter(外部电网电表)的 ESS 系统中,GX 设备未检测到电表。
处理方法:检查接线和系统配置。
适用范围:配备外部电网电表的 ESS 系统。
原文:Grid meter not found · Victron 来源
MK3 固件需要更新
需要更新 GX 设备内部 MK3 控制器的固件。更新可启用较新的功能,例如发电机自动启动和停止时的预热与冷却。
操作方法:进入 Settings → Devices → MultiPlus/Quattro/EasySolar。此处会出现 MK3 新版本通知,请点击通知并启动更新。如果没有通知,则系统已是最新版本。
注意:根据制造商数据,约 5% 的更新可能使系统短暂重启,逆变充电器会关闭后重新启动。因此,这次一次性更新由用户手动启动;后续更新会自动安装,无需重启。
原文:mk3 firmware needs update · Victron 来源
未连接到 GX 设备
导航多功能显示器(MFD)上的 Marine MFD 应用无法连接到 GX 设备。
处理方法:重启 GX 设备和/或 MFD 显示器。
适用范围:通过 Marine MFD 应用与 MFD 显示器集成的系统。
原文:“Could not connect to the GX device” · Victron 来源
03连接 VRM 门户
响应内容异常
http/https 连接成功,但响应无效。这通常表示遇到了 Wi-Fi 网络登录页面(即强制门户 captive portal),常见于机场、酒店、游艇码头和营地。
GX 设备无法在要求通过此类页面登录或接受使用条款的 Wi-Fi 网络中工作。制造商表示,对此没有解决办法。
原文:“Unexpected response text” · Victron 来源
HTTP 响应异常
连接成功,但响应未包含表示成功的 HTTP 状态码(通常为 200)。这可能意味着连接被透明代理服务器拦截,场景示例与 #150 相同。
原文:“Unexpected HTTP Response” · Victron 来源
连接超时
可能表示互联网连接质量较差,或网络防火墙(firewall)限制过严。
原文:“Connection time-out” · Victron 来源
连接错误
“Connection error”可能表示路由问题,具体信息见屏幕上的提示。手册中的示例是路由器未允许 GX 设备访问互联网。
如果“Connection problem”提示中包含 SSL 信息,请检查 GX 设备的日期、时间和时区,错误的设置会导致 SSL 错误。还应确认路由器没有显示免责声明、登录或接受使用条款的页面,此类页面常见于机场和酒店的公共 Wi-Fi 网络。
原文:“Connection error / Connection problem” · Victron 来源
DNS 错误
请确认 Ethernet 或 Wi-Fi 菜单中设置了可用的 DNS 服务器。通常由网络中的 DHCP 服务器自动分配。
原文:“DNS Failure” · Victron 来源
路由错误——无法访问 VRM
GX 设备收到了 ICMP 错误,表示没有通往 VRM 服务器的路由。请确认 DHCP 服务器分配了可用的默认路由;如果使用静态配置,请确认网关(gateway)设置正确。
原文:“Routing error” · Victron 来源
未知错误
无法归入其他类别的错误。此时可从提示内容中获取问题信息。
原文:“Unknown error” · Victron 来源
04ESS 状态
SoC 过低:已禁用放电
电池荷电状态已降至设定限值,因此 ESS 不再让电池放电。
在 Optimised 和 Optimised (with BatteryLife) 模式下,当 SoC 比 ESS 菜单中的“Minimum SoC”低 5% 或更多时,系统会自动使用电网为电池补充充电。达到 Minimum SoC 后,补充充电结束。
原文:“Low SoC: discharge disabled” · Victron 来源
BatteryLife 已启用
BatteryLife 防止电池长期处于低荷电状态。日照不足时,它每天将 SoC 下限提高 5%,直到每天从电池取出的能量与补充的能量相等,此时可供使用的电量会减少。
日照增加后,该限值会逐日恢复到用户设定的值。
原文:“BatteryLife is active” · Victron 来源 · BatteryLife(ESS 手册)
BMS 已禁止充电
电池 BMS 已禁止充电。诊断步骤见“BMS 切断充电”。
原文:“Charging disabled by BMS” · Victron 来源
BMS 已禁止放电
电池 BMS 已禁止放电。如果锂电池已深度放电,请参阅“锂电池电量耗尽”。
原文:“Discharging disabled by BMS” · Victron 来源
正在缓慢充电
这是 BatteryLife 的一项功能:当 SoC 低于当前下限超过 24 小时时,ESS 会缓慢为电池充电。达到下限后,系统返回“Discharge disabled”(已禁用放电)状态。
原文:“Slow charge in progress” · Victron 来源 · BatteryLife state(ESS 手册)
充电限值已设为零
设置中的充电限值为零,因此系统不会为电池充电。请检查 GX 设备中设置的充电限值。
原文:“User configured a charge limit of zero” · Victron 来源
放电限值已设为零
设置中的放电限值为零,因此系统不会让电池放电。请检查 GX 设备中设置的放电限值。
原文:“User configured a discharge limit of zero” · Victron 来源
05Wakespeed WS500 交流发电机调节器
与 BMS 的连接丢失
WS500 交流发电机调节器与 BMS 的通信中断,并进入已配置的应急模式(get home mode)。通信恢复后,它会重新采用 BMS 设定的充电目标。
适用范围:集成 BMS 的系统。此错误在持续期间属于严重故障,需要立即处理。
原文:“Lost connection with BMS” · Victron 来源
feature IN 输入信号已禁用 ATC
BMS 通过连接到 feature in 输入端的导线发出了断开充电信号(charge disconnect),因此 WS500 进入关闭状态(Off)。
适用范围:集成 BMS 的系统。此错误在持续期间属于严重故障,需要立即处理。
原文:“ATC disabled through feature IN” · Victron 来源
06VRM 门户错误代码
权限不足
提示:“You don't have sufficient rights to perform this action.” 您的账户没有执行此操作的权限(API 响应:HTTP 403)。
原文:“Forbidden” · Victron 来源
验证错误
服务器判定提交的数据无效并拒绝接收,提示内容包含服务器返回的详细信息(API 响应:HTTP 422)。
原文:“Validation error” · Victron 来源
请求过多
提示:“You've sent too many requests. Please try again in a few minutes.” 发送的请求过多,请您几分钟后重试(API 响应:HTTP 429)。
原文:“Rate limited” · Victron 来源
VRM 服务器不可用
提示:“服务器后端暂时不可用,请几分钟后重试。”VRM 服务器暂时不可用,请几分钟后重试(API 响应 HTTP 500)。
原文:“Internal Server Error without Status” · Victron 来源
请求超时
提示:“其中一个请求已超时。部分元素可能无法正常加载。请稍后重试。”其中一个请求超时,部分元素可能无法加载。请稍后重试。
原文:“Gateway timeout” · Victron 来源
带详细说明的服务器错误
VRM 服务器端错误,提示内容取决于具体错误(API 响应 HTTP 500)。
原文:“Internal Server Error with Status” · Victron 来源
出现异常
提示:“出现异常,请稍后重试。”请稍后重试。
原文:“error_with_data_message” · Victron 来源
未知错误
提示:“未知错误,请几分钟后重试。”请几分钟后重试(API 响应 HTTP 504)。
原文:“unknown_error” · Victron 来源
实时查看已禁用:GX 设备过载
VRM 门户因 GX 设备过载而禁用了实时连接。
原文:“Realtime connection disabled due to GX device overload” · Victron 来源
适用设备
Cerbo GX系统控制中心及 VRM 平台网关。
Ekrano GX内置 7 英寸触摸屏的 GX 控制中心。
GX Touch 50/70Cerbo GX 可选配的 5 英寸或 7 英寸显示屏:用于查看系统概况和设置,支持表面安装或嵌入式安装。
MultiPlus-II GXMultiPlus-II 内置 GX 设备、显示屏和 Wi-Fi,无需单独配置 Cerbo 即可接入 VRM。
EasySolar-II GXMultiPlus-II、250 V MPPT 控制器和 GX 设备出厂时已连接并集成于同一机箱内,容量为 3 或 5 kVA。
GX LTE 4G适用于 GX 设备的 2G/3G/4G 调制解调器——在没有 Wi-Fi 的地方提供互联网连接并接入 VRM 平台。后续步骤
GX 设备无法识别某个设备?请查看“GX 无法识别设备”故障排查。VRM 门户不显示数据,请查看“VRM 无数据”。Wi-Fi 出现问题,请查看“Cerbo GX 与 Wi-Fi”。固件更新步骤请参阅“固件更新”。如果制造商指出是硬件故障(例如 #42),请联系您购买设备的销售商或安装商。
资料来源
- GX 设备手册(Ekrano GX、Cerbo GX、Cerbo-S GX、Venus GX):Error Codes(错误代码)与 FAQ(HTML 版,截至 2026年9月21日)victronenergy.com · EN
- GX 设备手册:VRM Portal 连接错误 #150–#159victronenergy.com · EN
- GX 设备手册:DVCC 软件要求与 ESS 状态victronenergy.com · EN
- GX 设备手册:Wakespeed WS500 错误 #91 和 #92victronenergy.com · EN
- Venus OS Large:磁盘空间问题/数据分区已满victronenergy.com · EN
- ESS 设计与安装手册:BatteryLife(第 4.3.10 和 6.2 节)victronenergy.com · EN
- VRM 门户手册:VRM 错误代码(第 18 章)victronenergy.com · EN
