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