--------------------------------------------
Wii2600 v0.1 release README
--------------------------------------------

Ported by raz0red
[http://www.twitchasylum.com]

--------------------------------------------
What is Wii2600?
--------------------------------------------

Wii2600 is a port of the Stella 2.7.2 emulator to the Wii.

Stella is a multi-platform Atari 2600 VCS emulator released under the GNU 
General Public License (GPL). Stella was originally developed for Linux by 
Bradford W. Mott, however, since its original release several people have 
joined the development team to port Stella to other operating systems such 
as AcornOS, AmigaOS, DOS, FreeBSD, IRIX, Linux, OS/2, MacOS, Unix, and 
Windows. [http://stella.sourceforge.net].

--------------------------------------------
Current status
--------------------------------------------

Wii2600 is an ongoing work in progress. For the latest project information
please visit the following URL:

[http://www.wiibrew.org/wiki/Wii2600]

--------------------------------------------
Known issues
--------------------------------------------

Wiimote paddle support is a proof of concept at this point and as such is a bit
buggy. The range of motion is currently very small. You must have the Wiimote 
aligned directly with the sensor bar.

--------------------------------------------
Installation
--------------------------------------------

To install Wii2600, simply extract the zip file that this README was 
distributed with directly to your SD card (retain the hierarchical structure
exactly).

Cartridge images should be placed in the roms directory (wii2600/roms).

--------------------------------------------
Tearing, Vertical Sync, PAL/NTSC, etc.
--------------------------------------------

Without the use of Vertical Sync, 2600 games that scroll (Barnstorming, River
Raid, etc.) will exhibit tearing during game play.

The first time Wii2600 is started it attempts to determine whether your Wii is
running in PAL (50hz) or NTSC/PAL60 (60hz) mode. Based on this determination it
sets a default value for Vertical Sync. 

NTSC/PAL60:

If Wii2600 determines you are in NTSC/PAL60 mode (60hz) it enables Vertical
Sync by default. This should work well for both NTSC and PAL games. PAL games
run fine due to the fact that they run at a slower rate than NTSC.

PAL:

If Wii2600 determines you are currently in PAL mode (50hz) it disables Vertical
Sync by default. The reason it disables this setting is to be compatible with
both PAL and NTSC games at 100% speed. Since the Wii console is syncing at 50hz 
it won't be able to maintain the required 60hz for NTSC games and as a result 
you will get garbled sound and slow video.

If you still want to use Vertical Sync, you can enable it via the "Advanced" 
menu in Wii2600. PAL games will run as they were intended, 50hz at 100% speed.
Wii2600 also configures another setting "Force FPS" to "50 FPS" when you enable
Vertical Sync in PAL mode. What this setting does is control the frame rate
that games run at. Essentially what it will do is force all games (NTSC or
PAL) to run at 50 FPS. In doing so it also adjusts audio buffer sizes, etc. so
that you won't experience garbled sound. The downside is that NTSC games will
now run at 50 FPS versus their intended 60 FPS, so the games will run a bit 
slower.

The real answer to resolve these issues is to add auto-frame skipping to 
Stella. That is definitely something I will be looking to add in an upcoming
release. 

--------------------------------------------
Controls
--------------------------------------------

    Wii2600 menu:
    -------------

        Wiimote:

            D-pad  : Scroll
            A      : Select 
            B      : Back
            Home   : Exit to Homebrew Channel
            Power  : Power off

         Classic controller:

            D-pad  : Scroll
            A      : Select 
            B      : Back
            Home   : Exit to HBC
                  
         GameCube controller:

            D-pad  : Scroll
            A      : Select 
            B      : Back
            Z      : Exit to Homebrew Channel
            
    Stella emulator menu:
    ---------------------
    
    Unfortunately, at this point all navigation of the Stella menu is done via
    the Wiimote without the use of motion controls. Thus, the '+' and '-' 
    buttons allow for tabbing through the different controls. Pressing the 'A'
    button operates the current control, etc.
    
        Wiimote:

            +           : Move forward through controls
            -           : Move backward through controls
            Up/Down     : Scroll (when focused on a list or slider, etc.)
            Left/Right  : Page through list (when focused on list control)
            Left/Right  : Move between tabs (when focused on a tab in a dialog)
            A           : Operates current control (presses button, launch rom)
            B           : Closes current dialog
            Home        : Exit to Homebrew Channel

         Classic controller:

            +           : Move forward through controls
            -           : Move backward through controls
            R Trigger   : (Alternate) Move forward through controls
            L Trigger   : (Alternate) Move backward through controls
            Up/Down     : Scroll (when focused on a list or slider, etc.)
            Left/Right  : Page through list (when focused on list control)
            Left/Right  : Move between tabs (when focused on a tab in a dialog)
            A           : Operates current control (presses button, launch rom)
            B           : Closes current dialog
            Home        : Exit to Homebrew Channel
                  
         GameCube controller:

            R Trigger   : Move forward through controls
            L Trigger   : Move backward through controls
            Up/Down     : Scroll (when focused on a list or slider, etc.)
            Left/Right  : Page through list (when focused on list control)
            Left/Right  : Move between tabs (when focused on a tab in a dialog)
            A           : Operates current control (presses button, launch rom)
            B           : Closes current dialog
            Z           : Exit to Homebrew Channel
            
         USB keyboard:
         
            Refer to Stella emulator documentation.             
            
    In-game (Joystick):
    -------------------

        Wiimote:

            D-pad  : Move
            2      : Fire
            1      : Open/close command menu (save/load state, etc.)
            +      : [Reset]
            -      : [Select]
            Home   : Display Stella menu (see above)

         Classic controller:

            D-pad  : Move
            A      : Fire
            Y      : Open/close command menu (save/load state, etc.)
            +      : [Reset]
            -      : [Select]
            Home   : Display Stella menu (see above)
                  
         GameCube controller:

            D-pad      : Move
            A          : Fire
            Y          : Open/close command menu (save/load state, etc.)
            Start      : [Reset]
            L Trigger  : [Select]
            Z          : Display Stella menu (see above)
           
         USB keyboard:
         
            Refer to Stella emulator documentation.             
                
    In-game (Paddle):
    -----------------
    
    The paddle control support is a proof of concept at this point and as such
    is a bit difficult to use. However, it is playable for quite a number of 
    games (Kaboom!, Night Driver, Breakout, etc.). The range of motion is 
    currently very small. You must have the Wiimote aligned directly with the
    sensor bar.
    
        Wiimote:

            Motion  : Move
            A       : Fire
            B       : (Alternate) Fire
            1       : Open/close command menu (save/load state, etc.)
            +       : [Reset]
            -       : [Select]
            Home    : Display Stella menu (see above)    

--------------------------------------------
Wii2600 crashes, code dumps, etc.
--------------------------------------------

If you are having issues with Wii2600, please let me know about it via one of 
the following locations:

[http://www.wiibrew.org/wiki/Talk:Wii2600]
[http://www.twitchasylum.com/forum/viewtopic.php?=513]

--------------------------------------------
Special thanks
--------------------------------------------

RB22             : PAL testing
zodiacprime      : Testing
Sputicus         : Helping bug fix
Tantric/eke-eke  : Audio code example
yohanes          : SDL USB keyboard support
Team Twiizers    : For enabling homebrew

--------------------------------------------
Change log
--------------------------------------------

02/19/09 (0.1)
--------------
    - Initial release
    - Wiimote/Classic/GameCube controller support
    - Mouse via Wiimote for paddle games (proof of concept)
    - USB Keyboard
    - Audio/Video etc.    
    - Save/load state
    - Screenshot support
    