1.. _ek_ra6m5:
2
3RA6M5 Evaluation Kit
4####################
5
6Overview
7********
8
9The Renesas RA6M5 group uses the high-performance Arm® Cortex®-M33 core with
10TrustZone®. The RA6M5 is suitable for IoT applications requiring Ethernet, future
11proof security, large embedded RAM, and low active power consumption down
12to 107uA/MHz running the CoreMark® algorithm from Flash.
13
14The key features of the EK-RA6M5 board are categorized in three groups as follow:
15
16**MCU Native Pin Access**
17
18- 200MHz Arm Cortex-M33 based RA6M5 MCU in 176 pins, LQFP package
19- Native pin access through 4 x 40-pin male headers
20- MCU current measurement points for precision current consumption measurement
21- Multiple clock sources - RA6M5 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 RA6M5 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- Five most popular ecosystems expansions
48
49  - Two Seeed Grove system (I2C/Analog) connectors
50  - One SparkFun Qwiic connector
51  - Two Digilent Pmod (SPI and UART) connectors
52  - Arduino (Uno R3) connector
53  - MikroElektronika mikroBUS connector
54
55- MCU boot configuration jumper
56
57**Special Feature Access**
58
59- Ethernet (RJ45 RMII interface)
60- USB High Speed Host and Device (micro-AB connector)
61- 32 Mb (256 Mb) External Quad-SPI Flash
62- 64 Mb (512 Mb) External Octo-SPI Flash
63- CAN (3-pin header)
64
65.. figure:: ek_ra6m5.webp
66	:align: center
67	:alt: RA6M5 Evaluation Kit
68
69	EK-RA6M5 Board Functional Area Definitions (Credit: Renesas Electronics Corporation)
70
71Hardware
72********
73Detailed hardware feature for the RA6M5 MCU group can be found at `RA6M5 Group User's Manual Hardware`_
74
75.. figure:: ra6m5_block_diagram.webp
76	:width: 442px
77	:align: center
78	:alt: RA6M5 MCU group feature
79
80	RA6M5 Block diagram (Credit: Renesas Electronics Corporation)
81
82Detailed hardware feature for the EK-RA6M5 MCU can be found at `EK-RA6M5 - User's Manual`_
83
84Supported Features
85==================
86
87The below features are currently supported on Zephyr OS for EK-RA6M5 board:
88
89+-----------+------------+----------------------+
90| Interface | Controller | Driver/Component     |
91+===========+============+======================+
92| GPIO      | on-chip    | gpio                 |
93+-----------+------------+----------------------+
94| MPU       | on-chip    | arch/arm             |
95+-----------+------------+----------------------+
96| NVIC      | on-chip    | arch/arm             |
97+-----------+------------+----------------------+
98| UART      | on-chip    | serial               |
99+-----------+------------+----------------------+
100| CLOCK     | on-chip    | clock control        |
101+-----------+------------+----------------------+
102| I2C       | on-chip    | i2c                  |
103+-----------+------------+----------------------+
104| SPI       | on-chip    | spi                  |
105+-----------+------------+----------------------+
106| COUNTER   | on-chip    | counter              |
107+-----------+------------+----------------------+
108| USBHS     | on-chip    | udc                  |
109+-----------+------------+----------------------+
110| ADC       | on-chip    | adc                  |
111+-----------+------------+----------------------+
112| PWM       | on-chip    | pwm                  |
113+-----------+------------+----------------------+
114
115Other hardware features are currently not supported by the port.
116
117Programming and Debugging
118*************************
119
120Applications for the ``ek_ra6m5`` board target configuration can be
121built, flashed, and debugged in the usual way. See
122:ref:`build_an_application` and :ref:`application_run` for more details on
123building and running.
124
125Flashing
126========
127
128Program can be flashed to EK-RA6M5 via the on-board SEGGER J-Link debugger.
129SEGGER J-link's drivers are avaialbe at https://www.segger.com/downloads/jlink/
130
131To flash the program to board
132
133  1. Connect to J-Link OB via USB port to host PC
134
135  2. Make sure J-Link OB jumper is in default configuration as describe in `EK-RA6M5 - User's Manual`_
136
137  3. Execute west command
138
139	.. code-block:: console
140
141		west flash -r jlink
142
143Debugging
144=========
145
146You can use Segger Ozone (`Segger Ozone Download`_) for a visual debug interface
147
148Once downloaded and installed, open Segger Ozone and configure the debug project
149like so:
150
151* Target Device: R7FA6M5BH
152* Target Interface: SWD
153* Target Interface Speed: 4 MHz
154* Host Interface: USB
155* Program File: <path/to/your/build/zephyr.elf>
156
157**Note:** It's verified that we can debug OK on Segger Ozone v3.30d so please use this or later
158version of Segger Ozone
159
160References
161**********
162- `EK-RA6M5 Website`_
163- `RA6M5 MCU group Website`_
164
165.. _EK-RA6M5 Website:
166   https://www.renesas.com/us/en/products/microcontrollers-microprocessors/ra-cortex-m-mcus/ek-ra6m5-evaluation-kit-ra6m5-mcu-group
167
168.. _RA6M5 MCU group Website:
169   https://www.renesas.com/us/en/products/microcontrollers-microprocessors/ra-cortex-m-mcus/ra6m5-200mhz-arm-cortex-m33-trustzone-highest-integration-ethernet-and-can-fd
170
171.. _EK-RA6M5 - User's Manual:
172   https://www.renesas.com/us/en/document/man/ek-ra6m5-v1-users-manual
173
174.. _RA6M5 Group User's Manual Hardware:
175   https://www.renesas.com/us/en/document/man/ra6m5-group-users-manual-hardware
176
177.. _Segger Ozone Download:
178   https://www.segger.com/downloads/jlink#Ozone
179