fix(esp32c5): fix bootloader address

Dzarda7 · Dzarda7 · commit 83e09736aa85 · 2025-03-26T23:45:53.000+01:00
diff --git a/docs/en/advanced-topics/boot-mode-selection.rst b/docs/en/advanced-topics/boot-mode-selection.rst
@@ -2,7 +2,7 @@
 
 {IDF_TARGET_STRAP_BOOT_2_GPIO:default="GPIO8", esp32="GPIO2", esp32s2="GPIO46", esp32s3="GPIO46", esp32p4="GPIO36", esp32c5="GPIO27"}
 
-{IDF_TARGET_BOOTLOADER_OFFSET:default="0", esp32="1000", esp32s2="1000", esp32p4="2000"}
+{IDF_TARGET_BOOTLOADER_OFFSET:default="0x0", esp32="0x1000", esp32s2="0x1000", esp32p4="0x2000", esp32c5="0x2000"}
 
 .. _boot-mode:
 
@@ -224,7 +224,7 @@ Depending on the kind of hardware you have, it may also be possible to manually
 
    **chksum:**
 
-   If value of “chksum” == value of “csum”, it means flash has been read correctly during booting.
+   If value of "chksum" == value of "csum", it means flash has been read correctly during booting.
 
    The rest of boot messages are used internally by Espressif.
 
@@ -290,15 +290,23 @@ Depending on the kind of hardware you have, it may also be possible to manually
    Early Flash Read Error
    """"""""""""""""""""""
 
-   ::
+   .. only:: esp8266
+
+      ::
+
+         flash read err, 0
+
+   .. only:: not esp8266
+
+      ::
 
-      flash read err, {IDF_TARGET_BOOTLOADER_OFFSET}
+         Invalid header <value at {IDF_TARGET_BOOTLOADER_OFFSET}>
 
-   This fatal error indicates that the bootloader tried to read the software bootloader header at address 0x{IDF_TARGET_BOOTLOADER_OFFSET} but failed to read valid data. Possible reasons for this include:
+   This fatal error indicates that the bootloader tried to read the software bootloader header at address {IDF_TARGET_BOOTLOADER_OFFSET} but failed to read valid data. Possible reasons for this include:
 
    .. list::
 
-      -  There isn't actually a bootloader at offset 0x{IDF_TARGET_BOOTLOADER_OFFSET} (maybe the bootloader was flashed to the wrong offset by mistake, or the flash has been erased and no bootloader has been flashed yet.)
+      -  There isn't actually a bootloader at offset {IDF_TARGET_BOOTLOADER_OFFSET} (maybe the bootloader was flashed to the wrong offset by mistake, or the flash has been erased and no bootloader has been flashed yet.)
       -  Physical problem with the connection to the flash chip, or flash chip power.
       -  Flash encryption is enabled but the bootloader is plaintext. Alternatively, flash encryption is disabled but the bootloader is encrypted ciphertext.
 
@@ -326,7 +334,7 @@ Depending on the kind of hardware you have, it may also be possible to manually
          mode:DIO, clock div:1
 
 
-   This is normal boot output based on a combination of eFuse values and information read from the bootloader header at flash offset 0x{IDF_TARGET_BOOTLOADER_OFFSET}:
+   This is normal boot output based on a combination of eFuse values and information read from the bootloader header at flash offset {IDF_TARGET_BOOTLOADER_OFFSET}:
 
    .. list::
 
diff --git a/docs/en/advanced-topics/firmware-image-format.rst b/docs/en/advanced-topics/firmware-image-format.rst
@@ -6,7 +6,7 @@
 
 {IDF_TARGET_FLASH_FREQ_2:default="20", esp32c2="15", esp32h2="12"}
 
-{IDF_TARGET_BOOTLOADER_OFFSET:default="0x0", esp32="0x1000", esp32s2="0x1000", esp32p4="0x2000"}
+{IDF_TARGET_BOOTLOADER_OFFSET:default="0x0", esp32="0x1000", esp32s2="0x1000", esp32p4="0x2000", esp32c5="0x2000"}
 
 
 .. _image-format:
diff --git a/docs/en/esptool/advanced-commands.rst b/docs/en/esptool/advanced-commands.rst
@@ -1,4 +1,4 @@
-{IDF_TARGET_BOOTLOADER_OFFSET:default="0x0", esp32="0x1000", esp32s2="0x1000", esp32p4="0x2000"}
+{IDF_TARGET_BOOTLOADER_OFFSET:default="0x0", esp32="0x1000", esp32s2="0x1000", esp32p4="0x2000", esp32c5="0x2000"}
 
 .. _advanced-commands:
 
diff --git a/docs/en/esptool/flash-modes.rst b/docs/en/esptool/flash-modes.rst
@@ -1,4 +1,4 @@
-{IDF_TARGET_BOOTLOADER_OFFSET:default="0x0", esp32="0x1000", esp32s2="0x1000", esp32p4="0x2000"}
+{IDF_TARGET_BOOTLOADER_OFFSET:default="0x0", esp32="0x1000", esp32s2="0x1000", esp32p4="0x2000", esp32c5="0x2000"}
 
 {IDF_TARGET_FLASH_FREQ_F:default="80", esp32c2="60", esp32h2="48"}
 
diff --git a/docs/en/esptool/flashing-firmware.rst b/docs/en/esptool/flashing-firmware.rst
@@ -1,4 +1,4 @@
-{IDF_TARGET_BOOTLOADER_OFFSET:default="0x0", esp32="0x1000", esp32s2="0x1000", esp32p4="0x2000"}
+{IDF_TARGET_BOOTLOADER_OFFSET:default="0x0", esp32="0x1000", esp32s2="0x1000", esp32p4="0x2000", esp32c5="0x2000"}
 
 .. _flashing:
 
diff --git a/docs/en/troubleshooting.rst b/docs/en/troubleshooting.rst
@@ -1,4 +1,4 @@
-{IDF_TARGET_BOOTLOADER_OFFSET:default="0x0", esp32="0x1000", esp32s2="0x1000", esp32p4="0x2000"}
+{IDF_TARGET_BOOTLOADER_OFFSET:default="0x0", esp32="0x1000", esp32s2="0x1000", esp32p4="0x2000", esp32c5="0x2000"}
 
 .. _troubleshooting:
 
diff --git a/esptool/targets/esp32c5.py b/esptool/targets/esp32c5.py
@@ -16,6 +16,8 @@ class ESP32C5ROM(ESP32C6ROM):
     CHIP_NAME = "ESP32-C5"
     IMAGE_CHIP_ID = 23
 
+    BOOTLOADER_FLASH_OFFSET = 0x2000
+
     EFUSE_BASE = 0x600B4800
     EFUSE_BLOCK1_ADDR = EFUSE_BASE + 0x044
     MAC_EFUSE_REG = EFUSE_BASE + 0x044

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-{IDF_TARGET_BOOTLOADER_OFFSET:default="0x0", esp32="0x1000", esp32s2="0x1000", esp32p4="0x2000"}`
	`1`	`+{IDF_TARGET_BOOTLOADER_OFFSET:default="0x0", esp32="0x1000", esp32s2="0x1000", esp32p4="0x2000", esp32c5="0x2000"}`
`2`	`2`
`3`	`3`	`.. _advanced-commands:`
`4`	`4`