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