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