frontend: add touchscreen-as-buttons input code
[pcsx_rearmed.git] / readme.txt
303ee308 1
2PCSX-ReARMed - yet another PCSX fork
c9dbba7f 4
303ee308 6
10PCSX ReARMed is yet another PCSX fork based on the PCSX-Reloaded project,
11which itself contains code from PCSX, PCSX-df and PCSX-Revolution. This
12version is ARM architecture oriented and features MIPS->ARM recompiler by
3938f69a 13Ari64, NEON GTE code and more performance improvements. It was created for
14Pandora handheld, but should be usable on other devices after some code
15adjustments (N900 version is also available).
303ee308 16
c9dbba7f 17PCSX ReARMed features GPU plugin from PCSX4ALL project.
303ee308 18
23This version features a framebuffer driven menu that can be used to run
24games and configure the emulator.
33716956 26Supported CD image formats:
f932e54b 27- .bin/.cue
28- .bin/.toc
29- .img/.ccd/.sub
30- .mdf/.mds
303ee308 31- .Z/.Z.table
33716956 32- .bz/.bz.table
33- .ZNX/.ZNX.table (partial)
34- EBOOT.PBP (PSP, partial)
bab59f00 35- .cbn
303ee308 36
7ca0ce80 37CDDA (CD audio) only supported when .cue/.toc/.ccd/.mds files are present.
900acfae 38There is support for .sbi files, which can be used instead of
39.sub files to save space (name it the same as .cue/.bin, just use .sbi
40extension). This is required for Libcrypt copy protected game support.
303ee308 41
c9dbba7f 42The emulator can simulate BIOS, which means BIOS files are not required,
43however implementation is not complete and some games still need real BIOS
44to work. To use real BIOS, copy uncompressed BIOS files to
45[sd card]/pandora/appdata/pcsx_rearmed/bios/
46then select the BIOS you want to use in Options->BIOS/Plugins menu.
799b0b87 48Analog controllers are supported using nubs, but this is disabled by
49default and needs to be enabled in 'Controls' menu.
7ca0ce80 50There is also touchscreen based GunCon support, which also requires
51appropriate controller selected in controls configuration.
799b0b87 52
303ee308 53
ee78346e 54Plugins
57GPU (graphics) and SPU (sound) plugins can be selected in
58[BIOS/Plugins] menu:
60builtin_gpu - the P.E.Op.S. GPU plugin, most accurate but slow. - plugin from PCSX4ALL project. Faster but has some glitches. - experimental port of P.E.Op.S. MesaGL plugin to OpenGL ES.
63 Occasionally faster but has lots of glitches and seems to
64 be rather unstable (may crash the system).
7ca0ce80 65builtin_spu - P.E.Op.S. SPU plugin.
ee78346e - NULL plugin, i.e. no sound emulation.
9af2e936 69Changelog
cbd45cda 72r10 (2011-10-10)
73+ added Caanoo port
74+ completely rewrote memory handlers
aaac9c7e 75+ added fixed frameskip option
cbd45cda 76+ added ability to change PSX clock
77+ implemented GTE dead flag detection
78* switched to larger timeslices for better performance
79* fixed some cases of flickering
aaac9c7e 80* fixed a crash in PCSX4ALL GPU plugin
81* fixed several dynarec compatibility related issues (hopefully)
cbd45cda 82* fixed multiple SPU regressions from r9 and earlier
aaac9c7e 83* fixed frame limiter issue that sometimes caused stuttering
84* fixed some minor GUI issues
7ca0ce80 86r9 (2011-08-13)
87* fixed various dynarec integration issues that were causing instability
88* merged latest Ari64 dynarec code for some performance improvement
89* changed frameskip handling in builtin and PCSX4ALL plugins,
90 fixes some cases where it would not work
91* merged PCSX4ALL 2.2 GPU code to it's plugin
92* fixed PCSX4ALL GPU inline asm, was miscompiling for ARMv7.
93+ added CDDA handling for eboot format
94* improved CDDA handling for all image formats that support it
95* various compatibility/accuracy improvements
96* optimized PEOPS SPU core
97* various menu adjustments
98* changed scaling options a bit, there are now two 4:3 options:
99 integer and fractional
100+ added some basic memory card manager, which allows to change
101 or remove cards (remove needed for Tenka)
102+ added GunCon support
103+ added gpuPEOPS2 plugin (peops rendering + new emulation code)
3938f69a 105r8 (2011-03-22)
106* improved recompiler performance for some games
107* fixed a few recompiler related compatibility issues
108 (also fixes broken memcard support in some games)
109* fixed some graphics problems caused by frameskip.
110 Note that not all problems were fixed, so if you see graphics
111 glitches try turning off frameskip or using different GPU plugin.
112+ added screenshot function
113+ added some code to attempt to sync with pandora's LCD better
114* merged a few compatibility fixes from PCSX-Reloaded
115* fixed and issue with external controllers
116* added experimental ability to use nubs as buttons
900acfae 118r7 (2011-03-02)
119+ implemented most used GTE operations in NEON
120* merged latest Ari64's recompiler patches
121* removed some code from the recompiler that is unneeded for R3k
122* added some special handlers for constant reads
123* some moderate builtin GPU and SPU optimizations
124+ added SBI support
125* tuned frameskip code again
126* fixed one 'analog controller not working' issue
127* fixed a crash in builtin gpu code
128* fixed cdrom slowdown issue
129* fixed my stupid bug in the recompiler that slowed down
130 recompilation a lot
131* some other refactoring
acb57d8d 133r6 (2011-02-10)
134+ added analog controller support using nubs (disabled by default)
135+ added control config saving
136+ added support for ingame actions (eg. savestate load)
137+ added 'auto' region option and made it default
138+ added cd swap functionality
139+ added maemo frontend from Bonapart
140 (with some tuning, source code only)
141* reworked key configuration to be less confusing
142* fixed 'SPU IRQ wait' option sometimes causing noise
143 and turned it on by default
144* fixed mono xa masking (was causing noise)
145* fixed word access macros in dfxvideo (darkness problem)
146* changed GPU DMA timing back to 1.92 levels
147* backported more fixes from PCSX-Reloaded project
148 (mostly shalma's work, see GIT)
149* fixed a few more recompiler issues
150+ fixed frameskip in builtin plugin
5b09a334 152r5 (2011-01-31)
153+ added support for .bz format, also partial support for
154 .znx and eboot.pbp formats
155+ merged latest cdrom code from PCSX-Reloaded project
156* fixed remaining savestate incompatibilities between PCSX4ALL
157 and P.E.Op.S. GPU plugins
158* fixed channel disable preventing irqs in P.E.Op.S. SPU plugin
159* fixed some alignment issues
160+ added handling for branches in delay slots
161+ fixed some unexpected drops to menu
162* fixed lots of recompiler related issues (see GIT)
163+ added watchdog thread to detect emulator lockups
164* minor frontend adjustments
c9dbba7f 166r4 (2011-01-15)
167+ added real BIOS support (and various things for it to work)
168* fixed various recompiler issues
169+ added interpreter option (useful to overcome dynarec bugs)
170* fixed some memory card related issues with HLE bios
171* rewrote frame limiter (old was sometimes sleeping needlessly)
ee78346e 173r3 (2011-01-05):
174+ added Pickle's port of gpu-gles from psx4m project
175+ added PCSX4ALL gpu as a plugin
176* improved gpu plugin support
177+ added savestate preview
178* various frontend fixes
180r2 (2010-12-29):
9af2e936 181* fixed memcard paths
182* fixed a keybind copy-paste bug
183* properly implemented pad handling
ee78346e 184 (inputs no longer control both emulated pads at once)
9af2e936 185* fixed a crash caused by framebuffer out of range access
186* fixed SWL/SWR handling (usually resulted in graphic glitches)
187* fixed BxxZAL (Medal of Honor)
188* fixed alignment crash in color space conversion code (Lunar)
189* fixed SWC2 occasional use of wrong address register (Parasite Eve)
190* fixed firstfile() handling in HLE BIOS (broken memory cards in some games)
191+ added per-game configs (controls still not saved though)
192+ added simple plugin select interface to the menu
ee78346e 194r1 (2010-12-25):
9af2e936 195* initial release
303ee308 198Credits / License
f932e54b 201Emulator core:
303ee308 203(C) 1999-2003 PCSX Team
6b8a7b88 204 (c) 1998 Vision Thing
205 Linuzappz <>
206 Shadow <>
207 Pete Bernett <>
208 NoComp <>
209 Nik3d
210 Akumax <>
303ee308 212(C) 2005-2009 PCSX-df Team
6b8a7b88 213 (c) Ryan Schultz <>
214 (c) Andrew Burton <>
215 (c) Stephen Chao <>
216 (c) Marcus Comstedt <>
217 Stefan Sikora <>
900acfae 219(C) 2009-2011 PCSX-Reloaded Team
6b8a7b88 220 edgbla (Root counters, various core/plugin fixes)
900acfae 221 shalma (GTE Divider, many core improvements, sound plugin fixes)
6b8a7b88 222 Firnis (GTE code from PCSX-Revolution Project)
223 Gabriele Gorla (MDEC decoder)
6b8a7b88 224 Peter Collingbourne (Various core/psxbios fixes)
ee78346e 225 Dario, NeToU, siveritas (Various bugfixes)
6b8a7b88 226 Wei Mingzhi (Maintainer, input plugin, iso/cheat support, misc stuff)
ee78346e 228PCSX4ALL GPU plugin:
229 (C) 2010 PCSX4ALL Team
230 (C) 2010 Unai
231 Franxis <>
232 Chui <>
234GLES plugin (psx4m project):
f932e54b 235 (C) 1999-2009 by Pete Bernert
236 EQ
237 Olli Hinkka
238 Proger
239 Pickle
1775933a 241builtin GPU/SPU plugin:
242 (C) Pete Bernert and the P.E.Op.S. team
244builtin SPU plugin:
245 (C) Pete Bernert and the P.E.Op.S. team
246 (C) SPU2-X, gigaherz, Pcsx2 Development Team
247 shalma
f932e54b 248
249MIPS->ARM recompiler:
1775933a 250 (C) 2009-2011 Ari64
6b8a7b88 251
f932e54b 252integration, optimization and frontend:
253 (C) 2010-2011 notaz
303ee308 254
22d3b349 255some implementation ideas (and maybe code?) likely originated from
256MAME/smf/pSXauthor and were integrated by various people to PCSX.
303ee308 258Source code is released under GNU GPL license, version 2 or later.
259See COPYING included in the archive (.pnd can be extracted using unsquashfs).
260The source code is available in a GIT repository at: