Super Mario Essay, Research Paper
ZSNES
by zsKnight, _Demo_, and Pharos
http://www.zsnes.com
ZSNES is a Super Nintendo Entertainment System emulator written mostly
in assembler.
We would really like to thank the snes9x team for all their help and
also for an excellent snes emulator. We also wish them the very best
of luck!
—————————————————————————
Table of Contents
—————————————————————————
1.) What’s New
2.) Disclaimer
3.) System Requirements
4.) Things you should know about ZSNES (Updated v1.00)
5.) Current Progress
6.) Future Progress
7.) ZSNES Default Keys
8.) Extra Pop-Up Menu (F1 Menu)
9.) Configuration File (ZSNES.CFG)
10.) Cheat Codes
11.) Extra Features (SNES Mouse/Super Scope/SuperFX/DSP1/MultiTap/IPS)
12.) Bugs Section
13.) Contact Information
14.) The Debugger
15.) Error Codes
16.) Credits
—————————————————————————
1.) What’s New
—————————————————————————
See WHATSNEW.TXT
—————————————————————————
2.) Disclaimer
—————————————————————————
zsKnight, _Demo_, and Pharos are not responsible for any damages caused
by the use of this software. This software also must not be distributed
with ROMs.
—————————————————————————
3.) System Requirements
—————————————————————————
Absolute Minimum System that ZSNES can run on (but strongly not recommended) :
- 386 processor (486 processor required for new graphics engine)
- 14.5MB of RAM (You need at least 12.5MB free)
- VGA card
Somewhat Recommended System :
- 486/100 processor
- Min 14.5MB of RAM (min 12.5MB free, only can run 2MB rom images)
- VGA card
- Sound Blaster or 100% compatible
Strongly Recommended System :
- Pentium processor (P100 or higher)
- 32MB of RAM (min 17.0MB free)
- SVGA card
- Sound Blaster 16 or 100% compatible
Recommended System for 65536 (16-bit) color mode :
- Fast Pentium processor (P166 or higher)
- 32MB of RAM (min 17.0MB free)
- SVGA card which supports 320×240x65536 or 640×480x65536 colors
- Sound Blaster 16 or 100% compatible
Recommended System for SFX support :
- Fast Pentium processor (P200 – P2-300 (depending on the game))
- 32MB of RAM (min 17.0MB free)
- VGA card
- Sound Blaster 16 or 100% compatible
Recommended System for SA-1 support : (Mario RPG)
- Fast Pentium processor (P200 or higher)
- 32MB of RAM (min 17.0MB free)
- VGA card
- Sound Blaster 16 or 100% compatible
- You need 17.0MB of RAM to run 48mbit(6megabytes) roms.
- An FPU is required for DSP1 emulation
For SuperFX and SA-1 emulation, 17.0 megabytes of free memory is required
to run.
—————————————————————————
4.) Things you should know about ZSNES
—————————————————————————
- You can use both keyboard and joystick for player 1 or 2 with some
configuration adjustments. Refer to zsnes.faq for details
- If your sidewinder support doesn’t work, a quick way of getting it to
work is to fully disable the windows driver from the control panel
- For modem mode, if you don’t have a 16550A UART compatible modem
(It will tell you when the modem initializes), chances are that both
sides will go out of sync.
- IPX support seems to randomly lose packets in certain network
configurations which causes both sides to go out of sync
- Several special chip emulation (SA-1) have unknown bugs to
them
- Transparency effects are only available in 65536 color mode
- Using 320×240 resolution modes are faster than 640×480 modes. Use
640×480 modes only if you can’t run 320×240 modes or if you want the
added features of 640×480 modes
- To view 512 resolutions properly, use 640×480 mode. Only a few games
uses 512 resolution. One way to find out is to see if a game has
that feature is to look for text that looks squished.
- In 640×480 resolution, the image is scaled so it will look like 320×240
resolution. Only use 640×480 resolution if you want to use scanlines,
interpolation, or if 320×240 doesn’t work.
- SuperFX can be slow because it is an extra 10/20mhz cpu that has to be
emulated as well as the snes emulation
- Screen Snapshot and FPS counter are available through a menu by pressing
F1 during emulation
- Screen Snapshot currently saves as Image.PCX (256 colors) and Image.BMP
(65536 colors). This may change in the future.
- FPS counter currently only works when auto frame rate is on.
- To use the cheat function, be sure to have the ROM which you want to
patch loaded already.
- If the cheat codes do not work, chances are that you are using a different
version of the rom that was originally used to create them or the codes
are converted incorrectly from other code formats.
- Certain video cards/monitors cannot support ModeQ (default resolution)
If your video card/monitor doesn’t support it, run ZSNES with -v 0.
If -v 0 doesn’t work, use -v 2 (vesa 2 required)
- 16 bit mode in ZSNES requires a Scitech Display Doctor (v5.3+) to provide
high color, low resolution modes. You can obtain this software at
www.scitechsoft.com. If your video card already supports lo-res,
hi-color, then don’t worry about getting this driver.
- There are still many bugs left in ZSNES so don’t expect it to run all
your favorite games.
- VSync won’t run well unless you specify a frame skip (eg. -f 0) But
this feature is highly recommended to be used on very fast machines
(eg. Pentium IIs)
- SNES Mouse support is still missing some features such as speed settings
- Pressing the Fast Forward key is equivalent to running ZSNES using -f 9
- If ZSNES doesn’t work for you, then don’t use it. Use SNES9X, NLKE,
SNEESE, or SNEMUL instead! In fact, even if you use ZSNES,
use those emulators too!
—————————————————————————
5.) Current Progress
—————————————————————————
The following are implemented :
- complete 65816 instruction set
- SRAM support
- LoROM and HiROM support
- SlowROM and FastROM support
- Full DMA support
- HIRQ/VIRQ/NMI Interrupts
- Support for most snes file formats
- Multi file format support (.1,.2,.3,A.,B.,C.)
- Interleaved format support
- PAL/NTSC timing support
The following are implemented in the new graphics engine 8 bit :
- Combination of line by line and tile based graphics engine
- Graphic Modes 0,1,2,3,4,5,6,7
- 8×8, 16×16, 32×32 and 64×64 sprite support (flipped in all directions)
- 8×8 and 16×16 tiles
- 32×32,64×32,32×64,64×64 tile modes
- Full HDMA effects for wavy backgrounds, interesting mode 7 effects, etc.
- Mode 7 rotating and scaling effects
- BG priorities
- Sprite Priorities
- Add/sub of back area
- Mosaic Effects
- Offset per tile mode (mode 2/vertical only)
- High res 512 resolution and 448/478 vertical resolution
- Windowing effects
- High res Mode 7 (only in 640×480x256 video mode/disable Eagle/Scanlines)
The following are implemented in the old graphics engine :
- Line by line based graphics engine
- Graphic Modes 0,1,2,3,4,5,6,7
- 8×8, 16×16, 32×32 and 64×64 sprite support (flipped in all directions)
- Mosaic effects
- 8×8 and 16×16 tiles
- 32×32,64×32,32×64,64×64 tile modes
- Full HDMA effects for wavy backgrounds, interesting mode 7 effects, etc.
- Mode 7 rotating and scaling effects
- Single and Dual Windowing Routines
- BG priorities
- Sprite Priorities
- Add/sub of back area
- 16-bit graphics support
- offset per tile mode (mode 2/vertical only)
- High res 512 horizontal resolution (missing in 16×16)
Following are present in 16-bit graphics mode :
- Palette changing in the middle of a screen
- Screen Addition (full and half)
- Screen Subtraction (full)
- Fixed Color Addition/Subtraction
- Window clipping for Fixed Color
The following are implemented in the new graphics engine 16 bit :
- All of old graphics engine 16bit
- Combination of line by line and tile based graphics engine
- High resolution mode 7
- High resolution 16×16 tiles for mode 5
- full 15bit color transparencies (instead of the previous 13bit speed
hack) for improved picture quality (MMX compatible CPUs only)
The following are present in sound :
- 16bit digital stereo sound
- SPC700 Sound CPU
- DSP Sound Processor
– Echo Effects
– FIR Filter
– ADSR volume effects
– GAIN volume effects
– Noise effects
– Pitch Modulation
The following are extra features emulated :
- Super NES Mouse Support
- Super NES Super Scope Support
- SuperFX support (Still has a bug or 2 left)
- MultiTap (Multiplayer 5) support (4 players on a single computer, 5 players
remote (ipx/modem))
- DSP1 emulation (not complete)
- SA-1 emulation (not complete)
The following are the features present in ZSNES :
- Game State Save (F2=Save, F3=Select, F4=Load).
Warning : A state file takes 260 kbytes of HD space!
- Auto frame rate to give you constant Super Nintendo speed up to 9
frame skips
- configuration file support (ZSNES.CFG)
- 2 player support w/ Joystick and Gamepad support
The following features are missing :
- Pseudo 512 snes horizontal resolution
(Haven’t seen any game that uses them yet)
- Some modes in Offset Per Tile Mode
- Some Direct Color Modes (Haven’t seen any game that uses them yet)
What will not run (or not play properly) :
- Some Super FX games such as Dirt Trax FX or Winter Gold (causes instability)
- DSP1 games such as Pilotwings
- Games with other special chips such Street Fighter Alpha 2, Star
Ocean (S-DD1), and Far East of Eden 2 (SPC7110)
- Games which doesn’t have a valid header
- Games that hit a severe bug in the 65816/PPU/SPC700/DSP routines
- Games that require special timing
—————————————————————————
6.) Future Progress
—————————————————————————
This section is removed
—————————————————————————
7.) ZSNES Default Keys
—————————————————————————
Here are the default keys while running the emulator. They can be changed
through the GUI except for F1 and ESC :
Disable Backgrounds 1,2,3,4 = 1,2,3,4
Disable Sprites = 5
Panic Key (enable all) = 6
Enable SNES Mouse/SuperScope = 7
Enable New Graphics Engine = 8
Disable Windowing = 9
Disable OffsetMode = 0
Fast Forward Key = ~
PopUp Extra Menu = F1
Save State = F2
Switch State = F3
Load State = F4
Disable Sound Channel = F5 – F12
Quit = ESC
Here are the default keys for the game play (unless modified through the GUI):
Player 1 :
Up,Down,Left,Right : Cursor Keys on Numerical Pad (You can also use
the non-numerical pad, but numerical pad is
strongly recommended)
A,B,X,Y : Home, End, Insert, Delete
L,R : Page Up, Page Down
Start, Select : Enter, RShift
Player 2 : (You need to enable Player 2)
Up,Down,Left,Right : K, M, N, *
A,B,X,Y : D, X, S, Z
L,R : F, C
Start, Select : Ctrl, Alt
To run the emulator, just type ZSNES *romname.smc/.sfc/.fig/.1*
To run it with sound, type ZSNES -s *romname.smc/.sfc/.fig/.1*
To run it in 16-bit mode (VESA2 w/ video card that supports 320×240x65536
required), type ZSNES -v 3 *romname.smc/.sfc/.fig/.1*
or with sound, type ZSNES -v 3 -s *romname.smc/.sfc/.fig/.1*
—————————————————————————
8.) Extra Pop-Up Menu (F1 Menu)
—————————————————————————
Save Snapshot – Saves a snapshot as either .PCX (8-bit color) or .BMP
(16-bit color)
Show/Hide FPS – Shows or hides the frame per second display which appears
on the bottom-left corner of the screen. This can only
be enabled in auto-frame rate mode.
Save SPC Data – Selecting this will search for the beginning of the next
song and save the data into a .spc file which saves it
similarly as a .srm file. To capture a song, it is best
recommended to initiate this feature approx 2 seconds
before the next song starts. This does have potential to
fail though so don’t expect it to work all the time.
Also, this feature doesn’t work in the new gfx engine.
Sound Buffer Dump – This dumps the sound buffer in zsnes and also filters
out any unoccupied space. The sound buffer contains
decompressed samples which are written to when zsnes
plays/decodes a sample from sound memory. Because of the
way zsnes buffers the sound data, this can produce
inaccurate results.
Snapshot/Increment Frame – Same as snapshot, but it returns to the F1 menu
after a couple frames. Useful for making animations.
—————————————————————————
9.) Configuration File (ZSNES.CFG)
—————————————————————————
Almost everything in zsnes.cfg should now be editable through the gui
—————————————————————————
10.) Cheat Codes
—————————————————————————
Currently, ZSNES supports Game Genie, Pro Action Replay and GoldFinger codes
Here are the steps to get the codes working :
1.) Load the ROM which you want to patch
2.) Exit to the GUI, enter the code of your choice in the cheat menu
3.) After that, you may have to RESET the game to get the cheat code to
work. Sometimes, it is not necessary. You also may have to click
on the FIX button.
NOTE : Some cheat codes are meant to be for different versions of the game.
If a cheat code doesn’t work and there is one for both Game Genie
and Pro Action Replay, try them both.
—————————————————————————
11.) Extra Features (SNES Mouse/Super Scope/SuperFX/DSP1/MultiTap)
—————————————————————————
To Enable SNES Mouse, Press 7 once for 1st player and twice for 2nd player
To Enable SNES Super Scope, Press 7 three times
To disable either one, either press 6 or press 7 until you see a disable
message onscreen.
Here are the controls for the Super Scope :
Fire = Left Mouse button
Cursor Mode Button = Right Mouse button
Pause = Backspace Key on keyboard
Enable/Disable Autofire = =/+ key on keyboard, should be located to the
left of the backspace key
DSP1 is enabled automatically. Currently, it runs mario kart and some other
games, but it does not run pilotwings due to a lack of dsp1 functions
that are implemented.
Zsnes auto-detects the SFX emulation from the header and enables it when
found. Also, take note that the SFX is an additional 10Mhz(Ver1) or
20Mhz(Ver2) chip which also has to be emulated with the snes and will
most likely produce a very noticeable slow down in emulation if you
don’t have a fast computer.
Sometimes, the Multitap isn’t compatible with some games. If that happens,
disable Multitap by setting Player3,4, and 5’s input device to ‘None’ in
the GUI
IPS patcher :
Rename your .IPS file to the rom filename with the .IPS extension
(eg. If your rom is SD3.SMC and your rom is SD3V05.IPS, rename SD3V05.IPS
to SD3.IPS)
and ZSNES will patch the rom realtime without modifying the rom file’s
contents.
—————————————————————————
12.) Bugs Section
—————————————————————————