Jum's A5200 Emulator, version 0.2a 
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

5 May 2000

This is an A5200 emulator, debugging version. It is in
the alpha stage of development.

It is written using DJGPP/Allegro. 6502 emulator source is heavily
based on a distribution by a guy called "Neil". POKEY sound emulator
is from Ron Fries. The rest is by me :)


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

Jum's A5200 Emulator is copyright 1999-2000 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
matter 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 users 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%	(incl. some "naughty" opcodes :)
ANTIC			95%
GTIA			95%
POKEY			90%	
Controllers		50%	(also joystick + mouse)

Sound is emulated using Pokeysound (Ron Fries).
Hardware collision detection not complete.
Some "timing" problems, which are a ballache.


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

1. Non-debug 320x240 modex mode
2. New interface - menu to change options.
3. Speedup of I guess about 30% after a few optimisations.
4. More accurate timing -> better compatibility.


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

See compatibility list file.
Most carts will run, even if not very well.

Despite the fact that the emulator is not complete, you might
find it useful if you're coding something for the A5200.

Keys:
~~~~~
F1	5200 start button
F2	???
F3	Reset (reboot emulator)
F4	Go to monitor & halt CPU
F5	5200 # button
F6	5200 * button
F8	Switch between Keyboard/Joystick/Mouse control
F12	Dump screen to PCX file

ESC	Go back one level. (ie: does what you expect)


Joystick:
~~~~~~~~~

The first time you run the program, you will be asked to calibrate
the joystick.

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

Thereafter you may calibrate the joystick by clicking on the
"Calibrate" button in the options dialog.


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 go.bat
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.


FAQ:
~~~~

1. Q: It doesn't run on my Mac.
   A: Run a PC emulator on your Mac, then run it on the PC emu.

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

3. Q: It's so sssslllllooooowwwwwwwww...........
   A: You're right.
   A: You should have seen it before some optimisations!
   A: Program still have room for optimisation.
   A: You'll probably need a Pentium II to get 60 fps.

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.

7. Q: Where can I get ROMZ? (plead/whine/grovel/demand)
   A: You frickin MTV gen live in the rotting Western civilisation's
      "culture" of entitlement.
   A: Piss off.
   A: What are ROMZ?
   A: Learn to use a search engine, or something.



Troubleshooting and Comments:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Email:  jum_the_hig@geocities.com

1. RTFM ("Getting started" above)
2. Intelligent questions are welcome.
3. Constructive comments are appreciated.


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

1. Speed optimisation.
2. Better compatibility.
3. Better controller support.
4. Sprite priority (blah!)
5. Um... Make it better? 

Credits:
~~~~~~~~
Thanks to:
Dan Boris (author of VSS and V7800) for infos.
Ron Fries (for POKEY emu).
 

