mirror of
https://github.com/Abdess/retroarch_system.git
synced 2026-04-14 04:42:32 -05:00
1d350f0578
add --emulator, --system, --standalone, --list-emulators, --list-systems to verify.py and generate_pack.py. packs are RTU with data directories, regional BIOS variants, and archive support. validation: field per file (size, crc32, md5, sha1) with conflict detection. by_path_suffix index in database.json for regional variant resolution via dest_hint. restructure GameCube IPL to regional subdirs. 66 E2E tests, full pipeline verified.
46 lines
1.9 KiB
YAML
46 lines
1.9 KiB
YAML
emulator: Handy
|
|
type: libretro
|
|
core_classification: community_fork
|
|
source: "https://github.com/libretro/libretro-handy"
|
|
profiled_date: "2026-03-21"
|
|
core_version: "0.95"
|
|
display_name: "Atari - Lynx (Handy)"
|
|
cores:
|
|
- handy
|
|
systems: [atari-lynx]
|
|
|
|
notes: |
|
|
Handy is an Atari Lynx emulator. The core loads lynxboot.img from
|
|
the system directory and validates it by CRC32 (0x0D973C9D). If the
|
|
file is missing or the CRC does not match, the core falls back to an
|
|
internal HLE BIOS that replicates the boot sequence in software
|
|
(ram clear, cart loader decrypt, jump to $0200).
|
|
|
|
The HLE path intercepts CPU calls to ROM addresses FE00, FE19, FE4A
|
|
and FF80 via a Mikie register write trap (address 0xFD97). When
|
|
useEmu is true (no valid BIOS loaded), CRom initialises mRomData
|
|
with a default fill byte (0x88) plus reset vectors pointing to
|
|
the HLE entry points. The cart decryption uses a hardcoded RSA
|
|
public key (lynxdec.cpp) identical to the real hardware.
|
|
|
|
With the real BIOS, the first frame has unusually high cycle counts
|
|
because hardware timers start from the boot ROM rather than being
|
|
set artificially. Blip_Buffer::end_frame() caps the audio buffer
|
|
to handle this overflow.
|
|
|
|
File path: libretro.cpp retro_load_game() joins
|
|
RETRO_ENVIRONMENT_GET_SYSTEM_DIRECTORY with "lynxboot.img".
|
|
No subdirectory.
|
|
|
|
files:
|
|
- name: "lynxboot.img"
|
|
system: atari-lynx
|
|
description: "Atari Lynx boot ROM (Mikie internal 512B ROM)"
|
|
required: false
|
|
hle_fallback: true
|
|
size: 512
|
|
crc32: "0d973c9d"
|
|
validation: [size, crc32]
|
|
source_ref: "rom.h:48-49 (ROM_SIZE=0x200, ROM_CRC32=0xD973C9D), rom.cpp:76-128 (CRom constructor), libretro.cpp:1231-1258 (bios path + CSystem init)"
|
|
notes: "Validated by CRC32 at load time. If invalid or missing, core uses HLE fallback (system.cpp HLE_BIOS_* functions). Games work without it but the real boot ROM provides accurate startup timing."
|