home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / pocketbk / developmen / s3aemt / README.TXT < prev   
Text File  |  1994-11-08  |  7KB  |  169 lines
  1.                       README.TXT for S3aEMUL.EXE
  2.                       ==========================
  3.  
  4. This file explains how to run the program S3AEMUL.EXE, which provides
  5. an emulation of Psion's S3a software on sufficiently powerful PCs.
  6.  
  7. Files in the emulator:
  8. ----------------------
  9. S3AEMUL is distributed in the form of a .ZIP file containing the
  10. following files:
  11.  
  12.     readme.txt          this documentation file
  13.     licence.txt         user licence agreement
  14.     s3aemul.exe         the emulator top level
  15.     epoc.dll            used by the emulator (contains EPOC)
  16.     epoc.rmi            used by the emulator (rest of OS and APPS)
  17.     hhserver.par        configures the emulator
  18.     rtm.exe             run-time support
  19.     dpmi16bi.ovl        run-time support
  20.  
  21. Licence agreement - important
  22. -----------------------------
  23. Note: before using this software, you must read and agree with the
  24. terms of the accompanying file LICENCE.TXT.
  25.  
  26. Intended purpose
  27. ----------------
  28. Note: the intended purpose of S3AEMUL is as an unsupported tool for
  29. software developers.  Treat it with the caution you would normally
  30. accord to unsupported software development tools - be sure to have
  31. backups of any data on your PC, before using S3AEMUL.
  32.  
  33. That said, it has been the experience of developers who have already
  34. used S3AEMUL that no significant data loss has resulted from the use
  35. of this tool.
  36.  
  37. However, Psion cannot offer any warranties or guarantees on this
  38. point.  In particular, users are warned not to try running S3AEMUL
  39. from inside Windows, OS/2, or Windows NT.
  40.  
  41. Installation of the software
  42. ----------------------------
  43. You should copy the following files into the same directory on your
  44. PC: s3aemul.exe, epoc.dll, epoc.rmi, hhserver.par, rtm.exe, and
  45. dpmi16bi.ovl.
  46.  
  47. Rename S3aEMUL.EXE if you like, but don't rename any other file.
  48.  
  49. Limitations of the emulator:
  50. ----------------------------
  51.     You must be running a 386 (at least) PC.
  52.     You must have at least 4MB ram.
  53.     Only VGA graphics support.
  54.     S3aEMUL will not run in a DOS box in Windows (it will "violate
  55. Windows system integrity").
  56.     S3aEMUL will not run under Windows NT or O/S 2.
  57.  
  58. To run the emulator:
  59. --------------------
  60. Go to the directory including S3aEMUL.EXE and type "S3aEMUL".
  61.  
  62. NB The emulator will behave oddly if it cannot find an M:.
  63. So be sure that one is available (create one using SUBST if you need
  64. to), although there doesn't have to be anything special in it.
  65. (See below for notes on the DOS SUBST command.)
  66.  
  67. To exit the emulator:
  68. ---------------------
  69. Press and hold down Ctrl-Alt-Esc simultaneously.
  70. Or execute a program (IMG or OPO) that calls HwExit (call($168e)).
  71.  
  72. **** Ctrl-Alt-Z is an alternative to Ctrl-Alt-Esc.
  73.  
  74. When the emulator exits:
  75. ------------------------
  76. The message "Fatal application error 00" will be displayed.
  77. This is perfectly normal (no error has, in fact, occurred).
  78.  
  79. Other fatal application errors:
  80. -------------------------------
  81. These almost invariably mean that insufficient ram was available.
  82. For example, ram allocated to a ram drive is inaccessible to S3aEMUL.
  83.  
  84. Special keys inside the emulator:
  85. ---------------------------------
  86. F1 is System, F2 Data, ..., F8 Sheet, F9 Menu, F10 Help, F12 Diamond
  87. F11 simulates the machine being switched off then on (only has any
  88. effect when a password is set).
  89. Alt is the Psion key.
  90. You can use the Insert key as an alternative to Shift-System.
  91.  
  92. Other limitations of the emulator:
  93. ----------------------------------
  94. Limited emulation of the WVE sound system.
  95. Differences at the low-level filing system level.
  96. Address trapping is implemented differently.
  97.  
  98. Run-time errors with the emulator:
  99. ----------------------------------
  100. The low-level memory manager inside S3aEMUL may generate exceptions,
  101. known as "run-time errors", if various error conditions arise - eg
  102. programs attempting to read or write outside the limits of the code
  103. and/or data segments.  (On a real S3a, these conditions would lead to
  104. "panic"s, but they are caught earlier, at a lower level, inside
  105. S3aEMUL.  This is not to say, incidentally, that *all* S3a panics are
  106. converted to S3aEMUL exceptions, only a fixed minority.)
  107.  
  108. When a run-time error of this sort occurs, the whole emulator stops
  109. at once, and all data in all programs is lost (though not data saved
  110. to file).  The emulator stops so suddenly that the screen will be
  111. left in graphics mode.  To return it to standard character mode, type
  112. eg      
  113.         MODE co80
  114. (you'll have to type this "blind", since the characters you type
  115. won't be echoed onto the screen until after the command is processed).
  116.  
  117. When a run-time error occurs, some part of the memory of the PC may
  118. on occasion be left tied up, even after S3aEMUL has exited.  (Use eg the
  119. DOS MEM command to find out if this is the case.)  Reset your PC if
  120. this becomes a problem.
  121.  
  122. Note that under normal circumstances, S3aEMUL will not encounter a
  123. run-time error - only if a program contains a bug.  However, if you
  124. use S3aEMUL to test programs under development, you may well encounter
  125. this situation.
  126.  
  127. Remote Link:
  128. ------------
  129. Note that you can turn on Remote Link in the System Screen and gain
  130. access to an attached S3a (or other Sibo computer) as REM::.
  131.  
  132. By default, this connection presupposes use of COM1.  However, if you
  133. type "-p2" into the "Extra parameters" line in the "Remote link"
  134. dialog in the System screen inside S3aEMUL, COM2 will be used instead.
  135.  
  136. Notes about SUBST:
  137. ------------------
  138. See your DOS manual for full details.
  139. Example syntax is
  140.     SUBST M: C:\PSION
  141. To change a subst, you first have to "delete" it, eg using
  142.     SUBST M: /D
  143.  
  144. Note that before you can SUBST to M:, the LASTDRIVE setting in
  145. CONFIG.SYS must be set as least as high as M.  (If you have to change
  146. your CONFIG.SYS, you will have to reboot your PC before this takes
  147. any effect.)
  148.  
  149. You may also find it convenient to SUBST A: or B: whilst S3aEMUL is
  150. running, to lessen the amount of access made by S3aEMUL to your floppy
  151. disk drives.
  152.  
  153. Troubleshooting:
  154. ----------------
  155. If you have problems running S3aEMUL:
  156.     disconnect any serial mice and/or remove their drivers
  157.     remove any ramdrives from your PC configuration
  158.     remove other ram-guzzlers from your PC configuration
  159.     re-read this document (sorry if this sounds condescending).
  160.  
  161. Technical support for S3aEMUL:
  162. ------------------------------
  163. Psion regrets that no technical support is available on the use of
  164. S3aEMUL, whether by post, fax, telephone calls, or EMAIL.
  165.  
  166. The sole exceptions to this are that questions raised about S3aEMUL in
  167. the PSION conferences on CIX will generally be answered within a few
  168. days.
  169.