gnuboy - for the Onion Omega2
This is a port of the original gnuboy Gameboy and Gameboy Color emulator for the Onion Omega2(+).
It uses my ILI9225 library to drive the display and my Wii Classic library for the joystick input. Additionally, it uses ALSA to play audio over a USB audio card.
Initially, due to the problems with the SPI interface on the Omega2(+) on older firmwares, this program inherited these problems, too. The ILI9225 SPI display could only be driven at about 2 FPS for the time being, which is due to a 16 byte TX buffer in the SPI driver. Every 8th pixel's color might be corrupted (MSB of red value) because the SPI interface had a bug, causing it to transmit the first bit of my 16-byte transfers incorrectly. See here if you're interested.
A lot of these problems were fixed with the release of the new b176 firmware release. The SPI transfer size is now 4096 bytes, which signifcantly increased speed. Random color corruptions due the MSB bug also stopped happening. The ILI9225 driver still seems to have a problem though -- it sometimes randomly draws a small color block at a seemingly random position. That might be an issue with my driver code, so until I know I'll blame that on my driver. Right now it runs at about 20FPS. Still, I use multithreading and double-buffering to overcome the slowness of the display driver. The video thread just runs detached from everything else at its own pace. Audio and everything else still operates at full speed, stutter-free.
- Support for XInput gamepads
- this would enable the emulator to be playable with common XBox like USB gamepads
- I2S audio output configuration files for the newest firmware
- More retro emulators ports (NES, SNES, ...?)
- More display drivers
- maybe new general display framework with configuration file for actual display and wireup
You will need:
- an Onion Omega2 or Omega2+, preferably with the extension dock
- an ILI9225 display (e.g., on ebay)
- a Wii classic controller
- an adapter board for the controller's connector (e.g., Adafruit's nunchucky)
- a USB audio card (can be obtained for $3 and less on ebay)
- either headphones or an amplifier chip with loudspeakers (e.g. PAM8403) to hear the sound
- breadboard and wires
The pins for SPI display are statically compiled into the binary. They are as follows: MOSI = 8, SCLK = 7, CS = 6, RST = 3, RS = 1. The Wii Classic gamepad has to be connected to the standard I2C bus, as labeled on the extension dock.
Since this is a port of the gnuboy program, it can be used exactly as the original program. Usually, you just want to play a ROM using the syntax
The Wii classic gamepad button mappings are as follows:
|left analog stick||DPAD|
This project was designed for cross-compliation. Compile your toolchain according to https://docs.onion.io/omega2-docs/cross-compiling.html, change the paths in the
TOOLCHAIN_ROOT_DIR) and do a
make all. Optionally,
make upload will attempt to use
scp to transfer the compiled binary to your Omega Onion2 system. Simply change the IP address and the password if you whish to use this feature.
For a successful compilation, you need the
omega_libs folder somewhere on your computer. You can download them here. Change the path in the
Testing the compiled binaries
- Install the dependencies library by typing
opkg update && opkg install libonionspi libonioni2c alsa-utils alsa-lib. If you already have these libraries, skip this step.
- Transfer the
libwiiclassic.sofile from the
omega2-libsrepository to the
/usr/lib/folder on your Omega2, e.g. by using
- Make sure the wiring is that which is described in the wireup section
- Transfer the
gnuboyfile (ELF) to some directory on your Omega2, e.g.
/root/and run it with the path to some ROM (
- Maximilian Gerhardt, program porter
- Laguna (from gnuboy)
- All the people and companies on which dependencies are based (e.g. for the Wii controller or the ILI9225 stuff)
Remember that gnuboy is GPL licensed! If you modify the source and distribute the binaries, you have to release the source code.
Video (links to youtube):
- Old video:
- New video: