Setup

• Open the release page for the Adafruit MCUME fork: https://github.com/adafruit/MCUME/releases/latest
• Find the Assets section for the latest release and unfold it.
• Scroll down in the list of Assets and find picogb.uf2.
• Click picogb.uf2 to download it.

Loading the Emulator Onto the Fruit Jam

Enter the bootloader mode of the Fruit Jam by holding down the BOOT/BOOTSEL button (labeled Button #1), and while continuing to hold it (don't let go!), press and release the reset button (on the opposite side of the board). Continue to hold the BOOT/BOOTSEL button until the RP2350 drive appears on your computer!

If the drive does not appear, release all the buttons, and then repeat the process above.

You can also start with your board unplugged from USB, press and hold the BOOTSEL button (Button #1), continue to hold it while plugging it into USB, and wait for the drive to appear before releasing the button.

A lot of people end up using charge-only USB cables and it is very frustrating! Make sure you have a USB cable you know is good for data sync.

Copy the picogb.uf2 file onto the RP2350 drive. The board will then reset itself.

microSD Card Setup

• Format a microSD card with FAT32
• Create a gameboy/ directory at the root of the microSD card storage drive
• Place any .gb or .gbc GameBoy rom files that you have inside the gameboy/ directory
• Eject and remove card from your computer
• Insert the microSD card into the Fruit Jam while the Fruit Jam is powered off
• Power on the Fruit Jam

Usage

When the emulator boots up, it will load into a menu listing the roms that are placed in the gameboy/ directory on the microSD card. The GameBoy emulator can work with a standard USB keyboard, or the SNES-like gamepad that we have in the shop.

Menu Navigation

With a gamepad, navigate the menu using the up and down arrow buttons and select a rom with the B button.

With a keyboard, navigate the munu using the up and down arrow keys and select a rom with the space bar

During Gameplay

The gamepad behaves as expected with DPAD buttons, A, and B mapped to their GameBoy counterparts. 

With a keyboard the arrow keys act as DPAD, caps lock is the A button, and tab is the B button.