boards: renesas: Update documentation for Renesas RA boards

- Update boards documetation with new format
- Correct typo for documentation of RA boards

Signed-off-by: Quy Tran <[email protected]>

Author: quytranpzz

boards/renesas/ek_ra2a1/doc/index.rst

@@ -1,7 +1,4 @@
-.. _ek_ra2a1:
-
-RA2A1 Evaluation Kit
-####################
+.. zephyr:board:: ek_ra2a1
 
 Overview
 ********
@@ -31,12 +28,6 @@ Renesas RA2A1 Microcontroller Group has following features
 - Watchdog Timer
 - 49 Input/Output pins
 
-.. figure:: ek_ra2a1.webp
-	:align: center
-	:alt: RA2A1 Evaluation Kit
-
-	EK-RA2A1 Board Functional Area Definitions (Credit: Renesas Electronics Corporation)
-
 Hardware
 ********
 

boards/renesas/ek_ra2l1/doc/index.rst

@@ -1,8 +1,5 @@
 .. zephyr:board:: ek_ra2l1
 
-RA2L1 Evaluation Kit
-####################
-
 Overview
 ********
 

boards/renesas/ek_ra4e2/doc/index.rst

@@ -1,7 +1,4 @@
-.. _ek_ra4e2:
-
-RA4E2 Evaluation Kit
-####################
+.. zephyr:board:: ek_ra4e2
 
 Overview
 ********
@@ -16,17 +13,19 @@ The MCU in this series incorporates a high-performance Arm Cortex®-M33 core run
 100 MHz with the following features:
 
 **MCU Native Pin Access**
+
 - R7FA4E2B93CFM MCU (referred to as RA MCU)
 - 100 MHz, Arm® Cortex®-M33 core
 - 128 kB Code Flash, 40 kB SRAM
 - 64 pins, LQFP package
 - Native pin access through 2 x 14-pin and 1 x 40-pin male headers
 - MCU current measurement points for precision current consumption measurement
 - Multiple clock sources - RA MCU oscillator and sub-clock oscillator crystals, providing precision
-20.000 MHz and 32,768 Hz reference clock. Additional low-precision clocks are available internal to the
-RA MCU
+  20.000 MHz and 32,768 Hz reference clock. Additional low-precision clocks are available internal to the
+  RA MCU
 
 **System Control and Ecosystem Access**
+
 - USB Full Speed Device (micro-AB connector)
 - Three 5 V input sources
 
@@ -61,15 +60,9 @@ RA MCU
 
 - CAN FD (3-pin header)
 
-.. figure:: ek_ra4e2.webp
-	:align: center
-	:alt: RA4E2 Evaluation Kit
-
-	EK-RA4E2 Board Functional Area Definitions (Credit: Renesas Electronics Corporation)
-
 Hardware
 ********
-Detail Hardware feature for the RA4E2 MCU group can be found at `RA4E2 Group User's Manual Hardware`_
+Detailed hardware features for the RA4E2 MCU group can be found at `RA4E2 Group User's Manual Hardware`_
 
 .. figure:: ra4e2_block_diagram.webp
 	:width: 442px
@@ -78,12 +71,12 @@ Detail Hardware feature for the RA4E2 MCU group can be found at `RA4E2 Group Use
 
 	RA4E2 Block diagram (Credit: Renesas Electronics Corporation)
 
-Detail Hardware feature for the EK-RA4E2 MCU can be found at `EK-RA4E2 - User's Manual`_
+Detailed hardware features for the EK-RA4E2 MCU can be found at `EK-RA4E2 - User's Manual`_
 
 Supported Features
 ==================
 
-The below features are currently supported on Zephyr OS for EK-RA4E2 board:
+The below features are currently supported on Zephyr for EK-RA4E2 board:
 
 +-----------+------------+----------------------+
 | Interface | Controller | Driver/Component     |
@@ -129,11 +122,11 @@ SEGGER J-link's drivers are avaialbe at https://www.segger.com/downloads/jlink/
 
 To flash the program to board
 
-  1. Connect to J-Link OB via USB port to host PC
+1. Connect to J-Link OB via USB port to host PC
 
-  2. Make sure J-Link OB jumper is in default configuration as describe in `EK-RA4E2 - User's Manual`_
+2. Make sure J-Link OB jumper is in default configuration as describe in `EK-RA4E2 - User's Manual`_
 
-  3. Execute west command
+3. Execute west command
 
 	.. code-block:: console
 

boards/renesas/ek_ra4l1/doc/index.rst

@@ -1,8 +1,5 @@
 .. zephyr:board:: ek_ra4l1
 
-RA4L1 Evaluation Kit
-####################
-
 Overview
 ********
 

boards/renesas/ek_ra4m1/doc/index.rst

@@ -1,8 +1,5 @@
 .. zephyr:board:: ek_ra4m1
 
-RA4M1 Evaluation Kit
-####################
-
 Overview
 ********
 

boards/renesas/ek_ra4m2/doc/index.rst

@@ -1,7 +1,4 @@
-.. _ek_ra4m2:
-
-RA4M2 Evaluation Kit
-####################
+.. zephyr:board:: ek_ra4m2
 
 Overview
 ********
@@ -17,17 +14,19 @@ The MCU in this series incorporates a high-performance Arm Cortex®-M33 core run
 100 MHz with the following features:
 
 **Renesas RA4M2 Microcontroller Group**
+
 - R7FA4M2AD3CFP
 - 100-pin LQFP package
 - 100 MHz Arm® Cortex®-M33 core
 - 512 kB Code Flash, 128 KB SRAM
 - Native pin access through 4 x 28-pin male headers
 - MCU current measurement points for precision current consumption measurement
--  Multiple clock sources - RA MCU oscillator and sub-clock oscillator crystals, providing
-precision 24.000 MHz and 32,768 Hz reference clock. Additional low-precision clocks are
-available internal to the RA MCU
+- Multiple clock sources - RA MCU oscillator and sub-clock oscillator crystals, providing
+  precision 24.000 MHz and 32,768 Hz reference clock. Additional low-precision clocks are
+  available internal to the RA MCU
 
 **System Control and Ecosystem Access**
+
 - USB Full Speed Host and Device (micro AB connector)
 - Three 5 V input sources
 
@@ -59,17 +58,12 @@ available internal to the RA MCU
 - MCU boot configuration jumper
 
 **Special Feature Access**
-- 32 MB (256 Mb) External Quad-SPI Flash
 
-.. figure:: ek_ra4m2.webp
-	:align: center
-	:alt: RA4M2 Evaluation Kit
-
-	EK-RA4M2 Board Functional Area Definitions (Credit: Renesas Electronics Corporation)
+- 32 MB (256 Mb) External Quad-SPI Flash
 
 Hardware
 ********
-Detail Hardware feature for the RA4M2 MCU group can be found at `RA4M2 Group User's Manual Hardware`_
+Detailed hardware features for the RA4M2 MCU group can be found at `RA4M2 Group User's Manual Hardware`_
 
 .. figure:: ra4m2_block_diagram.webp
 	:width: 442px
@@ -78,12 +72,12 @@ Detail Hardware feature for the RA4M2 MCU group can be found at `RA4M2 Group Use
 
 	RA4M2 Block diagram (Credit: Renesas Electronics Corporation)
 
-Detail Hardware feature for the EK-RA4M2 MCU can be found at `EK-RA4M2 - User's Manual`_
+Detailed hardware features for the EK-RA4M2 MCU can be found at `EK-RA4M2 - User's Manual`_
 
 Supported Features
 ==================
 
-The below features are currently supported on Zephyr OS for EK-RA4M2 board:
+The below features are currently supported on Zephyr for EK-RA4M2 board:
 
 +-----------+------------+----------------------+
 | Interface | Controller | Driver/Component     |
@@ -135,11 +129,11 @@ SEGGER J-link's drivers are avaialbe at https://www.segger.com/downloads/jlink/
 
 To flash the program to board
 
-  1. Connect to J-Link OB via USB port to host PC
+1. Connect to J-Link OB via USB port to host PC
 
-  2. Make sure J-Link OB jumper is in default configuration as describe in `EK-RA4M2 - User's Manual`_
+2. Make sure J-Link OB jumper is in default configuration as describe in `EK-RA4M2 - User's Manual`_
 
-  3. Execute west command
+3. Execute west command
 
 	.. code-block:: console
 

boards/renesas/ek_ra4m3/doc/index.rst

@@ -1,7 +1,4 @@
-.. _ek_ra4m3:
-
-RA4M3 Evaluation Kit
-####################
+.. zephyr:board:: ek_ra4m3
 
 Overview
 ********
@@ -18,6 +15,7 @@ The MCU in this series incorporates a high-performance Arm Cortex®-M33 core run
 100 MHz with the following features:
 
 **MCU Native Pin Access**
+
 - R7FA4M3AF3CFB
 - 100-pin LQFP package
 - 100 MHz Arm® Cortex®-M33 core
@@ -26,32 +24,30 @@ The MCU in this series incorporates a high-performance Arm Cortex®-M33 core run
 - Native pin access through 4 x 40-pin male headers
 - MCU and USB current measurement points for precision current consumption measurement
 - Multiple clock sources - RA MCU oscillator and sub-clock oscillator crystals, providing precision
-24.000 MHz and 32,768 Hz reference clock. Additional low-precision clocks are available internal to the
-RA MCU
+  24.000 MHz and 32,768 Hz reference clock. Additional low-precision clocks are available internal to the
+  RA MCU
 
 **System Control and Ecosystem Access**
+
 - USB Full Speed Host and Device (micro AB connector)
-- Three 5 V input sources
 
+- Three 5 V input sources
 	- USB (Debug, Full Speed)
 	- External power supply (using surface mount clamp test points and power input vias)
 
- Three Debug modes
-
+- Three Debug modes
 	- Debug on-board (SWD)
 	- Debug in (ETM, SWD, and JTAG)
 	- Debug out (SWD)
 
- User LEDs and buttons
-
+- User LEDs and buttons
 	- Three User LEDs (red, blue, green)
 	- Power LED (white) indicating availability of regulated power
 	- Debug LED (yellow) indicating the debug connection
 	- Two User buttons
 	- One Reset button
 
 - Five most popular ecosystems expansions
-
 	- 2 Seeed Grove® system (I2C/Analog) connectors
 	- SparkFun® Qwiic® connector
 	- 2 Digilent PmodTM (SPI and UART) connectors
@@ -63,15 +59,9 @@ RA MCU
 **Special Feature Access**
 - 32 MB (256 Mb) External Quad-SPI Flash
 
-.. figure:: ek_ra4m3.webp
-	:align: center
-	:alt: RA4M3 Evaluation Kit
-
-	EK-RA4M3 Board Functional Area Definitions (Credit: Renesas Electronics Corporation)
-
 Hardware
 ********
-Detail Hardware feature for the RA4M3 MCU group can be found at `RA4M3 Group User's Manual Hardware`_
+Detailed hardware features for the RA4M3 MCU group can be found at `RA4M3 Group User's Manual Hardware`_
 
 .. figure:: ra4m3_block_diagram.webp
 	:width: 442px
@@ -80,12 +70,12 @@ Detail Hardware feature for the RA4M3 MCU group can be found at `RA4M3 Group Use
 
 	RA4M3 Block diagram (Credit: Renesas Electronics Corporation)
 
-Detail Hardware feature for the EK-RA4M3 MCU can be found at `EK-RA4M3 - User's Manual`_
+Detailed hardware features for the EK-RA4M3 MCU can be found at `EK-RA4M3 - User's Manual`_
 
 Supported Features
 ==================
 
-The below features are currently supported on Zephyr OS for EK-RA4M3 board:
+The below features are currently supported on Zephyr for EK-RA4M3 board:
 
 +-----------+------------+----------------------+
 | Interface | Controller | Driver/Component     |