Breakpoint Manager - Chysn/VIC20-wAx2 GitHub Wiki

Setting the Breakpoint

To set the breakpoint, use the Breakpoint Manager Tool:

.B addr

where addr is a valid 16-bit hexadecimal address. This will set the breakpoint at the specified address. wAx will update the display to show you the instruction at the specified breakpoint. If the breakpoint set was successful, the instruction will be in reverse text. If the instruction is in regular text, it means you attempted to set a breakpoint in ROM, which cannot be done.

If your breakpoint is shown during disassembly, it will be in reverse text to remind you where the breakpoint is.

When the program encounters a BRK during execution, if the BRK trapping system is enabled, wAx will handle the break by showing the register and program counter display.

Clearing the Breakpoint

To clear the breakpoint, use

.B-

Entering .B- clears the breakpoint (and restores the original breakpoint byte), but enables BRK trapping.

Viewing the Breakpoint

To view the current breakpoint address and code, use

.B

If a breakpoint is currently enabled, the Breakpoint Manager will show the address and code at the breakpoint. If no breakpoint is enabled, nothing will happen.

Disabling Breakpoint Trapping

When wAx is first started, it sets the BRK interrupt so that it can trap BRK instructions and show the Register Display.

To disable the BRK trapping system, press STOP/RESTORE. This will turn off breakpoint trapping, but will not clear your breakpoint. If BRK is encountered with the breakpoint trapping system off, the BRK will be handled by whatever BRK routine is set in the BRK vector ($0316/$0317), usually the hardware default $FED2.

Additional Information

Note: Using a memory editor (Assembler, Hex Editor, etc.) will clear the breakpoint.

Note: Using the Memory Save or Load tools will clear the breakpoint.