mirror of
https://github.com/Abdess/retroarch_system.git
synced 2026-11-11 12:33:53 -06:00
224 lines
11 KiB
YAML
224 lines
11 KiB
YAML
emulator: PCEE2
|
|
type: libretro
|
|
core_classification: community_fork
|
|
bios_mode: agnostic
|
|
source: "https://github.com/WizzardSK/pcee2-libretro"
|
|
upstream: "https://github.com/PCSX2/pcsx2"
|
|
profiled_date: "2026-11-09"
|
|
source_commit: "2b0edbe67188977c7709b57d6effdc70147eeb0d"
|
|
upstream_commit: "ab0b401f99729ef8da3009f9af28d8ee96e0e7ba"
|
|
core_version: "v2.9.138"
|
|
version_basis:
|
|
kind: tag
|
|
repo: upstream
|
|
tag: "v2.9.138"
|
|
distance: 0
|
|
display_name: "Sony - PlayStation 2 (PCEE2)"
|
|
cores: [pcee2]
|
|
systems: [sony-playstation-2, namco-system246, namco-system256]
|
|
|
|
bios_directory: "pcsx2/bios/"
|
|
resources_directory: "pcsx2/resources/"
|
|
|
|
data_directories:
|
|
- ref: pcsx2-resources
|
|
destination: "pcsx2/resources"
|
|
bundled: true
|
|
source_ref: "pcee2-libretro/Libretro.cpp:548-576, pcsx2/Pcsx2Config.cpp:2418-2430, cmake/EmbedResources.cmake:19-31, 46-62"
|
|
|
|
notes: |
|
|
libretro port of current PCSX2, merged up to upstream ab0b401f (v2.9.138,
|
|
pcee2-libretro/upstream.version). The build reports that version as
|
|
library_version. Everything the port adds lives in pcee2-libretro/ and in
|
|
the libretro renderer bridges, while the BIOS, CDVD, patch and database code is
|
|
upstream PCSX2.
|
|
|
|
InitializeConfig maps the PCSX2 folder layout under <system>/pcsx2:
|
|
AppRoot and DataRoot are that directory, Resources and UserResources are
|
|
pcsx2/resources, Settings is pcsx2/inis, and EmuFolders::LoadConfig
|
|
derives bios, memcards, cheats, patches, textures, gamesettings, cache,
|
|
snaps, sstates, logs, covers, inputprofiles and videos from DataRoot
|
|
(pcee2-libretro/Libretro.cpp:548-562, pcsx2/Pcsx2Config.cpp:2349-2366).
|
|
A standalone PCSX2.ini dropped in pcsx2/inis contributes nine emulation
|
|
sections as the baseline (pcee2-libretro/Libretro.cpp:638-669), and the core options and the
|
|
port overrides apply on top.
|
|
|
|
BIOS detection is filename-agnostic. The core option pcsx2_bios lists every
|
|
file of pcsx2/bios that IsBIOS accepts: a romdir whose RESET entry is
|
|
followed by a readable ROMVER, whose fifth character gives the zone (Japan,
|
|
USA, Europe, Asia, China, T10K, COH-H, Test, Free). With the option on
|
|
auto, SettingsOverride selects the first accepted file whose zone is not
|
|
COH-H, and clears a COH-H image left selected by an earlier arcade game
|
|
(pcee2-libretro/Libretro.cpp:712-783, pcsx2/ps2/BiosTools.cpp:80-207, 294-304).
|
|
An .acgame content runs on the Namco System 246/256 board BIOS instead:
|
|
the first file of pcsx2/bios whose zone is COH-H, whatever the option says.
|
|
Without one the game is started on the BIOS the option or the auto
|
|
selection gives (pcee2-libretro/Libretro.cpp:2333,
|
|
pcee2-libretro/Libretro.cpp:712-730). The media image, the dongle memory
|
|
card, the bootloader ELF and the SRAM file are named by the .acgame and
|
|
read beside it (pcsx2/VMManager.cpp:1335-1473). When no BIOS is configured or the
|
|
configured name is missing, LoadBIOS falls back to FindBiosImage, which
|
|
also filters on size between 4 and 8 MB (pcsx2/ps2/BiosTools.cpp:268-292, 327-379).
|
|
The image is read into the 4 MB ROM region, and a file shorter than 2465792
|
|
bytes turns off the OSDSys parameter HLE. No hash is matched. Booting with
|
|
no content starts the BIOS (pcee2-libretro/Libretro.cpp:2322-2332).
|
|
|
|
Companions derive from the selected image: rom1 and rom2 are tried as the
|
|
full name plus extension, then with the extension replaced, and are skipped
|
|
when absent. The nvm is read at the replaced extension and rebuilt with
|
|
region and language defaults when missing or blank, and the mec is written back
|
|
as 0x00020603 when it cannot be read (pcsx2/ps2/BiosTools.cpp:224-251, 376-377,
|
|
pcsx2/CDVD/CDVD.cpp:141-214). During an arcade game a rebuilt nvm starts
|
|
from 0xFF bytes, a readable one is kept without the blank check, and a
|
|
missing mec is written as 0x0104020A, the version of a COH-H31100.
|
|
|
|
The shaders, four interface fonts, GameIndex.yaml and patches.zip are built
|
|
into the core (cmake/EmbedResources.cmake:19-31, 46-62,
|
|
pcsx2/CMakeLists.txt:1181-1230)
|
|
and win over the copies on disk unless PCEE2_EXTERNAL_RESOURCES is set in
|
|
the environment (pcsx2/EmbeddedResources.cpp:8-12, pcsx2/GS/Renderers/Common/GSDevice.cpp:441-465,
|
|
pcsx2/ImGui/ImGuiManager.cpp:473-495, pcsx2/GameDatabase.cpp:1042-1071, pcsx2/Patch.cpp:293-332,
|
|
pcee2-libretro/Libretro.cpp:585-607). A missing resources directory is a warning, not a
|
|
failure (pcee2-libretro/Libretro.cpp:567-576). patches.zip is packed at build time from the
|
|
3rdparty/pcsx2_patches submodule, so the build carries the patches of the
|
|
commit it points at, and the directory supplies nothing this build reads
|
|
by default. RedumpDatabase.yaml is read only by the Qt game
|
|
summary (pcsx2/GameDatabase.cpp:1218-1231 has no caller in the core),
|
|
game_controller_db.txt only by the SDL input source the port disables
|
|
(pcee2-libretro/Libretro.cpp:695-696, pcsx2/Input/SDLInputSource.cpp:701-706), the
|
|
achievement sounds only with achievements enabled, which no core option or
|
|
adopted ini section does (pcsx2/Achievements.cpp:944-952), and
|
|
fullscreenui/no-save.png only by the save state selector, whose hotkeys the
|
|
port clears (pcee2-libretro/Libretro.cpp:698, pcsx2/ImGui/ImGuiOverlays.cpp:1441-1442).
|
|
The port supplies Roboto alone to ImGui, so no emoji font is read.
|
|
|
|
Per-game user files keep their PCSX2 locations under <system>/pcsx2:
|
|
cheats and patches as <serial>_<crc>.pnach, <serial>.pnach for an arcade
|
|
game, whose crc is 0 (pcsx2/Patch.cpp:334-371),
|
|
gamesettings/<serial>_<crc>.ini (pcsx2/VMManager.cpp:869-872),
|
|
textures/<serial>/replacements (pcsx2/GS/Renderers/HW/GSTextureReplacements.cpp:269-271),
|
|
memcards/*.ps2, which the core creates and lists in the memory card
|
|
options (pcee2-libretro/Libretro.cpp:785-805). The DEV9 HDD image is named in the ini and
|
|
created on demand.
|
|
|
|
files:
|
|
- name: "<bios>.bin"
|
|
found_by: content
|
|
path: "pcsx2/bios/<bios>.bin"
|
|
description: "PS2 BIOS image"
|
|
min_size: 4194304
|
|
max_size: 8388608
|
|
required: true
|
|
validation: [size]
|
|
source_ref: "source pcee2-libretro/Libretro.cpp:712-783, source pcsx2/ps2/BiosTools.cpp:16-17, source pcsx2/ps2/BiosTools.cpp:80-207, source pcsx2/ps2/BiosTools.cpp:268-304, source pcsx2/ps2/BiosTools.cpp:327-379"
|
|
note: >
|
|
Any file of pcsx2/bios whose romdir carries RESET and ROMVER. The 4 to
|
|
8 MB filter applies in FindBiosImage only. The core option scan and the
|
|
auto selection accept any size that passes the romdir check, and the
|
|
auto selection passes over a COH-H image.
|
|
|
|
- name: r27v1602f.8g
|
|
found_by: content
|
|
path: pcsx2/bios/r27v1602f.8g
|
|
system: namco-system256
|
|
agnostic: true
|
|
required: false
|
|
description: "Namco System 256 board BIOS"
|
|
source_ref: "source pcee2-libretro/Libretro.cpp:712-730, source pcee2-libretro/Libretro.cpp:2333, source pcsx2/ps2/BiosTools.cpp:149-153, source pcsx2/ps2/BiosTools.cpp:176-180"
|
|
note: >
|
|
Read for an .acgame content only. The first file of pcsx2/bios whose
|
|
ROMVER zone is COH-H is selected, whatever its name or size, and no board
|
|
is preferred over another. The name is the board position the chip dump
|
|
carries.
|
|
|
|
- name: r27v1602f.7d
|
|
found_by: content
|
|
path: pcsx2/bios/r27v1602f.7d
|
|
system: namco-system246
|
|
agnostic: true
|
|
required: false
|
|
description: "Namco System 246 Rack C board BIOS"
|
|
source_ref: "source pcee2-libretro/Libretro.cpp:712-730, source pcee2-libretro/Libretro.cpp:2333, source pcsx2/ps2/BiosTools.cpp:149-153, source pcsx2/ps2/BiosTools.cpp:176-180"
|
|
note: >
|
|
Same selection as the System 256 image: any COH-H image serves any
|
|
.acgame content.
|
|
|
|
- name: COH-H31000.BIN
|
|
found_by: content
|
|
path: pcsx2/bios/COH-H31000.BIN
|
|
system: namco-system246
|
|
agnostic: true
|
|
required: false
|
|
description: "Sony COH-H A-000-010 board BIOS"
|
|
source_ref: "source pcee2-libretro/Libretro.cpp:712-730, source pcee2-libretro/Libretro.cpp:2333, source pcsx2/ps2/BiosTools.cpp:149-153, source pcsx2/ps2/BiosTools.cpp:176-180"
|
|
note: >
|
|
Same selection as the System 256 image: any COH-H image serves any
|
|
.acgame content.
|
|
|
|
- name: "<bios>.rom1"
|
|
path: "pcsx2/bios/<bios>.rom1"
|
|
description: "DVD player ROM"
|
|
max_size: 4194304
|
|
required: false
|
|
source_ref: "source pcsx2/ps2/BiosTools.cpp:224-251, source pcsx2/ps2/BiosTools.cpp:376, source pcsx2/MemoryTypes.h:13"
|
|
note: >
|
|
Tried as <bios>.bin.rom1 then <bios>.rom1, opened case-insensitively,
|
|
skipped with a console line when absent.
|
|
|
|
- name: "<bios>.rom2"
|
|
path: "pcsx2/bios/<bios>.rom2"
|
|
description: "Chinese ROM extension"
|
|
max_size: 4194304
|
|
required: false
|
|
source_ref: "source pcsx2/ps2/BiosTools.cpp:224-251, source pcsx2/ps2/BiosTools.cpp:377, source pcsx2/MemoryTypes.h:14"
|
|
note: >
|
|
Same lookup as rom1. Present on Chinese region consoles only.
|
|
|
|
- name: "<bios>.nvm"
|
|
path: "pcsx2/bios/<bios>.nvm"
|
|
description: "Console NVRAM (region parameters, language, iLink ID, OSD settings)"
|
|
size: 1024
|
|
required: false
|
|
hle_fallback: true
|
|
source_ref: "source pcsx2/CDVD/CDVD.cpp:49, source pcsx2/CDVD/CDVD.cpp:141-197, source pcsx2/CDVD/CDVD.cpp:216-247"
|
|
note: >
|
|
Read at <bios>.nvm, rebuilt in memory with region and language defaults
|
|
when it is missing, short, or has a blank config block, and written back
|
|
on save.
|
|
|
|
- name: "<bios>.mec"
|
|
path: "pcsx2/bios/<bios>.mec"
|
|
description: "Mechacon version, one u32"
|
|
size: 4
|
|
required: false
|
|
hle_fallback: true
|
|
source_ref: "source pcsx2/CDVD/CDVD.cpp:51-53, source pcsx2/CDVD/CDVD.cpp:199-213"
|
|
note: >
|
|
Read at <bios>.mec, written as 0x00020603 when it cannot be read, or as
|
|
0x0104020A during an arcade game.
|
|
|
|
- name: "patches.zip"
|
|
path: "pcsx2/resources/patches.zip"
|
|
description: "Built-in game patch archive (pnach per serial and CRC)"
|
|
required: false
|
|
category: game_data
|
|
source_ref: "upstream pcsx2/Patch.cpp:117, source pcsx2/Patch.cpp:293-332, source pcsx2/Patch.cpp:382-422, source pcsx2/CMakeLists.txt:1194-1216"
|
|
note: >
|
|
Embedded in the core, packed from the 3rdparty/pcsx2_patches submodule.
|
|
The copy in the resources directory is opened only when
|
|
PCEE2_EXTERNAL_RESOURCES is set or the build carries no embedded copy.
|
|
Searched for <serial>_<crc>.pnach, then <crc>.pnach, when a game's
|
|
patches are enumerated. Files in the patches folder take precedence. A
|
|
failure to open is reported once on screen.
|
|
|
|
- name: "eeprom.dat"
|
|
load_from: working_directory
|
|
description: "DEV9 network adapter EEPROM"
|
|
size: 64
|
|
required: false
|
|
hle_fallback: true
|
|
source_ref: "upstream pcsx2/DEV9/DEV9.cpp:60-73, source pcsx2/DEV9/DEV9.cpp:106-167"
|
|
note: >
|
|
Opened read-write and mapped from the process working directory by
|
|
DEV9init. The built-in eeprom table is used when it cannot be opened.
|