diff --git a/stella/Announce.txt b/stella/Announce.txt index e49b022dc..7c1e3425b 100644 --- a/stella/Announce.txt +++ b/stella/Announce.txt @@ -9,7 +9,7 @@ SSSS ttt eeeee llll llll aaaaa =============================================================================== - Release 2.5.1 for Linux, Mac OSX and Windows + Release 2.6 for Linux, Mac OSX and Windows =============================================================================== The Atari 2600 Video Computer System (VCS), introduced in 1977, was the most @@ -21,23 +21,23 @@ of your favorite Atari 2600 games again! Stella was originally developed for Linux by Bradford W. Mott, however, it has been ported to a number of other platforms. -This is the 2.5.1 release of Stella for Linux, Mac OSX, Windows and GP2X. +This is the 2.6 release of Stella for Linux, Mac OSX, Windows and GP2X. Distributions for other operating systems will appear as they become available. The distributions currently available are: - * Binary distribution in 32-bit RPM format for Linux (stella-2.5.1-1.i586.rpm) + * Binary distribution in 32-bit RPM format for Linux (stella-2.6-1.i586.rpm) - * Binary distribution in 32-bit Ubuntu DEB format (stella_2.5.1-1_i386.deb) + * Binary distribution in 32-bit Ubuntu DEB format (stella_2.6-1_i386.deb) - * Binary distribution in 64-bit Ubuntu DEB format (stella_2.5.1-1_amd64.deb) + * Binary distribution in 64-bit Ubuntu DEB format (stella_2.6-1_amd64.deb) - * Binary distribution for Mac OSX (StellaOSX2.5.1.dmg.gz) + * Binary distribution for Mac OSX (StellaOSX2.6.dmg.gz) - * Binary installer (exe) for Windows (stella-2.5.1-win32.exe) + * Binary installer (exe) for Windows (stella-2.6-win32.exe) - * Binary zip for Windows (stella-2.5.1-win32.zip) + * Binary zip for Windows (stella-2.6-win32.zip) - * Source code distribution for all platforms (stella-2.5.1-src.tar.gz) + * Source code distribution for all platforms (stella-2.6-src.tar.gz) PLEASE DO NOT WRITE ASKING FOR ROM IMAGES TO USE WITH STELLA! ALL SUCH REQUESTS WILL BE IGNORED! diff --git a/stella/Changes.txt b/stella/Changes.txt index a92d7e7d5..af3039812 100644 --- a/stella/Changes.txt +++ b/stella/Changes.txt @@ -12,6 +12,52 @@ Release History =============================================================================== +2.5.1 to 2.6: (May 16, 2008) + + * Added AtariVox support using a real AtariVox device, where Stella + sends data directly to the AtariVox. For now, this is supported in + Linux/UNIX, OSX, and Win32 only. You'll obviously need a real + AtariVox, and a serial<->USB adaptor to connect it to your system. + Added '-avoxport' commandline argument used to set the serial port + to which the AtariVox is connected. Special thanks to Al Yarusso + and Richard H. for providing sample hardware. + + * Added AtariVox and SaveKey EEPROM emulation. This reads/writes data + to a 32KB file, not to the actual hardware. Very useful for testing + EEPROM support without actually wearing out the real device. Special + thanks to J. Payson for providing the EEPROM emulation code, and A. + Herbert for answering many driver-related questions. + + * Added support for CX-22, CX-80, and AmigaMouse trackball controllers. + + * Improved debugger symfile handling so that addresses accessed as + read-only won't use write-only labels (and vice-versa). More work + is still needed in this area. + + * Added M6532/RIOT tab to the debugger. This will be expanded on in a + future release. + + * Added TIA emulation fixes for graphical glitches in Escape from the + Mindmaster, Mission Survive, Solaris, and SWOOPS! + + * Fixed bug where fullscreen OpenGL scaling wasn't working on 4:3 monitors. + + * Further improvements to the M6532/RIOT emulation, which unfortunately + have broken old state files (again). + + * Added deadzone setting, for adjusting the deadzone amount for + analog joysticks. This can be set using the commandline argument + '-joydeadzone' or dynamically within the UI. + + * Make ROM disassembly in debugger take advantage of a wide window. + + * Fixed bug in 6507 BCD handling introduced in the last release. + + * For the Win32 port; Win9x should be fully supported again. + +-Have fun! + + 2.5 to 2.5.1: (April 9, 2008) * Fixed M6532 RIOT timer emulation. More testing is needed, but the @@ -40,8 +86,6 @@ * For Stella developers, fixed SpeakJet emulation so it compiles again. No improvements have been made to the emulation itself, though. --Have fun! - 2.4.2 to 2.5: (March 28, 2008) diff --git a/stella/Readme.txt b/stella/Readme.txt index 88d76988e..b4add017b 100644 --- a/stella/Readme.txt +++ b/stella/Readme.txt @@ -1,4 +1,4 @@ -This is release 2.5.1 of Stella. Stella is a multi-platform Atari 2600 VCS +This is release 2.6 of Stella. Stella is a multi-platform Atari 2600 VCS emulator which allows you to play all of your favorite Atari 2600 games on your PC. You'll find the Stella Users Manual in the docs subdirectory. If you'd like to verify that you have the latest release of Stella visit @@ -9,4 +9,4 @@ the Stella Website at: Enjoy, The Stella Team -April 9, 2008 +May 16, 2008 diff --git a/stella/debian/changelog b/stella/debian/changelog index 6172cbb3b..6c0864600 100644 --- a/stella/debian/changelog +++ b/stella/debian/changelog @@ -1,3 +1,10 @@ +stella (2.6-1) stable; urgency=low + + * Version 2.6 release + + -- Stephen Anthony Fri, 16 May 2008 18:38:25 +0200 + + stella (2.5.1-1) stable; urgency=low * Version 2.5.1 release diff --git a/stella/docs/graphics/eventmapping_virtualdevs.png b/stella/docs/graphics/eventmapping_virtualdevs.png index c6aea292e..33a4d41bd 100644 Binary files a/stella/docs/graphics/eventmapping_virtualdevs.png and b/stella/docs/graphics/eventmapping_virtualdevs.png differ diff --git a/stella/docs/index.html b/stella/docs/index.html index 241631e0a..84458ed8a 100644 --- a/stella/docs/index.html +++ b/stella/docs/index.html @@ -10,7 +10,7 @@

A multi-platform Atari 2600 VCS emulator

-

Release 2.5.1

+

Release 2.6



User's Guide

@@ -24,10 +24,11 @@
  • Starting A Game
  • Changing Options
  • Keyboard Layout
    • -
  • Event Remapping
    • +
  • Event Remapping / Input Devices
  • Viewing ROM Info
  • ROM Audit Mode
  • Stelladaptor Support
    • +
  • AtariVox/SaveKey Support
  • Integrated Debugger
  • Settings File
  • Cheatcode Manager
    • @@ -39,7 +40,7 @@


    -
    February 1999 - April 2008
    +
    February 1999 - May 2008
    The Stella Team
    Stella Homepage
    @@ -220,34 +221,49 @@ Sega Dreamcast, Unix, and Windows.

    -

    New in Release 2.5.1

    +

    New in Release 2.6

    @@ -260,14 +276,20 @@

  • Emulates the Atari 2600 Joystick Controllers using your computer's keyboard or joysticks
  • Emulates the Atari 2600 Keyboard Controllers using your computer's keyboard
    • -
  • Emulates one Atari 2600 Paddle Controller using your computer's mouse, keyboard +
  • Emulates the Atari 2600 Paddle Controllers using your computer's mouse, keyboard or joysticks
  • Emulates the Atari 2600 Driving Controllers using your computer's keyboard or joysticks
  • Emulates the CBS Booster-Grip Controller using your computer's keyboard or joysticks
    • +
  • Emulates CX-22 / CX-80 style trackballs and Amiga Mouse using your + computer's mouse
  • Support for real Atari 2600 controllers using the Stelladaptor
    • +
  • Support for the speech portion of a real + + AtariVox device using a USB adaptor
    • +
  • Supports EEPROM emulation for AtariVox and SaveKey controllers
  • Supports almost all known bankswitching schemes (let us know if there's one we missed)
  • Supports cartridge autodetection for almost all bankswitching schemes
  • Supports Supercharger single-load and multi-load games
    • @@ -277,6 +299,7 @@
  • Supports several "undocumented features" of the TIA graphics chip used by some games
  • TIA emulation supports full collision checking
    • +
  • Built-in extensive debugger
    • @@ -689,6 +712,14 @@ Shows some game info while Stella is running. + + 
    -joydeadzone <number>
    + Sets the joystick deadzone area for analog joysticks. + Accepts a number from 0 - 29, and uses the formula + 3200 + number * 1000. So the possible deadzone values + range from 3200 to 32200. + + 
    -pspeed <number>
    Speed of digital emulation for paddles (1-15). @@ -778,6 +809,16 @@ Set the full pathname of the ROM properties file. + + 
    -tiafloat <1|0>
    + Set unused TIA pins to be floating on a read/peek. + + + + 
    -avoxport <name>
    + Set the name of the serial port where an AtariVox is connected. + + 
    -help
    Prints a help message describing these options, and then @@ -825,11 +866,6 @@ Start the emulator with the left joystick button held down. - - 
    -tiafloat <1|0>
    - Set unused TIA pins to be floating on a read/peek. - - 
    -bs <type>
    Set "Cartridge.Type" property. See the Game Properties section @@ -972,7 +1008,7 @@

    Game Information dialog:

    This dialog allows you to change all ROM properties as described in - Section 15 - Game Properties. + Section 16 - Game Properties.


    Help dialog:

    @@ -1667,7 +1703,7 @@


    - 8. Event Remapping

    + 8. Event Remapping / Input Devices

    This version of Stella has event remapping. Almost every event in the emulator @@ -1706,7 +1742,12 @@

    Stelladaptor devices can be configured to either the left or right virtual - ports. See the section 'Stelladaptor Support' for more information.

    + ports. See Section 11 - Stelladaptor Support + for further information.

    + +

    Joystick deadzone area for analog joysticks can be set here. The deadzone + can be adjusted in an interval from 0 - 29, which internally is converted to + the range 3200 - 32200 using the formula '3200 + DEADZONE * 1000'.

    Paddle settings are also configured here. The mouse can emulate either paddle 0, 1, 2, or 3. Note that some paddle games don't default to paddle 0. In those @@ -1721,6 +1762,10 @@ paddle. When using digital devices, the paddle is moved a certain amount each frame. This speed setting specifies how much movement will occur.

    +

    The serial port to which a real AtariVox is connected can be set here. + See Section 12 - AtariVox/SaveKey Support for + further information.

    +


    @@ -1838,10 +1883,71 @@ + +

    +

    + 12. AtariVox/SaveKey Support

    +
    + +

    Stella supports a real AtariVox device for the speech/SpeakJet portion + of the controller. You will need a real AtariVox device, located + here, + as well as some means of connecting it to your computer (some sort of + serial port/USB adaptor). There should be drivers for your serial convertor, + which allow your particular operating system to 'see' the device. Configuring + this is outside the scope of this document. Once your operating system + properly detects the AtariVox, you will need to tell Stella which serial + port it is connected to. This is done by using the '-avoxport' commandline + argument, or by setting it in the UI under the 'Virtual Devs' tab in + 'Input Settings', as described in Section 8.

    + +

    Note that you must use the entire name of the port as specified by + your operating system. For example, in Windows this would be COM1, + COM2, etc; Linux and OSX tend to use '/dev/xxxxxx'. For now, only + Linux/UNIX, OSX, and Win32 are supported.

    + +

    Support for the EEPROM portion of the AtariVox and SaveKey is currently + emulated. That is, a file will be created on your computer simulating the + EEPROM; the actual EEPROM hardware itself will not be used or modified. + This is very useful in the testing stages of creating a new game, since + writing to a real EEPROM many times will eventually wear it out.

    + +

    The EEPROM files have a special name/location depending on which + version of Stella you use, which are currently not configurable:

    + +

    + + + + + + + + + + + + +
    Linux/Unix$HOME/.stella/atarivox_eeprom.dat
    + $HOME/.stella/savekey_eeprom.dat
    Macintosh$HOME/.stella/atarivox_eeprom.dat
    + $HOME/.stella/savekey_eeprom.dat
    Windows%MY_DOCUMENTS%\Stella\atarivox_eeprom.dat
    + %MY_DOCUMENTS%\Stella\savekey_eeprom.dat        + OR
    + %CURRENT_DIR%\atarivox_eeprom.dat
    + %CURRENT_DIR%\savekey_eeprom.dat
     + (if a file named 'disable_profiles.txt' exists in the + application directory)
    + +

    Note that these EEPROM files will be created when necessary, and + initialized as a real EEPROM would be (with randomized data). The + files can be manually deleted, which is very useful in testing + cases where a ROM is accessing the EEPROM for the first time.

    + +

    - 12. Integrated Debugger

    + 13. Integrated Debugger

    Have a look at this page for integrated debugger @@ -1851,7 +1957,7 @@

    - 13. Settings File

    + 14. Settings File

    Stella will remember when you change a setting either at the command line @@ -1915,7 +2021,7 @@

    - 14. Cheatcode Manager

    + 15. Cheatcode Manager

    Stella 2.0 contains support for Bob Colbert's Cheetah cheat codes, as @@ -2014,7 +2120,7 @@ Ms Pac-Man (Stella extended codes):

    - 15. Game Properties

    + 16. Game Properties

    Stella uses game properties to specify the "best" emulator settings for a @@ -2171,15 +2277,18 @@ Ms Pac-Man (Stella extended codes): Controller.Left: Indicates what type of controller the left player - uses. The value must be Booster-Grip, Driving, - Keyboard, Paddles, or Joystick. + uses. The value must be BoosterGrip, Driving, + Keyboard, Paddles, Trackball22, + Trackball80, AmigaMouse or Joystick. Controller.Right: Indicates what type of controller the right player - uses. The value must be Booster-Grip, Driving, - Keyboard, Paddles, or Joystick. + uses. The value must be BoosterGrip, Driving, + Keyboard, Paddles, Trackball22, + Trackball80, AmigaMouse, AtariVox, + SaveKey or Joystick. @@ -2261,7 +2370,7 @@ Ms Pac-Man (Stella extended codes):

    - 16. Palette Support

    + 17. Palette Support

    An Atari 2600 palette consists of 128 colours, which are different @@ -2328,7 +2437,7 @@ Ms Pac-Man (Stella extended codes):

    - 17. Acknowledgments

    + 18. Acknowledgments

    Bradford W. Mott started developing Stella during the fall of 1995 and since @@ -2405,7 +2514,12 @@ Ms Pac-Man (Stella extended codes): - Richard H. + Alex Herbert + Provided much information on AtariVox and SaveKey functionality + + + + Richard Hutchinson Provided an AtariVox USB adaptor to help with AVox development @@ -2466,6 +2580,11 @@ Ms Pac-Man (Stella extended codes): Author of the OpenStep version of Stella + + John Payson + Provided EEPROM emulation code for AtariVox and SaveKey support + + Manuel Polik Author of the Windows version of Stella starting with the 1.2 release @@ -2595,7 +2714,7 @@ Ms Pac-Man (Stella extended codes):

    - 18. License and Disclaimer

    + 19. License and Disclaimer

    diff --git a/stella/src/common/Version.hxx b/stella/src/common/Version.hxx index 30aba9e54..08cde2490 100644 --- a/stella/src/common/Version.hxx +++ b/stella/src/common/Version.hxx @@ -13,13 +13,13 @@ // See the file "license" for information on usage and redistribution of // this file, and for a DISCLAIMER OF ALL WARRANTIES. // -// $Id: Version.hxx,v 1.37 2008-05-15 19:10:10 stephena Exp $ +// $Id: Version.hxx,v 1.38 2008-05-16 12:04:34 stephena Exp $ //============================================================================ #ifndef VERSION_HXX #define VERSION_HXX -#define STELLA_BASE_VERSION "2.6_pre" +#define STELLA_BASE_VERSION "2.6" #ifdef NIGHTLY_BUILD #define STELLA_VERSION STELLA_BASE_VERSION "pre-" NIGHTLY_BUILD diff --git a/stella/src/emucore/Console.cxx b/stella/src/emucore/Console.cxx index 3d6414d6f..10c9df1a3 100644 --- a/stella/src/emucore/Console.cxx +++ b/stella/src/emucore/Console.cxx @@ -13,7 +13,7 @@ // See the file "license" for information on usage and redistribution of // this file, and for a DISCLAIMER OF ALL WARRANTIES. // -// $Id: Console.cxx,v 1.141 2008-05-12 22:40:23 stephena Exp $ +// $Id: Console.cxx,v 1.142 2008-05-16 12:04:34 stephena Exp $ //============================================================================ #include @@ -586,7 +586,7 @@ void Console::setControllers() Paddles::setMouseIsPaddle(-1); // Reset to defaults // Construct left controller - if(left == "BOOSTER-GRIP") + if(left == "BOOSTERGRIP") { myControllers[leftPort] = new BoosterGrip(Controller::Left, *myEvent, *mySystem); } @@ -623,7 +623,7 @@ void Console::setControllers() } // Construct right controller - if(right == "BOOSTER-GRIP") + if(right == "BOOSTERGRIP") { myControllers[rightPort] = new BoosterGrip(Controller::Right, *myEvent, *mySystem); } diff --git a/stella/src/emucore/Settings.cxx b/stella/src/emucore/Settings.cxx index 1f7929818..1ed41a130 100644 --- a/stella/src/emucore/Settings.cxx +++ b/stella/src/emucore/Settings.cxx @@ -13,7 +13,7 @@ // See the file "license" for information on usage and redistribution of // this file, and for a DISCLAIMER OF ALL WARRANTIES. // -// $Id: Settings.cxx,v 1.143 2008-05-11 21:18:35 stephena Exp $ +// $Id: Settings.cxx,v 1.144 2008-05-16 12:04:34 stephena Exp $ //============================================================================ #include @@ -338,6 +338,8 @@ void Settings::usage() << " -cheatfile Full pathname of cheatfile database\n" << " -palettefile Full pathname of user-defined palette file\n" << " -propsfile Full pathname of ROM properties file\n" + << " -tiafloat <1|0> Set unused TIA pins floating on a read/peek\n" + << " -avoxport The name of the serial port where an AtariVox is connected\n" << " -help Show the text you're now reading\n" #ifdef DEBUGGER_SUPPORT << endl @@ -350,7 +352,6 @@ void Settings::usage() << " -holdreset Start the emulator with the Game Reset switch held down\n" << " -holdselect Start the emulator with the Game Select switch held down\n" << " -holdbutton0 Start the emulator with the left joystick button held down\n" - << " -tiafloat <1|0> Set unused TIA pins floating on a read/peek\n" << endl << " -bs Sets the 'Cartridge.Type' (bankswitch) property\n" << " -type Same as using -bs\n" diff --git a/stella/src/macosx/Info-StellaOSX__Upgraded_.plist b/stella/src/macosx/Info-StellaOSX__Upgraded_.plist index 8127de18a..d4638d44b 100644 --- a/stella/src/macosx/Info-StellaOSX__Upgraded_.plist +++ b/stella/src/macosx/Info-StellaOSX__Upgraded_.plist @@ -33,7 +33,7 @@ CFBundleExecutable StellaOSX CFBundleGetInfoString - StellaOSX 2.5.1 + StellaOSX 2.6 CFBundleHelpBookFolder docs CFBundleHelpBookName @@ -45,13 +45,13 @@ CFBundleInfoDictionaryVersion 6.0 CFBundleName - StellaOSX 2.5.1 + StellaOSX 2.6 CFBundlePackageType APPL CFBundleSignature StLa CFBundleVersion - StellaOSX 2.5.1 + StellaOSX 2.6 NSMainNibFile SDLMain.nib NSPrincipalClass diff --git a/stella/src/unix/stella.SlackBuild b/stella/src/unix/stella.SlackBuild index 8aba3e525..daf262d37 100644 --- a/stella/src/unix/stella.SlackBuild +++ b/stella/src/unix/stella.SlackBuild @@ -1,6 +1,6 @@ #!/bin/sh -# $Id: stella.SlackBuild,v 1.10 2008-04-08 19:17:26 stephena Exp $ +# $Id: stella.SlackBuild,v 1.11 2008-05-16 12:04:35 stephena Exp $ # stella.SlackBuild for Stella 2.x, B. Watson, 2005 @@ -13,7 +13,7 @@ die() { exit 1 } -VERSION=2.5.1 +VERSION=2.6 ARCH=${ARCH-i486} BUILD=1 diff --git a/stella/src/unix/stella.spec b/stella/src/unix/stella.spec index cbc4c4f11..17a40f1f4 100644 --- a/stella/src/unix/stella.spec +++ b/stella/src/unix/stella.spec @@ -1,5 +1,5 @@ %define name stella -%define version 2.5.1 +%define version 2.6 %define rel 1 %define enable_gl 1 @@ -107,6 +107,9 @@ rm -rf $RPM_BUILD_DIR/%{name}-%{version} %_datadir/icons/large/%{name}.png %changelog +* Fri May 16 2008 Stephen Anthony 2.6-1 +- Version 2.6 release + * Wed Apr 9 2008 Stephen Anthony 2.5.1-1 - Version 2.5.1 release diff --git a/stella/src/win32/stella.iss b/stella/src/win32/stella.iss index da1724daf..06ea66e67 100755 --- a/stella/src/win32/stella.iss +++ b/stella/src/win32/stella.iss @@ -3,14 +3,14 @@ [Setup] AppName=Stella -AppVerName=Stella 2.5.1 +AppVerName=Stella 2.6 AppPublisher=Bradford W. Mott and the Stella team AppPublisherURL=http://stella.sourceforge.net AppSupportURL=http://stella.sourceforge.net AppUpdatesURL=http://stella.sourceforge.net DefaultDirName={pf}\Stella DefaultGroupName=Stella -OutputBaseFilename=stella-2.5.1-win32 +OutputBaseFilename=stella-2.6-win32 Compression=lzma SolidCompression=yes @@ -21,10 +21,10 @@ Name: "eng"; MessagesFile: "compiler:Default.isl" Name: "desktopicon"; Description: "{cm:CreateDesktopIcon}"; GroupDescription: "{cm:AdditionalIcons}"; Flags: unchecked [Files] -Source: "..\..\stella-2.5.1\Stella.exe"; DestDir: "{app}"; Flags: ignoreversion -Source: "..\..\stella-2.5.1\zlib1.dll"; DestDir: "{app}"; Flags: ignoreversion -Source: "..\..\stella-2.5.1\SDL.dll"; DestDir: "{app}"; Flags: ignoreversion -Source: "..\..\stella-2.5.1\docs\*"; DestDir: "{app}\docs"; Flags: ignoreversion recursesubdirs createallsubdirs +Source: "..\..\stella-2.6\Stella.exe"; DestDir: "{app}"; Flags: ignoreversion +Source: "..\..\stella-2.6\zlib1.dll"; DestDir: "{app}"; Flags: ignoreversion +Source: "..\..\stella-2.6\SDL.dll"; DestDir: "{app}"; Flags: ignoreversion +Source: "..\..\stella-2.6\docs\*"; DestDir: "{app}\docs"; Flags: ignoreversion recursesubdirs createallsubdirs ; NOTE: Don't use "Flags: ignoreversion" on any shared system files [Icons] diff --git a/stella/src/win32/stella.rc b/stella/src/win32/stella.rc index 76277dfd4..2016bf8a9 100755 --- a/stella/src/win32/stella.rc +++ b/stella/src/win32/stella.rc @@ -36,8 +36,8 @@ IDI_ICON ICON "stella.ico" // VS_VERSION_INFO VERSIONINFO - FILEVERSION 2,5,1,0 - PRODUCTVERSION 2,5,1,0 + FILEVERSION 2,6,0,0 + PRODUCTVERSION 2,6,0,0 FILEFLAGSMASK 0x3fL #ifdef _DEBUG FILEFLAGS 0x1L @@ -55,12 +55,12 @@ BEGIN VALUE "Comments", "The multi-platform Atari 2600 emulator. Stella is released under the GPL." VALUE "CompanyName", "Bradford W. Mott and the Stella team (http://stella.sourceforge.net)" VALUE "FileDescription", "Stella" - VALUE "FileVersion", "2.5.1" + VALUE "FileVersion", "2.6" VALUE "InternalName", "Stella" VALUE "LegalCopyright", "Copyright (C) 1995-2008 B. Mott & the Stella team" VALUE "OriginalFilename", "Stella.exe" VALUE "ProductName", "Stella" - VALUE "ProductVersion", "2.5.1" + VALUE "ProductVersion", "2.6" END END BLOCK "VarFileInfo"