ondas
A read-only Rust library for waveform analysis across VCD, FST, GHW, FSDB, SHM, WLF and WDB.
Usage
[]
= "=2.1.0"
Public contracts and runnable examples live in Rustdoc under src/. See the released API reference for the published crate. waveform-model.md explains the reasons for the common model.
For upgrades from 1.x, see the 2.0.0 migration notes. The versioned Rustdoc has examples for opening and reader limits, hierarchy, values, queries, explicit times, saved traces and errors.
Cargo features
No Cargo features are enabled by default. VCD, FST and GHW are built in, also with default-features = false. Native readers use optional Cargo features with the same names as their reader IDs. They need a local SDK at build time and runtime.
[]
= { = "=2.1.0", = ["fsdb-lib"] }
Readers
| Reader | Format | Implementation | Design and limits |
|---|---|---|---|
vcd-native |
VCD | Built-in Rust parser | vcd-reader.md |
fst-lib |
FST | Published fst-reader decoder |
fst-reader.md |
ghw-native |
GHW | Built-in Rust parser | ghw-reader.md |
fsdb-lib |
FSDB | Optional Verdi Reader SDK; file input | fsdb-reader.md |
shm-lib |
SHM | Optional Xcelium reader; directory input | shm-reader.md |
wlf-lib |
WLF | Optional Questa SDK; file input | wlf-reader.md |
wdb-lib |
WDB | Optional Vivado reader; file input | wdb-reader.md |
A native feature can make the executable depend on its SDK before Rust starts. This also affects applications that read another format. Each reader document explains its deployment constraints.
Development
Contributor entry points are dev and justfile. AGENTS.md gives repository rules. development-workflow.md explains hooks, required checks and environment limits. fixture-conformance.md explains independent evidence. Benchmark interpretation belongs in benchmark-methodology.md.
Licensed under Apache License 2.0.