home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 1 / ARM_CLUB_CD.iso / contents / apps / bbc / progs / sendterm / !SerialTrm_!Help < prev    next >
Encoding:
Text File  |  1995-05-16  |  5.2 KB  |  112 lines
  1. !SerialTrm 1.10beta  by The Angelos tou Thanatou
  2. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  3. Ever wanted to use command line stuff using a different keyboard & monitor
  4. so you didn't have to mess up your desktop by using 'f12' or a taskwindow?
  5.  
  6. !SerialTrm runs a taskwindow and directs all output to the serial port.
  7. Input from the serial port is directed to the taskwindow. The practical
  8. upshot of this is that by connecting a suitable terminal (see later) to
  9. your serial port, you can have a taskwindow that uses the terminal for
  10. all IO. Suprisingly useful. No, really.
  11.  
  12. What do I mean by a 'suitable termninal'? Well, for a start it should send
  13. ASCII code 10 for 'Return', and it should output LF's and CR's properly (ie.
  14. ASCII 10 = linefeed only, ASCII 13 = carriage return only).
  15. "Argh!", you cry, "I have no such terminal!". Well, if you have a beeb/master,
  16. you do, it's in the !SendTerm application supplied, and what's more, simply
  17. double-click !SendTerm and everything's taken care of.
  18.  
  19. What sort of serial cable do I need? See a bit later in this file for info.
  20.  
  21. Usage
  22. ~~~~~
  23. Double click on the !SerialTrm icon in a filer window. An icon will install
  24. itself on the left hand side of the icon bar; it'll probably flash an arrow and
  25. then a star followed by a blinking cursor at you. The icon reflects what the
  26. application is currently doing: an arrow pointing at the 'serial port' means
  27. that text is being output to the terminal, and arrow pointing 'in' from it
  28. means that text is being input from the terminal. Other possibilities are: a
  29. line (reinitialising), a star & blinking cursor (idle), a '!' sign (an serious
  30. error / buffer full), some paws (paused... sorry).
  31.  
  32. Icon bar menu
  33. ~~~~~~~~~~~~~
  34. You can restart and pause the task from the icon bar menu. Note that when I say
  35. 'task' I mean the task running under the taskwindow (eg. the CLI, Basic, etc).
  36. You can also quit the application from here.
  37. 'restart' restarts the taskwindow. Its effect is exactly the same as quiting
  38. and restarting the application (provided you haven't altered it whilst running
  39. it of course).
  40. 'pause' pauses the taskwindow. No more output will be generated, input will
  41. stack up in the serial buffer though. This shouldn't be a problem. Pause is
  42. only really useful if you absolutely *need* every CPUsec of processor time for
  43. some desktop task. Oh, and to go 'awww' at the cute icon.
  44.  
  45.  
  46. Configuration
  47. ~~~~~~~~~~~~~
  48. See the !Run file for details of how you can configure !SerialTrm
  49. Note that as supplied Hi-res sprites are used. You can rename the sprite files
  50. in the !SerialTrm directory if you want lo-res sprites. (The Sprites24 file is
  51. the low-res version of the file SpriteFile). Sorry about this, I just can't be
  52. bothered to fix it in the code :-)
  53.  
  54.  
  55. Notes
  56. ~~~~~
  57. You can alter the amount of memory allocated to the taskwindow by using the
  58. wimpslot command from the terminal. eg. '*wimpslot 1024k' will allocate 1Mbyte
  59. to the task(window).
  60. Sadly, if you're using a screen mode that doesn't have 80 columns, directory
  61. catalogues will be mangled on the terminal. This is because *cat, etc. read the
  62. current screen dimensions and then format their output acordingly. Any other
  63. (misbehaved?) software that does this will also suffer from this problem. A fix
  64. is way too complex to be worthwhile. 
  65.  
  66.  
  67. Cable Wiring
  68. ~~~~~~~~~~~~
  69. || Note, no account is take on the Hardware Bugs present in the old Serial
  70. || Chips.
  71. || The practical upshot of this is that your serial cable should be wired 'as
  72. || standard' rather than any of the 'fancy' work arounds. Hey, let's face it we
  73. || only need the RTS,CTS,TxD & RxD lines anyway...
  74. || The cable I use is wired:
  75. || 
  76. ||        ARC                   Beeb/Master
  77. || (9 pin Dtype socket)    (5 pin 'Domino' DIN plug)
  78. ||      ____________             _-   -_
  79. ||     \ 1 2 3 4 5 /            / 5   4 \        (both viewed looking at the
  80. ||      \ 6 7 8 9 /             >   1   |         *back* of the plug (ie.
  81. ||       ~~~~~~~~~              \ 2   3 /         at the bits you solder to))
  82. ||                               ~-___-~
  83. || Connections:
  84. || ARC                       BEEB
  85. ||  +----1
  86. ||  |    2--------------------3
  87. ||  |    3--------------------4
  88. ||  +----4
  89. ||  |    5--------------------1
  90. ||  +----6
  91. ||       7--------------------2
  92. ||       8--------------------5
  93. ||       9
  94.  
  95. Disclaimer
  96. ~~~~~~~~~~
  97. Use of this software is completely at your own risk. In particular,
  98. construction of a connecting cable to the above instructions is completely at
  99. the risk of the contructor. The author can accept no responsibility for any
  100. damage/loss arising from the use, or inability to use this software. No
  101. warranty, express or implied, applies to this software. This is not PD: the
  102. Copyright in this software belongs at all times to the author. However,
  103. permission is granted for unrestricted distribution prodividing that *no*
  104. charge is made for the distribution [a charge may be made for handling/media]
  105. and that the whole of the software is supplied intact and unaltered. Permission
  106. is also granted for unrestricted use and alteration of the software [but if you
  107. fix a bug / add anything nice, let me know so I can patch the 'master' version].
  108.  
  109. Bug reports / comments / etc to:
  110. Angelos tou Thanatou c/o 23 Baronsway, Whitkirk, Leeds, LS15 7AW, England.
  111. (until Sept-ish '95: n0ae2@newton.ncl.ac.uk, voice 0191 2301292)
  112.