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