MiSTer-devel / GBA_MiSTer

GBA for MiSTer
GNU General Public License v2.0
143 stars 44 forks source link

Gameboy Advance for MiSTer Platform

HW Requirements/Features

The games can run from a naked DE10-Nano with the build-in DDR-RAM. However, using SDRAM is highly recommended, as some games may slowdown or loose sync when using DDR-RAM.

When using SDRAM, it requires 32MB SDRAM for games less than 32MB. 32MB games require either 64MB or 128MB module. SDRAM will be automatically used when available and size is sufficient.

Bios

Opensource Bios from Normmatt is included, however it has issues with some games. Original GBA BIOS can be placed to GBA folder with name boot.rom

PLEASE do not report errors without testing with the original BIOS

Homebrew games are sometimes not supported by the official BIOS, because the BIOS checks for Nintendo Logo included in the ROM, which is protected by copyright. To use these ROMs without renaming or removing the the boot.rom, you can activate the "Homebrew BIOS" settings in OSD. As the BIOS is already replaced at boot time, you must save this settings and hard reset/reload the GBA core.

Status

~1600 games tested until ingame. There is no known official game that doesn't work. Exceptions are games that require rare extra hardware (mostly japanese). Some small video glitches remain, see issue list.

Features

Savestates

Core provides 4 slots to save and restore the state. Those can be saved to SDCard or reside only in memory for temporary use(OSD Option). Usage with either Keyboard, Gamepad mappable button or OSD.

Keyboard Hotkeys for save states:

Gamepad:

Rewind

To use rewind, turn on the OSD Option "Rewind Capture" and map the rewind button. You may have to restart the game for the function to work properly. Attention: Rewind capture will slow down your game by about 0.5% and may lead to light audio stutter. Rewind capture is not compatible to "Pause when OSD is open", so pause is disabled when Rewind capture is on.

Spritelimit

There are only very few games known that produce glitches without sprite pixel limit. Those games use the sprite pixel limit automatically. You can optionally also turn this on if you notice problems.

2x Resolution

Only works over HDMI, Analog output is not changed in 2x Resolution mode.

Improved rendering resolution for:

This rendering is experimental and can cause glitches, as not all game behavior can be supported. Those glitches can not be fixed without gamespecific hacks and therefore will not be fixed. Please don't add bugs in such cases.

Cartridge Hardware supported games

If there is a game you want to play that also uses one of these features, but is not listed, please open a bug request.

For romhacks you can activate the option "GPIO HACK(RTC+Rumble)". Make sure to deactivate it for other games, otherwise you will experience crashes.

Not included

Information for developers

How to simulate: https://github.com/MiSTer-devel/GBA_MiSTer/tree/master/sim

How to implement a GPIO module: https://github.com/MiSTer-devel/GBA_MiSTer/blob/master/gpio_readme.md