			fudroyd - a gameboy emulator for android
			     mic, 2009 | micol972@gmail.com


What is emulated
----------------
GB-Z80: All opcodes, though some might be buggy.
Memory bank controllers: MBC1, MBC3, MBC5.
Video: BG, window, objects, GBC palettes/attributes.
Joypad.
Timer.
GBC HDMA (only normal mode, not hblank triggered).



What is not emulated
--------------------
Audio.
Several memory bank controllers.
Any kind of external peripherals.
Probably a lot of other things.



Using the emulator
------------------

To run a ROM named foobar.gb, run the following commands from the prompt:

	adb push fudroyd /data/misc/fudroyd

	adb push foobar.gb /data/misc/foobar.gb

	adb shell chmod 777 /data/misc/fudroyd

	adb shell /data/misc/fudroyd /data/misc/foobar.gb

(Assuming that you're in the tools directory of the Android SDK, and you've got all the relevant files in there)

The GB joypad is mapped to the Android keypad as follows:

Up - Up
Down - Down
Left - Left
Right - Right
B - Z
A - X
Start - Return



Building the source code
------------------------

The ZIP archive includes a pre-compiled binary of the emulator for ARM-based Android devices.
If you happen to have an Android device based on some other platform, or you just want to compile the
source code yourself for some other reason, here's what you need to do:

* Build SDL for Android (instructions can be found at http://jiggawatt.org/badc0de/android/index.html#sdl).

* Assuming you've got a directory structure looking something like this:

  /
     fudroyd
        src
     SDL-1.2.13

  All you need to do is enter the fudroyd directory and run make.






