raspberrypi/rpi-eeprom
1
0
Fork 0
mirror of https://github.com/raspberrypi/rpi-eeprom.git synced 2026-01-20 21:13:36 +08:00
Code Issues Packages Projects Releases Wiki Activity
Files
3fb1c0c0e9c9d9b6fd92e8545668fedd51ada528
rpi-eeprom/firmware-2712/release-notes.md
Tim Gover d50b2b32f1 pieeprom-2025-03-10: 2712: Add [boot_partition] filter plus SDRAM init fixes (latest) 
* Update SDRAM init timings to intermittent 8-flash SDRAM init errors
  on some boards.
  See: https://github.com/raspberrypi/rpi-eeprom/issues/67
* config: Fix missing initialisation of selected_expr to 1 in config.txt
  Without an [all] section the new expression filter might default to
  false. This impacts the bootloader early parsing of config.txt
  for things like boot_ramdisk rather than the later config.txt pass
  for device-tree parsing.
* config_loader: Add support [boot_partition=N] as an expression filter
  The boot_partition tests whether the partition number N matches
  the number that the system is booting from. This expression is
  only supported in config.txt and is designed to make it easier
  to have common boot.img ramdisks in an A/B system where the
  conditional loads a different cmdline.txt file depending on
  which partition boot.img is loaded from.
2025-03-10 17:24:25 +00:00

24 KiB
Raw Blame History

Raspberry Pi5 bootloader EEPROM release notes

2025-03-10: Add [boot_partition] filter plus SDRAM init fixes (latest)

  • Update SDRAM init timings to intermittent 8-flash SDRAM init errors on some boards. See: https://github.com/raspberrypi/rpi-eeprom/issues/67
  • config: Fix missing initialisation of selected_expr to 1 in config.txt Without an [all] section the new expression filter might default to false. This impacts the bootloader early parsing of config.txt for things like boot_ramdisk rather than the later config.txt pass for device-tree parsing.
  • config_loader: Add support [boot_partition=N] as an expression filter The boot_partition tests whether the partition number N matches the number that the system is booting from. This expression is only supported in config.txt and is designed to make it easier to have common boot.img ramdisks in an A/B system where the conditional loads a different cmdline.txt file depending on which partition boot.img is loaded from.

2025-03-03: Fix bootloader pull configuration on 2712D0 (latest)

  • Fix pull configuration on 2712D0 2712D0 uses a horrendously sparse set of pad control registers. Make the pull-setting code sufficiently complex to cope. See: https://github.com/raspberrypi/rpi-eeprom/issues/672
  • Disable UARTA for CM5s without WiFi Just as CM5s without WiFI don't need the SDIO interface, the Bluetooth UART is unconnected. Disable the DT node to avoid kernel warnings and save some cycles.

2025-02-17: Promote 2025-02-12 to the default release (default)

2025-02-12: Fixup change to disable 3.7V PMIC output on CM5 no-wifi (latest)

  • Fixup change to disable 3.7V PMIC output on CM5 no-wifi

2025-02-11: CM5 no-Wifi stability improvements (latest)

  • recovery: Walk partitions to delete recovery.bin Previously, recovery.bin would fail to delete itself if the bootrom loaded recovery.bin where there are multiple FAT partitions and the first partition does not contain recovery.bin Update the rename code to walk the partition table to find the recovery.bin file to delete.
  • pi5: Add config filter for simple boot variable expressions (experimental) Add support for a new bootloader/config.txt conditional filter which tests the partition, boot_count and boot_arg1 variables. Syntax (no spaces): ARG boot_arg1, boot_count or partition (EEPROM config stage only) [ARG=VALUE] selected if (ARG == VALUE) [ARG&MASK] selected if ((ARG & VALUE) != 0)) [ARG&MASK=VALUE] selected if ((ARG & MASK) == VALUE) [ARG<VALUE] selected if (ARG < VALUE) [ARG>VALUE] selected if (ARG > VALUE) where VALUE and MASK are unsigned integer constants and ARG corresponds to the value in the reset register before the config file is parsed.
  • pi5: Add a boot-count bootloader variable (experimental) Store the boot-count in a reset register and increment just before the boot-order state-machine. The boot-count variable is visible via device-tree /proc/device-tree/chosen/bootloader/count and can be read/set via vcmailbox GET: sudo vcmailbox 0x0003008d 4 4 0 SET to N: sudo vcmailbox 0x0003808d 4 4 N
  • pi5: Add user-defined reboot argument (boot_arg1) (experimental) Add support for a user-defined boot parameter stored in a reset-safe scratch register on BCM2712. This is visible via device-tree at /proc/device-tree/chosen/bootloader/arg1 and via vcmailboxes GET arg1: sudo vcmailbox 0x0003008c 8 8 1 0 SET arg1 to 42: sudo vcmailbox 0x0003808c 8 8 1 42 or via config.txt set_reboot_arg1=42 The variable is NOT cleared automatically and will persist until a power-on-reset.
  • Enable overriding of high partition numbers Previously, the PARTITION=N bootloader config setting would only be used at power on reset or if the partition number passed to reboot was zero. Change the behaviour so that the bootloader config PARTITION property can override the reboot partition number if the reboot parameter is > 31.
  • Disable WiFi PMIC output on CM5 modules without WiFi Disable the 3.7V WiFi power supply on CM5 modules which do not have a WiFi module fitted. This fixes some stability issues where a CM5 would shutdown due to a spurious over-voltage condition on the non-connected WiFi power supply.
  • Add memory barrier to the mbox handler Firmware issue 1944 reports receiving kernel warnings about firmware requests where the status return code is 0. This should not be possible, as handle_mbox_property always sets the top bit of the return code, with the bottom bit indicating success or failure. If the firmware had died, the firmware driver would report a timeout due to the lack of a mailbox interrupt, and that isn't happening. See: https://github.com/raspberrypi/firmware/issues/1944
  • support dts files with size-cells of 2 DTS files with a top-level #size-cells of 2 make a lot of sense for systems with a lot of RAM, but the firmware is currently inconsistent in its support for that. Fix up the other cases to honor #size-cells and #address-cells.
  • Disable SDIO2 for CM5s without WiFi It has been observed that CM5s without WiFi hang on reboot. To prevent that, disable the sdio2 node on those devices. See: https://github.com/raspberrypi/linux/issues/6647
  • arm_dt: Use dtoverlay_enable_node Convert the open-coded DT node status changes to use the new dtoverlay method dtoverlay_enable_node.
  • dtoverlay: Add dtoverlay_enable_node Add a helper function for setting the status of a node.

2025-01-27: Walk the partition table if the requested partition is not bootable (latest)

  • Walk the partition table if the requested partition is not bootable Previously, if the specified boot partition was not bootable the bootloader would stop and advance to the next BOOT_ORDER. If the new PARTITION_WALK option is set to 1 the bootloader will now check each partition in turn starting from the specified partition before advancing the BOOT_ORDER. This feature is intended for use with A/B systems to handle the case where autoboot.txt is missing / corrupted. This change enables the system to failover to the next available bootable partition. The autoboot.txt file is not scanned during the partition-walk phase i.e. there is no recursive processing of autoboot.txt files. This option is only supported on physical block devices (SD, NVMe, USB) and not RAMDISK. USB assumes a single high speed device, partition walks on multiple USB devices is not recommended and may cause timeouts.
  • Improve keyboard handling in boot menu Try and make it more likely that we have enough time to perform key detection. Ignore mice, which were being enumerated and slowing things down.

2025-01-22: Promote 2025-01-22 to default release (default)

2025-01-22: Add DT /chosen property signed-boot boot.img hash (latest)

  • Add DT /chosen property signed-boot boot.img hash Make the sha256 hash of the boot.img file available via device-tree /proc/device-tree/chosen/bootloader/boot_img_sha256 if signed boot is enabled.
  • filesystem: GPT autoboot/reboot partition number fixes for Pi4 and older
  • Fix problems when setting arm_freq_min=arm_freq and display clocks if performance governor is not enabled.

2025-01-14: Add set_reboot_order API (latest)

  • Add set_reboot_order API and config.txt properties If set_reboot_order is defined in config.txt or set via vcmailbox then this will override the bootloader config BOOT_ORDER property on the next reboot. The parameter is stored in a reset safe register and is cleared by the bootloader after reading it. Typically, the config.txt value only be used via rpiboot to override the boot-order on the next reboot. Otherwise, it should reside in a conditional section so that the boot order is not overridden on every reboot. Example, test network boot sudo vcmailbox 0x0003808b 4 4 0xf4612; sudo reboot

2025-01-13: Improved SDRAM refresh timings for Pi5 16GB (latest)

  • Improved SDRAM refresh timings for Pi5 - 16GB
  • Add an option to wait for the power button to be pressed before booting. If POWER_OFF_ON_HALT=1 and WAIT_FOR_POWER_BUTTON=1 in the bootloader config then the bootloader will wait for either the power button to be pressed or an RTC alarm before booting. The wait state switches the PMIC to STANDBY mode which is the lowest possible power state.

2025-01-08: Update SDRAM refresh timings for BCM2712D0 products (latest)

  • Update SDRAM timings for BCM2712D0 products.

2025-01-07: Fixup M.2 HAT+ detection (latest)

  • Fix a potential timing issue introduced in the 2025-01-06 release when enabling PCIE_PWR when booting from SD/USB.

2025-01-06: Stop the fan after after fan-probe (latest)

  • Stop the fan after after fan-probe After the fan-probe has completed drive the fan PWM GPIO to high if a fan was detected and let the OS take over.
  • Add SD_QUIRKS for hardware bringup / workarounds Add a new SD_QUIRKS flags property which can be used to disable high-speed mode (bit 0). Other bits are reserved for future use.
  • Change uart_2ndstage default to 1 on Pi5 Change the default to 1 because this gives useful diagnostics for device-tree loading with minimal overhead. Set uart_2ndstage=0 or BOOT_UART=0 to disable this.
  • Move M.2 HAT+ detection to early boot. Initialse M.2 HAT+ detection before DDR init to give NVMe drive firmware more time to boot.

2024-12-19: Disable fan PWM before shutdown (latest)

  • Disable fan PWM before shutdown Drive the RP1 fan PWM GPIO high before entering the VPU sleep (POWER_OFF_ON_HALT=0) to stop the fan spinning.
  • Disable fan PWM GPIO between RP1 init and fan probe Drive fan PWM GPIO high during early boot to disable the fan until it is probed during the device-tree setup stage. This stops the spinning at max rpm during network-install.
  • arm_dt: enable_uart defaults to 0 on 2712 The default value of enable_uart on 2712 is 0, regardless of the presence of the debug UART cable, so guarantee that the default is always set correctly.

2024-12-15: Add net install to boot menu (latest)

2024-12-07: Enable banklow (and so NUMA) by default (latest)

  • Enable banklow (and so NUMA) by default banklow=1 (2712) and banklow=3 (2711) give the best performance.
  • enable_uart=1 now enables a Linix UART console on the 40-pin header unless a cable is detected on the dedicated boot-uart.
  • Recreate internal bl31 stub from clean git tree to fix dirty commit message.

2024-11-27: rp1fw: Add FIFO_STATE & DRAIN_TX, fix CAN_ADD_PROGRAM (default)

  • rp1fw: Add FIFO_STATE & DRAIN_TX, fix CAN_ADD_PROGRAM RP1 firmware eb39cfd516f8c90628aa9d91f52370aade5d0a55 adds methods to drain the TX FIFO and retrieve the state of both FIFOs. It also fixes the CAN_ADD_PROGRAM implementation, which was fatally broken.
  • network-install - Update the UI to display the board model / variant.

2024-11-12: Promote 2024-11-12 to default release (default)

  • Promote 2024-11 to the default release and archive older versions.

2024-11-12: Enable initial_turbo=60 by default (latest)

  • net-install: Fix keyboard detection on hubs
  • recovery: Always enable UART debug output on 2712
  • Set POWER_OFF_ON_HALT defaults The default value for POWER_OFF_ON_HALT on CM5 and Pi 500 will be 1. Pi5 defaults to 0 for backwards compatibility.
  • boot-time: Remove unnecessary 1 second delay when configuring DWC2 controller.
  • Enable initial_turbo=60 by default This reduces the time to get load and decompress the kernel.
  • logging: Remove superfluous newline on SDRAM refresh changed messages
  • Fix initial_turbo duration The timeout counter for the previous implementation could run too quickly causing the initial-turbo timeout to end earlier than expected.
  • rp1-fw: Add the mailbox firmware interface, and PIO support that uses it.
  • rp1-fw: Turn off unused 25MHz Ethernet refclk

2024-11-07: recovery.bin - Update default release to latest version (default)

  • Update recovery.bin to the most recent version required for CM5 and Pi500. (firmware version 2024-10-21)

2024-11-05: NUMA - Add system_heap.max_order=0 when needed (latest)

  • NUMA - Add system_heap.max_order=0 when needed - configure this setting automatically depending on whether NUMA is enabled.

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)

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)

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)

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)

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

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

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)

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.

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)

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.
Reference in New Issue View Git Blame Copy Permalink