feat(esp_tinyusb): Added device suspend/resume events

[peter-marcisovsky]

Description

This PR adds suspend/resume events to the device event callback handler

Reason for this change:

• Current esp_tinyusb V.2 lacks suspend/resume events needed for further HID Host tests, CDC-ACM Host tests and general usage of the esp_tinyusb

The device events are implemented using tud_suspend_cb() and tud_suspend_cb() provided by TinyUSB. The callbacks registering in configurable via Kconfig. Users can:

• register tud_suspend_cb() and tud_suspend_cb() in esp_tinyusb and benefit from internal event handling
• register their own custom callback

Related

• Needed for feat(hid_host): Remote wakeup #385
• Needed for feat(cdc_acm_host): Remote wakeup (IEC-453) #345
• Fixes feat(usb_host): Fix abort on failed suspend/resume #379
• Follow-up for feat(esp_tinyusb): Added suspend resume handling, possibilty to wake up Host #252

---

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

Medium Risk
Medium risk because it introduces new TinyUSB callback hooks (tud_suspend_cb/tud_resume_cb) behind Kconfig flags and adds a new public API (tinyusb_remote_wakeup) that changes runtime USB device behavior and is exercised in CI with new hardware-dependent tests.

Overview
Adds optional USB device suspend/resume event reporting to esp_tinyusb, gated by new Kconfig flags (CONFIG_TINYUSB_SUSPEND_CALLBACK, CONFIG_TINYUSB_RESUME_CALLBACK) that register strong tud_suspend_cb()/tud_resume_cb() implementations and emit TINYUSB_EVENT_SUSPENDED/TINYUSB_EVENT_RESUMED (including a remote-wakeup-enabled bit on suspend).

Introduces a new public API tinyusb_remote_wakeup() and internal tracking of host-enabled remote wakeup, plus documentation/CHANGELOG updates describing the opt-in behavior and linker constraints.

Extends CI and test coverage with a new power_management device test app and pytest suite validating suspend/resume event delivery and remote wakeup behavior, and updates the USB runner workflow/container setup to mount /dev/bus/usb and install libusb for pyusb-based tests.

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

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{Bugbot Autofix is OFF. To automatically fix reported issues with Cloud Agents, enable Autofix in the Cursor dashboard.}

[tore-espressif]

@peter-marcisovsky nice work, LGTM!