Skip to content

MD Debugger and Error Handler v.2.5

Latest
Latest
Compare
Choose a tag to compare
@vladikcomper vladikcomper released this 02 Jul 20:04
· 94 commits to master since this release
v.2.5
835d4cf

- Stable AS support, Backtrace, KDebug integration and much more!

eh_illegal_instr eh_backtrace

It's sure been a while: over 5 years since version 2.0 release in 2018, but development was slowly but surely going~
Version 2.5 brings some new incredible features, major QoL and stability improvements! It's also 100% backwards-compatible with v.2.0, meaning it's almost a drop-in replacement for the old users!

Feature highlights

  • Stable AS support
    • Better integration with AS projects, stable debug symbol extraction.
  • Backtrace, address registers analysis and custom built-in debuggers
    • On any exception screen, press B to display backtrace, A for address registers, Start to return;
    • You can map A/B/C buttons to your custom debuggers;
  • Log in-game events, benchmark code, breakpoint with KDebug integration
    • Blastem-nightly and Gens KMod allow you to log debug messages in emulator's console/window;
    • No side-effects on unsupported emulators and the real hardware.
  • Debugger now supports assertions.
  • ConvSym, the debug symbol extraction utility, is now fully cross-platform.
  • Slightly improved exception display, many QoL and stability improvements.

See MD Debugger's version history for the detailed changelog.

Version 2.0 to 2.5 migration guide

If you were already using version 2.0, migration is really simple as the new version is 100% backwards compatible.

  1. Download the correct version for your project (errorhandler-as.7z or errorhandler-asm68k.7z).
  2. Replace the old files; remove ErrorHandler.bin from the old installation because it's now inlined into ErrorHandler.asm.
  3. Download and replace convsym utility for your platform (see below for Windows, Linux, BSD and MacOS versions).
  4. Everything should work already, but to support features like assertions and KDebug integration you need to modify your build system to generate DEBUG builds. Just find an installation guide for your disassembly and follow the "Install ConvSym to generate debug symbols" step.

Installation guides, documentation and help

MD Debugger comes with exhaustive documentation, installation guides and usage examples. See the following links for details:

Assets 10