async-hid
A Rust library for asynchronously interacting with HID devices.
This crate aims the be a replacement for hidapi-rs without the baggage that comes from being a wrapper around a C library.
This crate generally offers a simpler and more streamlined api while also supporting async as best as possible.
Example
use ;
use SimpleLogger;
use StreamExt;
async
Platform Support
Operating System | Underlying API |
---|---|
Windows | WinRT (Windows.Devices.HumanInterfaceDevice ) |
Linux | hidraw |
MacOs | IOHIDManager |
Async
The amount of asynchronicity that each OS provides varies. The following tables gives a rough overview which calls utilize async under the hood.
enumerate |
open |
read_input_report |
write_output_report |
|
---|---|---|---|---|
Windows | ✔️ | ✔️ | ✔️ | ✔️ |
Linux | ❌ | ❌ | ✔️ | ✔️ |
MacOS | ❌ | ✔️ | ✔️ | ❌ |
Under Linux this crate requires a tokio
runtime while the Window and MacOS backends are runtime agnostic.
Planned Features
- Reading / Writing feature reports
- Listening for changes to the device list
- More unified error handling
License
MIT License