feat(uvc_host): Add global suspend/resume

    - usb_host lib supports global suspend and resume
    - backward compatibility with older IDF releases
    - UVC Host target tests

Author: peter-marcisovsky

host/class/uvc/usb_host_uvc/CHANGELOG.md

@@ -11,6 +11,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - Added support for user-provided frame buffers via `user_frame_buffers` field in `uvc_host_stream_config_t.advanced`
 
+### Added
+
+- Added global suspend/resume support
+
 ### Fixed
 
 - Fixed potential buffer overflow in descriptor printing functions by removing unnecessary memcpy operations

host/class/uvc/usb_host_uvc/examples/basic_uvc_stream/main/basic_uvc_stream.c

@@ -71,6 +71,14 @@ static void stream_callback(const uvc_host_stream_event_data_t *event, void *use
     case UVC_HOST_FRAME_BUFFER_UNDERFLOW:
         ESP_LOGW(TAG, "Frame buffer underflow");
         break;
+#ifdef UVC_HOST_SUSPEND_RESUME_API_SUPPORTED
+    case UVC_HOST_DEVICE_SUSPENDED:
+        ESP_LOGI(TAG, "Device suspended");
+        break;
+    case UVC_HOST_DEVICE_RESUMED:
+        ESP_LOGI(TAG, "Device resumed");
+        break;
+#endif // UVC_HOST_SUSPEND_RESUME_API_SUPPORTED
     default:
         abort();
         break;

host/class/uvc/usb_host_uvc/examples/camera_display/main/camera_display.c

@@ -1,5 +1,5 @@
 /*
- * SPDX-FileCopyrightText: 2024 Espressif Systems (Shanghai) CO LTD
+ * SPDX-FileCopyrightText: 2024-2025 Espressif Systems (Shanghai) CO LTD
  *
  * SPDX-License-Identifier: Apache-2.0
  */
@@ -62,6 +62,14 @@ void stream_callback(const uvc_host_stream_event_data_t *event, void *user_ctx)
     case UVC_HOST_FRAME_BUFFER_UNDERFLOW:
         ESP_LOGW(TAG, "Frame buffer underflow");
         break;
+#ifdef UVC_HOST_SUSPEND_RESUME_API_SUPPORTED
+    case UVC_HOST_DEVICE_SUSPENDED:
+        ESP_LOGI(TAG, "Device suspended");
+        break;
+    case UVC_HOST_DEVICE_RESUMED:
+        ESP_LOGI(TAG, "Device resumed");
+        break;
+#endif // UVC_HOST_SUSPEND_RESUME_API_SUPPORTED
     default:
         abort();
         break;

host/class/uvc/usb_host_uvc/include/usb/uvc_host.h

@@ -20,6 +20,11 @@
 extern "C" {
 #endif
 
+// For backward compatibility with IDF versions which do not have suspend/resume api
+#ifdef USB_HOST_LIB_EVENT_FLAGS_AUTO_SUSPEND
+#define UVC_HOST_SUSPEND_RESUME_API_SUPPORTED
+#endif
+
 typedef struct uvc_host_stream_s *uvc_host_stream_hdl_t;
 
 enum uvc_host_driver_event {
@@ -100,6 +105,10 @@ enum uvc_host_dev_event {
     UVC_HOST_FRAME_BUFFER_UNDERFLOW, /**< The received frame was discarded because no available buffer was free for storage.
                                           To address this, either optimize your processing speed or increase the `number_of_frame_buffers` parameter in
                                           `uvc_host_stream_config_t.advanced` to allocate additional buffers. */
+#ifdef UVC_HOST_SUSPEND_RESUME_API_SUPPORTED
+    UVC_HOST_DEVICE_SUSPENDED,      /**< Device was suspended. The stream is stopped. */
+    UVC_HOST_DEVICE_RESUMED,        /**< Device was resumed. */
+#endif // UVC_HOST_SUSPEND_RESUME_API_SUPPORTED
 };
 
 /**
@@ -118,6 +127,11 @@ typedef struct {
         } frame_overflow; // UVC_HOST_FRAME_BUFFER_OVERFLOW
         struct {
         } frame_underflow; // UVC_HOST_FRAME_BUFFER_UNDERFLOW
+#ifdef UVC_HOST_SUSPEND_RESUME_API_SUPPORTED
+        struct {
+            uvc_host_stream_hdl_t stream_hdl;
+        } device_suspended_resumed;
+#endif // UVC_HOST_SUSPEND_RESUME_API_SUPPORTED
     };
 } uvc_host_stream_event_data_t;