PiSNES for Raspberry Pi by Squid ================================ INTRODUCTION ------------ This is a SNES Emulator port based on SNES9X 1.39. This is an old version of SNES9X but was chosen as it runs mostly at full speed on the Raspberry Pi unlike the more recent versions of SNES9X. Game support is therefore not as good as the newer SNES9X versions and graphics & sound is not as accurate. Games that will not work, for example, are Yoshi's Island, Street Fighter Alpha 2, Star Fox. This port supports keyboard and USB joystick input and are configurable. It uses GLES2/dispmanx for graphics so can run equally well in the Console or under X-Windows. The audio uses the ALSA API and SDL is used for input. Web page for downloads, news, source, additional information: https://github.com/squidrpi/pisnes (No asking for ROMS) CONTROLS -------- KEYBOARD XBOX360 CONTROLS Up direction up arrow Down direction down arrow Left direction left arrow Right direction right arrow X button s Y Y button x X A button d B B button c A TL button a TL TR button f TR Start button return START Select button tab BACK Turbo backspace Quit escape BACK+START Quickload 1-4 F1-F4 RIGHT THUMB Quicksave 1-4 Shift F1-F4 LEFT THUMB The joystick layout defaults to XBOX 360 controller button layout. Additionally to quit with the joystick you can press SELECT+START. All controls are configurable by editing the "snes9x.cfg" file. Quickload and Quicksave, load and save snapshots of the game. Game saves are automatically loaded and saved when PiSNES starts and quits. INSTALLATION ------------ snes9x -> Game binary snes9x.gui -> Frontend binary snes9x.cfg -> MAME configuration file, limited support to only the options in the supplied file (not the full MAME settings). preview/ -> Box art in jpg format, must be 640x480 or smaller, matching name of ROM file. roms/ -> ROMs directory (Put your game ROMs in here) skins/ -> Frontend skins directory $HOME/.snes96_snapshots/ -> SRM and snapshot saves are stored here To run PiSNES simple run the "snes9x.gui" executable. At the command line "./snes9x.gui". This runs the GUI frontend. To simply run PiSNES without the GUI enter "./snes9x roms/{gamerom}" where "{gamerom}" is the game rom filename to run. It will work in X-Windows or in the Console. Pi CONFIGURATION ---------------- I highly recommend overclocking your Raspberry Pi to gain maximum performance as PiSNES is very CPU intensive and overclocking will make most games run at full speed. The Pi 2 does not need overclocking. My overclocking settings which work well, (/boot/config.txt) arm_freq=900 sdram_freq=500 NOTE: Make sure overclocking is actually working by checking "cat /sys/devices/system/cpu/cpu0/cpufreq/scaling_governor" should be "ondemand". Later kernels appear to set it to "powersave" by default. If your sound is too quiet then do the following to fix that: * First get the playback device, type "amixer controls" * This will show the numid for the playback device, probably 3. * Now set the volume, type "amixer cset numid=3 90%". * Then reboot to make it permanent. If you're having problems with HDMI audio then it is likely PulseAudio is causing the issues as it has problems with the ALSA drivers. To fix this simply remove PulseAudio: * sudo apt-get --purge remove pulseaudio * sudo apt-get autoremove If you're getting a black screen when running in Console mode with Composite output, try removing/commenting out the "overscan_" parameters from "/boot/config.txt" as follows (using disable_overscan doesn't appear to fix it): #overscan_left=16 #overscan_right=16 #overscan_top=16 #overscan_bottom=16 GRAPHICS AND SOUND EFFECTS -------------------------- Postprocessing can be enabled by setting "DisplayEffect" in snes9x.cfg. In addition you can disable anti-aliasing smoothing ("DisplaySmoothStretch" in snes9x.cfg). The postprocessing "phospher" effect does not run at full speed - i.e. it taxes the Pi GPU a little too much. To improve the sound on the RPi 2 you can set "InterpolatedSound=1". This setting on the RPi 1 slows it down too much. ORIGINAL CREDITS ---------------- * The SNES9X team for their wonderful emulator (http://www.snes9x.com/) PORT CREDITS ------------ * Ported to Raspberry Pi by Squid. * Based on the Dingoo SDL version of SNES9X v1.39 CHANGE LOG ---------- September 2015: * Added boxart preview window. * DPAD configurable as buttons (resolves new xpad driver causing HAT issues) February 21, 2015: * Added 2 player support. February 12, 2015: * Joystick controls default to XBOX 360 controller. * More joystick axis support. * Initial HAT/DPAD support (seems to have issues on the XBOX 360 controller). August 15, 2013: * Joystick axis are now configurable. May 25, 2013: * Graphics backend rewritten to use GLES2 instead of Dispmanx, to enable GPU postprocessing. * Graphics smoothing (anti-aliasing) can be disabled. * Added postprocessing graphics effects, i.e. scanlines, phospher. * Vsync support is better meaning less stuttering. May 11, 2013: * Added joystick button presses SELECT+TL quickload, SELECT+TR quicksave. * Fixed potential corruption to quicksaves using joystick. May 08, 2013: * Added more configuration to the snes9x.cfg for graphics and sound. * Added options for aspect ratio, stretching and video border. * Pass command line options from frontend to runtime snes9x. * Fix config file not being read when calling snes9x binary outside of CWD. May 02, 2013: * Added two joystick support. * The joystick buttons SELECT+START now quit. * Reduced sensitivity of the analog joystick. April 24, 2013: * Initial release.