feat(usb_host): Exit suspend state by port reset

[peter-marcisovsky]

Description

According to the programming guide, there are several ways how to exit suspended state:

• Host initiated resume
  • calling usb_host_lib_root_port_resume()
• Device initiated remote wakeup
  • in progress in USB Host remote wakeup #298
• Device disconnect
  • already working
• Host initiated reset
  • this PR
• and others which are not relevant for us yet.

Exiting Suspend Through Host Initiated Reset

When the port is in suspended state, it must react to HCD_PORT_CMD_RESET command, which will effectively resume the root port after the reset sequence.

This change does not bring any benefits right now, adding it just for the sake of the completeness of the global suspend/resume feature.

Related

• Follow-up for feat(usb_host): Global suspend/resume #275

Testing

---

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

Enable host-initiated reset while port is suspended to exit suspend; add ping helper and tests, including a new suspend+reset test.

• Driver (HCD DWC)
  • Allow HCD_PORT_CMD_RESET when port is HCD_PORT_STATE_SUSPENDED in _port_cmd_reset() (host/usb/src/hcd_dwc.c).
• Tests
  • Add TRANSFER_MAX_BYTES and test_hcd_ping_device() helper to probe device responsiveness (host/usb/test/target_test/common/hcd_common.{c,h}).
  • Update suspend/resume and sudden disconnect tests to use test_hcd_ping_device(), manage URB lifecycle, and validate states (host/usb/test/target_test/hcd/main/test_hcd_port.c).
  • Add new test "Test HCD port suspend and resume port reset" verifying reset exits suspend and restores enabled state while pipe remains halted (test_hcd_port.c).

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

[cursor]

This is the final PR Bugbot will review for you during this billing cycle

Your free Bugbot reviews will reset on December 20

Details

Your team is on the Bugbot Free tier. On this plan, Bugbot will review limited PRs each billing cycle for each member of your team.

To receive Bugbot reviews on all of your PRs, visit the Cursor dashboard to activate Pro and start your 14-day free trial.

[tore-espressif]

LGTM!