How meenalgada142/waveeye works
WaveEye is an offline RTL debugging tool for diagnosing AXI4-Lite protocol failures from SystemVerilog and VCD inputs. Its documented workflow converts waveforms into cycle data, builds an RTL intermediate representation, checks protocol and structural/temporal behavior, then backtracks from violations to produce a causal verdict and evidence-rich reports. The graph preserves those documented stages and capability branches. Several subsystem links are based on the README’s stage diagram; unsampled implementation details are not asserted beyond that documentation.
Main entry points: ir_builder.py RTL intermediate records · adapter.py AXI-Lite rules · rca_resolver.py Root cause resolution · io.py Waveform data
Components 20
Input and preprocessing
- Interactive entry
main.py - VCD preprocessing
Preprocessing/vcd - RTL preprocessing
Preprocessing/rtl - Waveform data
IR_backtracking/rca_core/io.py
RTL and protocol analysis
- RTL intermediate records
IR_backtracking/ir_builder.py - Signal aliases
IR_backtracking/alias_engine.py - AXI-Lite rules
IR_backtracking/protocols/axi_lite/adapter.py - Signal grouping
IR_backtracking/protocols/axi_lite/signal_map.py - Datapath semantics
IR_backtracking/rca_core/semantic_datapath_analysis.py - Memory write checks
IR_backtracking/semantic_checks/memory_write_analysis.py - FSM and temporal checks
IR_backtracking
Root cause analysis
- Causal obligations
IR_backtracking/rca_core/contracts.py - RCA core engine
IR_backtracking/rca_core/engine.py - Predicate backtracking
IR_backtracking/rca_core/predicate_backtrack.py - Causal graph
IR_backtracking/rca_core/causal_graph.py - Root cause resolution
IR_backtracking/rca_resolver.py
Verdicts and reports
- Diagnosis report
IR_backtracking/reports/console_diagnosis.py - Proof and analysis reports
IR_backtracking/reports - Analysis output files
Other components
- Engineer
Connections 22
- Engineer → Interactive entry: provides inputs
- Interactive entry → VCD preprocessing: starts analysis
- VCD preprocessing → Waveform data: converts VCD
Preprocessing/vcd/upload_run_convert_rtl_tb.py - RTL preprocessing → RTL intermediate records: parses RTL
- RTL intermediate records → Signal aliases: resolves aliases
- RTL intermediate records → AXI-Lite rules: checks handshakes
- AXI-Lite rules → Signal grouping: groups signals
IR_backtracking/protocols/axi_lite/adapter.py - RTL intermediate records → Datapath semantics: checks mappings
- RTL intermediate records → Memory write checks: checks writes
- Waveform data → AXI-Lite rules: supplies cycles
IR_backtracking/protocols/axi_lite/adapter.py - Waveform data → FSM and temporal checks: supplies traces
IR_backtracking/rca_core/io.py - AXI-Lite rules → Causal obligations: defines obligations
IR_backtracking/protocols/axi_lite/adapter.py - Causal obligations → RCA core engine: evaluates
IR_backtracking/rca_core/engine.py - RCA core engine → Predicate backtracking: backtracks predicates
IR_backtracking/rca_core/engine.py - RCA core engine → Causal graph: builds dependencies
IR_backtracking/rca_core/engine.py - Datapath semantics → Root cause resolution: informs verdict
- Predicate backtracking → Root cause resolution: supports cause
- Causal graph → Root cause resolution: supports cause
IR_backtracking/rca_resolver.py - Root cause resolution → Diagnosis report: renders verdict
- Diagnosis report → Proof and analysis reports: details evidence
- Proof and analysis reports → Analysis output files: writes reports
- Analysis output files → Engineer: returns findings