Introduction
The Intellicart is a RAM cartridge (64K words) that a PC loads over a serial line; the .rom file is, in the words of jzIntv’s documentation, “the exact format that is used for communication with the Intellicart”.
Unlike the plain .bin, it carries its own load addresses, a checksum for every part and the memory attributes (which ranges are ROM, RAM, banked) the cartridge must set.
It is made by jzIntv’s assembler as1600 or by bin2rom from a .bin and .cfg, and read back by rom2bin. The Cuttle Cart 3 uses the same layout with a different first byte.
This site recognises the file by its bytes: the explorer takes a .rom, .itv or .bin as an Intellicart ROM when all of it parses and every CRC-16 matches, exactly as jzIntv’s decoder does with CRC checking on. A damaged file is not
claimed; open it with Read as as the headerless Intellivision ROM instead. The layout below is read from jzIntv 20200712, src/icart/icartrom.c (icartrom_genrom and icartrom_decode) and
doc/programming/intellicart.txt.
Software
- jzIntv – emulator and SDK-1600: as1600, bin2rom, rom2bin (Windows, macOS, Linux)
Structure
0Header:$A8(Intellicart; jzIntv also accepts$41and$61for the Cuttle Cart 3), the number of segments N, and N xor$FF3 bytes3Segments, N of them: first page, last page, the words, a CRC-164 + 512 per page- Attribute table: 32 nibbles, one per 2K-word range16 bytes
- Fine-address table: the pages used inside each 2K-word range32 bytes
- Table CRC-16 of the 48 table bytes2 bytes
- Metadata tags (ICARTTAG), optionalthe rest
Header
| Offset | Size | Field |
|---|---|---|
| 0 | 1 | $A8, the autobaud rate-detection byte of the Intellicart. $41 or $61 (the test is (byte & ~$20) == $41) mark the Cuttle Cart 3, standard and advanced. |
| 1 | 1 | Number of ROM segments, N (0 to 255) |
| 2 | 1 | N xor $FF, the ones’ complement of byte 1 |
Segments
Each segment is a run of whole 256-word pages. The generator writes the pages of the 64K-word space that hold data, joining neighbours into one segment.
| Offset in the segment | Size | Field |
|---|---|---|
| 0 | 1 | First page: the upper 8 bits of the first address. $50 is $5000. |
| 1 | 1 | Last page, inclusive. It must not be below the first (the decoder refuses the file). |
| 2 | 512 x (last − first + 1) | The words, 16 bits each, big-endian; a decle sits in the low ten bits. Word i of the segment is at address (first << 8) + i. |
| 2 + data | 2 | CRC-16, big-endian, of the two page bytes and the data (everything from offset 0 up to here) |
The CRC is the left-shifting CRC-16 with polynomial $1021, start value $FFFF and no inversion or reflection (crc16_block in jzIntv, which its author put in the public domain). Its check value over the ASCII text 123456789 is $29B1.
The attribute and fine-address tables
The address space is cut into 32 ranges of 2K words ($0000, $0800, $1000 and so on). Range i has an attribute nibble and a fine-address byte.
| Where | Content |
|---|---|
| 16 bytes: nibble i is at byte i / 2, the low nibble for even i | Bit 0 readable, bit 1 writable, bit 2 narrow (8-bit RAM: ignored by the Intellicart, used by emulators), bit 3 bank-switched. Readable only is ROM; readable and writable is RAM; writable only is write-only memory. |
| 32 bytes: the byte for range i is at 16 + (i / 2 | (i & 1) << 4) from the table start | The upper part (bits 4-6) is the first 256-word page of the range that responds, the lower part (bits 0-2) the last one. A range may be trimmed at either end, never in the middle: this avoids holes such as the Intellivoice bus. |
| 2 bytes | CRC-16 of the 48 bytes above, big-endian |
Bank switching itself is done with write-only registers at $0040-$005F (one per 2K range), which add a page number to the address; see the memory map. The file only says which ranges are bank-switched.
What the explorer shows
- Structure tab: Header, one node per Segment (page range, words, CRC-16), the Attribute table, the Fine address table, the Table CRC-16, the Metadata tags.
- Raw code tab: the header and every segment (its pages, its CRC and that it is correct), the memory attributes as address ranges, the size of the tags.
- Code: one region per segment, at its own address, disassembled as CP1610 with the platform’s labels. The words of a
.romand the.binof the same program disassemble identically (tested with a program built both ways).
Tested against jzIntv’s own assembler: hello.rom (685 bytes: 3 + 516 + 50 bytes, plus 116 bytes of tags) and hello.bin built from examples/hello; every one-bit change in the header, the segment or the tables is refused, and so is every cut of the file before the end of the tables. On 20,000 random files, and on 20,000 more with the header bytes forced to a valid pattern, none was claimed.
Not described
Known, not yet covered
- Reference and viewer: the metadata tags (ICARTTAG): their record layout and CRCs are in jzIntv’s
icarttag.c; the viewer shows them as bytes. - Viewer: the bank-switched ranges: the file says a range is bank-switched but the viewer shows each segment at its own address, not the view a program has after writing the bank registers.
- Viewer: the Cuttle Cart 3 differences (its two first-byte values are accepted, nothing else about it is described), and the neighbouring
.cfgof a.bin. - Reference: the exact serial protocol with which a PC loads the Intellicart (the file is that stream; the page does not describe the line settings).
Unknown
- Viewer: files from other tools than jzIntv’s whose segments are not joined as its generator joins them are accepted (the decoder does not require it); whether any real Intellicart rejects something jzIntv accepts is not known.
Links
Reference
- jzIntv –
src/icart/icartrom.c,src/misc/crc16.canddoc/programming/intellicart.txtare the sources of this page - INT – the headerless cartridge file
- Memory map, registers and header