Crate usb_enumeration[][src]

A cross platform Rust library that returns the vendor and product IDs of currently connected USB devices

Actions Status

Example

let devices = usb_enumeration::enumerate(None, None);

println!("{:#?}", devices);

// Outputs:
// [
//   UsbDevice {
//       id: "USB\\VID_0CE9&PID_1220\\0000000004BE",
//       vendor_id: 3305,
//       product_id: 4640,
//       description: Some(
//           "PicoScope 4000 series PC Oscilloscope",
//       ),
//   },
//   UsbDevice {
//       id: "USB\\VID_046D&PID_C52B\\5&17411534&0&11",
//       vendor_id: 1133,
//       product_id: 50475,
//       description: Some(
//           "USB Composite Device",
//       ),
//   },
//   UsbDevice {
//       id: "USB\\VID_046D&PID_C52B&MI_00\\6&12D311A2&0&0000",
//       vendor_id: 1133,
//       product_id: 50475,
//       description: Some(
//           "Logitech USB Input Device",
//       ),
//   },
//     etc...
// ]

You can also subscribe to events using the Observer:

use usb_enumeration::{Observer, Event};

let sub = Observer::new()
    .with_poll_interval(2)
    .with_vendor_id(0x1234)
    .with_product_id(0x5678)
    .subscribe();

// when sub is dropped, the background thread will close

for event in sub.rx_event.iter() {
    match event {
        Event::Initial(d) => println!("Initial devices: {:?}", d),
        Event::Connect(d) => println!("Connected device: {:?}", d),
        Event::Disconnect(d) => println!("Disconnected device: {:?}", d),
    }   
}

Structs

Observer
Subscription
UsbDevice

Discovered USB device

Enums

Event

Events send from the Observer

Functions

enumerate

Enumerates connected USB devices