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