boards/renesas/mck_ra8t2/doc/index.rst
.. zephyr:board:: mck_ra8t2
Overview
The MCK-RA8T2 is an Motor Control Kit for Renesas RA8T2 MCU Group which integrates multiple series of software-compatible Arm®-based 32-bit cores that share a common set of Renesas peripherals to facilitate design scalability and efficient platform-based product development.
The MCU in this series incorporates a high-performance Arm® Cortex®-M85 core running up to 1 GHz and Arm® Cortex®-M33 core running up to 250 MHz with the following features:
MCK-RA8T2 kit includes the items below:
MCB-RA8T2_)MCI-LV-1_)MC-COM_)The specifications of the CPU board are shown below:
MCU specifications
A high-performance RA8T2 MCU featuring an Arm® Cortex®-M85 core running up to 1 GHz and an Arm® Cortex®-M33 core running up to 250 MHz, offered in a 289-pin BGA package.
MRAM/SRAM size: 1MB/2MB
MCU input clock: 24MHz (Generate with external crystal oscillator)
Power supply: DC 5V, select one way automatically from the below:
Connector
Onboard debugger
This product has the onboard debugger circuit, J-Link On-Board (hereinafter called “J-Link-OB”). When you write a program, open the JP3 and connect the USB connector(CN13) on CPU board to PC with USB cable. J-Link-OB operates as debugger equivalent to J-Link. If connecting from flash programming tool (e.g. J-Flash Lite by SEGGER), set the type of debugger (tool) to “J-Link”
Hardware
Detailed Hardware features for the RA8T2 MCU group can be found at:
RA8T2 Group User's Manual Hardware_MCB-RA8T2 - User's Manual_.. zephyr:board-supported-hw::
.. note::
For using SDHC module on MCK-RA8T2, Connect microSD Card to microSD Socket (CN17)
Programming and Debugging
.. zephyr:board-supported-runners::
Applications for the mck_ra8t2 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.
Here is an example for the :zephyr:code-sample:hello_world application on CM85 core.
.. zephyr-app-commands:: :zephyr-app: samples/hello_world :board: mck_ra8t2/r7ka8t2lflcac/cm85 :goals: flash
Open a serial terminal, reset the board (push the reset switch S1), and you should see the following message in the terminal:
.. code-block:: console
***** Booting Zephyr OS v4.2.0-xxx-xxxxxxxxxxxxx ***** Hello World! mck_ra8t2/r7ka8t2lflcac/cm85
Program can be flashed to MCB-RA8T2 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 MCB-RA8T2 - User's Manual_
Execute west command
.. code-block:: console
west flash -r jlink
The sysbuild makes possible to build and flash all necessary images needed to bootstrap the board.
To build the sample application using sysbuild use the command:
.. zephyr-app-commands:: :tool: west :zephyr-app: samples/hello_world :board: mck_ra8t2/r7ka8t2lflcac/cm85 :goals: build flash :west-args: --sysbuild :gen-args: -DSB_CONFIG_BOOTLOADER_MCUBOOT=y
By default, Sysbuild creates MCUboot and user application images.
Build directory structure created by sysbuild is different from traditional Zephyr build. Output is structured by the domain subdirectories:
.. code-block::
build/ ├── hello_world | └── zephyr │ ├── zephyr.elf │ ├── zephyr.hex │ ├── zephyr.bin │ ├── zephyr.signed.bin │ └── zephyr.signed.hex ├── mcuboot │ └── zephyr │ ├── zephyr.elf │ ├── zephyr.hex │ └── zephyr.bin └── domains.yaml
.. note::
With --sysbuild option, MCUboot will be rebuilt and re-flashed
every time the pristine build is used.
To only flash the user application in the subsequent builds, Use:
.. code-block:: console
$ west flash --domain hello_world
For more information about the system build please read the :ref:sysbuild documentation.
You should see the following message in the terminal:
.. code-block:: console
*** Booting MCUboot v2.2.0-171-g8513be710e5e *** *** Using Zephyr OS build v4.2.0-6156-ged85ac9ffda9 *** I: Starting bootloader I: Image index: 0, Swap type: none I: Image index: 0, Swap type: none I: Primary image: magic=unset, swap_type=0x1, copy_done=0x3, image_ok=0x3 I: Secondary image: magic=unset, swap_type=0x1, copy_done=0x3, image_ok=0x3 I: Boot source: none I: Image index: 0, Swap type: none I: Image index: 0, Swap type: none I: Image index: 0, Swap type: none I: Image index: 0, Swap type: none I: Bootloader chainload address offset: 0x10000 I: Image version: v0.0.0 I: Jumping to the first image slot *** Booting Zephyr OS build v4.2.0-6156-ged85ac9ffda9 *** Hello World! mck_ra8t2/r7ka8t2lflcac/cm85
References
MCK-RA8T2 Website_RA8T2 MCU group Website_.. _MCK-RA8T2 Website: https://www.renesas.com/en/design-resources/boards-kits/mck-ra8t2
.. _RA8T2 MCU group Website: https://www.renesas.com/en/products/ra8t2
.. _MCB-RA8T2 - User's Manual: https://www.renesas.com/en/document/mat/mcb-ra8t2-users-manual?r=25576094
.. _RA8T2 Group User's Manual Hardware: https://www.renesas.com/en/document/mah/ra8t2-group-users-manual-hardware?r=25575951
.. _MCB-RA8T2: https://www.renesas.com/en/design-resources/boards-kits/mcb-ra8t2
.. _MCI-LV-1: https://www.renesas.com/en/design-resources/boards-kits/mci-lv-1
.. _MC-COM: https://www.renesas.com/en/design-resources/boards-kits/mc-com