Skip to content

TinyTapeout/tt-chip-rom

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

21 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

What is Tiny Tapeout?

TinyTapeout is an educational project that aims to make it easier and cheaper than ever to get your digital designs manufactured on a real chip.

Go to https://tinytapeout.com for instructions.

What is this repo?

ROM memory that contains information about the Tiny Tapeout chip. The ROM is 8-bit wide and 256 bytes long.

The ROM layout

The ROM layout is as follows:

Address Length Encoding Description
0 8 7-segment Shuttle name (e.g. "tt05"), null-padded
8 8 7-segment Git commit hash
32 96 ASCII Chip descriptor (see below)
248 4 binary Magic value: "TT\xFA\xBB"
252 4 binary CRC32 of the ROM contents, little-endian

Other addresses are reserved and should be zero.

The chip descriptor

The chip descriptor is a simple null-terminated string that describes the chip. Each line is a key-value pair, separated by an equals sign. It contains the following keys:

Key Description Example value
shuttle The identifier of the shuttle tt05
repo The name of the repository TinyTapeout/tinytapeout-05
commit The commit hash * a1b2c3d4

* The commit hash is only included for Tiny Tapeout 5 and later.

Here is a complete example of a chip descriptor:

shuttle=tt05
repo=TinyTapeout/tinytapeout-05
commit=a1b2c3d4

How the ROM is generated

The ROM is automatically generated by tt-support-tools while building the final GDS file of the chip. Look at the rom.py file in the repository for more details.