Getting started

Using the debugger

CALCULATOR, CPU, LOG, freeze/step, and binary trace output.

The debug pane has three tabs: CALCULATOR, CPU, and LOG. CALCULATOR shows the program listing and live register state, CPU is the instruction trace inspector, and LOG displays raw debug output plus the trace capture toggle.

The most powerful feature is the TRACE toggle in LOG—it records a binary session file that you can export and analyze with the read_trace.py tool to understand ROM sequences in detail.

Quick start:

  1. Use the CALCULATOR tab to inspect registers and step through your program.
  2. Switch to CPU if you want to trace the actual ROM instructions that ran (including jumps and subroutine calls).
  3. Use TRACE in the LOG tab to capture a longer sequence (reset, keystroke processing, etc.) for offline analysis.