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.
86 lines
3.7 KiB
YAML
86 lines
3.7 KiB
YAML
emulator: DirectXBox
|
|
type: libretro
|
|
core_classification: pure_libretro
|
|
source: "https://github.com/libretro/libretro-directxbox"
|
|
profiled_date: "2026-03-23"
|
|
source_commit: "8b6b806675065efa7addb833e56fff7c05193bb1"
|
|
core_version: "alpha"
|
|
version_basis:
|
|
kind: file
|
|
path: "src/libretro/libretro.cpp"
|
|
pattern: 'info->library_version\s+=\s+"([^"]+)'
|
|
display_name: "Microsoft - Xbox (DirectXbox)"
|
|
cores:
|
|
- directxbox
|
|
systems:
|
|
- xbox
|
|
|
|
# DirectXBox is an experimental original Xbox emulator written from scratch for
|
|
# libretro. Status: alpha. Cromwell BIOS boots but cannot run games. Microsoft
|
|
# BIOS does not boot yet (ATA/OHCI unimplemented). No audio, no HW acceleration.
|
|
#
|
|
# BIOS loading (libretro.cpp:199-210):
|
|
# Paths are hardcoded relative to the system directory:
|
|
# mcpx_rom_str = <system_dir>/mcpx_1.0.bin
|
|
# bios_rom_str = <system_dir>/cromwell_1024.bin
|
|
# Both are passed to Xbox::LoadBootRoms(flash, mcpx).
|
|
# A commented-out alternative exists: xbox-3944.bin (Microsoft retail BIOS).
|
|
#
|
|
# LoadBootRoms (xbox.cpp:143-210):
|
|
# 1. Opens flash ROM, validates size is a multiple of 0x10000
|
|
# 2. Maps flash ROM to 0xFF000000-0xFFFFFFFF (mirrored to fill 16 MB)
|
|
# 3. Opens MCPX ROM, validates size is exactly 512 bytes
|
|
# 4. Overlays MCPX at the last 512 bytes of flash region
|
|
# If MCPX path is empty, step 3-4 are skipped (Debug/Chihiro machines).
|
|
# retro_load_game returns false if either file fails to load.
|
|
#
|
|
# Machine type (libretro_core_options.h:67-81):
|
|
# Core option "libretro-xbox_machine-type" selects hardware revision.
|
|
# Default "auto" detects from BIOS. Retail v1.0 uses McpxRomVersion::Mcpx1_0,
|
|
# all other retail revisions use Mcpx1_1. Debug and Chihiro use McpxRomVersion::None
|
|
# (no MCPX ROM needed).
|
|
#
|
|
# The .info file declares no firmware_count. Both files are mandatory for retail
|
|
# machine types. The core has no fallback or built-in replacement.
|
|
|
|
files:
|
|
- name: "mcpx_1.0.bin"
|
|
path: "mcpx_1.0.bin"
|
|
size: 512
|
|
validation: [size]
|
|
required: true
|
|
note: >
|
|
Xbox MCPX ROM (secret boot ROM on the southbridge). Contains the initial
|
|
boot vector that loads the flash BIOS. Overlaid at the last 512 bytes of
|
|
the 16 MB flash region (0xFFFFFE00-0xFFFFFFFF). Only needed for retail
|
|
machine types. Debug and Chihiro skip this file.
|
|
source_ref: "src/xbox.cpp:186-207, src/libretro/libretro.cpp:202"
|
|
|
|
- name: "cromwell_1024.bin"
|
|
path: "cromwell_1024.bin"
|
|
size: 1048576
|
|
validation: [size]
|
|
required: true
|
|
note: >
|
|
Cromwell open-source Xbox BIOS (1024 KB variant). Loaded as the flash ROM
|
|
and mirrored across the 16 MB flash region at 0xFF000000. Size must be a
|
|
multiple of 0x10000. This is the only BIOS that currently boots in the
|
|
emulator. The Microsoft retail BIOS (xbox-3944.bin) is referenced in
|
|
commented-out code but does not work yet.
|
|
source_ref: "src/xbox.cpp:143-178, src/libretro/libretro.cpp:203"
|
|
|
|
notes:
|
|
status: >
|
|
Alpha stage. Only Cromwell BIOS boots. No commercial game compatibility.
|
|
Missing ATA (hard drive), OHCI (USB/controllers), audio, and GPU HW
|
|
acceleration. The core requires libvirt86 for x86 virtualization.
|
|
microsoft_bios: >
|
|
The source references xbox-3944.bin as an alternative flash ROM (Microsoft
|
|
retail BIOS, typically 256 KB). It is commented out in src/libretro/libretro.cpp:204
|
|
because ATA and OHCI hardware are not yet implemented, preventing the
|
|
Microsoft BIOS from completing boot.
|
|
machine_types: >
|
|
xbox_database.cpp defines retail v1.0 through v1.6, debug, and chihiro
|
|
variants. Each has different TV encoder (Conexant/Focus/XCalibur) and MCPX
|
|
revision (X2/X3) settings. The core option auto-detects from the loaded BIOS.
|