feat(usb_host): MSC Host add suspend/resume events

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

Author: peter-marcisovsky

host/class/msc/usb_host_msc/CHANGELOG.md

@@ -1,6 +1,7 @@
 ## [Unreleased]
 
 - Added public API support for formatting
+- Added global suspend/resume support
 
 ## 1.1.3
 

host/class/msc/usb_host_msc/include/usb/msc_host.h

@@ -1,5 +1,5 @@
 /*
- * SPDX-FileCopyrightText: 2015-2023 Espressif Systems (Shanghai) CO LTD
+ * SPDX-FileCopyrightText: 2015-2025 Espressif Systems (Shanghai) CO LTD
  *
  * SPDX-License-Identifier: Apache-2.0
  */
@@ -9,6 +9,7 @@
 #include <wchar.h>
 #include <stdint.h>
 #include "esp_err.h"
+#include "usb/usb_host.h"
 #include "freertos/FreeRTOS.h"
 
 #ifdef __cplusplus
@@ -23,6 +24,11 @@ extern "C" {
 
 #define MSC_STR_DESC_SIZE 32
 
+// For backward compatibility with IDF versions which do not have suspend/resume api
+#ifdef USB_HOST_LIB_EVENT_FLAGS_AUTO_SUSPEND
+#define MSC_HOST_SUSPEND_RESUME_API_SUPPORTED
+#endif
+
 typedef struct msc_host_device *msc_host_device_handle_t;     /**< Handle to a Mass Storage Device */
 
 /**
@@ -32,10 +38,14 @@ typedef struct {
     enum {
         MSC_DEVICE_CONNECTED,       /**< MSC device has been connected to the system.*/
         MSC_DEVICE_DISCONNECTED,    /**< MSC device has been disconnected from the system.*/
+#ifdef MSC_HOST_SUSPEND_RESUME_API_SUPPORTED
+        MSC_DEVICE_SUSPENDED,       /**< MSC device has been suspended.*/
+        MSC_DEVICE_RESUMED,         /**< MSC device has been resumed.*/
+#endif // MSC_HOST_SUSPEND_RESUME_API_SUPPORTED
     } event;
     union {
-        uint8_t address;                /**< Address of connected MSC device.*/
-        msc_host_device_handle_t handle; /**< MSC device handle to disconnected device.*/
+        uint8_t address;                 /**< Address of connected MSC device.*/
+        msc_host_device_handle_t handle; /**< MSC device handle to disconnected, suspended or resumed device.*/
     } device;
 } msc_host_event_t;
 

host/class/msc/usb_host_msc/src/msc_host.c

@@ -1,5 +1,5 @@
 /*
- * SPDX-FileCopyrightText: 2015-2024 Espressif Systems (Shanghai) CO LTD
+ * SPDX-FileCopyrightText: 2015-2025 Espressif Systems (Shanghai) CO LTD
  *
  * SPDX-License-Identifier: Apache-2.0
  */
@@ -375,23 +375,57 @@ static msc_device_t *find_msc_device(usb_device_handle_t device_handle)
 
 static void client_event_cb(const usb_host_client_event_msg_t *event, void *arg)
 {
-    if (event->event == USB_HOST_CLIENT_EVENT_NEW_DEV) {
+    switch (event->event) {
+    case USB_HOST_CLIENT_EVENT_NEW_DEV:
+        ESP_LOGD(TAG, "New device connected");
         if (is_mass_storage_device(event->new_dev.address)) {
             const msc_host_event_t msc_event = {
                 .event = MSC_DEVICE_CONNECTED,
                 .device.address = event->new_dev.address,
             };
             s_msc_driver->user_cb(&msc_event, s_msc_driver->user_arg);
         }
-    } else if (event->event == USB_HOST_CLIENT_EVENT_DEV_GONE) {
-        msc_device_t *msc_device = find_msc_device(event->dev_gone.dev_hdl);
-        if (msc_device) {
+        break;
+    case USB_HOST_CLIENT_EVENT_DEV_GONE:
+        ESP_LOGD(TAG, "Device suddenly disconnected");
+        msc_device_t *msc_device_gone = find_msc_device(event->dev_gone.dev_hdl);
+        if (msc_device_gone) {
             const msc_host_event_t msc_event = {
                 .event = MSC_DEVICE_DISCONNECTED,
-                .device.handle = msc_device,
+                .device.handle = msc_device_gone,
+            };
+            s_msc_driver->user_cb(&msc_event, s_msc_driver->user_arg);
+        }
+        break;
+
+#ifdef MSC_HOST_SUSPEND_RESUME_API_SUPPORTED
+    case USB_HOST_CLIENT_EVENT_DEV_SUSPENDED:
+        ESP_LOGD(TAG, "Device suspended");
+        msc_device_t *msc_device_susp = find_msc_device(event->dev_gone.dev_hdl);
+        if (msc_device_susp) {
+            const msc_host_event_t msc_event = {
+                .event = MSC_DEVICE_SUSPENDED,
+                .device.handle = msc_device_susp,
+            };
+            s_msc_driver->user_cb(&msc_event, s_msc_driver->user_arg);
+        }
+        break;
+    case USB_HOST_CLIENT_EVENT_DEV_RESUMED:
+        ESP_LOGD(TAG, "Device resumed");
+        msc_device_t *msc_device_res = find_msc_device(event->dev_gone.dev_hdl);
+        if (msc_device_res) {
+            const msc_host_event_t msc_event = {
+                .event = MSC_DEVICE_RESUMED,
+                .device.handle = msc_device_res,
             };
             s_msc_driver->user_cb(&msc_event, s_msc_driver->user_arg);
         }
+        break;
+#endif // MSC_HOST_SUSPEND_RESUME_API_SUPPORTED
+
+    default:
+        ESP_LOGW(TAG, "Unrecognized USB Host client event");
+        break;
     }
 }