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, 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) support requires .cue/.bin format.
  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
  50
  51 Plugins
  52 -------
  53
  54 GPU (graphics) and SPU (sound) plugins can be selected in
  55 [BIOS/Plugins] menu:
  56
  57 builtin_gpu    - the P.E.Op.S. GPU plugin, most accurate but slow.
  58 gpuPCSX4ALL.so - plugin from PCSX4ALL project. Faster but has some glitches.
  59 gpuGLES.so     - experimental port of P.E.Op.S. MesaGL plugin to OpenGL ES.
  60                  Occasionally faster but has lots of glitches and seems to
  61                  be rather unstable (may crash the system).
  62 builtin_spu    - P.E.Op.S. SPU plugin, most accurate but slow.
  63 spunull.so     - NULL plugin, i.e. no sound emulation.
  64
  65
  66 Changelog
  67 ---------
  68
  69 r8 (2011-03-22)
  70 * improved recompiler performance for some games
  71 * fixed a few recompiler related compatibility issues
  72   (also fixes broken memcard support in some games)
  73 * fixed some graphics problems caused by frameskip.
  74   Note that not all problems were fixed, so if you see graphics
  75   glitches try turning off frameskip or using different GPU plugin.
  76 + added screenshot function
  77 + added some code to attempt to sync with pandora's LCD better
  78 * merged a few compatibility fixes from PCSX-Reloaded
  79 * fixed and issue with external controllers
  80 * added experimental ability to use nubs as buttons
  81
  82 r7 (2011-03-02)
  83 + implemented most used GTE operations in NEON
  84 * merged latest Ari64's recompiler patches
  85 * removed some code from the recompiler that is unneeded for R3k
  86 * added some special handlers for constant reads
  87 * some moderate builtin GPU and SPU optimizations
  88 + added redump.org SBI support
  89 * tuned frameskip code again
  90 * fixed one 'analog controller not working' issue
  91 * fixed a crash in builtin gpu code
  92 * fixed cdrom slowdown issue
  93 * fixed my stupid bug in the recompiler that slowed down
  94   recompilation a lot
  95 * some other refactoring
  96
  97 r6 (2011-02-10)
  98 + added analog controller support using nubs (disabled by default)
  99 + added control config saving
 100 + added support for ingame actions (eg. savestate load)
 101 + added 'auto' region option and made it default
 102 + added cd swap functionality
 103 + added maemo frontend from Bonapart
 104   (with some tuning, source code only)
 105 * reworked key configuration to be less confusing
 106 * fixed 'SPU IRQ wait' option sometimes causing noise
 107   and turned it on by default
 108 * fixed mono xa masking (was causing noise)
 109 * fixed word access macros in dfxvideo (darkness problem)
 110 * changed GPU DMA timing back to 1.92 levels
 111 * backported more fixes from PCSX-Reloaded project
 112   (mostly shalma's work, see GIT)
 113 * fixed a few more recompiler issues
 114 + fixed frameskip in builtin plugin
 115
 116 r5 (2011-01-31)
 117 + added support for .bz format, also partial support for
 118   .znx and eboot.pbp formats
 119 + merged latest cdrom code from PCSX-Reloaded project
 120 * fixed remaining savestate incompatibilities between PCSX4ALL
 121   and P.E.Op.S. GPU plugins
 122 * fixed channel disable preventing irqs in P.E.Op.S. SPU plugin
 123 * fixed some alignment issues
 124 + added handling for branches in delay slots
 125 + fixed some unexpected drops to menu
 126 * fixed lots of recompiler related issues (see GIT)
 127 + added watchdog thread to detect emulator lockups
 128 * minor frontend adjustments
 129
 130 r4 (2011-01-15)
 131 + added real BIOS support (and various things for it to work)
 132 * fixed various recompiler issues
 133 + added interpreter option (useful to overcome dynarec bugs)
 134 * fixed some memory card related issues with HLE bios
 135 * rewrote frame limiter (old was sometimes sleeping needlessly)
 136
 137 r3 (2011-01-05):
 138 + added Pickle's port of gpu-gles from psx4m project
 139 + added PCSX4ALL gpu as a plugin
 140 * improved gpu plugin support
 141 + added savestate preview
 142 * various frontend fixes
 143
 144 r2 (2010-12-29):
 145 * fixed memcard paths
 146 * fixed a keybind copy-paste bug
 147 * properly implemented pad handling
 148   (inputs no longer control both emulated pads at once)
 149 * fixed a crash caused by framebuffer out of range access
 150 * fixed SWL/SWR handling (usually resulted in graphic glitches)
 151 * fixed BxxZAL (Medal of Honor)
 152 * fixed alignment crash in color space conversion code (Lunar)
 153 * fixed SWC2 occasional use of wrong address register (Parasite Eve)
 154 * fixed firstfile() handling in HLE BIOS (broken memory cards in some games)
 155 + added per-game configs (controls still not saved though)
 156 + added simple plugin select interface to the menu
 157
 158 r1 (2010-12-25):
 159 * initial release
 160
 161
 162 Credits / License
 163 -----------------
 164
 165 Emulator core:
 166
 167 (C) 1999-2003 PCSX Team
 168         (c) 1998 Vision Thing
 169         Linuzappz     <linuzappz@pcsx.net>
 170         Shadow        <shadow@pcsx.net>
 171         Pete Bernett  <psswitch@online.de>
 172         NoComp        <NoComp@mailcity.com>
 173         Nik3d
 174         Akumax        <akumax@pcsx.net>
 175
 176 (C) 2005-2009 PCSX-df Team
 177         (c) Ryan Schultz <schultz.ryan@gmail.com>
 178         (c) Andrew Burton <adb@iinet.net.au>
 179         (c) Stephen Chao <schao@myrealbox.com>
 180         (c) Marcus Comstedt <marcus@mc.pp.se>
 181         Stefan Sikora <hoshy@schrauberstube.de>
 182
 183 (C) 2009-2011 PCSX-Reloaded Team
 184         edgbla (Root counters, various core/plugin fixes)
 185         shalma (GTE Divider, many core improvements, sound plugin fixes)
 186         Firnis (GTE code from PCSX-Revolution Project)
 187         Gabriele Gorla (MDEC decoder)
 188         Peter Collingbourne (Various core/psxbios fixes)
 189         Dario, NeToU, siveritas (Various bugfixes)
 190         Wei Mingzhi (Maintainer, input plugin, iso/cheat support, misc stuff)
 191
 192 PCSX4ALL GPU plugin:
 193         (C) 2010 PCSX4ALL Team
 194         (C) 2010 Unai
 195         Franxis <franxism@gmail.com>
 196         Chui <sdl_gp32@yahoo.es>
 197
 198 GLES plugin (psx4m project):
 199         (C) 1999-2009 by Pete Bernert
 200         EQ
 201         Olli Hinkka
 202         Proger
 203         Pickle
 204
 205 builtin GPU/SPU plugins:
 206         Pete Bernert and the P.E.Op.S. team
 207
 208 MIPS->ARM recompiler:
 209         (C) 2009-2010 Ari64
 210
 211 integration, optimization and frontend:
 212         (C) 2010-2011 notaz
 213
 214 Source code is released under GNU GPL license, version 2 or later.
 215 See COPYING included in the archive (.pnd can be extracted using unsquashfs).
 216 The source code is available in a GIT repository at:
 217
 218 git://notaz.gp2x.de/~notaz/pcsx_rearmed.git
 219