T₀ // routewave · reference
Reference
Quick start, keyboard shortcuts, console commands, supported file formats, and download verification. Looking for the walk-through? See the guide.
T₁ // quick start
Download the AppImage, make it executable, open a waveform:
$ wget https://github.com/djmazure/routewave/releases/latest/download/RouteWave-x86_64.AppImage
$ chmod +x RouteWave-x86_64.AppImage
$ ./RouteWave-x86_64.AppImage my_design.vcd
Or through the RouteRTL SDK, which auto-fetches the matching viewer:
$ pip install routertl && rr routewave
T₂ // supported formats
VCD
IEEE 1364 Value Change Dump
Any simulator
FST
Fast Signal Trace
GTKWave-compatible binary
GHW
GHDL Waveform
GHDL native via vendored libghw
ILA CSV
Vivado / Quartus ILA Export
Hardware analyzers
ltrace
RouteWave Native JSON
Lossless save/restore
.ltws
RouteWave Workspace YAML
Layout + signals + cursors
.ltr
RouteWave Macro Tape
Recorded console sessions
T₃ // keyboard shortcuts
| Shortcut | Action |
|---|---|
| Ctrl + O | Open file |
| Ctrl + J | Focus console |
| 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 |
| F | Zoom to fit |
| F1 | Help / command reference |
| Scroll wheel | Zoom in / out |
| Middle drag | Pan viewport |
| Right-click | Exponential zoom |
| H | Bind handshake on selection |
| Home / End | Pan to start / end |
T₄ // console commands
Press Ctrl + J to focus the console. Type help for the full command reference.
| Command | Description |
|---|---|
show <signal> | Add signal to canvas |
hide <signal> | Remove signal from canvas |
zoom <start> <end> | Set viewport time range |
cursor c1 <time|snap|clear> | Persistent cursor |
cursor c1 name <label> | Rename a cursor |
cursor c1 unit <ns|us|ms|s> | Per-cursor display unit |
measure <signal> | Period / freq / duty at cursor |
divider [name] [--color #RRGGBB] | Visual separator between channels |
handshake bind <valid> <ready> | Bind handshake analyzer |
translate <ch> uart_8n1 | Attach UART decoder |
translate <sda> <scl> i2c | Attach I2C decoder (2-channel merge) |
makebus <name> | Create virtual bus from selected signals |
virtual <name> = <expr> | Create virtual signal from expression |
find <channel> <hex_value> | Search bus for value |
findnext / findprev | Navigate search results |
bookmark [name] | Save viewport position |
goto <name|time> | Jump to bookmark or timestamp |
record start <file> / stop | Record + replay command macros |
exec <script.ltr> | Execute script file |
export <file.csv|file.vcd> | Export data (format by extension) |
compact [channel] | Compress signal data in memory |
memstat | Show per-channel memory usage |
undo / redo | Universal undo stack |
help | Show all available commands |
T₅ // download verification
Every release ships with SHA256 checksums and a GPG signature.
$ sha256sum -c SHA256SUMS.txt
$ gpg --verify SHA256SUMS.txt.sig SHA256SUMS.txt