Archimedes Emulator
===================
Homepage: http://arcem.sf.net/

Version 0.01
This is the first release on gp2x

Ported by Ian Jeffray (ian@jeffray.co.uk)

Written by Dave Alan Gilbert

This is completely experimental, and horribly slow, and not supported.
However, you can boot RISC OS and ARM Linux on it.

It is released far too early, for the gp2x.co.uk 2006 coding
compo.   I'm sorry it's not terribly useful yet.  My diffs will
be merged back to sourceforge - I hope others can help with this
emulator for gp2x - especially to make it faster!


Installing:

  Copy the contents of this archive to the ROOT of your SD card.
  The binaries must reside in /mnt/sd/arcem when mounted on
  your gp2x


Running ARM Linux:

  The provided 'rom' file will boot ARM Linux.  However, to get further
  than a kernel panic, you will require the Harddrive image from
    ftp://ftp.arm.linux.org.uk/pub/linux/arcem/
  Uncompress, and also place in the same directory
  Run the application.
  Login as "root".


Running RISC OS:

  You'll need to obtain a RISC OS 3.1 (or whatever) ROM image.  If you
  have 4 files, you'll need to join these into a 2MB file called "rom"
  in the same directory
  Run the application.
  PLEASE NOTE THAT BECAUSE THIS EMULATOR IS SO SLOW JUST NOW YOU WILL
  HAVE TO WATCH THE BEAUTIFUL BLANK SCREEN FOR UP TO TWO MINUTES WHILE
  THE OS BOOTS UP!
  
  Joystick moves the mouse (you may need to 'flick' rather than
  hold it - a known bug)
  Clicking the joystick down, clicks the left 'select' mouse button
  Select: F12
  A: 'h'
  Y: '.'
  Start: Enter
  (So you can hit Select, A, Y, Start to enter a simple RISC OS *
   command and see the emulator respond)
  If you have a serial cable, you can use that for keyboard input!


You can quit the emulator with the power switch ;-)


Known Problems:

  Hardware scrolling (e.g. F12 from desktop) doesn't work properly.
  It's very slow.
  Mouse input is horribly lumpy - don't "hold" the joystick
  Mouse cursor shape isn't correct (uses gp2x hardware cursor and
    pattern from the MMSP2 data sheet just now!)
  GP2X hardware scaling makes things look ugly (plan to use 2nd
    cpu to implement bicubic software scaler).


Original source, documentation, etc, available from:

  ftp://ftp.arm.linux.org.uk/pub/linux/arcem/



