tests: pwm_api: Add timing check

tests/drivers/pwm/pwm_api/Kconfig

@@ -0,0 +1,29 @@
+# Copyright (c) 2024 Espressif Systems (Shanghai) Co., Ltd.
+# SPDX-License-Identifier: Apache-2.0
+
+mainmenu "PWM api test"
+
+source "Kconfig.zephyr"
+
+config ENABLE_TIMING_CHECK
+	bool "Enable PWM timing check with GPIO and systimer"
+	help
+		Enables timing checks on PWM signals by using a GPIO pin and interrupts
+		along with the system timer to automatically measure period and duty cycle.
+		Assumes the system timer is accurate and uses it as reference tick.
+
+config ALLOWED_DEVIATION
+	int "Allowed deviation (%) for PWM timing checks"
+	default 5
+	range 0 100
+	help
+		Maximum allowed deviation (%) from the programmed values for the test to be
+		considered a PASS. For example, if set to 5, the measured period or duty cycle
+		can deviate by up to 5% from the programmed values for the test to pass.
+
+config TEST_DELAY
+	int "Test delay duration (ms)"
+	default 1000
+	help
+		Sets delay duration in milliseconds for testing purposes.
+		It configures the delay period in between test cases.

tests/drivers/pwm/pwm_api/dts/bindings/test-pwm-api.yaml

@@ -0,0 +1,18 @@
+#
+# Copyright (c) 2024 Espressif Systems (Shanghai) Co., Ltd.
+#
+# SPDX-License-Identifier: Apache-2.0
+#
+
+description: |
+    This binding provides resources required to build and run the test
+    tests/drivers/pwm/pwm_api when CONFIG_ENABLE_TIMING_CHECK is enabled.
+
+compatible: "test-pwm-api"
+
+properties:
+  in-gpios:
+    type: phandle-array
+    required: true
+    description: |
+      GPIO to be used as input to check and validate PWM timing.

tests/drivers/pwm/pwm_api/boards/esp32_devkitc_wroom_procpu.overlay → tests/drivers/pwm/pwm_api/socs/esp32_procpu.overlay

@@ -1,22 +1,29 @@
 /*
  * SPDX-License-Identifier: Apache-2.0
  *
- * Copyright (c) 2023 Espressif Systems (Shanghai) Co., Ltd.
+ * Copyright (c) 2024 Espressif Systems (Shanghai) Co., Ltd.
  */
 
 #include <zephyr/dt-bindings/pwm/pwm.h>
+#include <zephyr/dt-bindings/gpio/gpio.h>
+#include <zephyr/dt-bindings/gpio/espressif-esp32-gpio.h>
 
 / {
 	aliases {
 		pwm-0 = &ledc0;
 	};
+
+	resources {
+		compatible = "test-pwm-api";
+		in-gpios = <&gpio0 2 ESP32_GPIO_PIN_OUT_EN>;
+	};
 };
 
 &pinctrl {
 	ledc0_default: ledc0_default {
 		group1 {
 			pinmux = <LEDC_CH0_GPIO2>;
-			output-enable;
+			input-enable;
 		};
 	};
 };

tests/drivers/pwm/pwm_api/socs/esp32c2.overlay

@@ -5,18 +5,25 @@
  */
 
 #include <zephyr/dt-bindings/pwm/pwm.h>
+#include <zephyr/dt-bindings/gpio/gpio.h>
+#include <zephyr/dt-bindings/gpio/espressif-esp32-gpio.h>
 
 / {
 	aliases {
 		pwm-0 = &ledc0;
 	};
+
+	resources {
+		compatible = "test-pwm-api";
+		in-gpios = <&gpio0 2 ESP32_GPIO_PIN_OUT_EN>;
+	};
 };
 
 &pinctrl {
 	ledc0_default: ledc0_default {
 		group1 {
 			pinmux = <LEDC_CH0_GPIO2>;
-			output-enable;
+			input-enable;
 		};
 	};
 };

tests/drivers/pwm/pwm_api/socs/esp32c3.overlay

@@ -5,18 +5,25 @@
  */
 
 #include <zephyr/dt-bindings/pwm/pwm.h>
+#include <zephyr/dt-bindings/gpio/gpio.h>
+#include <zephyr/dt-bindings/gpio/espressif-esp32-gpio.h>
 
 / {
 	aliases {
 		pwm-0 = &ledc0;
 	};
+
+	resources {
+		compatible = "test-pwm-api";
+		in-gpios = <&gpio0 2 ESP32_GPIO_PIN_OUT_EN>;
+	};
 };
 
 &pinctrl {
 	ledc0_default: ledc0_default {
 		group1 {
 			pinmux = <LEDC_CH0_GPIO2>;
-			output-enable;
+			input-enable;
 		};
 	};
 };

tests/drivers/pwm/pwm_api/boards/esp32c6_devkitc.overlay → tests/drivers/pwm/pwm_api/socs/esp32c6.overlay

@@ -1,22 +1,29 @@
 /*
  * SPDX-License-Identifier: Apache-2.0
  *
- * Copyright (c) 2023 Espressif Systems (Shanghai) Co., Ltd.
+ * Copyright (c) 2024 Espressif Systems (Shanghai) Co., Ltd.
  */
 
 #include <zephyr/dt-bindings/pwm/pwm.h>
+#include <zephyr/dt-bindings/gpio/gpio.h>
+#include <zephyr/dt-bindings/gpio/espressif-esp32-gpio.h>
 
 / {
 	aliases {
 		pwm-0 = &ledc0;
 	};
+
+	resources {
+		compatible = "test-pwm-api";
+		in-gpios = <&gpio0 2 ESP32_GPIO_PIN_OUT_EN>;
+	};
 };
 
 &pinctrl {
 	ledc0_default: ledc0_default {
 		group1 {
 			pinmux = <LEDC_CH0_GPIO2>;
-			output-enable;
+			input-enable;
 		};
 	};
 };

tests/drivers/pwm/pwm_api/boards/esp32s2_saola.overlay → tests/drivers/pwm/pwm_api/socs/esp32s2.overlay

@@ -1,22 +1,29 @@
 /*
  * SPDX-License-Identifier: Apache-2.0
  *
- * Copyright (c) 2023 Espressif Systems (Shanghai) Co., Ltd.
+ * Copyright (c) 2024 Espressif Systems (Shanghai) Co., Ltd.
  */
 
 #include <zephyr/dt-bindings/pwm/pwm.h>
+#include <zephyr/dt-bindings/gpio/gpio.h>
+#include <zephyr/dt-bindings/gpio/espressif-esp32-gpio.h>
 
 / {
 	aliases {
 		pwm-0 = &ledc0;
 	};
+
+	resources {
+		compatible = "test-pwm-api";
+		in-gpios = <&gpio0 2 ESP32_GPIO_PIN_OUT_EN>;
+	};
 };
 
 &pinctrl {
 	ledc0_default: ledc0_default {
 		group1 {
 			pinmux = <LEDC_CH0_GPIO2>;
-			output-enable;
+			input-enable;
 		};
 	};
 };

tests/drivers/pwm/pwm_api/boards/esp32s3_devkitm_procpu.overlay → tests/drivers/pwm/pwm_api/socs/esp32s3_procpu.overlay

@@ -1,22 +1,29 @@
 /*
  * SPDX-License-Identifier: Apache-2.0
  *
- * Copyright (c) 2023 Espressif Systems (Shanghai) Co., Ltd.
+ * Copyright (c) 2024 Espressif Systems (Shanghai) Co., Ltd.
  */
 
 #include <zephyr/dt-bindings/pwm/pwm.h>
+#include <zephyr/dt-bindings/gpio/gpio.h>
+#include <zephyr/dt-bindings/gpio/espressif-esp32-gpio.h>
 
 / {
 	aliases {
 		pwm-0 = &ledc0;
 	};
+
+	resources {
+		compatible = "test-pwm-api";
+		in-gpios = <&gpio0 2 ESP32_GPIO_PIN_OUT_EN>;
+	};
 };
 
 &pinctrl {
 	ledc0_default: ledc0_default {
 		group1 {
 			pinmux = <LEDC_CH0_GPIO2>;
-			output-enable;
+			input-enable;
 		};
 	};
 };