.. zephyr:board:: mck_ra8t1

Overview
********

The **MCK-RA8T1** is a development kit that enables easy evaluation of motor control using permanent magnet synchronous
motors (brushless DC motors). More detailed information about the features of this toolkit and it's applications can be
found here: `MCK-RA8T1 Website`_

MCK-RA8T1 kit includes the items below:

- RA8T1 CPU board (`MCB-RA8T1`_)
- Inverter board (`MCI-LV-1`_)
- Communication board (`MC-COM`_)
- Permanent magnet synchronous motors
- Accessories (cables, standoffs, etc.)

.. figure:: mck_ra8t1_product_contents.jpg
	:align: center
	:alt: RA8T1 Motor Control Kit

	MCK-RA8T1 product contents (Credit: Renesas Electronics Corporation)

**MCB-RA8T1** is a CPU board for motor control equipped with RA8T1. Motor control using RA8T1 can be easily realized by
using it in combination with a supported inverter board. The RA8T1 MCU can be evaluated using this board alone.

By using a supported communication board, the CPU board can be electrically isolated from the PC for safe motor control
evaluation and debugging.

The specifications of the CPU board are shown below:

**MCU specifications**

- 480MHz Arm Cortex-M85 based RA8T1 MCU in 224 pins, BGA package
- ROM/RAM size: 2MB/1MB
- MCU input clock: 24MHz (Generate with external crystal oscillator)
- Power supply: DC 5V, select one way automatically from the below:

  - Power is supplied from compatible inverter board
  - Power is supplied from USB connector

**Connector**

- Inverter board connector (2 pair)
- USB connector for J-Link OB
- USB connector for RA8T1
- SCI connector for Renesas Motor Workbench communication
- Through hole for CAN communication
- 20 pin through hole for Arm debugger
- Pmod connectors (Type6A + Type2A/3A)
- Ethrnet connector
- microSD card connector

**Onboard debugger**

This product has the onboard debugger circuit, J-Link On-Board (hereinafter called “J-Link-OB”). You can
write a program (firmware) of RA8T1 with it.

Hardware
********
Detailed Hardware features for the RA8T1 MCU group can be found at `RA8T1 Group User's Manual Hardware`_

.. figure:: ra8t1_block_diagram.png
	:width: 442px
	:align: center
	:alt: RA8T1 MCU group feature

	RA8T1 Block diagram (Credit: Renesas Electronics Corporation)

Detailed Hardware features for the  MCB-RA8T1 board can be found at `MCB-RA8T1 - User's Manual`_

Supported Features
==================

.. zephyr:board-supported-hw::

.. note::

   For using SDHC module on EK-RA8M1, Connect microSD Card to microSD Socket (CN12)

Programming and Debugging
*************************

.. zephyr:board-supported-runners::

Applications for the ``mcb_ra8t1`` 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

Flashing
========

Program can be flashed to MCB-RA8T1 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

1. Connect to J-Link OB via USB port to host PC

2. Make sure J-Link OB jumper is in default configuration as describe in `MCB-RA8T1 - User's Manual`_

3. Execute west command

	.. code-block:: console

		west flash -r jlink

Debugging
=========

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:

* Target Device: R7FA8T1AH
* Target Interface: SWD
* Target Interface Speed: 4 MHz
* Host Interface: USB
* Program File: <path/to/your/build/zephyr.elf>

**Note:** It's verified that debug is OK on Segger Ozone v3.30d so please use this or later
version of Segger Ozone

References
**********
- `MCB-RA8T1 Website`_
- `RA8T1 MCU group Website`_

.. _MCB-RA8T1 Website:
   https://www.renesas.com/us/en/products/microcontrollers-microprocessors/ra-cortex-m-mcus/rtk0ema5k0c00000bj-mcb-ra8t1-cpu-board-ra8t1-mcu-group

.. _RA8T1 MCU group Website:
   https://www.renesas.com/us/en/products/microcontrollers-microprocessors/ra-cortex-m-mcus/ra8t1-480-mhz-arm-cortex-m85-based-motor-control-microcontroller-helium-and-trustzone

.. _MCB-RA8T1 - User's Manual:
   https://www.renesas.com/us/en/document/mat/mcb-ra8t1-users-manual?r=25466356

.. _RA8T1 Group User's Manual Hardware:
   https://www.renesas.com/us/en/document/mah/ra8t1-group-users-manual-hardware?r=25463106

.. _Segger Ozone Download:
   https://www.segger.com/downloads/jlink#Ozone

.. _MCK-RA8T1 Website:
	 https://www.renesas.com/us/en/products/microcontrollers-microprocessors/ra-cortex-m-mcus/rtk0ema5k0s00020bj-mck-ra8t1-renesas-flexible-motor-control-kit-ra8t1-mcu-group

.. _MCB-RA8T1:
   https://www.renesas.com/us/en/products/microcontrollers-microprocessors/ra-cortex-m-mcus/rtk0ema5k0c00000bj-mcb-ra8t1-cpu-board-ra8t1-mcu-group

.. _MCI-LV-1:
   https://www.renesas.com/us/en/products/power-power-management/fet-motor-drivers/rtk0em0000s04020bj-mci-lv-1-renesas-flexible-motor-control-inverter-board-low-voltage-48v10a-three-phase-bldcpmsm-motor

.. _MC-COM:
   https://www.renesas.com/us/en/products/microcontrollers-microprocessors/rx-32-bit-performance-efficiency-mcus/rtk0emxc90s00000bj-mc-com-renesas-flexible-motor-control-communication-board
