Gameboy Cartridge Dumper

This is a rom that loads its main loop into ram on the Gameboy, lets you swap cartridges and then will dump the contents of that cartridge via a link cable to a Raspberry Pi listening for the ROM data.

Currently tested using an EMS 64M flashcart and both a Gameboy pocket and Gameboy Color.

Screenshots

TODO

• Build a ROM showing text on the screen using RGBDS
  • Test it works on real hardware
• Copy code to RAM and test running from there works in an emulator
  • Test it works on real hardware
  • Add function to fix JUMP and CALL commands once code is moved to RAM
• Read and display the title from the cartridge header
• Test swapping cartridges works on real hardware
• Test for the Nintendo logo like the boot ROM does to see if a valid cart is plugged in
• Read joypad data
  • Read only what's needed when I need it
• Test serial connection works
• Dump cartridge data over seial port when Start pressed
  • Support basic 32K cartridge
  • Support ROM banking
    • MBC1
    • MBC2
    • MBC3
    • MBC5
  • Support SRAM reading
  • Add support for checking the data was properly recieved
  • Screen display dump progress
    • Add stat check in TX loop, only display if clear. No need to loop-block
  • Option to dump using external clock
    • Would need a re-work of the post-TX delay timer code
• Add other dumping methods
  • View hex on screen
  • QR Code (wildcard)
• Add more of a menu instead of debug tiles
  • Show more cart info
  • Nice dump process bar
  • Menu for dump methods
  • Menu for what to dump (rom/save)
  • Option to boot the cart that's plugged in
    • Works on DMG
    • Works on CGB (need to make cart CGB compatible)

To Build

Get RGBDS (Rednex Game Boy Development System) and run make. The makefile assembles, links and fixes creating a cart-dumper.gb file to use.

To Use

Copy the cart-dumper.gb rom to a flash-cart, run it on a Gameboy, carefully remove the flashcart once it's running, carefully (slowly, sometimes going too fast will reboot the Gameboy) put a new cartridge in and then wait for the cartridge title to be shown on screen.

Once connected to a running listener via the link cable you can press Start on the Gameboy and it will send the cartridge data to the listener.