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