home *** CD-ROM | disk | FTP | other *** search
/ RISC DISC 2 / RISC_DISC_2.iso / pd_share / comms / s2p / !S2P / !Help next >
Encoding:
Text File  |  1995-01-06  |  7.1 KB  |  209 lines
  1. Instructions for !S2P by Andrew Sellors
  2.  
  3. *****************************************************************************
  4. * NOTE:                                                                     *
  5. * !S2P is FreeWare.                                                         *
  6. * This means that you may freely copy and distribute it, provided that it   *
  7. * is complete with all original files, and that you do not sell it.         *
  8. * PD libraries may charge a nominal fee for the cost of duplication,        *
  9. * postage etc.                                                              *
  10. * In no circumstances shall the author be liable for any damage, loss of    *
  11. * profits, time or data or any indirect or consequential loss rising out of *
  12. * the use of this software or inability to use this software.               *
  13. *****************************************************************************
  14.  
  15. Contents:
  16. ---------
  17.  
  18. Aims
  19. Features
  20. Before you start!
  21. Compatibility
  22. Problems
  23. Operation
  24. Clicking on iconbar icon
  25. Iconbar menu
  26. "Serial Port Configuration" window
  27. Setting the 3D bit
  28. Contacting the author
  29.  
  30. ********************************************************************************
  31.  
  32. Aims:
  33. -----
  34.  
  35. This program sends all data received by a serial port to the parallel port.
  36. Why????
  37.  
  38. I have two machines, but only one printer and the two machines are not close
  39. together (10 metres in fact). Both machines are connected together using the
  40. serial ports so by configuring !Printers to use the serial port and running
  41. this program on the other machine, I can print from the remote machine.
  42.  
  43. ********************************************************************************
  44.  
  45. Features:
  46. ---------
  47.  
  48. Uses 3D bit in CMOS RAM to select 2D or 3D windows _and_ iconsprites on startup.
  49. (See the "Setting the 3D bit" section if you don't like 2D windows)
  50.  
  51. Uses Block Drivers so it can use serial ports other than the internal one.
  52.  
  53. Provides full control over the serial port used.
  54.  
  55. ********************************************************************************
  56.  
  57. Before you start!:
  58. ------------------
  59.  
  60. Before you can use this program you need the Block Drivers by Hugo Fiennes.
  61. If you don't have them then download them now! or look at your favourite
  62. PD library.
  63.  
  64. ********************************************************************************
  65.  
  66. Compatibility:
  67. --------------
  68.  
  69. This program is for RISC OS 3.10 or later.
  70. It has been tested on both RISC OS 3.10 and RISC OS 3.50 and with the internal
  71. port using Block Drivers v10a.
  72.  
  73. ********************************************************************************
  74.  
  75. Problems:
  76. ---------
  77.  
  78. The setting of the input buffer threshold for the internal port in RISC OS 3.10
  79. does not seem to do anything, as it still operates as if the threshold was set
  80. to the default of 9 bytes less then the full buffer when it stops the other
  81. computer transmitting. I don't know whether that is a bug in RISC OS 3.10 or
  82. just because I have an old hardware machine (A410/1) rather than something like
  83. a A5000. It does work though on RISC OS 3.50 on the Risc PC 600. So if you are
  84. using the internal port and you get problems with characters being missed out
  85. or the printer doing strange things when printing then try reducing the speed
  86. so that the data transfer lags behind the printer.
  87.  
  88. ********************************************************************************
  89.  
  90. Operation:
  91. ----------
  92.  
  93. When the !S2P icon is double-clicked, Serial 2 Parallel installs itself on the
  94. left of the icon bar and the configured Block Driver loaded. If the !SerialDev
  95. application that holds the Block Drivers has not been seen by the Filer then
  96. an error is reported and the program does not start up.
  97.  
  98. ********************************************************************************
  99.  
  100. Clicking on iconbar icon:
  101. -------------------------
  102.  
  103. The colour of the printer on the icon indicates whether the serial port is
  104. being redirected to the parallel port:
  105.      Grey printer: Serial port not redirected
  106.    Yellow printer: Serial port being redirected
  107.  
  108. Clicking on the icon toggles this state.
  109.  
  110. ********************************************************************************
  111.  
  112. Iconbar menu:
  113. -------------
  114.  
  115.    +--------------+
  116.    |     S2P      |
  117.    +--------------+
  118.    | Info    ⇨    | ⇨ opens "About this program" window
  119.    | Configure... | Opens "Serial Port Configuration" window
  120.    | Quit         | Quits program.
  121.    +--------------+
  122.  
  123. ********************************************************************************
  124.  
  125. "Serial Port Configuration" window
  126. ----------------------------------
  127.  
  128. This allows the serial port so be set up.
  129.  
  130. Any changes made only take effect when either "Change" or "Save" are selected.
  131.  
  132.  
  133. The "Driver Name" pop-up menu allows you to change the Block Driver used.
  134. When a new driver is selected, the driver is scanned to find the baud rates
  135. and ports supported, and the relevant menus changed accordingly.
  136.  
  137. Clicking on "Rescan Drivers" rechecks the available Block Drivers and updates
  138. the list of drivers for the "Driver Name" menu. This can be used to update
  139. the list if any drivers have been added since the program was started.
  140.  
  141. The "Port Number" pop-up menu allows the serial port to be configured as
  142. some drivers support more than one serial port, the internal driver has only
  143. one port: 0.
  144.  
  145. The other menus are fairly self explanatory, these should be set to the same
  146. as !Printers for the transfer of data to work.
  147.  
  148.  
  149. Clicking on "Change" makes any changes made take effect and removes the window
  150. from the screen. If adjust is used instead of select then the window is left
  151. on screen.
  152.  
  153. Clicking on "Cancel" throws away any changes made and removes the window from
  154. the screen.
  155.  
  156. Clicking on "Save" makes any changes made take effect and the saves the
  157. configuration to disc to be used the next time the program is loaded. Whether
  158. the serial port is being redirected is also saved with the options in this
  159. window. If adjust is used instead of select then the window is left on screen.
  160.  
  161. ********************************************************************************
  162.  
  163. Setting the 3D bit:
  164. -------------------
  165.  
  166. If you want to use the 3D windows in this program (and the handful of others
  167. that support it) then you need to set the 3D bit in the CMOS RAM. In RISC OS 3.1
  168. there is on *configure command to change it so you can either:
  169.  
  170.    Use !DeskCtrl (another program I have written, well worth getting and
  171.                   hopefully released soon on the Acorn User coverdisc)
  172.  
  173.    OR
  174.  
  175.    By cutting out the following BASIC program and running it.
  176.    Note: this program toggles the bit, so if its off and you run it twice then
  177.          it is still off!
  178.  
  179.    10REM Toggle state of DragASprite bit in CMOS
  180.    20REM Read byte
  181.    30SYS "OS_Byte",161,&1C TO ,,byte%
  182.    40REM EOR byte with mask for bit 1
  183.    50byte% = byte% EOR 1<<1
  184.    60REM Write byte back again
  185.    70SYS "OS_Byte",162,&1C,byte%
  186.    80END
  187.  
  188.  
  189. ********************************************************************************
  190.  
  191. Contacting the author
  192. --------------------
  193.  
  194. I, Andrew Sellors, can be contacted either at
  195.    57 Boundaries Road
  196.    Feltham
  197.    Middlesex
  198.    TW13 5DR
  199.  
  200. Or via Internet email at
  201.    k946949@king.ac.uk
  202.  
  203. Any feedback from users (bugs reports, requests for new features, praise,
  204. money etc.) is gladly received. 
  205.  
  206.  
  207.  
  208.  
  209.