1.. zephyr:board:: mck_ra8t1 2 3Overview 4******** 5 6The **MCK-RA8T1** is a development kit that enables easy evaluation of motor control using permanent magnet synchronous 7motors (brushless DC motors). More detailed information about the features of this toolkit and it's applications can be 8found here: `MCK-RA8T1 Website`_ 9 10MCK-RA8T1 kit includes the items below: 11 12- RA8T1 CPU board (`MCB-RA8T1`_) 13- Inverter board (`MCI-LV-1`_) 14- Communication board (`MC-COM`_) 15- Permanent magnet synchronous motors 16- Accessories (cables, standoffs, etc.) 17 18.. figure:: mck_ra8t1_product_contents.jpg 19 :align: center 20 :alt: RA8T1 Motor Control Kit 21 22 MCK-RA8T1 product contents (Credit: Renesas Electronics Corporation) 23 24**MCB-RA8T1** is a CPU board for motor control equipped with RA8T1. Motor control using RA8T1 can be easily realized by 25using it in combination with a supported inverter board. The RA8T1 MCU can be evaluated using this board alone. 26 27By using a supported communication board, the CPU board can be electrically isolated from the PC for safe motor control 28evaluation and debugging. 29 30The specifications of the CPU board are shown below: 31 32**MCU specifications** 33 34- 480MHz Arm Cortex-M85 based RA8T1 MCU in 224 pins, BGA package 35- ROM/RAM size: 2MB/1MB 36- MCU input clock: 24MHz (Generate with external crystal oscillator) 37- Power supply: DC 5V, select one way automatically from the below: 38 39 - Power is supplied from compatible inverter board 40 - Power is supplied from USB connector 41 42**Connector** 43 44- Inverter board connector (2 pair) 45- USB connector for J-Link OB 46- USB connector for RA8T1 47- SCI connector for Renesas Motor Workbench communication 48- Through hole for CAN communication 49- 20 pin through hole for Arm debugger 50- Pmod connectors (Type6A + Type2A/3A) 51- Ethrnet connector 52- microSD card connector 53 54**Onboard debugger** 55 56This product has the onboard debugger circuit, J-Link On-Board (hereinafter called “J-Link-OB”). You can 57write a program (firmware) of RA8T1 with it. 58 59Hardware 60******** 61Detailed Hardware features for the RA8T1 MCU group can be found at `RA8T1 Group User's Manual Hardware`_ 62 63.. figure:: ra8t1_block_diagram.png 64 :width: 442px 65 :align: center 66 :alt: RA8T1 MCU group feature 67 68 RA8T1 Block diagram (Credit: Renesas Electronics Corporation) 69 70Detailed Hardware features for the MCB-RA8T1 board can be found at `MCB-RA8T1 - User's Manual`_ 71 72Supported Features 73================== 74 75.. zephyr:board-supported-hw:: 76 77.. note:: 78 79 For using SDHC module on EK-RA8M1, Connect microSD Card to microSD Socket (CN12) 80 81Programming and Debugging 82************************* 83 84.. zephyr:board-supported-runners:: 85 86Applications for the ``mcb_ra8t1`` board configuration can be 87built, flashed, and debugged in the usual way. See 88:ref:`build_an_application` and :ref:`application_run` for more details on 89building and running. 90 91**Note:** Only support from SDK v0.16.6 in which GCC for Cortex Arm-M85 was available. 92To 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 93 94Flashing 95======== 96 97Program can be flashed to MCB-RA8T1 via the on-board SEGGER J-Link debugger. 98SEGGER J-link's drivers are available at https://www.segger.com/downloads/jlink/ 99 100To flash the program to board 101 1021. Connect to J-Link OB via USB port to host PC 103 1042. Make sure J-Link OB jumper is in default configuration as describe in `MCB-RA8T1 - User's Manual`_ 105 1063. Execute west command 107 108 .. code-block:: console 109 110 west flash -r jlink 111 112Debugging 113========= 114 115You can use Segger Ozone (`Segger Ozone Download`_) for a visual debug interface 116 117Once downloaded and installed, open Segger Ozone and configure the debug project 118like so: 119 120* Target Device: R7FA8T1AH 121* Target Interface: SWD 122* Target Interface Speed: 4 MHz 123* Host Interface: USB 124* Program File: <path/to/your/build/zephyr.elf> 125 126**Note:** It's verified that debug is OK on Segger Ozone v3.30d so please use this or later 127version of Segger Ozone 128 129References 130********** 131- `MCB-RA8T1 Website`_ 132- `RA8T1 MCU group Website`_ 133 134.. _MCB-RA8T1 Website: 135 https://www.renesas.com/us/en/products/microcontrollers-microprocessors/ra-cortex-m-mcus/rtk0ema5k0c00000bj-mcb-ra8t1-cpu-board-ra8t1-mcu-group 136 137.. _RA8T1 MCU group Website: 138 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 139 140.. _MCB-RA8T1 - User's Manual: 141 https://www.renesas.com/us/en/document/mat/mcb-ra8t1-users-manual?r=25466356 142 143.. _RA8T1 Group User's Manual Hardware: 144 https://www.renesas.com/us/en/document/mah/ra8t1-group-users-manual-hardware?r=25463106 145 146.. _Segger Ozone Download: 147 https://www.segger.com/downloads/jlink#Ozone 148 149.. _MCK-RA8T1 Website: 150 https://www.renesas.com/us/en/products/microcontrollers-microprocessors/ra-cortex-m-mcus/rtk0ema5k0s00020bj-mck-ra8t1-renesas-flexible-motor-control-kit-ra8t1-mcu-group 151 152.. _MCB-RA8T1: 153 https://www.renesas.com/us/en/products/microcontrollers-microprocessors/ra-cortex-m-mcus/rtk0ema5k0c00000bj-mcb-ra8t1-cpu-board-ra8t1-mcu-group 154 155.. _MCI-LV-1: 156 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 157 158.. _MC-COM: 159 https://www.renesas.com/us/en/products/microcontrollers-microprocessors/rx-32-bit-performance-efficiency-mcus/rtk0emxc90s00000bj-mc-com-renesas-flexible-motor-control-communication-board 160