===================================================
Author: Slaanesh
Website: http://www.slaanesh.net/
Email: slaanesh@bigpond.net.au
Paypal (donations): slaanesh@bigpond.net.au
Emulator: vAtari - Virtual Atari v2.0

vAtari is an Atari 2600 emulator for the Dingoo A320 (Native) and the GP32
==========================================================================

The emulator features:

* Highy optimized code.
* All games run at fullspeed;60FPS (for NTSC) and 50FPS (for PAL).
* Emulator is a mixture of various other Atari 2600 emulators and a big chunk of my own code.
* Has a built in library of Atari 2600 games with smart default game configuration.
* Paddles are emulated (Breakout! and many others).
* Dual joystick modes for Raiders of the Lost Ark and others.
* GP32 Frontend game selector (with optional overclock). A320 version uses the O/S to select the game.
* Gp32 version runs on NLU, FLU, BLU or BLU+.


Controls (Frontend, GP32 only):
-------------------
* Joystick moves selector. Up/Down line, Left/Right page.
* 'A' Button starts game at 133Mhz.
* 'B' Button starts game at 150Mhz.
* 'SELECT' Button starts game at 166Mhz.
* 'START' Button exits back to your firmware.


Controls (Emulator, Both):
-------------------
* Joystick provides movement for either joystick or paddle.
* 'A' Button is the fire button.
* 'B' Button is the fire buttons on the "other" controller.
* 'START' Atari Reset.
* 'SELECT' Atari Select.
* Games the require two joysticks, hold 'B' button to use second joystick
* Games the require two joysticks, 'L Shoulder' is the other fire button

Controls (A320 Specific)
* 'Power Slider' to switch off.
* 'L + R Shoulder' back to O/S.
* 'L Shoulder' decrease volume.
* 'R Shoulder' increase volume.
* 'Y' toggles Player 1 difficulty.
* 'X' toggles Player 2 difficulty.

Controls (GP32 Specific)
* 'SELECT + START' back to frontend.
* 'L + R' Information screen
* 'L Shoulder' toggles Player 1 difficulty.
* 'R Shoulder' toggles Player 2 difficulty.


A320 Installation:
-----------------
The vatari.sim should be copied to the A:/GAME directory along side the other .sim files.
Create a directory to store your Atari ROMs ie: A:/VATARI or B:/A2600
ROMs should NOT be compressed/zipped.
ROMs must have the .A26 suffix.

I split my ROMs into multiple alphabetically grouped directories, ie: A:/A2600/A-F,  A:/A2600/G-J, etc

The emulator sets the CPU to 336Mhz as this is sufficient to run all games at fullspeed.
The only exception is Pitfall 2 which requires more. Currently this is set to 396Mhz.
I haven't tested lower speeds yet but this runs it full speed with super sound.

The A320 version writes a log file to B:/vatari.txt (ie. Micro SD card).
If you have a problem with a game please check this file and send/post the corresponding log entry.


GP32 Installation:
-----------------
The files should be put on the GP32's SMC as follows.
The ZIP file already has this structure so just copy everything to your SMC.
Add a liberal amount of Atari 2600 ROMS to test. 
ROMs should NOT be compressed/zipped.
ROMs must have the .A26 suffix.

ie.

 |-GPMM/
     |-VATARIL.FXE (vAtari Game Selector)
     |-VATARI/
         |-SPLASH.BMP (vAtari Splash Screen)
         |-VATARI.FXE (vAtari Game Emulator)
         |-GAME1.A26 (Game ROM - not included)
         |-GAME2.A26 (Game ROM - not included)
         |-...
         |-...


History:
-------

V1.0
----
The GP32 was missing good Atari 2600 emulation. I had a look at the existing GP32 Atari 2600 emulators but they were either slow or not very compatible. I wanted to play my favorite Atari 2600 games on my GP32 - this included River Raid, H.E.R.O., Empre Strikes Back, Adventure, Berzerk, Centipede, Missile Command, Combat, Dragonfire, Pitfall, Space Invaders and Winter Games.
So I set about (initially) porting across various Atari 2600 emulators. Pretty much all of them had disappointing results - in the end I decided I'm going to have to tackle this myself. So using pVCS as a base, with a bit of Stella and lot of my own code, I crafted by own Atari 2600 emulator for the GP32. And I'm very happy with the results.
My initial objectived was to run River Raid at full speed. The first few build could run it at around 25FPS at 150Mhz. Lots of optimization later it now runs at the full 60FPS at 133Mhz. Actually it can run faster than that - in fact some games with the speed limiter off can push 90FPS running at 133Mhz!
Technically, it's mostly optimized 'C' with some ARM assembler, including a highly optimized ARM video blitter with double buffering especially tweaked for the Atari 2600 and GP32 screen.

V2.0
----
After a long hiatus of no development, I got interested in my vAtari project again. I noticed that many games weren't graphically very accurate. Some were fine, like River Raid and Pitfall but others just didn't work or produced graphics that weren't accurate (Pole Position and Desert Falcon).
So I began the task of updating the CPU and TIA code. Along the way many improvements have been made - some speed has now been sacrified for accuracy however the resulting emulator is now very accurate and also very fast. Most games will run at full speed in as little as 100mhz on the GP32. Others need more - in particular Pitfall 2 which doesn't really run full speed even at 166Mhz.
I also wanted to port vAtari to the Dingoo A320. Once I was happy with the GP32 version I ported the code accross and very quickly had a version that runs very nicely on the A320. The only issue was that the sound driver wasn't accurate enough (still!) for Pitfall 2 - so it has some floating point maths and now we have pretty much perfect sound and speed.
Both the GP32 and the A320 are great Atari 2600 emulation hosts with enough input controls and nice screen for a good handheld Atari 2600 experience - much better than the iPhone with its clumsy touch-screen controls for instance.

