1.. _ek_ra6m3:
2
3RA6M3 Evaluation Kit
4####################
5
6Overview
7********
8
9The Renesas RA6M3 group uses the high-performance Arm® Cortex®-M4 core and
10offers a TFT controller with 2D accelerator and JPEG decoder. The RA6M3 is
11suitable for IoT applications requiring TFT, Ethernet, security, large
12embedded RAM, and USB High Speed (HS).
13
14The key features of the EK-RA6M3 board are categorized in three groups as follow:
15
16**MCU Native Pin Access**
17
18- 120MHz Arm Cortex-M4 based RA6M3 MCU in 176 pins, LQFP package
19- Native pin access through 4 x 40-pin male headers
20- MCU and USB current measurement points for precision current consumption measurement
21- Multiple clock sources - RA6M3 MCU oscillator and sub-clock oscillator crystals,
22  providing precision 24.000 MHz and 32,768 Hz reference clock.
23  Additional low precision clocks are avaialbe internal to the RA6M3 MCU
24
25**System Control and Ecosystem Access**
26
27- USB Full Speed Host and Device (micro AB connector)
28- Four 5V input sources
29
30  - USB (Debug, Full Speed, High Speed)
31  - External power supply (using surface mount clamp test points and power input vias)
32
33- Three Debug modes
34
35  - Debug on-board (SWD)
36  - Debug in (ETM, SWD and JTAG)
37  - Debug out (SWD)
38
39- User LEDs and buttons
40
41  - Three User LEDs (red, blue, green)
42  - Power LED (white) indicating availability of regulated power
43  - Debug LED (yellow) indicating the debug connection
44  - Two User buttons
45  - One Reset button
46
47- Four most popular ecosystems expansions
48
49  - Two Seeed Grove system (I2C) connectors
50  - Two Digilent Pmod (SPI and UART) connectors
51  - Arduino (Uno R3) connector
52  - MikroElektronika mikroBUS connector
53
54- MCU boot configuration jumper
55
56**Special Feature Access**
57
58- Ethernet (RJ45 RMII interface)
59- USB High Speed Host and Device (micro-AB connector)
60- 32 Mb (256 Mb) External Quad-SPI Flash
61
62.. figure:: ek_ra6m3.webp
63	:align: center
64	:alt: RA6M3 Evaluation Kit
65
66	EK-RA6M3 Board Functional Area Definitions (Credit: Renesas Electronics Corporation)
67
68Hardware
69********
70Detailed hardware feature for the RA6M3 MCU group can be found at `RA6M3 Group User's Manual Hardware`_
71
72.. figure:: ra6m3_block_diagram.webp
73	:width: 442px
74	:align: center
75	:alt: RA6M3 MCU group feature
76
77	RA6M3 Block diagram (Credit: Renesas Electronics Corporation)
78
79Detail hardware feature for the EK-RA6M3 MCU can be found at `EK-RA6M3 - User's Manual`_
80
81Supported Features
82==================
83
84The below features are currently supported on Zephyr OS for EK-RA6M3 board:
85
86+-----------+------------+----------------------+
87| Interface | Controller | Driver/Component     |
88+===========+============+======================+
89| GPIO      | on-chip    | gpio                 |
90+-----------+------------+----------------------+
91| MPU       | on-chip    | arch/arm             |
92+-----------+------------+----------------------+
93| NVIC      | on-chip    | arch/arm             |
94+-----------+------------+----------------------+
95| UART      | on-chip    | serial               |
96+-----------+------------+----------------------+
97| CLOCK     | on-chip    | clock control        |
98+-----------+------------+----------------------+
99| I2C       | on-chip    | i2c                  |
100+-----------+------------+----------------------+
101| SPI       | on-chip    | spi                  |
102+-----------+------------+----------------------+
103| COUNTER   | on-chip    | counter              |
104+-----------+------------+----------------------+
105| USBHS     | on-chip    | udc                  |
106+-----------+------------+----------------------+
107| ADC       | on-chip    | adc                  |
108+-----------+------------+----------------------+
109| PWM       | on-chip    | pwm                  |
110+-----------+------------+----------------------+
111
112Other hardware features are currently not supported by the port.
113
114Programming and Debugging
115*************************
116
117Applications for the ``ek_ra6m3`` board target configuration can be
118built, flashed, and debugged in the usual way. See
119:ref:`build_an_application` and :ref:`application_run` for more details on
120building and running.
121
122Flashing
123========
124
125Program can be flashed to EK-RA6M3 via the on-board SEGGER J-Link debugger.
126SEGGER J-link's drivers are avaialbe at https://www.segger.com/downloads/jlink/
127
128To flash the program to board
129
130  1. Connect to J-Link OB via USB port to host PC
131
132  2. Make sure J-Link OB jumper is in default configuration as describe in `EK-RA6M3 - User's Manual`_
133
134  3. Execute west command
135
136	.. code-block:: console
137
138		west flash -r jlink
139
140Debugging
141=========
142
143You can use Segger Ozone (`Segger Ozone Download`_) for a visual debug interface
144
145Once downloaded and installed, open Segger Ozone and configure the debug project
146like so:
147
148* Target Device: R7FA6M3AH
149* Target Interface: SWD
150* Target Interface Speed: 4 MHz
151* Host Interface: USB
152* Program File: <path/to/your/build/zephyr.elf>
153
154**Note:** It's verified that we can debug OK on Segger Ozone v3.30d so please use this or later
155version of Segger Ozone
156
157References
158**********
159- `EK-RA6M3 Website`_
160- `RA6M3 MCU group Website`_
161
162.. _EK-RA6M3 Website:
163   https://www.renesas.com/us/en/products/microcontrollers-microprocessors/ra-cortex-m-mcus/ek-ra6m3-evaluation-kit-ra6m3-mcu-group
164
165.. _RA6M3 MCU group Website:
166   https://www.renesas.com/us/en/products/microcontrollers-microprocessors/ra-cortex-m-mcus/ra6m3-32-bit-microcontrollers-120mhz-usb-high-speed-ethernet-and-tft-controller
167
168.. _EK-RA6M3 - User's Manual:
169   https://www.renesas.com/us/en/document/mat/ek-ra6m3-v1-users-manual
170
171.. _RA6M3 Group User's Manual Hardware:
172   https://www.renesas.com/us/en/document/mah/ra6m3-group-users-manual-hardware
173
174.. _Segger Ozone Download:
175   https://www.segger.com/downloads/jlink#Ozone
176