Atari Technical Reference Notes (C016555)

Year
1980
Type
Component
Category
Atari's official hardware and OS documentation set (1980–1983)
Manufacturer
Atari, Inc.
Grey title page reading 'Atari 400/800 — Atari Home Computer System — Technical Reference Notes, includes: Operating System User's Manual, Operating System Source Listing and Hardware Manual', part number C016555 Rev. A

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