
==============================================================================================
PCSX4ALL 2.2 (10 de abril de 2011) por Franxis (franxism@gmail.com) y Chui (sdl_gp32@yahoo.es)
==============================================================================================


1. INTRODUCCIN
---------------

PCSX4ALL es un emulador de PSOne (PSX) para la consolas porttiles WIZ/CAANOO de GPH.
Se trata de un port del emulador PCSX Reloaded.
Para ver la licencia GPL mira el final de este documento (captulo 14).

Las pginas oficiales de este proyecto (con noticias, informacin adicional y donaciones) es:
http://chui.dcemu.co.uk/
http://franxis.zxq.net/


2. CONTROLES
------------

Los controles son los siguientes:
- Joystick: Movimiento del pad.
- B,X,A,Y,L,R,SELECT+L  I+L,SELECT+R  I+R: Botones Crculo,X,Cuadrado,Tringulo,L,R,L2,R2.
- SELECT  I: Botn SELECT.
- MENU  II: Botn START.
- L+R+START  HOME: Salir al men de seleccin de juegos (despus L+R  HOME en el men para salir).
- L+R+SELECT  L+R+I: Mostrar FPS.
- VolUp and VolDown: Incrementar / decrementar el volumen.
- SELECT+VolDown  I+L: Cargar save-state.
- SELECT+VolUp  I+R: Salvar save-state.


3. OPCIONES DEL EMULADOR
------------------------

- WIZ/CAANOO Clock:
Se puede seleccionar frecuencias de 200 a 900 MHz. El rendimiento del emulador es mejor a frecuencias ms altas.
533 MHz es la frecuencia estndar. 700 MHz parece funcionar ok con cualquier WIZ (pero la duracin de las pilas se reduce).
Usa frecuencias ms altas bajo tu propia responsabilidad!

- RAM Tweaks:
ON: Se activan los tweaks de la RAM para ganar ms rendimiento. Algunas consolas presentan problemas con esta opcin. Recomendado en WIZ.
OFF: Se desactiva los tweaks de la RAM para asegurar el funcionamiento en cualquier consola. Recomendado en CAANOO.

- Frame-Limit:
ON: Limitador de frames habilitado.
OFF: Limitador de frames deshabilitado.

- Frame-Skip:
0 to 11: Ajustar frame-skip.
Video: El frame-skip se ajusta en funcin de la velocidad de refresco de video (NTSC=60 Hz o PAL=50 Hz).
Game: El frame-skip se ajusta en funcin del frame-rate del juego (dependiente del juego).

- Interlace:
OFF: Entrelazado de video desactivado.
Simple: Entrelazado simple (slo se muestran la mitad de las lneas).
Progressive: Entrelazado progresivo (las lneas pares e impares se muestran alternativamente).

- Sound:
OFF: Sonido desactivado.
ON (basic): Sonido habilitado (slo FM y WAVE).
ON (XA): Sonido extra habilitado (XA-Audio).
ON (CD-Audio): Sonido extra habilitado (CD-Audio).
ON (XA+CD-Audio): Sonido extra habilitado (XA-Audio y CD-Audio).

- CPU Clock:
La velocidad de la CPU emulada se puede ajustar entre 10% y 200%. El valor nominal es 100% y la CPU se emula con ms exactitud.
Usa valores ms bajos para ganar rendimiento.
Tambin se pueden usar valores ms altos hasta un 200% para evitar ralentizaciones en algunos juegos.

- CPU BIAS:
Auto: El multiplicador de ciclos de CPU se ajusta automticamente.
1..16: El multiplicador de ciclos de CPU se ajusta manualmente.
3 es un valor bueno para la mayor parte de los juegos, pero el valor ms ptimo depende de cada juego.
4 puede usarse en algunos juegos 2D para ganar velocidad.
Los valores ms altos son ms rpidos porque se hace underclock de la CPU, pero si el juego necesita mucha CPU el juego se ralentizar.
Los valores ms bajos son ms lentos pero pueden ser requeridos por algunos juegos.

- CPU Core:
HLE: El modo ms rpido. El recompilador esta habilitado con emulacin de BIOS.
HLE-Secure: Ms lento pero ms compatible (ejemplo: Castlevania SOTN  Final Fantasy VII lo necesitan para funcionar).
BIOS: Ms lento que HLE pero ms compatible. Es necesaria una copia de la BIOS de la PSX (scph1001.bin).
HLE (Interpreter): Se utiliza el intrprete (ms lento que el recompilador) con emulacin BIOS (HLE).
BIOS (Interpreter): Se utiliza el intrprete junto con una copia de la BIOS de la PSX (scph1001.bin).
NOTE: Los modos BIOS necesitan una copia de la BIOS de la PSX (scph1001.bin) colocada en el mismo directorio del emulador.
Es necesario para jugar a juegos como Cotton 100%  Bubble Bobble 2 con sonido. Tambin es necesario con otros juegos
debido a fallos en la emulacin de la BIOS mediante HLE (tarjetas de memoria, temporizacin del sonido en PAL, etc.).

- GPU Type:
Software: GPU por software con todas sus caractersticas habilitadas.
No Light: Desactivar iluminacin para ganar velocidad. Puede provocar errores grficos en los juegos.
No Blend: Desactivar blending para ganar velocidad. Puede provocar errores grficos en los juegos.
No Light+Blend: Desactivar iluminacin y blending. Puede provocar errores grficos en los juegos.

- Auto-Save:
OFF: El modo de auto-guardado est desactivado.
ON: El estado del juego se carga automticamente al comenzar y se graba al salir.

- Game Fixes:
Sio Irq Always Enabled
Spu Irq Always Enabled
Parasite Eve 2, Vandal Hearts 1/2 fix
InuYasha Sengoku Battle fix
Abbe's Odyssey fix


4. INSTALACIN
--------------

autorun.gpu         -> Script de auto-run
mcd001.mcr          -> Memory-card #1
mcd002.mcr          -> Memory-card #2
pcsx4all.gpe        -> Script de seleccin automtica WIZ/CAANOO
pcsx4all_wiz.gpe    -> Men de seleccin de juegos (WIZ)
pcsx4all_wiz        -> Ejecutable del emulador (WIZ)
pcsx4all_caanoo.gpe -> Men de seleccin de juegos (CAANOO)
pcsx4all_caanoo     -> Ejecutable del emulador (CAANOO)
scph1001.bin        -> Copia de la BIOS de la PSX (no incluida)
warm_2.6.24.ko      -> MMU Hack Kernel Module
conf/               -> Ficheros de configuracin
exec/               -> Directorio de ejecutables PSX
isos/               -> Directorio de ISOs PSX
save/               -> Directorio para los save-states


5. SOPORTE DE JUEGOS
--------------------

- Los siguientes formatos de ISOs estn soportados: iso, bin, bin+cue, bin+toc, img+ccd, mdf+mds, img+sub.
- Las extensiones de las ISOs deben de estar en minsculas!
- No borres los ficheros cue, toc, ccd, mds o sub, son necesarios para el soporte de CD-Audio.
- Los formatos ISO comprimidos todava no estn soportados!
- Adicionalmente los ejecutables PSX tambin estn soportados.


6. CREDITOS ORIGINALES
----------------------

- http://www.pcsx.net/ : PCSX creado por linuzappz, shadow, Nocomp, Pete Bernett, nik3d y AkumaX.
- http://pcsx-df.sourceforge.net/ : PCSX-df por Ryan Schultz, Andrew Burton, Stephen Chao, Marcus Comstedt y Stefan Sikora.
- http://www.pcsx.net/ : PCSX-Reloaded por Wei Mingzhi y edgbla.
- http://mamedev.org/ : Ingeniera inversa para el divisor GTE por pSXAuthor para MAME.
- http://www.dosbox.com/ : ARMv4 backend por M-HT para DOSBox.
- http://github.com/zodttd/psx4all : GPU por Unai para PSX4ALL.
- http://www.zlib.net/ : ZLIB por Jean-loup Gailly y Mark Adler.


7. CREDITOS DEL PORT
--------------------

- Port a GPH WIZ/CAANOO por Franxis (franxism@gmail.com) y Chui (sdl_gp32@yahoo.es).
- Recompilador ARM basado en el de PCSX para x86 por Franxis y Chui.
- GTE optimizado en ensamblador ARMv5 por Franxis y Chui.
- SPU y PAD por Franxis (SPU: 22 KHz mono con CD-Audio asncrono, PAD: modelo SCPH-1010).
- Beta testing por Anarchy, nintiendo1, Rivroner, buba-ho-tep y Zenzuke.
- Artwork por Zenzuke.


8. DESARROLLO
-------------

10 de abril de 2011:
- Versin 2.2. Corregido fallo en el limitador de frames.

9 de abril de 2011:
- Versin 2.1. Aadido soporte para TV-Out en la WIZ. Optimizaciones y mejoras de compatibilidad en HLE, GPU y SPU.

29 de diciembre de 2010:
- Versin 2.0. Aadido port para CAANOO. Diversas mejoras (Auto-BIAS y deteccin de idle-loop por ejemplo).

31 de julio de 2010:
- Versin 1.0. Primera versin para la competicin de programacin 2010 de gp32spain.com.

Desarrollado con:
- DevKitGP2X rc2 (http://sourceforge.net/project/showfiles.php?group_id=114505)
- Sourcery G++ Lite 2006q1-6 (http://www.codesourcery.com/sgpp/lite/arm/portal/release293)
- GpBinConv por Aquafish (www.multimania.com/illusionstudio/aquafish/)


9. PROBLEMAS CONOCIDOS
----------------------

- No compatible con muchos juegos.
- Funcionan lentos muchos juegos.


10. A MEJORAR
-------------

- OpenGL-ES GPU.
- GTE ms rpido.
- Recompilador ms rpido.
- Ganar compatibilidad.


11. GRACIAS A
-------------

- Gamepark Holdings: Gracias por lanzar la consola GP2X, y tambin por proporcionarme una unidad de desarrollo
  varias semanas antes de su lanzamiento oficial por mediacin de Anarchy (gp32spain.com).
  Tambin por lanza la consola WIZ y por envirnosla a travs de EvilDragon (gp32x.de).
  Finalmente por lanzar la consola CAANOO y envirnosla.
- Puck2099: Gracias por la librera Pico e informacin sobre la WIZ.
- Orkie: Gracias por la librera Castor y la informacin sobre la WIZ.
- Notaz: Gracias por el MMU Hack kernel module para la WIZ.


12. PAGINAS INTERESANTES SOBRE EMULACIN PSX
--------------------------------------------

- http://www.pcsx.net/
- http://pcsxr.codeplex.com/
- http://pcsx-df.sourceforge.net/
- http://code.google.com/p/pcsx-revolution/
- http://github.com/smokku/psx4m


13. OTRAS PGINAS INTERESANTES
------------------------------

- http://www.talfi.net
- http://www.gp32spain.com
- http://www.gp32x.com
- http://www.emulatronia.com
- http://www.emulation64.com


14. LICENCIA GPL
----------------

Copyright (C) 2010 PCSX4ALL Team
Copyright (C) 2010 Franxis (franxism@gmail.com)
Copyright (C) 2010 Chui (sdl_gp32@yahoo.es)

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the
Free Software Foundation, Inc.,
51 Franklin Street, Fifth Floor, Boston, MA 02111-1307 USA.


15. COMPILACIN
---------------

Compilar ejecutable para WIZ: DevKitGP2X rc2 (http://sourceforge.net/project/showfiles.php?group_id=114505)
make -f Makefile.wiz clean
make -f Makefile.wiz

NOTA: Para compilar ejecutable para WIZ es necesario modificar los siguientes dos ficheros de DevKitGP2X manualmente:
devkitGP2X\sysroot\usr\lib\libm.so:
/* GNU ld script
   Use the shared library, but some functions are only in
   the static library, so try that secondarily.  */
OUTPUT_FORMAT(elf32-littlearm)
GROUP ( /lib/libm.so.6 )
devkitGP2X\sysroot\usr\lib\libpthread.so:
/* GNU ld script
   Use the shared library, but some functions are only in
   the static library, so try that secondarily.  */
OUTPUT_FORMAT(elf32-littlearm)
GROUP ( /lib/libpthread.so.0 )

Compilar ejecutable para CAANOO: Sourcery G++ Lite 2006q1-6 (http://www.codesourcery.com/sgpp/lite/arm/portal/release293)
make -f Makefile.caanoo clean
make -f Makefile.caanoo
