Updating firmware¶
The NetModule Linux system provides a tool to upgrade the firmware of the different modules in the system.
The firmware packages are not available in the reference image but the latest supported firmware versions are part of each software release.
Firmware Location¶
The firmwares officialy supported by NetModule are available at https://nmrepo.netmodule.com/chbe/fwupdate/
Preparation¶
Before upgrading a module, it is recommended to check if it has been properly configured and started
This can can be done using the following commands:
For GNSS modules:
systemctl status gnss-config
For WWAN modules:
systemctl status wwan-config@wwan0
When the modules are properly configured, the output shows one of the two following lines:
Active: active (running)
Active: active (exited)
Once the device is started, the firmware version can be read with the following commands:
For GNSS modules:
cat /run/gnss/gnss0.config
For WWAN modules:
cat /run/wwan/wwan0.config
Usage¶
The update tool can fetch the new firmware from the local device or via http from remote firmware.
Local firmware¶
To upgrade using a local firmware, the firmware must be copied to the target first. The following command can then be executed:
nmhw-fwupdate <device> <firmware.tar.gz>
Where <device> is the device name as reported by list-devices and <firmware> is the relative or full path to the firmware archive.
Examples :¶
# Updating gnss firmware
nmhw-fwupdate gnss0 UBX_M8_301_ADR_421_NEO_M8L.tar.gz
# Updating wwan firmware
nmhw-fwupdate wwan0 TOBY-L210-03S-01_FW16.19_A01.02_IP.tar.gz
Remote firmware (HTTP)¶
If the firmware is available on an HTTP server (reachable from the target), the following command can be used:
nmhw-fwupdate <device> <http link>
Where <device> is the device name as reported by list-devices and <http link> is the link to the firmware on the HTTP server.
Examples :¶
# Updating gnss firmware
nmhw-fwupdate gnss0 https://nmrepo.netmodule.com/chbe/fwupdate/UBX_M8_301_ADR_421_NEO_M8L.tar.gz
# Updating wwan firmware
nmhw-fwupdate wwan0 https://nmrepo.netmodule.com/chbe/fwupdate/TOBY-L210-03S-01_FW16.19_A01.02_IP.tar.gz