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 withBLOAD, 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/BITmasking, then opening a Graphics 1 screen through IOCB #6. Arlington rebuilds BASIC'sGRAPHICS,SETCOLOR,COLORandPLOTin 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
RAMTOPbefore opening the screen or the top-of-memory pointer after it, redefining characters to draw the dog, conditional assembly withIFDEF, 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
- AtariAge — David Arlington's Mac/65 course on YouTube — AtariAge forum members
- AtariAge — David Arlington's Mac/65 course on YouTube (page 2) — AtariAge forum members
- AtariAge — David Arlington's Mac/65 course on YouTube (page 3) — AtariAge forum members
