Refactor(usb_host): Rename auto suspend timer public API

[peter-marcisovsky]

Description

Renaming usb_host_lib_set_auto_pm to usb_host_lib_set_auto_suspend.
Also renaming it's related enums and typedefs, to align with the new name.

No functional change, just renaming.

Suspend timer type enum

Renamed from:

typedef enum {
    USB_HOST_LIB_PM_SUSPEND_ONE_SHOT,               /**< USB Host lib power management -> Auto suspend one-shot timer */
    USB_HOST_LIB_PM_SUSPEND_PERIODIC,               /**< USB Host lib power management -> Auto suspend periodic timer */
} usb_host_lib_pm_t;

to

typedef enum {
    USB_HOST_LIB_AUTO_SUSPEND_ONE_SHOT,             /**< Automatic suspend one-shot timer */
    USB_HOST_LIB_AUTO_SUSPEND_PERIODIC,             /**< Automatic suspend periodic timer */
} usb_host_lib_auto_suspend_tmr_t;

Suspend timer public API functions

Renamed from

esp_err_t usb_host_lib_set_auto_pm(usb_host_lib_pm_t timer_type, size_t timer_interval_ms);

to

esp_err_t usb_host_lib_set_auto_suspend(usb_host_lib_auto_suspend_tmr_t timer_type, size_t timer_interval_ms);

Related

• feat(usb_host): Global suspend/resume #275
• feat(usb_host): MSC Host add suspend/resume events #181
• feat(usb_host): HID Host add suspend/resume events #182
• feat(usb_host): CDC-ACM Host add suspend/resume events #206
• feat(uac_host): Add global suspend/resume #211
• feat(usb_host): UVC Host add suspend/resume events #328

---

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

Renames usb_host_lib_set_auto_pm and related PM types/constants to usb_host_lib_set_auto_suspend with new auto-suspend enum names, and updates core implementation and tests accordingly.

• API (usb_host.h):
  • Rename usb_host_lib_set_auto_pm(...) → usb_host_lib_set_auto_suspend(...).
  • Replace usb_host_lib_pm_t with usb_host_lib_auto_suspend_tmr_t.
  • Replace USB_HOST_LIB_PM_SUSPEND_ONE_SHOT/PERIODIC with USB_HOST_LIB_AUTO_SUSPEND_ONE_SHOT/PERIODIC.
• Core (usb_host.c):
  • Rename internal timer objects and helpers: auto_pm_timer → auto_suspend_timer, reset_pm_timer/stop_pm_timer → reset_auto_suspend_timer/stop_auto_suspend_timer, auto_pm_timer_cb → auto_suspend_timer_cb.
  • Wire new API and naming through install/uninstall, event handling, and logging.
• Tests:
  • Update CDC/MSC tests and USB host target tests to new API and constants.
  • Rename test macros, comments, and log tags from PM timer to suspend timer; adjust calls accordingly.

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

[roma-jam]

One blocking note from my side regarding the public API update and potential breaking change during the non-breaking release.
Oh, we didn't release it yet. Than, no blocking notes.

Otherwise, LGTM.