openMSX
Technical notes
Standalone MSX emulator supporting MSX1 through turboR, ColecoVision,
Spectravideo, and Pioneer LaserDisc hardware. Uses XML machine definitions
(share/machines/) that describe complete hardware configurations and
reference system ROMs by filename and SHA1 hash.
ROM resolution via FilePool (src/file/FilePool.cc, FilePoolCore.cc):
searches configured directories for files matching SHA1 checksums.
Filenames are secondary hints, while SHA1 is the primary lookup key.
Files may be gzipped or individually zipped.
Each user data directory contributes share/systemroms, scanned
recursively (src/file/FilePool.cc:27, FilePoolCore.cc:369-385). RetroBat
sets OPENMSX_HOME to bios/openmsx and refuses to start a machine whose
ROMs are not in bios/openmsx/share/systemroms. RetroPie links
share/systemroms to BIOS/openmsx and Batocera adds bios/openmsx to the
pool, both scanned recursively, so openmsx/share/systemroms serves all
three.
Batocera configgen (openmsxGenerator.py) configures filepool paths
(/userdata/bios/Machines position 1, /userdata/bios/openmsx position 2)
and selects machines per system type:
msx1, msx2 -> Boosted_MSX2_EN (enhanced Philips NMS 8245)
msx2+ -> Boosted_MSX2+_JP (enhanced Panasonic FS-A1WSX)
msxturbor -> Boosted_MSXturboR_with_IDE (enhanced Panasonic FS-A1GT)
colecovision -> ColecoVision_SGM
spectravideo -> Spectravideo_SVI-328
laserdisc (.ogv) -> Pioneer_PX-7
C-BIOS (open source MSX BIOS replacement) is shipped with openMSX in
Contrib/cbios/ and supports cartridge-only games. Not used by Batocera.
237 machine definitions exist in total. Each machine has its own ROM
requirements. Only ROMs for Batocera-selected machines are listed here.
Users selecting other machines via openMSX GUI need additional ROMs.
17 files | 17 required, 0 optional | 17 in repo, 0 missing
NMS8245SystemROM1.08.bin required in repo #
NMS 8245 combined system ROM (BIOS+BASIC 0x0000-0x7FFF, Sub ROM 0x8000-0xBFFF, FDC 0xC000-0xFFFF)
fmpac.rom required in repo #
Panasonic SW-M004 FMPAC (FM-PAC) sound cartridge ROM
phc-70fd2_basickun.rom required in repo #
Sanyo PHC-70FD2 MSX-BASIC Kun compiler ROM
yrw801.rom required in repo #
Yamaha YRW801 MoonSound wavetable ROM
fs-a1wsx_basic-bios2p.rom required in repo #
FS-A1WSX MSX2+ BIOS and BASIC ROM
fs-a1wsx_fmbasic.rom required in repo #
FS-A1WSX MSX-MUSIC (OPLL) ROM
fs-a1wsx_msx2psub.rom required in repo #
FS-A1WSX MSX2+ Sub ROM
- Path:
openmsx/share/systemroms/fs-a1wsx_msx2psub.rom
- SHA1:
fe0254cbfc11405b79e7c86c7769bd6322b04995
- Validation: sha1
- Source:
share/machines/Boosted_MSX2+_JP.xml:218
- Collection copy:
bios/Microsoft/MSX/MSX2PEXT.ROM
- Platforms: batocera
openmsx/fs-a1wsx_msx2psub.rom, lakka MSX2PEXT.ROM, recalbox Machines/Shared Roms/MSX2PEXT.rom, msx/MSX2PEXT.ROM, retroarch MSX2PEXT.ROM, retrobat MSX2PEXT.ROM, openMSX/share/systemroms/fs-a1wsx_msx2psub.rom, retrodeck bios/MSX2PEXT.ROM, bios/fs-a1wsx_msx2psub.rom, retropie MSX2PEXT.ROM, romm msx/MSX2PEXT.ROM
fs-a1wsx_kanjibasic.rom required in repo #
FS-A1WSX Kanji Driver with BASIC ROM
fs-a1wsx_disk.rom required in repo #
FS-A1WSX FDC (TC8566AF) disk controller ROM
fs-a1wsx_firmware.rom required in repo #
FS-A1WSX Panasonic firmware ROM
fs-a1wsx_kanjifont.rom required in repo #
Kanji font ROM (shared by FS-A1WSX and FS-A1GT machines)
fs-a1gt_firmware.rom required in repo #
FS-A1GT turboR combined firmware (512KB, contains BIOS, Sub ROM, Kanji, FDC, MSX-MUSIC, Opening ROM)
ide250.dat required in repo #
Sunrise IDE 2.50 interface ROM
COLECO.ROM required in repo #
ColecoVision system BIOS ROM
- Path:
openmsx/share/systemroms/COLECO.ROM
- SHA1:
45bedc4cbdeac66c7df59e9e599195c778d86a92
- Validation: sha1
- Source:
share/machines/ColecoVision_SGM.xml:57
- Collection copy:
bios/Coleco/ColecoVision/BIOS.col
- Platforms: batocera
colecovision.rom, bizhawk Coleco_Bios.bin, emudeck colecovision.rom, lakka BIOS.col, coleco.rom, colecovision.rom, recalbox Machines/COL - ColecoVision with Opcode Memory Extension/coleco.rom, Machines/COL - ColecoVision/coleco.rom, coleco/boot.rom, retroarch BIOS.col, coleco.rom, colecovision.rom, retrobat coleco.rom, colecovision.rom, openMSX/share/systemroms/coleco.rom, retrodeck bios/BIOS.col, bios/coleco.rom, bios/colecovision.rom, retropie BIOS.col, coleco.rom, colecovision.rom, romm colecovision/colecovision.rom
svi-3x8_v111.rom required in repo #
SVI-328 BASIC v1.11 ROM
px-7_basic-bios1.rom required in repo #
Pioneer PX-7 MSX1 BIOS and BASIC ROM
px-7_pbasic.rom required in repo #
Pioneer PX-7 LaserDisc PBASIC controller ROM
Generated on 2026-10-20T03:49:42Z