drivers: sdhc: Add support for Apollo510 SDIO host

This commit adds support for ambiq SDIO host driver

Signed-off-by: Fan Wang <fan.wang@ambiq.com>

Author: fanwang-ambiq

boards/ambiq/apollo510_evb/apollo510_evb-pinctrl.dtsi

@@ -380,4 +380,78 @@
 			drive-strength = "0.5";
 		};
 	};
+
+	sdio0_default: sdio0_default {
+		group0 {
+			pinmux = <SDIF0_DAT1_P85>,
+				 <SDIF0_DAT3_P87>,
+				 <SDIF0_DAT4_P156>,
+				 <SDIF0_DAT5_P157>,
+				 <SDIF0_DAT6_P158>,
+				 <SDIF0_DAT7_P159>;
+				 drive-strength = "1.0";
+		};
+		group1 {
+			pinmux = <SDIF0_DAT0_P84>,
+				 <SDIF0_DAT2_P86>,
+				 <SDIF0_CMD_P160>,
+				 <SDIF0_CLKOUT_P88>;
+				 drive-strength = "1.0";
+				 bias-pull-up;
+				 ambiq,pull-up-ohms = <12000>;
+		};
+		group2 {
+			pinmux = <GPIO_P161>;
+				 ambiq,sdif-cdwp = <1>;
+		};
+		group3 {
+			pinmux = <GPIO_P175>;
+				 ambiq,sdif-cdwp = <2>;
+		};
+		group4 {
+			pinmux = <GPIO_P161>;
+				 ambiq,sdif-cdwp = <3>;
+		};
+		group5 {
+			pinmux = <GPIO_P175>;
+				 ambiq,sdif-cdwp = <4>;
+		};
+	};
+
+	sdio1_default: sdio1_default {
+		group0 {
+			pinmux = <SDIF1_DAT1_P126>,
+				 <SDIF1_DAT3_P128>,
+				 <SDIF1_DAT4_P130>,
+				 <SDIF1_DAT5_P131>,
+				 <SDIF1_DAT6_P132>,
+				 <SDIF1_DAT7_P133>;
+				 drive-strength = "1.0";
+		};
+		group1 {
+			pinmux = <SDIF1_DAT0_P125>,
+				 <SDIF1_DAT2_P127>,
+				 <SDIF1_CMD_P134>,
+				 <SDIF1_CLKOUT_P129>;
+				 drive-strength = "1.0";
+				 bias-pull-up;
+				 ambiq,pull-up-ohms = <12000>;
+		};
+		group2 {
+			pinmux = <GPIO_P161>;
+				 ambiq,sdif-cdwp = <1>;
+		};
+		group3 {
+			pinmux = <GPIO_P175>;
+				 ambiq,sdif-cdwp = <2>;
+		};
+		group4 {
+			pinmux = <GPIO_P161>;
+				 ambiq,sdif-cdwp = <3>;
+		};
+		group5 {
+			pinmux = <GPIO_P175>;
+				 ambiq,sdif-cdwp = <4>;
+		};
+	};
 };

boards/ambiq/apollo510_evb/apollo510_evb.dts

@@ -199,6 +199,19 @@
 	};
 };
 
+&sdio0 {
+	pinctrl-0 = <&sdio0_default>;
+	pinctrl-names = "default";
+	txdelay = <0>;
+	rxdelay = <0>;
+	status = "disabled";
+	mmc {
+		compatible = "zephyr,mmc-disk";
+		disk-name = "SD2";
+		status = "disabled";
+	};
+};
+
 zephyr_udc0: &usb {
 	vddusb33-gpios = <&gpio64_95 27 (GPIO_PULL_UP)>;
 	vddusb0p9-gpios = <&gpio64_95 26 (GPIO_PULL_UP)>;

boards/ambiq/apollo510_evb/apollo510_evb.yaml

@@ -20,6 +20,7 @@ supported:
   - clock_control
   - usbd
   - mspi
+  - sdio
 testing:
   ignore_tags:
     - net

dts/arm/ambiq/ambiq_apollo510.dtsi

@@ -559,6 +559,22 @@
 			#io-channel-cells = <1>;
 		};
 
+		sdio0: sdio@SDIO0_BASE_NAME {
+			compatible = "ambiq,sdio";
+			reg = <SDIO0_REG_BASE SDIO0_REG_SIZE>;
+			interrupts = <26 0>;
+			status = "disabled";
+			zephyr,pm-device-runtime-auto;
+		};
+
+		sdio1: sdio@SDIO1_BASE_NAME {
+			compatible = "ambiq,sdio";
+			reg = <SDIO1_REG_BASE SDIO1_REG_SIZE>;
+			interrupts = <84 0>;
+			status = "disabled";
+			zephyr,pm-device-runtime-auto;
+		};
+
 		pinctrl: pin-controller@GPIO_BASE_NAME {
 			compatible = "ambiq,apollo5-pinctrl";
 			reg = <GPIO_REG_BASE GPIO_REG_SIZE>;

samples/subsys/fs/fs_sample/boards/apollo510_evb.conf

@@ -0,0 +1,11 @@
+CONFIG_DISK_DRIVER_MMC=y
+CONFIG_MMC_STACK=y
+CONFIG_SDHC=y
+CONFIG_MMC_SUBSYS=y
+
+CONFIG_MAIN_STACK_SIZE=8192
+CONFIG_IDLE_STACK_SIZE=4096
+CONFIG_AMBIQ_SDIO_ASYNC=y
+CONFIG_PM=y
+CONFIG_PM_DEVICE=y
+CONFIG_PM_DEVICE_RUNTIME=y

samples/subsys/fs/fs_sample/boards/apollo510_evb.overlay

@@ -0,0 +1,18 @@
+/*
+ * Copyright (C) 2025 Ambiq Micro Inc. <www.ambiq.com>
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/ {
+	aliases {
+		sdhc0 = &sdio0;
+	};
+};
+
+&sdio0 {
+	status = "okay";
+	mmc {
+		status = "okay";
+	};
+};