Files
libretro/emulators/mu.yml
T
Abdessamad Derraz b3b3880c19 chore: say which repository each source_ref cites
Profiles that read two repositories, a libretro port and its upstream,
now prefix each citation with source or upstream, decided by which tree
carries the cited value at its pin. The emulator pages use the word to
tell libretro glue, emulator code as the port carries it, and the
upstream emulator apart.
2026-10-20 09:23:41 +02:00

79 lines
3.1 KiB
YAML

emulator: Mu
type: libretro
core_classification: pure_libretro
source: "https://github.com/libretro/Mu"
upstream: "https://github.com/meepingsnesroms/Mu"
profiled_date: "2026-03-24"
source_commit: "afaeb157b8ba38a4a9bdf426ba663f7efb2cc6f8"
core_version: "v1.3.3"
display_name: "Palm OS (Mu)"
cores: [mu]
systems: [palm-os]
notes: |
Mu emulates Palm m500, Palm m515, and (with EMU_SUPPORT_PALM_OS5)
Tungsten T3. A Palm OS ROM dump is required. The core selects the
ROM filename based on the "OS Version" core option:
Palm m500 / Palm OS 4.0 -> palmos40-en-m500.rom
Palm m515 / Palm OS 4.1 -> palmos41-en-m515.rom (default)
Tungsten T3 / Palm OS 5.2 -> palmos52-en-t3.rom
Tungsten T3 / Palm OS 6.0 -> palmos60-en-t3.rom
ROM path: RETRO_ENVIRONMENT_GET_SYSTEM_DIRECTORY + "/" + osVersion + ".rom".
No hash or size validation: the code reads whatever file is present.
The bootloader is optional and ignored for Tungsten T3.
Supports no-game mode (boots Palm OS desktop from ROM without content).
files:
# --- Palm m515 / Palm OS 4.1 (default device) ---
- name: "palmos41-en-m515.rom"
system: palm-os
description: "Palm m515 ROM, Palm OS 4.1 English"
required: true
note: "Default ROM. Selected when core option is 'Palm m515/Palm OS 4.1'."
source_ref: "source libretroBuildSystem/libretro.c:173-176 (check_variables), 744-763 (retro_load_game ROM loading)"
# --- Palm m500 / Palm OS 4.0 ---
- name: "palmos40-en-m500.rom"
system: palm-os
description: "Palm m500 ROM, Palm OS 4.0 English"
required: false
note: "Selected when core option is 'Palm m500/Palm OS 4.0'."
source_ref: "source libretroBuildSystem/libretro.c:169-172"
# --- Tungsten T3 / Palm OS 5.2.1 (requires EMU_SUPPORT_PALM_OS5) ---
- name: "palmos52-en-t3.rom"
system: palm-os
description: "Tungsten T3 ROM, Palm OS 5.2.1 English"
required: false
note: "Selected when core option is 'Tungsten T3/Palm OS 5.2.1'. Requires EMU_SUPPORT_PALM_OS5 compile flag."
source_ref: "source libretroBuildSystem/libretro.c:178-181"
# --- Tungsten T3 / Palm OS 6.0 (requires EMU_SUPPORT_PALM_OS5) ---
- name: "palmos60-en-t3.rom"
system: palm-os
description: "Tungsten T3 ROM, Palm OS 6.0 English"
required: false
note: "Selected when core option is 'Tungsten T3/Palm OS 6.0'. Requires EMU_SUPPORT_PALM_OS5 compile flag."
source_ref: "source libretroBuildSystem/libretro.c:182-185"
# --- MC68VZ328 bootloader ---
- name: "bootloader-dbvz.rom"
system: palm-os
description: "MC68VZ328 UART bootloader"
required: false
note: "Optional for m500/m515. Ignored for Tungsten T3."
source_ref: "source libretroBuildSystem/libretro.c:766-782, source src/dbvz.c:1408-1423 (dbvzLoadBootloader)"
platform_details:
palm_m5xx:
rom_size: 4194304 # 4 MB (M5XX_ROM_SIZE)
bootloader_size: 512 # DBVZ_BOOTLOADER_SIZE (0x200)
cpu: "MC68VZ328"
source_ref: "include/m5XXBus.h:23, 28, src/emulator.c:191-212"
tungsten_t3:
rom_size: 16777216 # 16 MB (TUNGSTEN_T3_ROM_SIZE)
cpu: "PXA260 (ARM)"
source_ref: "include/tungstenT3Bus.h:17, src/emulator.c:145-162"