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