RouteWave Documentation

Command reference, keyboard shortcuts, and user guide.

Quick Start

The fastest way to get RouteWave is through the RouteRTL SDK. One command — auto-downloads the binary on first use.

# Install RouteRTL (if you haven't already)

pip install routertl

# Launch RouteWave

rr routewave

# Open a waveform directly

rr routewave sim/waves/test.fst

# Or after simulation — auto-opens the latest waveform

rr sim my_testbench --view

WSL2 (Windows)

RouteWave runs natively on WSL2. A fresh Ubuntu install needs OpenGL libraries first — one line, then you're set.

# Install OpenGL libs (required once on fresh WSL2 Ubuntu)

sudo apt install libopengl0 libgl1 libglx-mesa0 libegl1

# Windows 11 — WSLg handles display automatically

rr routewave

# Windows 10 — install VcXsrv first, then:

export DISPLAY=$(ip route list default | awk '{print $3}'):0

rr routewave

# Quick test — if this opens a window, you're good:

xeyes

Supported Formats

.vcd

.fst

.ghw

.csv (ILA)

.ltrace (JSON)

.ltws (Workspace)

Keyboard Shortcuts

Key	Action
Ctrl+O	Open waveform file
Ctrl+J	Focus console input
Ctrl+T	Focus OS terminal
Ctrl+M	Toggle Mission Control
Ctrl+P	Command palette
Ctrl+B	Save bookmark
Left/Right	Jump to prev/next edge
Up/Down	Select prev/next channel
Shift+Click	Push cursor to stack
R	Create ruler between cursors
T	Toggle toolbar
F1	Help / command reference
Scroll	Zoom in/out
Middle Drag	Pan viewport

Console Commands

Press Ctrl+J to open the console. Type help for the full command reference.

show <signal> — Add signal to viewer

cursor c1 <time|snap|clear> — Persistent cursor

cursor c1 name <label> — Rename cursor

cursor c1 unit <ns|us|ms|s> — Per-cursor unit

measure <signal> — Timing metrics at cursor

divider [name] [--color #RRGGBB] — Add separator

zoom <start> <end> — Zoom to range

undo / redo — Universal undo

Update

RouteWave updates automatically when you upgrade RouteRTL:

# Update RouteRTL (includes latest RouteWave)

pip install --upgrade routertl

# Or force-refresh the viewer binary

rr ws update-viewer

RouteWave Documentation

Command reference, keyboard shortcuts, and user guide.

Quick Start

The fastest way to get RouteWave is through the RouteRTL SDK. One command — auto-downloads the binary on first use.

# Install RouteRTL (if you haven't already)

pip install routertl

# Launch RouteWave

rr routewave

# Open a waveform directly

rr routewave sim/waves/test.fst

# Or after simulation — auto-opens the latest waveform

rr sim my_testbench --view

WSL2 (Windows)

RouteWave runs natively on WSL2. A fresh Ubuntu install needs OpenGL libraries first — one line, then you're set.

# Install OpenGL libs (required once on fresh WSL2 Ubuntu)

sudo apt install libopengl0 libgl1 libglx-mesa0 libegl1

# Windows 11 — WSLg handles display automatically

rr routewave

# Windows 10 — install VcXsrv first, then:

export DISPLAY=$(ip route list default | awk '{print $3}'):0

rr routewave

# Quick test — if this opens a window, you're good:

xeyes

Supported Formats

.vcd

.fst

.ghw

.csv (ILA)

.ltrace (JSON)

.ltws (Workspace)

Keyboard Shortcuts

Key	Action
Ctrl+O	Open waveform file
Ctrl+J	Focus console input
Ctrl+T	Focus OS terminal
Ctrl+M	Toggle Mission Control
Ctrl+P	Command palette
Ctrl+B	Save bookmark
Left/Right	Jump to prev/next edge
Up/Down	Select prev/next channel
Shift+Click	Push cursor to stack
R	Create ruler between cursors
T	Toggle toolbar
F1	Help / command reference
Scroll	Zoom in/out
Middle Drag	Pan viewport

Console Commands

Press Ctrl+J to open the console. Type help for the full command reference.

show <signal> — Add signal to viewer

cursor c1 <time|snap|clear> — Persistent cursor

cursor c1 name <label> — Rename cursor

cursor c1 unit <ns|us|ms|s> — Per-cursor unit

measure <signal> — Timing metrics at cursor

divider [name] [--color #RRGGBB] — Add separator

zoom <start> <end> — Zoom to range

undo / redo — Universal undo

Update

RouteWave updates automatically when you upgrade RouteRTL:

# Update RouteRTL (includes latest RouteWave)

pip install --upgrade routertl

# Or force-refresh the viewer binary

rr ws update-viewer