Waveforms
The waveform viewer shows the signals from a simulation run. It’s on the Waveform tab of the Simulation page.
Open a waveform
Section titled “Open a waveform”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.
Move through time
Section titled “Move through time”| 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 |
Measure with the cursor and markers
Section titled “Measure with the cursor and markers”- 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.
Read bus values
Section titled “Read bus values”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.