5 releases

0.2.2 Apr 22, 2024
0.2.1 Mar 6, 2024
0.2.0 Nov 13, 2023
0.1.1 Oct 3, 2020
0.1.0 Jul 24, 2019

#97 in Embedded development

Download history 3524/week @ 2024-12-14 1400/week @ 2024-12-21 1574/week @ 2024-12-28 3341/week @ 2025-01-04 3894/week @ 2025-01-11 2883/week @ 2025-01-18 2857/week @ 2025-01-25 3133/week @ 2025-02-01 2245/week @ 2025-02-08 2099/week @ 2025-02-15 2147/week @ 2025-02-22 1914/week @ 2025-03-01 2419/week @ 2025-03-08 2509/week @ 2025-03-15 3105/week @ 2025-03-22 2048/week @ 2025-03-29

10,252 downloads per month
Used in 65 crates (60 directly)

MIT license

37KB
755 lines

usbd-serial

CDC-ACM USB serial port implementation for usb-device.

CDC-ACM is a USB class that's supported out of the box by most operating systems and used for implementing modems and generic serial ports. The SerialPort class implements a stream-like buffered serial port that can be used similarly to a normal UART.

The crate also contains CdcAcmClass which is a lower-level implementation that has less overhead, but requires more care to use correctly.

Example

A full example requires the use of a hardware-driver, but the hardware independent part is as follows:

let mut serial = SerialPort::new(&usb_bus);

let mut usb_dev = UsbDeviceBuilder::new(&usb_bus, UsbVidPid(0x16c0, 0x27dd))
    .product("Serial port")
    .device_class(USB_CLASS_CDC)
    .build();

loop {
    if !usb_dev.poll(&mut [&mut serial]) {
        continue;
    }

    let mut buf = [0u8; 64];

    match serial.read(&mut buf[..]) {
        Ok(count) => {
            // count bytes were read to &buf[..count]
        },
        Err(UsbError::WouldBlock) => // No data received
        Err(err) => // An error occurred
    };

    match serial.write(&[0x3a, 0x29]) {
        Ok(count) => {
            // count bytes were written
        },
        Err(UsbError::WouldBlock) => // No data could be written (buffers full)
        Err(err) => // An error occurred
    };
}

Dependencies

~2MB
~32K SLoC