drivers: sdhc: add sdhc driver for Ambiq MCU

Add SDHC/SDIO driver support for Ambiq Apollo4 MCU.

Signed-off-by: Darren Lu <[email protected]>

Author: darrenlu-ambiq

drivers/sdhc/CMakeLists.txt

@@ -14,4 +14,5 @@ zephyr_library_sources_ifdef(CONFIG_CDNS_SDHC sdhc_cdns_ll.c sdhc_cdns.c)
 zephyr_library_sources_ifdef(CONFIG_SDHC_ESP32 sdhc_esp32.c)
 zephyr_library_sources_ifdef(CONFIG_SDHC_RENESAS_RA sdhc_renesas_ra.c)
 zephyr_library_sources_ifdef(CONFIG_SDHC_MAX32 sdhc_max32.c)
+zephyr_library_sources_ifdef(CONFIG_SDHC_AMBIQ sdhc_ambiq.c)
 endif()

drivers/sdhc/Kconfig

@@ -19,6 +19,7 @@ source "drivers/sdhc/Kconfig.sdhc_cdns"
 source "drivers/sdhc/Kconfig.esp32"
 source "drivers/sdhc/Kconfig.renesas_ra"
 source "drivers/sdhc/Kconfig.max32"
+source "drivers/sdhc/Kconfig.ambiq"
 
 config SDHC_INIT_PRIORITY
 	int "SDHC driver init priority"

drivers/sdhc/Kconfig.ambiq

@@ -0,0 +1,31 @@
+# Copyright (c) 2025 Ambiq Micro Inc.
+# SPDX-License-Identifier: Apache-2.0
+
+config SDHC_AMBIQ
+	bool "Ambiq SDHC driver"
+	default y
+	depends on DT_HAS_AMBIQ_SDIO_ENABLED
+	select AMBIQ_HAL
+	select AMBIQ_HAL_USE_SDIO
+	select PINCTRL
+	select GPIO
+	select SDHC_SUPPORTS_NATIVE_MODE
+	help
+	  This option enables the SDHC driver for Ambiq Apollo family.
+
+if SDHC_AMBIQ
+
+config AMBIQ_SDIO_ASYNC
+	bool "Ambiq SDIO Async Mode"
+	default y
+	depends on DT_HAS_AMBIQ_SDIO_ENABLED
+	help
+	  This option enables Ambiq SDIO Async Mode.
+
+config SDHC_BUFFER_ALIGNMENT
+	default 32 if DCACHE
+	default 16
+	help
+	  SDHC buffer should be 32bytes aligned when placed in cachable region.
+
+endif