This is an automated email from the ASF dual-hosted git repository. linguini1 pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/nuttx.git
commit 328ffdb297ce19f0f334a0c6797137a3aeb70d54 Author: Eren Terzioglu <[email protected]> AuthorDate: Mon Jan 5 12:47:14 2026 +0100 Docs/platforms/espressif: Add UF2 file format docs Add UF2 file format docs for RISC-V based Espressif devices Signed-off-by: Eren Terzioglu <[email protected]> --- Documentation/platforms/risc-v/esp32c3/index.rst | 6 ++++++ Documentation/platforms/risc-v/esp32c6/index.rst | 6 ++++++ Documentation/platforms/risc-v/esp32h2/index.rst | 6 ++++++ 3 files changed, 18 insertions(+) diff --git a/Documentation/platforms/risc-v/esp32c3/index.rst b/Documentation/platforms/risc-v/esp32c3/index.rst index d56c51efeed..99edb8e60a9 100644 --- a/Documentation/platforms/risc-v/esp32c3/index.rst +++ b/Documentation/platforms/risc-v/esp32c3/index.rst @@ -131,6 +131,12 @@ where: * ``ESPTOOL_BINDIR=./`` is the path of the externally-built 2nd stage bootloader and the partition table (if applicable): when built using the ``make bootloader``, these files are placed into ``nuttx`` folder. * ``ESPTOOL_BAUD`` is able to change the flash baud rate if desired. +To create and flash with UF2 (USB Flashing Format) binary, ``UF2=1`` option needs to be set during build phase +(e.g ``make UF2=1 -j8``). This flag will create UF2 format file addition to binary. This output can be used to +flash the device with `ESP USB Bridge <https://github.com/espressif/esp-usb-bridge>`__. +To flash using ESP USB Bridge, either drag and drop the generated UF2 file onto the flasher's +mass storage device, or use the ``UF2=1`` flag during flashing (e.g. ``make flash ESPTOOL_PORT=<port> ESPTOOL_BINDIR=./ UF2=1``) + Flashing NSH Example -------------------- diff --git a/Documentation/platforms/risc-v/esp32c6/index.rst b/Documentation/platforms/risc-v/esp32c6/index.rst index c221ed0b196..1cda738ceea 100644 --- a/Documentation/platforms/risc-v/esp32c6/index.rst +++ b/Documentation/platforms/risc-v/esp32c6/index.rst @@ -131,6 +131,12 @@ where: * ``ESPTOOL_BINDIR=./`` is the path of the externally-built 2nd stage bootloader and the partition table (if applicable): when built using the ``make bootloader``, these files are placed into ``nuttx`` folder. * ``ESPTOOL_BAUD`` is able to change the flash baud rate if desired. +To create and flash with UF2 (USB Flashing Format) binary, ``UF2=1`` option needs to be set during build phase +(e.g ``make UF2=1 -j8``). This flag will create UF2 format file addition to binary. This output can be used to +flash the device with `ESP USB Bridge <https://github.com/espressif/esp-usb-bridge>`__. +To flash using ESP USB Bridge, either drag and drop the generated UF2 file onto the flasher's +mass storage device, or use the ``UF2=1`` flag during flashing (e.g. ``make flash ESPTOOL_PORT=<port> ESPTOOL_BINDIR=./ UF2=1``) + Flashing NSH Example -------------------- diff --git a/Documentation/platforms/risc-v/esp32h2/index.rst b/Documentation/platforms/risc-v/esp32h2/index.rst index e14db7bba66..33ecb7278cf 100644 --- a/Documentation/platforms/risc-v/esp32h2/index.rst +++ b/Documentation/platforms/risc-v/esp32h2/index.rst @@ -131,6 +131,12 @@ where: * ``ESPTOOL_BINDIR=./`` is the path of the externally-built 2nd stage bootloader and the partition table (if applicable): when built using the ``make bootloader``, these files are placed into ``nuttx`` folder. * ``ESPTOOL_BAUD`` is able to change the flash baud rate if desired. +To create and flash with UF2 (USB Flashing Format) binary, ``UF2=1`` option needs to be set during build phase +(e.g ``make UF2=1 -j8``). This flag will create UF2 format file addition to binary. This output can be used to +flash the device with `ESP USB Bridge <https://github.com/espressif/esp-usb-bridge>`__. +To flash using ESP USB Bridge, either drag and drop the generated UF2 file onto the flasher's +mass storage device, or use the ``UF2=1`` flag during flashing (e.g. ``make flash ESPTOOL_PORT=<port> ESPTOOL_BINDIR=./ UF2=1``) + Flashing NSH Example --------------------
