Skip to content

Game Boy emulation on the Raspberry Pi RP2040 microcontroller.

Notifications You must be signed in to change notification settings

YouMakeTech/Pico-GB

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

64 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

RP2040-GB for Pico-GB

This is a fork of the RP2040-GB Game Boy (DMG) emulator from deltabeard. RP2040-GB is a Game Boy (DMG) emulator Peanut-GB on the Raspberry Pi RP2040 microcontroller, using an ILI9225 screen. Runs at more than 70 fps without audio emulation. With frame skip and interlacing, can run at up to 120 fps.

This fork includes changes done by me for Pico-GB:

  • push buttons support
  • overclocking to 266MHz for more accurate framerate (~60 FPS)
  • I2S sound support (44.1kHz 16 bits stereo audio)
  • SD card support (store roms and save games) + game selection menu
  • automatic color palette selection for some games (emulation of Game Boy Color Bootstrap ROM) + manual color palette selection

Pico-GB is a 3d-printed Game Boy emulator handheld gaming console for Raspberry Pi Pico that ressembles to the original Nintendo Game Boy released in 1989.

Videos

Hardware

What you need

DISCLAIMER: Some links are affiliate links. As an Amazon Associate I receive a small commission (at no extra cost to you) if you make a purchase after clicking one of the affiliate links. Thanks for your support!

Setting up the hardware

Pico-GB assembly instructions, circuit diagrams, 3d printed files etc.

Pinout

  • UP = GP2
  • DOWN = GP3
  • LEFT = GP4
  • RIGHT = GP5
  • BUTTON A = GP6
  • BUTTON B = GP7
  • SELECT = GP8
  • START = GP9
  • SD MISO = GP12
  • SD CS = GP13
  • SD CSK = GP14
  • SD MOSI = GP15
  • LCD CS = GP17
  • LCD CLK = GP18
  • LCD SDI = GP19
  • LCD RS = GP20
  • LCD RST = GP21
  • LCD LED = GP22
  • MAX98357A DIN = GP26
  • MAX98357A BCLK = GP27
  • MAX98357A LRC = GP28

Flashing the firmware

  • Download RP2040_GB.uf2 from the releases page
  • Push and hold the BOOTSEL button on the Pico, then connect to your computer using a micro USB cable. Release BOOTSEL once the drive RPI-RP2 appears on your computer.
  • Drag and drop the UF2 file on to the RPI-RP2 drive. The Raspberry Pi Pico will reboot and will now run the emulator.

Preparing the SD card

The SD card is used to store game roms and save game progress. For this project, you will need a FAT 32 formatted Micro SD card with roms you legally own. Roms must have the .gb extension.

  • Insert your SD card in a Windows computer and format it as FAT 32
  • Copy your .gb files to the SD card root folder (subfolders are not supported at this time)
  • Insert the SD card into the ILI9225 SD card slot using a Micro SD adapter

Building from source

The Raspberry Pi Pico SDK is required to build this project. Make sure you are able to compile an example project before continuing.

Known issues and limitations

  • No copyrighted games are included with Pico-GB / RP2040-GB. For this project, you will need a FAT 32 formatted Micro SD card with roms you legally own. Roms must have the .gb extension.
  • The RP2040-GB emulator is able to run at full speed on the Pico, at the expense of emulation accuracy. Some games may not work as expected or may not work at all. RP2040-GB is still experimental and not all features are guaranteed to work.
  • RP2040-GB is only compatible with original Game Boy DMG games (not compatible with Game Boy Color or Game Boy Advance games)
  • Repeatedly flashing your Pico will eventually wear out the flash memory (Pico is qualified for min. 100K flash/erase cycles)
  • The emulator overclocks the Pico in order to get the emulator working fast enough. Overclocking can reduce the Pico’s lifespan.
  • Use this software and instructions at your own risk! I will not be responsible in any way for any damage to your Pico and/or connected peripherals caused by using this software. I also do not take responsibility in any way when damage is caused to the Pico or display due to incorrect wiring or voltages.

License

MIT

About

Game Boy emulation on the Raspberry Pi RP2040 microcontroller.

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C 96.9%
  • C++ 2.8%
  • Other 0.3%