1.. zephyr:board:: rssk_ra2l1
2
3Overview
4********
5
6The RA2L1 MCU Group Capacitive Touch Evaluation System (RTK0EG0022S01001BJ) is a
7kit created for evaluating the RA2L1 MCU Group Capacitive Touch Sensing Unit (CTSU).
8
9RTK0EG0022S01001BJ is composed of two boards: The RA2L1 Cap Touch CPU Board is mounted with an
10RA2L1 MCU which includes an on-chip CTSU. The Capacitive Touch Application Board Capacitive Touch
11Application Board is equipped with self-capacitance touch buttons, wheel and slider electrodes, and LEDs
12touch electrodes.
13
14Renesas RA2L1 Microcontroller Group has following features
15
16- 48MHz, Arm Cortex-M23 core
17- 256kB or 128kB Code Flash, 8kB Data Flash, 32kB SRAM (divided on 2 equal areas
18  with- and without- ECC support)
19- SCI x 5
20- SPI x 2
21- I2C x 2
22- CAN x 1
23- 12-bit A/D Converter
24- 12-bit D/A Converter
25- Low-Power Analog Comparator x 2
26- Temperature Sensor
27- General PWM Timer 32-bit x 4
28- General PWM Timer 16-bit x 6
29- Low Power Asynchronous General-Purpose Timer x 2
30- Watchdog Timer (WDT)
31- Independent Watchdog Timer (IWDT)
32- Up to 85 Input/Output pins (depends on the package type)
33
34Hardware
35********
36
37The main functions of the RA2L1 Cap Touch CPU board are as follows:
38
39- Renesas RA2L1 MCU Group
40
41   - R7FA2L1AB2DFP
42   - 100-pin LFQFP package
43   - 48MHz Arm Cortex®-M23 Core with built-in Arm® MPU (Armv8-M architecture)
44   - 32KB SRAM
45   - 256KB code flash memory
46   - 8KB data flash memory
47   - 32-channel capacitive touch sensing unit (CTSU) pins
48
49- Connectivity
50
51   - USB serial conversion interface (FT234XD manufactured by FTDI)
52   - 10-pin JTAG/SWD interface for connecting external debugger or programmer (option)
53   - Application board GPIO interface: 2.54mm pitch, 16 pins (8 x 2 DIL)
54   - Application board CTSU interface: 2.54mm pitch, 40 pins (20 x 2 DIL)
55
56- Other functions
57
58   - MCU current measurement jumper
59   - User push button switches: 2
60   - User LEDs: 2
61
62.. figure:: rtk0eg0018c01001bj.webp
63   :width: 300
64   :align: center
65
66   RA2L1 Cap Touch CPU Board (Credit: Renesas Electronics Corporation)
67
68Key functions of the Capacitive Touch Application Board are as follows:
69
70- Self-capacitance detection touch electrodes
71
72   - Buttons: 3
73   - Wheel (4-electrode configuration): 1
74   - Slider (5-electrode configuration): 1
75
76- LEDs: 16
77
78Supported Features
79==================
80
81.. zephyr:board-supported-hw::
82
83Programming and debugging
84*************************
85
86Building & Flashing
87===================
88
89You can build and flash an application with an external J-Link debug adapter connect to
90J1 connector.
91:ref:`build_an_application` and
92:ref:`application_run` for more details.
93
94Here is an example for building and flashing the :zephyr:code-sample:`blinky` application.
95
96.. zephyr-app-commands::
97   :zephyr-app: samples/basic/blinky
98   :board: rssk_ra2l1
99   :goals: build flash
100
101
102Debugging
103=========
104
105Debugging also can be done with an external J-Link debug adapter connected to
106J1 connector.
107For the debug log output through UART console, you need to connect a USB cable
108from the host PC to the USB Serial Conversion on CN5.
109The following command is debugging the :zephyr:code-sample:`blinky` application.
110Also, see the instructions specific to the debug server that you use.
111
112.. zephyr-app-commands::
113   :zephyr-app: samples/basic/blinky
114   :board: rssk_ra2l1
115   :maybe-skip-config:
116   :goals: debug
117
118Or you can use Segger Ozone (`Segger Ozone Download`_) for a visual debug interface
119
120Once downloaded and installed, open Segger Ozone and configure the debug project
121like so:
122
123* Target Device: R7FA2L1AB
124* Target Interface: SWD
125* Target Interface Speed: 4 MHz
126* Host Interface: USB
127* Program File: <path/to/your/build/zephyr.elf>
128
129
130References
131**********
132- `RSSK-RA2L1 Web site`_
133- `RA2L1 MCU Group Website`_
134
135.. _RSSK-RA2L1 Web site:
136   https://www.renesas.com/en/products/microcontrollers-microprocessors/ra-cortex-m-mcus/rtk0eg0022s01001bj-capacitive-touch-evaluation-system-ra2l1
137
138.. _RA2L1 MCU Group Website:
139   https://www.renesas.com/en/products/microcontrollers-microprocessors/ra-cortex-m-mcus/ra2l1-48mhz-arm-cortex-m23-ultra-low-power-general-purpose-microcontroller
140
141.. _Segger Ozone Download:
142   https://www.segger.com/downloads/jlink#Ozone
143