mirror of
https://github.com/Abdess/retroarch_system.git
synced 2026-11-11 12:33:53 -06:00
180 lines
8.8 KiB
YAML
180 lines
8.8 KiB
YAML
emulator: "Geartowns"
|
|
type: libretro
|
|
core_classification: official_port
|
|
source: "https://github.com/drhelius/Geartowns"
|
|
upstream: "https://github.com/drhelius/Geartowns"
|
|
profiled_date: "2026-11-09"
|
|
source_commit: "0b3ee180c3d0405cac29f6b2587bc9e458664504"
|
|
prose_written_at: "0b3ee180c3d0405cac29f6b2587bc9e458664504"
|
|
core_version: "1.0.6-3-g0b3ee18"
|
|
version_basis:
|
|
kind: tag
|
|
tag: "1.0.6"
|
|
distance: 3
|
|
display_name: "Fujitsu - FM Towns (Geartowns)"
|
|
cores:
|
|
- "geartowns"
|
|
systems:
|
|
- "fmtowns"
|
|
|
|
notes: |
|
|
FM Towns emulator by Ignacio Sanchez (drhelius). The same tree builds the
|
|
desktop application and the libretro core (platforms/libretro). The core
|
|
emulates the Model 1/2, 1F/2F, 10F/20F, II CX, UX, UG, HG, HR, UR, ME, MA,
|
|
MX, MF/Fresh and the Marty, the HC being listed but not emulated
|
|
(src/system/machine_profiles.h:120-134, `emulated` field). The version
|
|
string is `git describe` at build time (platforms/libretro/Makefile:369-371).
|
|
|
|
retro_load_game() fails when load_bios() finds no firmware
|
|
(platforms/libretro/libretro.cpp:818-822). load_bios() searches
|
|
system/geartowns first, then the system directory itself, each time
|
|
accepting first only a set made for the selected model and then any set
|
|
(platforms/libretro/libretro.cpp:937-964). Firmware::FindSources() takes
|
|
as candidates the folder itself, every direct subfolder and every .zip in
|
|
it (src/media/firmware.cpp:288-348). Folder and zip names are free. A
|
|
candidate counts only when the System, OS, Font and Dictionary ROMs are all
|
|
present at the right size, and the CRC32 of its System ROM names the set
|
|
(src/media/firmware.cpp:377-416, src/media/firmware.h:115-125).
|
|
|
|
Six sets are known (src/media/firmware.h:115-125): fmtowns (Model 1/2),
|
|
freetowns (Free FM Towns Project replacement ROMs, used by the Model 1/2),
|
|
fmtownsux (UX, also used by 1F/2F, 10F/20F, CX and UG), fmtmarty (Marty),
|
|
fmtownshr (HR, also used by the HG and UR) and the V10 set (made for the
|
|
MF/Fresh and MX, also used by the HG, UR, ME and MA). The V10 set is read
|
|
from the MAME fmtownsftv files or from the single MX mask ROM. On Auto the
|
|
model comes from the game database and falls back to the Model 1/2 or to
|
|
the first model in release order that has a set made for it or accepted by
|
|
it (src/geartowns_core.cpp:2088-2142, src/geartowns_core.cpp:2238-2243). A
|
|
1.44 MB floppy (2HD at 300 rpm) inserted on Auto replaces a model without a
|
|
three-mode drive by the first one in release order that has it
|
|
(src/geartowns_core.cpp:803-806, src/geartowns_core.cpp:2115-2123). A set
|
|
made for another model still loads in the second pass, with a warning
|
|
(platforms/libretro/libretro.cpp:966-999).
|
|
|
|
File names are matched without case, inside a zip only at the archive root
|
|
(src/media/firmware.cpp:622-671). Accepted names, one group per component,
|
|
are (FMT_SYS.ROM, FMT_SYS_A.ROM, FMTHR_SYS.ROM), (FMT_DOS.ROM, FMT_DOS_A.ROM),
|
|
(FMT_FNT.ROM), (FMT_DIC.ROM), (FMT_F20.ROM, FMT_F20_A.ROM), (MYTOWNS.ROM,
|
|
MYTOWNSUX.ROM, MYTOWNSM2.ROM, MYTOWNSFTV.ROM, MYTOWNSHR.ROM, MYTOWNSMX.ROM)
|
|
and (MAR_EX0.ROM to MAR_EX3.ROM) (src/media/firmware.cpp:28-42). Without
|
|
separate files the components are cut from 2 MiB mask ROMs
|
|
(src/media/firmware.cpp:500-516). For the Marty, MROM.M36 holds the OS at 0
|
|
and the first three extension parts, and MROM.M37 the fourth extension
|
|
part, the 20-dot font at 0x80000, the dictionary at 0x100000, the font at
|
|
0x180000 and the System ROM at 0x1C0000. For the MX, FMTOWNSIIMXBIOS.M79
|
|
holds the OS at 0, the font at 0x80000, the System ROM at 0xC0000, the
|
|
20-dot font at 0x100000 and the dictionary at 0x180000.
|
|
|
|
Each component must have its exact size or it is rejected
|
|
(src/media/firmware.cpp:538-620, src/common/defines.h:48-55): System
|
|
256 KiB, OS 512 KiB, Font 256 KiB, Dictionary 512 KiB, 20-dot Font 512 KiB,
|
|
Serial 32 bytes, Extension 2 MiB (four 512 KiB parts). System, OS, Font and
|
|
Dictionary are required. A missing 20-dot Font or Extension is replaced by
|
|
0xFF, a missing Serial ROM is generated (src/media/firmware.cpp:76-165,
|
|
src/media/firmware.cpp:260-263). The CRC32 of every component is looked up
|
|
in game_db.h (src/media/firmware.cpp:167-184, src/media/game_db.h:345-380),
|
|
and an unknown CRC only produces a warning. The Free FM Towns set is known by
|
|
System 65DC3B1F, OS 43C18E92, Font 736D9CB1 and a blank Dictionary
|
|
504BF849. The Marty slices are known by System 937311F6, OS 2BC2AF96,
|
|
Extension E1A9FA72 and 20-dot Font 75660AAC.
|
|
|
|
The CMOS is written by the core next to the saves
|
|
(platforms/libretro/libretro.cpp:3365-3379). It is state, not a file to
|
|
obtain.
|
|
|
|
files:
|
|
- name: "fmtowns.zip"
|
|
description: "FM Towns Model 1/2 firmware set"
|
|
system: "fmtowns"
|
|
category: bios_zip
|
|
path: "geartowns/fmtowns.zip"
|
|
required: true
|
|
contents:
|
|
- { name: "fmt_sys.rom", size: 262144, crc32: "53319e23" }
|
|
- { name: "fmt_dos.rom", size: 524288, crc32: "112872ee" }
|
|
- { name: "fmt_fnt.rom", size: 262144, crc32: "955c6b75" }
|
|
- { name: "fmt_dic.rom", size: 524288, crc32: "b314c659" }
|
|
source_ref: "platforms/libretro/libretro.cpp:818-822, platforms/libretro/libretro.cpp:946-964, src/media/firmware.h:117, src/media/firmware.cpp:28-33, src/media/firmware.cpp:288-348, src/media/game_db.h:345-349"
|
|
note: >
|
|
Set for the Model 1/2, the machine Auto falls back to. The same four
|
|
files load from any subfolder of system/geartowns or from
|
|
system/geartowns itself. The core has no CRC for a Model 1/2 20-dot
|
|
Font, and fmt_f20.rom is read when present.
|
|
|
|
- name: "fmtownsux.zip"
|
|
description: "FM Towns II UX firmware set"
|
|
system: "fmtowns"
|
|
category: bios_zip
|
|
path: "geartowns/fmtownsux.zip"
|
|
required: false
|
|
contents:
|
|
- { name: "fmt_sys_a.rom", size: 262144, crc32: "92f3fa67" }
|
|
- { name: "fmt_dos_a.rom", size: 524288, crc32: "22270e9f" }
|
|
- { name: "fmt_fnt.rom", size: 262144, crc32: "dd6fd544" }
|
|
- { name: "fmt_dic.rom", size: 524288, crc32: "82d1daa2" }
|
|
- { name: "mytownsux.rom", size: 32, crc32: "5cc7e6bc" }
|
|
source_ref: "src/media/firmware.h:119-120, src/media/firmware.cpp:28-35, src/media/game_db.h:351-356"
|
|
note: "Set for the UX, also used by the 1F/2F, 10F/20F, CX and UG."
|
|
|
|
- name: "fmtmarty.zip"
|
|
description: "FM Towns Marty firmware set"
|
|
system: "fmtowns"
|
|
category: bios_zip
|
|
path: "geartowns/fmtmarty.zip"
|
|
required: false
|
|
contents:
|
|
- { name: "mrom.m36", size: 2097152 }
|
|
- { name: "mrom.m37", size: 2097152 }
|
|
source_ref: "src/media/firmware.h:121, src/media/firmware.cpp:500-516, src/media/game_db.h:358-362"
|
|
note: >
|
|
The core checks the CRC32 of the slices it cuts from the two mask
|
|
ROMs, not of the files: System 937311F6, OS 2BC2AF96, Extension
|
|
E1A9FA72, 20-dot Font 75660AAC. The Marty 2 layout with separate
|
|
FMT_*.ROM and MAR_EX0.ROM to MAR_EX3.ROM files is read the same way.
|
|
|
|
- name: "fmtownshr.zip"
|
|
description: "FM Towns II HR firmware set"
|
|
system: "fmtowns"
|
|
category: bios_zip
|
|
path: "geartowns/fmtownshr.zip"
|
|
required: false
|
|
contents:
|
|
- { name: "fmthr_sys.rom", size: 262144, crc32: "8aeff982" }
|
|
- { name: "fmt_dos.rom", size: 524288 }
|
|
- { name: "fmt_fnt.rom", size: 262144 }
|
|
- { name: "fmt_dic.rom", size: 524288 }
|
|
- { name: "mytownshr.rom", size: 32, crc32: "c52f0e89" }
|
|
source_ref: "src/media/firmware.h:122, src/media/firmware.cpp:28-35, src/media/game_db.h:364-366"
|
|
note: "Set for the HR, and first choice for the HG and UR."
|
|
|
|
- name: "fmtownsftv.zip"
|
|
description: "FM Towns II V10 firmware set (MF/Fresh)"
|
|
system: "fmtowns"
|
|
category: bios_zip
|
|
path: "geartowns/fmtownsftv.zip"
|
|
required: false
|
|
contents:
|
|
- { name: "fmt_sys.rom", size: 262144, crc32: "afe4ebcf" }
|
|
- { name: "fmt_dos.rom", size: 524288 }
|
|
- { name: "fmt_fnt.rom", size: 262144 }
|
|
- { name: "fmt_dic.rom", size: 524288 }
|
|
- { name: "fmt_f20.rom", size: 524288, crc32: "9f55a20c" }
|
|
- { name: "mytownsftv.rom", size: 32, crc32: "a961aae7" }
|
|
source_ref: "src/media/firmware.h:123-124, src/media/firmware.cpp:28-35, src/media/game_db.h:368-371"
|
|
note: "V10 set for the MF/Fresh and MX, also used by the ME and MA, and second choice for the HG and UR."
|
|
|
|
- name: "fmtownsmx.zip"
|
|
description: "FM Towns II MX firmware set (V10)"
|
|
system: "fmtowns"
|
|
category: bios_zip
|
|
path: "geartowns/fmtownsmx.zip"
|
|
required: false
|
|
contents:
|
|
- { name: "fmtownsiimxbios.m79", size: 2097152 }
|
|
- { name: "mytownsmx.rom", size: 32, crc32: "16e78766" }
|
|
source_ref: "src/media/firmware.h:123-124, src/media/firmware.cpp:28-35, src/media/firmware.cpp:500-516, src/media/game_db.h:373-374"
|
|
note: >
|
|
The V10 set in the MX layout: OS, font, System ROM, 20-dot font and
|
|
dictionary are cut from the one mask ROM, and the System ROM slice is
|
|
the V10 one (AFE4EBCF). Serves the same models as fmtownsftv.zip.
|