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,4 +1,4 @@
-.. _ek_ra2a1:
+.. zephyr:board:: ek_ra2a1
 
 RA2A1 Evaluation Kit
 ####################
@@ -31,12 +31,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_ra4e2/doc/index.rst

@@ -1,4 +1,4 @@
-.. _ek_ra4e2:
+.. zephyr:board:: ek_ra4e2
 
 RA4E2 Evaluation Kit
 ####################
@@ -16,17 +16,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 +63,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 +74,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     |
@@ -127,11 +123,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_ra4m2/doc/index.rst

@@ -1,4 +1,4 @@
-.. _ek_ra4m2:
+.. zephyr:board:: ek_ra4m2
 
 RA4M2 Evaluation Kit
 ####################
@@ -17,17 +17,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 +61,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 +75,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     |
@@ -131,11 +128,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,4 +1,4 @@
-.. _ek_ra4m3:
+.. zephyr:board:: ek_ra4m3
 
 RA4M3 Evaluation Kit
 ####################
@@ -18,6 +18,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 +27,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 +62,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 +73,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     |

boards/renesas/ek_ra4w1/doc/index.rst

@@ -1,4 +1,4 @@
-.. _ek_ra4w1:
+.. zephyr:board:: ek_ra4w1
 
 RA4W1 Evaluation Kit
 ####################
@@ -14,54 +14,56 @@ excellent reception performance. RA4W1 is geared towards IoT application requiri
 embedded RAM and low power consumption.
 
 **MCU Native Pin Access**
+
 - R7FA4W1AD2CNG
 - QFN-56 package
 - On-chip memory: 512-KB ROM, 96-KB RAM, 8-KB data flash memory
 
 **Power-supply voltage**
+
 - USB connector: 5-V input
 - Power-supply IC: 5-V input, 3.3-V output
 - External power-supply header*1: 3.3-V input, 2 pins x 1
 
 **Main clock**
+
 - Crystal oscillator (surface-mount technology (SMT)) for the main system clock
 - Crystal oscillator or ceramic resonator (lead type) for the main system clock
 
 **Sub-clock**
+
 - Crystal oscillator (SMT) for the sub-clock
 
 **Bluetooth Low Energy**
+
 - Bluetooth Low Energy (BLE) circuit x1
 - Range of frequency: 2402 to 2480 MHz
 - Maximum transmission output power: 4 dBm (in 4-dBm output mode)
 - Output variation: +2 dB
 
 **Push switches**
+
 - Reset switch x 1
 - User switch x 1
 
 **LED**
+
 - Power indicator: green x 1
 - User: green x 2
 - ACT LED: green x 1
 
-**Conetivity**
+**Connectivity**
+
 - Connector for an on-board emulator: USB Micro-B
 - Connector for a USB serial-conversion interface: USB Micro-B
 - Pmod™ connector: Angle type, 12 pins
 - Arduino™ UNO connectors
 
-- Emulator reset switch
-
-.. figure:: ek_ra4w1.webp
-	:align: center
-	:alt: RA4W1 Evaluation Kit
-
-	EK-RA4W1 Board Functional Area Definitions (Credit: Renesas Electronics Corporation)
+- Emulator reset switch: DIP switch x 1
 
 Hardware
 ********
-Detail Hardware feature for the RA4W1 MCU group can be found at `RA4W1 Group User's Manual Hardware`_
+Detailed Hardware features for the RA4W1 MCU group can be found at `RA4W1 Group User's Manual Hardware`_
 
 .. figure:: ra4w1_block_diagram.webp
 	:width: 442px
@@ -70,12 +72,12 @@ Detail Hardware feature for the RA4W1 MCU group can be found at `RA4W1 Group Use
 
 	RA4W1 Block diagram (Credit: Renesas Electronics Corporation)
 
-Detail Hardware feature for the EK-RA4W1 MCU can be found at `EK-RA4W1 - User's Manual`_
+Detailed Hardware features for the EK-RA4W1 MCU can be found at `EK-RA4W1 - User's Manual`_
 
 Supported Features
 ==================
 
-The below features are currently supported on Zephyr OS for EK-RA4W1 board:
+The below features are currently supported on Zephyr for EK-RA4W1 board:
 
 +-----------+------------+----------------------+
 | Interface | Controller | Driver/Component     |
@@ -121,11 +123,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-RA4W1 - User's Manual`_
+2. Make sure J-Link OB jumper is in default configuration as describe in `EK-RA4W1 - User's Manual`_
 
-  3. Execute west command
+3. Execute west command
 
 	.. code-block:: console