c0a59d2ec52aea09c9d0e0a56e0015c72267b926
[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 Analog controllers are supported using nubs, but this is disabled by
44 default and needs to be enabled in 'Controls' menu.
45
46
47 Plugins
48 -------
49
50 GPU (graphics) and SPU (sound) plugins can be selected in
51 [BIOS/Plugins] menu:
52
53 builtin_gpu    - the P.E.Op.S. GPU plugin, most accurate but slow.
54 gpuPCSX4ALL.so - plugin from PCSX4ALL project. Faster but has some glitches.
55 gpuGLES.so     - experimental port of P.E.Op.S. MesaGL plugin to OpenGL ES.
56                  Occasionally faster but has lots of glitches and seems to
57                  be rather unstable (may crash the system).
58 builtin_spu    - P.E.Op.S. SPU plugin, most accurate but slow.
59 spunull.so     - NULL plugin, i.e. no sound emulation.
60
61
62 Changelog
63 ---------
64
65 r5 (2011-01-31)
66 + added support for .bz format, also partial support for
67   .znx and eboot.pbp formats
68 + merged latest cdrom code from PCSX-Reloaded project
69 * fixed remaining savestate incompatibilities between PCSX4ALL
70   and P.E.Op.S. GPU plugins
71 * fixed channel disable preventing irqs in P.E.Op.S. SPU plugin
72 * fixed some alignment issues
73 + added handling for branches in delay slots
74 + fixed some unexpected drops to menu
75 * fixed lots of recompiler related issues (see GIT)
76 + added watchdog thread to detect emulator lockups
77 * minor frontend adjustments
78
79 r4 (2011-01-15)
80 + added real BIOS support (and various things for it to work)
81 * fixed various recompiler issues
82 + added interpreter option (useful to overcome dynarec bugs)
83 * fixed some memory card related issues with HLE bios
84 * rewrote frame limiter (old was sometimes sleeping needlessly)
85
86 r3 (2011-01-05):
87 + added Pickle's port of gpu-gles from psx4m project
88 + added PCSX4ALL gpu as a plugin
89 * improved gpu plugin support
90 + added savestate preview
91 * various frontend fixes
92
93 r2 (2010-12-29):
94 * fixed memcard paths
95 * fixed a keybind copy-paste bug
96 * properly implemented pad handling
97   (inputs no longer control both emulated pads at once)
98 * fixed a crash caused by framebuffer out of range access
99 * fixed SWL/SWR handling (usually resulted in graphic glitches)
100 * fixed BxxZAL (Medal of Honor)
101 * fixed alignment crash in color space conversion code (Lunar)
102 * fixed SWC2 occasional use of wrong address register (Parasite Eve)
103 * fixed firstfile() handling in HLE BIOS (broken memory cards in some games)
104 + added per-game configs (controls still not saved though)
105 + added simple plugin select interface to the menu
106
107 r1 (2010-12-25):
108 * initial release
109
110
111 Credits / License
112 -----------------
113
114 Emulator core:
115
116 (C) 1999-2003 PCSX Team
117         (c) 1998 Vision Thing
118         Linuzappz     <linuzappz@pcsx.net>
119         Shadow        <shadow@pcsx.net>
120         Pete Bernett  <psswitch@online.de>
121         NoComp        <NoComp@mailcity.com>
122         Nik3d
123         Akumax        <akumax@pcsx.net>
124
125 (C) 2005-2009 PCSX-df Team
126         (c) Ryan Schultz <schultz.ryan@gmail.com>
127         (c) Andrew Burton <adb@iinet.net.au>
128         (c) Stephen Chao <schao@myrealbox.com>
129         (c) Marcus Comstedt <marcus@mc.pp.se>
130         Stefan Sikora <hoshy@schrauberstube.de>
131
132 (C) 2009-2010 PCSX-Reloaded Team
133         edgbla (Root counters, various core/plugin fixes)
134         Firnis (GTE code from PCSX-Revolution Project)
135         Gabriele Gorla (MDEC decoder)
136         Peter Collingbourne (Various core/psxbios fixes)
137         Dario, NeToU, siveritas (Various bugfixes)
138         shalma (GTE Divider, various core fixes)
139         Wei Mingzhi (Maintainer, input plugin, iso/cheat support, misc stuff)
140
141 PCSX4ALL GPU plugin:
142         (C) 2010 PCSX4ALL Team
143         (C) 2010 Unai
144         Franxis <franxism@gmail.com>
145         Chui <sdl_gp32@yahoo.es>
146
147 GLES plugin (psx4m project):
148         (C) 1999-2009 by Pete Bernert
149         EQ
150         Olli Hinkka
151         Proger
152         Pickle
153
154 builtin GPU/SPU plugins:
155         Pete Bernert and the P.E.Op.S. team
156
157 MIPS->ARM recompiler:
158         (C) 2009-2010 Ari64
159
160 integration, optimization and frontend:
161         (C) 2010-2011 notaz
162
163 Source code is released under GNU GPL license, version 2 or later.
164 See COPYING included in the archive (.pnd can be extracted using unsquashfs).
165 The source code is available in a GIT repository at:
166
167 git://notaz.gp2x.de/~notaz/pcsx_rearmed.git
168