David Arlington's MAC/65 Video Course Teaches Assembly on Real Hardware

In 2024 David Arlington (DocSavage2001 on AtariAge), already known for his Atari BASIC and Action! video series, started a YouTube course called "MAC/65 Assembler Editor and Atari 8-bit Machine Language Programming." By 21 August 2024 an AtariAge thread was keeping a running index of the episodes, with a written summary and a full transcript for each. The series has reached at least Part 15.

A native toolchain, on purpose

Where many of today's Atari programmers use cross-assemblers on a PC, Arlington works the way programmers did in the 1980s, on an original Atari 800 with 48 KB, a FujiNet for storage and the MAC/65 cartridge. He owns several versions of MAC/65, including the 4-in-1 cartridge and a copy on his Ultimate Cart, but teaches with version 1.01 as a "least common denominator", so the lessons work on any MAC/65 a viewer has. Debugging is done with DDT, the debugger that comes with MAC/65.

His recommended reading is the MAC/65 manual, Mapping the Atari, Atari Roots and Tom Hudson's "Boot Camp" columns from ANALOG.

What the course covers

The series builds one program step by step, a small "Dog Park" game in which a character moves around a Graphics 1 screen under joystick control:

  • Parts 1–2: the MAC/65 editor (including its built-in syntax checker and how spacing decides whether text is read as a label, instruction or comment), ASM, SIZE, saving and loading object code with BLOAD, and a "Hello World" of under 30 bytes stepped through in DDT.
  • Parts 3–5: addressing modes, turning code into reusable subroutines, reading the joystick, and making programs that run under different DOSes, SpartaDOS X included. Part 5 turns to address-independent code, using the carry flag and bit shifts to save bytes, and trimming programs the way 8 KB cartridge authors had to.
  • Parts 7–9: the stack, AND/ORA/EOR/BIT masking, then opening a Graphics 1 screen through IOCB #6. Arlington rebuilds BASIC's GRAPHICS, SETCOLOR, COLOR and PLOT in assembly, adds a delay based on the real-time clock, and writes the joystick movement logic.
  • Parts 10–13: working around the symbol table overwriting your code, include files and their rules (tokenised format, no nesting), a tested memory-move subroutine, reserving memory by lowering RAMTOP before opening the screen or the top-of-memory pointer after it, redefining characters to draw the dog, conditional assembly with IFDEF, and macros. Part 13 adds simple collision detection.
  • Parts 14–15: ANTIC and custom display lists, built from scratch, mixing Graphics 1 and 2 for a title screen, with an explanation of why the multicolour character mode, ANTIC 4, gives bitmap-like results in much less memory.

The style is gradual. Mistakes are left in and fixed on camera, including a long-standing error in the IOCB buffer setup that a viewer spotted. Arlington encourages viewers to write the code themselves rather than copy it.

Why it matters

Native development with a cartridge assembler was the everyday reality for Atari programmers in the 1980s, and it is rarely taught step by step today. This course gives newcomers a structured route from first opcode to display lists. For people who already use cross-assemblers, it explains what MAC/65 and DDT can do on the machine itself.

Where to find it

Search YouTube for the series title. The AtariAge thread "David Arlington's Mac/65 course on YouTube" in the 8-bit programming forum links every episode with summaries and transcripts. To follow along in an emulator, Altirra with a MAC/65 cartridge image and DOS 2.5 or SpartaDOS X works well.

Credits