Currently, there's no official documentation as the bsnes user interface is brand new. However, I'll put the most important information on this page.
In the mean time, you can try reading the official higan documentation. Although the user interface is substantially different, many concepts do carry over to bsnes.
bsnes ships with the following integrated firmware files:
- cx4.data.rom [Mega Man X2, Mega Man X3]
- sgb1.boot.rom [Super Game Boy]
- sgb2.boot.rom [Super Game Boy 2]
But unfortunately, many firmware files are missing due to their contents being covered by copyright law:
- dsp1.program.rom, dsp1.data.rom [Super Mario Kart, Pilotwings, etc]
- dsp1b.program.rom, dsp1b.data.rom [Ballz 3D, etc]
- dsp2.program.rom, dsp2.data.rom [Dungeon Master]
- dsp3.program.rom, dsp3.data.rom [SD Gundam GX]
- dsp4.program.rom, dsp4.data.rom [Top Gear 3000]
- st010.program.rom, st010.data.rom [F1 Race of Champions II]
- st011.program.rom, st011.data.rom [Hayazashi Nidan Morita Shougi]
- st018.program.rom, st018.data.rom [Hayazashi Nidan Morita Shougi 2]
It would be against the law to ship bsnes with these files, and I can't tell you where to find these files.
Please also note that files named dsp1.rom, st010.rom, etc are concatenated (merged) images that do not currently work with any emulator. These are not the correct files to use.
Unlike Snes9X, bsnes only provides low-level emulation of SNES coprocessors. Thus, if you wish to play these games, you must obtain these files yourself and place them into the firmware directory first. Failure to do so will result in error messages when you run the aforementioned games.
Suffice to say, if you see any of these messages, it means you must obtain the above files first. In a future release, it's planned to provide better help messages, and even possibly a high-level emulation fallback.
Until then, sorry for the inconvenience. I realize this is all very inconvenient, and I will be working toward alleviating this in future releases.
I am a huge proponent in that this firmware is part of the original games, and should thus be grouped together with the games themselves, but unfortunately this viewpoint has not caught on in practice.
Technically, all of these firmware programs fall under three coprocessor architectures, and when you load a game without the firmware present, bsnes does not yet know exactly which program to use for a given title. It tries to guess, but presents you with the generic architecture names: upd7725, upd96050, and arm6.
This guessing also means that the included SNES games database cannot be used,
because the game checksums will not match the database entries. In practice,
this won't affect emulation accuracy. But if you really need the database lookup
functionality, you'll need to append the SNES firmware to the end of your SNES
ROM images. Doing so is beyond the scope of these notes, but basically you would
cat command on the terminal.