MSX Debugger — Inspect software running on OpenMSX, trace source code in real time, and monitor runtime information. IMPORTANT NOTEThe extension uses a port bridge to connect to openmsx. This is required because the communication protocol is not supported directly within visual studio code. The bridge forwards TCP data and runs as an invisible Windows executable, which is why the extension currently only runs on Windows machines. TRACE FILE REQUIREMENTThe extension requires a trace file generated by your compiler (for example, Glass) when compiling your software. This file provides the mapping between the running instructions in OpenMSX and the original source lines, allowing the editor to synchronize with the emulator’s execution. EXAMPLESExample using Glass 0.6: java -jar glass-0.6 -L game.trace game.asm game.rom CONNECTING TO OPENMSXThe extension can locate a trace/lst file in the same folder as the ROM being executed. Once connected, the extension tracks the emulator’s state in real time, opening the relevant source files, highlighting the currently executing line, and monitoring runtime information. FEATURESDisplay the source files corresponding to the code currently executing in OpenMSX. Highlight the active source line in real time. Monitor runtime information, such as the current execution state of the program. Track breakpoints set in VS Code and synchronize them with the emulator’s execution. REQUIREMENTSOpenMSX emulator ROM file compiled with Glass 0.6+ LICENSEGPL-3.0 |