===== OPL-PORT of Atari 5200 (Jum52) UniqueUserName's MOD =====

Jum's A5200 Emulator, PS2 Version 0.7 
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

= May 30 2016 =
(updated from the =15 September 2002= README)

This is an Atari 5200 emulator OPL-PORT for the PS2 (released with kind permission from Jum).

If you want to use Jum52 outside of OPL, please get the ORIGINAL at:
http://jum.pdroms.de/

If you need a newer version of OPL, get the CURRENT version at:
https://bitbucket.org/ifcaro/open-ps2-loader/downloads/OpenPS2Loader_0.9.3.zip


The 6502 CPU emulator source is heavily based on a distribution by Neil Bradley.
The POKEY sound emulator is a modified version of Ron Fries POKEY emulator.
The rest is by Jum, using Bigboy's PS2 framework :)


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

Jum's A5200 Emulator is copyright 1999-2002 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 (without permission from Jum). 

Jum maintains the right to forbid the use of the emulator at any time.
Jum is not responsible for any damage caused by the use of this program. This program is distributed "as-is".
Jum makes 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- (with ANY roms) and (without permission from Jum).


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


What's new:
~~~~~~~~~~

Some small fixes:
1. Implemented ANTIC mode 4/5 alternate colour bit.
2. Improved joystick code, implemented Pengo mode joystick.

Note:
MODE turns itself on when starting the game, but has to be turned off manually in options menu.
It may improve compatibility with some games, but impair others... so dont forget to shut it off when not in use.


What's not fixed:
~~~~~~~~~~~~~~~~

If a physical CDROM is used, it doesn't stop spinning.
If a physical CDROM is used, the possibility of a 30ish-file limit.


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

Jum52 is only compatible with 16k and 32k games (please make sure you use the correct versions).
The below 62-games are currently known to be compatible with this version:

Please RENAME your games EXACTLY this way (copy/paste), to work with OPL as described and tested, AND to look really good (with full names) in your gamelist... 
Buuut most importantly, to co-exist with the provided FILES.TXT, which is completely case-sensitive... it is how the PS2 knows where to find your games, their paths, and what you would like to call them in the Game Selection Screen.
If you like you can edit the document line by line, and delete the games you do not own (to neaten up your list, and have only games that you actually own).

NOTE: Do NOT mess with the word "END" in the FILES.TXT (D O N T !), or any empty space around it (its NOT really empty!), as your setup will likely fail to boot (and youll have to start over).


IMPORTANT:

Also, REMOVE any extension your images may have, such as .rom, .bin, .a52, etcetera.
(Bulk Rename Utility is great for changing a whole folder in one click in mere seconds -bottom right in its interface).
If you require an extension for some unforeseen reason, you may be limited to DOS 8.3 naming scheme, and you will have to alter the FILES.TXT to match your ROMS folder (examples: BEAMRIDE or BEAMRIDR instead of its full name).

-----32k WORKING games:

BARROOMBASEBALL
BASEBALL
BASKETBALL
BEAMRIDER
BERZERK
BLUEPRINT
CHOPLIFTER
CRYSTALCASTLES
DEFENDER
DIGDUG
FOOTBALL
FROGGER2THREEDEEP
GREMLINS
JOUST
KOFFIYELLOWKOPTER
LASTSTARFIGHTER
MARIOBROS
MEEBZORK
MICROGAMMON
MILLIPEDE
MINER2049
MINIATUREGOLF
MONTEZUMASREVENGE
MSPACMAN
PACMAN
PENGO
PITFALL2THELOSTCAVERNS
QIX
ROADRUNNER
SOCCER
SPACESHUTTLEAJOURNEY
SPORTGOOFY
STARGATE
STARTREKSTRATEGICOPERATION
STARWARSDEATHSTARBATTLE
SUPERCOBRA
VANGUARD
XEVIOUS
ZAXXON
ZENJI
ZONERANGER

-----16k WORKING games:

AE
ASTROCHASE
BATTLEZONE
BUCKROGERSPLANETOFZOOM
CONGOBONGO
COUNTERMEASURE
DREADNAUGHTFACTOR
FINALLEGACY
FRISKYTOM
GORF
JRPACMAN
KRAZYSHOOTOUT
LOONEYTUNESHOTEL
QBERT
ROBOTRON2084
SPACEDUNGEON
SPACEINVADERS
STARRAIDERS
STARWARSTHEARCADEGAME
SUPERPACMAN
TEMPEST


NOTE: If ANY of the above games do not boot for you, then you either have a bad rom, or didnt use the correct 16k/32k format (notice that I made two seperate lists for you, to make it as easy as possible, with using the correct working versions of the game)... ALL these above games WILL work.


Dual-Shock Controls:
~~~~~~~~~~~~~~~~~~~

START       5200 Start button
SELECT      Go to Options Menu
TRIANGLE    5200 * button
SQUARE      5200 # button


Player 1:
~~~~~~~~~
D-PAD   Up/Down/Left/Right
X       Fire
O       Trigger ("fire 1")
R2      Side button ("fire 2")
L1      Keypad button 1
L2      Keypad button 2
R1      Keypad button 3


Player 2:
~~~~~~~~

Not supported yet!


Joystick:
~~~~~~~~~

From the Options Menu (press SELECT button), select whether to use the D-PAD or the Analog Stick for control, by toggling "Controller Mode" (press RIGHT on the D-PAD).

Robotron / Space Dungeon control mode can be activated while in Analog mode by selecting "Robotron Mode On" in the Options Menu.
This allows you to use the left analog stick to move, and right analog stick to fire. 

Pengo control mode is activated automatically if you load Pengo.
You can also activate it from the Options Menu.
Some other games may work better with this mode. 

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.
Some games also calibrate the centre position of the joystick at the start of the game or at the start of a level, so you may have to be careful to leave the joystick centred when pressing start. 


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

ANY folder included, with "! !" surrounding the name of the folder, is telling you where to transfer its CONTENTS for use in OPL.

You will need:

A PS2 running OPL v0.9.3.
UltraISO (invaluable program you should have anyways).
A Computer (duh).
The files in this package.
Along with some 16k or 32k Atari 5200 cartridge games (no games will EVER be included).
You must manually add your own games to the ROMS folder in the ISO (read the included "ADDING YOUR GAMES TO AN ISO..." file for steps).


NOTE: IF YOU DO NOT HAVE A WAY TO BOOT OPL, THEN YOU CANNOT RUN THIS MOD OF JUM52 ON YOUR PS2 !!!


The format of the FILES.TXT file is the same as that in Sjeep's PSMS emulator package, except, that if you want to manually edit it (and arent just deleting the lines of games you dont own), you must maintain the device specifier "cdrom0:" as a prefix in your ROM paths.
See the included FILES.TXT as an example.


Adding your Games to the ISO:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Games...
(you must ALWAYS supply your own)

-----Steps (IF using Bulk Rename Utility):

1- "GATHER" all your games into a single folder.
(before renaming or removing extensions)

2- "OPEN" Bulk Rename Utility, and navigate to your games folder.
(press "CTRL + A", when you see the before/after window viewing your games)

3- Click the "DOWN-ARROW" next to the word "SAME".
(extension-11, in the bottom-righthand-corner)

4- Click "REMOVE", in the list that pops up.
(then click the BIG button in the corner, "RENAME")

5- Click the "DOWN-ARROW" next to the word "SAME".
(case-4, in the lower-middle-left area)

6- Click "UPPER", in the list that pops up.
(then click the BIG button in the corner, "RENAME")


NOTE: At this point in your games folder, there should be no ".ROM" extensions, and all gamenames should be "UPPERCASE".


7- "CLOSE" Bulk Rename Utility.
(RED "X" Tab, in upper-right corner of its-window)


-----Steps (to ADD games to the ISO):


1. "OPEN" the ISO with "UltraISO".
(resize its-window to the left-half of your screen)

2. "DOUBLE-CLICK" the "ROMS" folder inside the ISO.
(to open up ROMS folder for the addition of games)

3. "NAVIGATE" to where you have your "games" stored.
(resize folder-window to the right-half of your screen)

4. "HIGHLIGHT" the games you would like to "add".
(OR Select-All with "CTRL + A")

5. "DRAG+DROP" your games into the ROMS folder.
(while holding-down the Left-Mouse-Button)

6. Click "FILES" Tab > "Properties", make sure "UDF" + "ISO9660" are checked.
(in UltraISO obviously... setting it as default, ONLY defaults for each ISO individually)

7. Click "OK".
(OR press "ENTER")

8. "Close" UltraISO.
(RED "X" Tab, in upper-right corner of its-window)

9. Click "YES", when the "Save-Changed-File" box appears.
(OR press "ENTER")


NOTE: The above instructions should work for most ISOs you make yourself or find on the net... however, if youre using one of my ISOs, there is a few more steps to get all the pre-set settings and coverart/backgrounds, that I will usually include...


-----Extra Steps:

10. "MOVE" the CONTENTS, of ALL folders in the zip, to where its !FOLDERNAME! says.
(ONLY the CONTENTS, of these special directing folders, NOT any !FOLDER ITSELF!)

11. "BOOT" OPL, and Launch your game from whatever menu corresponds to your device.
(ISO goes in "CD" folder on ROOT of USB... OR treat as a PS2 game if used in IHD)


-----Enjoy!


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

FAQ:
~~~~

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

2.
Q: It's so sssslllllooooowwwwwwwww...........
A: Your PS2 is broken.
A: Run in a PS2 emulator on a faster PC.
A: You may be playing this NTSC version in PAL mode.

3.
Q: I have trouble getting my joystick to work.
A: It happens to even the best of men. 
A: Joystick is not completely emulated.

4.
Q: I don't hear any sound.
A: Cut down on the heavy metal.
A: Turn up the volume REALLY loud.

5.
Q: Game X doesn't work.
A: It may be a corrupt/bad ROM image (there are many).
A: For now use only the games in the above list.
A: If you can't get past the start screen in the game, then Jum52 just doesn't handle that game (yet).

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


Troubleshooting and Comments:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

For the OPL-PORT of Jum52:
At the original release thread on PSX-SCENE.COM (where you probably got this).

For the Jum52 Emulator itself:
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? 


Credits:
~~~~~~~~

THANKS TO:

James Higgs (Jum is THE MAN! and author of Jum52):
(for waaay too many reasons to list here).
(seriously, I would need to make another readme to list it all).

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).

Richard Bannister:
(for cross-platform conversion and Mac version).

Sjeep & Bigboy:
(for the PS2 stuff).

Duke/NPM & ppl:
(from #psx2dev).

UniqueUserName:
(for remaking the FILES.TXT file to match new configuration).
(for removing the DOS 8.3 8-character filename-limit).
(for removing the need for multiple ROMS-folders).
(for compatibility testing with use in OPL).
(for configuring it noob-friendly to work with OPL).
(for updating this README/adding upto date instructions).

...And any other people who contributed, or complained...


FINAL NOTE from UniqueUserName:

If anyone knows how to get Jum52 to fetch the list of games from the ROMS folder...
(to remove the FILES.TXT limitation from this configuration)
Please contact UniqueUserName @PSX-SCENE.COM


===== This README updated in May-2016 by UniqueUserName, to apply to the OPL-PORT of Jum52, while retaining as much of the original README as possible =====