boards: shields: add support for rtk0eg0019b01002bj

boards/renesas/ek_ra2a1/Kconfig.defconfig

@@ -0,0 +1,9 @@
+# Copyright (c) 2025 Renesas Electronics Corporation
+# SPDX-License-Identifier: Apache-2.0
+
+if !INPUT_RENESAS_RA_QE_TOUCH_CFG
+
+config INPUT_RENESAS_RA_CTSU_NUM_SELF_ELEMENTS
+	default 1
+
+endif # INPUT_RENESAS_RA_QE_TOUCH_CFG

boards/renesas/ek_ra2a1/ek_ra2a1-pinctrl.dtsi

@@ -51,4 +51,12 @@
 			renesas,analog-enable;
 		};
 	};
+
+	ctsu_default: ctsu_default {
+		group1 {
+			/* TS01 TSCAP */
+			psels = <RA_PSEL(RA_PSEL_CTSU, 0, 1)>,
+				<RA_PSEL(RA_PSEL_CTSU, 4, 9)>;
+		};
+	};
 };

boards/renesas/ek_ra2a1/ek_ra2a1.dts

@@ -83,6 +83,10 @@
 	status = "okay";
 };
 
+&ioport4 {
+	status = "okay";
+};
+
 &port_irq6 {
 	interrupts = <29 3>;
 	status = "okay";
@@ -120,3 +124,40 @@
 &wdt {
 	status = "okay";
 };
+
+&ctsu {
+	pinctrl-0 = <&ctsu_default>;
+	pinctrl-names = "default";
+	interrupts = <10 3>, <11 3>, <12 3>;
+	interrupt-names = "ctsuwr", "ctsurd", "ctsufn";
+	clock-div = <1>;
+	pwr-supply-sel = "vcc";
+	atune1 = "normal";
+	measure-mode = "self-multi-scan";
+	tscap-gpios = <&ioport4 9 0>;
+	status = "okay";
+
+	group1 {
+		ctsuchac = <0x00>, <0x80>, <0x00>, <0x00>, <0x00>;
+		ctsuchtrc = <0x00>, <0x00>, <0x00>, <0x00>, <0x00>;
+		rx-count = <1>;
+		tx-count = <0>;
+		ssdiv = "1.00";
+		so = <0x108>;
+		snum = <0x01>;
+		sdpa = <0x0B>;
+		on-freq = <3>;
+		off-freq = <3>;
+		drift-freq = <255>;
+		cancel-freq = <0>;
+		num-moving-avg = <4>;
+
+		ts1: button1 {
+			compatible = "renesas,ra-ctsu-button";
+			event-code = <INPUT_KEY_1>;
+			elements = <0>;
+			threshold = <2305>;
+			hysteresis = <115>;
+		};
+	};
+};

boards/renesas/rssk_ra2l1/Kconfig.rssk_ra2l1

@@ -0,0 +1,5 @@
+# Copyright (c) 2025 Renesas Electronics Corporation
+# SPDX-License-Identifier: Apache-2.0
+
+config BOARD_RSSK_RA2L1
+	select SOC_R7FA2L1ABXXFP

boards/renesas/rssk_ra2l1/board.cmake

@@ -0,0 +1,8 @@
+# Copyright (c) 2025 Renesas Electronics Corporation
+# SPDX-License-Identifier: Apache-2.0
+
+board_runner_args(jlink "--device=r7fa2l1ab")
+board_runner_args(pyocd "--target=r7fa2l1ab")
+
+include(${ZEPHYR_BASE}/boards/common/jlink.board.cmake)
+include(${ZEPHYR_BASE}/boards/common/pyocd.board.cmake)

boards/renesas/rssk_ra2l1/board.yml

@@ -0,0 +1,6 @@
+board:
+  name: rssk_ra2l1
+  full_name: Capacitive Touch Evaluation System for RA2L1
+  vendor: renesas
+  socs:
+  - name: r7fa2l1abxxfp

boards/renesas/rssk_ra2l1/doc/index.rst

@@ -0,0 +1,142 @@
+.. zephyr:board:: rssk_ra2l1
+
+Overview
+********
+
+The RA2L1 MCU Group Capacitive Touch Evaluation System (RTK0EG0022S01001BJ) is a
+kit created for evaluating the RA2L1 MCU Group Capacitive Touch Sensing Unit (CTSU).
+
+RTK0EG0022S01001BJ is composed of two boards: The RA2L1 Cap Touch CPU Board is mounted with an
+RA2L1 MCU which includes an on-chip CTSU. The Capacitive Touch Application Board Capacitive Touch
+Application Board is equipped with self-capacitance touch buttons, wheel and slider electrodes, and LEDs
+touch electrodes.
+
+Renesas RA2L1 Microcontroller Group has following features
+
+- 48MHz, Arm Cortex-M23 core
+- 256kB or 128kB Code Flash, 8kB Data Flash, 32kB SRAM (divided on 2 equal areas
+  with- and without- ECC support)
+- SCI x 5
+- SPI x 2
+- I2C x 2
+- CAN x 1
+- 12-bit A/D Converter
+- 12-bit D/A Converter
+- Low-Power Analog Comparator x 2
+- Temperature Sensor
+- General PWM Timer 32-bit x 4
+- General PWM Timer 16-bit x 6
+- Low Power Asynchronous General-Purpose Timer x 2
+- Watchdog Timer (WDT)
+- Independent Watchdog Timer (IWDT)
+- Up to 85 Input/Output pins (depends on the package type)
+
+Hardware
+********
+
+The main functions of the RA2L1 Cap Touch CPU board are as follows:
+
+- Renesas RA2L1 MCU Group
+
+   - R7FA2L1AB2DFP
+   - 100-pin LFQFP package
+   - 48MHz Arm Cortex®-M23 Core with built-in Arm® MPU (Armv8-M architecture)
+   - 32KB SRAM
+   - 256KB code flash memory
+   - 8KB data flash memory
+   - 32-channel capacitive touch sensing unit (CTSU) pins
+
+- Connectivity
+
+   - USB serial conversion interface (FT234XD manufactured by FTDI)
+   - 10-pin JTAG/SWD interface for connecting external debugger or programmer (option)
+   - Application board GPIO interface: 2.54mm pitch, 16 pins (8 x 2 DIL)
+   - Application board CTSU interface: 2.54mm pitch, 40 pins (20 x 2 DIL)
+
+- Other functions
+
+   - MCU current measurement jumper
+   - User push button switches: 2
+   - User LEDs: 2
+
+.. figure:: rtk0eg0018c01001bj.webp
+   :width: 300
+   :align: center
+
+   RA2L1 Cap Touch CPU Board (Credit: Renesas Electronics Corporation)
+
+Key functions of the Capacitive Touch Application Board are as follows:
+
+- Self-capacitance detection touch electrodes
+
+   - Buttons: 3
+   - Wheel (4-electrode configuration): 1
+   - Slider (5-electrode configuration): 1
+
+- LEDs: 16
+
+Supported Features
+==================
+
+.. zephyr:board-supported-hw::
+
+Programming and debugging
+*************************
+
+Building & Flashing
+===================
+
+You can build and flash an application with an external J-Link debug adapter connect to
+J1 connector.
+:ref:`build_an_application` and
+:ref:`application_run` for more details.
+
+Here is an example for building and flashing the :zephyr:code-sample:`blinky` application.
+
+.. zephyr-app-commands::
+   :zephyr-app: samples/basic/blinky
+   :board: rssk_ra2l1
+   :goals: build flash
+
+
+Debugging
+=========
+
+Debugging also can be done with an external J-Link debug adapter connected to
+J1 connector.
+For the debug log output through UART console, you need to connect a USB cable
+from the host PC to the USB Serial Conversion on CN5.
+The following command is debugging the :zephyr:code-sample:`blinky` application.
+Also, see the instructions specific to the debug server that you use.
+
+.. zephyr-app-commands::
+   :zephyr-app: samples/basic/blinky
+   :board: rssk_ra2l1
+   :maybe-skip-config:
+   :goals: debug
+
+Or 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: R7FA2L1AB
+* Target Interface: SWD
+* Target Interface Speed: 4 MHz
+* Host Interface: USB
+* Program File: <path/to/your/build/zephyr.elf>
+
+
+References
+**********
+- `RSSK-RA2L1 Web site`_
+- `RA2L1 MCU Group Website`_
+
+.. _RSSK-RA2L1 Web site:
+   https://www.renesas.com/en/products/microcontrollers-microprocessors/ra-cortex-m-mcus/rtk0eg0022s01001bj-capacitive-touch-evaluation-system-ra2l1
+
+.. _RA2L1 MCU Group Website:
+   https://www.renesas.com/en/products/microcontrollers-microprocessors/ra-cortex-m-mcus/ra2l1-48mhz-arm-cortex-m23-ultra-low-power-general-purpose-microcontroller
+
+.. _Segger Ozone Download:
+   https://www.segger.com/downloads/jlink#Ozone

boards/renesas/rssk_ra2l1/rssk_ra2l1-pinctrl.dtsi

@@ -0,0 +1,36 @@
+/*
+ * Copyright (c) 2025 Renesas Electronics Corporation
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+&pinctrl {
+	sci9_default: sci9_default {
+		group1 {
+			/* TXD RXD */
+			psels = <RA_PSEL(RA_PSEL_SCI_9, 2, 3)>,
+				<RA_PSEL(RA_PSEL_SCI_9, 2, 2)>;
+		};
+	};
+
+	ctsu_default: ctsu_default {
+		group1 {
+			psels = <RA_PSEL(RA_PSEL_CTSU, 1, 10)>,
+				<RA_PSEL(RA_PSEL_CTSU, 1, 9)>,
+				<RA_PSEL(RA_PSEL_CTSU, 3, 1)>,
+				<RA_PSEL(RA_PSEL_CTSU, 2, 4)>,
+				<RA_PSEL(RA_PSEL_CTSU, 4, 2)>,
+				<RA_PSEL(RA_PSEL_CTSU, 0, 0)>,
+				<RA_PSEL(RA_PSEL_CTSU, 0, 2)>,
+				<RA_PSEL(RA_PSEL_CTSU, 0, 12)>,
+				<RA_PSEL(RA_PSEL_CTSU, 1, 3)>,
+				<RA_PSEL(RA_PSEL_CTSU, 3, 3)>,
+				<RA_PSEL(RA_PSEL_CTSU, 4, 8)>,
+				<RA_PSEL(RA_PSEL_CTSU, 4, 9)>,
+				<RA_PSEL(RA_PSEL_CTSU, 4, 10)>,
+				<RA_PSEL(RA_PSEL_CTSU, 4, 11)>,
+				<RA_PSEL(RA_PSEL_CTSU, 3, 2)>,
+				<RA_PSEL(RA_PSEL_CTSU, 1, 12)>;
+		};
+	};
+};