home *** CD-ROM | disk | FTP | other *** search
/ RISC DISC 2 / RISC_DISC_2.iso / pd_share / comms / z88link / !Z88Link / !Help < prev    next >
Encoding:
Text File  |  1995-04-05  |  8.1 KB  |  220 lines
  1. Z88Link 1.01  User Guide
  2. ========================
  3.  
  4. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  5. + © John Allen 1995.  This application remains Public Domain as     +
  6. + long as:                                                          + 
  7. +                                                                   +
  8. + 1. The source code is not altered in any way                      +
  9. + 2. Any copies made contain all of the files in the directory      +
  10. + 3. It is not sold for a profit                                    +
  11. +                                                                   +
  12. + Please contact me before adding it to a PD library so that I can  +
  13. + supply an up to date version.                                     +
  14. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  15.  
  16. Z88Link 1.01 links the Cambridge Computer Z88 portable with RISC OS 
  17. computers.  It requires a cable, wired as detailed below, but does not 
  18. require the PC Link rom in the Z88.
  19.  
  20. !Z88link only works from the desktop, there are no '*' commands 
  21. available from the command line.
  22.  
  23. Version 2.00 is available from the author on receipt of £5.00.  
  24. Further details of version 2.00 are given at the end of this file.
  25.  
  26. The following files should be contained in the !Z88Link application 
  27. directory:
  28.  
  29. !Boot
  30. !Run
  31. !Help
  32. !Sprites
  33. !Sprites22
  34. DragOpts directory, containing DragOff and DragOn 
  35. Z88Mod
  36. Serial
  37. Settings
  38. 2D_Templ
  39. 3D_Templ
  40.  
  41.  
  42. Loading 
  43. -------
  44.  
  45. Load the application by double clicking on the icon, this installs the 
  46. 'Z88' icon on the left hand side of the icon bar.
  47.  
  48.  
  49. Serial Settings
  50. ---------------
  51.  
  52. These should be set on the RISC OS machine to match the ones set on 
  53. the Z88's Control Panel.  This is done by using the 'Serial Setup' 
  54. window selected from the !Z88Link iconbar menu.  This window is 
  55. displayed either by clicking the item on the menu or by moving the 
  56. mouse to the right of the menu text.
  57.  
  58. The settings on the RISC OS computer can be saved using the 'Save 
  59. Setup' option on the iconbar menu.  Once saved, these settings will be 
  60. the initial ones used every time that !Z88Link is loaded.  They are 
  61. stored in the file 'Settings' within the application's directory.  If 
  62. this file is not present, default settings, to match the Z88 defaults, 
  63. will be used.
  64.  
  65. Acorn's replacement Serial Device Driver module 0.22 is included in 
  66. the application and loaded with !Z88Link.  Without it random chunks 
  67. of files transferred will disappear on older machines running RISC OS 
  68. 3.10.  This problem can still occur at higher speeds on these machines 
  69. when transferring to floppy discs.  For safety you should transfer to 
  70. a hard disc or a ram disc and copy the file to a floppy.  If you don't 
  71. need the module it can be deleted in the !Run file.
  72.  
  73.  
  74. Sending a file to the Z88
  75. -------------------------
  76.  
  77. Sending a file from the RISC OS machine can be started in two ways:
  78.  
  79. 1. By dragging a file of type 'Text' (&FFF), 'PipeDream' (&DDE) 
  80. 'Basic' (&FFB) or 'Data' (&FFD) onto the !Z88Link iconbar icon.
  81.  
  82. 2. By dragging an icon of type 'Text', 'PipeDream' 'Basic' or 'Data' 
  83. from the save window of another RISC OS application to the !Z88Link 
  84. icon on the iconbar.
  85.  
  86. In both cases an 'Export' window will be displayed and you should 
  87. follow the instructions in the large top icon.  Broadly you set the 
  88. Z88's Export utility ([]X) to receive a file and then click on the 
  89. 'Start' icon in the export window.  The Z88 can be set to receive a 
  90. batch of files when any number of files are sent from the RISC OS 
  91. computer and 'ESC' pressed on the Z88 after the last one.
  92.  
  93. Although BBC Basic is used on both machines the files are formatted 
  94. differently, so !Z88Link performs the necessary conversion.  It should 
  95. be noted that there are differences in the implementation of BBC Basic 
  96. on the two machines so programs are not necessarily able to run on 
  97. both machines, this is particularly true if graphics, sound or add-on 
  98. hardware is used.
  99.  
  100.  
  101.  
  102. Receiving a file from the Z88
  103. -----------------------------
  104.  
  105. This can be initiated on the RISC OS machine in two ways:
  106.  
  107. 1. By selecting the 'Import File' item on the !Z88Link iconbar menu.
  108.  
  109. 2. By clicking on the Z88Link icon on the iconbar.
  110.  
  111. In both cases an 'Import' window is displayed while the transfer takes 
  112. place, with instructions appearing in the large top icon.  Broadly the 
  113. procedure is to set !Z88Link ready to receive then send the file from 
  114. the Z88 using the Z88 export utility ([]X).
  115.  
  116. Once the file has transferred the save window will display a suitable 
  117. file icon and the Z88 leafname for the file.  The leafname can be 
  118. edited.  If a full pathname is inserted click 'OK' to save the file.  
  119. If the leafname is not edited, or if the resulting name is not a full 
  120. pathname, drag the icon to the required Filer directory. 
  121.  
  122. Any file extension in the Z88 name will be retained but the '.' will 
  123. be replaces by '/'.  This conforms with the convention when reading PC 
  124. discs.  
  125.  
  126. Note that ADFS has a maximum file name length of 10 characters, the 
  127. Z88 allows 12 characters and there can be another four characters 
  128. added for a file extension.  It is advisable to edit long file names 
  129. before saving to ADFS otherwise they will be truncated to 10 
  130. characters.
  131.  
  132. !Z88Link will examine the file to decide on the filetype.  PipeDream 
  133. working files will be given 'PipeDream' (&DDE) filetypes, Basic 
  134. programs will have 'Basic' (&FFB) filetpyes and all other files will 
  135. have a 'Text' (&FFF) filetype.  
  136.  
  137. Although BBC Basic is used on both machines the files are formatted 
  138. differently so, as with exporting !Z88Link will perform the necessary 
  139. conversion.  It should be noted that there are differences in the 
  140. implementation of BBC Basic on the two machines so programs are not 
  141. necessarily able to run on both machines, this is particularly true if 
  142. graphics, sound or add-on hardware is used.
  143.  
  144.  
  145. Connections
  146. -----------
  147.  
  148. The lead to connect the two machines should be wired as follows:
  149.  
  150.             RISC OS           Z88
  151.        9-pin female D    9-pin male D
  152.  
  153.               2  ------------  2
  154.               3  ------------  3
  155.               5  ------------  7
  156.               7  ------------  5
  157.               6  ------------  4
  158.  
  159. On the RISC OS computer plug pins 1, 4 and 8 should be connected 
  160. together and on the Z88 plug pins 8 and 9 need to be connected 
  161. together.
  162.  
  163.  
  164. Sprite Dragging
  165. ---------------
  166.  
  167. RISC OS 3 has a 'Drag A Sprite' module which allows solid spites to be 
  168. dragged from file save windows rather than the standard dotted box.  
  169. !Z88Link will use this facility if the module is present, and if 
  170. RISC OS is configured for this to happen.  Unfortunately this is not 
  171. one of the options available from the RISC OS !Configure application 
  172. so two simple programmes are provided to configure this facility, they 
  173. are in the directory 'DragOpts' inside this application directory.  
  174. Double click on the appropriate file to set the option on or off.  
  175.  
  176. This does not stop !Z88Link from operating as normal under 
  177. RISC OS 2.
  178.  
  179.  
  180. Appearance
  181. ----------
  182.  
  183. !Z88Link uses the new style 3D icons with RISC OS 3.10 or higher, 
  184. otherwise standard 2D icons will be used in all of the windows.
  185.  
  186.  
  187. Version 2.00
  188. ------------
  189.  
  190. Version 2.00 has more bells and whistles!  It does everything that 
  191. this PD version 1.01 does, plus it allows batches of files to be 
  192. transferred in either direction.  For example by using suitable 
  193. wildcards, all files in the Z88 or in a particular device can be 
  194. backed up to a single archive file on the RISC OS computer for safety.  
  195. The entire contents of the RISC OS archive can then be restored to the 
  196. Z88, or an option allows selective restoration.  Mystery Z88 resets 
  197. need never again be a problem!  Version 2.00 is available from the 
  198. author at the address below for £5.00 and is NOT a PD utility.
  199.  
  200.  
  201. Any comments, queries, donations or bug reports to:
  202.  
  203. John Allen
  204. 9 Bramber Road
  205. West Kensington
  206. London W14 9PA
  207.  
  208. E-mail: john@bramber.demon.co.uk
  209. Silicon Village: 819991215
  210. Arcade: #917
  211.  
  212.  
  213. ***************************** AD ************************************
  214.  
  215. Z88 PipeDream: A Dabhand Guide by John Allen is the indispensable 
  216. guide to this important application.  It only costs £14.95 from Dabs 
  217. Press.  Buy one today! 
  218.  
  219. ************************** End of AD ********************************
  220.