1.. _ek_ra4e2:
2
3RA4E2 Evaluation Kit
4####################
5
6Overview
7********
8
9The RA4E2 Group delivers up to 100 MHz of CPU performance using an Arm® Cortex®-M33 core
10with 128 KB of code flash memory, 4 KB of data flash memory, and 40 KB of SRAM. RA4E2 MCUs
11offer high-performance and optimized peripheral functions along with the smallest package
12options, including space-saving 36-pin BGA and 32-pin QFN packages. The RA4E2
13Group offers a wide set of peripherals, including USB Full Speed, CANFD, I3C, and ADC.
14
15The MCU in this series incorporates a high-performance Arm Cortex®-M33 core running up to
16100 MHz with the following features:
17
18**MCU Native Pin Access**
19- R7FA4E2B93CFM MCU (referred to as RA MCU)
20- 100 MHz, Arm® Cortex®-M33 core
21- 128 kB Code Flash, 40 kB SRAM
22- 64 pins, LQFP package
23- Native pin access through 2 x 14-pin and 1 x 40-pin male headers
24- MCU current measurement points for precision current consumption measurement
25- Multiple clock sources - RA MCU oscillator and sub-clock oscillator crystals, providing precision
2620.000 MHz and 32,768 Hz reference clock. Additional low-precision clocks are available internal to the
27RA MCU
28
29**System Control and Ecosystem Access**
30- USB Full Speed Device (micro-AB connector)
31- Three 5 V input sources
32
33	- USB (Debug, Full Speed)
34	- External power supply (using surface mount clamp test points and J31 through holes)
35
36- Three Debug modes
37
38	- Debug on-board (SWD)
39	- Debug in (SWD)
40	- Debug out (JTAG, SWD)
41
42- User LEDs and buttons
43
44	- Three User LEDs (red, blue, green)
45	- Power LED (white) indicating availability of regulated power
46	- Debug LED (yellow) indicating the debug connection
47	- Two User buttons
48	- One Reset button
49
50- Five most popular ecosystems expansions
51
52	- 2 Seeed Grove® system (I3C/Analog) connectors
53	- SparkFun® Qwiic® connector
54	- 2 Digilent PmodTM (SPI and UART) connectors
55	- ArduinoTM (Uno R3) connector
56	- MikroElektronikaTM mikroBUS connector
57
58- MCU boot configuration jumper
59
60**Special Feature Access**
61
62- CAN FD (3-pin header)
63
64.. figure:: ek_ra4e2.webp
65	:align: center
66	:alt: RA4E2 Evaluation Kit
67
68	EK-RA4E2 Board Functional Area Definitions (Credit: Renesas Electronics Corporation)
69
70Hardware
71********
72Detail Hardware feature for the RA4E2 MCU group can be found at `RA4E2 Group User's Manual Hardware`_
73
74.. figure:: ra4e2_block_diagram.webp
75	:width: 442px
76	:align: center
77	:alt: RA4E2 MCU group feature
78
79	RA4E2 Block diagram (Credit: Renesas Electronics Corporation)
80
81Detail Hardware feature for the EK-RA4E2 MCU can be found at `EK-RA4E2 - User's Manual`_
82
83Supported Features
84==================
85
86The below features are currently supported on Zephyr OS for EK-RA4E2 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| SPI       | on-chip    | spi                  |
102+-----------+------------+----------------------+
103| ADC       | on-chip    | adc                  |
104+-----------+------------+----------------------+
105| PWM       | on-chip    | pwm                  |
106+-----------+------------+----------------------+
107| ENTROPY   | on-chip    | entropy              |
108+-----------+------------+----------------------+
109
110Other hardware features are currently not supported by the port.
111
112Programming and Debugging
113*************************
114
115Applications for the ``ek_ra4e2`` board target configuration can be
116built, flashed, and debugged in the usual way. See
117:ref:`build_an_application` and :ref:`application_run` for more details on
118building and running.
119
120Flashing
121========
122
123Program can be flashed to EK-RA4E2 via the on-board SEGGER J-Link debugger.
124SEGGER J-link's drivers are avaialbe at https://www.segger.com/downloads/jlink/
125
126To flash the program to board
127
128  1. Connect to J-Link OB via USB port to host PC
129
130  2. Make sure J-Link OB jumper is in default configuration as describe in `EK-RA4E2 - User's Manual`_
131
132  3. Execute west command
133
134	.. code-block:: console
135
136		west flash -r jlink
137
138Debugging
139=========
140
141You can use Segger Ozone (`Segger Ozone Download`_) for a visual debug interface
142
143Once downloaded and installed, open Segger Ozone and configure the debug project
144like so:
145
146* Target Device: R7FA4E2B9
147* Target Interface: SWD
148* Target Interface Speed: 4 MHz
149* Host Interface: USB
150* Program File: <path/to/your/build/zephyr.elf>
151
152**Note:** It's verified that we can debug OK on Segger Ozone v3.30d so please use this or later
153version of Segger Ozone
154
155References
156**********
157- `EK-RA4E2 Website`_
158- `RA4E2 MCU group Website`_
159
160.. _EK-RA4E2 Website:
161   https://www.renesas.com/us/en/products/microcontrollers-microprocessors/ra-cortex-m-mcus/ek-ra4e2-evaluation-kit-ra4e2-mcu-group
162
163.. _RA4E2 MCU group Website:
164   https://www.renesas.com/us/en/products/microcontrollers-microprocessors/ra-cortex-m-mcus/ra4e2-entry-line-100mhz-arm-cortex-m33-general-purpose-microcontroller
165
166.. _EK-RA4E2 - User's Manual:
167   https://www.renesas.com/us/en/document/mat/ek-ra4e2-v1-users-manual
168
169.. _RA4E2 Group User's Manual Hardware:
170   https://www.renesas.com/us/en/document/mah/ra4e2-group-users-manual-hardware
171
172.. _Segger Ozone Download:
173   https://www.segger.com/downloads/jlink#Ozone
174