Support Retronix Sparrow Hawk board based on Renesas R-Car V4H SoC

boards/retronix/index.rst

@@ -0,0 +1,10 @@
+.. _boards-retronix:
+
+Retronix Technology Inc
+#######################
+
+.. toctree::
+   :maxdepth: 1
+   :glob:
+
+   **/*

boards/retronix/sparrowhawk_rcar_v4h/Kconfig.defconfig

@@ -0,0 +1,5 @@
+# Copyright (c) 2025 Renesas Electronics Corporation
+# SPDX-License-Identifier: Apache-2.0
+
+config BUILD_OUTPUT_BIN
+	default y if BOARD_SPARROWHAWK_RCAR_V4H_R8A779G0_R52

boards/retronix/sparrowhawk_rcar_v4h/Kconfig.sparrowhawk_rcar_v4h

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

boards/retronix/sparrowhawk_rcar_v4h/board.cmake

@@ -0,0 +1,5 @@
+# SPDX-License-Identifier: Apache-2.0
+if(CONFIG_BOARD_SPARROWHAWK_RCAR_V4H_R8A779G0_R52)
+  board_runner_args(openocd "--use-elf")
+  include(${ZEPHYR_BASE}/boards/common/openocd.board.cmake)
+endif()

boards/retronix/sparrowhawk_rcar_v4h/board.yml

@@ -0,0 +1,6 @@
+board:
+  name: sparrowhawk_rcar_v4h
+  full_name: Sparrow Hawk R-Car V4H SBC
+  vendor: retronix
+  socs:
+  - name: r8a779g0

boards/retronix/sparrowhawk_rcar_v4h/doc/sparrow_hawk_rcar_v4h_r52.rst

@@ -0,0 +1,148 @@
+.. zephyr:board:: sparrowhawk_rcar_v4h
+
+Overview
+********
+Retronix Sparrow Hawk Single Board Computer (SBC) is powered by the latest Renesas R-Car V4H
+System-on-Chip. Sparrow Hawk focuses on robotics, industrial automation, and rapid prototyping,
+offering a highly flexible and cost-effective development platform.
+
+The R-Car V4H system-on-chip is tailored for central processing for advanced driver-assistance (ADAS)
+and automated driving (AD) systems. The R-Car V4H achieves deep learning performance of up to 34 TOPS
+(Tera Operations Per Second), enabling high-speed image recognition and processing of surrounding
+objects by automotive cameras, radar, and Light Detection and Ranging (LiDAR).
+
+Hardware
+********
+
+Hardware capabilities of the board can be found on `Retronix Sparrow Hawk`_ page.
+All the features of Renesas R-Car V4H SoC are described in the product page `Renesas R-Car V4H`_.
+
+Supported Features
+==================
+
+We support Zephyr running on Cortex R52 processor that is provided for RTOS purpose.
+
+.. zephyr:board-supported-hw::
+
+Connections and IOs
+===================
+
+For the connections and IO interfaces, refer to the official page `Retronix Sparrow Hawk`_
+
+UART
+----
+
+Here is information about serial ports provided on Sparrow Hawk board :
+
++--------------------------+--------------------+--------------------+-------------+---------------------------+
+|    Software interface    | Physical Interface | Hardware Interface | Converter   |    Usage Note             |
++==========================+====================+====================+=============+===========================+
+| /tty/USBx, COMn (lower)  | CN4 USB Port       |       HSCIF0       | FT2232H     | Used by U-Boot and Linux  |
++--------------------------+--------------------+--------------------+-------------+---------------------------+
+| /tty/USBy, COMm (higher) | CN4 USB Port       |       HSCIF1       | FT2232H     | Default for Zephyr        |
++--------------------------+--------------------+--------------------+-------------+---------------------------+
+
+.. note::
+   By default, Zephyr console output is assigned to HSCIF1 with 921600 8N1 without
+   hardware flow control.
+
+Programming and Debugging
+*************************
+
+You can build the applications as usual. This is the example for Hello World:
+
+.. zephyr-app-commands::
+   :zephyr-app: samples/hello_world
+   :board: sparrowhawk_rcar_v4h/r8a779g0/r52
+   :goals: build
+
+Configuring a Console
+=====================
+
+Connect a USB cable from your PC to CN4 USB port. There are two COM ports (or /tty/USB devices) available.
+Both of them are used for booting procedure. Use the following settings with your serial terminal of choice
+(minicom, putty, etc.):
+
+* Speed: 921600
+* Data: 8 bits
+* Parity: None
+* Stop bits: 1
+
+Flashing
+========
+
+The board does not support flashing Zephyr image. However, the image writing and loading
+can be done with U-Boot.
+
+Make sure you have already flashed the board with U-Boot, see the guideline at: `Retronix Sparrow Hawk`_,
+section "4.2.1. Flashing loader".
+Connect the terminal software to the serial port of HSCIF0 (lower /tty/USBx or COMn).
+Powerup the board by pressing SW1 switch. You would see the boot log:
+
+.. code-block:: console
+
+   U-Boot SPL 2025.07 (Aug 07 2025 - 04:02:12 +0000)
+   Trying to boot from SPI
+
+
+   U-Boot 2025.07 (Aug 07 2025 - 04:02:12 +0000)
+
+   CPU:   Renesas Electronics R8A779G0 rev 3.0
+   Model: Retronix Sparrow Hawk board based on r8a779g3
+   DRAM:  2 GiB (total 16 GiB)
+   Core:  87 devices, 23 uclasses, devicetree: separate
+   MMC:   mmc@ee140000: 0
+   Loading Environment from SPIFlash... SF: Detected w77q51nw with page size 256 Bytes, erase size 64 KiB, total 64 MiB
+   OK
+   In:    serial@e6540000
+   Out:   serial@e6540000
+   Err:   serial@e6540000
+   Net:   eth0: ethernet@e6800000
+   =>
+
+Press any key to stop the booting and continue at the U-Boot prompt.
+
+Method 1: Using TFTP to transfer Zephyr image
+
+This assumes that you have already installed a TFTP server in the host PC.
+Put the image bin file ``build/zephyr/zephyr.bin`` inside TFTP root directory. Run these
+U-Boot commands:
+
+.. code-block:: console
+
+   => setenv ipaddr <board.ip>
+   => setenv serverip <tftp.server.ip>
+   => tftp 0x40040000 zephyr.bin
+   => rproc init; rproc load 0:3 0x40040000 0x200000; rproc start 0
+
+Method 2: Using serial to transfer Zephyr image
+
+Some terminal software support transferring file via serial using Kermit protocol. Use this U-Boot commands:
+
+.. code-block:: console
+
+   => loadb 0x40040000 921600
+   ## Ready for binary (kermit) download to 0x40040000 at 921600 bps...
+   (Transfer zephyr.bin after this line)
+   ## Total Size      = 0x00009f2c = 40748 Bytes
+   ## Start Addr      = 0x40040000
+   => rproc init; rproc load 0:3 0x40040000 0x200000; rproc start 0
+
+You should see Zephyr boot log in the terminal of HSCIF1:
+
+.. code-block:: console
+
+   *** Booting Zephyr OS build v4.2.0-4945-g8fc6351ef451 ***
+   Hello World! sparrowhawk_rcar_v4h/r8a779g0/r52
+
+References
+**********
+
+- `Renesas R-Car V4H`_
+- `Retronix Sparrow Hawk`_
+
+.. _Renesas R-Car V4H:
+   https://www.renesas.com/en/products/r-car-v4h
+
+.. _Retronix Sparrow Hawk:
+   https://rcar-community.github.io/Sparrow-Hawk/index.html

boards/retronix/sparrowhawk_rcar_v4h/sparrowhawk_rcar_v4h_r8a779g0_r52-pinctrl.dtsi

@@ -0,0 +1,25 @@
+/*
+ * Copyright (c) 2025 Renesas Electronics Corporation
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#include <dt-bindings/pinctrl/renesas/pinctrl-r8a779g0.h>
+
+&pfc {
+	hscif0_data_tx_default: hscif0_data_tx_default {
+		pin = <PIN_HRX0 FUNC_HRX0>;
+	};
+
+	hscif0_data_rx_default: hscif0_data_rx_default {
+		pin = <PIN_HTX0 FUNC_HTX0>;
+	};
+
+	hscif1_data_tx_default: hscif1_data_tx_default {
+		pin = <PIN_MSIOF2_SYNC FUNC_HRX1>;
+	};
+
+	hscif1_data_rx_default: hscif1_data_rx_default {
+		pin = <PIN_MSIOF2_SS1 FUNC_HTX1>;
+	};
+};

boards/retronix/sparrowhawk_rcar_v4h/sparrowhawk_rcar_v4h_r8a779g0_r52.dts

@@ -0,0 +1,34 @@
+/*
+ * Copyright (c) 2025 Renesas Electronics Corporation
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ */
+
+/dts-v1/;
+#include <arm/renesas/rcar/gen4/r8a779g0.dtsi>
+#include "sparrowhawk_rcar_v4h_r8a779g0_r52-pinctrl.dtsi"
+
+/ {
+	model = "Retronix Sparrow Hawk on R-Car V4H";
+	compatible = "retronix,sparrowhawk-v4h-cr52";
+
+	chosen {
+		zephyr,sram = &sram0;
+		zephyr,console = &hscif1;
+		zephyr,shell-uart = &hscif1;
+	};
+};
+
+/* USB serial */
+&hscif0 {
+	pinctrl-0 = <&hscif0_data_tx_default &hscif0_data_rx_default>;
+	pinctrl-names = "default";
+	status = "disabled";
+};
+
+&hscif1 {
+	pinctrl-0 = <&hscif1_data_tx_default &hscif1_data_rx_default>;
+	pinctrl-names = "default";
+	status = "okay";
+};

boards/retronix/sparrowhawk_rcar_v4h/sparrowhawk_rcar_v4h_r8a779g0_r52.yaml

@@ -0,0 +1,11 @@
+identifier: sparrowhawk_rcar_v4h/r8a779g0/r52
+name: Retronix Sparrow Hawk with Renesas R-Car V4H Cortex R52
+type: mcu
+arch: arm
+toolchain:
+  - zephyr
+  - gnuarmemb
+supported:
+  - gpio
+  - clock_control
+  - uart

boards/retronix/sparrowhawk_rcar_v4h/sparrowhawk_rcar_v4h_r8a779g0_r52_defconfig

@@ -0,0 +1,11 @@
+CONFIG_CLOCK_CONTROL=y
+
+# UART driver
+CONFIG_SERIAL=y
+CONFIG_UART_USE_RUNTIME_CONFIGURE=y
+CONFIG_UART_INTERRUPT_DRIVEN=n
+
+# Console
+CONFIG_CONSOLE=y
+CONFIG_RAM_CONSOLE=n
+CONFIG_UART_CONSOLE=y

drivers/clock_control/CMakeLists.txt

@@ -128,6 +128,7 @@ if(CONFIG_CLOCK_CONTROL_RCAR_CPG_MSSR)
   zephyr_library_sources(clock_control_renesas_cpg_mssr.c)
   zephyr_library_sources_ifdef(CONFIG_DT_HAS_RENESAS_R8A7795_CPG_MSSR_ENABLED clock_control_r8a7795_cpg_mssr.c)
   zephyr_library_sources_ifdef(CONFIG_DT_HAS_RENESAS_R8A779F0_CPG_MSSR_ENABLED clock_control_r8a779f0_cpg_mssr.c)
+  zephyr_library_sources_ifdef(CONFIG_DT_HAS_RENESAS_R8A779G0_CPG_MSSR_ENABLED clock_control_r8a779g0_cpg_mssr.c)
 endif()
 
 zephyr_library_sources_ifdef(CONFIG_CLOCK_CONTROL_AST10X0 clock_control_ast10x0.c)