boards/renesas/ek_ra8d1/doc/index.rst
.. zephyr:board:: ek_ra8d1
Overview
The EK-RA8D1 is an Evaluation Kit for Renesas RA8D1 MCU Group which are the industry’s first 32-bit graphics-enabled MCUs based on the Arm Cortex-M85 (CM85) core, delivering breakthrough performance of over 3000 Coremark points at 480 MHz and superior graphics capabilities that enable high-resolution displays and Vision AI applications.
The key features of the EK-RA8D1 board are categorized in three groups as follow:
MCU Native Pin Access
System Control and Ecosystem Access
USB Full Speed Host and Device (micro-AB connector)
Four 5V input sources
Three Debug modes
User LEDs and buttons
Five most popular ecosystems expansions
MCU boot configuration jumper
Special Feature Access
Hardware
Detailed Hardware features for the RA8D1 MCU group can be found at RA8D1 Group User's Manual Hardware_
.. figure:: ra8d1_block_diagram.png :width: 442px :align: center :alt: RA8D1 MCU group feature
RA8D1 Block diagram (Credit: Renesas Electronics Corporation)
Detailed Hardware features for the EK-RA8D1 MCU can be found at EK-RA8D1 - User's Manual_
.. zephyr:board-supported-hw::
.. note::
For using Ethernet on RA8D1 board please set switch SW1 as following configuration:
+-------------+-------------+--------------+------------+------------+------------+-------------+-----------+ | SW1-1 PMOD1 | SW1-2 TRACE | SW1-3 CAMERA | SW1-4 ETHA | SW1-5 ETHB | SW1-6 GLCD | SW1-7 SDRAM | SW1-8 I3C | +-------------+-------------+--------------+------------+------------+------------+-------------+-----------+ | OFF | OFF | OFF | OFF | ON | OFF | OFF | OFF | +-------------+-------------+--------------+------------+------------+------------+-------------+-----------+
For using SDHC channel 1 on RA8D1 board please set switch SW1 as following configuration:
+-------------+-------------+--------------+------------+------------+------------+-------------+-----------+ | SW1-1 PMOD1 | SW1-2 TRACE | SW1-3 CAMERA | SW1-4 ETHA | SW1-5 ETHB | SW1-6 GLCD | SW1-7 SDRAM | SW1-8 I3C | +-------------+-------------+--------------+------------+------------+------------+-------------+-----------+ | OFF | OFF | OFF | OFF | OFF | OFF | OFF | OFF | +-------------+-------------+--------------+------------+------------+------------+-------------+-----------+
For using MIPI Graphics Expansion Port (J58) on RA8D1 board please set switch SW1 as following configuration:
+-------------+-------------+--------------+------------+------------+------------+-------------+-----------+ | SW1-1 PMOD1 | SW1-2 TRACE | SW1-3 CAMERA | SW1-4 ETHA | SW1-5 ETHB | SW1-6 GLCD | SW1-7 SDRAM | SW1-8 I3C | +-------------+-------------+--------------+------------+------------+------------+-------------+-----------+ | OFF | OFF | OFF | OFF | OFF | ON | ON | OFF | +-------------+-------------+--------------+------------+------------+------------+-------------+-----------+
For using the Parallel Graphics Expansion Port (J57), please set switch SW1 to the following configuration:
+-------------+-------------+--------------+------------+------------+------------+-------------+-----------+ | SW1-1 PMOD1 | SW1-2 TRACE | SW1-3 CAMERA | SW1-4 ETHA | SW1-5 ETHB | SW1-6 GLCD | SW1-7 SDRAM | SW1-8 I3C | +-------------+-------------+--------------+------------+------------+------------+-------------+-----------+ | OFF | OFF | OFF | OFF | OFF | ON | ON | OFF | +-------------+-------------+--------------+------------+------------+------------+-------------+-----------+
For using I3C on RA8D1 board please set switch SW1 as following configuration:
+-------------+-------------+--------------+------------+------------+------------+-------------+-----------+ | SW1-1 PMOD1 | SW1-2 TRACE | SW1-3 CAMERA | SW1-4 ETHA | SW1-5 ETHB | SW1-6 GLCD | SW1-7 SDRAM | SW1-8 I3C | +-------------+-------------+--------------+------------+------------+------------+-------------+-----------+ | OFF | OFF | OFF | OFF | OFF | OFF | OFF | ON | +-------------+-------------+--------------+------------+------------+------------+-------------+-----------+
For using the Camera Expansion Port (J59) with the Camera, please set switch SW1 as following configuration:
+-------------+-------------+--------------+------------+------------+------------+-------------+-----------+ | SW1-1 PMOD1 | SW1-2 TRACE | SW1-3 CAMERA | SW1-4 ETHA | SW1-5 ETHB | SW1-6 GLCD | SW1-7 SDRAM | SW1-8 I3C | +-------------+-------------+--------------+------------+------------+------------+-------------+-----------+ | OFF | OFF | ON | OFF | OFF | OFF | ON | OFF | +-------------+-------------+--------------+------------+------------+------------+-------------+-----------+
.. warning::
Do not enable SW1-4 and SW1-5 together
Programming and Debugging
.. zephyr:board-supported-runners::
Applications for the ek_ra8d1 board configuration can be
built, flashed, and debugged in the usual way. See
:ref:build_an_application and :ref:application_run for more details on
building and running.
Note: Only support from SDK v0.16.6 in which GCC for Cortex Arm-M85 was available. To 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
Program can be flashed to EK-RA8D1 via the on-board SEGGER J-Link debugger. SEGGER J-link's drivers are available at https://www.segger.com/downloads/jlink/
To flash the program to board
Connect to J-Link OB via USB port to host PC
Make sure J-Link OB jumper is in default configuration as describe in EK-RA8D1 - User's Manual_
Execute west command
.. code-block:: console
west flash -r jlink
You can use Segger Ozone (Segger Ozone Download_) for a visual debug interface
Once downloaded and installed, open Segger Ozone and configure the debug project like so:
Note: It's verified that debug is OK on Segger Ozone v3.30d so please use this or later version of Segger Ozone
References
EK-RA8D1 Website_RA8D1 MCU group Website_.. _EK-RA8D1 Website: https://www.renesas.com/us/en/products/microcontrollers-microprocessors/ra-cortex-m-mcus/ek-ra8d1-evaluation-kit-ra8d1-mcu-group
.. _RA8D1 MCU group Website: 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
.. _EK-RA8D1 - User's Manual: https://www.renesas.com/us/en/document/mat/ek-ra8d1-v1-user-manual
.. _RA8D1 Group User's Manual Hardware: https://www.renesas.com/us/en/document/mah/ra8d1-group-users-manual-hardware
.. _Segger Ozone Download: https://www.segger.com/downloads/jlink#Ozone