DIS6502 3.0: The Interactive Disassembler Returns After 14 Years

DIS6502 3.0 window with a segment list and hex dump on the left and a colour-coded disassembly listing on the right

In May 2020 Peter Dell (JAC!) and Eric (ebiguy) released DIS6502 3.0, the first official new version of the interactive Windows disassembler since version 2.2 shipped in May 2006. A 3.0 beta had been available as a daily build from the WUDSN site since early 2019, and in spring 2020 Eric used his vacation to finish the missing piece, working SpartaDOS X support.

What DIS6502 does

DIS6502 loads plain binary files as well as Atari 8-bit executables (and C64 and Oric files), splits them into segments, and lets you work on the disassembly interactively: rename labels, mark data areas, search for graphics, and export a listing that will reassemble. It knows the Atari operating-system labels and vectors, so calls into the OS appear under their symbolic names. Output profiles format the listing for ASM/ED, MAC/65, LADS, CA65 and MADS.

New in 3.0

  • SpartaDOS X binaries with relocatable segments can be disassembled, and the dump pane has two new byte types for SDX labels and fix-ups. JSR PRINTF calls are recognised so their inline parameters come out correctly.
  • References can carry an offset (LDA L30FA+1), and comments can be inserted before any instruction.
  • A label prefix per segment keeps code apart when, for example, an intro and the main program load into the same address range.
  • System equates that the program never uses are greyed out and left out of the exported listing.
  • The window is resizable at last, the dump can show 8 or 16 bytes per line, and the Atari font can be shown at double height.
  • "New Workspace" lets you pick the target (Atari 800, Atari 5200 or Oric).
  • Workspaces and profiles are now XML, and MADS is the default output profile, since it is the cross-assembler that can build both standard Atari and SDX executables.

Workspaces from 2.2 still open, but 3.0 saves only in the new format, so back up old projects first. Some label names changed between the betas and the release (Atari binaries use short Lxxxx labels, SDX binaries the longer SnnnLxxxx form), so workspaces made with a beta may need their labels checked.

Rapid follow-ups

User reports came in quickly, and within a few weeks, by June 2020, versions 3.1 to 3.6 had appeared. They restored the 2.2 behaviour of creating equates for addresses outside loaded segments, fixed hex search for bytes above $80, added a per-segment choice of processor (6502 "Sally" or 65C02), switched to MADS-compatible names for undocumented opcodes, and added a profile option to force absolute addressing (.w in MADS) where a zero-page operand must stay two bytes long. A bug-fix release, 3.6.1, followed in 2023. Peter's rewrite toward version 4, available as a daily build, has since become a 64-bit Unicode program, which means it runs again under Wine on current macOS.

Why it matters

Disassembly is how the community fixes old games, ports cartridges, documents undumped software and learns from classic code. Having a maintained interactive disassembler that understands Atari executables, SDX relocation and modern cross-assemblers saves a great deal of hand work.

Getting it

DIS6502 is free from its SourceForge project (sourceforge.net/projects/dis6502). The 4.x development builds are linked from the WUDSN site. The program is a 32-bit Windows application in the 3.x series; it also runs under Wine.

Credits