emul: mspi: Add the mspi controller emulator

Add bus emulator support for MSPI and the MSPI controller emulator.
The mspi_emul.c not only serves as an emulator but also provides an
example implementation of the MSPI API. It does not actually do anything
other than validating parameters and forwarding transceive request back
to the device driver emulators.

(cherry picked from commit f5554ca)

Original-Signed-off-by: Swift Tian <[email protected]>
GitOrigin-RevId: f5554ca
Change-Id: I2bab84f8e8251d626e03925d56e970a34d71e5de
Reviewed-on: https://chromium-review.googlesource.com/c/chromiumos/third_party/zephyr/+/5635393
Commit-Queue: Ting Shen <[email protected]>
Tested-by: Ting Shen <[email protected]>
Reviewed-by: Ting Shen <[email protected]>
Tested-by: Dawid Niedźwiecki <[email protected]>
Reviewed-by: Dawid Niedźwiecki <[email protected]>

Author: swift-tk

drivers/mspi/CMakeLists.txt

@@ -4,3 +4,4 @@ zephyr_syscall_header(${ZEPHYR_BASE}/include/zephyr/drivers/mspi.h)
 
 zephyr_library()
 zephyr_library_sources_ifdef(CONFIG_MSPI_AMBIQ_AP3   mspi_ambiq_ap3.c)
+zephyr_library_sources_ifdef(CONFIG_MSPI_EMUL        mspi_emul.c)

drivers/mspi/Kconfig

@@ -60,5 +60,6 @@ module-str = mspi
 source "subsys/logging/Kconfig.template.log_config"
 
 source "drivers/mspi/Kconfig.ambiq"
+source "drivers/mspi/Kconfig.mspi_emul"
 
 endif # MSPI

drivers/mspi/Kconfig.mspi_emul

@@ -0,0 +1,17 @@
+# Copyright (c) 2024, Ambiq Micro Inc. <www.ambiq.com>
+# SPDX-License-Identifier: Apache-2.0
+
+config MSPI_EMUL
+	bool "MSPI emulator"
+	default y
+	depends on DT_HAS_ZEPHYR_MSPI_EMUL_CONTROLLER_ENABLED
+	depends on EMUL
+	select MSPI_XIP
+	select MSPI_SCRAMBLE
+	select MSPI_TIMING
+	select GPIO
+	help
+	  Enable the MSPI emulator driver. This is a fake driver in that it
+	  does not talk to real hardware. Instead it talks to emulation
+	  drivers that pretend to be devices on the emulated MSPI bus. It is
+	  used for testing drivers for MSPI devices.