| | 1 | \r |
| | 2 | GINGE - Ginge Is Not GP2X Emulator\r |
| | 3 | release 4\r |
| | 4 | \r |
| | 5 | (C) notaz, 2010-2011\r |
| | 6 | http://notaz.gp2x.de/\r |
| | 7 | \r |
| | 8 | \r |
| | 9 | About\r |
| | 10 | -----\r |
| | 11 | \r |
| | 12 | Ginge is an application that can run many GP2X F100/F200, Wiz games and\r |
| | 13 | programs on other ARM Linux platforms, which currently includes Pandora,\r |
| | 14 | Caanoo and Wiz itself. It is not a full hardware emulator like MAME, PicoDrive\r |
| | 15 | or similar, it does not emulate the CPU. It can be considered as compatibility\r |
| | 16 | layer similar to Wine on PC Linux, however it does emulate small portion of\r |
| | 17 | MMSP2 and Pollux system-on-chips. It operates by hooking certain system calls\r |
| | 18 | and using realtime patching of code that accesses memory mapped hardware\r |
| | 19 | directly.\r |
| | 20 | \r |
| | 21 | \r |
| | 22 | Usage\r |
| | 23 | -----\r |
| | 24 | \r |
| | 25 | Ginge comes with a launcher that is started when you run Ginge. The launcher\r |
| | 26 | can then be used to start GP2X software, which will either run if it's\r |
| | 27 | compatible, or just return back to the menu if it is not. In some cases it\r |
| | 28 | might hang though.\r |
| | 29 | \r |
| | 30 | Keys are mapped to corresponding keys pandora, Wiz and Caanoo , except:\r |
| | 31 | \r |
| | 32 | Key Pandora Wiz Caanoo\r |
| | 33 | Stick Push 1 unmapped Stick Push\r |
| | 34 | Volume up/down '.', ',' Volume up/down Home+I/Home+II\r |
| | 35 | \r |
| | 36 | On pandora pressing 'q' will exit the menu or try to kill current application.\r |
| | 37 | On Cannoo Home+Y tries to kill current application.\r |
| | 38 | \r |
| | 39 | \r |
| | 40 | Structure\r |
| | 41 | ---------\r |
| | 42 | \r |
| | 43 | Ginge actually consists of 4 independent executables and a few scripts:\r |
| | 44 | \r |
| | 45 | + ginge_sloader - loader of static executables\r |
| | 46 | + ginge_dyn - dynamic executable handler\r |
| | 47 | + ginge_prep - .gpe parser that selects the right handler from above\r |
| | 48 | + gp2xmenu - the launcher/menu program\r |
| | 49 | + ginge_dyn.sh - environment setup script for ginge_dyn\r |
| | 50 | + ginge.sh/gpe - menu launcher script\r |
| | 51 | \r |
| | 52 | The menu is optional and can be replaced or bypassed completely. The only thing\r |
| | 53 | it does is running ginge_prep on GP2X .gpe program, ginge_prep handles the rest.\r |
| | 54 | \r |
| | 55 | \r |
| | 56 | Changelog\r |
| | 57 | ---------\r |
| | 58 | \r |
| | 59 | r4\r |
| | 60 | + ginge now runs on Caanoo\r |
| | 61 | * minor fixes in path handling\r |
| | 62 | \r |
| | 63 | r3\r |
| | 64 | * improved exec handling, mostly for gpecomp.\r |
| | 65 | + added preliminary Wiz support, pcsx4all works.\r |
| | 66 | * Wiz: since some stuff is written to /tmp, mount tmpfs there when starting\r |
| | 67 | to avoid wearing down flash.\r |
| | 68 | \r |
| | 69 | r2\r |
| | 70 | * improved exit handling\r |
| | 71 | * Wiz: should now return to Wiz menu after gp2xmenu exit\r |
| | 72 | \r |
| | 73 | r1 - initial release\r |
| | 74 | + icons provided by Inder\r |
| | 75 | \r |
| | 76 | \r |
| | 77 | License\r |
| | 78 | -------\r |
| | 79 | \r |
| | 80 | gp2xmenu is based on GPH GPL source (http://www.gnu.org/licenses/gpl.html).\r |
| | 81 | Source is available at http://notaz.gp2x.de/releases/ginge/gp2xmenu.tar.bz2\r |
| | 82 | \r |
| | 83 | Ginge may come with some libraries. Those libraries are unmodified copies\r |
| | 84 | of ones found in root filesystems in GP2X and Wiz and are included to more\r |
| | 85 | accurately reproduce environment found on GP2X. Their source code may or may\r |
| | 86 | not be available, I did not use it, but whatever I found is mirrored here:\r |
| | 87 | http://notaz.gp2x.de/downloads/gp2x/src/410_all/\r |
| | 88 | \r |
| | 89 | Remaining portion is released under custom closed source license. It is not\r |
| | 90 | derived from gp2xmenu and is completely standalone, the menu is only included\r |
| | 91 | for user's convenience.\r |
| | 92 | \r |
| | 93 | Redistribution and use of program's binaries and helper scripts, with or without\r |
| | 94 | modification, is permitted provided that the following conditions are met:\r |
| | 95 | * This readme is included in unmodified form.\r |
| | 96 | * The program in any of it's forms is not sold or used as part of any\r |
| | 97 | commercial package, including pre-installed or included in any kind of\r |
| | 98 | portable device.\r |
| | 99 | * It is not bundled and distributed with any GP2X or Wiz program without\r |
| | 100 | respective program's author's permission.\r |
| | 101 | \r |
| | 102 | THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND\r |
| | 103 | ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED\r |
| | 104 | WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE\r |
| | 105 | DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDER BE LIABLE FOR ANY\r |
| | 106 | DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES\r |
| | 107 | (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;\r |
| | 108 | LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND\r |
| | 109 | ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT\r |
| | 110 | (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS\r |
| | 111 | SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\r |
| | 112 | \r |
notaz.gp2x.de / ginge.git / blame_incremental