libretro/emulators/bsnes_hd_beta.yml

emulator: bsnes-hd beta
type: libretro
core_classification: enhanced_fork
source: "https://github.com/DerKoun/bsnes-hd"
upstream: "https://github.com/bsnes-emu/bsnes"
profiled_date: "2026-03-23"
core_version: "v10.6"
display_name: "Nintendo - SNES / SFC (bsnes-hd beta)"
cores: [bsnes_hd_beta, bsneshd, bsnes_hd]
systems:
  - nintendo-snes
  - nintendo-sgb
  - nintendo-satellaview
  - nintendo-sufami-turbo

notes: |
  bsnes-hd beta is a fork of bsnes ~v114 by DerKoun with widescreen
  and true color rendering. Firmware handling identical to bsnes v115.
  repo Version="10.6", SerializerVersion="114.2"
  ref: bsnes/emulator/emulator.hpp:33-34,40

  SGB boot ROMs embedded in binary (icd/boot-roms.cpp:1,12).
  SGB1.sfc/SGB2.sfc are SGB cartridge ROMs (not boot ROMs).
  HLE available for DSP1/1B/2/4, ST010, CX4 (default ON in libretro).
  DSP3, ST011, ST018 have no HLE.
  Coprocessor firmware not loaded from system_dir in libretro wrapper;
  HLE used by default, LLE requires firmware embedded in ROM.
  ref: sfc/cartridge/load.cpp:431,506,586
  ref: sfc/coprocessor/icd/icd.cpp:87,90
  ref: target-libretro/libretro_core_options.h:462-470

files:
  # NEC uPD7725 coprocessor firmware (DSP1/1B/2/3/4)
  # code requests upd7725.program.rom / upd7725.data.rom internally
  # .info conventional names used here
  - name: dsp1.program.rom
    system: nintendo-snes
    required: false
    hle_fallback: true
    source_ref: "sfc/cartridge/load.cpp:490-494,506-513"
  - name: dsp1.data.rom
    system: nintendo-snes
    required: false
    hle_fallback: true
    source_ref: "sfc/cartridge/load.cpp:498-503,506-513"
  - name: dsp1b.program.rom
    system: nintendo-snes
    required: false
    hle_fallback: true
    source_ref: "sfc/cartridge/load.cpp:490-494,506-513"
  - name: dsp1b.data.rom
    system: nintendo-snes
    required: false
    hle_fallback: true
    source_ref: "sfc/cartridge/load.cpp:498-503,506-513"
  - name: dsp2.program.rom
    system: nintendo-snes
    required: false
    hle_fallback: true
    source_ref: "sfc/cartridge/load.cpp:490-494,515-520"
  - name: dsp2.data.rom
    system: nintendo-snes
    required: false
    hle_fallback: true
    source_ref: "sfc/cartridge/load.cpp:498-503,515-520"
  - name: dsp3.program.rom
    system: nintendo-snes
    required: false
    note: "no HLE — required for SD Gundam GX"
    source_ref: "sfc/cartridge/load.cpp:490-494,531-534"
  - name: dsp3.data.rom
    system: nintendo-snes
    required: false
    note: "no HLE — required for SD Gundam GX"
    source_ref: "sfc/cartridge/load.cpp:498-503,531-534"
  - name: dsp4.program.rom
    system: nintendo-snes
    required: false
    hle_fallback: true
    source_ref: "sfc/cartridge/load.cpp:490-494,522-528"
  - name: dsp4.data.rom
    system: nintendo-snes
    required: false
    hle_fallback: true
    source_ref: "sfc/cartridge/load.cpp:498-503,522-528"

  # Hitachi HG51BS169 coprocessor (CX4)
  # code requests hg51bs169.data.rom internally
  - name: cx4.data.rom
    system: nintendo-snes
    required: false
    hle_fallback: true
    size: 3072
    source_ref: "sfc/cartridge/load.cpp:431-454"

  # NEC uPD96050 coprocessor (ST010/ST011)
  # code requests upd96050.program.rom / upd96050.data.rom internally
  - name: st010.program.rom
    system: nintendo-snes
    required: false
    hle_fallback: true
    source_ref: "sfc/cartridge/load.cpp:570-574,586-596"
  - name: st010.data.rom
    system: nintendo-snes
    required: false
    hle_fallback: true
    source_ref: "sfc/cartridge/load.cpp:578-583,586-596"
  - name: st011.program.rom
    system: nintendo-snes
    required: false
    note: "no HLE — required for Hayazashi Nidan Morita Shougi"
    source_ref: "sfc/cartridge/load.cpp:570-574,599-602"
  - name: st011.data.rom
    system: nintendo-snes
    required: false
    note: "no HLE — required for Hayazashi Nidan Morita Shougi"
    source_ref: "sfc/cartridge/load.cpp:578-583,599-602"

  # ARM6 coprocessor (ST018)
  # code requests arm6.program.rom / arm6.data.rom internally
  - name: st018.program.rom
    system: nintendo-snes
    required: false
    note: "no HLE — required for Hayazashi Nidan Morita Shougi 2"
    source_ref: "sfc/cartridge/load.cpp:379-384"
  - name: st018.data.rom
    system: nintendo-snes
    required: false
    note: "no HLE — required for Hayazashi Nidan Morita Shougi 2"
    source_ref: "sfc/cartridge/load.cpp:387-393"

  # SGB cartridge ROMs (boot ROMs embedded in icd/boot-roms.cpp)
  # sgb_bios core option selects SGB1.sfc or SGB2.sfc (default: SGB1.sfc)
  - name: SGB1.sfc
    system: nintendo-sgb
    required: false
    md5: b15ddb15721c657d82c5bab6db982ee9
    note: "SGB1 cartridge ROM. Boot ROM embedded in icd/boot-roms.cpp:1"
    source_ref: "target-libretro/libretro.cpp:1022,1040"
  - name: SGB2.sfc
    system: nintendo-sgb
    required: false
    md5: 8ecd73eb4edf7ed7e81aef1be80031d5
    note: "SGB2 cartridge ROM. Boot ROM embedded in icd/boot-roms.cpp:12"
    source_ref: "target-libretro/libretro.cpp:1022,1040"

  # Satellaview BIOS
  - name: BS-X.bin
    system: nintendo-satellaview
    required: false
    note: "required when loading .bs files, core returns false if missing"
    source_ref: "target-libretro/libretro.cpp:1054-1060"