abf6e44ff41b077c0d68f7963e8fe3da2795f7e8
[pcsx_rearmed.git] / pandora / readme.txt
1
2 PCSX-ReARMed - yet another PCSX fork
3
4 http://notaz.gp2x.de/pcsx_rearmed.php
5
6
7 About
8 -----
9
10 PCSX ReARMed is yet another PCSX fork based on the PCSX-Reloaded project,
11 which itself contains code from PCSX, PCSX-df and PCSX-Revolution. This
12 version is ARM architecture oriented and features MIPS->ARM recompiler by
13 Ari64. It was created for Pandora handheld, but should be usable on other
14 devices after some code adjustments.
15
16 PCSX ReARMed features GPU plugin from PCSX4ALL project.
17
18
19 Usage
20 -----
21
22 This version features a framebuffer driven menu that can be used to run
23 games and configure the emulator.
24
25 Supported CD image formats:
26 - .bin/.cue
27 - .bin/.toc
28 - .img/.ccd/.sub
29 - .mdf/.mds
30 - .Z/.Z.table
31 - .bz/.bz.table
32 - .ZNX/.ZNX.table (partial)
33 - EBOOT.PBP (PSP, partial)
34
35 CDDA (CD audio) support requires .cue/.bin format.
36
37 The emulator can simulate BIOS, which means BIOS files are not required,
38 however implementation is not complete and some games still need real BIOS
39 to work. To use real BIOS, copy uncompressed BIOS files to
40 [sd card]/pandora/appdata/pcsx_rearmed/bios/
41 then select the BIOS you want to use in Options->BIOS/Plugins menu.
42
43
44 Plugins
45 -------
46
47 GPU (graphics) and SPU (sound) plugins can be selected in
48 [BIOS/Plugins] menu:
49
50 builtin_gpu    - the P.E.Op.S. GPU plugin, most accurate but slow.
51 gpuPCSX4ALL.so - plugin from PCSX4ALL project. Faster but has some glitches.
52 gpuGLES.so     - experimental port of P.E.Op.S. MesaGL plugin to OpenGL ES.
53                  Occasionally faster but has lots of glitches and seems to
54                  be rather unstable (may crash the system).
55 builtin_spu    - P.E.Op.S. SPU plugin, most accurate but slow.
56 spunull.so     - NULL plugin, i.e. no sound emulation.
57
58
59 Changelog
60 ---------
61
62 r4 (2011-01-15)
63 + added real BIOS support (and various things for it to work)
64 * fixed various recompiler issues
65 + added interpreter option (useful to overcome dynarec bugs)
66 * fixed some memory card related issues with HLE bios
67 * rewrote frame limiter (old was sometimes sleeping needlessly)
68
69 r3 (2011-01-05):
70 + added Pickle's port of gpu-gles from psx4m project
71 + added PCSX4ALL gpu as a plugin
72 * improved gpu plugin support
73 + added savestate preview
74 * various frontend fixes
75
76 r2 (2010-12-29):
77 * fixed memcard paths
78 * fixed a keybind copy-paste bug
79 * properly implemented pad handling
80   (inputs no longer control both emulated pads at once)
81 * fixed a crash caused by framebuffer out of range access
82 * fixed SWL/SWR handling (usually resulted in graphic glitches)
83 * fixed BxxZAL (Medal of Honor)
84 * fixed alignment crash in color space conversion code (Lunar)
85 * fixed SWC2 occasional use of wrong address register (Parasite Eve)
86 * fixed firstfile() handling in HLE BIOS (broken memory cards in some games)
87 + added per-game configs (controls still not saved though)
88 + added simple plugin select interface to the menu
89
90 r1 (2010-12-25):
91 * initial release
92
93
94 Credits / License
95 -----------------
96
97 Emulator core:
98
99 (C) 1999-2003 PCSX Team
100         (c) 1998 Vision Thing
101         Linuzappz     <linuzappz@pcsx.net>
102         Shadow        <shadow@pcsx.net>
103         Pete Bernett  <psswitch@online.de>
104         NoComp        <NoComp@mailcity.com>
105         Nik3d
106         Akumax        <akumax@pcsx.net>
107
108 (C) 2005-2009 PCSX-df Team
109         (c) Ryan Schultz <schultz.ryan@gmail.com>
110         (c) Andrew Burton <adb@iinet.net.au>
111         (c) Stephen Chao <schao@myrealbox.com>
112         (c) Marcus Comstedt <marcus@mc.pp.se>
113         Stefan Sikora <hoshy@schrauberstube.de>
114
115 (C) 2009-2010 PCSX-Reloaded Team
116         edgbla (Root counters, various core/plugin fixes)
117         Firnis (GTE code from PCSX-Revolution Project)
118         Gabriele Gorla (MDEC decoder)
119         Peter Collingbourne (Various core/psxbios fixes)
120         Dario, NeToU, siveritas (Various bugfixes)
121         shalma (GTE Divider, various core fixes)
122         Wei Mingzhi (Maintainer, input plugin, iso/cheat support, misc stuff)
123
124 PCSX4ALL GPU plugin:
125         (C) 2010 PCSX4ALL Team
126         (C) 2010 Unai
127         Franxis <franxism@gmail.com>
128         Chui <sdl_gp32@yahoo.es>
129
130 GLES plugin (psx4m project):
131         (C) 1999-2009 by Pete Bernert
132         EQ
133         Olli Hinkka
134         Proger
135         Pickle
136
137 builtin GPU/SPU plugins:
138         Pete Bernert and the P.E.Op.S. team
139
140 MIPS->ARM recompiler:
141         (C) 2009-2010 Ari64
142
143 integration, optimization and frontend:
144         (C) 2010-2011 notaz
145
146 Source code is released under GNU GPL license, version 2 or later.
147 See COPYING included in the archive (.pnd can be extracted using unsquashfs).
148 The source code is available in a GIT repository at:
149
150 git://notaz.gp2x.de/~notaz/pcsx_rearmed.git
151