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