How to setup

[thewh1teagle]

I would like to use this crate for creating rust program which will install libusb driver for raspberry pi pico, similar to what you did here:
https://github.com/blackmagic-debug/bmputil/blob/main/src/windows.rs

1. I'm not sure how to adapt it
2. and if I should detect it by PID / VID?
3. How to grab the info? Will it work for every pico board I'll try?
4. Can I do that even when the board isn't connected?

[chekoopa]

I'll do some necro posting for future reference.

The example below is used to install Libusb0 WCID driver, but you're free to change options according to your needs.

VID/PID are provided in DeviceInfo and the installed driver applies to every device with this identity.
You can perform this installation even when the device isn't available (moreover, it is a better option).

// Refer to libwdi documentation for options help

// Describe device settings
let mut dev: wdi::DeviceInfo = wdi::DeviceInfo {
  vid: 0x1234, // <-- used when WCID is off, so you should
  pid: 0x5678, // <--   write your VID/PID here
  is_composite: false,
  mi: 0,
  desc: CString::new("My greatest invention").unwrap().into_bytes_with_nul().to_vec(),
  driver: None,
  device_id: None,
  hardware_id: None,
  compatible_id: None,
  upper_filter: None,
  driver_version: 0,
};

// Describe driver options
let mut popt = wdi::PrepareDriverOptions::default()
  .driver_type(wdi::DriverType::Libusb0) // <-- you may want to change it to WinUSB
  .use_wcid_driver(true); // <-- and delete this line

// Installation options, defaults are ok in most cases.
let mut iopt = wdi::InstallDriverOptions::default();

// You have to provide a directory to unpack the prepared driver
// Better use tempdir or some crate to reduce clutter
let unpack_path = "usb_drivers";

eprintln!("Preparing driver...");

wdi::prepare_driver(&mut dev, &unpack_path, "usb_device.inf", &mut popt).map_err(|e| {
  format!("Driver prepare error: {}", e)
})?;

eprintln!("Driver is ready.");

// A little pause to ensure the driver is really ready. Not sure it is needed.
std::thread::sleep(std::time::Duration::from_secs(1));

eprintln!("\nInstalling driver... It may take up to a few minutes.");
eprintln!("No progress is reported, so DO NOT CLOSE THE WINDOW.");
eprintln!("(In case of failure, try restarting the app with admin privileges)");

wdi::install_driver(&mut dev, &unpack_path, "usb_device.inf", &mut iopt).map_err(|e| {
  format!("Driver install error: {}", e)
})?;

eprintln!("Driver successfully installed.");