WUDSN IDE

Year
2009
Publisher
WUDSN (Peter Dell), freeware
Type
Development tool
Category
Eclipse-based cross-development IDE for 6502 assemblers
Developer
Peter Dell (JAC!)
Language
Java (Eclipse plugin)
Requirements
Windows, macOS or Linux with Java and Eclipse (or the WUDSN installer, which sets everything up); a cross-assembler such as MADS or ATasm; an emulator such as Altirra or Atari800
Eclipse window showing an ATASM source file in the WUDSN editor with syntax colouring, an Outline view listing labels such as start and loop, and a Problems view reporting the error Unknown symbol LOOP1 and a warning about illegal opcodes

Overview

WUDSN IDE brings a modern integrated development environment to Atari 8-bit assembly programming. It is a free plugin for Eclipse, written by the German demo coder Peter Dell, known on AtariAge as JAC!. WUDSN is his demo-group name. He announced the first version on AtariAge in 2009, describing it as "completely rewritten from scratch". From the start it offered an editor with syntax highlighting, compiling in place with error navigation, an outline with folding for macros and sections, content assist, hyperlinks to included source and binary files, and label files for emulators.

Instead of writing source in a plain editor and assembling from a batch file, you edit in Eclipse, press one key, and the IDE runs the cross-assembler, jumps to any error, and starts your program in an emulator. Dell said he created it to make it easy for people to "(re)start working with 6502 assembly for their beloved Atari, C64 or other machine". The project page now describes it as a development plugin for the Apple II, Atari 2600, Atari 7800, Atari 8-bit, C64 and NES.

Features

  • Assembler-specific editors for MADS, ATasm and XASM on the Atari, and for ACME, DASM, Kick Assembler, TASS, ASM6 and others on the other machines. Each understands its own assembler's directives. For example, completing .PROC in MADS adds the closing RTS and .ENDP.
  • Outline view of labels, equates, macros, procedures and includes, with click-to-navigate and folding. Content assist completes opcodes, directives and your own symbols.
  • Compile and Compile and Run, by default on CTRL+SHIFT+9 and CTRL+SHIFT+0. Errors and warnings appear in Eclipse's Problems view and are linked to the source line, including lines inside include files.
  • Emulator integration: the output file opens directly in Altirra, Atari800 or other emulators. With MADS and Altirra, a debug symbol file is produced so you can debug at source level. Newer versions reuse the running Altirra instance, so you no longer have to close the emulator before each run.
  • Source annotations: comment lines at the top of a file such as @com.wudsn.ide.asm.hardware=ATARI8BIT, ...mainsourcefile=Main.asm or ...outputfile=..\out\game.xex tell the IDE which platform, main file and output to use. This lets an include file be assembled through its parent, and lets one source tree build both an Atari 8-bit and a 5200 version.
  • Mad Pascal support (from the 1.7 series), plus extras such as a graphics viewer and converter that grew out of Dell's port of the FAIL image-format library.

Behind the scenes

WUDSN IDE was shaped in public in its long AtariAge thread. Early users immediately asked for MADS and XASM support, and both followed. Updates came for each new Eclipse release, a "zero installation" Windows package (2013) bundled Eclipse, the plugin, every supported assembler and an emulator for each platform, and Dell demonstrated it at events such as the Fujiama party. Later, the source and an installer script moved to GitHub, and an installer now downloads and configures the tools and example projects in one step. A 2023 discussion on GitHub reconsidered the old CTRL+SHIFT+0 shortcut, because recent Windows versions bind it to switching input languages.

Using it today

Run the WUDSN installer for your platform. It fetches Eclipse, the plugin, the assemblers and example projects. Then open the Atari 8-bit "Hello World" example and press Compile and Run. A few tips from users:

  • If the WUDSN menus and preferences do not appear after installing, the Java version is usually too old.
  • Set full paths to your emulator and compiler executables in the preferences. Eclipse may not search the system PATH.
  • Associate your file extensions (.asm, .s, .a65) with the right assembler editor, or the Compile buttons will run the wrong assembler.
  • Some antivirus engines have flagged the Windows installer executable heuristically. The batch-file version does the same job.

WUDSN IDE remains one of the main ways people write new Atari 8-bit software, alongside newer options such as the Visual Studio Code bridge between ATasm and Altirra.

Credits