Skip to content

nand2mario/snestang

Repository files navigation

SNESTang - SNES for Sipeed Tang FPGA Boards

SNESTang is an open source project to recreate the Super Nintendo Entertainment System (SNES) with the affordable Sipeed Tang FPGA boards. Currently Tang Primer 25K, Tang Nano 20K and Tang Mega 138K Pro are supported.

  • 720p HDMI output.
  • Cycle accurate gameplay.
  • Supports LoROM, HiROM and ExHiROM.
  • ROM loading from MicroSD with an easy-to-use menu system, powered by a RISC-V softcore.
  • Extension chips: DSP-1/2/3/4, S-RTC, OBC-1.
  • Automatic BSRAM backup and restore.
  • SNES or DS2 controllers.

If you haven't bought your board yet, Tang Primer 25K (or the upcoming TangConsole 60K) is probably the one to get. Tang Nano 20K only runs games smaller than 3.75MB (30Mbits) due to its limited SDRAM size.

Setup Instructions

Detailed step-by-step instructions.

Quick instructions for experienced users:

  • Tang Primer 25K needs 4 modules: Tang sdram, DVI, SNES/Dualshock2 controller, SD and a pair of controllers. Currently these should cost ~$60 in total. Tang Nano 20K just needs controller adapters. Check instructions for how to connect the modules / adapters.
  • Download a SNESTang release, and program the corresponding snestang_*.fs to the board with Gowin programmer.
  • Program the softcore firmware firmware.bin to address 0x500000 of the on-board flash. See this screenshot for how to do it.
  • Put your .sfc or .smc roms on a MicroSD card (exFAT or FAT32 file system).
  • Connect one or two DualShock2 controllers to the DS2 pmod.
  • Insert the MicroSD card, connect an HDMI monitor or TV, and enjoy your games.

More information on game compatibility.

Usage

Basic operations

  • .SFC and .SMC roms should be automatically recognized.
  • SELECT-RIGHT BUTTON to open OSD.

Backup SRAM support

  • Many SNES gamepaks include battery-backed SRAM chips to store game saves, for example Super Mario World. Since 0.5, SNESTang supports fully-automatic backup and restore of BSRAM content, with no interruption to the game play.
  • The function is by default turned off. To use it, first enable it in options. Then launch a game with BSRAM support. Every 10 seconds, SNESTang will check if there's new BSRAM content, and if yes saves it into /saves/<rom_name>.srm. BSRAM is also automatically restored at game launch if the corresponding .srm file exists, and BSRAM function is on.
  • List of games with save batteries.

Core Switching

  • If you create a /cores directory in your SD card and put the relevant .bin files of SNESTang and NESTang there, you will be able to switch between the two cores without connecting the board to your PC. Just choose "Select core" in the main menu and follow the instructions.

Development

I am developing with Gowin IDE 1.9.9 Pro version (not the EDU version). It requires a free license. Just open the project file snestang_primer25k.gprj.

Read the updated design notes to understand the code or to add features.

You can also simulate the code with our verilator harness. src/test_loader.v specifies which rom is used by the simulation. Then make sim will start a SDL-based graphical simulation.

Upcoming feature that I may work on,

  • SNAC native controller adapter support.

Special Thanks

  • SNES_FPGA by Sergiy Dvodnenko (srg320) and gyurco. SNESTang is a port of this core for MiSTer and MIST.
  • hdl-util/hdmi by Sameer Puri.

nand2mario (nand2mario at outlook.com)

Since 2024.1