sv-pathfinder

VS Code extension for SystemVerilog design navigation & RTL tracing - Download

sv-pathfinder helps you explore elaborated SystemVerilog designs at ease, and seamlessly integrates with the waveform viewer VaporView for post-simulation debug.

Limitations: only supports Linux64 for now. Tested on Ubuntu 22.04, AlmaLinux 8

Getting Started

sv-pathfinder currently supports .f files and UHDM databases (generated by Surelog) for design navigation.

.f

Install Surelog, or specify surelog path in setting: "sv-pathfinder.surelogPath"

Then open the .f in sv-pathfinder.

.uhdm

Generating UHDM using Surelog:

# ./slpp_all/surelog.uhdm will be generated
surelog dut.v tb.sv -elabuhdm -parse -sverilog -d uhdm

Then you can open the .uhdm in sv-pathfinder.

Compatibility Note: This extension is built with UHDM v1.84. It's recommended to use Surelog v1.84 to ensure compatibility. See Build Surelog

Features

Browse design hierarchy

• Jump to module definitions/instantiations, signal declarations, generate blocks, and more.

Go back/foward

Select instance

Waveform Integration

sv-pathfinder is seamlessly integrated with VaporView – Download

Signal value annotation

Adding signals to the waveform viewer

Settings

• "sv-pathfinder.remotePathPrefix": string
• "sv-pathfinder.localPathPrefix": string
  • Replace the remote path prefix with the local path prefix when jumping to source files. This is useful when the design database is generated on the different machine/path. Only take effect when both set.
• "sv-pathfinder.surelogPath": string, Path to the Surelog executable. If empty, 'surelog' will be resolved from your system PATH.
• "sv-pathfinder.showInstancesView": boolean, Show the instances view. Need to reload window to take effect.
  • Default: true

Requirements

This extension requires VS Code 1.93.0 or later

Acknowledgements

Many thanks to @lramseyer for all of his great work and inspiration.