mirror of
https://github.com/Abdess/retroarch_system.git
synced 2026-04-13 12:22:33 -05:00
de1940d57c
Batch analysis of all 273 profiles to identify HLE/embedded fallbacks. Added hle_fallback: true where the core has verified software replacement for missing BIOS files: - Embedded ROMs: vice (102), ep128emu (22), fuse (18), frodo (4) - HLE BIOS: bsnes* (33 across 3 profiles), puae (9 AROS), noods (4), melonds* (6 FreeBIOS), flycast (3 reios) - Open-source replacements: sameboy (8), pokemini (1), gpsp (1) - Built-in fallbacks: np2kai (7), atari800 (6 Altirra), picodrive (3), quasi88 (4), gambatte (2) Conservative: only added where notes or source code confirm HLE. Skipped 50+ profiles where files are optional alternatives, not HLE replaceable (neocd, opera, kronos, pcem, etc.)
70 lines
2.8 KiB
YAML
70 lines
2.8 KiB
YAML
emulator: gpSP
|
|
type: libretro
|
|
source: "https://github.com/libretro/gpsp"
|
|
profiled_date: "2026-03-18"
|
|
core_version: "Git"
|
|
display_name: "Nintendo - Game Boy Advance (gpSP)"
|
|
cores:
|
|
- gpsp
|
|
systems:
|
|
- nintendo-gba
|
|
|
|
notes: |
|
|
gpSP is a Game Boy Advance emulator originally by Exophase, ported to
|
|
libretro. Historically it required the official GBA BIOS to run. Current
|
|
versions ship a built-in open-source BIOS (bios/open_gba_bios.bin) compiled
|
|
from bios/source/ that covers most games.
|
|
|
|
The core option gpsp_bios controls BIOS selection:
|
|
auto (default) - try official gba_bios.bin, fall back to built-in
|
|
builtin - always use the built-in open-source BIOS
|
|
official - try gba_bios.bin, warn and fall back to built-in if missing
|
|
|
|
A second option gpsp_boot_mode selects startup behavior:
|
|
game (default) - skip BIOS intro, boot directly into game
|
|
bios - run the BIOS boot animation before launching
|
|
|
|
BIOS loading path (libretro/libretro.c:1093-1131):
|
|
1. Resolve system directory (RETRO_ENVIRONMENT_GET_SYSTEM_DIRECTORY)
|
|
2. Append "/gba_bios.bin"
|
|
3. load_bios() reads 0x4000 (16 KB) into bios_rom[]
|
|
4. Sanity check: bios_rom[0] must be 0x18 (ARM branch opcode)
|
|
5. On failure, memcpy open_gba_bios_rom[] as fallback
|
|
|
|
The official BIOS improves compatibility for a few games that rely on
|
|
precise SWI behavior or BIOS checksum verification. The built-in BIOS
|
|
works for the vast majority of the GBA library.
|
|
|
|
files:
|
|
# -------------------------------------------------------
|
|
# Game Boy Advance - BIOS (optional, built-in fallback)
|
|
# -------------------------------------------------------
|
|
- name: gba_bios.bin
|
|
system: nintendo-gba
|
|
required: false
|
|
hle_fallback: true
|
|
size: 16384 # 16 KB (0x4000)
|
|
note: "Official GBA BIOS. Built-in open-source BIOS used as fallback. Real BIOS needed for full SWI accuracy and boot logo."
|
|
source_ref: "libretro/libretro.c:1111"
|
|
|
|
platform_details:
|
|
gba:
|
|
bios_size: 16384 # 16 KB
|
|
hle_bios: true
|
|
source_ref: "libretro/libretro.c:1107-1131, bios/source/"
|
|
notes: |
|
|
The built-in BIOS (open_gba_bios_rom, 16 KB) is an open-source
|
|
reimplementation compiled from bios/source/. It implements most
|
|
SWI calls (SoftReset, RegisterRamReset, Halt, VBlankIntrWait,
|
|
arithmetic, decompression, sound, multiboot).
|
|
|
|
Validation is minimal: load_bios() in gba_memory.c reads exactly
|
|
0x4000 bytes. The libretro frontend checks bios_rom[0] == 0x18
|
|
(ARM branch instruction at reset vector) to reject garbage files.
|
|
No hash or checksum verification is performed.
|
|
|
|
The bios_type enum (main.h:56-61) defines three modes:
|
|
auto_detect - try official first, fall back to built-in
|
|
builtin_bios - skip file load entirely, use open_gba_bios_rom
|
|
official_bios - try file, warn on failure, still fall back
|