#maps #register #generate #struct #svd2rust #spirit #lvbitx

lvbitfile2rust

Generate Rust register maps (structs) from lvbitx files - in the spirit of svd2rust

2 releases

0.1.1 Aug 23, 2020
0.1.0 Aug 23, 2020

#900 in Procedural macros


Used in 2 crates

Custom license

16KB
279 lines

lvbitfile2rust

crates.io docs.rs CI

lvbitfile2rust generates static register maps from lvbitx files.

Invoking from the command line

cargo install lvbitfile2rust
lvbitfile2rust-cli /boot/user.lvbitx | rustfmt > rio.rs

Invoking as a macro

mod rio {
    use lvbitfile2rust_macros::lvbitfile2rust;
    lvbitfile2rust!("/boot/user.lvbitx");
}

Generated code

lvbitfile2rust generates code with a similar interface to code generated by svd2rust. The generated code contains a struct named Peripherals with an associated function named take. Calling take will attempt to open an FPGA session and return a Peripherals instance. The Peripherals instance contains fields for each register described by the input bitfile. These fields contain instances of structs corresponding to each register, with read and possibly write methods. In practice, the interface is rather straightforward to use:

use ni_fpga::fxp::UnsignedFXP;

mod rio {
    use lvbitfile2rust_macros::lvbitfile2rust;
    lvbitfile2rust!("/boot/user.lvbitx");
}

fn main() -> Result<(), Box<dyn std::error::Error>> {
    // Turn PWM on if the RSL is on!
    // My scope tells me the RSL blinks at 5Hz in teleop mode!
    let peripherals = rio::Peripherals::take("RIO0")?;
    loop {
        let leds = peripherals.LEDs.read()?;
        peripherals.PWM_Hdr0.write(&{
            if leds.RSL {
                UnsignedFXP::max_value()
            } else {
                UnsignedFXP::min_value()
            }
        })?;
    }
}

Generated code will depend on ni-fpga and ni-fpga-macros if the input bitfile uses Clusters or Enums.

Dependencies

~1.5MB
~40K SLoC