Skip to content

Waveforms

The waveform viewer shows the signals from a simulation run. It’s on the Waveform tab of the Simulation page.

After a simulation that wrote a waveform, open the Waveform tab: it shows that run’s waveform.

To open another file, select Change above the waveform, and choose a .vcd or .fst file. When no waveform is open, the tab offers Browse… and a list of Recent runs.

Large waveforms open quickly. The companion indexes the file where it’s stored, and sends the app only the part you’re looking at. While a file is being indexed for the first time, the viewer shows “Building waveform index…” with its progress. The indexes are kept in chipforge/.cache/waveform/ in your project.

To Do this
Zoom in or out around the pointer Ctrl + wheel, or pinch
Zoom in or out Alt+= or Alt+-
See the whole simulation Alt+0
Pan Shift + wheel, swipe sideways, or Alt+, and Alt+.
Jump to the start or end Alt+[ or Alt+]
Move the view Drag the bar under the signals
  • Place the cursor: click or drag on the waveform. The cursor snaps to the nearest signal edge; hold Alt to place it exactly.
  • Step between edges: click a signal or its name to select it, then press ← or → to move the cursor to its previous or next change.
  • Add a marker: press M to add one at the cursor, or Shift+click a signal to add one there. Middle-click moves marker M1.
  • Move or remove a marker: drag its flag, or double-click the flag to remove it.

The time axis shows the time between neighbouring markers and the cursor.

Right-click a bus to choose how its value is shown: Hexadecimal, Binary, Octal, Unsigned decimal, Signed decimal or ASCII. Buses start in hexadecimal, and signals declared as integers start in signed decimal. Your choice is saved with the waveform’s layout.

When some bits of a value are unknown (x) or high-impedance (z), the viewer keeps the digits it does know. For example, 0011xxxx reads 3x in hexadecimal.

Press ? to see every waveform shortcut.