GBlinkDX PC Client

Based on Brian Provinciano's GBlinkdl client from Nov 2005 (archived page)
Modifications by taizou 2016-2017

A small tool designed to communicate with the GBlinkdl program for Game Boy via a parallel -> GB link cable and allow for dumping of ROMs, reverse engineering of mappers and other fun stuff.

The original version was designed for Windows, but this new version now supports Linux too.

Parallel port access should now be possible under both OSs, including modern and 64-bit versions of Windows thanks to inpout32.dll.

HOW TO USE

You will need

A Game Boy Color (GBA probably can't do the cart swap due to hardware switching, wasn't able to get it working on a GB Pocket either)
A computer running Windows or Linux with an onboard parallel port (not tested with PCI cards or USB adapters)
A Game Boy flash cart
The gblinkdl.gb Game Boy ROM which you can find in Brian Provinciano's original GBlinkdl package
A GB Link -> Parallel cable, which you can build according to the schematic in the package linked above (the one supplied with the GB PC Linker will also work, but is vanishingly rare at this point)

Running this software

Linux

Download the source code archive from the latest release and extract
Open a terminal in the source code directory
To build in-place type make, or to install globally type sudo make install
Run gblinkdx as superuser (necessary for parallel port access) e.g. sudo gblinkdx dump.gb

Windows

Download the Windows executable from the latest release - this should also come with inpout32.dll
Open a command prompt in the directory it's in. The first time you run it, you may need to run as administrator to allow inpout32 to install its driver.
Run gblinkdx e.g. gblinkdx dump.gb

Linking with a Game Boy

Flash gblinkdl.gb to your flash cart
Connect Game Boy to PC
Insert flash cart in Game Boy, run gblinkdl.gb
When you reach the black screen saying "Run GBLinkdl.exe on your PC now".. do NOT do that yet
Remove the flash cart and insert the cartridge you would like to dump. (If the GB resets at this point see 'Reset avoidance' below)
Run the PC client software at a command line, as detailed in "Running this software" above.
If the connection has worked properly you will see the GB cart's name etc appear on both the PC and Game Boy screens.

Many carts will reset the gameboy either when inserted or when you start to read from them. To circumvent this, you can cover the reset pin, pin 30 as per this diagram. http://www.rickard.gunee.com/projects/playmobile/html/3/Image9.gif

Note that the cartridge will not boot on a Game Boy with this pin not connected, so don't do anything drastic like severing it altogether, just stick something over it.

To avoid the need to cover the pin on every cartridge you dump, you can do this on some kind of passthrough device like a cheat cartridge. I use an Xploder Lite for this purpose. However ensure the cheat functionality is switched OFF and that the cheat cart acts as a direct passthrough in this state (ie the game starts directly without any menus) or you may end up dumping the cheat cartridge's internal ROM instead!

Another option detailed on the original [GBlinkdl page] (http://web.archive.org/web/20070203014624/http://www.bripro.com/low/hardware/index.php?page=gblinkdl) is to use a Game Genie, bypass the cheat screen and boot the GBlinkdl program, and then swap the cart while keeping the Game Genie in the system.

Options/modes

The first parameter is always the ROM name. The second can be a few different things - examples:

No second parameter e.g. gblinkdx dump.gb: Auto-detect cart type based on header, and dump the cartridge to dump.gb

-o e.g. gblinkdx dump.gb -o Dump the cartridge to dump.gb as 4mb standard MBC (ignoring the header, useful for unlicensed carts with wrong headers)

-i e.g. gblinkdx dump.gb -i Enter interactive mode, see below

Script filename (any other value) e.g. gblinkdx dump.gb somescript.txt Perform writes defined in somescript.txt before dumping (implies -o)

Interactive mode

Interactive mode allows you to perform arbitrary reads/writes and dump. Useful for reverse engineering mappers.

Supported commands:

r xxxx yy reads yy bytes from address xxxx
w xxxx yy writes value yy to address xxxx
d dump rom as 4mb standard MBC (as in -o mode)
a dump rom based on header values (as in default mode)
t re-read title (useful for checking connection is still ok)
x exit

Numbers entered in r and w commands must be hexadecimal

You can chain multiple commands using semicolons (no spaces before or after), for example: w 2000 0A;w 3080 FF;r 10AF 10;d

Scripted mode

This is much more simplistic/crappy than interactive mode but allows you to perform a preset set of writes before a dump

Your script should be alternating lines address/value like this

Big ol caveat

There's no error checking and the software won't detect if the connection fails during dumping, so I recommend you dump multiple times and disconnect/reconnect everything between dumps to ensure you have a good copy

endrift/gblinkdx