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