MAME m68k Debug Adapter Protocol extension

This is a modification of Graham Bates' uae-dap, turning it into a VS Code MAME debug extension for Motorola 68000 targets.

No build tools are included with this extension, it only contains the debugging adapter for launching and attaching to the MAME emulator.

Also, given the large size of MAME, it isn't included either, so you should download MAME for your platform and reference the MAME executable using the 'emulatorBin' property in a launch configuration (or add the parent folder to the OS path).

The directory part of the program property will be used to set MAME's -rompath argument, so put the bios for the target system in the same directory, so MAME will pick it up along with your ROM.

vlink

Debug symbols are fetched from a symbol file (generated during build) - this should be in vlink symbol file format (-M argument).

Note that a fairly recent build of vlink is required for outputting correct symbol files!

How to compile/assemble, link, and otherwise manipulate the build output, in order to generate a MAME ROM set, is beyond the scope of this document.

Launch and attach configuration properties

[^1]: Only relevant for launch requests, attach requests won't try to start the emu. [^2]: Only relevant for debug configs (noDebug: false)