Using the Debugger
WinAPE features a fully integrated Z80 debugger. This allows you to pause the emulation at any time, examine or modify the values of Z80 registers, view the running Z80 program and edit, load and save regions of emulator memory.

To start the debugger at any time while the emulator is running, click the pause button

To resume emulation click the play button

While in debug mode the F7 key allows you to single step through executing Z80 instructions. Pressing this key will execute a single instruction or part of an instruction. Single stepping repeating instructions (eg. LDIR, LDDR) will cause one execution cycle of that instruction to be performed. Single stepping through CALL instructions will continue stepping into the called location.
The F8 key allows you to step over certain instructions. Step over works in much the same way as single stepping, but repeating instructions are executed as a whole, and CALL instructions are not followed, but performed. If the F8 key is pressed with a CALL instruction which does not return to the address immediately after the call instruction the emulator will continue to run until it is paused, the F8 key will be disabled.
The F4 key allows the emulator to run until it reaches the currently selected instruction in the Disassembler Pane.
The debugger disassembly, memory and stack values displayed are in the region of memory currently selected in the Memory Selection section of the debugger.
Multiple breakpoints can be set and the emulator will stop and enter debug mode whenever these instructions are reached.
The T value is a representation of the current number of elapsed microsecond cycles since the last time the value was reset using the adjacent button.
The Follow PC check box causes the disassembler pane to follow the current Program Counter (PC) value.
The Hide On Run check box causes the debugger to be hidden when the emulator leaves debug mode and resumes running normally.
The Breakpoints check box allows all breakpoints to be enabled or disabled with a single click.
The Break Instructions check box allows WinAPE to use a special BRK instruction (ED FF) as a breakpoint.
The

The

The

The

The

The

The

The

For more information on each section see:
The Disassembler Pane
The Memory Dump Pane
The Stack Pane
The Breakpoints Window
The Data Areas Window
The Graphics Finder
The Register Window