Where this comes from, and how sure it is
The best reference for the header is Thierry Nouspikel’s Standard headers page. It could not be read directly: the server answered 403 and then a human-verification page, which was not worked around. What follows is built from web-search summaries of that page, of ninerpedia and of AtariAge threads (read 2026-11-18; “our words”), and from a test cartridge assembled with xdt99. Each point that only one summary supports is hedged.
The standard header
A header may sit at the start of a ROM (>6000), of a GROM, or of a peripheral card’s DSR ROM (>4000). The scanning routines of the console look for >AA at the start and, finding it, read the lists. For a cartridge ROM or GROM at its
first address, >6000:
| Offset | Size | Field |
|---|---|---|
| 0 | 1 | >AA: a header exists |
| 1 | 1 | Version |
| 2 | 1 | Number of programs (optional) |
| 3 | 1 | Not used |
| 4 | 2 | Power-up list: the address of the first item, >0000 for none |
| 6 | 2 | Program list: the console’s selection screen lists these (the menu) |
| 8 | 2 | DSR list |
| 10 | 2 | Subprogram list |
All 16-bit values are big-endian. A list item is a link (the address of the next item, >0000 ends the list), a start address, a one-byte name length and the name; the power-up list has no name. A cartridge ROM can only contain programs, so the
power-up, DSR and subprogram lists belong to GROMs and peripheral cards (Nouspikel, by summary). The test cartridge’s header is the twelve bytes AA 01 01 00 0000 600C 0000 0000, then its single list item at >600C: link 0000, start address 6018, length 06, SAMPLE.
Not confirmed: that the header is exactly twelve bytes (a pointer to an interrupt link list is mentioned by one summary, and where it would sit could not be established, so the viewer does not read one), and what the version byte means.
The strict test
The explorer takes a file as a TI-99/4A cartridge image only when all of this holds, within its first 8 KB:
- the file is at least 19 bytes (a header and one one-letter item) and at most 1 MB;
- byte 0 is
>AA; - each of the four pointers is
>0000or an address with a whole item (4 or 5 bytes) inside>6000up to the end of the first 8 KB (or of the file when it is shorter); - following the links of each list, no item lies outside that window, no list loops back on itself, and a named item’s name stays in the file;
- the program list is not empty, and every item of it has a name of 1 to 40 printable ASCII characters (
>20->7E) and a start address inside the window.
On 200,000 random files, and on 200,000 more with the first byte forced to >AA, none passed; the test refuses every kind of damage tried (a different first byte, a missing, low or high program pointer, a power-up or DSR pointer outside the window, a start address outside the file, a name length that is zero or runs off the end, a control or high byte in a name, a list that loops back, a link outside the window).
It also means that a genuine cartridge whose names use other characters, or whose program list sits outside the first 8 KB, is not recognised; open it with Read as.
GROM files
A GROM holds 6 KB of GPL code and data; dumps are written as 8 KB per GROM, so a file’s size is usually a multiple of 8 KB (FinalGROM 99 accepts up to 40 KB, GROMs 3 to 7). A cartridge’s first GROM is at GROM address >6000, so a G file’s header is at its first byte,
and the item addresses are GROM addresses, counted from >6000. The header has the same layout as in a ROM, so the viewer cannot tell a ROM from a GROM by it: Read the file as decides, with the default from a name ending in G.
For a GROM the viewer shows: the Structure tab with the header, each list item (a link, a start address and a name) and the rest of the file as GROM data (GPL code and tables); and a table with the size (in 8 KB GROM blocks), the base >6000, the header, and every list. There is no code view: GPL is
a different byte code with its own decoder, which this site does not have yet.
Not described
Known, not yet covered
- Viewer: GPL decoding; headers in a GROM other than the first, in DSR ROMs (
>4000) and in the console; the GRAM Kracker and other headered dump formats. - Reference: the TI-99 menu’s own use of the program list (the order of entries, how the console scans cartridge ROM banks and GROM headers).
Unknown
- Reference: the interrupt link list and the version byte (above); the list items’ exact use by power-up routines, which no readable source was reached for.
Links
Reference
- Thierry Nouspikel: Standard headers – the primary page (not read directly)
- Ninerpedia: formats
- FinalGROM 99
- TI-99/4A cartridge image – the overview