drivers: udc_ambiq: Implemented UDC driver for apollo4p_blue

Added implementation for udc_ambiq with its dependencies:
- udc_ambiq driver, along with required Kconfig and CMakeList updates
- created ambiq,usb.yaml for dts binding
- added usb node for apollo4p_blue mcu and apollo4p_blue_kxr_evb baord.

Signed-off-by: Chew Zeh Yang <[email protected]>

Author: zeonchew

boards/ambiq/apollo4p_blue_kxr_evb/apollo4p_blue_kxr_evb.dts

@@ -1,5 +1,6 @@
 /dts-v1/;
 #include <ambiq/ambiq_apollo4p_blue.dtsi>
+#include <zephyr/dt-bindings/input/input-event-codes.h>
 
 #include "apollo4p_blue_kxr_evb-pinctrl.dtsi"
 
@@ -45,13 +46,18 @@
 
 	buttons {
 		compatible = "gpio-keys";
+		polling-mode;
 		button0: button_0 {
 			gpios = <&gpio0_31 17 (GPIO_PULL_UP | GPIO_ACTIVE_LOW)>;
 			label = "BTN0";
+			zephyr,code = <INPUT_KEY_0>;
+			status = "okay";
 		};
 		button1: button_1 {
 			gpios = <&gpio0_31 19 (GPIO_PULL_UP | GPIO_ACTIVE_LOW)>;
 			label = "BTN1";
+			zephyr,code = <INPUT_KEY_1>;
+			status = "okay";
 		};
 	};
 };
@@ -129,6 +135,12 @@
 	status = "okay";
 };
 
+zephyr_udc0: &usb {
+	vddusb33-gpios = <&gpio0_31 13 (GPIO_PULL_UP)>;
+	vddusb0p9-gpios = <&gpio0_31 15 (GPIO_PULL_UP)>;
+	status = "okay";
+};
+
 &gpio0_31 {
 	status = "okay";
 };

boards/ambiq/apollo4p_evb/apollo4p_evb.dts

@@ -1,5 +1,6 @@
 /dts-v1/;
 #include <ambiq/ambiq_apollo4p.dtsi>
+#include <zephyr/dt-bindings/input/input-event-codes.h>
 
 #include "apollo4p_evb-pinctrl.dtsi"
 
@@ -45,13 +46,18 @@
 
 	buttons {
 		compatible = "gpio-keys";
+		polling-mode;
 		button0: button_0 {
 			gpios = <&gpio0_31 18 (GPIO_PULL_UP | GPIO_ACTIVE_LOW)>;
 			label = "BTN0";
+			zephyr,code = <INPUT_KEY_0>;
+			status = "okay";
 		};
 		button1: button_1 {
 			gpios = <&gpio0_31 19 (GPIO_PULL_UP | GPIO_ACTIVE_LOW)>;
 			label = "BTN1";
+			zephyr,code = <INPUT_KEY_1>;
+			status = "okay";
 		};
 	};
 };

drivers/usb/udc/CMakeLists.txt

@@ -17,3 +17,4 @@ zephyr_library_sources_ifdef(CONFIG_UDC_NXP_EHCI udc_mcux_ehci.c)
 zephyr_library_sources_ifdef(CONFIG_UDC_NXP_IP3511 udc_mcux_ip3511.c)
 zephyr_library_sources_ifdef(CONFIG_UDC_NUMAKER udc_numaker.c)
 zephyr_library_sources_ifdef(CONFIG_UDC_RPI_PICO udc_rpi_pico.c)
+zephyr_library_sources_ifdef(CONFIG_UDC_AMBIQ udc_ambiq.c)

drivers/usb/udc/Kconfig

@@ -64,5 +64,6 @@ source "drivers/usb/udc/Kconfig.it82xx2"
 source "drivers/usb/udc/Kconfig.mcux"
 source "drivers/usb/udc/Kconfig.numaker"
 source "drivers/usb/udc/Kconfig.rpi_pico"
+source "drivers/usb/udc/Kconfig.ambiq"
 
 endif # UDC_DRIVER

drivers/usb/udc/Kconfig.ambiq

@@ -0,0 +1,34 @@
+# Copyright (c) 2024 Ambiq Micro Inc.
+# SPDX-License-Identifier: Apache-2.0
+
+config UDC_AMBIQ
+	bool "USB device controller driver for ambiq devices"
+	default y
+	depends on DT_HAS_AMBIQ_USB_ENABLED
+	select GPIO
+	select AMBIQ_HAL
+	select AMBIQ_HAL_USE_USB
+	help
+	  Enable USB Device Controller Driver.
+
+config UDC_AMBIQ_STACK_SIZE
+	int "UDC AMBIQ driver internal thread stack size"
+	depends on UDC_AMBIQ
+	default 2048
+	help
+	  AMBIQ driver internal thread stack size.
+
+config UDC_AMBIQ_THREAD_PRIORITY
+	int "UDC AMBIQ driver thread priority"
+	depends on UDC_AMBIQ
+	default 8
+	help
+	  AMBIQ driver thread priority.
+
+
+config UDC_AMBIQ_MAX_QMESSAGES
+	int "UDC AMBIQ maximum number of ISR event messages"
+	range 4 64
+	default 8
+	help
+	  AMBIQ maximum number of ISR event messages.