Skip to content

Commit 5da98e6

Browse files
committed
boot-eeprom: explicitly document the timestamp field
Without the timestamp field, EEPROM updates do not work on the Pi 5. This took me a few hours to figure out, so I’m updating the docs. See gokrazy/gokrazy#332 for more details.
1 parent c9820f1 commit 5da98e6

File tree

1 file changed

+2
-2
lines changed

1 file changed

+2
-2
lines changed

documentation/asciidoc/computers/raspberry-pi/boot-eeprom.adoc

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -280,7 +280,7 @@ For more information, see xref:raspberry-pi.adoc#eeprom-boot-flow[EEPROM bootflo
280280
| Bootloader EEPROM image - same as `pieeprom.upd` but changes `recovery.bin` behaviour to not rename itself to `RECOVERY.000`.
281281

282282
| `pieeprom.sig`
283-
| The sha256 checksum of bootloader image (pieeprom.upd/pieeprom.bin)
283+
| The sha256 checksum and timestamp of bootloader image (pieeprom.upd/pieeprom.bin)
284284

285285
| `vl805.bin`
286286
| The VLI805 USB firmware EEPROM image - Raspberry Pi 4B revision 1.3 and earlier only.
@@ -291,7 +291,7 @@ For more information, see xref:raspberry-pi.adoc#eeprom-boot-flow[EEPROM bootflo
291291

292292
* If the bootloader update image is called `pieeprom.upd` then `recovery.bin` is renamed to `recovery.000` once the update has completed, then the system is rebooted. Since `recovery.bin` is no longer present the ROM loads the newly updated bootloader from SPI flash and the OS is booted as normal.
293293
* If the bootloader update image is called `pieeprom.bin` then `recovery.bin` will stop after the update has completed. On success the HDMI output will be green and the green activity LED is flashed rapidly. If the update fails, the HDMI output will be red and an xref:configuration.adoc#led-warning-flash-codes[error code] will be displayed via the activity LED.
294-
* The `.sig` files contain the hexadecimal sha256 checksum of the corresponding image file; additional fields may be added in the future.
294+
* The `.sig` files contain the hexadecimal sha256 checksum of the corresponding image file on the first line, followed by the timestamp of the image (`ts: unixtime`); additional fields may be added in the future.
295295
* The ROM found on BCM2711 and BCM2712 does not support loading `recovery.bin` from USB mass storage or TFTP. Instead, newer versions of the bootloader support a self-update mechanism where the bootloader is able to reflash the SPI flash itself. See `ENABLE_SELF_UPDATE` on the xref:raspberry-pi.adoc#raspberry-pi-bootloader-configuration[bootloader configuration] page.
296296
* The temporary EEPROM update files are automatically deleted by the `rpi-eeprom-update` service at startup.
297297

0 commit comments

Comments
 (0)