Skip to main content

read_input/
read_input.rs

1//! Open a device by VID/PID and dump input reports plus its parsed report
2//! descriptor, driving hidra's futures blocking with `.wait()`.
3//!
4//! ```sh
5//! cargo run --example read_input -- 046d c216
6//! ```
7
8use std::env;
9
10use hidra::MaybeFuture;
11
12fn main() -> hidra::HidResult<()> {
13    let mut args = env::args().skip(1);
14    let vid = u16::from_str_radix(&args.next().expect("usage: read_input <vid> <pid>"), 16)
15        .expect("vid must be hex");
16    let pid = u16::from_str_radix(&args.next().expect("usage: read_input <vid> <pid>"), 16)
17        .expect("pid must be hex");
18
19    let api = hidra::Hidra::new()?;
20    let device = api.open(vid, pid).wait()?;
21
22    println!("product: {:?}", device.get_product_string().wait()?);
23    let descriptor = device.parsed_report_descriptor().wait()?;
24    println!(
25        "report descriptor: {} top-level collection(s), max input report {} bytes, numbered ids: {}",
26        descriptor.collections.len(),
27        descriptor.max_report_size(hidra::descriptor::ReportKind::Input),
28        descriptor.uses_report_ids(),
29    );
30
31    println!("reading input reports (ctrl-c to quit)...");
32    let mut buf = [0u8; 256];
33    loop {
34        // Blocks until a report arrives; never returns 0.
35        let len = device.read(&mut buf).wait()?;
36        println!("{:02x?}", &buf[..len]);
37    }
38}