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.
101 lines
5.4 KiB
YAML
101 lines
5.4 KiB
YAML
emulator: Gearcoleco
|
|
type: libretro
|
|
core_classification: official_port
|
|
source: "https://github.com/drhelius/Gearcoleco"
|
|
upstream: "https://github.com/drhelius/Gearcoleco"
|
|
profiled_date: "2026-09-17"
|
|
source_commit: "be1a3716d2db312c1add1639753258e365f2dfd4"
|
|
core_version: "1.7.4-35-gbe1a371"
|
|
version_basis:
|
|
kind: tag
|
|
tag: "1.7.4"
|
|
distance: 35
|
|
display_name: "Coleco - ColecoVision / ADAM (Gearcoleco)"
|
|
cores:
|
|
- gearcoleco
|
|
systems:
|
|
- colecovision
|
|
- coleco-adam
|
|
|
|
notes: |
|
|
ColecoVision and Coleco ADAM emulator by Ignacio Sanchez (drhelius). The
|
|
libretro port lives in the same repository. Three firmware roles are
|
|
declared in kAdamFirmwareMetadata (src/Adam.cpp:26-40): OS-7, EOS and
|
|
SmartWriter, each with a size, a CRC32 and its accepted file names.
|
|
|
|
find_firmware() (platforms/libretro/libretro.cpp:779-840) walks the
|
|
frontend system directory and then its gearcoleco subdirectory
|
|
(platforms/libretro/libretro.cpp:793), trying every accepted name in each. A file whose size
|
|
differs from the role's size is skipped with a warning (platforms/libretro/libretro.cpp:812-817).
|
|
Every candidate that passes is compared to the first one found: two
|
|
valid-sized images with different bytes are an ambiguous role and the load
|
|
fails (platforms/libretro/libretro.cpp:826-833). CRC32 is computed after the search and only
|
|
logged when it differs from the table (platforms/libretro/libretro.cpp:873-876, 924-935).
|
|
|
|
The machine is chosen per load (platforms/libretro/libretro.cpp:2441-2443): .ddp, .dsk, a ZIP
|
|
holding an ADAM image, an .m3u playlist, no content at all, or a cartridge
|
|
with the core option gearcoleco_cartridge_hardware set to ADAM start the
|
|
ADAM, and any other cartridge starts the ColecoVision. The "adam" subsystem
|
|
(platforms/libretro/libretro.cpp:535-543) takes a cartridge, two disks and two data packs.
|
|
|
|
ColecoVision: load_colecovision_firmware() (platforms/libretro/libretro.cpp:858-885) needs OS-7
|
|
and retro_load_game() returns false without it (platforms/libretro/libretro.cpp:2453-2457).
|
|
It runs again on retro_reset() (platforms/libretro/libretro.cpp:2258-2259). The image goes
|
|
through Memory::LoadBiosFromBuffer() (src/Memory.cpp:310-319) and byte 0x69
|
|
is patched on reset, 0x32 when the cartridge is PAL and 0x3C otherwise
|
|
(src/Memory.cpp:246-249). The ADAM always gets 0x3C (src/Memory.cpp:221).
|
|
|
|
ADAM: load_adam_firmware() (platforms/libretro/libretro.cpp:887-948) needs all three roles and
|
|
every ADAM entry point returns false when one is missing (platforms/libretro/libretro.cpp:
|
|
2427-2428, 2484-2488, 2501-2502, 2585-2589). Adam::LoadFirmware()
|
|
(src/Adam.cpp:166-188) copies the three images, IsFirmwareReady()
|
|
(src/Adam.cpp:137-146) gates StartAdam() (src/GearcolecoCore.cpp:414-419).
|
|
The MIOC maps SmartWriter over the lower 32 KiB with EOS replacing its
|
|
last 8 KiB bank when the control latch selects it, and OS-7 over the first
|
|
8 KiB in cartridge mode (src/Adam.cpp:513-537).
|
|
|
|
Save RAM, save states and IPS patches are read next to the content or in
|
|
the frontend save directory. They are state the core writes, not files a
|
|
user obtains.
|
|
|
|
files:
|
|
- name: "colecovision.rom"
|
|
aliases: ["coleco.rom", "os7.u2"]
|
|
description: "ColecoVision OS-7 BIOS"
|
|
system: colecovision
|
|
required: true
|
|
size: 8192
|
|
crc32: "3aa93ef3"
|
|
validation: [size, crc32]
|
|
source_ref: "platforms/libretro/libretro.cpp:779-840 (find_firmware), platforms/libretro/libretro.cpp:858-885 (load_colecovision_firmware), platforms/libretro/libretro.cpp:2453-2457, platforms/libretro/libretro.cpp:2258-2259, src/Adam.cpp:28-31, src/Adam.h:52, src/Memory.cpp:310-319, src/Memory.cpp:246-249"
|
|
note: >
|
|
Loaded for both machines. Any 8192-byte image is accepted, and a CRC32
|
|
other than 3aa93ef3 logs "Unknown OS-7 revision" and runs. PAL timing
|
|
comes from the byte patched at 0x69, not from a PAL dump.
|
|
|
|
- name: "eos.rom"
|
|
description: "ADAM EOS (Elementary Operating System) ROM"
|
|
system: coleco-adam
|
|
required: true
|
|
size: 8192
|
|
crc32: "05a37a34"
|
|
validation: [size, crc32]
|
|
source_ref: "platforms/libretro/libretro.cpp:887-948 (load_adam_firmware), platforms/libretro/libretro.cpp:2426-2427, platforms/libretro/libretro.cpp:2483-2487, platforms/libretro/libretro.cpp:2500-2501, platforms/libretro/libretro.cpp:2584-2588, src/Adam.cpp:32-35, src/Adam.h:53, src/Adam.cpp:137-146, src/Adam.cpp:166-188, src/GearcolecoCore.cpp:414-419, src/Adam.cpp:519-522"
|
|
note: >
|
|
The 8 KiB EOS bank, the first half of the 16 KiB u22 chip. A CRC32
|
|
other than 05a37a34 logs "Unknown EOS revision" and runs. Only the ADAM
|
|
needs it: ColecoVision cartridges load without it.
|
|
|
|
- name: "writer.rom"
|
|
aliases: ["wp.rom", "wp_r80.rom"]
|
|
description: "ADAM SmartWriter word processor ROM"
|
|
system: coleco-adam
|
|
required: true
|
|
size: 32768
|
|
crc32: "58d86a2a"
|
|
validation: [size, crc32]
|
|
source_ref: "platforms/libretro/libretro.cpp:887-948 (load_adam_firmware), platforms/libretro/libretro.cpp:2426-2427, platforms/libretro/libretro.cpp:2483-2487, platforms/libretro/libretro.cpp:2500-2501, platforms/libretro/libretro.cpp:2584-2588, src/Adam.cpp:36-39, src/Adam.h:54, src/Adam.cpp:137-146, src/Adam.cpp:166-188, src/GearcolecoCore.cpp:414-419, src/Adam.cpp:513-522"
|
|
note: >
|
|
A CRC32 other than 58d86a2a logs "Unknown SmartWriter revision" and
|
|
runs. Only the ADAM needs it: ColecoVision cartridges load without it.
|