Skip to main content

usb3_configure/
usb3_configure.rs

1//! Load a caller-supplied bitstream onto a board, bind it, print its identity: `usb3_configure
2//! <bit> [serial]`, `<bit>` being **the** release bitstream (`make all`). Volatile — no flash — but
3//! it evicts whatever was running: NOT safe on a shared board. Compare the printed sha yourself.
4
5use std::fs;
6use std::process::ExitCode;
7
8use kdi::Commands;
9
10fn main() -> ExitCode {
11    let mut args = std::env::args().skip(1);
12    let Some(bit) = args.next() else {
13        eprintln!("usage: usb3_configure <bit> [serial]");
14        return ExitCode::FAILURE;
15    };
16    let serial = args.next().unwrap_or_default();
17
18    let image = match fs::read(&bit) {
19        Ok(b) => b,
20        Err(e) => {
21            eprintln!("{bit}: {e}");
22            return ExitCode::FAILURE;
23        }
24    };
25
26    let mut dev = match kdi::Device::open_usb3_configured(&serial, &image) {
27        Ok(d) => d,
28        Err(e) => {
29            eprintln!("configure + open failed: {e}");
30            return ExitCode::FAILURE;
31        }
32    };
33
34    let (major, minor) = dev.kdi();
35    let sha = dev.gateware_sha();
36    let caps = dev.caps();
37    println!("serial          {}", dev.info().serial);
38    println!("contract        {major}.{minor}");
39    println!("gateware_sha    {sha:08x}");
40    println!("caps            0x{:08x}", caps.0);
41    if caps.has(kdi::Cap::CommandProtocol) {
42        match dev.sys_hello() {
43            Ok(h) => println!("fw_sha          {}", h.fw),
44            Err(e) => {
45                eprintln!("sys.hello failed: {e}");
46                return ExitCode::FAILURE;
47            }
48        }
49    } else {
50        println!("fw_sha          -");
51    }
52
53    if let Err(e) = dev.close() {
54        eprintln!("close: {e}");
55        return ExitCode::FAILURE;
56    }
57    println!("configure OK");
58    ExitCode::SUCCESS
59}