HW-Detect: One Program to Identify Your Atari's Hardware
On 6 November 2019, ascrnet published HW-Detect, a small utility that quickly identifies the hardware in an Atari 8-bit machine. He released it as an executable plus full source code on GitHub and asked owners of different machines to report whether it detected their setup correctly. Over the following months, and with a lot of help from experienced forum members, the tool went through a series of releases.
What it detects
The first versions reported:
- video standard (NTSC or PAL), read from GTIA;
- the Atari BASIC revision present;
- extended memory from 64 KB up to 2,112 KB, using the banked-memory detection method described on the Polish Atariki wiki.
Version 1.2 added detection of custom operating systems such as QMEG 4.4 and RC01, plus a check on the ANTIC chip. Version 1.3 fixed base-memory detection on the 600XL (16 KB or 64 KB), following flashjazzcat's tip to write and read back known values at $4000 or above. Later test builds detected 24, 32, 40 and 48 KB configurations on 400/800 machines. The source includes routines with names such as DetectCPU, DetectCPUSpeed, DetectHighMem and DetectMapRam.
What testing taught
The thread is a good short course in hardware detection:
- Running the first build in an emulator set to a 1088K RAMBO expansion showed stray control characters on screen, which was fixed in 1.1.
- flashjazzcat found a subtle bug in the ANTIC routine: a variable placed in the code path was executed as a
BRK, causing the next instruction to be misread on the first loop. It wasn't fatal, but it shows how easily data in a code path goes wrong. - To tell older machines from XL/XE models, ascrnet checks for the second character set that only the XL/XE OS has at
$CC00. Forum members explained why RAM tests on 4K boundaries are enough. On XL/XE machines you have to disable interrupts and switch out the OS ROM before testing RAM at$C000and above. And an inserted cartridge can mask RAM at$8000–$BFFF. - Rybags suggested measuring CPU speed so that accelerators running at 3.6, 7.2 or 14.4 MHz could be identified, and discussed how swapped ANTIC/GTIA chips could or could not be detected.
Why it matters
Modern Atari setups vary enormously: Ultimate 1MB, VBXE, stereo POKEY, accelerators, custom OSes. A quick, free way to see what a machine actually has is useful for buyers checking a used computer, for developers deciding what to support, and for anyone troubleshooting an upgrade.
Getting it
The executable and source code (MADS assembler) are at github.com/ascrnet/HW-Detect. Run the XEX from DOS, or load it directly in an emulator.
Credits
- Picture: HW-Detect v1.7 reporting a 1088 KB XL/XE with OS Rev. 2 and BASIC Rev. C. — Screenshot from the HW-Detect GitHub repository by ascrnet
- AtariAge — HW-Detect — AtariAge forum members
