mirror of
https://github.com/Abdess/retroarch_system.git
synced 2026-10-31 16:17:19 -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.
53 lines
2.4 KiB
YAML
53 lines
2.4 KiB
YAML
emulator: Gearlynx
|
|
type: libretro
|
|
core_classification: official_port
|
|
source: "https://github.com/drhelius/Gearlynx"
|
|
profiled_date: "2026-10-04"
|
|
source_commit: "77901f3d3b318a12fdf71dd3ebb64048f0070ada"
|
|
core_version: "1.2.36-10-g77901f3"
|
|
version_basis:
|
|
kind: tag
|
|
tag: "1.2.36"
|
|
distance: 10
|
|
display_name: "Atari - Lynx (GearLynx)"
|
|
cores: [gearlynx]
|
|
systems: [atari-lynx]
|
|
verification: existence
|
|
|
|
notes: |
|
|
Gearlynx is an Atari Lynx emulator by Ignacio Sanchez (drhelius).
|
|
The libretro core loads lynxboot.img from the system directory in
|
|
retro_load_game() and again in retro_reset()
|
|
(platforms/libretro/libretro.cpp:175-217, function load_bootroms).
|
|
Path is built as: system_directory + "/lynxboot.img", no subdirectory.
|
|
With the libretro VFS the file is read by load_bios_file() and handed to
|
|
LoadBiosFromBuffer(), otherwise Media::LoadBios() opens it
|
|
(platforms/libretro/libretro.cpp:135-173, src/media.cpp:583-625).
|
|
|
|
LoadBiosData in src/media.cpp:638-688 takes exactly 512 bytes
|
|
(GLYNX_BIOS_SIZE = 0x200, src/defines.h:50). If the file size is not
|
|
0x200, the load is rejected with BIOS_LOAD_INVALID_SIZE. After loading,
|
|
bytes at offset 0x1F8 and 0x1F9 are patched (RAM/MAPCTL registers), then
|
|
CRC32 is computed and compared against GLYNX_DB_BIOS_CRC (0x0D973C9D,
|
|
src/game_db.h:47). An invalid CRC triggers a warning log but the BIOS
|
|
is still marked as loaded (m_is_bios_loaded = true).
|
|
|
|
No HLE fallback. If the BIOS is not loaded (IsBiosLoaded() returns
|
|
false), RunToVBlank in src/gearlynx_core.cpp:232-237 renders a static
|
|
"no bios" image and returns false, refusing to emulate. The BIOS is
|
|
required for any ROM to run. Homebrew (.o, BS93 format) bypasses the
|
|
normal boot sequence via PrepareForHomebrew() but still requires the
|
|
BIOS to be loaded for the emulation loop to execute.
|
|
|
|
ROM extensions: .lnx, .lyx, .o, .bin
|
|
|
|
files:
|
|
- name: "lynxboot.img"
|
|
description: "Atari Lynx boot ROM"
|
|
required: true
|
|
size: 512
|
|
crc32: "0d973c9d"
|
|
validation: [size, crc32]
|
|
source_ref: "platforms/libretro/libretro.cpp:175-217 (load_bootroms), src/media.cpp:638-688 (LoadBiosData), src/defines.h:50 (GLYNX_BIOS_SIZE=0x200), src/game_db.h:47 (GLYNX_DB_BIOS_CRC=0x0D973C9D), src/gearlynx_core.cpp:232-237 (no-bios guard)"
|
|
note: "512-byte boot ROM validated by CRC32 after load. Invalid CRC logs a warning but still works. Missing or wrong-size file blocks emulation entirely (no HLE fallback)."
|