Add embassy-usb-host support by bugadani · Pull Request #5283 · esp-rs/esp-hal

bugadani · 2026-03-30T16:00:10Z

Implementation for embassy-rs/embassy#5633

github-actions · 2026-03-31T12:14:14Z

New commits in main has made this PR unmergable. Please resolve the conflicts.

brezina1 · 2026-04-01T10:07:18Z

Amazing! Do you also plan on adding UVC device support?

Dominaezzz · 2026-04-01T10:14:20Z

Amazing! Do you also plan on adding UVC device support?

I think that's a little out of scope for this whole repository 😅

bugadani · 2026-04-01T10:31:41Z

oh I thought that comment was made against the embassy repo 😅 I don't know if I have an appropriate camera, but maybe Claude can draft something up?

github-actions · 2026-04-02T12:10:52Z

New commits in main has made this PR unmergable. Please resolve the conflicts.

Copilot

Pull request overview

This PR adds USB OTG FS host-mode support via embassy-usb-host and refactors the existing OTG FS support into a dedicated otg_fs/ module layout, updating examples and metadata to use the new driver modules.

Changes:

Introduces esp_hal::otg_fs::embassy_usb_host host controller driver based on embassy-usb-host.
Moves the existing embassy USB device-mode integration into esp_hal::otg_fs::embassy_usb_device and updates async examples accordingly.
Updates esp-metadata (and generated metadata) to attach the USB peripheral interrupt to USB0.

Reviewed changes

Copilot reviewed 15 out of 16 changed files in this pull request and generated 6 comments.

Show a summary per file

File	Description
examples/async/embassy_usb_serial/src/main.rs	Updates import path to the new `otg_fs::embassy_usb_device` module.
examples/async/embassy_usb_ethernet/src/main.rs	Updates import path to the new `otg_fs::embassy_usb_device` module.
examples/async/embassy_usb_ethernet/Cargo.lock	Updates esp-pacs git rev in the example lockfile.
examples/async/embassy_usb_hid_host/src/main.rs	Adds a new async HID host example using `embassy-usb-host`.
examples/async/embassy_usb_hid_host/Cargo.toml	Adds a new example crate manifest for the HID host example.
examples/async/embassy_usb_hid_host/.cargo/config.toml	Adds example-specific runner/rustflags and build-std config.
esp-metadata/devices/esp32s2.toml	Associates `USB0` with the `USB` peripheral interrupt.
esp-metadata/devices/esp32s3.toml	Associates `USB0` with the `USB` peripheral interrupt.
esp-metadata-generated/src/_generated_esp32s2.rs	Regenerates peripheral interrupt bindings for `USB0`.
esp-metadata-generated/src/_generated_esp32s3.rs	Regenerates peripheral interrupt bindings for `USB0`.
esp-hal/src/otg_fs/mod.rs	New OTG FS module root, factoring common USB peripheral setup and exposing host/device submodules.
esp-hal/src/otg_fs/embassy_usb_device.rs	New embassy-usb device-mode driver wrapper with custom init/interrupt binding.
esp-hal/src/otg_fs/embassy_usb_host.rs	New embassy-usb-host controller driver and interrupt wiring.
esp-hal/src/otg_fs.rs	Removes the previous monolithic OTG FS module file (replaced by `otg_fs/`).
esp-hal/Cargo.toml	Enables `embassy-usb-synopsys-otg` `host` feature to support host mode.
esp-hal/CHANGELOG.md	Adds changelog entries for host support and the device module move.

+        on_host_interrupt(
+            Driver::REGISTERS,
+            &HOST_STATE,
+            Usb::MAX_EP_COUNT.min(Usb::MAX_HOST_CH_COUNT),
+        )
+    }


Copilot

Pull request overview

Copilot reviewed 15 out of 16 changed files in this pull request and generated 6 comments.

github-actions · 2026-05-04T10:02:22Z

New commits in main have made this PR unmergeable. Please resolve the conflicts.

Copilot

Pull request overview

Copilot reviewed 15 out of 16 changed files in this pull request and generated 3 comments.

github-actions · 2026-05-05T10:58:19Z

New commits in main have made this PR unmergeable. Please resolve the conflicts.

github-actions · 2026-05-06T07:52:20Z

New commits in main have made this PR unmergeable. Please resolve the conflicts.

Copilot

Pull request overview

Copilot reviewed 15 out of 16 changed files in this pull request and generated 2 comments.

bjoernQ · 2026-05-07T15:27:52Z

Seems the hid-host doesn't work for me - it doesn't enumerate.

Might be my soldering however - so would be good if someone else could give it a try.

usb-device still works fine for me, code LGTM

github-actions · 2026-05-07T15:38:49Z

New commits in main have made this PR unmergeable. Please resolve the conflicts.

bugadani · 2026-05-07T15:53:23Z

Here's the output of my mouse:

This is running on a Freenove S3 CAM or whatever is the name of the board, because it has a type-c USB port so I can use my cute type-c to microusb cable. But the code was also tested on an S3-BOX-3 :)

github-actions · 2026-05-07T17:54:08Z

New commits in main have made this PR unmergeable. Please resolve the conflicts.

This comment was marked as outdated.

Sign in to view

bugadani force-pushed the usb-host branch from 0cb243a to d096a25 Compare March 31, 2026 07:09

github-actions Bot added the merge-conflict Merge conflict detected. Automatically added/removed by CI. label Mar 31, 2026

bugadani force-pushed the usb-host branch from d096a25 to 672c50f Compare April 1, 2026 11:00

github-actions Bot added merge-conflict Merge conflict detected. Automatically added/removed by CI. and removed merge-conflict Merge conflict detected. Automatically added/removed by CI. labels Apr 1, 2026

bugadani force-pushed the usb-host branch from 672c50f to b2c269e Compare April 17, 2026 12:57

github-actions Bot removed the merge-conflict Merge conflict detected. Automatically added/removed by CI. label Apr 17, 2026

bugadani force-pushed the usb-host branch from b2c269e to b3fb9e5 Compare May 4, 2026 06:38

bugadani changed the title ~~Usb host~~ Add embassy-usb-host support May 4, 2026

bugadani force-pushed the usb-host branch from 247ff71 to 3fbd1ad Compare May 4, 2026 07:18

bugadani marked this pull request as ready for review May 4, 2026 07:37

Copilot AI review requested due to automatic review settings May 4, 2026 07:37

Copilot started reviewing on behalf of bugadani May 4, 2026 07:38 View session

Copilot AI reviewed May 4, 2026

View reviewed changes

bugadani force-pushed the usb-host branch from 3fbd1ad to b773444 Compare May 4, 2026 07:59

Copilot AI review requested due to automatic review settings May 4, 2026 08:52

Copilot started reviewing on behalf of bugadani May 4, 2026 08:53 View session

Copilot AI reviewed May 4, 2026

View reviewed changes

github-actions Bot added the merge-conflict Merge conflict detected. Automatically added/removed by CI. label May 4, 2026

Copilot AI review requested due to automatic review settings May 4, 2026 10:03

bugadani force-pushed the usb-host branch from 713666d to 7e71b27 Compare May 4, 2026 10:03

github-actions Bot removed the merge-conflict Merge conflict detected. Automatically added/removed by CI. label May 4, 2026

Copilot started reviewing on behalf of bugadani May 4, 2026 10:07 View session

Copilot started reviewing on behalf of bugadani May 5, 2026 09:20 View session

Copilot AI reviewed May 5, 2026

View reviewed changes

Comment thread esp-hal/Cargo.toml

Comment thread esp-hal/src/otg_fs/mod.rs

Comment thread esp-hal/src/otg_fs/embassy_usb_device.rs

github-actions Bot added the merge-conflict Merge conflict detected. Automatically added/removed by CI. label May 5, 2026

bugadani added 9 commits May 5, 2026 13:01

Restructure OTG-FS driver

a1b52c4

Add USB host impl

c92e858

Add example

32a0fdb

Clean up USB interrupt binding

94f2c30

Changelog

9d6df88

Update to released APIs

e61473a

Update docs

c70126f

Update locked deps

52c9313

Fixes

f2245c3

bugadani force-pushed the usb-host branch from 5f761c2 to f2245c3 Compare May 5, 2026 11:02

github-actions Bot added merge-conflict Merge conflict detected. Automatically added/removed by CI. and removed merge-conflict Merge conflict detected. Automatically added/removed by CI. labels May 5, 2026

Merge branch 'main' into usb-host

6a0e743

Copilot AI review requested due to automatic review settings May 6, 2026 07:53

github-actions Bot removed the merge-conflict Merge conflict detected. Automatically added/removed by CI. label May 6, 2026

Copilot started reviewing on behalf of bugadani May 6, 2026 08:01 View session

Copilot AI reviewed May 6, 2026

View reviewed changes

Comment thread examples/async/embassy_usb_hid_host/src/main.rs

Comment thread esp-hal/CHANGELOG.md

github-actions Bot added the merge-conflict Merge conflict detected. Automatically added/removed by CI. label May 7, 2026

Merge branch 'main' into usb-host

78818fa

github-actions Bot removed the merge-conflict Merge conflict detected. Automatically added/removed by CI. label May 7, 2026

github-actions Bot added the merge-conflict Merge conflict detected. Automatically added/removed by CI. label May 7, 2026

Conversation

bugadani commented Mar 30, 2026

Uh oh!

This comment was marked as outdated.

github-actions Bot commented Mar 31, 2026

Uh oh!

brezina1 commented Apr 1, 2026

Uh oh!

Dominaezzz commented Apr 1, 2026

Uh oh!

bugadani commented Apr 1, 2026

Uh oh!

github-actions Bot commented Apr 2, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

github-actions Bot commented May 4, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

github-actions Bot commented May 5, 2026

Uh oh!

github-actions Bot commented May 6, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

bjoernQ commented May 7, 2026

Uh oh!

github-actions Bot commented May 7, 2026

Uh oh!

bugadani commented May 7, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions Bot commented May 7, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

bugadani commented May 7, 2026 •

edited

Loading