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