Skip to the content
2 layers80 × 59.7 mmKeyboard-2600, the printed circuit board in 3D

PS/2 keyboard interface for the Atari 2600 and 7800

Size
80 × 59.7 mm
Copper layers
2
Thickness
1.6 mm
Parts
31
Nets
51
Pads
192
Tracks, vias
646, 43
Pours
1
Routed
Yes
KiCad
KiCad 8.0 (file 20240108)
Created
10 Mar 2025
Updated
20 Sep 2026

Overview

Keyboard-2600 is an open-source printed circuit board by Al-Nafuur, from the Al-Nafuur/KeyPortari repository on GitHub, published under the MIT licence. It is a 2-layer board of 80 × 59.7 mm with 31 parts on 51 nets, routed with 646 tracks and 43 vias.

It is built around the ATMEGA328P-AU and 74HC4066D,653-JSM. Its parts include 7 connectors, 6 resistors, 5 capacitors, 3 ICs and 2 switches. It belongs with the keyboards and input and retro computing and games boards and the AVR (ATmega, ATtiny) boards of this library.

Main components

2

README

README.md

🕹️⌨️ The KeyPortari a 2600/7800 Keyboard Interface

This project enables the connection of a PS/2 keyboard (or a USB keyboard that supports the PS/2 protocol) to the Atari 2600 or 7800 console. The ATmega328P processes keystrokes and controls the joystick inputs of the Atari 2600 accordingly. When no keyboard is needed, the KeyPortari also transparently forwards a real joystick, paddle, or other controller straight through to the console.

✨ Features

  • PS/2 Keyboard Support: Supports keyboard layouts US and DE.
  • Multiple Protocols, selectable via DIP switch (see DIP Switch Configuration below):
    • Port Forwarding only — no keyboard involved, joystick/paddle/other controllers pass straight through.
    • 24Char Display — on-screen text entry via a limited on-screen charset (A-Z, a-z, 0-9, space, dot, comma), port forwarding stays active while no key is pressed.
    • Basic Programming — direct ASCII keyboard input via Steve Guidi's protocol, for typing BASIC programs directly into the console.
    • CompuMate — emulates the Spectravideo CompuMate keyboard matrix (requires custom bankswitching, currently only supported by PlusCart draft firmware — see Special Protocols below).
    • 7-bit ASCII — raw 7-bit ASCII output with a dedicated chip-enable line, for consoles/carts that want to read keystrokes directly.
    • Atari 7800 Keyboard — keyboard emulation for the Atari 7800.
  • Port Forwarding: Joysticks, paddles, keypads, SaveKey, and AtariVox all pass through transparently when not actively using the keyboard, and the KeyPortari is compatible with multicart solutions like PlusCart.
  • Configurable Keymaps: Customizable key assignments for Atari 2600 control.
  • Efficient GPIO Usage: Utilizes an 8-bit port for direct control.
  • Configurable DIP Switches: 4-bit resistor-ladder circuit for easy configuration.

🔌 Hardware Requirements

  • ATmega328P 5V 16Mhz (Arduino-compatible)
  • PS/2 Keyboard (or USB Keyboard that supports the PS/2 protocol)
  • Resistors for Resistor-Ladder (10kΩ, 20kΩ, 40kΩ, 80kΩ, 100kΩ Pull-up)
  • 2x Quad analog switch (74HC4066)
  • Joystick port connection for the Atari 2600
  • 6 jumper wires (included) — only needed for the Basic Programming / CompuMate protocols, see the warning below.

⚡ Flashing the Firmware

The easiest way to flash or update the firmware is the KeyPortari Web Updater — flashes directly from your browser (Chrome, Edge, or Firefox 151+) via the Web Serial API, no Arduino IDE or driver installation required. Source: KeyPortari-Updater.

Alternatively, upload Keyboard-26.ino the classic way via the Arduino IDE or AVRDUDE.

🎛️ DIP Switch Configuration

The DIP switch block configures both the active protocol and the keyboard layout. Down = On = 1, Up = Off = 0.

⚠️ Changed in firmware v1.2.0: the DIP switch assignment is different from older firmware versions, so settings from an older firmware do not carry over. Layout is now selected by DIP 1 only (the French layout was removed), and the protocol by DIP 2–4 (previously DIP 3+4). An old setting can now select a different protocol, so re-check your switches after updating.

Keyboard layout (DIP 1):

Pos 1Layout
0US
1DE

Protocol (DIP 2–4):

Pos 2Pos 3Pos 4Protocol
000None (port forwarding only)
10024Char display (port forwarding active while no key is pressed)
010Basic Programming (port forwarding disabled, requires jumpers set — see warning below)
110CompuMate (port forwarding disabled, requires jumpers set — see warning below)
001Atari 7800 Keyboard (port forwarding disabled)
1017-bit ASCII (port forwarding active while no key is pressed)
011unused — behaves like None (port forwarding only)
111unused — behaves like None (port forwarding only)

After changing DIP switches, press the Reset button on the KeyPortari to apply the new configuration — this works at runtime, no need to power-cycle the Atari.

(photo placeholder: DIP switch block)

⚙️ Installation & Setup

  1. Flash the firmware — see Flashing the Firmware above.

  2. Connect PS/2 keyboard to the corresponding pins.

  3. Set DIP switches for the desired configuration (see table above).

  4. Connect to the Atari 2600 joystick port — the cables connecting to the 2600 joystick ports should point outwards from the KeyPortari.

    (photo placeholder: joystick cable orientation)

🔌 Special Protocols: Basic Programming & CompuMate

These two protocols need extra wiring: the TIA's INPT0–INPT5 lines must be manually routed to ATmega GPIOs A0–A3, PB2, and PB3 (MOSI) using the 6 included jumper wires via the expansion port pin header.

(photo placeholder: expansion port jumper wiring)

⚠️ Electrical caution: The included jumpers have no built-in series resistors. If a joystick, paddle, or keypad is connected to the same TIA inputs at the same time as the jumpers, this causes signal contention that can permanently damage the ATmega's GPIOs (the TIA inputs themselves are not at risk).

Never use joysticks, paddles, or other controllers on the KeyPortari forwarding ports while a Basic Programming or CompuMate protocol jumper is connected. Best practice: leave the protocol DIP switches at None (DIP 2–4 all OFF, 0-0-0) by default, and only switch to the specific protocol right before launching that ROM, then press the KeyPortari's Reset button. Optionally, add external ~220Ω series resistors between the TIA inputs and the ATmega GPIOs for extra protection (planned as standard on future expansion boards).

Protocol compatibility:

  • Basic Programming works with almost all Atari 2600 cartridge solutions — real cartridges, flashcarts, and multicarts.
  • CompuMate requires custom bankswitching, currently supported only by the PlusCart draft firmware. If you'd like to test CompuMate, reach out via AtariAge to be added to the PlusCart draft firmware group, then update your PlusCart via the PlusStore firmware update.

🎮 Usage

  • Each keystroke on the PS/2 keyboard is translated into joystick controls for the Atari 2600, per the active protocol (see DIP Switch Configuration).
  • Modifier keys like Shift, Ctrl, and Alt influence the key output (e.g., uppercase/lowercase characters).
  • DIP 1 switches between the US and DE keyboard layout — press Reset on the KeyPortari after switching.
  • The 24Char display protocol has a very limited charset (A-Za-z, 0-9, space, dot, comma) — any character not in that set is mapped to space.

🧪 Getting Started — Developer & Tester Checklist

A step-by-step checklist for testing a KeyPortari, from basic hardware to full keyboard functionality, is maintained in the AtariAge docs thread. Short version:

Level 1 — Basic hardware + port forwarding (no keyboard):

  1. DIP 2–4 to protocol 0-0-0 (None), power via the Atari.
  2. Plug in joystick(s), confirm full control in a known game/test ROM (e.g. Combat for two players).
  3. Test paddles/keypad if available.
  4. Confirm SaveKey/AtariVox forwarding works via a game that supports them.
  5. Confirm multicart compatibility (e.g. PlusCart) — startup and input should behave exactly as without the KeyPortari.

Level 2 — Basic keyboard functionality:

  1. DIP 2–4 to protocol 1-0-0 (24Char display), connect a PS/2 keyboard, power on — check for NumLock/CapsLock LED activity as a power sanity check.
  2. Run the 24Char test ROM (PlusStore path: /Public ROMs/Homebrew/Hardware/KeyPortari/24Char Notepad xxxx.bin) and confirm layout, modifier keys, and responsiveness.
  3. Test layout switching (DIP 1 for US/DE), pressing Reset after each change.

🧪 Breadboard Setup (one joystick forwarded)

Breadboard Setup with one joystick forwarded

🐞 Known Issues & Solutions

None currently open — please file an issue if you run into something.

Fixed in v1.2.1: with firmware v1.2.0, the two unused protocol DIP combinations (DIP 2–4 = 0-1-1 and 1-1-1) read past the end of the protocol table, which could hang the KeyPortari. They now behave like None. If you are on v1.2.0, please update.

🙏 Credits

🛠️ Sponsored by JLCPCB

PCB manufacturing for this project was kindly sponsored by JLCPCB – a leading PCB prototype service. For the first prototype run, JLCPCB generously provided 15 SMD assembled test boards, helping to accelerate early hardware development.

If you’re a developer or hardware tinkerer and would like to experiment with the interface or contribute your own ideas, feel free to reach out to me via AtariAge – I’d be happy to provide a board to support your work.

📄 License


If you have any questions or suggestions, feel free to open an issue on GitHub! 🎮

Parts

31
QtyValueFootprintReferences
4MountingHoleMountingHole:MountingHole_3mmH1, H2, H3, H4
30.1 uFCapacitor_SMD:C_0402_1005MetricC2, C4, C5
20.1uFCapacitor_SMD:C_0402_1005MetricC1, C3
210KResistor_SMD:R_0402_1005MetricR1, R3
274HC4066D_653Package_SO:SOIC-14_3.9x8.7mm_P1.27mmU2, U3
1100KResistor_SMD:R_0402_1005MetricR2
116MhzCrystal:Resonator_SMD_Murata_CSTxExxV-3Pin_3.0x1.1mmY2
120KResistor_SMD:R_0402_1005MetricR4
140KResistor_SMD:R_0603_1608MetricR5
180KResistor_SMD:R_0603_1608MetricR6
1ATmega328P-APackage_QFP:TQFP-32_7x7mm_P0.8mmU1
1Config Switch-BoxButton_Switch_THT:SW_DIP_SPSTx04_Piano_10.8x11.72mm_W7.62mm_P2.54mmSW1
1Expansion PortKeyPortari:PinHeader_2x14_P2.54mm_Vertical_KeyPortari_Expansion-PortJ6
1FTDI BasicConnector_PinHeader_2.54mm:PinHeader_1x06_P2.54mm_HorizontalJP1
1Joystick leftConnector_PinHeader_2.54mm:PinHeader_2x05_P2.54mm_VerticalJ8
1Joystick rightConnector_PinHeader_2.54mm:PinHeader_2x05_P2.54mm_VerticalJ7
1LOGOKeyPortari:Logo KeyPortariG***
1Left Forward PortConnector_Dsub:DSUB-9_Male_Horizontal_P2.77x2.84mm_EdgePinOffset4.94mm_Housed_MountingHolesOffset7.48mmJ2
1Mini-DIN-6KeyPortari:Connector_Mini-DIN_Female_6Pin_2rowsJ5
1ResetButton_Switch_SMD:SW_Push_1P1T_NO_CK_KMR2SW2
1Right Forward PortConnector_Dsub:DSUB-9_Male_Horizontal_P2.77x2.84mm_EdgePinOffset4.94mm_Housed_MountingHolesOffset7.48mmJ3
1USB_AConnector_USB:USB_A_Molex_67643_HorizontalJ1

The 30 most common of 31 parts.

Similar boards

  • 2 layers50 × 42 mmElektor, the printed circuit board in 3D

    Elektor

    joseluu/Elektor_sdr_teensy

    Sdr hardware front end shield to be used on top of the teensy audio board

    63 parts
  • 2 layers50.5 × 128.5 mmOpenThereminV45, the printed circuit board in 3D

    OpenThereminV45

    GaudiLabs/OpenThereminV4

    Open Source Theremin Instrument

    107 parts249GPL-3.0
  • 2 layers152 × 88 mmRFBitBangSMT, the printed circuit board in 3D

    RFBitBangSMT

    profdc9/RFBitBanger

    A QRP digital transceiver created from readily available parts for off-the-grid maintenance

    271 parts222
  • 2 layers50.2 × 31.2 mmMCU Datalogger, the printed circuit board in 3D

    MCU Datalogger

    futureshocked/KLP4e_MCU-Datalogger

    This is the repository for the "MCU Datalogger" project.

    31 parts138MIT
  • 2 layers34 × 46 mmNfcemu, the printed circuit board in 3D

    Nfcemu

    solosky/nfc-emu

    NFC模拟器

    58 parts117Apache-2.0
  • 2 layers73 × 94 mmSportiduino base, the printed circuit board in 3D

    Sportiduino base

    sportiduino/sportiduino

    Electronic timing system for orienteering and similar outdoor sports events on Arduino

    119 parts78GPL-3.0
  • 2 layers58.9 × 44.2 mmOpenPSX2AmigaPadAdapter, the printed circuit board in 3D

    OpenPSX2AmigaPadAdapter

    SukkoPera/OpenPSX2AmigaPadAdapter

    Playstation to Commodore Amiga/CD32 Controller Adapter

    43 parts69

Questions

How big is the Keyboard-2600 PCB?

It measures 80 × 59.7 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Keyboard-2600 use?

31 parts, built around the ATMEGA328P-AU and 74HC4066D,653-JSM. 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 Keyboard-2600 KiCad files?

From the Al-Nafuur/KeyPortari repository on GitHub, at the commit this page was made from: the board is pcb/Keyboard-2600/Keyboard-2600.kicad_pcb and its schematic pcb/Keyboard-2600/Keyboard-2600.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Keyboard-2600 design in my own project?

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