#devices #usb #peripheral #ip #embedded #otg #synopsys

no-std esp-synopsys-usb-otg

'usb-device' implementation for Synopsys USB OTG IP cores

4 releases

new 0.4.1 Apr 16, 2024
0.4.0 Dec 11, 2023
0.3.2 Jul 14, 2023
0.3.1 Nov 2, 2022

#115 in Hardware support

Download history 1945/week @ 2023-12-22 2192/week @ 2023-12-29 2103/week @ 2024-01-05 2049/week @ 2024-01-12 2392/week @ 2024-01-19 2128/week @ 2024-01-26 1880/week @ 2024-02-02 2126/week @ 2024-02-09 2172/week @ 2024-02-16 2313/week @ 2024-02-23 2447/week @ 2024-03-01 2729/week @ 2024-03-08 2814/week @ 2024-03-15 2439/week @ 2024-03-22 3339/week @ 2024-03-29 2558/week @ 2024-04-05

11,639 downloads per month
Used in 3 crates (2 directly)

MIT license

420KB
8K SLoC

crates.io crates.io

This is a fork of synopsys-usb-otg with support for ESP32-Sx added - please use https://github.com/stm32-rs/synopsys-usb-otg when not targeting ESP32-Sx

synopsys-usb-otg

usb-device implementation for Synopsys USB OTG IP cores.

This project is a successor to the great work started by @mvirkkunen.

Supported microcontrollers

  • STM32F429xx (OTG_FS and OTG_HS in FS mode)
  • STM32F401xx
  • STM32F446xx (OTG_FS and OTG_HS in FS mode)
  • STM32F723xx (OTG_FS and OTG_HS with internal HS PHY)
  • STM32H7xxxx (OTG1_HS and OTG2_HS in FS mode, and OTG1_HS with external HS PHY)
  • And others...

Usage

This driver is intended for use through a device hal library. Such hal library should implement UsbPeripheral for the corresponding USB peripheral object. This trait declares all the peripheral properties that may vary from one device family to the other. Additionally, hal should pass fs of hs feature to the synopsys-usb-otg library to define a peripheral type:

  • fs - for FullSpeed peripherals
  • hs - for HighSpeed peripherals

Only one peripheral type can be selected at the moment.

ULPI Transciever Delay

Some ULPI PHYs like the Microchip USB334x series require a delay between the ULPI register write that initiates the HS Chirp and the subsequent transmit command, otherwise the HS Chirp does not get executed and the deivce enumerates in FS mode. Some USB Link IP like those in the STM32H7 series support adding this delay to work with the affected PHYs. Enable the xcvrdly feature to add this delay.

Examples

See the usb-otg-workspace repo for different device-specific examples.

Dependencies

~1.5MB
~29K SLoC