samples: boards: renesas: Add OpenAMP sample for Renesas RZ/V2L

Add OpenAMP sample support for board Renesas RZ/V2L-SMARC

Signed-off-by: Phuc Pham <[email protected]>
Signed-off-by: Tien Nguyen <[email protected]>

Author: Phuc Pham

samples/boards/renesas/openamp_linux_zephyr/README.rst

@@ -20,26 +20,39 @@ Building the application
 Zephyr
 ======
 
-Build command:
+Build command for RZ/G3S-SMARC
+------------------------------
 
 .. zephyr-app-commands::
    :zephyr-app: samples/boards/renesas/openamp_linux_zephyr
    :board: rzg3s_smarc/r9a08g045s33gbg/cm33
    :goals: build
    :compact:
 
+Build command for RZ/V2L-SMARC
+------------------------------
+
+.. zephyr-app-commands::
+   :zephyr-app: samples/boards/renesas/openamp_linux_zephyr
+   :board: rzv2l_smarc/r9a07g054l23gbg/cm33
+   :goals: build
+   :compact:
+
 Running the sample
-*************************
+******************
 
 Linux setup
 ===========
 
-The sample currently supports the Linux RZ/G Multi-OS Package V2.2.0. The build steps for Renesas Multi-OS Package V2.2.0 are described below.
+For RZ/G3S-SMARC
+----------------
+
+The sample currently supports the Linux RZ/G Multi-OS Package v3.0.0. The build steps for Renesas Multi-OS Package are described below.
 
-1. Follow the procedures in ''3.Multi-OS Package Setup'' of `Release Note for RZ/G Multi-OS Package V2.2.0 <https://www.renesas.com/en/document/rln/release-note-rzg-multi-os-package-v220?r=1522841>`_
+1. Follow the procedures in ''3.2 Integration of Multi-OS Package related stuff'' of `Quick Start Guide for RZ/G3S Multi-OS Package`_
    without initiating the build process.
-2. For RZ/G3S, add ``PLAT_M33_BOOT_SUPPORT=1`` by following this guide:
-   `RZ/G3S SMARC Evaluation Board Kit <https://docs.zephyrproject.org/latest/boards/renesas/rzg3s_smarc/doc/index.html#programming-and-debugging>`_
+
+2. For RZ/G3S, add ``PLAT_M33_BOOT_SUPPORT=1`` by following this guide: `RZ/G3S SMARC Evaluation Board Kit`_
 
 3. Insert the highlighted lines of code into the following file: meta-rz-features/meta-rz-multi-os/meta-rzg3s/recipes-example/rpmsg-sample/files/platform_info.c
 
@@ -63,12 +76,44 @@ The sample currently supports the Linux RZ/G Multi-OS Package V2.2.0. The build
 
 4. Start the build.
 
-5. For deploying bootloader files, Linux kernel image, device tree and rootfs, follow the procedures in ''3.5.1 In case of configuring CA55 as Boot CPU'' of `Release Note for RZ/G Multi-OS Package V2.2.0 <https://www.renesas.com/en/document/rln/release-note-rzg-multi-os-package-v220?r=1522841>`_
+5. For deploying bootloader files, Linux kernel image, device tree and rootfs, please refer to: `SMARC EVK of RZ/G3S Linux Start-up Guide`_
+
+For RZ/V2L-SMARC
+----------------
+
+The sample currently supports the Linux RZ/V Multi-OS Package v3.1.1. The build steps for Renesas Multi-OS Package are described below.
+
+1. Follow the steps (1) and (2) from the ''Flashing'' section of `RZ/V2L SMARC Evaluation Board Kit`_
+
+2. Insert the highlighted lines of code into the following file: meta-rz-features/meta-rz-multi-os/meta-rzv2l/recipes-example/rpmsg-sample/files/platform_info.c
+
+   .. code-block:: c
+      :emphasize-lines: 5,6,7,8,9,10
+
+      if (ret) {
+      LPRINTF("failed rpmsg_init_vdev");
+      goto err;
+      }
+      /* RPMsg virtio enables callback for avail flags */
+      ret = virtqueue_enable_cb(rpmsg_vdev->rvq);
+      if (ret) {
+         LPRINTF("Failed release availability flags");
+         goto err;
+      }
+      #ifndef __linux__ /* uC3 */
+      start_ipi_task(rproc);
+      #endif
+      return rpmsg_virtio_get_rpmsg_device(rpmsg_vdev);
+
+3. Start the build.
+
+4. For deploying bootloader files, Linux kernel image, device tree and rootfs, follow the steps (4) to (8) from the ''Flashing'' section of
+`RZ/V2L SMARC Evaluation Board Kit`_
 
 Zephyr setup
 ============
 
-1. Flash the sample to the board.
+1. Flash the sample to the board by following the ''Flashing'' instructions for your board.
 
 2. Open a serial terminal (minicom, putty, etc.) and connect to the board with the following
    settings:
@@ -173,3 +218,20 @@ The following message will appear on the Zephyr console.
       I: OpenAMP[remote] Linux sample client responder started
       I: OpenAMP demo ended
       I: OpenAMP Linux sample client responder ended
+
+References
+**********
+
+.. target-notes::
+
+.. _Quick Start Guide for RZ/G3S Multi-OS Package:
+   https://www.renesas.com/en/document/qsg/quick-start-guide-rzg3s-multi-os-package
+
+.. _RZ/G3S SMARC Evaluation Board Kit:
+   https://docs.zephyrproject.org/latest/boards/renesas/rzg3s_smarc/doc/index.html#programming-and-debugging
+
+.. _SMARC EVK of RZ/G3S Linux Start-up Guide:
+   https://www.renesas.com/en/document/gde/smarc-evk-rzg3s-linux-start-guide-rev106
+
+.. _RZ/V2L SMARC Evaluation Board Kit:
+   https://docs.zephyrproject.org/latest/boards/renesas/rzv2l_smarc/doc/index.html#flashing

samples/boards/renesas/openamp_linux_zephyr/boards/rzv2l_smarc_r9a07g054l23gbg_cm33.overlay

@@ -0,0 +1,80 @@
+/*
+ * Copyright (c) 2025 Renesas Electronics Corporation
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/ {
+	/*
+	 * Allocating whole openamp region as reserved memory
+	 * to save MPU entries
+	 */
+	reserved-memory {
+		#address-cells = <1>;
+		#size-cells = <1>;
+		ranges;
+
+		openamp_shm: memory-region@62F00000 {
+			compatible = "zephyr,memory-region";
+			reg = <0x62F00000 0x900000>;
+			zephyr,memory-region = "openamp_memory";
+			zephyr,memory-attr = <( DT_MEM_ARM(ATTR_MPU_IO) )>;
+		};
+	};
+
+	chosen {
+		zephyr,ipc_shm = &vring_shm0;
+		zephyr,ipc = &mbox_consumer;
+	};
+
+	vring_ctrl0: memory@63000000 {
+		compatible = "mmio-sram";
+		reg = <0x63000000 0x50000>;
+	};
+
+	vring_ctrl1: memory@63050000 {
+		compatible = "mmio-sram";
+		reg = <0x63050000 0x50000>;
+	};
+
+	vring_shm0: memory@63200000 {
+		compatible = "mmio-sram";
+		reg = <0x63200000 0x300000>;
+	};
+
+	rsctbl: memory@62F00000 {
+		compatible = "mmio-sram";
+		reg = <0x62F00000 0x1000>;
+	};
+
+	mhu1_shm: memory@62F01008 {
+		compatible = "mmio-sram";
+		reg = <0x62F01008 0x8>;
+	};
+
+	mhu3_shm: memory@62F01018 {
+		compatible = "mmio-sram";
+		reg = <0x62F01018 0x8>;
+	};
+
+	mhu4_shm: memory@62F01020 {
+		compatible = "mmio-sram";
+		reg = <0x62F01020 0x8>;
+	};
+
+	mhu5_shm: memory@62F01028 {
+		compatible = "mmio-sram";
+		reg = <0x62F01028 0x8>;
+	};
+
+	mbox_consumer: mbox-consumer {
+		compatible = "vnd,mbox-consumer";
+		mboxes = <&mbox1 1>, <&mbox1 0>;
+		mbox-names = "tx", "rx";
+	};
+
+};
+
+&mbox1 {
+	shared-memory = <&mhu1_shm>;
+	status = "okay";
+};

samples/boards/renesas/openamp_linux_zephyr/src/main_remote.c

@@ -122,7 +122,6 @@ static void new_service_cb(struct rpmsg_device *rdev, const char *name, uint32_t
 int mailbox_notify(void *priv, uint32_t id)
 {
 	ARG_UNUSED(priv);
-
 	mbox_send_dt(&tx_channel, NULL);
 	return 0;
 }
@@ -209,7 +208,6 @@ static void platform_deinit(void)
 static void cleanup_system(void)
 {
 	struct fw_resource_table *rsc_tbl = (struct fw_resource_table *)RSC_TABLE_ADDR;
-
 	rpmsg_deinit_vdev(&rvdev);
 	rproc_virtio_remove_vdev(rvdev.vdev);
 	/*
@@ -236,13 +234,6 @@ struct rpmsg_device *platform_create_rpmsg_vdev(unsigned int vdev_index, unsigne
 		return NULL;
 	}
 
-	/* Set gfeatures because they should be equal to dfeatures
-	 * when create_ept is called. As rproc_virtio_create_vdev
-	 * doesn't set them because its VIRTIO_DEVICE not DRIVER.
-	 * Assume the virtio driver support all remote features.
-	 */
-	virtio_set_features(vdev, 0x1);
-
 	/* wait master rpmsg init completion */
 	rproc_virtio_wait_remote_ready(vdev);
 
@@ -264,6 +255,13 @@ struct rpmsg_device *platform_create_rpmsg_vdev(unsigned int vdev_index, unsigne
 		goto failed;
 	}
 
+	/* Set gfeatures because they should be equal to dfeatures
+	 * when create_ept is called. As rproc_virtio_create_vdev
+	 * doesn't set them because its VIRTIO_DEVICE not DRIVER.
+	 * Assume the virtio driver support all remote features.
+	 */
+	virtio_set_features(vdev, 0x1);
+
 	rpmsg_virtio_init_shm_pool(&shpool, NULL, SHM_SIZE);
 	ret = rpmsg_init_vdev(&rvdev, vdev, ns_cb, shm_io, &shpool);