https://github.com/mofosyne/GameboyPrinterSniffer
Sniff packet Communications Between Real Gameboy And Real Gameboy Printer
https://github.com/mofosyne/GameboyPrinterSniffer
Last synced: about 1 month ago
JSON representation
Sniff packet Communications Between Real Gameboy And Real Gameboy Printer
- Host: GitHub
- URL: https://github.com/mofosyne/GameboyPrinterSniffer
- Owner: mofosyne
- License: gpl-3.0
- Created: 2020-08-29T16:08:34.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2022-06-21T18:32:48.000Z (almost 3 years ago)
- Last Synced: 2025-03-11T15:17:13.535Z (about 1 month ago)
- Language: C++
- Size: 136 KB
- Stars: 9
- Watchers: 5
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-game-boy-camera-and-game-boy-printer-projects - Game Boy Printer sniffer
README
# Gameboy Printer Sniffer
Sniff packet Communications Between Real Gameboy And Real Gameboy Printer.
This repository contains test vectors in `./RealCapture/` to assist in
emulating a real Gameboy printer.
Written by Brian Khuu, but happy to accept contributions.
Originally part of https://github.com/mofosyne/arduino-gameboy-printer-emulator
## Purpose
This is a tool to help investigate Gameboy behavior by sitting
between a real Gameboy and a real Gameboy printer.
This is a spinoff of the Arduino Gameboy Printer Emulator V2 redesign,
where we were aiming for full support for all games now.
To do this, we needed the ground truth, thus we need to sniff the communication
between a real Gameboy printer and a real Gameboy.
## 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
## Structure
* `./RealCapture/` : Real test vectors contributions from the community
* `./gbp_sniffer/` : Ardunio sketch for capturing packets between a real Gameboy and Gameboy printer.
## Usage of gbp_sniffer (arduino)
gbp_sniffer is an arduino sketch, tested on an ardunio nano. To construct...
Split a cable and locate the GND, Serial Ouput, Serial Input and Clock.
Solder these wires to the arduino using the pinout shown below.
Plug a Gameboy and a printer to both ends of the cable. I've added auto detection
routine so you don't have to worry about which ends to plug it in.
Next download `./gbp_sniffer/gpb_sniffer.ino` to your arduino nano.
After that, open the serial console and set the baud rate to 115200 baud.
You can now send an image over to the real Gameboy and the serial console will
show the desired dump.
This will give you an output similar to those found in `./RealCapture/`.
[To view the content, you can use the raw decoder found here](https://mofosyne.github.io/arduino-gameboy-printer-emulator/GameBoyPrinterDecoderJS/gameboy_printer_js_raw_decoder.html)
### 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) |
## Thanks
* Raphaël BOICHOT : For supplying real capture data in `./RealCapture/` folder