| Both sides previous revision Previous revision Next revision | Previous revision |
| systems:gba [2021/11/27 23:35] – template consistency overhaul atari | systems:gba [2021/12/12 04:46] (current) – added the gameboy micro atari |
|---|
| <WRAP third column> | <WRAP third column> |
| {{ https://raw.githubusercontent.com/fabricecaruso/es-theme-carbon/master/art/consoles/gba.png?nolink&350 |}} | {{ https://raw.githubusercontent.com/fabricecaruso/es-theme-carbon/master/art/consoles/gba.png?nolink&350 |}} |
| | {{ https://raw.githubusercontent.com/fabricecaruso/es-theme-carbon/master/art/consoles/jp/gbah.png?nolink&350 |For ants.}} |
| </WRAP> | </WRAP> |
| </WRAP> | </WRAP> |
| |
| * **Emulator:** [[#retroarch|RetroArch]] | * **Emulator:** [[#retroarch|RetroArch]] |
| * **Cores available:** [[#libretro_mgba|mGBA]], [[#libretro_vba-m|VBA-M]], [[#libretro_gpsp|gpsp]] | * **Cores available:** [[#libretro:_mgba|libretro: mGBA]], [[#libretro:_VBA-M|libretro: vba-m]], [[#libretro:_gpsp|libretro: gpsp]] |
| * **Folder:** ''/userdata/roms/gba'' | * **Folder:** ''/userdata/roms/gba'' |
| * **Accepted ROM formats:** ''.gba'', ''.zip'', ''.7z'' | * **Accepted ROM formats:** ''.gba'', ''.zip'', ''.7z'' |
| ===== BIOS ===== | ===== BIOS ===== |
| |
| BIOS files are optional for GBA emulation, however they are the only way to see the cool boot animation on start-up. | The BIOS file are optional for GBA emulation, however it is the only way to see the cool boot animation on start-up. |
| |
| ^ MD5 checksum ^ Share file path ^ Description ^ | ^ MD5 checksum ^ Share file path ^ Description ^ |
| | a860e8c0b6d573d191e4ec7db1b1e4f6 | bios/gba_bios.bin | | | | ''a860e8c0b6d573d191e4ec7db1b1e4f6'' | ''bios/gba_bios.bin'' | Game Boy Advance BIOS | |
| | 32fbbd84168d3482956eb3c5051637f5 | bios/gb_bios.bin | | | |
| | dbfce9db9deaa2567f6a84fde55f9680 | bios/gbc_bios.bin | | | |
| | d574d4f9c12f305074798f54c091a8b4 | bios/sgb_bios.bin | | | |
| |
| ===== ROMs ===== | ===== ROMs ===== |
| ==== RetroArch ==== | ==== RetroArch ==== |
| |
| [[https://docs.libretro.com/|RetroArch]] (formerly SSNES), is a ubiquitous frontend that can run multiple "cores", which are essentially the emulators themselves. The most common cores use the [[https://www.libretro.com/|libretro]] API, so that's why cores run in RetroArch in Batocera are referred to as "libretro/(core name)". RetroArch aims to unify the feature set of all libretro cores and offer a universal, familiar interface independent of platform. | [[https://docs.libretro.com/|RetroArch]] (formerly SSNES), is a ubiquitous frontend that can run multiple "cores", which are essentially the emulators themselves. The most common cores use the [[https://www.libretro.com/|libretro]] API, so that's why cores run in RetroArch in Batocera are referred to as "libretro: (core name)". RetroArch aims to unify the feature set of all libretro cores and offer a universal, familiar interface independent of platform. |
| |
| === RetroArch configuration === | === RetroArch configuration === |
| ^ ES setting name ''batocera.conf_key'' ^ Description => ES option ''key_value'' ^ | ^ ES setting name ''batocera.conf_key'' ^ Description => ES option ''key_value'' ^ |
| ^ Settings that apply to all cores of this emulator || | ^ Settings that apply to all cores of this emulator || |
| | **GRAPHICS BACKEND ''gba.gfxbackend''** | Choose your graphics rendering\\ => OpenGL ''opengl'', Vulkan ''vulkan''. | | | **GRAPHICS API ''gba.gfxbackend''** | Choose which graphics API library to use. Vulkan is better, when supported.\\ => OpenGL ''opengl'', Vulkan ''vulkan''. | |
| | **AUDIO LATENCY ''gba.audio_latency''** | Audio latency in milliseconds, turn it up if you hear crackles\\ => 256 ''256'', 192 ''192'', 128 ''128'', 64 ''64'', 32 ''32'', 16 ''16'', 8 ''8''. | | | **AUDIO LATENCY ''gba.audio_latency''** | Audio latency in milliseconds, turn it up if you hear crackles\\ => 256 ''256'', 192 ''192'', 128 ''128'', 64 ''64'', 32 ''32'', 16 ''16'', 8 ''8''. | |
| | **THREADED VIDEO ''gba.video_threaded''** | Improves performance at the cost of latency and more video stuttering. Use only if full speed cannot be obtained otherwise.\\ => On ''true'', Off ''false''. | | | **THREADED VIDEO ''gba.video_threaded''** | Improves performance at the cost of latency and more video stuttering. Use only if full speed cannot be obtained otherwise.\\ => On ''true'', Off ''false''. | |
| |
| === libretro/mGBA === | === libretro: mGBA === |
| |
| mGBA is an emulator for running Game Boy Advance games. It aims to be faster and more accurate than many existing Game Boy Advance emulators, as well as adding features that other emulators lack. It also supports Game Boy and Game Boy Color games. | mGBA is an emulator for running Game Boy Advance games. It aims to be faster and more accurate than many existing Game Boy Advance emulators, as well as adding features that other emulators lack. It also supports Game Boy and Game Boy Color games. |
| We use the latest [[https://github.com/libretro/mgba|libretro]] core. See the [[https://docs.libretro.com/library/mgba/|official documentation]] for more information. | We use the latest [[https://github.com/libretro/mgba|libretro]] core. See the [[https://docs.libretro.com/library/mgba/|official documentation]] for more information. |
| |
| == libretro/mGBA configuration == | == libretro: mGBA configuration == |
| |
| ^ ES setting name ''batocera.conf_key'' ^ Description => ES option ''key_value'' ^ | ^ ES setting name ''batocera.conf_key'' ^ Description => ES option ''key_value'' ^ |
| ^ Settings that apply to all systems this core supports || | ^ Settings that apply to all systems this core supports || |
| | **SHOW BIOS BOOTLOGO ''global.skip_bios_mgba''** | Show BIOS animation when starting content\\ => Off ''True'', On ''False''. | | | **SHOW BIOS BOOTLOGO ''global.skip_bios_mgba''** | Show BIOS animation when starting content. Requires BIOS file to be present.\\ => Off ''True'', On ''False''. | |
| ^ Settings specific to gb || | ^ Settings specific to gb || |
| | **SUPER GB BORDERS ''gb.sgb_borders''** | Only for Super Game Boy enhanced games\\ => Off ''False'', On ''True''. | | | **SUPER GB BORDERS ''gb.sgb_borders''** | Only for Super Game Boy enhanced games.\\ => Off ''False'', On ''True''. | |
| | **COLOR CORRECTION ''gb.color_correction''** | Adjusts output colors to feel real hardware\\ => Off ''False'', On ''GBA''. | | | **COLOR CORRECTION ''gb.color_correction''** | Simulate LCD color inaccuracy. More accurate to how the game would have appeared on the real hardware.\\ => Off ''False'', On ''GBA''. | |
| ^ Settings specific to gbc || | ^ Settings specific to gbc || |
| | **SUPER GB BORDERS ''gbc.sgb_borders''** | Only for Super Game Boy enhanced games\\ => Off ''False'', On ''True''. | | | **SUPER GB BORDERS ''gbc.sgb_borders''** | Only for Super Game Boy enhanced games.\\ => Off ''False'', On ''True''. | |
| | **COLOR CORRECTION ''gbc.color_correction''** | Adjusts output colors to feel real hardware\\ => Off ''False'', On ''GBC''. | | | **COLOR CORRECTION ''gbc.color_correction''** | Simulate LCD color inaccuracy. More accurate to how the game would have appeared on the real hardware.\\ => Off ''False'', On ''GBC''. | |
| ^ Settings specific to gba || | ^ Settings specific to gba || |
| | **SOLAR SENSOR LEVEL ''gba.solar_sensor_level''** | Can be used by games that employed the use of a [[https://boktai.neoseeker.com/wiki/Solar_sensor|solar sensor]] on their cartridges. Use it for the few [[https://emulation.gametechwiki.com/index.php/Game_Boy_Advance_emulators#Solar_Sensor|solar sensor games]] available, such as Boktai.\\ => 0 ''0'', 1 ''1'', 2 ''2'', 3 ''3'', 4 ''4'', 5 ''5'', 6 ''6'', 7 ''7'', 8 ''8'', 9 ''9'', 10 ''10''. | | | **SOLAR SENSOR LEVEL ''gba.solar_sensor_level''** | Can be used by games that employed the use of a [[https://boktai.neoseeker.com/wiki/Solar_sensor|solar sensor]] on their cartridges. Use it for the few solar sensor games available, namely the Boktai series.\\ => 0 ''0'', 1 ''1'', 2 ''2'', 3 ''3'', 4 ''4'', 5 ''5'', 6 ''6'', 7 ''7'', 8 ''8'', 9 ''9'', 10 ''10''. | |
| | **FRAMESKIP ''gba.frameskip_mgba''** | Skip frames to improve performance (smoothness)\\ => 0 ''0'', 1 ''1'', 2 ''2'', 3 ''3'', 4 ''4'', 5 ''5'', 6 ''6'', 7 ''7'', 8 ''8'', 9 ''9'', 10 ''10''. | | | **FRAMESKIP ''gba.frameskip_mgba''** | Skip frames to improve performance (smoothness)\\ => 0 ''0'', 1 ''1'', 2 ''2'', 3 ''3'', 4 ''4'', 5 ''5'', 6 ''6'', 7 ''7'', 8 ''8'', 9 ''9'', 10 ''10''. | |
| |
| === libretro/VBA-M === | === libretro: VBA-M === |
| |
| VBA-M is a Game Boy Advance emulator with the goal to improve upon VisualBoyAdvance by integrating the best features from the various builds floating around. It also supports Game Boy, Game Boy Color and Super Game Boy (borders, palette). | VBA-M is a Game Boy Advance emulator with the goal to improve upon VisualBoyAdvance by integrating the best features from the various builds floating around. It also supports Game Boy, Game Boy Color and Super Game Boy (borders, palette). |
| |
| == libretro/vba-m configuration == | == libretro: VBA-M configuration == |
| |
| ^ ES setting name ''batocera.conf_key'' ^ Description => ES option ''key_value'' ^ | ^ ES setting name ''batocera.conf_key'' ^ Description => ES option ''key_value'' ^ |
| ^ Settings specific to gb || | ^ Settings specific to gb || |
| | **COLORIZATION ''gb.palettes''** | Set the Game Boy palettes to use\\ => original gameboy ''original gameboy'', black and white ''black and white'', gba sp ''gba sp'', blue sea ''blue sea'', dark knight ''dark knight'', green forest ''green forest'', hot desert ''hot desert'', pink dreams ''pink dreams'', weird colors ''weird colors''. | | | **COLORIZATION ''gb.palettes''** | Set the Game Boy palettes to use\\ => original gameboy ''original gameboy'', black and white ''black and white'', gba sp ''gba sp'', blue sea ''blue sea'', dark knight ''dark knight'', green forest ''green forest'', hot desert ''hot desert'', pink dreams ''pink dreams'', weird colors ''weird colors''. | |
| | **COLOR CORRECTION ''gb.gbcoloroption_gb''** | Adjusts output colors to simulate real hardware\\ => Off ''disabled'', On ''enabled''. | | | **COLOR CORRECTION ''gb.gbcoloroption_gb''** | Simulate LCD color inaccuracy. More accurate to how the game would have appeared on the real hardware.\\ => Off ''disabled'', On ''enabled''. | |
| | **SUPER GB BORDERS ''gb.showborders_gb''** | Only for Super Game Boy enhanced games\\ => Off ''disabled'', On ''enabled''. | | | **SUPER GB BORDERS ''gb.showborders_gb''** | Only for Super Game Boy enhanced games.\\ => Off ''disabled'', On ''enabled''. | |
| ^ Settings specific to gbc || | ^ Settings specific to gbc || |
| | **COLOR CORRECTION ''gbc.gbcoloroption_gbc''** | Adjusts output colors to simulate real hardware\\ => Off ''disabled'', On ''enabled''. | | | **COLOR CORRECTION ''gbc.gbcoloroption_gbc''** | Simulate LCD color inaccuracy. More accurate to how the game would have appeared on the real hardware.\\ => Off ''disabled'', On ''enabled''. | |
| | **SUPER GB BORDERS ''gbc.showborders_gbc''** | Only for Super Game Boy enhanced games\\ => Off ''disabled'', On ''enabled''. | | | **SUPER GB BORDERS ''gbc.showborders_gbc''** | Only for Super Game Boy enhanced games.\\ => Off ''disabled'', On ''enabled''. | |
| ^ Settings specific to gba || | ^ Settings specific to gba || |
| | **SOLAR SENSOR LEVEL ''gba.solarsensor''** | Only for games that employed it (for Boktai)\\ => 0 ''0'', 1 ''1'', 2 ''2'', 3 ''3'', 4 ''4'', 5 ''5'', 6 ''6'', 7 ''7'', 8 ''8'', 9 ''9'', 10 ''10''. | | | **SOLAR SENSOR LEVEL ''gba.solarsensor''** | Can be used by games that employed the use of a [[https://boktai.neoseeker.com/wiki/Solar_sensor|solar sensor]] on their cartridges. Use it for the few solar sensor games available, namely the Boktai series.\\ => 0 ''0'', 1 ''1'', 2 ''2'', 3 ''3'', 4 ''4'', 5 ''5'', 6 ''6'', 7 ''7'', 8 ''8'', 9 ''9'', 10 ''10''. | |
| | **SENSOR SENSITIVITY (GYROSCOPE) ''gba.gyro_sensitivity''** | For Gyro-enabled games (bound to left analog stick)\\ => 10 ''10'', 15 ''15'', 20 ''20'', 25 ''25'', 30 ''30'', 35 ''35'', 40 ''40'', 45 ''45'', 50 ''50'', 55 ''55'', 60 ''60'', 65 ''65'', 70 ''70'', 75 ''75'', 80 ''80'', 85 ''85'', 90 ''90'', 95 ''95'', 100 ''100'', 105 ''105'', 110 ''110'', 115 ''115'', 120 ''120''. | | | **SENSOR SENSITIVITY (GYROSCOPE) ''gba.gyro_sensitivity''** | For Gyro-enabled games (bound to left analog stick)\\ => 10 ''10'', 15 ''15'', 20 ''20'', 25 ''25'', 30 ''30'', 35 ''35'', 40 ''40'', 45 ''45'', 50 ''50'', 55 ''55'', 60 ''60'', 65 ''65'', 70 ''70'', 75 ''75'', 80 ''80'', 85 ''85'', 90 ''90'', 95 ''95'', 100 ''100'', 105 ''105'', 110 ''110'', 115 ''115'', 120 ''120''. | |
| | **SENSOR SENSITIVITY (TILT) ''gba.tilt_sensitivity''** | For Gyro-enabled games (bound to right analog stick)\\ => 10 ''10'', 15 ''15'', 20 ''20'', 25 ''25'', 30 ''30'', 35 ''35'', 40 ''40'', 45 ''45'', 50 ''50'', 55 ''55'', 60 ''60'', 65 ''65'', 70 ''70'', 75 ''75'', 80 ''80'', 85 ''85'', 90 ''90'', 95 ''95'', 100 ''100'', 105 ''105'', 110 ''110'', 115 ''115'', 120 ''120''. | | | **SENSOR SENSITIVITY (TILT) ''gba.tilt_sensitivity''** | For Gyro-enabled games (bound to right analog stick)\\ => 10 ''10'', 15 ''15'', 20 ''20'', 25 ''25'', 30 ''30'', 35 ''35'', 40 ''40'', 45 ''45'', 50 ''50'', 55 ''55'', 60 ''60'', 65 ''65'', 70 ''70'', 75 ''75'', 80 ''80'', 85 ''85'', 90 ''90'', 95 ''95'', 100 ''100'', 105 ''105'', 110 ''110'', 115 ''115'', 120 ''120''. | |
| |
| === libretro/gpsp === | === libretro: gpsp === |
| |
| == libretro/gpsp configuration == | == libretro: gpsp configuration == |
| |
| ===== Controls ===== | ===== Controls ===== |
| Here are the default Game Boy Advance's controls shown on a [[:configure_a_controller|Batocera Retropad]]: | Here are the default Game Boy Advance's controls shown on a [[:configure_a_controller|Batocera Retropad]]: |
| |
| {{ https://raw.githubusercontent.com/batocera-linux/batocera-controller-overlays/master/solid-4k/gba.png }} | {{https://raw.githubusercontent.com/batocera-linux/batocera-controller-overlays/master/solid-4k/gba.png}} |
| |
| ===== Troubleshooting ===== | ===== Troubleshooting ===== |