diff --git a/boards/ambiq/apollo3_evb/doc/index.rst b/boards/ambiq/apollo3_evb/doc/index.rst index 6b6ad6c1089..c8d56b0443b 100644 --- a/boards/ambiq/apollo3_evb/doc/index.rst +++ b/boards/ambiq/apollo3_evb/doc/index.rst @@ -26,6 +26,8 @@ Supported Features Programming and Debugging ========================= +.. zephyr:board-supported-runners:: + Flashing an application ----------------------- diff --git a/boards/ambiq/apollo3p_evb/doc/index.rst b/boards/ambiq/apollo3p_evb/doc/index.rst index 4612d28dd41..1aa477d785d 100644 --- a/boards/ambiq/apollo3p_evb/doc/index.rst +++ b/boards/ambiq/apollo3p_evb/doc/index.rst @@ -26,6 +26,8 @@ Supported Features Programming and Debugging ========================= +.. zephyr:board-supported-runners:: + Flashing an application ----------------------- diff --git a/boards/ambiq/apollo4p_blue_kxr_evb/doc/index.rst b/boards/ambiq/apollo4p_blue_kxr_evb/doc/index.rst index f79a8b80070..b6e891ef53f 100644 --- a/boards/ambiq/apollo4p_blue_kxr_evb/doc/index.rst +++ b/boards/ambiq/apollo4p_blue_kxr_evb/doc/index.rst @@ -28,6 +28,8 @@ Supported Features Programming and Debugging ========================= +.. zephyr:board-supported-runners:: + Flashing an application ----------------------- diff --git a/boards/ambiq/apollo4p_evb/doc/index.rst b/boards/ambiq/apollo4p_evb/doc/index.rst index 9561b162b1b..ab8ccfd456a 100644 --- a/boards/ambiq/apollo4p_evb/doc/index.rst +++ b/boards/ambiq/apollo4p_evb/doc/index.rst @@ -27,6 +27,8 @@ Supported Features Programming and Debugging ========================= +.. zephyr:board-supported-runners:: + Flashing an application ----------------------- diff --git a/boards/espressif/esp32s3_eye/doc/index.rst b/boards/espressif/esp32s3_eye/doc/index.rst index 36190e2e150..e7b7643cbba 100644 --- a/boards/espressif/esp32s3_eye/doc/index.rst +++ b/boards/espressif/esp32s3_eye/doc/index.rst @@ -135,6 +135,8 @@ below to retrieve those files. Building & Flashing ******************* +.. zephyr:board-supported-runners:: + Simple boot ----------- diff --git a/boards/kws/pico2_spe/doc/index.rst b/boards/kws/pico2_spe/doc/index.rst index d7c64e9d9ba..48bccacea86 100644 --- a/boards/kws/pico2_spe/doc/index.rst +++ b/boards/kws/pico2_spe/doc/index.rst @@ -42,6 +42,8 @@ The default pin mapping is unchanged from the Pico-SPE. Programming and Debugging ************************* +.. zephyr:board-supported-runners:: + As with the Pico-SPE, the SWD interface can be used to program and debug the device, e.g. using OpenOCD with the `Raspberry Pi Debug Probe `_ . diff --git a/boards/kws/pico_spe/doc/index.rst b/boards/kws/pico_spe/doc/index.rst index c5c160b8250..3246d36a972 100644 --- a/boards/kws/pico_spe/doc/index.rst +++ b/boards/kws/pico_spe/doc/index.rst @@ -82,6 +82,8 @@ devices as well as both PIO devices). Programming and Debugging ************************* +.. zephyr:board-supported-runners:: + Flashing ======== diff --git a/boards/lilygo/tdongle_s3/doc/index.rst b/boards/lilygo/tdongle_s3/doc/index.rst index 634812677c8..b90f5a21417 100644 --- a/boards/lilygo/tdongle_s3/doc/index.rst +++ b/boards/lilygo/tdongle_s3/doc/index.rst @@ -54,6 +54,8 @@ below to retrieve those files. Building & Flashing ******************* +.. zephyr:board-supported-runners:: + Simple boot =========== diff --git a/boards/lilygo/ttgo_tbeam/doc/index.rst b/boards/lilygo/ttgo_tbeam/doc/index.rst index 7c6911b0c4d..fa6082abaa2 100644 --- a/boards/lilygo/ttgo_tbeam/doc/index.rst +++ b/boards/lilygo/ttgo_tbeam/doc/index.rst @@ -51,6 +51,8 @@ below to retrieve those files. Building & Flashing ******************* +.. zephyr:board-supported-runners:: + Simple boot =========== diff --git a/boards/nuvoton/numaker_m2l31ki/doc/index.rst b/boards/nuvoton/numaker_m2l31ki/doc/index.rst index cf8a480ef69..a91bdc32778 100644 --- a/boards/nuvoton/numaker_m2l31ki/doc/index.rst +++ b/boards/nuvoton/numaker_m2l31ki/doc/index.rst @@ -32,6 +32,9 @@ More details about the supported peripherals are available in `M2L31 TRM`_ Building and Flashing ********************* + +.. zephyr:board-supported-runners:: + Flashing ======== diff --git a/boards/nuvoton/numaker_m55m1/doc/index.rst b/boards/nuvoton/numaker_m55m1/doc/index.rst index 57bb7708076..d1b37b22e37 100644 --- a/boards/nuvoton/numaker_m55m1/doc/index.rst +++ b/boards/nuvoton/numaker_m55m1/doc/index.rst @@ -33,6 +33,9 @@ More details about the supported peripherals are available in `M55M1 TRM`_ Building and Flashing ********************* + +.. zephyr:board-supported-runners:: + Flashing ======== diff --git a/boards/nuvoton/numaker_pfm_m467/doc/index.rst b/boards/nuvoton/numaker_pfm_m467/doc/index.rst index 5301fb06ea6..622a84c9eb9 100644 --- a/boards/nuvoton/numaker_pfm_m467/doc/index.rst +++ b/boards/nuvoton/numaker_pfm_m467/doc/index.rst @@ -35,6 +35,9 @@ More details about the supported peripherals are available in `M460 TRM`_ Building and Flashing ********************* + +.. zephyr:board-supported-runners:: + Flashing ======== diff --git a/boards/nxp/frdm_mcxa166/doc/index.rst b/boards/nxp/frdm_mcxa166/doc/index.rst index 7d3e34c5f68..16f0245349f 100644 --- a/boards/nxp/frdm_mcxa166/doc/index.rst +++ b/boards/nxp/frdm_mcxa166/doc/index.rst @@ -62,6 +62,8 @@ LPUART 2 is configured as UART for the console. Programming and Debugging ************************* +.. zephyr:board-supported-runners:: + Build and flash applications as usual (see :ref:`build_an_application` and :ref:`application_run` for more details). diff --git a/boards/nxp/frdm_mcxa276/doc/index.rst b/boards/nxp/frdm_mcxa276/doc/index.rst index 83eb279459f..c176de8b82c 100644 --- a/boards/nxp/frdm_mcxa276/doc/index.rst +++ b/boards/nxp/frdm_mcxa276/doc/index.rst @@ -109,6 +109,11 @@ Connect a USB cable from your PC to J15, and use the serial terminal of your cho - Parity: None - Stop bits: 1 +Programming and Debugging +========================= + +.. zephyr:board-supported-runners:: + Flashing ======== diff --git a/boards/nxp/imx8mm_evk/doc/index.rst b/boards/nxp/imx8mm_evk/doc/index.rst index 743931a024e..3c2a8540aba 100644 --- a/boards/nxp/imx8mm_evk/doc/index.rst +++ b/boards/nxp/imx8mm_evk/doc/index.rst @@ -66,6 +66,8 @@ CPU's UART4. This is used for the M4 and A53 core targets. Programming and Debugging (A53) ******************************* +.. zephyr:board-supported-runners:: + U-Boot "cpu" command is used to load and kick Zephyr to Cortex-A secondary Core, Currently it is supported in : `Real-Time Edge U-Boot`_ (use the branch "uboot_vxxxx.xx-y.y.y, xxxx.xx is uboot version and y.y.y is Real-Time Edge Software version, for example diff --git a/boards/nxp/imx8mp_evk/doc/index.rst b/boards/nxp/imx8mp_evk/doc/index.rst index d64dedc3e31..70f14700813 100644 --- a/boards/nxp/imx8mp_evk/doc/index.rst +++ b/boards/nxp/imx8mp_evk/doc/index.rst @@ -62,6 +62,8 @@ CPU's UART4. Programming and Debugging (A53) ******************************* +.. zephyr:board-supported-runners:: + U-Boot "cpu" command is used to load and kick Zephyr to Cortex-A secondary Core, Currently it is supported in : `Real-Time Edge U-Boot`_ (use the branch "uboot_vxxxx.xx-y.y.y, xxxx.xx is uboot version and y.y.y is Real-Time Edge Software version, for example diff --git a/boards/nxp/imx93_evk/doc/index.rst b/boards/nxp/imx93_evk/doc/index.rst index 765fec276e9..84b90410539 100644 --- a/boards/nxp/imx93_evk/doc/index.rst +++ b/boards/nxp/imx93_evk/doc/index.rst @@ -116,6 +116,8 @@ Note: The overlay only supports ``mimx9352/a55``, but can be extended to support Programming and Debugging (A55) ******************************* +.. zephyr:board-supported-runners:: + U-Boot "cpu" command is used to load and kick Zephyr to Cortex-A secondary Core, Currently it is supported in : `Real-Time Edge U-Boot`_ (use the branch "uboot_vxxxx.xx-y.y.y, xxxx.xx is uboot version and y.y.y is Real-Time Edge Software version, for example diff --git a/boards/nxp/imx95_evk/doc/index.rst b/boards/nxp/imx95_evk/doc/index.rst index bd43f51c4c0..75aba8fd01d 100644 --- a/boards/nxp/imx95_evk/doc/index.rst +++ b/boards/nxp/imx95_evk/doc/index.rst @@ -113,6 +113,8 @@ The first ENET1 port could be enabled for M7 by west build option Programming and Debugging (A55) ******************************* +.. zephyr:board-supported-runners:: + Use this configuration to run basic Zephyr applications and kernel tests, for example, with the :zephyr:code-sample:`synchronization` sample: diff --git a/boards/olimex/olimexino_stm32/doc/index.rst b/boards/olimex/olimexino_stm32/doc/index.rst index 55f8c7309b9..76a4466ff1c 100644 --- a/boards/olimex/olimexino_stm32/doc/index.rst +++ b/boards/olimex/olimexino_stm32/doc/index.rst @@ -351,6 +351,8 @@ The default jumper settings for the OLIMEXIMO-STM32E are: Flashing Zephyr onto OLIMEXINO-STM32 ************************************ +.. zephyr:board-supported-runners:: + Flashing the Zephyr kernel onto OLIMEXINO-STM32 requires the `stm32flash tool`_. diff --git a/boards/others/serpente/doc/index.rst b/boards/others/serpente/doc/index.rst index 05fe15c4766..3872360dabc 100644 --- a/boards/others/serpente/doc/index.rst +++ b/boards/others/serpente/doc/index.rst @@ -46,6 +46,8 @@ to the host PC. Programming and Debugging ========================= +.. zephyr:board-supported-runners:: + The Serpente ships the BOSSA compatible UF2 bootloader. The bootloader can be entered by quickly tapping the reset button twice. diff --git a/boards/rakwireless/rak11720/doc/index.rst b/boards/rakwireless/rak11720/doc/index.rst index c6bc5cfc786..081753fbfd6 100644 --- a/boards/rakwireless/rak11720/doc/index.rst +++ b/boards/rakwireless/rak11720/doc/index.rst @@ -42,6 +42,8 @@ Supported Features Programming and Debugging ========================= +.. zephyr:board-supported-runners:: + The RAK11720 board shall be connected to a Segger Embedded Debugger Unit `J-Link OB `_. This provides a debug interface to the Apollo3 Blue chip. You can use JLink to communicate with diff --git a/boards/rakwireless/rak3172/doc/index.rst b/boards/rakwireless/rak3172/doc/index.rst index 81aedb6317b..f251c41ace3 100644 --- a/boards/rakwireless/rak3172/doc/index.rst +++ b/boards/rakwireless/rak3172/doc/index.rst @@ -43,6 +43,8 @@ Supported Features Programming and Debugging ========================= +.. zephyr:board-supported-runners:: + The RAK3172 board can be debugged and flashed with an external debug probe connected to the SWD pins. It can also be flashed via `pyOCD`_, but have to install an additional pack to support STM32WL. diff --git a/boards/renesas/rzt2m_rsk/doc/index.rst b/boards/renesas/rzt2m_rsk/doc/index.rst index 44cbe3dab36..4beff6866a4 100644 --- a/boards/renesas/rzt2m_rsk/doc/index.rst +++ b/boards/renesas/rzt2m_rsk/doc/index.rst @@ -62,6 +62,8 @@ The Zephyr console uses UART0. Programming and Debugging ************************* +.. zephyr:board-supported-runners:: + Applications for the ``rzt2m_rsk`` board can be built in the usual way as documented in :ref:`build_an_application`. diff --git a/boards/sensry/ganymed_bob/doc/index.rst b/boards/sensry/ganymed_bob/doc/index.rst index 6a73dbd9170..0726dc771ec 100644 --- a/boards/sensry/ganymed_bob/doc/index.rst +++ b/boards/sensry/ganymed_bob/doc/index.rst @@ -64,6 +64,8 @@ For more detailed description please refer to `Ganymed BreakOut Board Documentat Programming and Testing *********************** +.. zephyr:board-supported-runners:: + Building ======== diff --git a/boards/sensry/ganymed_sk/doc/index.rst b/boards/sensry/ganymed_sk/doc/index.rst index 134714bdc18..fbddec63913 100644 --- a/boards/sensry/ganymed_sk/doc/index.rst +++ b/boards/sensry/ganymed_sk/doc/index.rst @@ -64,6 +64,8 @@ For more detailed description please refer to `Ganymed StarterKit Board Document Programming and Testing *********************** +.. zephyr:board-supported-runners:: + Building ======== diff --git a/boards/silabs/dev_kits/sltb010a/doc/index.rst b/boards/silabs/dev_kits/sltb010a/doc/index.rst index 9638598126a..a9fcdd71643 100644 --- a/boards/silabs/dev_kits/sltb010a/doc/index.rst +++ b/boards/silabs/dev_kits/sltb010a/doc/index.rst @@ -89,6 +89,8 @@ board. Programming and Debugging ========================= +.. zephyr:board-supported-runners:: + Flashing an application ----------------------- diff --git a/boards/silabs/dev_kits/xg27_dk2602a/doc/index.rst b/boards/silabs/dev_kits/xg27_dk2602a/doc/index.rst index 4dc3814d9a6..eec5ba7c021 100644 --- a/boards/silabs/dev_kits/xg27_dk2602a/doc/index.rst +++ b/boards/silabs/dev_kits/xg27_dk2602a/doc/index.rst @@ -81,6 +81,8 @@ Commander in unattended mode and passes all the necessary arguments to it. Programming and Debugging ========================= +.. zephyr:board-supported-runners:: + The sample application :zephyr:code-sample:`hello_world` is used for this example. Build the Zephyr kernel and application: diff --git a/boards/st/steval_stwinbx1/doc/index.rst b/boards/st/steval_stwinbx1/doc/index.rst index 5273492d990..1622f07b3af 100644 --- a/boards/st/steval_stwinbx1/doc/index.rst +++ b/boards/st/steval_stwinbx1/doc/index.rst @@ -256,7 +256,9 @@ There are two possible options for Zephyr console output: Console default settings are 115200 8N1. Programming and Debugging -------------------------- +************************* + +.. zephyr:board-supported-runners:: There are two alternative methods of flashing ST Sensortile.box Pro board: @@ -297,7 +299,7 @@ It is recommended to use the latest version of `STM32CubeProgrammer`_ Flash an Application to STEVAL-STWINBX1 ------------------------------------------- +--------------------------------------- There are two ways to enter DFU mode: diff --git a/boards/st/stm32mp135f_dk/doc/index.rst b/boards/st/stm32mp135f_dk/doc/index.rst index 9000f28bbfb..d56cb0c4c12 100644 --- a/boards/st/stm32mp135f_dk/doc/index.rst +++ b/boards/st/stm32mp135f_dk/doc/index.rst @@ -108,6 +108,8 @@ Memory mapping Programming and Debugging ************************* +.. zephyr:board-supported-runners:: + Prerequisite ============ diff --git a/boards/ti/msp_exp432p401r_launchxl/doc/index.rst b/boards/ti/msp_exp432p401r_launchxl/doc/index.rst index 126ddba4541..61598eb8201 100644 --- a/boards/ti/msp_exp432p401r_launchxl/doc/index.rst +++ b/boards/ti/msp_exp432p401r_launchxl/doc/index.rst @@ -36,6 +36,8 @@ More details about the supported peripherals are available in MSP432P4XX TRM. Building and Flashing ********************* +.. zephyr:board-supported-runners:: + Prerequisites: ============== diff --git a/boards/vcc-gnd/yd_stm32h750vb/doc/index.rst b/boards/vcc-gnd/yd_stm32h750vb/doc/index.rst index 5905e639068..8ce686dc509 100644 --- a/boards/vcc-gnd/yd_stm32h750vb/doc/index.rst +++ b/boards/vcc-gnd/yd_stm32h750vb/doc/index.rst @@ -42,6 +42,8 @@ is driven by the PLL clock at 480MHz. PLL clock is feed by a 25MHz high speed ex Flashing ======== +.. zephyr:board-supported-runners:: + There are 2 main entry points for flashing STM32H750VB SoCs, one using the ROM bootloader, and another by using the SWD debug port (which requires additional hardware such as ST-Link). Flashing using the ROM bootloader requires a special activation diff --git a/boards/we/ophelia4ev/doc/index.rst b/boards/we/ophelia4ev/doc/index.rst index cbfce933420..ad981f6c01d 100644 --- a/boards/we/ophelia4ev/doc/index.rst +++ b/boards/we/ophelia4ev/doc/index.rst @@ -26,6 +26,8 @@ Supported Features Programming and Debugging ************************* +.. zephyr:board-supported-runners:: + Applications for the ``ophelia4ev/nrf54l15/cpuapp`` board target can be built, flashed, and debugged in the usual way. See :ref:`build_an_application` and :ref:`application_run` for more details on