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