Atari Technical Reference Notes (C016555)
- Year
- 1980
- Type
- Component
- Category
- Atari's official hardware and OS documentation set (1980–1983)
- Manufacturer
- Atari, Inc.
- Tags
- atari-inc, documentation, technical-reference-notes, hardware-manual, os-manual, os-source-listing, de-re-atari, xl-addendum, developers, history
- Related
- Altirra, Atari 1200XL
Overview
The 400 and 800 shipped with BASIC and operator's manuals, not register maps. Programmers who wanted to use display lists, player/missile graphics or the serial bus needed Atari's own engineering documents, and from 1980 Atari began selling them. Collected in a binder under part number C016555, and from 1982 titled the Technical Reference Notes, they became the foundation of nearly everything later written about the 8-bit Atari — including this site's technical entries, which still cite the OS manual for the SIO protocol, cartridge header and controller registers.
What was in the binder
- Operating System User's Manual — written by Harry B. Stewart, a NEOTERIC consultant for Atari. It covers the memory map, the CIO/SIO input-output system and device handlers, interrupts, system initialisation, the floating-point package, how to add device handlers, the cartridge header, and appendices listing ATASCII, error codes, SIO commands and every OS variable.
- Hardware Manual — the register-level description of ANTIC, CTIA/GTIA, POKEY and the PIA, with memory configurations and schematics.
- Operating System Source Listing — the assembly-language source of the 400/800 OS (from late 1982, the Revision B version).
Editions
| Edition | Contents and identification |
|---|---|
| November 1980 | "Operating System User's Manual and Hardware Manual", C016555, orange cover; OS manual (215 pp.) plus the 10/80 Hardware Manual, whose memory-configuration pages B-10/B-11 are hand-drawn |
| January 1982 | Same title, yellow cover; OS manual extended to 261 pp. with new appendices on device characteristics and OS variables |
| Mid-1982 | First titled Technical Reference Notes, C016555 REV. 1, gold title page |
| Late 1982 | C016555 Rev. A, blue title page: "Atari Home Computer System Technical Reference Notes includes: Operating System User's Manual, Operating System Source Listing and Hardware Manual" — a revised 273-page OS manual with index, the 1982 Hardware Manual and the Rev. B OS listing |
The OS source had also been sold separately: an Operating System Listing (C016579) in February 1981, described on its first page as "the original June 1979 Atari 400/800 computer operating system listing", and a re-issued Operating System Source Listing (C017893) in August 1981.
Companions and successors
- De Re Atari ("A Guide to Effective Programming") was written by Atari's Software Development Support Group — whose members, at an April 1981 developer seminar, included Chris Crawford, Lane Winner, Mike Ekberg, Kathleen Pitta, Jim Cox, Gus Makreas and John Eckstrom. It was first issued in 1981 to registered developers (C060070) and then sold to everyone through the Atari Program Exchange (APX-90008, 1982). Where the Technical Reference Notes say what the hardware does, De Re Atari explains how to use it: display lists, scrolling, player/missile graphics, artifacting and more.
- The XL Addendum — "Operating System Manual: Supplement to Atari 400/800 Technical Reference Notes" (C024515), first with a green "Atari 1200XL" cover and later a white "Atari XL Addendum" cover — documents the changes in the XL OS in 36 pages. It was written, uncredited, by Robert A. Peck.
- XL OS source. Atari produced a listed source for the XL OS, but, as Mapping the Atari noted, it was never published for sale as intended.
Why it mattered
The binder turned the 400/800 from a closed console-like system into a documented computer. Magazines, books such as Mapping the Atari, and third-party hardware makers all built on it, and because Atari defined official entry points (the ROM vectors) and documented them here, well-behaved software kept working across OS revisions. De Re Atari warned that software jumping directly into the OS ROM instead of using the vectors "will almost certainly crash on future versions of the OS" — which is exactly what happened to a number of 400/800 programs when the XL OS arrived.
Reading it today
Scans of the OS User's Manual and Hardware Manual circulate widely, the OS manual is available as text on the web, and De Re Atari is on atariarchives.org. Together with the modern Altirra Hardware Reference Manual, which corrects and extends them from emulator research, they remain the standard references for programming the 8-bit Atari.
Credits
- Picture: Title page of the late-1982 Technical Reference Notes, C016555 Rev. A. — Title page of Atari Home Computer System Technical Reference Notes C016555 Rev. A (Atari, 1982), scan in the local Atari documents collection (Fair use (manual cover))
- comp.sys.atari.8bit FAQ (Michael Current) — 1.12 (hardware manuals from Atari, De Re Atari editions), 7.1.1 (OS manuals, XL Addendum, OS source listings, Mapping the Atari quote), 7.1.7 (400/800 programs failing on XL), 11.1 timeline (April 1981 developer seminar; 1981 De Re Atari for registered developers) — Michael Current (comp.sys.atari.8bit FAQ), 1981
- Atari 400/800 Operating System User's Manual (text mirror) — contents — ksquiggle
- De Re Atari, Chapter 8 (ROM vectors warning) — Jim Dunion (Section 8 of De Re Atari)
