ni-fpga-rs

使用此Rust接口与NI FPGA交互！有关FPGA C接口的更多信息，请参阅NI的文档。

支持类型

此接口支持以下类型的读取和写入，既可以单独也可以在固定大小的数组中

基本类型

• bool
• u8
• u16
• u32
• u64
• i8
• i16
• i32
• i64
• f32 (用于SGL寄存器)
• f64 (用于DBL寄存器)

Cluster

通过 derive 宏支持 Cluster。Cluster 数组不支持保证。

#[derive(Cluster)]
struct PWMConfig {
    period: u16,
    min_high: u16,
}

枚举

通过 derive 宏支持枚举。也支持枚举数组。根据变体的数量，将选择 u8、u16、u32 或 u64 作为基础类型。

#[derive(Enum)]
enum SPIDebugState {
    Idle,
    CheckWindow,
    CheckAvailable,
    SetFIFOMark,
    EnableSPI,
    StuffFIFO,
    CheckMark,
    ShuffleData,
    Disable,
}

定点数值类型

在 fxp 模块中实现了有符号和无符号的 FXP 类型。这两种类型都接受两个泛型参数：字长和整数长度。字长是该类型实际使用的位数。整数长度是这样的，该类型的最大值是 2^整数长度 - 1（如果是无符号则为半数）并且该类型的分辨率是 2^{整数长度 - 字长}。例如，如果一个无符号 FXP 的字长为 8 且整数长度为 7，则其最大值是 127 且其分辨率是 0.5。

assert_eq!(
    SignedFXP::<8, 7>::from_float(-1.5)? + SignedFXP::<8, 7>::from_float(4.0)?,
    SignedFXP::<8, 7>::from_float(2.5)?,
);

定位寄存器偏移

寄存器偏移可以通过在 roboRIO 上检查 /boot/user.lvbitx 来找到。此文件也存在于 first-rust-competition/cross-images 映像中。

完整示例

use ni_fpga::Session;
use ni_fpga_macros::{Cluster, Enum};

#[derive(Cluster, Debug)]
struct PWMConfig {
    period: u16,
    min_high: u16,
}
#[derive(Cluster, Debug)]
struct AnalogTriggerOutput {
    in_hysteresis: bool,
    over_limit: bool,
    rising: bool,
    falling: bool,
}

#[derive(Enum, Debug)]
enum SPIDebugState {
    Idle,
    CheckWindow,
    CheckAvailable,
    SetFIFOMark,
    EnableSPI,
    StuffFIFO,
    CheckMark,
    ShuffleData,
    Disable,
}

fn main() -> Result<(), ni_fpga::Error> {
    let session = Session::open(
        "/boot/user.lvbitx",
        "264D0BA312FF00B741D4742415E1D470",
        "RIO0",
    )?;

    println!("Input voltage: {:?}", session.read::<u16>(99174)?);
    println!("{:#?}", session.read::<PWMConfig>(98536)?);
    println!("{:#?}", session.read::<[AnalogTriggerOutput; 8]>(98424)?);
    println!("{:#?}", session.read::<SPIDebugState>(99314)?);
    Ok(())
}

贡献

欢迎并感谢贡献。查看 开放问题 以找到要工作的任务。我们特别需要以下方面的帮助

• 创建自动化测试策略
• 改进文档
• 添加对IRQ和FIFO的支持（参见 NI API参考）