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
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
.PROCin MADS adds the closingRTSand.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.asmor...outputfile=..\out\game.xextell 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
- Picture: WUDSN IDE: an ATasm source in the editor, with outline and error navigation. — WUDSN IDE screenshot from wudsn.com (Peter Dell) (Screenshot © Peter Dell / WUDSN — used for identification/commentary)
- WUDSN — WUDSN IDE home page — WUDSN IDE screenshot from wudsn.com (Peter Dell) (Screenshot © Peter Dell / WUDSN — used for identification/commentary)
- AtariAge forum — WUDSN IDE: The free integrated Atari 8-bit development plugin for Eclipse (2009–) — AtariAge forum members, 2009
- AtariAge forum — WUDSN IDE thread: releases 1.6.4 (2013), zero installation distribution, annotations (part 045/052) — AtariAge forum members, 2013
- AtariAge forum — WUDSN IDE thread: key binding discussion, installer (parts 078–082) — AtariAge forum members
- AtariAge forum — Source listing for MAC/65 Toolkit? (VS Code ATasm/Altirra bridge) — AtariAge forum members
