rpi-eeprom/firmware-2712/release-notes.md

Raspberry Pi5 bootloader EEPROM release notes

2024-10-21: Fix PCIe BAR issue for some switches (latest)

• Fix PCIe BAR setup issue which prevented NVMe boot from working with some PCIe switches See: https://github.com/raspberrypi/firmware/issues/1833
• Boot-menu improvements Remain in the forced boot mode until the menu is used to select a different boot-mode or reset to the original boot-order.

2024-10-10: Add support to override the boot-mode at power on (latest)

• Introduce a new boot-menu feature where pressing SPACE at power on gives the user a one-shot option to select a different boot mode. e.g. Select USB boot if the default SD card is corrupted or unavailable.
• Display the bootloader network-install UI for longer on a cold boot to make this feature more visible to first time users. To revert to the previous behaviour remove NET_INSTALL_AT_POWER_ON=1 from the bootloader config.
• Support non-UUID HAT mapping Extend the HAT map support to allow matching on product and vendor strings, as well as product ID and version. As a minimum, there must be a product string - if that matches, the other keys are considered. Without a product key, the UUID is compared as before.
• Remove requirement for GPT ptable array to be at LBA-2 See: https://github.com/raspberrypi/rpi-eeprom/issues/585
• 2712C1 clock manager improvements to slightly reduce idle power ~50mW saving
• Adjust SDRAM page-hold and auto-precharge to improve performance. ~2% improvement with Geekbench 6
• armstubs: 2712: Rebuild with updated max-power throttle and direct stream settings See: fc45bc492d
• debug: Only display the program_pubkey log if configuring secure-boot
• Default to 2GB start for PCI bus addresses on 2711 and 2712 This change also constrains the window size to 2GB, so all PCI bus address assignments fall below 4GB, avoiding a potential bug with 32-bit BARs in esoteric bus topologies (e.g. lots of GPUs).

2024-09-24: Promote 2024-09-23 release (default) (automatic update)

2024-09-23: SDRAM performance tuning (latest)

• Allow BANKLOW to be configured by SDRAM_BANKLOW parameter
• Manufacturing test updates

2024-09-11: Promote 2024-09-10 release (default) (automatic update)

2024-09-10: Fix lockup on 7" DSI panel clones (latest)

• Fix lockup regression with some 3rd party 7" DSI panels See: https://github.com/raspberrypi/linux/issues/6341

2024-09-05: Fix self-update if EEPROM is write-protected (latest)

• arm_dt: Consult the hat_map for all HATs
• USB boot - ignore RP2 / RP3 MSD device in BOOTSEL mode.
• recovery.bin - Fix erase_eeprom to not block reboot_recovery
• Fix self-update to continue to boot instead of retrying forever if the EEPROM is write protected. https://github.com/raspberrypi/rpi-eeprom/issues/597

2024-07-30: Promote the 2024-07-30 release to default (default)

2024-08-14 - (recovery.bin) Add support for OTP metadata (latest)

• Update to recovery.bin to output metadata about OTP during rpiboot

2024-07-30: Optimized SDRAM timings for Pi5 8GB (latest)

• Optimize all-banks/per-bank refresh timings for Pi5 8GB
• Improve compatibility for booting from some USB SD card readers https://github.com/raspberrypi/rpi-eeprom/issues/527
• Add enable_rp1_uart=1 to config.txt to initialise RP1 UART0 immediately prior to starting the ARMs get earlycon on 40-pin header (pins 14,15) Also requires pciex4_reset=0 in config.txt, and earlycon=pl011,0x1f00030000,115200n8 in cmdline.txt

2024-07-25: Support CM4 nEXTRST on CM5 (latest)

• Drive nEXTRST on CM5 for CM4IO compatibility.
• Preliminary changes for CM5 Lite.

2024-06-11: Promote pieeprom-2024-06-05 to the default release (default)

2024-06-05: CM5 bringup changes (latest)

• Minor changes to support CM5 bringup and test.

2024-06-04: Fix [pi5] config.txt conditional state (latest)

• The [pi5] conditional statement should apply to the entire pi5 family i.e. include cm5 as well.
• Bump SDIO bus priorities so that a GPU/RAM intensive process can't unnecessarily stall I/O.
• Assorted log message tidyups.

2024-05-17: Ignore bootloader updates for Pi5 on Pi4 - (latest)

• Add timestamps to UART log messages

2024-05-13: Add support for NVMe boot with PCIe switches (latest)

• Add preliminary support for booting NVMe devices behind PCIe switches. See: https://github.com/raspberrypi/firmware/issues/1833
• Fix MAX_RESTARTS parameter See: https://github.com/raspberrypi/rpi-eeprom/issues/576
• arm_dt: Support HAT EEPROM dtparams
• Fix reporting of the partition number via DT See: https://github.com/raspberrypi/rpi-eeprom/issues/575
• Resolve HID counting bug which caused Network Install to fail on some keyboards See: Fixes https://github.com/raspberrypi/rpi-eeprom/issues/574
• Pull PCIE DET_WAKE high by default on CM5

2024-04-20: Fix SDRAM refesh timing (default) (automatic update)

• Fix a possible performance regression on Pi5.

2024-04-18: Promote the 2024-04-17 release to the default release (default) (automatic update)

• Select pieeprom-2024-04-17.bin to be the new default release and bump the automatic update minimum version to this.

2024-04-18: Update RP1 firmware to extend PCIe L1 entry timeout to 32 us (latest)

• Extend PCIe L1 entry timeout to 32us Fix xhci soft reset on link-down Set useful xhci compatibility bits in GUCTL See https://github.com/raspberrypi/firmware/issues/1877

2024-04-17: Fix TRYBOOT flag in secure-boot mode (latest)

• Fix issue that caused the TRYBOOT flag to be lost in secure-boot mode.
• dtoverlay: Use %u when converting u32s to strings See: https://github.com/raspberrypi/linux/issues/6039
• Improved debug messages for secure-boot.
• Generate the bootloader diagnostics qrcode at run time.

2024-04-05: HAT+ fixes for max-current, custom CA cert for net install and enable over-clocking to > 3GHz (latest)

• bootloader: clock_2712: Remove restriction on arm_freq <= 3000 See: https://github.com/raspberrypi/firmware/issues/1876

• arm_dt: Update max_current to match HAT value

• arm_dt: Remove unused legacy parameters (core_freq, arm_freq, uart0_clkrate and cache_line_size)

• Add support for custom CA cert for network install You need to specify HTTP_HOST=myhost.com HTTP_PATH=/path/to/files HTTP_CACERT_HASH=

  where is a sha256 hash of the der encoded ca certificate. CA cert is added using rpi-eeprom-config.

• Optimise Vbat current draw with charging disabled

• Display OTP boot status in UART log messages.

• Preliminary support for secure-boot OTP provisioning.

• Update PCIE DET_WAKE pinmux for D0 products

2024-02-16: u-boot loading and thermal throttling fixes (latest) (default)

• arm_loader: Move non-kernels back to 512KB See: https://github.com/raspberrypi/firmware/issues/1868

• Limit throttled frequency to OS requested frequency rather than config.txt frequency. See: https://github.com/raspberrypi/rpi-eeprom/issues/518

2024-02-14: Fix vcgencmd otp_dump and implement C(initial_turbo) (latest)

• Fix a regression that caused vcgencmd otp_dump to fail.
• Implement C(initial_turbo) on Pi5 See: https://github.com/raspberrypi/firmware/issues/1864

2024-02-08: Adjust SDRAM refresh based on temperature (latest)

• Adjust the SDRAM refresh interval based on the temperature. This addresses the gap in performance between the 8GB and 4GB variants. See https://github.com/raspberrypi/firmware/issues/1854
• Preliminary support for signed boot.

2024-02-05: Add support for HAT+ POE HATs (latest)

• Add support for probing HAT+ POE HATs
• Implement DWC3 specific XHCI quirks

2024-01-24: NVMe boot fix for WD NVMe (latest)

• Add a workaround for an issue seen when booting with WD Blue SN550 NVMe SSD

2024-01-22: Add support for network-install (latest)

• Fix issue boot.img end sector check - STABLE See: https://github.com/raspberrypi/rpi-eeprom/issues/521
• Fix handling of files that use the last cluster in the partition See: https://github.com/raspberrypi/rpi-eeprom/issues/521
• Fix SD card detection See: https://github.com/raspberrypi/rpi-eeprom/issues/523

2024-01-15: Add support for network-install (latest)

• Add support for Network Install
• Preliminary D0 firmware support

2024-01-08: Promote 2024-01-05 to default (automatic update)

2024-01-05: Fix handling of FAT files without LFNs.

• Fix issues with SFN entries sometimes being treated as LFNs see https://github.com/raspberrypi/rpi-eeprom/issues/514
• Add a dedicated message for "M.2 HAT" not being found instead of the generic 'unsupported boot order' message when NVMe boot is skipped.

2023-12-17: Promote 2023-12-14 to default release

• Bump to the default release now that the partition number fix is confirmed.

2023-12-14: Fix boot partition parameter (latest)

• Fix an issue where the boot partition parameter in PM_RSTS was cleared before being checked. https://github.com/raspberrypi/firmware/issues/1853
• Add a specific fatal error pattern for RP1 not found - 4 long - 3 short

2023-12-12: Promote 2023-12-06 to default release.

2023-12-06: Initialise DWC PHY (latest)

• Initialise the DWC PHY to enable DWC host+peripheral support under Linux. Requires 82069a7a02
• Force PWM on 3V3 supply if cameras or HATs are connected or if power_force_3v3_pwm=1 in config.txt Resolves an image quality issue with the GS camera.
• Add support for C(arm_min_freq) < 1500 MHz (must be at >= 200 MHz)
• Manufacturing test updates for DVFS.

2023-11-20: Auto-detect support for PCIe expansion HAT (default + latest)

• Add autodetect support for PCIe expansion HATs
• Add PCIE_PROBE=1 to the EEPROM config for custom PCIe exapansion designs that do not support the upcoming HAT spec. This gives similar behaviour to CM4 where PCIe x1 is enumerated to discover NVMe devices.
• Fix loading of multiple initramfs images that are not 32-bit aligned sizes https://github.com/raspberrypi/firmware/issues/1843
• Kernel load performance improvement - remove a memcpy

2023-10-30: UPG watchdog support + SD reset fixes (default + latest)

• Fix SDIO / WiFi clock-setup for BOOT_ORDER=0xf14
• Fix SD power-on-reset
• Firmware support for improved watchdog driver
• Update DHCP Option97 to be R,P,i,5 on Pi5

2023-10-18: Display autodetect + HAT gpiomap (default + latest) (automatic update)

• Add support for HAT gpiomap for improved HAT compatibility.
• Add I2C probe for DSI display auto detect
• Automatically set dtparam=nvme if booted from nvme
• Fix network boot reset issue where only the first attempt works.
• Adding pciex4_reset=0 to config.txt will leave RP1 PCIe enabled when ARM stage is started.
• Prevent HDMI diagnostics being displayed immediately when waking after HALT.
• Update board-name - "Raspberry Pi 5"

2023-09-28: vcgencmd pmic_read_adcs fixes (automatic update)

• Fix the LDO names and current scaling codes
• Manufacturing test updates

2023-09-21: Power button and ACT LED improvements

• Fix bug where button press was not monitor for USB-C power supplies that were detected as < 3A.
• In USB boot mode automatically select max-current during a reboot (but not power on reset) to improve OS installation experience.
• USB-MSD stability improvements
• Remove the HALT error pattern and go to halt/standby immediately.
• Add support for HAT map.

2023-09-13: Initial release

• Initial manufacturing software
• Network Install is not available in this version
• rpi-eeprom-update uses self-update on Pi5 rather than recovery.bin. so that the update mechanism is the same on all boot-modes and the boot file-system is never modified by the firmware/recovery.bin. recovery.bin is still used by RPi Imager - bootloader update SD card images.
• Pi4 and Pi4 bootloader images and recovery.bin are not compatible. The 2711/2712 boot ROM ignores incompatible recovery.bin files.