Skip to content

Commit 202dfad

Browse files
committed
docs(elf2image): Link an article with Simple Boot explanation
1 parent 5d5eafb commit 202dfad

File tree

1 file changed

+1
-0
lines changed

1 file changed

+1
-0
lines changed

docs/en/esptool/basic-commands.rst

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -221,6 +221,7 @@ By default, ``elf2image`` uses the sections in the ELF file to generate each seg
221221
In the above example, the output image file would be called ``my_esp_app.bin``.
222222

223223
The ``--ram-only-header`` configuration is mainly applicable for use within the Espressif's SIMPLE_BOOT option from 3rd party OSes such as ZephyrOS and NuttX OS.
224+
For a detailed explanation of Simple Boot and how it works, see `Simple Boot explained <https://developer.espressif.com/blog/2025/06/simple-boot-explained/>`_.
224225
This option makes only the RAM segments visible to the ROM bootloader placing them at the beginning of the file and altering the segment count from the image header with the quantity of these segments, and also writing only their checksum. This segment placement may result in a more fragmented binary because of flash alignment constraints.
225226
It is strongly recommended to use this configuration with care, because the image built must then handle the basic hardware initialization and the flash mapping for code execution after ROM bootloader boot it.
226227

0 commit comments

Comments
 (0)