Jum's A5200 Emulator, version 0.3a ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 1/6/2000 This is an A5200 emulator. It will run most 5200 games, more or less. Some games are even playable! 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. 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: ~~~~~ ESC Go back to "main dialog". Controller 1: (keyboard, joystick or mouse) F1 Start key F2 Pause key F3 Reset key F4 Go to debug monitor F5 or "-" 5200 * button F6 or "=" 5200 # button F8 Switch between Keyboard/Joystick/Mouse control F12 Dump screen to PCX file Controller 2: (keyboard control only) keypad / Start keypad * Pause keypad + Reset keypad Del * keypad Enter # When in the debug monitor, press "h" to get help on what keys to use. Joystick: ~~~~~~~~~ Joystick calibration settings will be saved in "joy.ini" the first time you run 52emu. Thereafter they will be loaded automatically. If you need to recalibrate, just delete joy.ini before running the emulator. Mouse: ~~~~~~ The mouse does not require calibrating :) Use the mouse for Missile Command and 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 The main dialog box will pop up (warning - ASCII art!): +-------------------------------------------+ | Jum's 5200 Emulator | | | | Controller: (o) Keyboard ___________ | | ( ) Joystick | Calibrate | | | ( ) Mouse ~~~~~~~~~~~ | | | | (o) Normal mode (o) Sound On | | ( ) Debug mode ( ) Sound Off | | | | Volume: |--------|--| | | | | __________ _________ _________ | | | Load Rom | | OK | | Quit | | | ~~~~~~~~~~ ~~~~~~~~~ ~~~~~~~~~ | +-------------------------------------------+ Change the settings as you wish, or use the default settings. Click on "Load Rom" to load and run a game. Click "OK" to go back to a game. Click "Quit" to exit the emulator. Press "ESC" at any time to return to the Menu dialog. Details of menu options: 1. Controller Choose to emulate the 5200 controller with the keyboard, joystick, or mouse. 2. Normal / Debug mode Normal mode runs the 5200 software in 320x240 modex mode. Debug mode, well try it and see... (remember keys "F4" and "h") 3. Sound On/Off Turn sound off if it sounds horrible or something. 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 under dev. More in future releases. A: It's free. Waddaya expect? 3. Q: It's so sssslllllooooowwwwwwwww........... A: You're right. A: Program have much room for optimisation. A: You'll probably need a PII 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. A: Try put sound card in SB16 mode. 7. Q: Where can I get ROMZ? 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. Development History: ~~~~~~~~~~~~~~~~~~~~ ? ??? 2000: Version 0.3a (will have) : - better controller support - speed up - more cart mappings supported. ? May 2000: Version 0.2a - 320x240 mode X "fullscreen" gfx - Speed improved - More games run - Collision detection improved - 2nd controller supported 28 Feb 2000: Version 0.1a released (debugging version) Credits: ~~~~~~~~ Thanks to: Dan Boris (author of VSS and V7800) for infos. Ron Fries (for POKEY emu). [Names of guys who contributed comments etc]