home *** CD-ROM | disk | FTP | other *** search
/ Freesoft 1999 February / Freesoft_1999-02_cd.bin / Recenz / Emulator / PSX / Pex / PEX.DOC < prev    next >
Text File  |  1998-02-02  |  9KB  |  179 lines
  1. /****************************************************************************/
  2. /* pex.doc v0.01                                                            */
  3. /* the documentation for pex.                                               */
  4. /* Geoffrey Wossum (aka Maxon)                                              */
  5. /****************************************************************************/
  6.  
  7. ;****************************************************************************
  8. ;* contents                                                                 *
  9. ;****************************************************************************
  10. 1)  what is pex?
  11. 2)  what do I need to run pex?
  12. 3)  how do I setup pex?
  13. 4)  how do I use pex?
  14. 5)  troubleshooting.
  15. 6)  greets.
  16. 7)  contact.
  17. 8)  legal stuff.
  18.  
  19. //////////////////////////////////////////////////////////////////////////////
  20. // what is pex?
  21. //////////////////////////////////////////////////////////////////////////////
  22. pex is an emulator so that you can play Sony Playstation games on your PC.
  23. It has been coded by Geoffrey Wossum (aka Maxon).  For a detailed list of those
  24. who helped, go to the greets section.
  25.  
  26. //////////////////////////////////////////////////////////////////////////////
  27. // what do I need to run pex?
  28. //////////////////////////////////////////////////////////////////////////////
  29. Since it is still in an early alpha state, the final system requirements aren't
  30. quite clear.  However, I have a rough idea what its going to take.
  31.  
  32. expected system requirements for fully working pex -
  33.     - Intel Pentium 166 or faster (GenuineIntel recommended, much mathco use
  34.         forseen)
  35.     - 16megs of RAM.
  36.     - About a meg of hard drive space to install pex.
  37.     - CD-ROM drive.
  38.     - FAST 3d graphics card (3Dfx Voodoo, nVidia Riva128, TriTech Pyramid).
  39.     - MS-DOS operating system (Win95 DOS mode [not box] should work fine.)
  40.     - MSCDEX 2.1 or newer.
  41.     - optional : SoundBlaster or compatible soundcard or any Gravis Ultrasound
  42.         series soundcard.
  43.  
  44. system requirements for this non-fully working pex -
  45.     - Pentium class or better.
  46.     - 8megs of RAM?
  47.     - About a meg of hard drive space to install pex.
  48.     - CD-ROM drive.
  49.     - MS-DOS operating system (Win95 DOS mode [not box] should work fine.)
  50.     - MSCDEX 2.1 or newer.
  51.     - optional : SoundBlaster or compatible soundcard or any Gravis Ultrasound
  52.         series soundcard.
  53.  
  54. //////////////////////////////////////////////////////////////////////////////
  55. // how do I setup pex?
  56. //////////////////////////////////////////////////////////////////////////////
  57. Thank you for taking the time to read this!  Hopefully you'll continue on, yes?
  58.  
  59. Make yourself a directory on your hard disk, lets say "pex".  Then unzip the
  60. pex zipfile into that directory.
  61.  
  62. Next, you'll need to obtain a copy of the Playstation ROM from somewhere.
  63. DO NOT EMAIL ME FOR THIS!  I WILL NOT GIVE IT TO YOU!
  64. Remember, you can not legally have a copy of the ROM unless you own a
  65. Playstation.
  66.  
  67. Now that you have the ROM image, put it into the pex directory.  pex will
  68. search it's directory for the following files (in this order) :
  69.         SCPH1000.BIN
  70.         SCPH5000.BIN
  71.         SCPH5500.BIN
  72.         DTLH3000.BIN
  73.         PSX.ROM
  74. The rom image must be named one of those names.
  75.  
  76. Now run pex by going to the pex directory and running pex.  pex should set
  77. itself up automatically.  If anything does go wrong with pex setting itself up
  78. or you don't like the way pex has set itself up, you can run pex with the
  79. "/config" command line switch to manually configure it.  This should not be
  80. necessary, however.  The only setup is the sound card settings, and the CD-ROM
  81. drive (if you have more than one in your system).
  82.  
  83. example :
  84. md pex
  85. cd pex
  86. pkunzip \netdown\pexd001b
  87. pkunzip \netdown\scph1000
  88. pex
  89.  
  90. In order to get this version of pex to do anything slightly interesting,
  91. use the "/debug" switch.
  92.  
  93. //////////////////////////////////////////////////////////////////////////////
  94. // how do I use pex?
  95. //////////////////////////////////////////////////////////////////////////////
  96. With more fully working versions of pex, you'll just pop a psx cd into your
  97. cdrom, run pex, and play the game.
  98.  
  99. This, however, is not a fully working of pex.  If you'd try that, pex will just
  100. think for a few seconds, and then quit with a greet screen or something.  In
  101. order to get this version of pex to do anything interesting, you must run it
  102. with the "/debug" switch.  This will put pex into debug.  In debug mode, it
  103. will create a log file called "pex.log".  It will also start the debugger.
  104. I don't feel like explaining how to use the debugger right now.  If your lucky
  105. I have by the time this gets released, but I if I haven't...  Anyway, if you
  106. have any business using a debugger, it'll be pretty much self-explanatory to
  107. you.
  108.  
  109. *** A NOTE ***
  110. It looks like pex doesn't run the delay slots at all.  This is because pex
  111. considers a branch and its delay slot to be one instruction.  Therefore, when
  112. it runs the branch, it executes the delay slot at the same time.  The actual
  113. error in the delay slots is that the delay slot is executed twice when the
  114. branch is not taken.  Note the likely branch instructions are handled correctly,
  115. I think.
  116.  
  117. //////////////////////////////////////////////////////////////////////////////
  118. // troubleshooting.
  119. //////////////////////////////////////////////////////////////////////////////
  120. If pex does something weird, "Don't panic" (Douglas Adams.  _Hitchhikers guide
  121. to the galaxy._  p.3).  If pex actually locks up or crashes take the following
  122. advice first.
  123.  
  124. 1)  Read the BUGS.TXT for a list of known bugs.  See if your problem is in
  125.     known bugs.  If it is, your SOL until the next version.  If it isn't,
  126.     take the following advice.
  127. 2)  Did you tell the debugger to "Run" the code?  bad idea.
  128. 3)  Are you running Win95?  If you are, be sure you are running in DOS mode, not
  129.     a DOS box.  I will not tell you how to do this.
  130. 4)  Try removing all but necessary TSR's (cd driver, MSCDEX, sound card driver).
  131.     Especially remove memory managers (QEMM sucks!).  pex does not need them
  132.     because it uses PMODE/W, plus they degrade system performance and can cause
  133.     strange errors.
  134. 5)  Try running pex with the "/config" switch.  Perhaps MIDAS set up the sound
  135.     card wrong.
  136. 6)  If you were tracing code, there's probably a problem in the re-compiled
  137.     code, better contact me with more info.
  138.  
  139. If you can't figure out why your getting an error, (or if you know why),
  140. fill out the "TROUBLE.FRM" in this zipfile and email it to me at
  141. "gpw0341@omega.uta.edu", with the title "pex error report".
  142.  
  143. If you know what your doing and find errors in the way pex runs R3000 code,
  144. or any other technical thing, it'd be great if you could help me out and tell
  145. me what you've found.
  146.  
  147. //////////////////////////////////////////////////////////////////////////////
  148. // greets.
  149. //////////////////////////////////////////////////////////////////////////////
  150. greets go out the following -
  151. Mario Rodriguez - when can we say a beta of Atlaânt?
  152. Duddie - good luck with PSemu.
  153. Shawn McIntire - great web page, good luck with virtual.yarouze.
  154. Mercury Boy - thanks for the tips.
  155. Tran and Daredevil - PMODE/W rocks!
  156. Sahara Surfers - MIDAS is awesome!  I'll never write my own .mod play again.
  157.  
  158. //////////////////////////////////////////////////////////////////////////////
  159. // contact.
  160. //////////////////////////////////////////////////////////////////////////////
  161. email - gpw0341@omega.uta.edu
  162.  
  163. web - http://www.fastlane.net/~gpwossum
  164.  
  165. //////////////////////////////////////////////////////////////////////////////
  166. // legal stuff.
  167. //////////////////////////////////////////////////////////////////////////////
  168. pex is intended for entermainment use only.
  169. any damage caused by pex to your computer, data, business, personal life, etc.,
  170. is purely coincidental and not the responsibity of the author, Geoffrey Wossum.
  171. pex is distributed "AS IS", and contains no warranties expressed or implied.
  172. the Sony Playstation ROM image that pex requires may only be legally possessed
  173. by those who own a Sony Playstation.
  174. The author will not distribute Playstation ROM images or Playstation games.
  175.  
  176. /****************************************************************************/
  177. /* end of pex.doc                                                           */
  178. /****************************************************************************/
  179.