Jum's A5200 Emulator, Windows Version 0.8 
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

10 April 2003

This is an Atari 5200 emulator for Windows.
MSDOS, BeOS, Mac, QNX and PS2 versions are also available.

The 6502 CPU emulator source is heavily based on a distribution
by Neil Bradley. The POKEY sound emulator is from Ron Fries.
The rest is by me :)


Obligatory Copyright Notice:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Jum's A5200 Emulator is copyright 1999-2003 by James Higgs.
POKEY Sound is copyright 1996 by Ron Fries.

Jum's A5200 Emulator is free as long as it is not used in a commercial
manner and not altered in any way. The contents of this archive should
not be added to or changed in any way. 

I maintain the right to forbid the use of the emulator at
any time. I am not responsible for any damage caused by the use
of this program. This program is distributed "as-is". I make no
guarantees as to it's accuracy, performance, or compatibility with
the user's hardware.

Jum's A5200 Emulator ("Jum52") is not to be included in CD collections
of any sort.


******************************************************************
	DO NOT ASK ME FOR ROM OR CARTRIDGE IMAGES !!!
******************************************************************

Emulated hardware:
~~~~~~~~~~~~~~~~~~
CPU			99%
ANTIC			97%
GTIA			97%
POKEY			99%	
Controllers		95%	(also joystick + mouse)

Still a few display timing problems.
Still a few controller problems.

What's New:
~~~~~~~~~~~

See changes_52pi.txt

Compatibility:
~~~~~~~~~~~~~~

Most carts will run. Some games still give problems:

Buck Rogers
Decathlon
Mr. Do's Castle
Quest for Quintana Roo
Rescue on Fractalus

New games playable with version 0.8:

KABOOM!
RIVER RAID
H.E.R.O.
+ maybe some more


Keys:
~~~~~
F1	5200 Start button
F2	5200 Pause button
F3	Reset (reboot emulator)
F4	Go to monitor & halt CPU
F5	5200 * button
F6	5200 # button
F8	Switch between Keyboard/Joystick/Mouse control
F9	Save state
F10	Load state
F11	Toggle fps display on/off
F12	Dump screen to PCX file

ESC	Go back one level. (ie: does what you expect)
Pause   5200 Pause button
P	Emulator pause
TAB	Scanline mode (crappy TV mode) on/off

Player 1:
~~~~~~~~~
Arrow Keys	Up/Down/Left/Right
Right Ctrl	Fire (*changed)
Space		Trigger ("fire 1")
\               Side button ("fire 2")
0-9, F5, F6     Keypad buttons (also "-" (*) and "+" (#) )

Player 2:
~~~~~~~~~
E/X/S/D		P2 Up/Down/Left/Right
Left Ctrl	P2 Fire (*changed)
/               P2 Start
*		P2 Pause
Del		P2 * button
Enter		P2 # button

Debugger Keys
~~~~~~~~~~~~~

Press H while in the debugger to get help.


Joystick:
~~~~~~~~~

Calibrate the joystick by clicking on the "Calibrate" button
in the options dialog.

Joystick calibration settings will be saved in "joy.ini".

Many games do "auto-calibrating" while you play. Moving the
joystick handle in a big circle while chanting "work dammit"
usually gets it working OK. (The same applies when using the
keyboard - press left, right, up, down to let the game
calibrate the controller).


Mouse:
~~~~~~
The mouse does not require calibrating :)
Use the mouse for Missile Command and maybe other trackball
games.


Getting started:
~~~~~~~~~~~~~~~~

You will need:
Jum's A5200 Emulator executable JUM52.EXE
A5200 bios rom, renamed to "5200.BIN", in the same directory.
Some 16k or 32k 5200 cartridge images

******************************************************************
	DO NOT ASK ME FOR ROM OR CARTRIDGE IMAGES !!!
******************************************************************


Run jum52.exe
Choose the type of control you want to use.
Set other options as neccessary.
Click on "Load ROM" to load and run a ROM image.


Command-line switches:
~~~~~~~~~~~~~~~~~~~~~~

PAL	Use PAL mode. (See jum52pal.bat).



FAQ:
~~~~

1. Q: It doesn't run on my Mac or my Linux box.
   A: Get the Mac version from www.bannister.org
   A: It hasn't been ported to Linux yet, because Linux
      is way harder to port to than QNX, BeOS, and PS2
      (apparently!).

2. Q: It's crap. There's no blah blah yadda yadda ...
   A: It's free. Waddaya expect?

3. Q: It's so sssslllllooooowwwwwwwww...........
   A: Not really. You just have a crap PC.

4. Q: I have trouble getting the joystick to work.
   A: Delete joy.ini and restart. 
   A: Joystick is not completely emulated.

5. Q: I don't hear any sound.
   A: Cut down on the heavy metal.
   A: Turn up the volume REALLY loud.
   A: You have a crap sound card.

6. Q: Game X doesn't work.
   A: It may be a corrupt/bad ROM image (there are many).
   A: Jum52 may not handle that game (yet).

7. Q: Where can I get ROMZ? (plead/whine/grovel/demand)
   A: Learn to use a search engine, or something.



Troubleshooting and Comments:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Email:  james7780@yahoo.com

1. RTFM ("Getting started" above)
2. Intelligent questions are welcome.
3. Constructive comments are appreciated (especially comments on
   how the emulator differs from the real thing).


Future Features:
~~~~~~~~~~~~~~~~

1. Better.
2. Faster.
3. Better controller support.
4. Whatever you can suggest? 
5. Updated platform-independant version.

Credits:
~~~~~~~~
Thanks to:
Dan Boris (author of VSS and V7800) for infos.
Ron Fries (for POKEY emu).
Neil Bradley for 6502 emu.
Sherwood for helpful comments and other stuff.
Christpher Durante for useful input.
John Swiderski for comments and requests.
Other people who contributed or complained. 
