1.. _ek_ra8d1:
2
3RA8D1 Evaluation Kit
4####################
5
6Overview
7********
8
9The EK-RA8D1 is an Evaluation Kit for Renesas RA8D1 MCU Group which are the industry’s first 32-bit
10graphics-enabled MCUs based on the Arm Cortex-M85 (CM85) core, delivering breakthrough performance
11of over 3000 Coremark points at 480 MHz and superior graphics capabilities that enable high-resolution
12displays and Vision AI applications.
13
14The key features of the EK-RA8D1 board are categorized in three groups as follow:
15
16**MCU Native Pin Access**
17
18- 480MHz Arm Cortex-M85 based RA8D1 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 - RA8D1 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 RA8D1 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-RA8D1 board)
62- CAN FD (3-pin header)
63
64.. figure:: ek_ra8d1.jpg
65	:align: center
66	:alt: RA8D1 Evaluation Kit
67
68	EK-RA8D1 Board Functional Area Definitions (Credit: Renesas Electronics Corporation)
69
70Hardware
71********
72Detail Hardware feature for the RA8D1 MCU group can be found at `RA8D1 Group User's Manual Hardware`_
73
74.. figure:: ra8d1_block_diagram.png
75	:width: 442px
76	:align: center
77	:alt: RA8D1 MCU group feature
78
79	RA8D1 Block diagram (Credit: Renesas Electronics Corporation)
80
81Detail Hardware feature for the EK-RA8D1 MCU can be found at `EK-RA8D1 - User's Manual`_
82
83Supported Features
84==================
85
86The below features are currently supported on Zephyr OS for EK-RA8D1 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| ENTROPY      | on-chip    | entropy                           |
102+--------------+------------+-----------------------------------+
103| SPI          | on-chip    | spi                               |
104+--------------+------------+-----------------------------------+
105| FLASH        | on-chip    | flash                             |
106+--------------+------------+-----------------------------------+
107| PWM          | on-chip    | pwm                               |
108+--------------+------------+-----------------------------------+
109| COUNTER      | on-chip    | counter                           |
110+--------------+------------+-----------------------------------+
111| CAN          | on-chip    | canfd                             |
112+--------------+------------+-----------------------------------+
113| I2C          | on-chip    | i2c                               |
114+--------------+------------+-----------------------------------+
115| USBHS        | on-chip    | udc                               |
116+--------------+------------+-----------------------------------+
117| DISPLAY      | on-chip    | LCDIF; MIPI-DSI. Tested with      |
118|              |            | :ref:`rtkmipilcdb00000be` shields |
119+--------------+------------+-----------------------------------+
120| ETHERNET     | on-chip    | ethernet                          |
121+--------------+------------+-----------------------------------+
122| ADC          | on-chip    | adc                               |
123+--------------+------------+-----------------------------------+
124| SDHC         | on-chip    | sdhc                              |
125+--------------+------------+-----------------------------------+
126
127**Note:**
128
129- For using Ethernet on RA8D1 board please set switch SW1 as following configuration:
130
131+-------------+-------------+--------------+------------+------------+------------+-------------+-----------+
132| SW1-1 PMOD1 | SW1-2 TRACE | SW1-3 CAMERA | SW1-4 ETHA | SW1-5 ETHB | SW1-6 GLCD | SW1-7 SDRAM | SW1-8 I3C |
133+-------------+-------------+--------------+------------+------------+------------+-------------+-----------+
134|     OFF     |      OFF    |      OFF     |     OFF    |     ON     |      OFF   |      OFF    |     OFF   |
135+-------------+-------------+--------------+------------+------------+------------+-------------+-----------+
136
137- For using SDHC channel 1 on RA8D1 board please set switch SW1 as following configuration:
138
139+-------------+-------------+--------------+------------+------------+------------+-------------+-----------+
140| SW1-1 PMOD1 | SW1-2 TRACE | SW1-3 CAMERA | SW1-4 ETHA | SW1-5 ETHB | SW1-6 GLCD | SW1-7 SDRAM | SW1-8 I3C |
141+-------------+-------------+--------------+------------+------------+------------+-------------+-----------+
142|     OFF     |      OFF    |      OFF     |     OFF    |     OFF    |      OFF   |      OFF    |     OFF   |
143+-------------+-------------+--------------+------------+------------+------------+-------------+-----------+
144
145**CAUTION:** Do not enable SW1-4 and SW1-5 together
146
147Other hardware features are currently not supported by the port.
148
149Programming and Debugging
150*************************
151
152Applications for the ``ek_ra8d1`` board configuration can be
153built, flashed, and debugged in the usual way. See
154:ref:`build_an_application` and :ref:`application_run` for more details on
155building and running.
156
157**Note:** Only support from SDK v0.16.6 in which GCC for Cortex Arm-M85 was available.
158To 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
159
160Flashing
161========
162
163Program can be flashed to EK-RA8D1 via the on-board SEGGER J-Link debugger.
164SEGGER J-link's drivers are avaialbe at https://www.segger.com/downloads/jlink/
165
166To flash the program to board
167
168  1. Connect to J-Link OB via USB port to host PC
169
170  2. Make sure J-Link OB jumper is in default configuration as describe in `EK-RA8D1 - User's Manual`_
171
172  3. Execute west command
173
174	.. code-block:: console
175
176		west flash -r jlink
177
178Debugging
179=========
180
181You can use Segger Ozone (`Segger Ozone Download`_) for a visual debug interface
182
183Once downloaded and installed, open Segger Ozone and configure the debug project
184like so:
185
186* Target Device: R7FA8D1BH
187* Target Interface: SWD
188* Target Interface Speed: 4 MHz
189* Host Interface: USB
190* Program File: <path/to/your/build/zephyr.elf>
191
192**Note:** It's verified that debug is OK on Segger Ozone v3.30d so please use this or later
193version of Segger Ozone
194
195References
196**********
197- `EK-RA8D1 Website`_
198- `RA8D1 MCU group Website`_
199
200.. _EK-RA8D1 Website:
201   https://www.renesas.com/us/en/products/microcontrollers-microprocessors/ra-cortex-m-mcus/ek-ra8d1-evaluation-kit-ra8d1-mcu-group
202
203.. _RA8D1 MCU group Website:
204   https://www.renesas.com/us/en/products/microcontrollers-microprocessors/ra-cortex-m-mcus/ra8d1-480-mhz-arm-cortex-m85-based-graphics-microcontroller-helium-and-trustzone
205
206.. _EK-RA8D1 - User's Manual:
207   https://www.renesas.com/us/en/document/mat/ek-ra8d1-v1-user-manual
208
209.. _RA8D1 Group User's Manual Hardware:
210   https://www.renesas.com/us/en/document/mah/ra8d1-group-users-manual-hardware
211
212.. _Segger Ozone Download:
213   https://www.segger.com/downloads/jlink#Ozone
214