doc: boards: nordic: Adopt zephyr:board directives

Migrate all Nordic boards to leverage the full extent of zephyr:board
directives.

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>

boards/nordic/nrf21540dk/doc/index.rst

@@ -1,7 +1,4 @@
-.. _nrf21540dk_nrf52840:
+.. zephyr:board:: nrf21540dk
-
-nRF21540 DK
-###########
 
 Overview
 ********
@@ -25,12 +22,6 @@ The CPU provides support for the following devices:
 * :abbr:`USB (Universal Serial Bus)`
 * :abbr:`WDT (Watchdog Timer)`
 
-.. figure:: img/nrf21540dk_nrf52840.jpg
-     :align: center
-     :alt: nRF21540 DK
-
-     nRF21540 DK (Credit: Nordic Semiconductor)
-
 More information about the board can be found at the `nRF21540 website`_.
 `nRF21540 Product Specification`_ contains the processor's and front end
 module's information and the datasheet.
@@ -44,45 +35,8 @@ of the slow clock is 32.768 kHz. The frequency of the main clock is 32 MHz.
 Supported Features
 ==================
 
-The nrf21540dk/nrf52840 board configuration supports the following
+.. zephyr:board-supported-hw::
-hardware features:
 
-+-----------+------------+----------------------+
-| Interface | Controller | Driver/Component     |
-+===========+============+======================+
-| ADC       | on-chip    | adc                  |
-+-----------+------------+----------------------+
-| CLOCK     | on-chip    | clock_control        |
-+-----------+------------+----------------------+
-| FLASH     | on-chip    | flash                |
-+-----------+------------+----------------------+
-| GPIO      | on-chip    | gpio                 |
-+-----------+------------+----------------------+
-| I2C(M)    | on-chip    | i2c                  |
-+-----------+------------+----------------------+
-| MPU       | on-chip    | arch/arm             |
-+-----------+------------+----------------------+
-| NVIC      | on-chip    | arch/arm             |
-+-----------+------------+----------------------+
-| PWM       | on-chip    | pwm                  |
-+-----------+------------+----------------------+
-| RADIO     | on-chip    | Bluetooth,           |
-|           |            | ieee802154           |
-+-----------+------------+----------------------+
-| RTC       | on-chip    | system clock         |
-+-----------+------------+----------------------+
-| RTT       | Segger     | console              |
-+-----------+------------+----------------------+
-| SPI(M/S)  | on-chip    | spi                  |
-+-----------+------------+----------------------+
-| UART      | on-chip    | serial               |
-+-----------+------------+----------------------+
-| USB       | on-chip    | usb                  |
-+-----------+------------+----------------------+
-| WDT       | on-chip    | watchdog             |
-+-----------+------------+----------------------+
-
-Other hardware features have not been enabled yet for this board.
 See `nRF52840 Product Specification`_ and `nRF21540 DK Hardware guide`_
 for a complete list of nRF21540 Development Kit board hardware features.
 

boards/nordic/nrf51dk/doc/index.rst

@@ -1,7 +1,4 @@
-.. _nrf51dk_nrf51822:
+.. zephyr:board:: nrf51dk
-
-nRF51 DK
-########
 
 Overview
 ********
@@ -22,12 +19,6 @@ Semiconductor nRF51822 ARM Cortex-M0 CPU and the following devices:
 * :abbr:`UART (Universal asynchronous receiver-transmitter)`
 * :abbr:`WDT (Watchdog Timer)`
 
-.. figure:: img/nrf51dk_nrf51822.jpg
-     :align: center
-     :alt: nRF51 DK
-
-     nRF51 DK (Credit: Nordic Semiconductor)
-
 More information about the board can be found at the
 `nRF51 DK website`_. The `nRF51 Development Kit User Guide`_
 contains the processor's information and the datasheet.
@@ -43,38 +34,8 @@ is 16 MHz.
 Supported Features
 ==================
 
-The nrf51dk/nrf51822 board configuration supports the following nRF51
+.. zephyr:board-supported-hw::
-hardware features:
 
-+-----------+------------+----------------------+
-| Interface | Controller | Driver/Component     |
-+===========+============+======================+
-| ADC       | on-chip    | adc                  |
-+-----------+------------+----------------------+
-| CLOCK     | on-chip    | clock_control        |
-+-----------+------------+----------------------+
-| FLASH     | on-chip    | flash                |
-+-----------+------------+----------------------+
-| GPIO      | on-chip    | gpio                 |
-+-----------+------------+----------------------+
-| I2C(M)    | on-chip    | i2c                  |
-+-----------+------------+----------------------+
-| NVIC      | on-chip    | arch/arm             |
-+-----------+------------+----------------------+
-| RADIO     | on-chip    | Bluetooth            |
-+-----------+------------+----------------------+
-| RTC       | on-chip    | system clock         |
-+-----------+------------+----------------------+
-| RTT       | Segger     | console              |
-+-----------+------------+----------------------+
-| SPI(M/S)  | on-chip    | spi                  |
-+-----------+------------+----------------------+
-| UART      | on-chip    | serial               |
-+-----------+------------+----------------------+
-| WDT       | on-chip    | watchdog             |
-+-----------+------------+----------------------+
-
-Other hardware features have not been enabled yet for this board.
 See `nRF51 DK website`_ and `nRF51 Development Kit User Guide`_
 for a complete list of nRF51 Development Kit board hardware features.
 

boards/nordic/nrf51dongle/doc/index.rst

@@ -1,7 +1,4 @@
-.. _nrf51dongle_nrf51422:
+.. zephyr:board:: nrf51dongle
-
-nRF51 Dongle
-############
 
 Overview
 ********
@@ -22,12 +19,6 @@ Semiconductor nRF51822 ARM Cortex-M0 CPU and the following devices:
 * :abbr:`UART (Universal asynchronous receiver-transmitter)`
 * :abbr:`WDT (Watchdog Timer)`
 
-.. figure:: img/nrf51dongle_nrf51822.jpg
-     :align: center
-     :alt: nRF51 Dongle
-
-     nRF51 Dongle (Credit: Nordic Semiconductor)
-
 More information about the board can be found at the
 `nRF51 Dongle website`_. The `Nordic Semiconductor TechDocs`_
 contains the processor's information and the datasheet.
@@ -43,38 +34,8 @@ is 16 MHz.
 Supported Features
 ==================
 
-The nrf51dongle/nrf51822 board configuration supports the following nRF51
+.. zephyr:board-supported-hw::
-hardware features:
 
-+-----------+------------+----------------------+
-| Interface | Controller | Driver/Component     |
-+===========+============+======================+
-| ADC       | on-chip    | adc                  |
-+-----------+------------+----------------------+
-| CLOCK     | on-chip    | clock_control        |
-+-----------+------------+----------------------+
-| FLASH     | on-chip    | flash                |
-+-----------+------------+----------------------+
-| GPIO      | on-chip    | gpio                 |
-+-----------+------------+----------------------+
-| I2C(M)    | on-chip    | i2c                  |
-+-----------+------------+----------------------+
-| NVIC      | on-chip    | arch/arm             |
-+-----------+------------+----------------------+
-| RADIO     | on-chip    | Bluetooth            |
-+-----------+------------+----------------------+
-| RTC       | on-chip    | system clock         |
-+-----------+------------+----------------------+
-| RTT       | Segger     | console              |
-+-----------+------------+----------------------+
-| SPI(M/S)  | on-chip    | spi                  |
-+-----------+------------+----------------------+
-| UART      | on-chip    | serial               |
-+-----------+------------+----------------------+
-| WDT       | on-chip    | watchdog             |
-+-----------+------------+----------------------+
-
-Other hardware features have not been enabled yet for this board.
 See `nRF51 Dongle website`_ and `Nordic Semiconductor TechDocs`_
 for a complete list of nRF51 Dongle hardware features.
 

boards/nordic/nrf52833dk/doc/index.rst

@@ -1,7 +1,4 @@
-.. _nrf52833dk_nrf52833:
+.. zephyr:board:: nrf52833dk
-
-nRF52833 DK
-###########
 
 Overview
 ********
@@ -41,45 +38,8 @@ is 32 MHz.
 Supported Features
 ==================
 
-The ``nrf52833dk/nrf52833`` board configuration supports the following
+.. zephyr:board-supported-hw::
-hardware features:
 
-+-----------+------------+----------------------+
-| Interface | Controller | Driver/Component     |
-+===========+============+======================+
-| ADC       | on-chip    | adc                  |
-+-----------+------------+----------------------+
-| CLOCK     | on-chip    | clock_control        |
-+-----------+------------+----------------------+
-| FLASH     | on-chip    | flash                |
-+-----------+------------+----------------------+
-| GPIO      | on-chip    | gpio                 |
-+-----------+------------+----------------------+
-| I2C(M)    | on-chip    | i2c                  |
-+-----------+------------+----------------------+
-| MPU       | on-chip    | arch/arm             |
-+-----------+------------+----------------------+
-| NVIC      | on-chip    | arch/arm             |
-+-----------+------------+----------------------+
-| PWM       | on-chip    | pwm                  |
-+-----------+------------+----------------------+
-| RADIO     | on-chip    | Bluetooth,           |
-|           |            | ieee802154           |
-+-----------+------------+----------------------+
-| RTC       | on-chip    | system clock         |
-+-----------+------------+----------------------+
-| RTT       | Segger     | console              |
-+-----------+------------+----------------------+
-| SPI(M/S)  | on-chip    | spi                  |
-+-----------+------------+----------------------+
-| UART      | on-chip    | serial               |
-+-----------+------------+----------------------+
-| USB       | on-chip    | usb                  |
-+-----------+------------+----------------------+
-| WDT       | on-chip    | watchdog             |
-+-----------+------------+----------------------+
-
-Other hardware features have not been enabled yet for this board.
 See `nRF52833 DK website`_ and `nRF52833 DK Hardware guide`_
 for a complete list of nRF52833 Development Kit board hardware features.
 
@@ -206,6 +166,17 @@ In the table 7.1.1 'aQFN73 ball assignments' select the pins marked
 'General purpose I/O'.  Note that pins marked as 'low frequency I/O only' can only be used
 in under-10KHz applications. They are not suitable for 115200 speed of UART.
 
+nRF52820 emulation on nRF52833 DK
+*********************************
+
+The ``nrf52833dk/nrf52820`` board variant is a modified version of the
+:zephyr:board:`nrf52833dk` that enforces the limitations imposed by the nRF52820
+IC, which is a variant of the original nRF52833. Since Nordic does not offer a
+development kit for the nRF52820 you can use this board to develop for this IC
+while using the nRF52833 Development Kit (PCA10100).
+
+See `nRF52820 website`_ for the official reference on the IC itself.
+
 References
 **********
 
@@ -215,27 +186,4 @@ References
 .. _nRF52833 Product Specification: https://docs.nordicsemi.com/bundle/ps_nrf52833/page/keyfeatures_html5.html
 .. _J-Link Software and documentation pack: https://www.segger.com/jlink-software.html
 .. _nRF52833 DK Hardware guide: https://docs.nordicsemi.com/bundle/ug_nrf52833_dk/page/UG/dk/intro.html
-
-.. _nrf52833dk_nrf52820:
-
-nRF52820 emulation on nRF52833 DK
-#################################
-
-Overview
-********
-
-The ``nrf52833dk/nrf52820`` board is a modified version of the
-:ref:`nrf52833dk_nrf52833` that enforces the limitations imposed by the nRF52820
-IC, which is a variant of the original nRF52833. Since Nordic does not offer a
-development kit for the nRF52820 you can use this board to develop for this IC
-while using the nRF52833 Development Kit (PCA10100).
-
-See :ref:`nrf52833dk_nrf52833` for more information about the development board
-and `nRF52820 website`_ for the official reference on the IC itself.
-
-References
-**********
-
-.. target-notes::
-
 .. _nRF52820 website: https://www.nordicsemi.com/Products/Low-power-short-range-wireless/nRF52820

boards/nordic/nrf52840dk/doc/index.rst

@@ -1,7 +1,4 @@
-.. _nrf52840dk_nrf52840:
+.. zephyr:board:: nrf52840dk
-
-nRF52840 DK
-###########
 
 Overview
 ********
@@ -25,12 +22,6 @@ Nordic Semiconductor nRF52840 ARM Cortex-M4F CPU and the following devices:
 * :abbr:`USB (Universal Serial Bus)`
 * :abbr:`WDT (Watchdog Timer)`
 
-.. figure:: img/nrf52840dk_nrf52840.jpg
-     :align: center
-     :alt: nRF52840 DK
-
-     nRF52840 DK (Credit: Nordic Semiconductor)
-
 More information about the board can be found at the `nRF52840 DK website`_.
 `nRF52840 Product Specification`_ contains the processor's information
 and the datasheet.
@@ -45,45 +36,8 @@ is 32.768 kHz. The frequency of the main clock is 32 MHz.
 Supported Features
 ==================
 
-The ``nrf52840dk/nrf52840`` board configuration supports the following
+.. zephyr:board-supported-hw::
-hardware features:
 
-+-----------+------------+----------------------+
-| Interface | Controller | Driver/Component     |
-+===========+============+======================+
-| ADC       | on-chip    | adc                  |
-+-----------+------------+----------------------+
-| CLOCK     | on-chip    | clock_control        |
-+-----------+------------+----------------------+
-| FLASH     | on-chip    | flash                |
-+-----------+------------+----------------------+
-| GPIO      | on-chip    | gpio                 |
-+-----------+------------+----------------------+
-| I2C(M)    | on-chip    | i2c                  |
-+-----------+------------+----------------------+
-| MPU       | on-chip    | arch/arm             |
-+-----------+------------+----------------------+
-| NVIC      | on-chip    | arch/arm             |
-+-----------+------------+----------------------+
-| PWM       | on-chip    | pwm                  |
-+-----------+------------+----------------------+
-| RADIO     | on-chip    | Bluetooth,           |
-|           |            | ieee802154           |
-+-----------+------------+----------------------+
-| RTC       | on-chip    | system clock         |
-+-----------+------------+----------------------+
-| RTT       | Segger     | console              |
-+-----------+------------+----------------------+
-| SPI(M/S)  | on-chip    | spi                  |
-+-----------+------------+----------------------+
-| UART      | on-chip    | serial               |
-+-----------+------------+----------------------+
-| USB       | on-chip    | usb                  |
-+-----------+------------+----------------------+
-| WDT       | on-chip    | watchdog             |
-+-----------+------------+----------------------+
-
-Other hardware features have not been enabled yet for this board.
 See `nRF52840 DK website`_ and `nRF52840 DK Hardware guide`_
 for a complete list of nRF52840 Development Kit board hardware features.
 
@@ -216,27 +170,15 @@ in under-10KHz applications. They are not suitable for 115200 speed of UART.
 .. _nrf52840dk_nrf52811:
 
 nRF52811 emulation on nRF52840 DK
-#################################
+*********************************
-
-Overview
-********
 
 The ``nrf52840dk/nrf52811`` board variant is a modified version of the
-:ref:`nrf52840dk_nrf52840` that enforces the limitations imposed by the nRF52811
+:zephyr:board:`nrf52840dk` that enforces the limitations imposed by the nRF52811
 IC, which is a variant of the original nRF52840. Since Nordic does not offer a
 development kit for the nRF52811 you can use this board to develop for this IC
 while using the nRF52840 Development Kit (PCA10056).
 
-See :ref:`nrf52840dk_nrf52840` for more information about the development board
+See `nRF52811 website`_ for the official reference on the IC itself.
-and `nRF52811 website`_ for the official reference on the IC itself.
-
-
-References
-**********
-
-.. target-notes::
-
-.. _nRF52811 website: https://www.nordicsemi.com/Products/Low-power-short-range-wireless/nRF52811
 
 References
 **********

boards/nordic/nrf52840dongle/doc/index.rst

@@ -1,7 +1,4 @@
-.. _nrf52840dongle_nrf52840:
+.. zephyr:board:: nrf52840dongle
-
-nRF52840 Dongle
-###############
 
 Overview
 ********
@@ -24,12 +21,6 @@ Semiconductor nRF52840 ARM Cortex-M4F CPU and the following devices:
 * :abbr:`USB (Universal Serial Bus)`
 * :abbr:`WDT (Watchdog Timer)`
 
-.. figure:: img/nrf52840dongle_nrf52840.jpg
-     :align: center
-     :alt: nRF52840 Dongle
-
-     nRF52840 Dongle
-
 More information about the board can be found at the
 `nRF52840 Dongle website`_. The `nRF52840 Dongle guide`_
 contains the processor's information and the datasheet.
@@ -45,43 +36,8 @@ is 32 MHz.
 Supported Features
 ==================
 
-The ``nrf52840dongle/nrf52840`` board configuration supports the following
+.. zephyr:board-supported-hw::
-hardware features:
 
-+-----------+------------+----------------------+
-| Interface | Controller | Driver/Component     |
-+===========+============+======================+
-| ADC       | on-chip    | adc                  |
-+-----------+------------+----------------------+
-| CLOCK     | on-chip    | clock_control        |
-+-----------+------------+----------------------+
-| FLASH     | on-chip    | flash                |
-+-----------+------------+----------------------+
-| GPIO      | on-chip    | gpio                 |
-+-----------+------------+----------------------+
-| I2C(M)    | on-chip    | i2c                  |
-+-----------+------------+----------------------+
-| MPU       | on-chip    | arch/arm             |
-+-----------+------------+----------------------+
-| NVIC      | on-chip    | arch/arm             |
-+-----------+------------+----------------------+
-| PWM       | on-chip    | pwm                  |
-+-----------+------------+----------------------+
-| RADIO     | on-chip    | Bluetooth,           |
-|           |            | ieee802154           |
-+-----------+------------+----------------------+
-| RTC       | on-chip    | system clock         |
-+-----------+------------+----------------------+
-| SPI(M/S)  | on-chip    | spi                  |
-+-----------+------------+----------------------+
-| UART      | on-chip    | serial               |
-+-----------+------------+----------------------+
-| USB       | on-chip    | usb                  |
-+-----------+------------+----------------------+
-| WDT       | on-chip    | watchdog             |
-+-----------+------------+----------------------+
-
-Other hardware features have not been enabled yet for this board.
 See `nRF52840 Dongle website`_ and `nRF52840 Dongle Hardware description`_
 for a complete list of nRF52840 Dongle board hardware features.
 

boards/nordic/nrf52dk/doc/index.rst

@@ -1,7 +1,4 @@
-.. _nrf52dk_nrf52832:
+.. zephyr:board:: nrf52dk
-
-nRF52 DK
-########
 
 Overview
 ********
@@ -25,12 +22,6 @@ the following devices:
 * :abbr:`UART (Universal asynchronous receiver-transmitter)`
 * :abbr:`WDT (Watchdog Timer)`
 
-.. figure:: img/nrf52dk_nrf52832.jpg
-     :align: center
-     :alt: nRF52 DK
-
-     nRF52 DK (Credit: Nordic Semiconductor)
-
 More information about the board can be found at the
 `nRF52 DK website`_. `nRF52832 Product Specification`_
 contains the processor's information and the datasheet.
@@ -46,42 +37,8 @@ is 32 MHz.
 Supported Features
 ==================
 
-The ``nrf52dk/nrf52832`` board configuration supports the following
+.. zephyr:board-supported-hw::
-hardware features:
 
-+-----------+------------+----------------------+
-| Interface | Controller | Driver/Component     |
-+===========+============+======================+
-| ADC       | on-chip    | adc                  |
-+-----------+------------+----------------------+
-| CLOCK     | on-chip    | clock_control        |
-+-----------+------------+----------------------+
-| FLASH     | on-chip    | flash                |
-+-----------+------------+----------------------+
-| GPIO      | on-chip    | gpio                 |
-+-----------+------------+----------------------+
-| I2C(M)    | on-chip    | i2c                  |
-+-----------+------------+----------------------+
-| MPU       | on-chip    | arch/arm             |
-+-----------+------------+----------------------+
-| NVIC      | on-chip    | arch/arm             |
-+-----------+------------+----------------------+
-| PWM       | on-chip    | pwm                  |
-+-----------+------------+----------------------+
-| RADIO     | on-chip    | Bluetooth            |
-+-----------+------------+----------------------+
-| RTC       | on-chip    | system clock         |
-+-----------+------------+----------------------+
-| RTT       | Segger     | console              |
-+-----------+------------+----------------------+
-| SPI(M/S)  | on-chip    | spi                  |
-+-----------+------------+----------------------+
-| UART      | on-chip    | serial               |
-+-----------+------------+----------------------+
-| WDT       | on-chip    | watchdog             |
-+-----------+------------+----------------------+
-
-Other hardware features have not been enabled yet for this board.
 See `nRF52 DK website`_ and `nRF52832 Product Specification`_
 for a complete list of nRF52 Development Kit board hardware features.
 
@@ -397,6 +354,32 @@ You can build and flash the examples to make sure Zephyr is running correctly on
 your board. The button and LED definitions can be found in
 :zephyr_file:`boards/nordic/nrf52dk/nrf52dk_nrf52832.dts`.
 
+.. _nrf52dk_nrf52805:
+
+nRF52805 emulation on nRF52 DK
+******************************
+
+The ``nrf52dk/nrf52805`` board is a modified version of the :zephyr:board:`nrf52dk`
+that enforces the limitations imposed by the nRF52805 IC, which is a
+cost-reduced variant of the original nRF52832. Since Nordic does not offer a
+development kit for the nRF52805, you can use this board to develop for this
+IC while using the nRF52 Development Kit (PCA10040).
+
+See `nRF52805 website`_ for the official reference on the IC itself.
+
+.. _nrf52dk_nrf52810:
+
+nRF52810 emulation on nRF52 DK
+******************************
+
+The ``nrf52dk/nrf52810`` board variant is a modified version of the :zephyr:board:`nrf52dk`
+that enforces the limitations imposed by the nRF52810 IC, which is a
+cost-reduced variant of the original nRF52832. Since Nordic does not offer a
+development kit for the nRF52810 you can use this board to develop for this
+IC while using the nRF52 Development Kit (PCA10040).
+
+See `nRF52810 website`_ for the official reference on the IC itself.
+
 References
 **********
 
@@ -404,52 +387,5 @@ References
 
 .. _nRF52 DK website: https://www.nordicsemi.com/Software-and-Tools/Development-Kits/nRF52-DK
 .. _nRF52832 Product Specification: https://docs.nordicsemi.com/bundle/ps_nrf52832/page/nrf52832_ps.html
-
-.. _nrf52dk_nrf52805:
-
-nRF52805 emulation on nRF52 DK
-##############################
-
-Overview
-********
-
-The ``nrf52dk/nrf52805`` board is a modified version of the :ref:`nrf52dk_nrf52832`
-that enforces the limitations imposed by the nRF52805 IC, which is a
-cost-reduced variant of the original nRF52832. Since Nordic does not offer a
-development kit for the nRF52805, you can use this board to develop for this
-IC while using the nRF52 Development Kit (PCA10040).
-
-See :ref:`nrf52dk_nrf52832` for more information about the development board and
-`nRF52805 website`_ for the official reference on the IC itself.
-
-References
-**********
-
-.. target-notes::
-
 .. _nRF52805 website: https://www.nordicsemi.com/Products/Low-power-short-range-wireless/nRF52805
-
-.. _nrf52dk_nrf52810:
-
-nRF52810 emulation on nRF52 DK
-##############################
-
-Overview
-********
-
-The ``nrf52dk/nrf52810`` board is a modified version of the :ref:`nrf52dk_nrf52832`
-that enforces the limitations imposed by the nRF52810 IC, which is a
-cost-reduced variant of the original nRF52832. Since Nordic does not offer a
-development kit for the nRF52810 you can use this board to develop for this
-IC while using the nRF52 Development Kit (PCA10040).
-
-See :ref:`nrf52dk_nrf52832` for more information about the development board and
-`nRF52810 website`_ for the official reference on the IC itself.
-
-
-References
-**********
-
-.. target-notes::
-
 .. _nRF52810 website: https://www.nordicsemi.com/Products/Low-power-short-range-wireless/nRF52810

boards/nordic/nrf5340_audio_dk/doc/index.rst

@@ -1,7 +1,4 @@
-.. _nrf5340_audio_dk_nrf5340:
+.. zephyr:board:: nrf5340_audio_dk
-
-nRF5340 Audio DK
-################
 
 Overview
 ********
@@ -31,10 +28,6 @@ The nRF5340 Audio DK comes with the following hardware features:
 * Stereo analog input using 3.5 mm jack
 * USB soundcard capability
 
-.. figure:: img/nrf5340_audio_dk.jpg
-     :align: center
-     :alt: nRF5340 DK
-
 More information about the board can be found at the `nRF5340 Audio DK website`_. The `nRF5340 Audio DK hardware guide`_
 contains the processor's information and the datasheet.
 
@@ -59,7 +52,9 @@ the datasheet.
 Supported Features
 ==================
 
-See :ref:`nrf5340dk_nrf5340` and `nRF5340 Audio DK hardware guide`_
+.. zephyr:board-supported-hw::
+
+See :zephyr:board:`nrf5340dk` and `nRF5340 Audio DK hardware guide`_
 for a complete list of nRF5340 Audio DK board hardware features.
 
 

boards/nordic/nrf5340dk/doc/index.rst

@@ -1,7 +1,4 @@
-.. _nrf5340dk_nrf5340:
+.. zephyr:board:: nrf5340dk
-
-nRF5340 DK
-##########
 
 Overview
 ********
@@ -40,12 +37,6 @@ nRF5340 SoC provides support for the following devices:
 * :abbr:`USB (Universal Serial Bus)`
 * :abbr:`WDT (Watchdog Timer)`
 
-.. figure:: img/nrf5340dk.jpg
-     :align: center
-     :alt: nRF5340 DK
-
-     nRF5340 DK (Credit: Nordic Semiconductor)
-
 More information about the board can be found at the
 `nRF5340 DK website`_.
 The `nRF5340 DK Product Specification`_
@@ -62,76 +53,8 @@ is 32 MHz.
 Supported Features
 ==================
 
-The ``nrf5340dk/nrf5340/cpuapp`` board configuration supports the following
+.. zephyr:board-supported-hw::
-hardware features:
 
-+-----------+------------+----------------------+
-| Interface | Controller | Driver/Component     |
-+===========+============+======================+
-| ADC       | on-chip    | adc                  |
-+-----------+------------+----------------------+
-| CLOCK     | on-chip    | clock_control        |
-+-----------+------------+----------------------+
-| FLASH     | on-chip    | flash                |
-+-----------+------------+----------------------+
-| GPIO      | on-chip    | gpio                 |
-+-----------+------------+----------------------+
-| I2C(M)    | on-chip    | i2c                  |
-+-----------+------------+----------------------+
-| MPU       | on-chip    | arch/arm             |
-+-----------+------------+----------------------+
-| NVIC      | on-chip    | arch/arm             |
-+-----------+------------+----------------------+
-| PWM       | on-chip    | pwm                  |
-+-----------+------------+----------------------+
-| RTC       | on-chip    | system clock         |
-+-----------+------------+----------------------+
-| RTT       | Segger     | console              |
-+-----------+------------+----------------------+
-| SPI(M/S)  | on-chip    | spi                  |
-+-----------+------------+----------------------+
-| SPU       | on-chip    | system protection    |
-+-----------+------------+----------------------+
-| UARTE     | on-chip    | serial               |
-+-----------+------------+----------------------+
-| USB       | on-chip    | usb                  |
-+-----------+------------+----------------------+
-| WDT       | on-chip    | watchdog             |
-+-----------+------------+----------------------+
-
-The ``nrf5340dk/nrf5340/cpunet`` board configuration supports the following
-hardware features:
-
-+-----------+------------+----------------------+
-| Interface | Controller | Driver/Component     |
-+===========+============+======================+
-| CLOCK     | on-chip    | clock_control        |
-+-----------+------------+----------------------+
-| FLASH     | on-chip    | flash                |
-+-----------+------------+----------------------+
-| GPIO      | on-chip    | gpio                 |
-+-----------+------------+----------------------+
-| I2C(M)    | on-chip    | i2c                  |
-+-----------+------------+----------------------+
-| MPU       | on-chip    | arch/arm             |
-+-----------+------------+----------------------+
-| NVIC      | on-chip    | arch/arm             |
-+-----------+------------+----------------------+
-| RADIO     | on-chip    | Bluetooth,           |
-|           |            | ieee802154           |
-+-----------+------------+----------------------+
-| RTC       | on-chip    | system clock         |
-+-----------+------------+----------------------+
-| RTT       | Segger     | console              |
-+-----------+------------+----------------------+
-| SPI(M/S)  | on-chip    | spi                  |
-+-----------+------------+----------------------+
-| UARTE     | on-chip    | serial               |
-+-----------+------------+----------------------+
-| WDT       | on-chip    | watchdog             |
-+-----------+------------+----------------------+
-
-Other hardware features have not been enabled yet for this board.
 See `nRF5340 DK Product Specification`_
 for a complete list of nRF5340 DK board hardware features.
 

boards/nordic/nrf54h20dk/doc/index.rst

@@ -1,7 +1,4 @@
-.. _nrf54h20dk_nrf54h20:
+.. zephyr:board:: nrf54h20dk
-
-nRF54H20 DK
-###########
 
 Overview
 ********
@@ -59,49 +56,7 @@ nRF54H20 DK has two crystal oscillators:
 Supported Features
 ==================
 
-The ``nrf54h20dk/nrf54h20/cpuapp`` board configuration supports the following
+.. zephyr:board-supported-hw::
-hardware features:
-
-+-----------+------------+----------------------+
-| Interface | Controller | Driver/Component     |
-+===========+============+======================+
-| GPIO      | on-chip    | gpio                 |
-+-----------+------------+----------------------+
-| GRTC      | on-chip    | system clock         |
-+-----------+------------+----------------------+
-| I2C(M)    | on-chip    | i2c                  |
-+-----------+------------+----------------------+
-| MEMCONF   | on-chip    | retained_mem         |
-+-----------+------------+----------------------+
-| SPI(M/S)  | on-chip    | spi                  |
-+-----------+------------+----------------------+
-| UART      | on-chip    | serial               |
-+-----------+------------+----------------------+
-| WDT       | on-chip    | watchdog             |
-+-----------+------------+----------------------+
-
-The ``nrf54h20dk/nrf54h20/cpurad`` board configuration supports the following
-hardware features:
-
-+-----------+------------+----------------------+
-| Interface | Controller | Driver/Component     |
-+===========+============+======================+
-| GPIO      | on-chip    | gpio                 |
-+-----------+------------+----------------------+
-| GRTC      | on-chip    | system clock         |
-+-----------+------------+----------------------+
-| I2C(M)    | on-chip    | i2c                  |
-+-----------+------------+----------------------+
-| MEMCONF   | on-chip    | retained_mem         |
-+-----------+------------+----------------------+
-| SPI(M/S)  | on-chip    | spi                  |
-+-----------+------------+----------------------+
-| UART      | on-chip    | serial               |
-+-----------+------------+----------------------+
-| WDT       | on-chip    | watchdog             |
-+-----------+------------+----------------------+
-
-Other hardware features have not been enabled yet for this board.
 
 Connections and IOs
 ===================

boards/nordic/nrf54l09pdk/doc/index.rst

@@ -1,8 +1,5 @@
 .. zephyr:board:: nrf54l09pdk
 
-nRF54L09 PDK
-############
-
 Overview
 ********
 
@@ -36,25 +33,7 @@ internal or external capacitors.
 Supported Features
 ==================
 
-The ``nrf54l09pdk/nrf54l09/cpuapp`` board target supports the following hardware features:
+.. zephyr:board-supported-hw::
-
-+-----------+------------+----------------------+
-| Interface | Controller | Driver/Component     |
-+===========+============+======================+
-| CLOCK     | on-chip    | clock_control        |
-+-----------+------------+----------------------+
-| RRAM      | on-chip    | flash                |
-+-----------+------------+----------------------+
-| GPIO      | on-chip    | gpio                 |
-+-----------+------------+----------------------+
-| GRTC      | on-chip    | system clock         |
-+-----------+------------+----------------------+
-| NVIC      | on-chip    | arch/arm             |
-+-----------+------------+----------------------+
-| UARTE     | on-chip    | serial               |
-+-----------+------------+----------------------+
-
-Other hardware features have not been enabled yet for this board.
 
 Programming and Debugging
 *************************

boards/nordic/nrf54l15dk/doc/index.rst

@@ -1,7 +1,4 @@
-.. _nrf54l15dk_nrf54l15:
+.. zephyr:board:: nrf54l15dk
-
-nRF54L15 DK
-############
 
 Overview
 ********
@@ -29,12 +26,6 @@ nRF54L15 Arm Cortex-M33 CPU and the following devices:
 * :abbr:`UARTE (Universal asynchronous receiver-transmitter)`
 * :abbr:`WDT (Watchdog Timer)`
 
-.. figure:: img/nrf54l15dk_nrf54l15.webp
-     :align: center
-     :alt: nRF54L15 DK
-
-     nRF54L15 DK (Credit: Nordic Semiconductor)
-
 Hardware
 ********
 
@@ -49,44 +40,7 @@ internal or external capacitors.
 Supported Features
 ==================
 
-The ``nrf54l15dk/nrf54l15/cpuapp`` board target configuration supports the following
+.. zephyr:board-supported-hw::
-hardware features:
-
-+-----------+------------+----------------------+
-| Interface | Controller | Driver/Component     |
-+===========+============+======================+
-| CLOCK     | on-chip    | clock_control        |
-+-----------+------------+----------------------+
-| GPIO      | on-chip    | gpio                 |
-+-----------+------------+----------------------+
-| GRTC      | on-chip    | counter              |
-+-----------+------------+----------------------+
-| MEMCONF   | on-chip    | retained_mem         |
-+-----------+------------+----------------------+
-| MPU       | on-chip    | arch/arm             |
-+-----------+------------+----------------------+
-| NVIC      | on-chip    | arch/arm             |
-+-----------+------------+----------------------+
-| PWM       | on-chip    | pwm                  |
-+-----------+------------+----------------------+
-| RRAM      | on-chip    | flash                |
-+-----------+------------+----------------------+
-| RTT       | Segger     | console              |
-+-----------+------------+----------------------+
-| SAADC     | on-chip    | adc                  |
-+-----------+------------+----------------------+
-| SPI(M/S)  | on-chip    | spi                  |
-+-----------+------------+----------------------+
-| SPU       | on-chip    | system protection    |
-+-----------+------------+----------------------+
-| TWIM      | on-chip    | i2c                  |
-+-----------+------------+----------------------+
-| UARTE     | on-chip    | serial               |
-+-----------+------------+----------------------+
-| WDT       | on-chip    | watchdog             |
-+-----------+------------+----------------------+
-
-Other hardware features have not been enabled yet for this board.
 
 Programming and Debugging
 *************************
@@ -151,43 +105,39 @@ Testing the LEDs and buttons in the nRF54L15 DK
 Test the nRF54L15 DK with a :zephyr:code-sample:`blinky` sample.
 
 
-.. _nRF54L15 website: https://www.nordicsemi.com/Products/nRF54L15
-.. _nRF54L15 documentation: https://docs.nordicsemi.com/bundle/ncs-latest/page/nrf/app_dev/device_guides/nrf54l/index.html
-
 .. _nrf54l15dk_nrf54l05:
 
 nRF54L05 emulation on nRF54L15 DK
-#################################
+*********************************
 
-Overview
+The ``nrf54l15dk/nrf54l05`` board is a modified version of the :zephyr:board:`nrf54l15dk`
-********
-
-The ``nrf54l15dk/nrf54l05`` board is a modified version of the :ref:`nrf54l15dk_nrf54l15`
 that enforces the limitations imposed by the nRF54L05 IC, which is a
 cost-reduced variant of the original nRF54L15. Since Nordic does not offer a
 development kit for the nRF54L05, you can use this board to develop for this
 IC while using the nRF54L15 Development Kit (PCA10156).
 
-See :ref:`nrf54l15dk_nrf54l15` for more information about the development board and
+See `nRF54L05 website`_ for the official reference on the IC itself.
-`nRF54L05 website`_ for the official reference on the IC itself.
 
-.. _nRF54L05 website: https://www.nordicsemi.com/Products/nRF54L05
 
 .. _nrf54l15dk_nrf54l10:
 
 nRF54L10 emulation on nRF54L15 DK
-#################################
+*********************************
 
-Overview
+The ``nrf54l15dk/nrf54l10`` board is a modified version of the :zephyr:board:`nrf54l15dk`
-********
-
-The ``nrf54l15dk/nrf54l10`` board is a modified version of the :ref:`nrf54l15dk_nrf54l15`
 that enforces the limitations imposed by the nRF54L10 IC, which is a
 cost-reduced variant of the original nRF54L15. Since Nordic does not offer a
 development kit for the nRF54L10 you can use this board to develop for this
 IC while using the nRF54L15 Development Kit (PCA10156).
 
-See :ref:`nrf54l15dk_nrf54l15` for more information about the development board and
+See `nRF54L10 website`_ for the official reference on the IC itself.
-`nRF54L10 website`_ for the official reference on the IC itself.
 
+References
+**********
+
+.. target-notes::
+
+.. _nRF54L15 website: https://www.nordicsemi.com/Products/nRF54L15
+.. _nRF54L15 documentation: https://docs.nordicsemi.com/bundle/ncs-latest/page/nrf/app_dev/device_guides/nrf54l/index.html
+.. _nRF54L05 website: https://www.nordicsemi.com/Products/nRF54L05
 .. _nRF54L10 website: https://www.nordicsemi.com/Products/nRF54L10

boards/nordic/nrf54l20pdk/doc/index.rst

@@ -1,7 +1,4 @@
-.. _nrf54l20pdk_nrf54l20:
+.. zephyr:board:: nrf54l20pdk
-
-nRF54L20 PDK
-############
 
 Overview
 ********
@@ -36,26 +33,7 @@ internal or external capacitors.
 Supported Features
 ==================
 
-The ``nrf54l20pdk/nrf54l20/cpuapp`` board target configuration supports the following
+.. zephyr:board-supported-hw::
-hardware features:
-
-+-----------+------------+----------------------+
-| Interface | Controller | Driver/Component     |
-+===========+============+======================+
-| CLOCK     | on-chip    | clock_control        |
-+-----------+------------+----------------------+
-| RRAM      | on-chip    | flash                |
-+-----------+------------+----------------------+
-| GPIO      | on-chip    | gpio                 |
-+-----------+------------+----------------------+
-| GRTC      | on-chip    | system clock         |
-+-----------+------------+----------------------+
-| NVIC      | on-chip    | arch/arm             |
-+-----------+------------+----------------------+
-| UARTE     | on-chip    | serial               |
-+-----------+------------+----------------------+
-
-Other hardware features have not been enabled yet for this board.
 
 Programming and Debugging
 *************************

boards/nordic/nrf7002dk/doc/index.rst

@@ -1,7 +1,4 @@
-.. _nrf7002dk_nrf5340:
+.. zephyr:board:: nrf7002dk
-
-nRF7002 DK
-##########
 
 Overview
 ********
@@ -28,12 +25,6 @@ The ``nrf7002dk/nrf5340/cpuapp`` board target provides support for the applicati
 nRF5340 SoC. The ``nrf7002dk/nrf5340/cpunet`` board target provides support for the network
 core on the nRF5340 SoC.
 
-.. figure:: img/nrf7002dk.jpg
-   :align: center
-   :alt: nRF7002 DK
-
-   nRF7002 DK (Credit: Nordic Semiconductor)
-
 More information about the board can be found at the
 `nRF7002 DK website`_.
 The `nRF7002 DK Product Specification`_
@@ -53,78 +44,8 @@ Hardware
 Supported features
 ------------------
 
-The ``nrf7002dk/nrf5340/cpuapp`` board configuration supports the following hardware features:
+.. zephyr:board-supported-hw::
 
-+-----------+------------+----------------------+
-| Interface | Controller | Driver/Component     |
-+===========+============+======================+
-| ADC       | on-chip    | adc                  |
-+-----------+------------+----------------------+
-| CLOCK     | on-chip    | clock_control        |
-+-----------+------------+----------------------+
-| FLASH     | on-chip    | flash                |
-+-----------+------------+----------------------+
-| GPIO      | on-chip    | gpio                 |
-+-----------+------------+----------------------+
-| I2C(M)    | on-chip    | i2c                  |
-+-----------+------------+----------------------+
-| MPU       | on-chip    | arch/arm             |
-+-----------+------------+----------------------+
-| NVIC      | on-chip    | arch/arm             |
-+-----------+------------+----------------------+
-| PWM       | on-chip    | pwm                  |
-+-----------+------------+----------------------+
-| RTC       | on-chip    | system clock         |
-+-----------+------------+----------------------+
-| RTT       | Segger     | console              |
-+-----------+------------+----------------------+
-| RADIO     | nrf7002    | Wi-Fi 6 (802.11ax)   |
-+-----------+------------+----------------------+
-| QSPI      | on-chip    | qspi                 |
-+-----------+------------+----------------------+
-| SPI(M/S)  | on-chip    | spi                  |
-+-----------+------------+----------------------+
-| SPU       | on-chip    | system protection    |
-+-----------+------------+----------------------+
-| UARTE     | on-chip    | serial               |
-+-----------+------------+----------------------+
-| USB       | on-chip    | usb                  |
-+-----------+------------+----------------------+
-| WDT       | on-chip    | watchdog             |
-+-----------+------------+----------------------+
-
-The ``nrf7002dk/nrf5340/cpunet`` board configuration supports the following hardware features:
-
-+-----------+------------+----------------------+
-| Interface | Controller | Driver/Component     |
-+===========+============+======================+
-| CLOCK     | on-chip    | clock_control        |
-+-----------+------------+----------------------+
-| FLASH     | on-chip    | flash                |
-+-----------+------------+----------------------+
-| GPIO      | on-chip    | gpio                 |
-+-----------+------------+----------------------+
-| I2C(M)    | on-chip    | i2c                  |
-+-----------+------------+----------------------+
-| MPU       | on-chip    | arch/arm             |
-+-----------+------------+----------------------+
-| NVIC      | on-chip    | arch/arm             |
-+-----------+------------+----------------------+
-| RADIO     | on-chip    | Bluetooth,           |
-|           |            | ieee802154           |
-+-----------+------------+----------------------+
-| RTC       | on-chip    | system clock         |
-+-----------+------------+----------------------+
-| RTT       | Segger     | console              |
-+-----------+------------+----------------------+
-| SPI(M/S)  | on-chip    | spi                  |
-+-----------+------------+----------------------+
-| UARTE     | on-chip    | serial               |
-+-----------+------------+----------------------+
-| WDT       | on-chip    | watchdog             |
-+-----------+------------+----------------------+
-
-Other hardware features have not been enabled yet for this board.
 See `nRF7002 DK Product Specification`_
 for a complete list of nRF7002 DK board hardware features.
 

boards/nordic/nrf9131ek/doc/index.rst

@@ -1,7 +1,4 @@
-.. _nrf9131ek_nrf9131:
+.. zephyr:board:: nrf9131ek
-
-nRF9131 EK
-##########
 
 Overview
 ********
@@ -26,12 +23,6 @@ Cortex-M33F CPU with ARMv8-M Security Extension and the following devices:
 * :abbr:`WDT (Watchdog Timer)`
 * :abbr:`IDAU (Implementation Defined Attribution Unit)`
 
-.. figure:: img/nrf9131ek_nrf9131.webp
-     :align: center
-     :alt: nRF9131 EK
-
-     nRF9131 EK (Credit: Nordic Semiconductor)
-
 The `Nordic Semiconductor TechDocs`_ will soon
 contain the processor's information and the datasheet.
 
@@ -46,40 +37,7 @@ is 32 MHz.
 Supported Features
 ==================
 
-The ``nrf9131ek/nrf9131`` board configuration supports the following
+.. zephyr:board-supported-hw::
-hardware features:
-
-+-----------+------------+----------------------+
-| Interface | Controller | Driver/Component     |
-+===========+============+======================+
-| ADC       | on-chip    | adc                  |
-+-----------+------------+----------------------+
-| CLOCK     | on-chip    | clock_control        |
-+-----------+------------+----------------------+
-| FLASH     | on-chip    | flash                |
-+-----------+------------+----------------------+
-| GPIO      | on-chip    | gpio                 |
-+-----------+------------+----------------------+
-| I2C(M)    | on-chip    | i2c                  |
-+-----------+------------+----------------------+
-| MPU       | on-chip    | arch/arm             |
-+-----------+------------+----------------------+
-| NVIC      | on-chip    | arch/arm             |
-+-----------+------------+----------------------+
-| PWM       | on-chip    | pwm                  |
-+-----------+------------+----------------------+
-| RTC       | on-chip    | system clock         |
-+-----------+------------+----------------------+
-| RTT       | Segger     | console              |
-+-----------+------------+----------------------+
-| SPI(M/S)  | on-chip    | spi                  |
-+-----------+------------+----------------------+
-| SPU       | on-chip    | system protection    |
-+-----------+------------+----------------------+
-| UARTE     | on-chip    | serial               |
-+-----------+------------+----------------------+
-| WDT       | on-chip    | watchdog             |
-+-----------+------------+----------------------+
 
 Connections and IOs
 ===================

boards/nordic/nrf9151dk/doc/index.rst

@@ -1,7 +1,4 @@
-.. _nrf9151dk_nrf9151:
+.. zephyr:board:: nrf9151dk
-
-nRF9151 DK
-##########
 
 Overview
 ********
@@ -39,50 +36,7 @@ is 32 MHz.
 Supported Features
 ==================
 
-The ``nrf9151dk/nrf9151`` board configuration supports the following
+.. zephyr:board-supported-hw::
-hardware features:
-
-+-----------+------------+----------------------+
-| Interface | Controller | Driver/Component     |
-+===========+============+======================+
-| ADC       | on-chip    | adc                  |
-+-----------+------------+----------------------+
-| CLOCK     | on-chip    | clock_control        |
-+-----------+------------+----------------------+
-| FLASH     | on-chip    | flash                |
-+-----------+------------+----------------------+
-| FLASH     | external   | spi                  |
-+-----------+------------+----------------------+
-| GPIO      | on-chip    | gpio                 |
-+-----------+------------+----------------------+
-| GPIO      | external   | i2c                  |
-+-----------+------------+----------------------+
-| I2C(M)    | on-chip    | i2c                  |
-+-----------+------------+----------------------+
-| MPU       | on-chip    | arch/arm             |
-+-----------+------------+----------------------+
-| NVIC      | on-chip    | arch/arm             |
-+-----------+------------+----------------------+
-| PWM       | on-chip    | pwm                  |
-+-----------+------------+----------------------+
-| RTC       | on-chip    | system clock         |
-+-----------+------------+----------------------+
-| RTT       | nRF53      | console              |
-+-----------+------------+----------------------+
-| SPI(M/S)  | on-chip    | spi                  |
-+-----------+------------+----------------------+
-| SPU       | on-chip    | system protection    |
-+-----------+------------+----------------------+
-| UARTE     | on-chip    | serial               |
-+-----------+------------+----------------------+
-| WDT       | on-chip    | watchdog             |
-+-----------+------------+----------------------+
-
-
-.. _nrf9151dk_additional_hardware:
-
-Other hardware features have not been enabled yet for this board.
-See the `nRF9151 website`_ for more information.
 
 Connections and IOs
 ===================

boards/nordic/nrf9161dk/doc/index.rst

@@ -1,7 +1,4 @@
-.. _nrf9161dk_nrf9161:
+.. zephyr:board:: nrf9161dk
-
-nRF9161 DK
-##########
 
 Overview
 ********
@@ -41,49 +38,10 @@ is 32 MHz.
 Supported Features
 ==================
 
-The ``nrf9161dk/nrf9161`` board configuration supports the following
+.. zephyr:board-supported-hw::
-hardware features:
-
-+-----------+------------+----------------------+
-| Interface | Controller | Driver/Component     |
-+===========+============+======================+
-| ADC       | on-chip    | adc                  |
-+-----------+------------+----------------------+
-| CLOCK     | on-chip    | clock_control        |
-+-----------+------------+----------------------+
-| FLASH     | on-chip    | flash                |
-+-----------+------------+----------------------+
-| FLASH     | external   | spi                  |
-+-----------+------------+----------------------+
-| GPIO      | on-chip    | gpio                 |
-+-----------+------------+----------------------+
-| GPIO      | external   | i2c                  |
-+-----------+------------+----------------------+
-| I2C(M)    | on-chip    | i2c                  |
-+-----------+------------+----------------------+
-| MPU       | on-chip    | arch/arm             |
-+-----------+------------+----------------------+
-| NVIC      | on-chip    | arch/arm             |
-+-----------+------------+----------------------+
-| PWM       | on-chip    | pwm                  |
-+-----------+------------+----------------------+
-| RTC       | on-chip    | system clock         |
-+-----------+------------+----------------------+
-| RTT       | nRF53      | console              |
-+-----------+------------+----------------------+
-| SPI(M/S)  | on-chip    | spi                  |
-+-----------+------------+----------------------+
-| SPU       | on-chip    | system protection    |
-+-----------+------------+----------------------+
-| UARTE     | on-chip    | serial               |
-+-----------+------------+----------------------+
-| WDT       | on-chip    | watchdog             |
-+-----------+------------+----------------------+
-
 
 .. _nrf9161dk_additional_hardware:
 
-Other hardware features have not been enabled yet for this board.
 See `nRF9161 DK website`_ and `nRF9161 Product Specification`_
 for a complete list of nRF9161 DK board hardware features.
 

boards/nordic/thingy52/doc/index.rst

@@ -1,7 +1,4 @@
-.. _thingy52_nrf52832:
+.. zephyr:board:: thingy52
-
-Thingy:52
-#########
 
 .. warning::
 
@@ -34,12 +31,6 @@ processor, a set of environmental sensors, a pushbutton, and two RGB LEDs.
 * :abbr:`UART (Universal asynchronous receiver-transmitter)`
 * :abbr:`WDT (Watchdog Timer)`
 
-.. figure:: img/thingy52_nrf52832.jpg
-     :align: center
-     :alt: nRF52 Thingy:52
-
-     nRF52 Thingy:52 (Credit: Nordic Semiconductor)
-
 More information about the board can be found at the `nRF52 DK website`_. The
 `Nordic Thingy:52 guide`_ contains the processor's information and the
 datasheet.
@@ -61,46 +52,7 @@ Thingy:52 has the following features:
 Supported Features
 ==================
 
-+-----------+------------+----------------------+
+.. zephyr:board-supported-hw::
-| Interface | Controller | Driver/Component     |
-+===========+============+======================+
-| ADC       | on-chip    | adc                  |
-+-----------+------------+----------------------+
-| CLOCK     | on-chip    | clock_control        |
-+-----------+------------+----------------------+
-| FLASH     | on-chip    | flash                |
-+-----------+------------+----------------------+
-| Gas       | on-board   | ccs811               |
-| Sensor    |            |                      |
-+-----------+------------+----------------------+
-| GPIO      | on-chip    | gpio                 |
-+-----------+------------+----------------------+
-| GPIO Exp  | on-board   | sx1509b              |
-+-----------+------------+----------------------+
-| Humidity  | on-board   | hts221               |
-| and Temp  |            |                      |
-+-----------+------------+----------------------+
-| I2C(M)    | on-chip    | i2c                  |
-+-----------+------------+----------------------+
-| MPU       | on-chip    | arch/arm             |
-+-----------+------------+----------------------+
-| NVIC      | on-chip    | arch/arm             |
-+-----------+------------+----------------------+
-| Pressure  | on-board   | lps22hb_press        |
-| and Temp  |            |                      |
-+-----------+------------+----------------------+
-| PWM       | on-chip    | pwm                  |
-+-----------+------------+----------------------+
-| RADIO     | on-chip    | Bluetooth            |
-+-----------+------------+----------------------+
-| RTC       | on-chip    | system clock         |
-+-----------+------------+----------------------+
-| SPI(M/S)  | on-chip    | spi                  |
-+-----------+------------+----------------------+
-| UART      | on-chip    | serial               |
-+-----------+------------+----------------------+
-| WDT       | on-chip    | watchdog             |
-+-----------+------------+----------------------+
 
 Connections and IOs
 ===================
@@ -362,7 +314,7 @@ Thingy:52 does not have an on-board J-Link debug IC as some other nRF5
 development boards, however, instructions from the :ref:`nordic_segger` page
 also apply to this board, with the additional step of connecting an external
 debugger. A development board with a Debug out connector such as the
-:ref:`nrf52dk_nrf52832` can be used as a debugger with Thingy:52.
+:zephyr:board:`nrf52dk` can be used as a debugger with Thingy:52.
 
 Testing board features
 **********************

boards/nordic/thingy53/doc/index.rst

@@ -1,7 +1,4 @@
-.. _thingy53_nrf5340:
+.. zephyr:board:: thingy53
-
-Thingy:53
-#########
 
 Overview
 ********
@@ -25,6 +22,14 @@ support for the network core on the nRF5340 SoC.
 The `Nordic Thingy:53 Hardware guide`_ contains the processor's information and
 the datasheet.
 
+Hardware
+********
+
+Supported Features
+==================
+
+.. zephyr:board-supported-hw::
+
 Programming and Debugging
 *************************
 
@@ -41,7 +46,7 @@ Thingy:53 does not have an on-board J-Link debug IC as some other nRF5
 development boards, however, instructions from the :ref:`nordic_segger` page
 also apply to this board, with the additional step of connecting an external
 debugger. A development board with a Debug out connector such as the
-:ref:`nrf5340dk_nrf5340` can be used as a debugger with Thingy:53.
+:zephyr:board:`nrf5340dk` can be used as a debugger with Thingy:53.
 
 References
 **********

boards/panasonic/pan1770_evb/doc/index.rst

@@ -7,7 +7,7 @@ The PAN1770 Evaluation Board is a development tool for the PAN1770 module
 which is based on the nRF52840 chipset from Nordic Semiconductor.
 
 It is basically a clone of the official nRF52840 development kit (PCA10056)
-from Nordic Semiconductor. Please refer to :ref:`nrf52840dk_nrf52840` for
+from Nordic Semiconductor. Please refer to :zephyr:board:`nrf52840dk` for
 further information.
 
 You can find more information about the PAN1770 module and the PAN1770

boards/panasonic/pan1780_evb/doc/index.rst

@@ -7,7 +7,7 @@ The PAN1780 Evaluation Board is a development tool for the PAN1780 module which
 is based on the nRF52840 chipset from Nordic Semiconductor.
 
 It is basically a clone of the official nRF52840 development kit (PCA10056)
-from Nordic Semiconductor. Please refer to :ref:`nrf52840dk_nrf52840` for
+from Nordic Semiconductor. Please refer to :zephyr:board:`nrf52840dk` for
 further information.
 
 You can find more information about the PAN1780 module and the PAN1780

boards/panasonic/pan1781_evb/doc/index.rst

@@ -9,7 +9,7 @@ which is based on the nRF52820 chipset from Nordic Semiconductor.
 You can find more information about the PAN1781 module and the PAN1781
 evaluation board on the `product website`_.
 
-Please also refer to :ref:`nrf52833dk_nrf52820` for general information about
+Please also refer to :zephyr:board:`nrf52833dk` for general information about
 development kits for the nRF52820 from Nordic Semiconductor.
 
 The PAN1781 evaluation board is closely linked to these other evaluation

boards/panasonic/pan1782_evb/doc/index.rst

@@ -9,7 +9,7 @@ which is based on the nRF52833 chipset from Nordic Semiconductor.
 You can find more information about the PAN1782 module and the PAN1782
 evaluation board on the `product website`_.
 
-Please also refer to :ref:`nrf52833dk_nrf52833` for general information about
+Please also refer to :zephyr:board:`nrf52833dk` for general information about
 development kits for the nRF52833 from Nordic Semiconductor.
 
 The PAN1782 evaluation board is closely linked to these other evaluation

doc/build/sysbuild/index.rst

@@ -535,7 +535,7 @@ In sysbuild and Zephyr CMake build system a board may refer to:
 
 * A physical board with a single core SoC.
 * A specific core on a physical board with a multi-core SoC, such as
-  :ref:`nrf5340dk_nrf5340`.
+  :zephyr:board:`nrf5340dk`.
 * A specific SoC on a physical board with multiple SoCs, such as
   :ref:`nrf9160dk_nrf9160` and :ref:`nrf9160dk_nrf52840`.
 

doc/develop/getting_started/index.rst

@@ -523,7 +523,7 @@ another sample.
    When building for such boards it is necessary to specify the SoC or CPU
    cluster for which the sample must be built.
    For example to build :zephyr:code-sample:`blinky` for the ``cpuapp`` core on
-   the :ref:`nRF5340DK <nrf5340dk_nrf5340>` the board must be provided as:
+   the :zephyr:board:`nrf5340dk` the board must be provided as:
    ``nrf5340dk/nrf5340/cpuapp``. See also :ref:`board_terminology` for more
    details.
 

doc/hardware/porting/board_porting.rst

@@ -93,13 +93,13 @@ the :term:`SoC series` and :term:`SoC family` levels are not always used.
    +--------------------------------------------+--------------------------+-------------+--------------------+--------------------+----------------+----------------------+
    | :term:`board name`                         | :term:`board qualifiers` | :term:`SoC` | :term:`SoC Series` | :term:`SoC family` | CPU core       | :term:`architecture` |
    +============================================+==========================+=============+====================+====================+================+======================+
-   | :ref:`nrf52dk <nrf52dk_nrf52832>`          | nrf52832                 | nRF52832    | nRF52              | Nordic nRF         | Arm Cortex-M4  | ARMv7-M              |
+   | :zephyr:board:`nrf52dk`                    | nrf52832                 | nRF52832    | nRF52              | Nordic nRF         | Arm Cortex-M4  | ARMv7-M              |
    +--------------------------------------------+--------------------------+-------------+--------------------+--------------------+----------------+----------------------+
    | :zephyr:board:`frdm_k64f <frdm_k64f>`      | mk64f12                  | MK64F12     | Kinetis K6x        | NXP Kinetis        | Arm Cortex-M4  | ARMv7-M              |
    +--------------------------------------------+--------------------------+-------------+--------------------+--------------------+----------------+----------------------+
    | :zephyr:board:`rv32m1_vega <rv32m1_vega>`  | openisa_rv32m1/ri5cy     | RV32M1      | (Not used)         | (Not used)         | RI5CY          | RISC-V RV32          |
    +--------------------------------------------+--------------------------+-------------+--------------------+--------------------+----------------+----------------------+
-   | :ref:`nrf5340dk <nrf5340dk_nrf5340>`       | nrf5340/cpuapp           | nRF5340     | nRF53              | Nordic nRF         | Arm Cortex-M33 | ARMv8-M              |
+   | :zephyr:board:`nrf5340dk`                  | nrf5340/cpuapp           | nRF5340     | nRF53              | Nordic nRF         | Arm Cortex-M33 | ARMv8-M              |
    |                                            +--------------------------+-------------+--------------------+--------------------+----------------+----------------------+
    |                                            | nrf5340/cpunet           | nRF5340     | nRF53              | Nordic nRF         | Arm Cortex-M33 | ARMv8-M              |
    +--------------------------------------------+--------------------------+-------------+--------------------+--------------------+----------------+----------------------+
@@ -168,7 +168,7 @@ The board qualifiers ``nrf5340/cpuapp/ns`` can be read as:
   Zephyr denoting a non-secure build for boards supporting :ref:`tfm`.
 
 Not all SoCs define CPU clusters or variants. For example a simple board
-like the :ref:`thingy52_nrf52832` contains a single SoC with no CPU clusters and
+like the :zephyr:board:`thingy52` contains a single SoC with no CPU clusters and
 no variants.
 For ``thingy52`` the board target ``thingy52/nrf52832`` can be read as:
 
@@ -651,7 +651,7 @@ while porting.
   using the ``zephyr,console`` chosen node in the devicetree.
   Development boards with a built-in debug adapter or USB-to-UART adapter should
   by default configure and use the UART controller connected to that adapter.
-  For boards like :ref:`nRF52840 Dongle <nrf52840dongle_nrf52840>`, that do not
+  For boards like :zephyr:board:`nrf52840dongle`, that do not
   have a debug adapter, but a USB device controller, there is a common
   :zephyr_file:`Kconfig file <boards/common/usb/Kconfig.cdc_acm_serial.defconfig>`
   that must be included in the board's Kconfig.defconfig file and

doc/releases/release-notes-3.7.rst

@@ -452,8 +452,8 @@ Boards & SoC Support
   * Introduced the simulated :ref:`nrf54l15bsim<nrf54l15bsim>` target.
   * The nrf5x bsim targets now support BT LE Coded PHY.
   * LLVM fuzzing support has been refactored while adding support for it in native_sim.
-  * nRF54H20 PDK (pre-release) converted to :ref:`nrf54h20dk_nrf54h20`
+  * nRF54H20 PDK (pre-release) converted to :zephyr:board:`nrf54h20dk`
-  * PPR core target in :ref:`nrf54h20dk_nrf54h20` runs from RAM by default. A
+  * PPR core target in :zephyr:board:`nrf54h20dk` runs from RAM by default. A
     new ``xip`` variant has been introduced which runs from MRAM (XIP).
   * Refactored :zephyr:board:`beagleconnect_freedom` external antenna switch handling.
   * Added Arduino dts node labels for the nRF5340 Audio DK.

doc/releases/release-notes-4.0.rst

@@ -289,9 +289,9 @@ Boards & SoC Support
    * :zephyr:board:`Espressif ESP8684-DevKitM <esp8684_devkitm>` (``esp8684_devkitm``)
    * :zephyr:board:`Gardena Smart Garden Radio Module <sgrm>` (``sgrm``)
    * :zephyr:board:`mikroe STM32 M4 Clicker <mikroe_stm32_m4_clicker>` (``mikroe_stm32_m4_clicker``)
-   * :ref:`Nordic Semiconductor nRF54L15 DK <nrf54l15dk_nrf54l15>` (``nrf54l15dk``)
+   * :zephyr:board:`Nordic Semiconductor nRF54L15 DK <nrf54l15dk>` (``nrf54l15dk``)
-   * :ref:`Nordic Semiconductor nRF54L20 PDK <nrf54l20pdk_nrf54l20>` (``nrf54l20pdk``)
+   * :zephyr:board:`Nordic Semiconductor nRF54L20 PDK <nrf54l20pdk>` (``nrf54l20pdk``)
-   * :ref:`Nordic Semiconductor nRF7002 DK <nrf7002dk_nrf5340>` (``nrf7002dk``)
+   * :zephyr:board:`Nordic Semiconductor nRF7002 DK <nrf7002dk>` (``nrf7002dk``)
    * :zephyr:board:`Nuvoton NPCM400_EVB <npcm400_evb>` (``npcm400_evb``)
    * :zephyr:board:`NXP FRDM-MCXA156 <frdm_mcxa156>` (``frdm_mcxa156``)
    * :zephyr:board:`NXP FRDM-MCXC242 <frdm_mcxc242>` (``frdm_mcxc242``)
@@ -344,7 +344,7 @@ Boards & SoC Support
   * STM32: Deprecated MCO configuration via Kconfig in favour of setting it through Devicetree.
     See ``samples/boards/st/mco`` sample.
   * STM32: STM32CubeProgrammer is now the default runner on all STMicroelectronics STM32 boards.
-  * Removed the ``nrf54l15pdk`` board, use :ref:`nrf54l15dk_nrf54l15` instead.
+  * Removed the ``nrf54l15pdk`` board, use :zephyr:board:`nrf54l15dk` instead.
   * PHYTEC: ``mimx8mp_phyboard_pollux`` has been renamed to :ref:`phyboard_pollux<phyboard_pollux>`,
     with the old name marked as deprecated.
   * PHYTEC: ``mimx8mm_phyboard_polis`` has been renamed to :ref:`phyboard_polis<phyboard_polis>`,

doc/services/device_mgmt/mcumgr.rst

@@ -136,7 +136,7 @@ On boards where a J-Link OB is present which has both CDC and MSC (virtual Mass
 Storage Device, also known as drag-and-drop) support, the MSD functionality can
 prevent MCUmgr commands over the CDC UART port from working due to how USB
 endpoints are configured in the J-Link firmware (for example on the
-:ref:`Nordic nrf52840dk/nrf52840 board <nrf52840dk_nrf52840>`) because of
+:zephyr:board:`nrf52840dk` board) because of
 limiting the maximum packet size (most likely to occur when using image
 management commands for updating firmware). This issue can be
 resolved by disabling MSD functionality on the J-Link device, follow the

doc/services/retention/blinfo.rst

@@ -15,7 +15,7 @@ Devicetree setup
 To use the bootloader information subsystem, a retention area needs to be
 created which has a retained data section as its parent, generally non-init RAM
 is used for this purpose. See the following example (examples in this guide are
-based on the :ref:`nrf52840dk_nrf52840` board and memory layout):
+based on the :zephyr:board:`nrf52840dk` board and memory layout):
 
 .. code-block:: devicetree
 

doc/services/retention/index.rst

@@ -33,7 +33,7 @@ RAM as non-init for this purpose. The retention system is then initialised as a
 child node of this device 1 or more times - note that the memory region will
 need to be decremented to account for this reserved portion of RAM. See the
 following example (examples in this guide are based on the
-:ref:`nrf52840dk_nrf52840` board and memory layout):
+:zephyr:board:`nrf52840dk` board and memory layout):
 
 .. code-block:: devicetree
 

doc/services/tfm/requirements.rst

@@ -18,7 +18,7 @@ The following are some of the boards that can be used with TF-M:
      - ``lpcxpresso55s69_ns``
    * - :ref:`nrf9160dk_nrf9160`
      - ``nrf9160dk/nrf9160/ns``
-   * - :ref:`nrf5340dk_nrf5340`
+   * - :zephyr:board:`nrf5340dk`
      - ``nrf5340dk/nrf5340/cpuapp/ns``
    * - :zephyr:board:`b_u585i_iot02a`
      - ``b_u585i_iot02a/stm32u585xx/ns``

samples/basic/blinky_pwm/README.rst

@@ -63,7 +63,7 @@ In these other cases, however, manual wiring is necessary:
 Building and Running
 ********************
 
-To build and flash this sample for the :ref:`nrf52840dk_nrf52840`:
+To build and flash this sample for the :zephyr:board:`nrf52840dk`:
 
 .. zephyr-app-commands::
    :zephyr-app: samples/basic/blinky_pwm

samples/basic/fade_led/README.rst

@@ -24,7 +24,7 @@ This sample has the same requirements and wiring considerations as the
 Building and Running
 ********************
 
-To build and flash this sample for the :ref:`nrf52840dk_nrf52840`:
+To build and flash this sample for the :zephyr:board:`nrf52840dk`:
 
 .. zephyr-app-commands::
    :zephyr-app: samples/basic/fade_led

samples/bluetooth/channel_sounding/README.rst

@@ -37,7 +37,7 @@ connected devices are available in [#cs_setup_phase]_ and [#cs_start]_.
 Requirements
 ************
 
-* Two boards with Bluetooth LE and Channel Sounding support (such as an :ref:`nRF54L15 <nrf54l15dk_nrf54l15>`)
+* Two boards with Bluetooth LE and Channel Sounding support (such as an :zephyr:board:`nrf54l15dk`)
 * A controller that supports the Channel Sounding feature
 
 Building and Running

samples/bluetooth/direction_finding_central/README.rst

@@ -15,7 +15,7 @@ Requirements
 ************
 
 * Nordic nRF SoC based board with Direction Finding support (example boards:
-  :ref:`nrf52833dk_nrf52833`, :ref:`nrf52833dk_nrf52820`, :ref:`nrf5340dk_nrf5340`)
+  :zephyr:board:`nrf52833dk`, :zephyr:board:`nrf5340dk`)
 * Antenna matrix for AoA (optional)
 
 Check your SoC's product specification for Direction Finding support if you are

samples/bluetooth/direction_finding_connectionless_rx/README.rst

@@ -15,7 +15,7 @@ Requirements
 ************
 
 * Nordic nRF SoC based board with Direction Finding support (example boards:
-  :ref:`nrf52833dk_nrf52833`, :ref:`nrf5340dk_nrf5340`)
+  :zephyr:board:`nrf52833dk`, :zephyr:board:`nrf5340dk`)
 * Antenna matrix for AoA (optional)
 
 Check your SoC's product specification for Direction Finding support if you are

samples/bluetooth/direction_finding_connectionless_tx/README.rst

@@ -14,7 +14,7 @@ Requirements
 ************
 
 * Nordic nRF SoC based board with Direction Finding support (example boards:
-  :ref:`nrf52833dk_nrf52833`, :ref:`nrf5340dk_nrf5340`)
+  :zephyr:board:`nrf52833dk`, :zephyr:board:`nrf5340dk`)
 * Antenna matrix for AoD (optional)
 
 Check your SoC's product specification for Direction Finding support if you are

samples/bluetooth/direction_finding_peripheral/README.rst

@@ -14,7 +14,7 @@ Requirements
 ************
 
 * Nordic nRF SoC based board with Direction Finding support (example boards:
-  :ref:`nrf52833dk_nrf52833`, :ref:`nrf52833dk_nrf52820`, :ref:`nrf5340dk_nrf5340`)
+  :zephyr:board:`nrf52833dk`, :zephyr:board:`nrf5340dk`)
 * Antenna matrix for AoA (optional)
 
 Check your SoC's product specification for Direction Finding support if you are

samples/bluetooth/hci_spi/README.rst

@@ -25,7 +25,7 @@ the host and associates the application with a SPI bus to use.
 
 See :zephyr_file:`boards/nrf51dk_nrf51822.overlay
 <samples/bluetooth/hci_spi/boards/nrf51dk_nrf51822.overlay>` in this sample
-directory for an example overlay for the :ref:`nrf51dk_nrf51822` board.
+directory for an example overlay for the :zephyr:board:`nrf51dk` board.
 
 You can then build this application and flash it onto your board in
 the usual way; see :ref:`boards` for board-specific building and

samples/bluetooth/hci_usb/README.rst

@@ -8,7 +8,7 @@ Overview
 ********
 
 Make a USB Bluetooth dongle out of Zephyr. Requires USB device support from the
-board it runs on (e.g. :ref:`nrf52840dk_nrf52840` supports both Bluetooth LE and USB).
+board it runs on (e.g. :zephyr:board:`nrf52840dk` supports both Bluetooth LE and USB).
 
 Requirements
 ************

samples/bluetooth/mesh/README.rst

@@ -45,7 +45,7 @@ For other boards, build and flash the application as follows:
 Refer to your :ref:`board's documentation <boards>` for alternative
 flash instructions if your board doesn't support the ``flash`` target.
 
-To run the application on an :ref:`nrf5340dk_nrf5340`, a Bluetooth controller application
+To run the application on an :zephyr:board:`nrf5340dk`, a Bluetooth controller application
 must also run on the network core. The :zephyr:code-sample:`bluetooth_hci_ipc` sample
 application may be used. Build this sample with configuration
 :zephyr_file:`samples/bluetooth/hci_ipc/nrf5340_cpunet_bt_mesh-bt_ll_sw_split.conf`

samples/bluetooth/mesh_demo/README.rst

@@ -56,7 +56,7 @@ For other boards, build and flash the application as follows:
 Refer to your :ref:`board's documentation <boards>` for alternative
 flash instructions if your board doesn't support the ``flash`` target.
 
-To run the application on an :ref:`nrf5340dk_nrf5340`, a Bluetooth controller application
+To run the application on an :zephyr:board:`nrf5340dk`, a Bluetooth controller application
 must also run on the network core. The :zephyr:code-sample:`bluetooth_hci_ipc` sample
 application may be used. Build this sample with configuration
 :zephyr_file:`samples/bluetooth/hci_ipc/nrf5340_cpunet_bt_mesh-bt_ll_sw_split.conf`

samples/bluetooth/mesh_provisioner/README.rst

@@ -54,7 +54,7 @@ For other boards, build and flash the application as follows:
 Refer to your :ref:`board's documentation <boards>` for alternative
 flash instructions if your board doesn't support the ``flash`` target.
 
-To run the application on an :ref:`nrf5340dk_nrf5340`, a Bluetooth controller application
+To run the application on an :zephyr:board:`nrf5340dk`, a Bluetooth controller application
 must also run on the network core. The :zephyr:code-sample:`bluetooth_hci_ipc` sample
 application may be used. Build this sample with configuration
 :zephyr_file:`samples/bluetooth/hci_ipc/nrf5340_cpunet_bt_mesh-bt_ll_sw_split.conf`

samples/drivers/adc/adc_sequence/README.rst

@@ -31,7 +31,7 @@ Building and Running for Nordic nRF52840
 ========================================
 
 The sample can be built and executed for the
-:ref:`nrf52840dk_nrf52840` as follows:
+:zephyr:board:`nrf52840dk` as follows:
 
 .. zephyr-app-commands::
    :zephyr-app: samples/drivers/adc/adc_sequence

samples/drivers/audio/dmic/README.rst

@@ -17,8 +17,8 @@ Requirements
 
 The device to be used by the sample is specified by defining a devicetree node
 label named ``dmic_dev``.
-The sample has been tested on :ref:`nrf52840dk_nrf52840` (nrf52840dk/nrf52840)
+The sample has been tested on :zephyr:board:`nrf52840dk` (nrf52840dk/nrf52840)
-and :ref:`nrf5340dk_nrf5340` (nrf5340dk/nrf5340/cpuapp), and provides overlay
+and :zephyr:board:`nrf5340dk` (nrf5340dk/nrf5340/cpuapp), and provides overlay
 files for both of these boards.
 
 Building and Running

samples/drivers/display/README.rst

@@ -31,7 +31,7 @@ Building and Running
 
 As this is a generic sample it should work with any display supported by Zephyr.
 
-Below is an example on how to build for a :ref:`nrf52840dk_nrf52840` board with a
+Below is an example on how to build for a :zephyr:board:`nrf52840dk` board with a
 :ref:`adafruit_2_8_tft_touch_v2`.
 
 .. zephyr-app-commands::

samples/drivers/ht16k33/README.rst

@@ -23,7 +23,7 @@ The sample logs keyscan events on the console.
 Building and Running
 ********************
 
-Build the application for the :ref:`nrf52840dk_nrf52840` board, and
+Build the application for the :zephyr:board:`nrf52840dk` board, and
 connect an HT16K33 LED driver at address 0x70 on the I2C-0 bus.
 
 .. zephyr-app-commands::
@@ -33,7 +33,7 @@ connect an HT16K33 LED driver at address 0x70 on the I2C-0 bus.
    :compact:
 
 For flashing the application, refer to the Flashing section of the
-:ref:`nrf52840dk_nrf52840` board documentation.
+:zephyr:board:`nrf52840dk` board documentation.
 
 References
 **********

samples/drivers/i2s/echo/README.rst

@@ -22,8 +22,8 @@ a devicetree node label named ``i2s_rxtx`` or separate node labels ``i2s_rx``
 and ``i2s_tx`` if separate I2S devices are to be used for the RX and TX
 streams.
 
-This sample has been tested on :ref:`nrf52840dk_nrf52840` (nrf52840dk/nrf52840)
+This sample has been tested on :zephyr:board:`nrf52840dk` (nrf52840dk/nrf52840)
-and :ref:`nrf5340dk_nrf5340` (nrf5340dk/nrf5340/cpuapp), using the Audio Codec
+and :zephyr:board:`nrf5340dk` (nrf5340dk/nrf5340/cpuapp), using the Audio Codec
 Shield, and provides overlay files for both of these boards.
 
 More information about the used shield and the CODEC itself can be found here:

samples/drivers/led/lp5562/README.rst

@@ -30,7 +30,7 @@ mappings used by this sample.
 Building and Running
 ********************
 
-Build the application for the :ref:`nrf52840dk_nrf52840` board, and connect
+Build the application for the :zephyr:board:`nrf52840dk` board, and connect
 a LP5562 LED driver on the bus I2C0 at the address 0x30.
 
 .. zephyr-app-commands::
@@ -40,6 +40,6 @@ a LP5562 LED driver on the bus I2C0 at the address 0x30.
    :compact:
 
 For flashing the application, refer to the Flashing section of the
-:ref:`nrf52840dk_nrf52840` board documentation.
+:zephyr:board:`nrf52840dk` board documentation.
 
 .. _LP5562 Manual: http://www.ti.com/lit/ds/symlink/lp5562.pdf

samples/drivers/led/lp5569/README.rst

@@ -16,7 +16,7 @@ This pattern then repeats indefinitely.
 Building and Running
 ********************
 
-Build the application for the :ref:`nrf52840dk_nrf52840` board, and connect
+Build the application for the :zephyr:board:`nrf52840dk` board, and connect
 a LP5569 LED controller on the bus I2C0 at the address 0x32.
 
 .. zephyr-app-commands::
@@ -26,7 +26,7 @@ a LP5569 LED controller on the bus I2C0 at the address 0x32.
    :compact:
 
 For flashing the application, refer to the Flashing section of the
-:ref:`nrf52840dk_nrf52840` board documentation.
+:zephyr:board:`nrf52840dk` board documentation.
 
 .. code-block:: none
 

samples/sensor/adt7420/README.rst

@@ -37,7 +37,7 @@ Building and Running
 This project outputs sensor data to the console. It requires an ADT7420
 sensor. It should work with any platform featuring a I2C peripheral interface.
 It does not work on QEMU.
-In this example below the :ref:`nrf52dk_nrf52832` board is used.
+In this example below the :zephyr:board:`nrf52dk` board is used.
 
 
 .. zephyr-app-commands::

samples/sensor/bmi270/README.rst

@@ -30,7 +30,7 @@ Building and Running
 This project outputs sensor data to the console. It requires a BMI270
 sensor. It should work with any platform featuring a I2C peripheral interface.
 It does not work on QEMU.
-In this example below the :ref:`nrf52840dk_nrf52840` board is used.
+In this example below the :zephyr:board:`nrf52840dk` board is used.
 
 
 .. zephyr-app-commands::

samples/sensor/clock/README.rst

@@ -13,7 +13,7 @@ and utilize the Sensor Clock API.
 Building and Running
 ********************
 
-The sample below uses the :ref:`nrf52840dk_nrf52840` and :ref:`nrf52833dk_nrf52833` boards.
+The sample below uses the :zephyr:board:`nrf52840dk` and :zephyr:board:`nrf52833dk` boards.
 
 To run this sample, ensure the following configurations:
 

samples/sensor/lis2dh/README.rst

@@ -30,7 +30,7 @@ The LIS2DH2 or compatible sensors are available on a variety of boards
 and shields supported by Zephyr, including:
 
 * :zephyr:board:`actinius_icarus`
-* :ref:`thingy52_nrf52832`
+* :zephyr:board:`thingy52`
 * :zephyr:board:`stm32f3_disco`
 * :ref:`x-nucleo-iks01a2`
 

samples/sensor/ms5837/README.rst

@@ -42,7 +42,7 @@ Build this sample using the following commands:
    :goals: build
    :compact:
 
-See :ref:`nrf52840dk_nrf52840` on how to flash the build.
+See :zephyr:board:`nrf52840dk` on how to flash the build.
 
 References
 **********

samples/subsys/display/lvgl/README.rst

@@ -38,8 +38,8 @@ Requirements
 Display shield and a board which provides a configuration
 for corresponding connectors, for example:
 
-- :ref:`adafruit_2_8_tft_touch_v2` and :ref:`nrf52840dk_nrf52840`
+- :ref:`adafruit_2_8_tft_touch_v2` and :zephyr:board:`nrf52840dk`
-- :ref:`buydisplay_2_8_tft_touch_arduino` and :ref:`nrf52840dk_nrf52840`
+- :ref:`buydisplay_2_8_tft_touch_arduino` and :zephyr:board:`nrf52840dk`
 - :ref:`ssd1306_128_shield` and :zephyr:board:`frdm_k64f`
 - :ref:`seeed_xiao_round_display` and :zephyr:board:`xiao_ble`
 
@@ -66,7 +66,7 @@ or
 Building and Running
 ********************
 
-Example building for :ref:`nrf52840dk_nrf52840`:
+Example building for :zephyr:board:`nrf52840dk`:
 
 .. zephyr-app-commands::
    :zephyr-app: samples/subsys/display/lvgl

samples/subsys/mgmt/updatehub/README.rst

@@ -454,7 +454,7 @@ The below list of hardware have been used by UpdateHub team.
    :width: 800px
 
    :zephyr:board:`frdm_k64f`, "1, 2, 3, 4"
-   :ref:`nrf52840dk_nrf52840`, "2, 3, 4, 5, 6"
+   :zephyr:board:`nrf52840dk`, "2, 3, 4, 5, 6"
    :zephyr:board:`nucleo_f767zi`, "1, 2, 3, 4"
 
 

samples/subsys/usb/uac2_explicit_feedback/README.rst

@@ -48,11 +48,11 @@ is not available, the DPPI and TIMER peripherals on nRF5340 can be configured to
 provide relative timing information between I2S FRAMESTART and USB SOF.
 
 This sample in both modes (direct sample counting and indirect I2S buffer output
-to USB SOF offset) has been tested on :ref:`nrf5340dk_nrf5340`.
+to USB SOF offset) has been tested on :zephyr:board:`nrf5340dk`.
 
 The sample defaults to indirect feedback calculation because direct sample
 counting requires external connection between I2S LRCLK output pin to GPIOTE
-input pin (hardcoded to P1.09) on :ref:`nrf5340dk_nrf5340`. In the indirect mode
+input pin (hardcoded to P1.09) on :zephyr:board:`nrf5340dk`. In the indirect mode
 no extra connections are necessary and the sample can even be used without any
 I2S device connected where I2S signals can be checked e.g. on logic analyzer.
 

samples/subsys/usb/uac2_implicit_feedback/README.rst

@@ -23,7 +23,7 @@ Target must be able to measure I2S block start (i.e. first sample from output
 buffer gets out) relative to USB SOF. The relative offset must be reported with
 single sample accuracy.
 
-This sample has been tested on :ref:`nrf5340dk_nrf5340`. While for actual audio
+This sample has been tested on :zephyr:board:`nrf5340dk`. While for actual audio
 experience it is necessary to connect external I2S ADC and I2S DAC, simple echo
 can be accomplished by shorting I2S data output with I2S data input.
 

samples/sysbuild/hello_world/README.rst

@@ -30,7 +30,7 @@ to boot a remote core.
    ``-T`` option.
 
 Here's an example to build and flash the sample for the
-:ref:`nrf54h20dk_nrf54h20`, using application and radio cores:
+:zephyr:board:`nrf54h20dk`, using application and radio cores:
 
 .. zephyr-app-commands::
    :zephyr-app: samples/sysbuild/hello_world