1.. _ek_ra8m1:
2
3RA8M1 Evaluation Kit
4####################
5
6Overview
7********
8
9The EK-RA8M1 is an Evaluation Kit for Renesas RA8M1 MCU Group which is the first
1032-bits MCUs based on new Arm Cortex-M85. The kit offer multiple external interface
11and peripherals set optimized on board allows user to seamlessly evaluate the features
12of the RA8M1 MCU and develop embedded system application in various field.
13
14The key features of the EK-RA8M1 board are categorized in three groups as follow:
15
16**MCU Native Pin Access**
17
18- 480MHz Arm Cortex-M85 based RA8M1 MCU in 224 pins, BGA package
19- Native pin acces througgh 2 x 50-pin, and 2 x 40-pin male headers
20- MCU current measurement points for precision current consumption measurement
21- Multiple clock sources - RA8M1 MCU oscillator and sub-clock oscillator crystals,
22  providing precision 20.000MHz and 32,768 Hz refeence clocks.
23  Additional low precision clocks are avaialbe internal to the RA8M1 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/I3C) connectors
50  - One SparkFun Qwiic connector
51  - Two Digilent Pmod (SPI, UART and I2C/I3C) 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- 512 Mb (64 MB) External Octo-SPI Flash (present in the MCU Native Pin Access area of the EK-RA8M1 board)
62- CAN FD (3-pin header)
63
64.. figure:: ek_ra8m1.jpg
65	:align: center
66	:alt: RA8M1 Evaluation Kit
67
68	EK-RA8M1 Board Functional Area Definitions (Credit: Renesas Electronics Corporation)
69
70Hardware
71********
72Detail Hardware feature for the RA8M1 MCU group can be found at `RA8M1 Group User's Manual Hardware`_
73
74.. figure:: ra8m1_block_diagram.jpg
75	:width: 442px
76	:align: center
77	:alt: RA8M1 MCU group feature
78
79	RA8M1 Block diagram (Credit: Renesas Electronics Corporation)
80
81Detail Hardware feature for the EK-RA8M1 MCU can be found at `EK-RA8M1 - User's Manual`_
82
83Supported Features
84==================
85
86The below features are currently supported on Zephyr OS for EK-RA8M1 board:
87
88+-----------+------------+----------------------+
89| Interface | Controller | Driver/Component     |
90+===========+============+======================+
91| GPIO      | on-chip    | gpio                 |
92+-----------+------------+----------------------+
93| MPU       | on-chip    | arch/arm             |
94+-----------+------------+----------------------+
95| NVIC      | on-chip    | arch/arm             |
96+-----------+------------+----------------------+
97| UART      | on-chip    | serial               |
98+-----------+------------+----------------------+
99| CLOCK     | on-chip    | clock control        |
100+-----------+------------+----------------------+
101| I2C       | on-chip    | i2c                  |
102+-----------+------------+----------------------+
103| ENTROPY   | on-chip    | entropy              |
104+-----------+------------+----------------------+
105| SPI       | on-chip    | spi                  |
106+-----------+------------+----------------------+
107| FLASH     | on-chip    | flash                |
108+-----------+------------+----------------------+
109| PWM       | on-chip    | pwm                  |
110+-----------+------------+----------------------+
111| COUNTER   | on-chip    | counter              |
112+-----------+------------+----------------------+
113| CAN       | on-chip    | canfd                |
114+-----------+------------+----------------------+
115| USBHS     | on-chip    | udc                  |
116+-----------+------------+----------------------+
117| ETHERNET  | on-chip    | ethernet             |
118+-----------+------------+----------------------+
119| ADC       | on-chip    | adc                  |
120+-----------+------------+----------------------+
121| SDHC      | on-chip    | sdhc                 |
122+-----------+------------+----------------------+
123
124**Note:**
125
126- For using Ethernet module on EK-RA8M1, remove jumper J61 to enable Ethernet B
127- For using SDHC driver on EK-RA8M1, remove jumper J61 to use with channel 0
128
129Other hardware features are currently not supported by the port.
130
131Programming and Debugging
132*************************
133
134Applications for the ``ek_ra8m1`` board configuration can be
135built, flashed, and debugged in the usual way. See
136:ref:`build_an_application` and :ref:`application_run` for more details on
137building and running.
138
139**Note:** Only support from SDK v0.16.6 in which GCC for Cortex Arm-M85 was available.
140To build for EK-RA8M1 user need to get and install GNU Arm Embedded toolchain from https://github.com/zephyrproject-rtos/sdk-ng/releases/tag/v0.16.6
141
142Flashing
143========
144
145Program can be flashed to EK-RA8M1 via the on-board SEGGER J-Link debugger.
146SEGGER J-link's drivers are avaialbe at https://www.segger.com/downloads/jlink/
147
148To flash the program to board
149
150  1. Connect to J-Link OB via USB port to host PC
151
152  2. Make sure J-Link OB jumper is in default configuration as describe in `EK-RA8M1 - User's Manual`_
153
154  3. Execute west command
155
156	.. code-block:: console
157
158		west flash -r jlink
159
160Debugging
161=========
162
163You can use Segger Ozone (`Segger Ozone Download`_) for a visual debug interface
164
165Once downloaded and installed, open Segger Ozone and configure the debug project
166like so:
167
168* Target Device: R7FA8M1AH
169* Target Interface: SWD
170* Target Interface Speed: 4 MHz
171* Host Interface: USB
172* Program File: <path/to/your/build/zephyr.elf>
173
174**Note:** It's verified that we can debug OK on Segger Ozone v3.30d so please use this or later
175version of Segger Ozone
176
177References
178**********
179- `EK-RA8M1 Website`_
180- `RA8M1 MCU group Website`_
181
182.. _EK-RA8M1 Website:
183   https://www.renesas.com/us/en/products/microcontrollers-microprocessors/ra-cortex-m-mcus/ek-ra8m1-evaluation-kit-ra8m1-mcu-group
184
185.. _RA8M1 MCU group Website:
186   https://www.renesas.com/us/en/products/microcontrollers-microprocessors/ra-cortex-m-mcus/ra8m1-480-mhz-arm-cortex-m85-based-microcontroller-helium-and-trustzone
187
188.. _EK-RA8M1 - User's Manual:
189   https://www.renesas.com/us/en/document/mat/ek-ra8m1-users-manual
190
191.. _RA8M1 Group User's Manual Hardware:
192   https://www.renesas.com/us/en/document/mah/ra8m1-group-users-manual-hardware
193
194.. _Segger Ozone Download:
195   https://www.segger.com/downloads/jlink#Ozone
196
197.. _zephyr-sdk-0.16.5-6-ge895c4e_linux-x86_64:
198   https://github.com/zephyrproject-rtos/sdk-ng/suites/22342313531/artifacts/1379111922
199