Skip to content

arch/risc-v: update MCUboot slot sizes on Espressif devices #18757

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
acassis merged 2 commits into from
Apr 19, 2026
Merged

arch/risc-v: update MCUboot slot sizes on Espressif devices #18757

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
6a5c45c
arch/risc-v: update MCUBoot slot size and offsets
fdcavalcanti Apr 16, 2026
7c2c2db
documentation: update ESP32-C3|C6|H2 flash allocation table
fdcavalcanti Apr 16, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
32 changes: 16 additions & 16 deletions Documentation/platforms/risc-v/esp32c3/index.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -700,18 +700,18 @@ based on the default KConfig values:
- 64KB
* - Primary Application Slot (/dev/ota0)
- 0x020000
- 1MB
- 1.4MB
* - Secondary Application Slot (/dev/ota1)
- 0x120000
- 1MB
- 0x170000
- 1.4MB
* - Scratch Partition (/dev/otascratch)
- 0x220000
- 0x2C0000
- 256KB
* - Storage MTD (optional)
- 0x260000
- 0x300000
- 1MB
* - Available Flash
- 0x360000+
- 0x400000+
- Remaining

.. raw:: html
Expand Down Expand Up @@ -740,27 +740,27 @@ virtual E-Fuses are later enabled.
0x020000 ├─────────────────────────────┤
│ │
│ Primary App Slot │
│ (1MB) │
│ (1.4MB) │
│ /dev/ota0 │
│ │
0x120000 ├─────────────────────────────┤
0x170000 ├─────────────────────────────┤
│ │
│ Secondary App Slot │
│ (1MB) │
│ (1.4MB) │
│ /dev/ota1 │
│ │
0x220000 ├─────────────────────────────┤
0x2C0000 ├─────────────────────────────┤
│ │
│ Scratch Partition │
│ (256KB) │
│ /dev/otascratch │
│ │
0x260000 ├─────────────────────────────┤
0x300000 ├─────────────────────────────┤
│ │
│ Storage MTD (optional) │
│ (1MB) │
│ │
0x360000 ├─────────────────────────────┤
0x400000 ├─────────────────────────────┤
│ │
│ Available Flash │
│ (Remaining) │
Expand All @@ -770,11 +770,11 @@ virtual E-Fuses are later enabled.
The key KConfig options that control this layout:

- ``ESPRESSIF_OTA_PRIMARY_SLOT_OFFSET`` (default: 0x20000)
- ``ESPRESSIF_OTA_SECONDARY_SLOT_OFFSET`` (default: 0x120000)
- ``ESPRESSIF_OTA_SLOT_SIZE`` (default: 0x100000)
- ``ESPRESSIF_OTA_SCRATCH_OFFSET`` (default: 0x220000)
- ``ESPRESSIF_OTA_SECONDARY_SLOT_OFFSET`` (default: 0x170000)
- ``ESPRESSIF_OTA_SLOT_SIZE`` (default: 0x150000)
- ``ESPRESSIF_OTA_SCRATCH_OFFSET`` (default: 0x2C0000)
- ``ESPRESSIF_OTA_SCRATCH_SIZE`` (default: 0x40000)
- ``ESPRESSIF_STORAGE_MTD_OFFSET`` (default: 0x260000 when MCUBoot enabled)
- ``ESPRESSIF_STORAGE_MTD_OFFSET`` (default: 0x300000 when MCUBoot enabled)
- ``ESPRESSIF_STORAGE_MTD_SIZE`` (default: 0x100000)

For MCUBoot operation:
Expand Down
34 changes: 17 additions & 17 deletions Documentation/platforms/risc-v/esp32c6/index.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -697,18 +697,18 @@ based on the default KConfig values:
- 64KB
* - Primary Application Slot (/dev/ota0)
- 0x020000
- 1MB
- 1.4MB
* - Secondary Application Slot (/dev/ota1)
- 0x120000
- 1MB
- 0x170000
- 1.4MB
* - Scratch Partition (/dev/otascratch)
- 0x220000
- 0x2C0000
- 256KB
* - Storage MTD (optional)
- 0x260000
- 0x300000
- 1MB
* - Available Flash
- 0x360000+
- 0x400000+
- Remaining

.. raw:: html
Expand Down Expand Up @@ -737,27 +737,27 @@ virtual E-Fuses are later enabled.
0x020000 ├─────────────────────────────┤
│ │
│ Primary App Slot │
│ (1MB) │
│ (1.4MB) │
│ /dev/ota0 │
│ │
0x120000 ├─────────────────────────────┤
0x170000 ├─────────────────────────────┤
│ │
│ Secondary App Slot │
│ (1MB) │
│ (1.4MB) │
│ /dev/ota1 │
│ │
0x220000 ├─────────────────────────────┤
0x2C0000 ├─────────────────────────────┤
│ │
│ Scratch Partition │
│ (256KB) │
│ /dev/otascratch │
│ │
0x260000 ├─────────────────────────────┤
0x300000 ├─────────────────────────────┤
│ │
│ Storage MTD (optional) │
│ Storage MTD (optional) │
│ (1MB) │
│ │
0x360000 ├─────────────────────────────┤
0x400000 ├─────────────────────────────┤
│ │
│ Available Flash │
│ (Remaining) │
Expand All @@ -767,11 +767,11 @@ virtual E-Fuses are later enabled.
The key KConfig options that control this layout:

- ``ESPRESSIF_OTA_PRIMARY_SLOT_OFFSET`` (default: 0x20000)
- ``ESPRESSIF_OTA_SECONDARY_SLOT_OFFSET`` (default: 0x120000)
- ``ESPRESSIF_OTA_SLOT_SIZE`` (default: 0x100000)
- ``ESPRESSIF_OTA_SCRATCH_OFFSET`` (default: 0x220000)
- ``ESPRESSIF_OTA_SECONDARY_SLOT_OFFSET`` (default: 0x170000)
- ``ESPRESSIF_OTA_SLOT_SIZE`` (default: 0x150000)
- ``ESPRESSIF_OTA_SCRATCH_OFFSET`` (default: 0x2C0000)
- ``ESPRESSIF_OTA_SCRATCH_SIZE`` (default: 0x40000)
- ``ESPRESSIF_STORAGE_MTD_OFFSET`` (default: 0x260000 when MCUBoot enabled)
- ``ESPRESSIF_STORAGE_MTD_OFFSET`` (default: 0x300000 when MCUBoot enabled)
- ``ESPRESSIF_STORAGE_MTD_SIZE`` (default: 0x100000)

For MCUBoot operation:
Expand Down
34 changes: 17 additions & 17 deletions Documentation/platforms/risc-v/esp32h2/index.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -608,18 +608,18 @@ based on the default KConfig values:
- 64KB
* - Primary Application Slot (/dev/ota0)
- 0x020000
- 1MB
- 1.4MB
* - Secondary Application Slot (/dev/ota1)
- 0x120000
- 1MB
- 0x170000
- 1.4MB
* - Scratch Partition (/dev/otascratch)
- 0x220000
- 0x2C0000
- 256KB
* - Storage MTD (optional)
- 0x260000
- 0x300000
- 1MB
* - Available Flash
- 0x360000+
- 0x400000+
- Remaining

.. raw:: html
Expand Down Expand Up @@ -648,27 +648,27 @@ virtual E-Fuses are later enabled.
0x020000 ├─────────────────────────────┤
│ │
│ Primary App Slot │
│ (1MB) │
│ (1.4MB) │
│ /dev/ota0 │
│ │
0x120000 ├─────────────────────────────┤
0x170000 ├─────────────────────────────┤
│ │
│ Secondary App Slot │
│ (1MB) │
│ (1.4MB) │
│ /dev/ota1 │
│ │
0x220000 ├─────────────────────────────┤
0x2C0000 ├─────────────────────────────┤
│ │
│ Scratch Partition │
│ (256KB) │
│ /dev/otascratch │
│ │
0x260000 ├─────────────────────────────┤
0x300000 ├─────────────────────────────┤
│ │
│ Storage MTD (optional) │
│ Storage MTD (optional) │
│ (1MB) │
│ │
0x360000 ├─────────────────────────────┤
0x400000 ├─────────────────────────────┤
│ │
│ Available Flash │
│ (Remaining) │
Expand All @@ -678,11 +678,11 @@ virtual E-Fuses are later enabled.
The key KConfig options that control this layout:

- ``ESPRESSIF_OTA_PRIMARY_SLOT_OFFSET`` (default: 0x20000)
- ``ESPRESSIF_OTA_SECONDARY_SLOT_OFFSET`` (default: 0x120000)
- ``ESPRESSIF_OTA_SLOT_SIZE`` (default: 0x100000)
- ``ESPRESSIF_OTA_SCRATCH_OFFSET`` (default: 0x220000)
- ``ESPRESSIF_OTA_SECONDARY_SLOT_OFFSET`` (default: 0x170000)
- ``ESPRESSIF_OTA_SLOT_SIZE`` (default: 0x150000)
- ``ESPRESSIF_OTA_SCRATCH_OFFSET`` (default: 0x2C0000)
- ``ESPRESSIF_OTA_SCRATCH_SIZE`` (default: 0x40000)
- ``ESPRESSIF_STORAGE_MTD_OFFSET`` (default: 0x260000 when MCUBoot enabled)
- ``ESPRESSIF_STORAGE_MTD_OFFSET`` (default: 0x300000 when MCUBoot enabled)
- ``ESPRESSIF_STORAGE_MTD_SIZE`` (default: 0x100000)

For MCUBoot operation:
Expand Down
8 changes: 4 additions & 4 deletions arch/risc-v/src/common/espressif/Kconfig
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -382,19 +382,19 @@ config ESPRESSIF_OTA_PRIMARY_SLOT_DEVPATH

config ESPRESSIF_OTA_SECONDARY_SLOT_OFFSET
hex "Application image secondary slot offset"
default 0x120000
default 0x170000

config ESPRESSIF_OTA_SECONDARY_SLOT_DEVPATH
string "Application image secondary slot device path"
default "/dev/ota1"

config ESPRESSIF_OTA_SLOT_SIZE
hex "Application image slot size (in bytes)"
default 0x100000
default 0x150000

config ESPRESSIF_OTA_SCRATCH_OFFSET
hex "Scratch partition offset"
default 0x220000
default 0x2C0000

config ESPRESSIF_OTA_SCRATCH_SIZE
hex "Scratch partition size"
Expand Down Expand Up @@ -3056,7 +3056,7 @@ config ESPRESSIF_STORAGE_MTD_DEBUG
config ESPRESSIF_STORAGE_MTD_OFFSET
hex "Storage MTD base address in SPI Flash"
default 0x180000 if !ESPRESSIF_BOOTLOADER_MCUBOOT
default 0x260000 if ESPRESSIF_BOOTLOADER_MCUBOOT
default 0x300000 if ESPRESSIF_BOOTLOADER_MCUBOOT
depends on ESPRESSIF_MTD
---help---
MTD base address in SPI Flash.
Expand Down
Loading