Skip to content

Updating the firmware on the CerboGX

Chris Adams edited this page Jul 29, 2024 · 18 revisions

Updating via the device

Update the firmware version

Online Updates

For gui-v2 development, we usually want to use candidate or testing rather than release feed. After setting which opkg feed to use, you can check for updates and optionally upgrade to an available update.

cerbogx # /opt/victronenergy/swupdate-scripts/set-feed.sh testing
cerbogx # /opt/victronenergy/swupdate-scripts/check-updates.sh
cerbogx # /opt/victronenergy/swupdate-scripts/check-updates.sh -update

The same may be done via the GUI: Settings > Firmware > Online updates > Check for updates: 'Press to check'. If update is available, another settings list item appears below with 'Press to install '.

After installation succeeds and the device reboots, you should run the resize2fs script to make the root partition as large as possible and remount it in read-write mode:

cerbogx # /opt/victronenergy/swupdate-scripts/resize2fs.sh

Offline Updates

When testing a specific image (.swu file), an offline update should be performed after the image file is made available for installation.

cerbogx # mkdir -p /data/swu
host $ scp venus-swu-einstein-img.swu root@cerbogx:/data/swu
cerbogx # ln -s /data/swu /media/dataswu
cerbogx # /opt/victronenergy/swupdate-scripts/check-updates.sh -offline
cerbogx # /opt/victronenergy/swupdate-scripts/check-updates.sh -offline -update

Install any extra libraries

In some cases, we might be testing with new libraries which aren't yet part of the default image. In this case, it is necessary to install them manually using opkg. Such packages are probably available in the candidate feed.

cerbogx # /opt/victronenergy/swupdate-scripts/set-feed.sh candidate
cerbogx # opkg update
cerbogx # opkg install new-library-package

If the package installation fails try updating the device firmware first.

Resetting the root password

After flash / software update, the device will reboot and the root password will be lost (but root ssh keys will remain).

To set a password: https://www.victronenergy.com/live/ccgx:root_access

1) Go to settings/general
2) Set access level to "User and installer" password ZZZ
3) Highlight Access Level )but don't open the selected page, i.e. make sure you are on General page, not Access Level page)
4) Drag the menu down and hold for 5 seconds
5) Options to become superuser and/or set password is shown.