The Ultimate Playstation Emulator: PSEmu v0.2.1 "beta"
(C)1997 Duddie / Vision Thing Software Group

E-mail:	    duddie@szczecin.top.pl
Homepage:   http://szczecin.top.pl/~duddie


DISCLAIMER
----------

This program is provided as is. I take no responsibility for any
damage or consequences directly or indirectly, intentionally
or unintentionally, which may arise from using this program -
	      YOU USE IT AT YOUR OWN RISK!

 EMULATION IS NOT A CRIME, EMULATION SUPPORTS COMPANIES!
		 TRY EMU - BUY CONSOLE!

   THIS IS TOTALLY FREE AND WILL BE UPDATED REGULLARY!


LICENSE
-------

* The program, parts of the program or the documentation may
  not be passed freely nor sold to third persons.
* The program nor its documentation may be altered in any way.
* By using this program, the user accepts these conditions of
  license and use.


REQUIREMENTS
------------

Hardware:
 PC 486+ (Pentium is recommended)
 SVGA Card VESA compatible
 CD-ROM
 4MB RAM (at least)
 
Software:
 MS-DOS or Windows (Windows95 is a recomended platform)
 VESA 2.0 extender (ie. Scitech Display Doctor) 
 
Additional:
 PlayStation BIOS image (SCPH1001.BIN) -> Can be found on the net
 PlayStation Game on CD-ROM
 

WARNING
-------

Due to fact that PlayStation is copyrighted by Sony if You want to use
an emulator You must possess PlayStation console.
This is caused by fact, that this emulator uses PlayStation BIOS image.


USAGE
-----

Run PSE.EXE. Put CD-ROM with PlayStation game into You CD-ROM Reader and press F1.
If You want to test another game You must start over an emulator.


DIRS:

  DEV	 - devices connected to parallel (now, You don't have to know)
  BIOS   - here reside bios images they must have names as they are
           listed in text file which is located in this dir
  SNAP   - in this directory will be make a snapshot (BMP format)
  

KEYS:

ESC     - exit
CURSORS - move cursor, move display
PGUP/DN - move display
F1      - start emulation.
F4      - take snapshot of curren screen -> read "usage.txt"
F5      - walk one instruction
F6      - skip one instruction
F7      - go fast (like F8 but without break/skip points)
F8      - go (can be interrupted by pressing any key)
SH-F8   - execute fast - go until code reach cursor position, without
          break (be carefull, You can hang Your computer due to PSX EXE can
          get into infinite loop)
F9      - toggle display: DISASM/MEMORY/ASCII
F10     - toggle display of log file "output.txt"
F11     - toggle display of registers: CPU/COP0
SH+F12  - view PSX VRAM (press again to view 2-nd part)
F12     - reset psx and set PC register to BFC00000 as MIPS do this (unstable function)
l       - load PlayStation executable into memory (You'll be asked with name
	  of it) It must reside in same directory as PSE.
L	- load binary of given name at given addres
P	- make PC to point at this place where the cursor stands (only in disasm mode)
p	- set PC manually to given value
b	- toggle breakpoint at cursor position
s	- toggle skippoint at cursor position
g	- move display to given location 
G	- move dispaly to current PC location
o	- options screen
d	- enable logging big outputs 
D	- disable all logging (default)


KEYS DURING EMULATION:

ESC	- stop emulation
CURSORS - as Cursors on Pad
S,E,D,X - Pad keys: Square, Triangle, Circle, X
1	- Pad key Start
2	- Pad key Select
Ins,Del,PgUp,PgDn - L1,L2,R1,R2
    

After setting options You have to quit and restart PSEmu.

Instruction marked as SkipPoint, will be skipped during execution.
On BreakPoint execution will be stopped. SkipPoints and BreakPoints are
ignored by Walk and Skip commands and also by execute fast.

After execution you can find two files that reside in your PSE directory:
LOG.TXT	    - logs system calls, loads, etc.
HARDLOG.TXT - logs access to HR (Hardware Registers)
OUTPUT.TXT  - logs whole output of PSX programs that is dedicated to stdout

You can now execute BIOS-SHELL but I'm sure that it will get somewhere in
infinite loop (you can stop execution by pressing any key), due to
fact that not so much HR are emulated (it plays with this stuff a lot).

In revisions 16+ You can execute startup code of bios (no shell) which gives You 
configured registers, and so on... IT IS DONE ON STARTUP BY DEFAULT!

In PSXDEV directory resides file dummy.dev - it is kinda psx device 
that actually do nothing. But as I found BIOS wants to execute init of
at least one device! Every device I will make will reside in this 
directory.



THANX AND GREETZ
----------------

* Rafu (for maintaining HomePage and getting info on this)
* Xatart (whatever it means ;) - for everything, HE KNOWS)
* Icepic!/TRSI - for HR support
* Pseudo (for promising me donation!)
* Kingpin (another donation)
* Sergio Moreira (for his great page)
* Psycho (for support)
* Lee (for an icon)
* Yoshiki Tanaka (for... he knows for...)
* Keith Mawhinney (for support)
* Shawn McIntyre (for what he do)
* Derrick Jobidon (for CD-ROM support)
* to many others that I do not remember
and last but not least to my wife Joanna (for being so patient...)


PlayStation, PlayStation Logo and Sony are registered trademarks of Sony.
