Skip to the content
2 layers34.2 × 63.7 mmGb link usb, the printed circuit board in 3D

Game Boy (DMG) link port to USB-C PC adapter: printer emulation, PC link, online link play. Sister project of the WiFi Game Boy cart.

Size
34.2 × 63.7 mm
Copper layers
2
Thickness
1.6 mm
Parts
59
Nets
68
Pads
252
Tracks, vias
400, 70
Pours
10
Routed
Yes
KiCad
KiCad 10.0 (file 20260206)
Created
15 Oct 2026
Updated
26 Oct 2026

Overview

Gb link usb is an open-source printed circuit board by hazy2go, from the hazy2go/gb-link-usb repository on GitHub. It is a 2-layer board of 34.2 × 63.7 mm with 59 parts on 68 nets, routed with 400 tracks and 70 vias.

It is built around the RP2350A, W25Q128JVSIQ and SN74LVC1T45DBVRE4, with the TPD4E05U06DQAR, USBLC6-2SC6 and SKRPABE010 among its other parts. Its parts include 27 capacitors, 17 resistors, 8 ICs, 2 connectors and 2 switches. It belongs with the radio and wireless and retro computing and games boards and the RP2350 boards of this library.

Main components

9

README

README.md

A Game Boy connected through its link port to a Raspberry Pi Pico 2 W, which sends prints to a computer as PNG files

gb-link-usb

Connect a Game Boy's link port to your computer over USB.
Print from a real Game Boy straight to PNG, or watch live crypto prices from SODAX on it,
with a Raspberry Pi Pico 2 W and one cut link cable.

Board: Pico 2 W Chip: RP2350 Pico SDK 2.3.1 Printer emulator: working Tested on DMG SODAX live data: working License: MIT

Quick start · Printing · SODAX · Troubleshooting · How it works · Roadmap


Highlights

  • A Game Boy Printer that saves PNGs. The Pico answers exactly like Nintendo's printer, so games print as usual, and every picture lands on your computer.
  • Live SODAX market data on the Game Boy. Prices, charts and real swap quotes from the SODAX API, drawn by our own Game Boy ROM.
  • No level shifter, no soldering. The Pico 2's RP2350 pins tolerate the Game Boy's 5 V signals, so four wires on a breadboard are enough.
  • Double-click to use. On a Mac, one launcher saves every print to Pictures/GameBoy Prints, with a sound. Any computer with Chrome or Edge can use the web page instead.
  • Tested and documented. The printer logic and the decoder have automated tests, and every hardware step, measurement and bug is written down in the logbook.

What you need

PartNotes
1Raspberry Pi Pico 2 W (or 2 WH)Must be a Pico 2. An original Pico (RP2040) is not 5 V tolerant and needs a level shifter.
2Game Boy link cable you can cutBuilt and tested with a DMG-04. You keep one plug end.
3Breadboard and jumper wiresOr solder the four wires straight to the Pico.
4Multimeter with continuity beepTo find which wire is which: colours are not standard.
5Mac with Node.js, or any computer with Chrome/EdgeFor saving the prints.

Quick start

1. Map the cable

Cut the link cable, keep one plug with some cable attached, and strip the wire ends. With the multimeter in beep mode, put a paperclip in one plug hole and touch each wire until it beeps.

Plug pinout and wiring to the Pico: plug pin 5 clock to GP0, pin 2 data from Game Boy to GP1, pin 6 ground to GND, pin 3 data to Game Boy to GP2

Plug pinSignalPico pin
5SCK, clock1 (GP0)
2SOUT, data from the Game Boy2 (GP1)
6GND3 (GND)
3SIN, data to the Game Boy4 (GP2)

Pins 1 (5 V) and 4 (SD) are usually not in the cable and are not needed. Leave the bare shield unconnected and taped.

2. Wire it to the Pico

Breadboard layout: Pico 2 W in the middle, the four cable wires plugged into the rows of Pico pins 1 to 4

Press the Pico into the middle of the breadboard, USB end up. Each cable wire goes into a free hole in the same row as its Pico pin, on the left side of the gap.

Nothing else is connected: no level shifter, no power wires.

Hole-by-hole drawing: interactive wiring page.

Power order matters. Plug the Pico into USB before switching the Game Boy on, and switch the Game Boy off before unplugging the Pico. The RP2350 tolerates 5 V on its pins only while it is powered.

3. Flash the firmware

  1. Get gb_link_usb.uf2 from Releases, or build it yourself.
  2. Hold the white BOOTSEL button on the Pico while plugging it into USB, then let go. A drive called RP2350 appears.
  3. Drag gb_link_usb.uf2 onto the drive. The Pico restarts as a Game Boy Printer.

Printing

On a Mac: double-click

  1. Download this repository (Code → Download ZIP) and unzip it.
  2. Double-click GB Printer.command. The first time, macOS may block it: right-click it → Open → Open.
  3. Wait for Pico connected, then print from the game.

Every print is saved in Pictures → GameBoy Prints, at original size and at 4×, with a sound. Unplugging and replugging the Pico is fine. Leave the window open while you print.

Any computer: the web page

Open https://hazy2go.github.io/gb-link-usb/ in Chrome or Edge, click Connect Pico, and print. Prints appear on the page with a PNG download link. Nothing to install.

To run it locally instead: cd web && python3 -m http.server 8000, then open http://localhost:8000.

The web page after decoding a print: buttons for Connect Pico, Save capture, Decode, Open file, Demo print, and the decoded 160 by 144 image

SODAX on the Game Boy

Splash screen with the SODAX logo BTC 24H: price, chart, low/high and a live solver quote ETH 30D: price, chart, low/high and a live solver quote

Emulator screenshots with live data. Tested on a real DMG.

Live prices, a 24H / 7D / 30D chart and a real swap quote from the SODAX solver for 9 coins (BTC, ETH, SOL, SODA, SUI, HYPE, AVAX, XLM, POL), on an original Game Boy.

  1. Put sodax.gb (from Releases) on a flash cart such as an EverDrive.
  2. With the Pico on USB, double-click SODAX Bridge.command (or run node tools/sodax-bridge.mjs). Close the print tool first: one program uses the Pico at a time.
  3. Switch the Game Boy on and start sodax.gb.
ButtonAction
◄ ► (or ▲ ▼)previous / next coin
Btime range: 24H, 7D, 30D
A or Startload fresh data now (it also refreshes every 30 s)

Prices come from the SODAX oracle (/oracle/candles), quotes from the SODAX solver (/intent/quote), no API key needed. How the Game Boy, the Pico's bridge mode and the PC talk: docs/SODAX.md.

Troubleshooting

ProblemWhat to check
The game reports a printer errorWiring: beep each plug pin to its Pico pin. If your colours were mapped wrong, swap the two data wires (plug pins 2 and 3). Power order: Pico first.
Stuck on Waiting for the Pico...Is the printer firmware on the Pico? It should appear as Pico by Raspberry Pi. Try another USB cable, some are charge-only.
A print did not saveSee gbprint.log in the prints folder. Raw data of every session is kept in raw/; node tools/render.mjs <file> turns it into PNGs.
SODAX screen stays on "waiting"Is the bridge window open and saying "bridge mode on"? Is the Pico on firmware v0.2.0 or newer? Press A to request a screen.
The web page cannot connectUse Chrome or Edge on a desktop (Safari and Firefox have no Web Serial). Close the Mac tool first: only one program can use the Pico at a time.

How it works

text
Game Boy link port ──► Pico 2 W ──────────────────────────────────────► computer
 5 V, clocked serial    PIO follows the Game Boy's clock (glitch filter)    gbprint.mjs or the web page
                        core 1: answers like a Game Boy Printer             decodes packets → PNG
                        core 0: streams every byte over USB serial
Sample print: a pixel-art Game Boy, the text gb-link-usb, four grey shades and a dithered gradient
  • Link layer. A PIO state machine is the clock slave: it outputs a bit when the Game Boy's clock falls and samples the Game Boy's bit when it rises. A 1.6 µs glitch filter rejects crosstalk from the data line, which otherwise shows up as extra clock edges.
  • Printer. firmware/src/printer.c replies 0x00 to every byte, then the printer ID 0x81 and a status byte, and walks through the same status sequence as a real printer (busy while "printing", then ready). Replies are queued two bytes ahead, matching how the PIO loads them.
  • Decoding. web/gbprinter.js parses packets, checks checksums, expands compressed data, turns 2-bit tiles into pixels and applies the print palette. The same file runs in the browser and in the Mac tool.

Right: a test image sent through the full printer protocol and decoded by that code.


Project layout

text
firmware/         Pico 2 W firmware (C, Pico SDK): PIO link, printer emulator, USB serial
  test/           host tests for the printer state machine
  firstlight/     patch used to run stacksmashing's firmware for the first wiring test
web/              decoder library + web page (Web Serial)
tools/            gbprint.mjs (Mac print tool), sodax-bridge.mjs + sodax.mjs (SODAX data),
                  render.mjs, printcap.py, linktest.py
rom/              Game Boy ROMs (RGBDS): sodax.gb, linktest.gb, printtest.gb; mkfont.py makes the font
hw/              own PCB (KiCad, rev A ready to order), case, scripted build + checks
sim/link/        ngspice simulation of the link lines
docs/             PROTOCOL.md, PLAN.md, PCB.md, LOGBOOK.md, breadboard drawing, images
GB Printer.command    double-click launcher for the Mac print tool
SODAX Bridge.command  double-click launcher for SODAX on the Game Boy

Development

sh
# firmware (needs the Arm GNU toolchain and Pico SDK 2.3.1; PICO_SDK_PATH set)
cmake -S firmware -B firmware/build -G Ninja && ninja -C firmware/build   # → firmware/build/gb_link_usb.uf2

# tests
make -C firmware/test        # printer state machine (host, with sanitizers)
cd web && npm test           # decoder

# Game Boy ROMs (RGBDS)
make -C rom
node tools/sodax-bridge.mjs --dry   # print live SODAX screens without hardware

rom/printtest.gb makes the Game Boy act like a printing game and shows on screen what the printer answers (… 81 00 is correct). rom/linktest.gb echoes bytes for testing the link in the other direction. Details: firmware/README.md.

Roadmap

  • Wiring and first link test: 1,000 bytes both ways, 0 errors
  • Game Boy Printer emulator: prints from a DMG saved as PNG
  • More printer games tested (compressed and multi-part prints)
  • General PC link: live SODAX market data on the Game Boy (bridge mode)
  • Online link play between two Game Boys
  • Own small PCB with USB-C and a case, so nobody has to cut a cable: rev A designed and checked (hw/), not ordered yet

Credits

Sister project: WiFi Game Boy Cartridge.

License

MIT. Exception: firmware/firstlight/ patches GPL-3.0 code and is GPL-3.0.

Parts

59
QtyValueFootprintReferences
11100nRPI_COMPILED:generic_capc1005x50C2, C8, C10, C11, C12, C13, C14, C15, C16, C17, C18
6100nCapacitor_SMD:C_0402_1005MetricC101, C102, C103, C104, C105, C106
3100kResistor_SMD:R_0402_1005MetricR103, R107, R108
310uRPI_COMPILED:generic_capc2012x125C1, C5, C19
31kRPI_COMPILED:generic_resc1005x35R2, R4, R6
3SN74LVC1T45DBVRPackage_TO_SOT_SMD:SOT-23-6U102, U103, U104
2100pCapacitor_SMD:C_0402_1005MetricC107, C108
215pRPI_COMPILED:generic_capc1005x50C3, C4
2220Resistor_SMD:R_0402_1005MetricR104, R105
227RPI_COMPILED:generic_resc1005x35R7, R8
24.7uRPI_COMPILED:generic_capc1005x50_wideC6, C7
25.1kResistor_SMD:R_0402_1005MetricR101, R102
2SKRPABE010RPI_COMPILED:wurthelek_434133025816SW1, SW2
10RPI_COMPILED:generic_resc1005x35R10
1100Resistor_SMD:R_0402_1005MetricR109
110kRPI_COMPILED:generic_resc1005x35R1
11kResistor_SMD:R_0402_1005MetricR106
133RPI_COMPILED:generic_resc1005x35R3
14.7uRPI_COMPILED:generic_capc1005x50C9
1ABM8-272-T3RPI_COMPILED:generic_xtalcc320x250x80-4X1
1AOTA-B201610S3R3-101-TRPI_COMPILED:abracon_aota-b201610s3r3-101-tL1
1Link cableConnector_Wire:SolderWire-0.15sqmm_1x05_P4mm_D0.5mm_OD1.5mm_ReliefJ102
1NCP1117ST33T3GRPI_COMPILED:onsemi_ncp1117st33t3gU2
1RP2350ARPI_COMPILED:rpi_rp2350a_viasU1
1TPD4E05U06DQARPackage_SON:USON-10_2.5x1.0mm_P0.5mmU105
1TYPE-C-31-M-12gb-link-usb:USB_C_Receptacle_HRO_TYPE-C-31-M-12_FlushJ101
1USBLC6-2SC6Package_TO_SOT_SMD:SOT-23-6U101
1W25Q128JVSIQRPI_COMPILED:generic_soic127p790x195-8U3
1greenLED_SMD:LED_0805_2012MetricD101

Similar boards

  • 2 layers40 × 89.5 mmMono, the printed circuit board in 3D

    Mono

    jmcpheron/pico-quorum

    Several people, several keys, one Safe. Hardware approvals for Safe multisig wallets.

    89 partsMIT
  • 4 layers52.6 × 51.6 mmEos learn rp2350, the printed circuit board in 3D

    Eos learn rp2350

    embeddedos-org/eCAD-Hardware-Products

    Hardware designs + EE docs + Board datasheets of Multiple products

    53 parts8MIT
  • 4 layers21 × 51 mmEasy2350, the printed circuit board in 3D

    Easy2350

    sequoia-hope/ultraroute

    PCB autorouting experiments around copperroute: route jobs, leaderboards, board morphing

    58 parts1MIT
  • 4 layers82 × 55 mmSpark, the printed circuit board in 3D

    Spark

    ratmuds/spark

    The PCB files for this project. The gerber and other PCBA files are in the production folder.

    202 parts1
  • 2 layers30.5 × 68.6 mm16bit-5v, the printed circuit board in 3D

    16bit-5v

    bread-modular/bread-modular

    Modular Synths for Everyone

    62 parts67MIT
  • 2 layers99.6 × 49.8 mmStasis badge, the printed circuit board in 3D

    Stasis badge

    MeghanaM4/stasis-badge

    74 parts2
  • 4 layers85 × 120 mmGameboy, the printed circuit board in 3D

    Gameboy

    MeesCode/gameboy-pcb

    custom gameboy-esque pcb running an stm32 and my own tiny game engine

    134 parts
  • 4 layers240 × 90.5 mmBILLEE Rover Control Module V1, the printed circuit board in 3D

    BILLEE Rover Control Module V1

    BILLEE-BroncoSTAR/billee-hardware-2027

    Hardware and firmware Repository for BILLEE URC 2027

    276 parts1MIT

Questions

How big is the Gb link usb PCB?

It measures 34.2 × 63.7 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Gb link usb use?

59 parts, built around the RP2350A, W25Q128JVSIQ, SN74LVC1T45DBVRE4 and TPD4E05U06DQAR. 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 Gb link usb KiCad files?

From the hazy2go/gb-link-usb repository on GitHub, at the commit this page was made from: the board is hw/rev-a/gb-link-usb.kicad_pcb and its schematic hw/reference/RPI-RP2350A-MINIMAL_R4-S1_public/RPI-RP2350A-MINIMAL_R4-S1.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Gb link usb design in my own project?

Its repository states no licence, so its author keeps all rights: ask hazy2go before reusing the design.