MUSB

musb(Mentor USB) Registers and embassy-usb-driver , usb-device Implementation.

The MUSBMHDRC (musb) is a USB 2.0 Multi-Point, Dual-Role Controller designed by Mentor Graphics Corp. It is widely used by various manufacturers in microcontrollers and SoCs, including companies like TI, MediaTek, Puya, Allwinner, and others.

Quick Start

If your chip uses standard MUSB IP

(and hasn't disabled features like Dynamic FIFO size configuration)

Add musb to your Cargo.toml:

[dependencies]
musb = { version = "0.1.0", features = ["builtin-std"] }

You can use the std profile by enabling the builtin-std feature. This profile doesn't include a base_address, so it won't generate a UsbInstance (explained below).

You can then set the number of endpoints using the endpoints-num-x feature (e.g., endpoints-num-8). The total FIFO size can be configured using the total-fifo-size-dword-x feature (e.g., total-fifo-size-dword-256 where 256 double-words = 2048 bytes) (TODO). Currently, endpoints-num-x and total-fifo-size-dword-x are not effective when the prebuild feature is enabled.

If your chip's IP differs from the standard MUSB IP

These built-in profiles are used via Cargo features (see below), with only one selectable:

• builtin-py32f07x
• builtin-py32f403
• builtin-std (excludes base_address and endpoints_num)

If your chip is not included, you'll need to create a new profile. Refer to the Porting Guide for more details.

Features

embassy-usb-driver-impl: Enables embassy-usb-driver implementation.

usb-device-impl: Enables usb-device implementation.

Note: Only one of these two implementations can be enabled at a time.

prebuild(on by default): Uses pre-generated PAC (Peripheral Access Crate).

builtin-xxxx: Uses builtin profile.

endpoints-num-x: Specifies the number of endpoints. Only needs to be set when this information is not provided in the profile.

total-fifo-size-dword-x: Specifies the total FIFO size. Only needs to be set when using dynamic FIFO sizing and this information is not provided in the profile.

defmt, log: Enables debug logging.

Examples

hal example: py32-hal/src/usb.rs · py32-rs/py32-hal

embassy-usb: py32-hal/examples/py32f072

usb-device: py32-hal/examples/usbd-f072

Porting

Refer to the Porting Guide for more details.

You can also refer to this blog (in Chinese): PY32的musb(Mentor USB)的Rust支持 - Decaday

Contribution

If you have any questions or uncertainties, feel free to create an Issue or start a Discussion.

TODOs

• Support Dynamic FIFO Size
• better support for standard musb
• Support dual packet buffer
• Support SiFli SF32BL52
• Other Chips
• host mode

License

This project is under Apache License, Version 2.0 (LICENSE or http://www.apache.org/licenses/LICENSE-2.0)