uae4allgp2x0.6.4
----------------

This is an Amiga emulator for the GP2X.  It runs quite a lot of games at a reasonable speed with sound.

uae4all is Chui's work - I have just changed a few things to make it a bit more convenient to run
on the GP2X.

This port is maintained by critical (criticalhippo@gmail.com).  

The wiki at:

http://wiki.gp2x.org/wiki/UAE4all 

is where the compatibility list, keys, etc. are held.

Note that compatibility has been largely down to the CPU emulation core in the past, and this has now
changed with the 0.6.0 release to Chui and fox68k's FAME.  This has improved speed greatly.

The mmu hack included in this release is thanks to Squidge.

The cpuspeed.o included in this release is thanks to Hermes/PS2Reality, Vimacs and god_at_hell.

There is use of ryleh's minlib too, and of course Paeryn's HW SDL libs.


Installation
------------

* Copy uae4all.gpe and mmuhack.o into a directory on your SD card

* Copy the data directory to that directory, so it sits beneath 
  the directory you just copied uae4all.gpe to.

* Put your kick.rom file in the same directory as uae4all.gpe.

* Create a roms directory in the same directory as uae4all.gpe 
  (it should browse to any, but I haven't tested that.


Release history
---------------

20060203 - version 0.1.0	Initial release

20060204 - version 0.2.0 	Added diagonals to directions
				Fixed down-left causing return to menu (select does that now)
				Added left mouse-click by pressing L button (does the job)
				Added right mouse-click by pressing R button (untested)
                         	Tested with Chaos Engine as well now (handles disk swap)

20060204 - version 0.2.1 	Added second joystick button support (Y button).  This lets
                         	you turn into the spinning disc in Turrican, and may well work
                         	with other games too (I'm hoping Chase HQ, Shadow Dancer, and
                         	Wonderboy).

				Made exit on the main menu exit back to the GP2X menu properly.

20060205 - version 0.2.5 	Added mouse support.  The START button toggles it on and off.
                        	This lets you play Lemmings :)  Hopefully UFO might work too.

20060210 - version 0.2.8	Added ability to disable status line.
				Mapped A button to send keystrokes 'Return', then 'Space'.
				Used Iorgy77's new splash screen and background bmps (cheers).

20060212 - version 0.3.0        Added virtual keyboard support (rough around the edges still).

20060213 - version 0.3.1	Stopped sending joystick events to the games when in virtual
				keyboard mode.

20060215 - version 0.3.2        Added initial remapping support and removed awful hack that made
                                users install to /uae4all.  Set up remapped demo key for Pinball
                                Dreams.

20060218 - version 0.4.0	Initial stab at sound support.  Also, added bitmaps for joystick,
				mouse, and remapping modes so they show which mode you're 
				switching to when you press the Start button.

20060221 - version 0.4.1        Had a go at providing overclocking options.  Also added volume
				control (use vol-/+, provides on-screen display).  Changed 
				throttle settings to be a bit more sensible (hopefully).

20060223 - version 0.4.2	Changed the overclocking support to leave existing settings
				alone initially.  Fixed volume control in mouse emu mode.

20060227 - version 0.4.3	Added option to use battery LED to show disk access (thanks
				to Waninkoko's sdl2x code).

20060303 - version 0.4.5	Added support for HAM and EHB.  Added 'Fake' option to sound,
				which does enough to get stubborn games to run, but is intended
				to allow the game to still run faster than it would if real
				sound was being output.

20060313 - version 0.5.0	Merged in Chui's changes for rc-1 of his dreamcast release.
				Improved compatibility (Three Stooges now works, for example),
				and two disk drive support (tested with Lemmings).  Also
				super throttle and adz.  Fake sound temporarily doesn't work.  

20060314 - version 0.5.1	Stopped switching input mode when virtual keyboard visible.
				Fixed annoying "have to select directories twice sometimes" bug
				Sorted both directories and files, rather than just files
				Implemented turbo mouse (hold down X for triple speed mouse)
				Added 266MHz to the overclocking options
				Added png icon

20061029 - version 0.6.0	Used Chui's new FAME core.  Used squidge's mmu hack.

20061030 - version 0.6.1	Fixed crashes on overclock.  Fixed flickering on input mode change.

20061031 - version 0.6.2	Fixed crashes on overclock (hopefully).  Added SELECT to show full
				filename in file browser.  Added -norelaunchmenu command line param
				to stop it relaunching the gp2x menu app on exit.

20061111 - version 0.6.3	Really fixed crashes on overclock.  It seems to just crash when
				using HW accelerated SDL on the main menu.  Added mouse acceleration
				option to main menu.  Various other cosmetic things (no more flickering
				virtual keyboard).

20061113 - version 0.6.4	Added disk writing.  Auto save in the main menu defaults to 'on', which
				will cause any writes to disk to be written into the saves directory
				under the dir in which uae4all is stored.  Defaulted sound to 'on'.

The rest
--------

The code I ported it from (a Dreamcast port) is available here:

http://chui.dcemu.co.uk/uae4all.html

My full source is available here:

http://www.vividvillage.com/

Email: criticalhippo@gmail.com

This is GPL'ed software... respect the license.