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

[peter-marcisovsky]

Description

This MR adds Suspend/Resume events for MSC class driver as a follow-up for the Global/Suspend resume feature for usb component.

Added a backward compatibility for older IDF releases, where the suspend/resume will not be backported, by:

// 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

Related

• Suspend/Resume support for MSC Class driver

Testing

• Added tests, which verify the class driver functionality with root port Suspend/Resume events

---

Checklist

Before submitting a Pull Request, please ensure the following:

• 🚨 This PR does not introduce breaking changes.
• All CI checks (GH Actions) pass.
• Documentation is updated as needed.
• Tests are updated or added as necessary.
• Code is well-commented, especially in complex areas.
• Git history is clean — commits are squashed to the minimum necessary.

---

Note

Add global suspend/resume support to MSC host (new events and client handling) with backward-compatible API guard and comprehensive test coverage.

• MSC Host Driver:
  • Add MSC_DEVICE_SUSPENDED and MSC_DEVICE_RESUMED events; handle USB_HOST_CLIENT_EVENT_DEV_SUSPENDED/DEV_RESUMED in client_event_cb (switch-based refactor, improved logs).
  • Include usb/usb_host.h; update SPDX years.
• Public API (include/usb/msc_host.h):
  • Gate suspend/resume support with MSC_HOST_SUSPEND_RESUME_API_SUPPORTED (defined if USB_HOST_LIB_EVENT_FLAGS_AUTO_SUSPEND).
  • Extend msc_host_event_t to carry suspended/resumed events and use device handle for them.
• Tests (test_app/main/test_msc.c):
  • Add suspend/resume suites: suspend_resume, auto_suspend_timer (one-shot/periodic PM), resume_by_transfer_submit, suspended_device_open_close, suspended_device_sudden_disconnect, sudden_suspend, sudden_suspend_from_another_task.
  • Introduce wait_for_app_event, unify base path via BASE_PATH, handle USB_HOST_LIB_EVENT_FLAGS_AUTO_SUSPEND, and minor fixes (typos, cleanup).
• Changelog:
  • Note added global suspend/resume support.

^{Written by Cursor Bugbot for commit db50486. This will update automatically on new commits. Configure here.}

[tore-espressif]

LGTM!

[tore-espressif]

Tested on P4-ECO5, works great, thanks!