Skip to content

nSide (SFC Balanced)
Type libretro
Classification Enhanced forks
Source https://github.com/libretro/nSide
Upstream https://gitlab.com/higan/higan
Version 106.25
Revision libretro/nSide@5b2b5da3a965, higan/higan@3353efd3a108
Profiled 2026-09-17
Profile YAML, JSON
Cores nside_sfc_balanced, higan_sfc_balanced
Systems nintendo-snes, nintendo-sgb
Technical notes

Fork of higan by hex_usr (nSide v009r16, README.txt:1-4), synchronised with higan v106r25: Emulator::Version is "106.25" (nSide/emulator/emulator.hpp:16) and retro_get_system_info announces it as library_version under the name "higan (Super Famicom Balanced)" (nSide/target-libretro/libretro.cpp:87-93, nSide/target-libretro/libretro-sfc.cpp:486). The balanced profile keeps a scanline-based PPU, and the accuracy profile is refused at build time (nSide/target-libretro/GNUmakefile:1-2, nSide/target-libretro/libretro.cpp:38-39). The library is named nside_$(corename)libretro with corename sfc_balanced (nSide/target-libretro/GNUmakefile:4-13, nSide/target-libretro/GNUmakefile:18-23), which the GitLab CI publishes as nside_sfc_balanced (.gitlab-ci.yml:15, .gitlab-ci.yml:53-54). The core options keep the higan_sfc prefix so the settings are shared with higan's core (nSide/target-libretro/libretro-sfc.cpp:321-329).

System files manifest.bml, boards.bml and ipl.rom are compiled into the binary and served from memory (nSide/target-libretro/libretro-sfc.cpp:335-341, nSide/target-libretro/resource/sfc.bml:1-4, nSide/sfc-balanced/smp/smp.cpp:25-33).

Coprocessor firmware. A ROM is imported through icarus, whose manifest names each firmware memory by architecture and identifier (icarus/heuristics/super-famicom.cpp:90-115). When the image does not carry the firmware appended (icarus/heuristics/super-famicom.cpp:406-414), the importer reports {identifier}.{content}.rom as missing (icarus/core/super-famicom.cpp:46-57) and the libretro target reads that name through locate_libretro, appends it to the image and imports again (nSide/target-libretro/icarus.cpp:111-142). locate_libretro tries the system directory, then higan/ and nSide/ under the user's config and data directories (nSide/target-libretro/libretro.cpp:3-31). Identifiers come from the cartridge label: DSP1 for PILOTWINGS, DSP2 for DUNGEON MASTER, DSP3 for SD Gundam GX, DSP4 for TOP GEAR 3000 and PLANETS CHAMP TG3000, DSP1B otherwise. ST011 is used for 2DAN MORITA SHOUGI, ST010 otherwise, and ST018 and Cx4 have a single revision (icarus/heuristics/super-famicom.cpp:512-541). No hash is checked, and a file shorter than the size the manifest declares leaves the second import short and the load fails. The sizes below are those declared by the heuristics.

Super Game Boy. Loading a .gb or .gbc file selects the folder named by the higan_sfc_sgb_bios option, SGB1.sfc/ by default or SGB2.sfc/ (nSide/target-libretro/libretro-sfc.cpp:142-145, nSide/target-libretro/libretro-sfc.cpp:326). program.rom is looked up in that folder, then in SGB.sfc/ and Super GameBoy.sfc/, and the folder's manifest is generated from its program.rom and *.boot.rom files (nSide/target-libretro/libretro-sfc.cpp:179-215, icarus/core/super-famicom.cpp:1-11). The Game Boy system then opens the boot ROM the manifest names, lr35902.boot.rom, from the folder first and from the system directory root as a fallback (nSide/gb/system/system.cpp:54-65, nSide/target-libretro/program.cpp:19-81). Once a Game Boy image is loaded both files are mandatory: a missing one sets the failure flag and retro_load_game returns false (nSide/target-libretro/program.cpp:75-78, nSide/target-libretro/libretro.cpp:286). The SHA-1 values on the boot ROMs and on cx4.data.rom are those of the copies the source tree ships in icarus/firmware/.

21 files | 0 required, 21 optional | 21 in repo, 0 missing

dsp1.data.rom optional in repo #

dsp1.program.rom optional in repo #

dsp1b.data.rom optional in repo #

dsp1b.program.rom optional in repo #

dsp2.data.rom optional in repo #

dsp2.program.rom optional in repo #

dsp3.data.rom optional in repo #

dsp3.program.rom optional in repo #

dsp4.data.rom optional in repo #

dsp4.program.rom optional in repo #

cx4.data.rom optional in repo #

st010.data.rom optional in repo #

st010.program.rom optional in repo #

st011.data.rom optional in repo #

st011.program.rom optional in repo #

st018.data.rom optional in repo #

st018.program.rom optional in repo #

program.rom optional in repo #

  • Path: SGB1.sfc/program.rom
  • System: nintendo-sgb
  • Source: nSide/target-libretro/libretro-sfc.cpp:179-215, nSide/sfc-balanced/cartridge/load.cpp:159-162
  • Collection copy: bios/Nintendo/Super Game Boy/SGB1.sfc/program.rom
  • Platforms: batocera SGB1.sfc, lakka SGB1.sfc, SGB1.sfc/program.rom, sgb1.program.rom, misterfpga SGB/Super Game Boy.sfc, recalbox sgb/SGB1.sfc, retroarch SGB1.sfc, SGB1.sfc/program.rom, sgb1.program.rom, retrobat SGB1.sfc, retrodeck bios/SGB1.sfc, bios/sgb1.program.rom, retropie SGB1.sfc, SGB1.sfc/program.rom, sgb1.program.rom, romm super-gb/SGB1.sfc, super-gb/sgb1.program.rom
  • Also looked up as SGB.sfc/program.rom and Super GameBoy.sfc/program.rom.

lr35902.boot.rom optional in repo #

  • Path: SGB1.sfc/lr35902.boot.rom
  • System: nintendo-sgb
  • Size: 256 B
  • SHA1: aa2f50a77dfb4823da96ba99309085a3c6278515
  • Source: nSide/gb/system/system.cpp:54-65, nSide/emulator/game.hpp:101-104, icarus/heuristics/super-famicom.cpp:103, icarus/heuristics/super-famicom.cpp:523-527
  • Collection copy: bios/Nintendo/Game Boy/GB_sgb.bin
  • Platforms: batocera sgb_bios.bin, sgb_boot.bin, bizhawk GB_sgb.bin, lakka SGB1.sfc/sgb1.boot.rom, sgb.boot.rom, sgb_bios.bin, sgb_boot.bin, recalbox sgb/sgb_bios.bin, retroarch SGB1.sfc/sgb1.boot.rom, sgb.boot.rom, sgb_bios.bin, sgb_boot.bin, retrobat sgb_boot.bin, retrodeck bios/sgb1.boot.rom, bios/sgb_bios.bin, retropie SGB1.sfc/sgb1.boot.rom, sgb.boot.rom, sgb_bios.bin, sgb_boot.bin, romm super-gb/sgb1.boot.rom, super-gb/sgb_bios.bin
  • Falls back to lr35902.boot.rom at the system directory root.

program.rom optional in repo #

lr35902.boot.rom optional in repo #

  • Path: SGB2.sfc/lr35902.boot.rom
  • System: nintendo-sgb
  • Size: 256 B
  • SHA1: 93407ea10d2f30ab96a314d8eca44fe160aea734
  • Source: nSide/gb/system/system.cpp:54-65, nSide/emulator/game.hpp:101-104, icarus/heuristics/super-famicom.cpp:103, icarus/heuristics/super-famicom.cpp:523-527
  • Collection copy: bios/Nintendo/Game Boy/GB_sgb2.bin
  • Platforms: batocera sgb2_boot.bin, bizhawk GB_sgb2.bin, lakka SGB2.sfc/sgb2.boot.rom, sgb2_bios.bin, sgb2_boot.bin, retroarch SGB2.sfc/sgb2.boot.rom, sgb2_bios.bin, sgb2_boot.bin, retrobat sgb2_boot.bin, retrodeck bios/sgb2_boot.bin, retropie SGB2.sfc/sgb2.boot.rom, sgb2_bios.bin, sgb2_boot.bin, romm super-gb/sgb2.boot.rom, super-gb/sgb2_bios.bin
  • Falls back to lr35902.boot.rom at the system directory root.

Generated on 2026-10-20T03:49:41Z