hid-decode 0.3.1

HID report descriptor decoding utilities
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53

use std::io::stdout;
use std::path::PathBuf;
use std::process::ExitCode;

use clap::Parser;
use hid_decode::TextDecoder;

#[derive(Debug, Clone, Parser)]
struct Arguments {
    /// A file containing a binary HID descriptor.
    descriptor_filename: PathBuf,
    /// Display the hex bytes corresponding to each item.
    #[arg(long)]
    show_bytes: bool,
    /// Display the tag type for each item.
    #[arg(long)]
    show_tag_types: bool,
    /// Reject zero-length item values.
    #[arg(long)]
    reject_zero_length_values: bool,
}

fn main() -> ExitCode {
    let args = Arguments::parse();

    let descriptor_bytes = match std::fs::read(&args.descriptor_filename) {
        Ok(bytes) => bytes,
        Err(e) => {
            eprintln!("failed to read {}: {e}", args.descriptor_filename.display());
            return ExitCode::FAILURE;
        }
    };

    let mut decoder = TextDecoder::new(stdout());

    if args.show_bytes {
        decoder = decoder.display_raw_bytes();
    }
    if args.show_tag_types {
        decoder = decoder.display_tag_type();
    }
    if args.reject_zero_length_values {
        decoder = decoder.reject_zero_length_values();
    }

    match decoder.decode(&descriptor_bytes) {
        Ok(()) => ExitCode::SUCCESS,
        Err(e) => {
            eprintln!("error writing decoded descriptor: {e}");
            ExitCode::FAILURE
        }
    }
}