Arduino Gameboy Printer Emulator (V3)

CI

Main project website located at https://mofosyne.github.io/arduino-gameboy-printer-emulator/

Telegram Gameboy Camera Chatroom

Got telegram instant messaging and have some questions or need any advice, or just want to share? Invite link below:

https://t.me/gameboycamera

Media Coverage And Other Projects Spinoff

There is more examples located in our showcase page page, but below is a few actively used cases:

Featured On Hack A Day Article

WestM’s Arduino Gameboy Printer Emulator Tutorial

CristoferCruz : gbpxl (multi-tone) : Fork of gbpxl with multitone support (Here until merged into mainline)

Raphaël BOICHOT : Game boy printer emulator with e-paper feature (CrapPrinter) for Matlab and Octave

HerrZatacke : A set of node js functions to decode the raw packet stream from a gameboy to gameboy printer

Click For More Examples In Our Showcase Page

About this project

Code to emulate a gameboy printer via the gameboy link cable and an arduino module

Goal is to provide an easy way for people to quickly setup and download the images from their gameboy to their computer before the battery of these gameboy cameras dies of old age.

I hope there will be a project to collate these gameboy images somewhere.

Official Releases

Downloads: Version Release Downloads at GitHub

Release Notes Located Here

Quick Start

Construct the Arduino Gameboy Printer Emulator

Use an arduino nano and wire the gameboy link cable as shown below. If you can fit the gameboy camera to gameboy advance etc… you may need a differen pinout reference. But the wiring should be similar.

You should avoid cutting old genuine gameboy link cables, there is plenty new cables you can purchase online. Do note that you cannot trust the color code of these cables, you must always check the wire against the plug pins. Especially considering the RX/TX pair of the pins may be flipped.

Else if you have a 3D printer, you can use (Game Boy DMG-01 Link Port plug for dupont jumper wire by Marko Štamcar from Slovenian Computer Museum, created as part of a retro tech exhibition)[https://www.thingiverse.com/thing:4685189]

Pinout Diagram

Thanks to West McGowan (twitter: @imwestm) who was able to replicate this project on his Arduino Nano plus Gameboy Color and helpfully submitted a handy picture of how to wire this project up. You can find his tutorial in here

General Pinout

Gameboy Original/Color Link Cable Pinout
 ___________
|  6  4  2  |
 \_5__3__1_/   (at cable)
Arduino Pin Gameboy Link Pin
unused Pin 1 : 5.0V
D4 Pin 2 : Serial OUTPUT
D3 Pin 3 : Serial INPUT
unused Pin 4 : Serial Data
D2 Pin 5 : Serial Clock (Interrupt)
GND Pin 6 : GND (Attach to GND Pin)

Programming the emulator

Next download ./GameBoyPrinterEmulator/gpb_emulator.ino to your arduino nano. After that, open the serial console and set the baud rate to 115200 baud.

Download the image

Press the download button in your gameboy. The emulator will automatically start to download and dump the data as a string of hex in the console display.

After the download has complete. Copy the content of the console to the raw packet javascript decoder in ./GameBoyPrinterDecoderJS/gameboy_printer_js_raw_decoder.html. Press click to render button.

One you done that, your image will show up below. You can then right click on the image to save it to your computer. Or you can click upload to imgur to upload it to the web in public, so you can share it. (Feel free to share with me at mofosyne@gmail.com).

A copy of the raw decoder is accessible here as well:

Need example raw packet captures to test out the raw js decoder without the gameboy printer emulator hardware? You can check a few out in the Real Packet Capture Example folder of the gameboy printer sniffer project.

You are all done!

Note: V3 now uses raw packet decoder, rather than the original tile decoder. This allows us to better support gameboy printers enabled games using compression.

Project Makeup

Technical Information

Sniffer / Real Gameboy Printer Captures

Refer to https://github.com/mofosyne/GameboyPrinterSniffer for more information.

Protocol

  | BYTE POS :    |     0     |     1     |     2     |      3      |     4     |     5     |  6 + X    | 6 + X + 1 | 6 + X + 2 | 6 + X + 3 | 6 + X + 4 |
  |---------------|-----------|-----------|-----------|-------------|-----------|-----------|-----------|-----------|-----------|-----------|-----------|
  | SIZE          |        2 Bytes        |  1 Byte   |   1 Byte    |  1 Bytes  |  1 Bytes  | Variable  |        2 Bytes        |  1 Bytes  |  1 Bytes  |
  | DESCRIPTION   |       SYNC_WORD       | COMMAND   | COMPRESSION |     DATA_LENGTH(X)    | Payload   |       CHECKSUM        |  DEVICEID |  STATUS   |
  | GB TO PRINTER |    0x88   |    0x33   | See Below | See Below   | Low Byte  | High Byte | See Below |       See Below       |    0x00   |    0x00   |
  | TO PRINTER    |    0x00   |    0x00   |    0x00   |   0x00      |    0x00   |    0x00   |    0x00   |    0x00   |    0x00   |    0x81   | See Below |

Gameboy Printer Timing

Below measurements was obtained via the ANALOG DISCOVERY via digilent

                       1.153ms
        <--------------------------------------->
         0   1   2   3   4   5   6   7             0   1   2   3   4   5   6   7
     __   _   _   _   _   _   _   _   ___________   _   _   _   _   _   _   _   _
CLK:   |_| |_| |_| |_| |_| |_| |_| |_|           |_| |_| |_| |_| |_| |_| |_| |_|
DAT: ___XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX____________XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX_
       <-->                           <---------->
       127.63 us                         229.26 us

Research/Dev log

2021-01-26

2020-08-30

2017-11-30

2017-4-12

My Face In BW


Credits / Other Resources

Resources Referenced

Contributors / Thanks