boards: shields: Add support for pmod sd

Add support for Pmod SD and support overlay for EK-RA8M1, EK-RA8D1
to use with Pmod

Signed-off-by: Quy Tran <quy.tran.pz@renesas.com>

Author: quytranpzz

boards/renesas/ek_ra8d1/ek_ra8d1.dts

@@ -298,3 +298,5 @@ zephyr_lcdif: &lcdif {
 zephyr_mipi_dsi: &mipi_dsi {};
 
 renesas_mipi_i2c: &iic1{};
+
+pmod_sd_shield: &sdhc1 {};

boards/renesas/ek_ra8m1/ek_ra8m1.dts

@@ -347,3 +347,5 @@ pmod_header: &pmod1_header {};
 	interrupts = <89 12>;
 	status = "okay";
 };
+
+pmod_sd_shield: &sdhc0 {};

boards/shields/pmod_sd/Kconfig.shield

@@ -0,0 +1,5 @@
+# Copyright (c) 2024 Renesas Electronics Corporation
+# SPDX-License-Identifier: Apache-2.0
+
+config SHIELD_PMOD_SD
+	def_bool $(shields_list_contains,pmod_sd)

boards/shields/pmod_sd/boards/ek_ra8d1.overlay

@@ -0,0 +1,10 @@
+/*
+ * Copyright (c) 2024 Renesas Electronics Corporation
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+&pmod_sd_shield {
+	interrupt-names = "accs", "card", "dma-req";
+	interrupts = <60 12>, <61 12>, <62 12>;
+	pinctrl-0 = <&sdhc1_default>;
+};

boards/shields/pmod_sd/doc/index.rst

@@ -0,0 +1,54 @@
+.. _pmod_sd:
+
+Digilent Pmod SD
+################
+
+Overview
+********
+
+The Digilent Pmod SD (Revision B) allows system boards to read from and write to SD cards.
+
+Features
+********
+
+- Full-sized SD card slot
+- Store and access large amounts of date from your system board
+- No limitation on file system or memory size of SD card used
+- 1-bit and 4-bit communication
+- 12-pin Pmod port with SPI interface
+
+Programming
+***********
+
+Set ``--shield pmod_sd`` when you invoke ``west build``. For example:
+
+.. zephyr-app-commands::
+   :zephyr-app: tests/drivers/disk/disk_access
+   :board: ek_ra8m1
+   :shield: pmod_sd
+   :goals: build
+
+Pinout
+======
+
+.. figure:: pmod_sd_pins.webp
+	:align: center
+	:alt: PMOD SD Pinout
+
+	PMOD SD Pinout (Credit: Digilent)
+
+References
+**********
+
+- `Pmod SD product page`_
+- `Pmod SD reference manual`_
+- `Pmod SD schematic`_
+
+.. _Pmod SD product page:
+   https://digilent.com/shop/pmod-sd-full-sized-sd-card-slot/
+
+.. _Pmod SD reference manual:
+   https://digilent.com/reference/pmod/pmodsd/reference-manual
+
+.. _Pmod SD schematic:
+   https://digilent.com/reference/_media/reference/pmod/pmodsd/pmodsd_sch.pdf

boards/shields/pmod_sd/doc/pmod_sd_pins.webp

@@ -0,0 +1,21 @@
+/*
+ * Copyright (c) 2024 Renesas Electronics Corporation
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/ {
+	aliases {
+		sdhc0 = &pmod_sd_shield;
+	};
+};
+
+&pmod_sd_shield {
+	pinctrl-0 = <&sdhc0_default>;
+	pinctrl-names = "default";
+	status = "okay";
+	sdmmc {
+		compatible = "zephyr,sdmmc-disk";
+		disk-name = "SD";
+		status = "okay";
+	};
+};