LinuxCommandLibrary

rpi-eeprom-update

Update Raspberry Pi bootloader EEPROM

TLDR

Print information about the current raspberry pi EEPROM installed

$ sudo rpi-eeprom-update
copy

Update a raspberry pi EEPROM
$ sudo rpi-eeprom-update -a
copy

Cancel the pending update
$ sudo rpi-eeprom-update -r
copy

Display help
$ rpi-eeprom-update -h
copy

SYNOPSIS

rpi-eeprom-update [options]

PARAMETERS

-h, --help
    Display help message and exit.

-f, --force
    Force update even if the current EEPROM version is newer than the available update. Use with caution!

-d, --dry-run
    Simulate the update process without actually flashing the EEPROM. Useful for testing.

-v, --verbose
    Enable verbose output for more detailed information during the update process.

-l, --list-versions
    List available versions of the EEPROM firmware. Requires network connection.

--recovery
    Run in recovery mode: ignores the check for a valid signature on the update. Allows restoring a broken EEPROM, but only use when necessary.

DESCRIPTION

The `rpi-eeprom-update` command is a utility used to update the bootloader EEPROM on Raspberry Pi 4 and later models. This EEPROM contains the firmware responsible for the initial boot process, including initializing hardware and loading the operating system. Updating the EEPROM is crucial for applying bug fixes, improving hardware compatibility, enabling new features (like network boot), and enhancing overall system stability. The command checks for available updates and applies them, ensuring your Raspberry Pi has the latest bootloader firmware.

It typically retrieves updates from a designated online repository, compares the current version with the available updates, and then flashes the new firmware to the EEPROM. Improper updates can brick the device, so it's recommended to follow official documentation and take precautions. It is a vital tool for maintaining a functional and up-to-date Raspberry Pi system.

CAVEATS

Improper use of `rpi-eeprom-update`, especially the `--force` or `--recovery` options, can render your Raspberry Pi unbootable. Always ensure you have a stable power supply during the update process and refer to official Raspberry Pi documentation before proceeding. Back up important data beforehand if possible. Using `--force` or `--recovery` without understanding the risks can cause permanent damage.

EEPROM RECOVERY

If the EEPROM becomes corrupted or the update fails, the Raspberry Pi might not boot. In such cases, a recovery process using an SD card image is typically required. Refer to the official Raspberry Pi documentation for the recovery procedure which can vary depending on the model.

BOOTLOADER CONFIGURATION

The bootloader configuration can influence where the operating system boots from. Updating the bootloader can enable new boot options like network boot (pxe). Use the raspi-config utility or directly edit the /boot/firmware/config.txt file to configure boot order and other bootloader related parameters.

HISTORY

The `rpi-eeprom-update` command emerged with the introduction of the Raspberry Pi 4, which moved to an EEPROM-based bootloader. Prior Raspberry Pi models had a different boot process. The command was developed to provide a straightforward and reliable way to update this EEPROM firmware. Regular updates are pushed to address bugs, improve compatibility, and enhance security.

Over time, the command has been refined and new features like dry-run and force options have been added to cater to different user needs and scenarios.

SEE ALSO

Copied to clipboard