Skip to content

Bootloader

Nerivec edited this page Nov 13, 2024 · 15 revisions

Interact with the Gecko bootloader in the adapter.

As of v2.2.0, the bootloader can be entered from either NCP or RCP firmware.

Tip

If your adapter refuses to enter the bootloader when using this command, you may need to use the dedicated button (if any) to force it. The 'Force Reset' option (prompt only available for supported adapters) can also force the adapter to enter the bootloader.

Get info

Print the Gecko Bootloader information.

Example:

Gecko Bootloader v1.12.00.

Update firmware

Update the adapter's firmware. Both upgrade and downgrade are supported.

You will be asked to provide a GBL update file when entering this menu. This may be from the pre-defined list (based on the adapter model you previously selected), a URL, or a file in the data folder.

Tip

You can also upgrade the bootloader itself with this menu, if you have a proper GBL file for it.

Clear NVM3

Clear the entire NVM3 of the adapter (menu only available for supported adapters).

Caution

This will erase any network (and associated configuration) present in the adapter. It is recommended you do a backup first, clear the NVM3, then restore your backup, unless you really want to clear everything for good (to create a brand new network for example).

Exit bootloader

Exit the bootloader and let the EmberZNet stack run.

[Experimental] Bricked or misbehaving adapters

Special GBL firmware files have been crafted to flash onto problem adapters to try to recover them without requiring access to specialty hardware.

See https://github.com/Nerivec/silabs-firmware-recovery for more details.

Caution

Be sure to read the entire README in the above link before proceeding. These operations cannot be reversed, and may further damage your adapter if improperly handled.

Clone this wiki locally