blackmagic-debug/wdi-rs

Extremely WIP Rust interface to libwdi

wdi-rs — A safe Rust wrapper for libwdi

Warning: this crate is extremely work in progress and the actual wrapping is very bare bones. The functionality implemented exists almost entirely for bmputil.

Cross compilation

Considerable effort has been put into libwdi-sys's build script to ensure cross compilation works as seamlessly as possible. It will, however, require an existing Windows target cross toolchain setup, but cargo-xwin can take care of most of that for you.

The only other requirement is the Windows 8.0 Driver Kit redistributable components, with the environment variable WDK_DIR set to the path it's been extracted to, e.g. export WDK_DIR=/opt/wdk/8.0.

wdi-rs's Issues

build requires nightly due to `exit_status_error`

This library requires a nightly build, due to build.rs using #[feature(exit_status_error)]. This is part of issue rust-lang/rust#84908.

It is possible to build this using a stable compiler by setting RUSTC_BOOTSTRAP=1 or by using a nightly compiler.

The nightly requirement should be noted in the README, or this feature should be removed to allow it to be built on a stable compiler.

How to setup

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?