mirror of
https://github.com/Abdess/retroarch_system.git
synced 2026-11-01 00:27:20 -05:00
Abdessamad Derraz
e7aa9e870b
Each libretro profile records version_basis and core_version is read there at its pin. snes9x states 1.63 in snes9x.h, nestopia 2.0.0, mgba 0.11.0, vice 3.10, atari800's libretro tree 7.0.0. Cores whose build takes its version from git carry the nearest tag in describe form (flycast v2.7-90-ge88b0ce, ppsspp, duckstation, gearcoleco), placeholders copied from .info files (Git, SVN) are replaced by the code's statement, and a code that states none is null with kind none.
196 lines
7.6 KiB
YAML
196 lines
7.6 KiB
YAML
emulator: Virtual Jaguar
|
|
type: libretro
|
|
core_classification: community_fork
|
|
source: "https://github.com/libretro/virtualjaguar-libretro"
|
|
upstream: "http://shamusworld.gotdns.org/git/virtualjaguar"
|
|
profiled_date: "2026-09-04"
|
|
source_commit: "e7db53678b86e2fceb459e26cf09d2fdaaa4d395"
|
|
core_version: "v3.10.0"
|
|
version_basis:
|
|
kind: tag
|
|
tag: "v3.10.0"
|
|
distance: 0
|
|
display_name: "Atari - Jaguar (Virtual Jaguar)"
|
|
cores:
|
|
- virtualjaguar
|
|
systems:
|
|
- atari-jaguar
|
|
|
|
notes: |
|
|
The boot ROMs are compiled in, generated by bin2c, and a file in the system
|
|
directory can replace them. stage_cart_boot_rom stages the cart boot ROM at
|
|
jagMemSpace + 0xE00000 (libretro.c:6105-6180). BT_M_SERIES reads
|
|
jagboot_m.rom from the system directory, and a read shorter than 0x20000
|
|
bytes leaves the embedded Model M in place. BT_CUSTOM searches six names
|
|
across the system directory and two subdirectories (libretro.c:6059-6103),
|
|
takes the first file of exactly 0x20000 bytes, and falls back to the
|
|
embedded Series K when none qualifies (libretro.c:6010-6050).
|
|
|
|
stage_cd_bios calls load_external_cd_bios, which walks three name groups
|
|
over five directories (libretro.c:5785-5884, 5899-5940). The group order
|
|
follows the virtualjaguar_cd_bios_type option, then generic names, then the
|
|
other type, so a lone file of the other type still beats the embedded copy.
|
|
A candidate must be exactly 0x40000 bytes. Its CRC32 is compared with two
|
|
constants, and a file matching neither is still accepted when the run
|
|
address at 0x404 lies between 0x800000 and 0x840000
|
|
(libretro.c:5681-5682,5706-5781).
|
|
|
|
The "BIOS (Cartridges)" core option (virtualjaguar_bios, disabled by
|
|
default) controls whether the boot ROM runs at startup. When enabled, the
|
|
boot ROM entry point is copied to jaguarMainRAM
|
|
(src/core/jaguar.c:1499-1501). When disabled, jaguarRunAddress is written
|
|
directly, skipping the boot animation. GPU-only cartridges turn the boot
|
|
ROM on regardless (libretro.c:5968-6002).
|
|
|
|
Nothing here is required: every path falls back to an embedded copy, and a
|
|
file only replaces it. The embedded arrays are the dumps themselves:
|
|
jaguarBootROM and jaguarBootROM_M hash to the CRC32 values biosdb.c names
|
|
Series K and Model M, jaguarCDBootROM and jaguarDevCDBootROM to the two
|
|
values the CD BIOS test accepts (src/bios/jagbios.c, src/bios/jagbios_m.c,
|
|
src/bios/jagcdbios.c, src/bios/jagdevcdbios.c, src/core/biosdb.c:20-21,
|
|
libretro.c:5681-5682). A file changes what runs when it is a cart boot ROM
|
|
under BT_CUSTOM, where any checksum is loaded and an unrecognised one is
|
|
logged (libretro.c:6010-6050), or a CD BIOS revision outside the two
|
|
checksums.
|
|
|
|
files:
|
|
- name: "[BIOS] Atari Jaguar CD (World).j64"
|
|
system: atari-jaguar
|
|
required: false
|
|
size: 262144
|
|
crc32: "687068d5"
|
|
validation: [size, crc32]
|
|
aliases:
|
|
- "[BIOS] Atari Jaguar CD (World).rom"
|
|
- "[BIOS] Atari Jaguar CD (World).bin"
|
|
- "jaguarcd_bios.bin"
|
|
- "jagcd_bios.bin"
|
|
- "jaguarcd.bin"
|
|
- "jagcd.bin"
|
|
- "Jaguar CD BIOS.rom"
|
|
- "Jaguar CD BIOS.bin"
|
|
description: "Jaguar CD retail BIOS, replacing the embedded copy"
|
|
source_ref: "libretro.c:5681, libretro.c:5706-5781, libretro.c:5785-5884, libretro.c:5899-5940"
|
|
note: >-
|
|
Searched in the system directory and under Atari - Jaguar,
|
|
Atari - Jaguar CD, jaguar and jaguarcd. Accepted at exactly 262144
|
|
bytes. A file whose CRC32 matches neither constant is still accepted
|
|
when its run address at 0x404 lies between 0x800000 and 0x840000,
|
|
otherwise it is rejected and the search goes on. The generic names are
|
|
tried after the type the virtualjaguar_cd_bios_type option selects.
|
|
|
|
- name: "[BIOS] Atari Jaguar Developer CD (World).j64"
|
|
system: atari-jaguar
|
|
required: false
|
|
size: 262144
|
|
crc32: "55a0669c"
|
|
validation: [size, crc32]
|
|
aliases:
|
|
- "[BIOS] Atari Jaguar Developer CD (World).rom"
|
|
- "[BIOS] Atari Jaguar Developer CD (World).bin"
|
|
description: "Jaguar CD developer BIOS, selected by virtualjaguar_cd_bios_type"
|
|
source_ref: "libretro.c:5682, libretro.c:5706-5781, libretro.c:5785-5884"
|
|
note: >-
|
|
Same search and the same size and checksum test as the retail BIOS.
|
|
Whichever type the option does not select is still tried last.
|
|
|
|
- name: jagboot.rom
|
|
system: atari-jaguar
|
|
required: false
|
|
size: 131072
|
|
validation: [size]
|
|
aliases:
|
|
- boot.rom
|
|
- boot0.rom
|
|
- "[BIOS] Atari Jaguar (World).j64"
|
|
- "[BIOS] Atari Jaguar Stubulator '94 (World).j64"
|
|
- "[BIOS] Atari Jaguar Stubulator '93 (World).j64"
|
|
description: "Cart boot ROM read when the BIOS type is set to custom"
|
|
source_ref: "libretro.c:6010-6050, libretro.c:6059-6103, libretro.c:6131-6147"
|
|
note: >-
|
|
Reached only through BT_CUSTOM. Searched in the system directory and
|
|
under Atari - Jaguar and jaguar, name by name. No checksum is tested. A
|
|
file that is not exactly 131072 bytes is skipped, and with none left the
|
|
embedded Series K is used.
|
|
|
|
- name: jagboot_m.rom
|
|
system: atari-jaguar
|
|
required: false
|
|
size: 131072
|
|
validation: [size]
|
|
sha1: "af643900fea84234e08b616a6d27f03f0a61db96"
|
|
md5: "6e844759720226e58d55ecaf33608a13"
|
|
crc32: "ae25bdf5"
|
|
description: "Model-M cart boot ROM, read when the BIOS type is Model M"
|
|
source_ref: "libretro.c:6149-6171, src/bios/jagbios_m.c:9"
|
|
note: >-
|
|
Read from the system directory only, as jagboot_m.rom, and only when
|
|
biosType is BT_M_SERIES. A short read falls back to the embedded
|
|
Model M array, which carries the same bytes as the Model M dump.
|
|
|
|
analysis:
|
|
embedded_bios:
|
|
k_series_boot_rom:
|
|
source_file: src/bios/jagbios.c
|
|
header: src/bios/jagbios.h
|
|
symbol: jaguarBootROM
|
|
size: 131072 # 0x20000, 128 KB
|
|
description: "Jaguar K-series boot ROM"
|
|
filedb_crc: "0xFB731AAA"
|
|
filedb_name: "[BIOS] Atari Jaguar (World)"
|
|
|
|
m_series_boot_rom:
|
|
source_file: src/bios/jagbios_m.c
|
|
header: src/bios/jagbios_m.h
|
|
symbol: jaguarBootROM_M
|
|
size: 131072 # 0x20000, 128 KB
|
|
description: "Jaguar M-series boot ROM"
|
|
biosdb_crc: "0xAE25BDF5"
|
|
biosdb_name: "Model M boot ROM"
|
|
|
|
cd_boot_rom:
|
|
source_file: src/bios/jagcdbios.c
|
|
header: src/bios/jagcdbios.h
|
|
symbol: jaguarCDBootROM
|
|
size: 262144 # 0x40000, 256 KB
|
|
description: "Jaguar CD boot ROM"
|
|
filedb_crc: "0x687068D5"
|
|
filedb_name: "[BIOS] Atari Jaguar CD (World)"
|
|
|
|
dev_cd_boot_rom:
|
|
source_file: src/bios/jagdevcdbios.c
|
|
header: src/bios/jagdevcdbios.h
|
|
symbol: jaguarDevCDBootROM
|
|
size: 262144 # 0x40000, 256 KB
|
|
description: "Jaguar Developer CD boot ROM"
|
|
filedb_crc: "0x55A0669C"
|
|
filedb_name: "[BIOS] Atari Jaguar Developer CD (World)"
|
|
|
|
bios_type_enum:
|
|
source_ref: "src/core/settings.h:66"
|
|
values:
|
|
- BT_K_SERIES
|
|
- BT_M_SERIES
|
|
- BT_STUBULATOR_1
|
|
- BT_STUBULATOR_2
|
|
- BT_CUSTOM
|
|
|
|
core_option:
|
|
key: virtualjaguar_bios
|
|
label: "BIOS (Cartridges)"
|
|
description: "Which BIOS a cartridge boots with: disabled is HLE, enabled runs the boot ROM."
|
|
default: disabled
|
|
source_ref: "libretro_core_options.h:589-601"
|
|
|
|
bios_loading:
|
|
mechanism: embedded
|
|
load_address: "0xE00000"
|
|
load_size: "0x20000"
|
|
source_ref: "libretro.c:6105-6180, libretro.c:7237"
|
|
selection_logic: "BT_CUSTOM reads a file, BT_M_SERIES tries jagboot_m.rom, otherwise the embedded array"
|
|
external_loading: true
|
|
note: |
|
|
jagBootPath and CDBootPath struct fields are never set in the libretro
|
|
port. The standalone Virtual Jaguar GUI uses them but that code path
|
|
is not compiled into the libretro core.
|