Skip to the content
2 layers80.9 × 56.2 mmAdapter, the printed circuit board in 3D

System, apps and tooling for the Gigatron TTL microcomputer

Size
80.9 × 56.2 mm
Copper layers
2
Thickness
1.6 mm
Parts
40
Nets
59
Pads
187
Tracks, vias
278, 3
Pours
1
Routed
Yes
KiCad
KiCad 8.0 (file 20240108)
Created
13 Oct 2017
Updated
1 Nov 2026

Overview

Adapter is an open-source printed circuit board by kervinck, from the kervinck/gigatron-rom repository on GitHub, published under the BSD-2-Clause licence. It is a 2-layer board of 80.9 × 56.2 mm with 40 parts on 59 nets, routed with 278 tracks and 3 vias.

It is built around the TXB0104D. Its parts include 19 resistors, 7 capacitors, 4 ICs, 4 connectors and 1 diode. It belongs with the interfaces and adapters boards of this library.

Main components

1

README

README.md

Software for Gigatron ROM

Important files

text
gigatron-rom
 +--- LICENSE                   2-Clause BSD License
 +--- Makefile                  Marcel's Makefile
 +--- Core/                     Gigatron kernel and build tools
 |     +--- dev.asm.py          Development ROM (type 'make' to build):
 |     |                        Video/audio/io/kernel loops and cold storage
 |     |                        for applications and data ("kernel + ROM disk")
 |     +--- ROMv6.asm.py        Source for release ROM v6 (most recent release)
 |     `--- compilegcl.py       Stand-alone GCL to vCPU compiler (GT1 files)
 +--- interface.json            Formal bindings interface to ROM for programs
 +--- Apps/                     Built-in and example applications (GCL and GT1)
 |     +--- Blinky/Blinky.gcl   Very simple GCL program
 |     `--- HelloWorld/         Program that draws "Hello world" on screen
 +--- BASIC/                    Example BASIC programs
 +--- Utils/
 |     +--- BabelFish/          Generic Arduino sketch for talking with Gigatron
 |     +--- gt1dump.py          Dump or disassemble GT1 files
 |     +--- lcc/                LCC compiler with vCPU backend (NOT YET STABLE)
 |     `--- sendFile.py         Send GT1 or BASIC file from laptop/PC
 +--- Libs/                     C libraries for Gigatron programs
 |     `--- Example.c           Example C program
 +--- Docs/
 |     +--- GCL-language.txt    Gigatron Control Language and vCPU explanation
 |     +--- GT1-files.txt       vCPU object file format and ROM versioning

Files generated by ROMv6.asm.py

See Makefile for how to make these.

text
ROMv6.lst                       Generated listing with disassembly, labels,
                                comments and source (large!)
ROMv6.rom                       ROM file for 27C1024 (PCB versions)

Memory map (RAM)

text
              0 1          53 54     127 128 129         (vSP)       255
             +-+-------------+-----------+-+-------------+--------------+
page 0       |0| System vars | User vars |1| User vars <-| Stack/Loader |
             +-+-------------+-----------+-+------+------+--+-----------+
page 1       | Video table                        | vReset  | Channel 1 |
             +------------------------------------+---------+-----------+ ---
page 2       |0                                239 240   249| Channel 2 |  ^
             |                                              +-----------+  |  Also see
page 3       |                                              | Channel 3 |  |  channelMask
             |                                              +-----------+  |
page 4       |            User vCPU code and/or data        | Channel 4 |  v
             |                                              +-----------+ ---
page 5-6     |                                               250     255|
             |                                                          |
             |                                               <- C stack |
             +----------------------------------------------------------+
page 7       | Sound tables                                             |
             +--------------------------------+-------------------------+
page 8-127   |0                            159|160                   255|
             | 120 lines of 160 pixels        |  Extra space for user   |
             | Default video memory           |  code and/or data       |
             =                                =                         =
             |                                |                         |
             +--------------------------------+-------------------------+

Memory map (ROM)

text
             +----------------------------------------------------------+  ---
$0000        | Boot and reset sequences                                 |   ^
             +----------------------------------------------------------+   |
$0100        | Video and audio loop (vertical blank lines)              |   |
             |                                                          |   |
$0200        | Video and audio loop (visible lines)                     |   |
             +----------------------------------------------------------+   |
$0300        | vCPU interpreter loop (primary page)                     |   |
             |                                                          |   |
$0400        | vCPU extended instructions (and some SYS functions)      |   |
             +----------------------------------------------------------+   |
$0500        | Shift tables                                             |   |
             |                                                          |   |  Core system
$0600        | SYS functions (LSRW and others)                          |   |  Kernel and drivers
             +----------------------------------------------------------+   |
$0700        | Font table (ASCII 32..81)                                |   |
             |                                                          |   |
$0800        | Font table (ASCII 82..126 and symbols 127-131)           |   |
             |                                                          |   |
$0900        | Notes table (C-0..A#7)                                   |   |
             |                                                          |   |
$0a00        | Inversion table                                          |   |
             +----------------------------------------------------------+   |
$0b00        | SYS functions (SendSerial, Sprites, SPI, ...)            |   |

SYS functions (ROM)

text
Available since ROM v1:

00ad    SYS_Exec_88                     Load serialized vCPU code from ROM and execute
04a7    SYS_Random_34                   Get random number and update entropy
0600    SYS_LSRW1_48                    Shift right 1 bit
0619    SYS_LSRW2_52                    Shift right 2 bits
0636    SYS_LSRW3_52                    Shift right 3 bits
0652    SYS_LSRW4_50                    Shift right 4 bits
066d    SYS_LSRW5_50                    Shift right 5 bits
0687    SYS_LSRW6_48                    Shift right 6 bits
04b9    SYS_LSRW7_30                    Shift right 7 bits
04c6    SYS_LSRW8_24                    Shift right 8 bits
06a0    SYS_LSLW4_46                    Shift left 4 bits
04cd    SYS_LSLW8_24                    Shift left 8 bits
04e1    SYS_VDrawBits_134               Draw 8 vertical pixels
06c0    SYS_Unpack_56                   Unpack 3 bytes into 4 pixels
04d4    SYS_Draw4_30                    Copy 4 pixels to screen memory
00f4    SYS_Out_22                      Write byte to hardware OUT register
00f9    SYS_In_24                       Read byte from hardware IN port

Added in ROM v2:

0b00    SYS_SetMode_v2_80               Set video mode 0..3
0b03    SYS_SetMemory_v2_54             Set 1..256 bytes of memory to value

Parts

40
QtyValueFootprintReferences
50.1µCapacitor_THT:C_Disc_D5.0mm_W2.5mm_P2.50mmC1, C2, C3, C4, C7
510kResistor_THT:R_Axial_DIN0207_L6.3mm_D2.5mm_P7.62mm_HorizontalR1, R3, R4, R5, R19
520kResistor_THT:R_Axial_DIN0207_L6.3mm_D2.5mm_P7.62mm_HorizontalR2, R6, R7, R8, R9
31k5Resistor_THT:R_Axial_DIN0207_L6.3mm_D2.5mm_P7.62mm_HorizontalR12, R14, R16
3750Resistor_THT:R_Axial_DIN0207_L6.3mm_D2.5mm_P7.62mm_HorizontalR13, R15, R17
3TXB0104DPackage_SO:SOIC-14_3.9x8.7mm_P1.27mmU1, U3, U4
20.1µCapacitor_SMD:C_1206_3216Metric_Pad1.33x1.80mm_HandSolderC5, C6
11N4148Diode_THT:D_DO-35_SOD27_P7.62mm_HorizontalD1
11k8Resistor_THT:R_Axial_DIN0207_L6.3mm_D2.5mm_P7.62mm_HorizontalR10
12k2Resistor_THT:R_Axial_DIN0207_L6.3mm_D2.5mm_P7.62mm_HorizontalR11
15k1Resistor_THT:R_Axial_DIN0207_L6.3mm_D2.5mm_P7.62mm_HorizontalR18
1Audioparts:CUI_RCJ-041J1
1Conn_01x06_SocketConnector_PinSocket_2.54mm:PinSocket_1x06_P2.54mm_VerticalJ3
1Jumper_3_Bridged12parts:JumperJP1
1NES Controllerparts:AMPHENOL_L717SDE09PA4CH4RJ2
1Tang Nano 9Kparts:TangNano9kU2
1VGAparts:AMPHENOL_L77HDE15SD1CH4RJ5

The 36 most common of 40 parts.

Similar boards

  • 2 layers54 × 64 mmDonConIOmini, the printed circuit board in 3D

    DonConIOmini

    ravinrabbid/DonCon2040

    RP2040 based firmware and hardware for DIY Taiko no Tatsujin Drum Controllers

    96 parts66MIT
  • 2 layers54.9 × 33 mmBoard2, the printed circuit board in 3D

    Board2

    dgoodlad/esp8266-mitsubishi-aircon

    ESP8266 / Mitsubishi AC interface

    26 parts24MIT
  • 4 layers79 × 142 mmGuitarray control board, the printed circuit board in 3D

    Guitarray control board

    IIP-Group/polymap

    Repository for the PolyMap Hardware and PolyMap Studio VST Plugin (prototype version).

    757 parts4CERN-OHL-P-2.0
  • 2 layers100 × 100 mmXaar128-Driver, the printed circuit board in 3D

    Xaar128-Driver

    tuwrraphael/inkjet-printer

    Inkjet printer for printing ceramic thin films: software, electronics and CAD designs

    188 parts4Apache-2.0
  • 2 layers99 × 80 mmMmM, the printed circuit board in 3D

    MmM

    wyolum/mmM

    mmMercury is an Open Hardware, blood pressure measurement device (not FDA approved).

    167 parts2
  • 2 layers68.6 × 53.3 mmGergotron, the printed circuit board in 3D

    Gergotron

    expipiplus1/gergotron

    33 parts1
  • 2 layers140.3 × 89.3 mmAVPCB, the printed circuit board in 3D

    AVPCB

    Paarseus/AVPCB

    Autonomous Vehicle PCB - KiCad project

    48 parts1

Questions

How big is the Adapter PCB?

It measures 80.9 × 56.2 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Adapter use?

40 parts, built around the TXB0104D. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.

Where can I download the Adapter KiCad files?

From the kervinck/gigatron-rom repository on GitHub, at the commit this page was made from: the board is Contrib/docvolt/adapter/schematic.kicad_pcb and its schematic Contrib/docvolt/adapter/schematic.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Adapter design in my own project?

Its repository publishes it under the BSD-2-Clause licence: you may reuse it on that licence's terms (keep the author's notice, and for a copyleft licence share your changes alike).