diff --git a/stella/README-GP2X.txt b/stella/README-GP2X.txt new file mode 100644 index 000000000..c6c215170 --- /dev/null +++ b/stella/README-GP2X.txt @@ -0,0 +1,98 @@ +--------------------------------------- +Stella 2.1: +Ported to GP2X by Alex Zaballa +Contact: alex.zaballa@gmail.com +Homepage: http://stella.sourceforge.net +--------------------------------------- + +-------- +Changes: +-------- +>From 2.0.1: +Stopped using the ROM Script (No more ROM limit. 'Single binary' zip support available.) +Opened up the Native GUI for use through Joymouse Emulation +SOUND! +Diagonals +Snapshots +Some button mapping (but still comfortably familiar) + +----------- +Known Bugs: +----------- +2nd exit bug (yes, it's still there.... but, you can play many games before that second exit, lest we + forget save state. Fix coming soon.) + +------------------------------ +Known GP2X Performance Issues: +------------------------------ +Pitfall 2 runs slow due to extra hardware emulation. (Steve foresees this being fixed in the future.) +Phosphorus effect disabled at the moment due to dragging software video mode. (A version that writes + directly to hardware is in the works.) + +--------------------- +Installation to GP2X: +--------------------- +Place files stella.gpe and stella.pro into a chosen directory. Upon first run, Stella will ask for your +ROM directory and snapshot directory. Remember that the path to the sd card is '/mnt/sd'. + +----------- +Navigation: +----------- +The joystick moves the mouse cursor in all menus except the ROM Launcher, with any button acting as a click. +In the ROM Launcher, up/down scrolls through the ROM list and left/right selects options across the bottom, with any +button serving as a click. + +------------- +GP2X Mapping: +------------- + A = Snapshot + B = Fire + X = Pause + Y = Settings Menu + L = Console Reset + R = Console Select + START = Launcher Menu + SELECT = Command Menu + +Note: Nothing has been taken away by changing this mapping. Save, Change, and Load State are all available +through the Command Menu (SELECT). + +Caution: Changing video and audio settings could lead to a non-working Stella setup. If you do feel the need +to change the settings (as we all do) and happen to cause a crash or hang, delete the 'stellarc' file and that should +clear up the problem. If anyone finds any settings that give better performance in sound and gameplay, +let me know and I might incorporate them into the next build. Happy tinkering. + +------------- +Compile Info: +------------- +Since the GP2X branch was so graciously added to Stella, GP2X compilation is now built in. If you plan on doing a +compile yourself, you need the GP2X devkit pro and SDL Open2X libs with zlib support. I recommend theoddbot's +Open2X libraries which work very nicely for this. Any questions, email me. + +Make sure your path includes your arm-linux compilers: +export PATH=:$PATH + +This is what my configure line looks like: +./configure --prefix= --enable-zlib --disable-developer --host=gp2x --with-zlib-prefix= --with-png-prefix= --with-sdl-prefix= --x-libraries= + +Then: +make + +Then strip the exec: +make gp2x-strip + +You should get an exec ~2mb in size. Much better than 7mb right? + +Place stella.gpe and stella.pro (available in ../src/emucore) into your destination directory on the GP2X and run. + +--------------- +Special Thanks: +--------------- +... to Steve Anthony for the major improvements in the port and incorporating the GP2X. Not to mention the + wealth of information and help... did I mention patience? ;-) +... to Eckhard Stolberg for making me known to the Stella Team. +... to the Stella Team for the excellent emulator and the hospitality. +... to theoddbot for the excellent Open2X toolchain libs. +... to the community for all of the interest.