🌊 ROHD Wave Viewer

An interactive waveform viewer for VCD, FST, and GHW files, running directly inside VS Code. Part of the ROHD hardware design ecosystem.

Click the image to watch the viewer load a filter bank waveform and explore its signals.

Features

• Open waveform files — double-click any .vcd, .fst, or .ghw file and it renders in a custom editor tab.
• Pan & Zoom — keyboard arrows, scroll wheel, Ctrl+drag region zoom, and press F to fit the entire waveform to the viewport.
• Time marker — click any waveform row to place a time cursor; jump to previous/next transitions across focused signals with ←/→.
• Signal filtering — filter the current module by name, hierarchy path, or case-insensitive prefix or */? wildcard; use Tab for path completion.
• Module tree — hierarchical module browser; click to expand/collapse and filter signals by module.
• Signal monitor list — double-click or use the context menu to add signals; multi-select, drag to reorder, and remove with Delete or Backspace. Save or load the ordered monitor list as JSON.
• Structured signals — expand arrays and structures or define monitored bit ranges when hierarchy metadata is available.
• Reload from disk — re-read the waveform file without closing the tab (useful during simulation reruns).
• Internal signal visibility — toggle display of internal implementation signals.
• Light / Dark theme — toggle the viewer theme manually.
• PNG export — save the selected-signal, value, and waveform panes through the native VS Code save dialog.
• Source navigation — navigate selected signals to ROHD or generated SystemVerilog when the companion ROHD extension and source metadata are available.
• Cross-probe — send selected signals between registered wave and schematic viewers through the companion ROHD extension.

Keyboard Shortcuts

Toolbar

Commands

Installation

From VSIX

make install-local

This builds build/rohd-wave-viewer-<version>.vsix, installs it with the VS Code CLI, and replaces an older installed version. Reload the VS Code window after installation.

Development Build

Run extension builds from the repository root:

make extension

This compiles the TypeScript host, builds the patched Flutter web application, and stages the complete extension under build/extension/rohd-wave-viewer-<version>/. The same command also produces build/rohd-wave-viewer-<version>-slim.zip.

Building the Extension Package

make vsix

Do not run vsce package directly in vscode-extension/. The source directory intentionally does not contain the generated Flutter web and WebAssembly assets. make vsix packages the staged output created by the supported build pipeline with the pinned @vscode/vsce tool.

Once its workflow file is available on the repository's default branch, the Extension release artifact GitHub Actions workflow can be run manually with publish selected or triggered by a matching v<version> tag. It verifies the extension version, tests the Rust WebAssembly bridge in both web compilers, builds and verifies the VSIX, then uploads the VSIX and SHA-256 checksum as a 90-day GitHub artifact. It does not publish to the Marketplace. An authorized intel-corporation publisher admin downloads and verifies the artifact, then uploads the contained .vsix through Marketplace publisher management.

To compile only the TypeScript host while editing it:

cd vscode-extension
npm ci
npm run compile

That command does not create a runnable or publishable extension package.

Requirements

Extension builds require the repository's pinned Flutter, Rust, WebAssembly, native build, and Node.js toolchains. See the build and environment guide.

Copyright (C) 2024-2026 Intel Corporation SPDX-License-Identifier: BSD-3-Clause