jaylink 0.1.1

Library to communicate with J-Link USB devices
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
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99

use jaylink::*;
use std::fmt::Write;

fn main() {
    env_logger::init();

    if let Err(e) = run() {
        eprintln!("error: {}", e);
        std::process::exit(1);
    }
}

fn run() -> Result<()> {
    let list = jaylink::scan_usb()?.collect::<Vec<_>>();
    println!(
        "Found {} J-Link device{}.",
        list.len(),
        if list.len() == 1 { "" } else { "s" },
    );

    for devinfo in list {
        println!();
        print!(
            "Bus {:03} Address {:03} Port {:03}: VID={:04x} PID={:04X} – ",
            devinfo.bus_number(),
            devinfo.address(),
            devinfo.port_number(),
            devinfo.vid(),
            devinfo.pid(),
        );

        let dev_data;
        let dev = match devinfo.open() {
            Ok(dev) => {
                dev_data = format!(
                    "{} {} (Serial {})",
                    dev.manufacturer_string(),
                    dev.product_string(),
                    dev.serial_string(),
                );
                Some(dev)
            }
            Err(e) => {
                dev_data = format!("<{}>", e.to_string());
                None
            }
        };

        println!("{}", dev_data);

        if let Some(dev) = dev {
            // Print detailed information read from the device
            let info = match detailed_info(&dev) {
                Ok(info) => info,
                Err(e) => format!("<{}>", e),
            };

            // This is multi-line info
            for (i, line) in info.lines().enumerate() {
                if i == 0 {
                    print!("⤷ ");
                } else {
                    print!("  ");
                }

                println!("{}", line);
            }
        }
    }

    Ok(())
}

fn detailed_info(dev: &JayLink) -> Result<String> {
    let caps = dev.read_capabilities()?;
    let firmware = dev.read_firmware_version()?;
    let hw_vers = dev.read_hardware_version()?;
    let speeds = dev.read_speeds()?;
    let max_mem_block = dev.read_max_mem_block()?;
    let intf = dev.read_current_interface()?;
    let avail_intfs = dev
        .read_available_interfaces()?
        .map(|intf| intf.to_string())
        .collect::<Vec<_>>()
        .join(", ");
    let tgt_voltage = dev.read_target_voltage()?;

    let mut info = String::new();
    writeln!(info, " Capabilities: {:?}", caps).unwrap();
    writeln!(info, "     Firmware: {}", firmware).unwrap();
    writeln!(info, "   HW Version: {}", hw_vers).unwrap();
    writeln!(info, "       Speeds: {:?}", speeds).unwrap();
    writeln!(info, "Max. Memblock: {} bytes", max_mem_block).unwrap();
    writeln!(info, "    Interface: {}", intf).unwrap();
    writeln!(info, "Avail. Interf: {}", avail_intfs).unwrap();
    writeln!(info, "        VTref: {} V", tgt_voltage as f32 / 1000.0).unwrap();

    Ok(info)
}