vpi 0.1.1

Safe and ergonomic Rust bindings to the Verilog and SystemVerilog VPI C API for writing VPI applications in Rust.
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

/// Declares the `vlog_startup_routines` symbol required by VPI simulators.
///
/// Provide one or more `extern "C" fn()` routine names. The macro emits a
/// null-terminated function pointer table as expected by common simulators.
///
/// # Example
/// ```ignore
/// extern "C" fn register() {
///     // Register callbacks/system tasks.
/// }
///
/// vpi::startup_routines!(register);
/// ```
#[macro_export]
macro_rules! startup_routines {
    ($($func:expr),* $(,)?) => {
        #[unsafe(no_mangle)]
        pub static vlog_startup_routines: [Option<extern "C" fn()>; $crate::count_idents!($($func),*) + 1] = [
            $(Some($func),)*
            None,
        ];
    };
}

/// Counts macro expression arguments at compile time.
///
/// This is primarily used internally by [`startup_routines!`].
#[macro_export]
macro_rules! count_idents {
    () => {0};
    ($_head:expr $(, $tail:expr)*) => {1 + $crate::count_idents!($($tail),*)};
}