home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / t / tnc_arc / !Tnc / !Help / ReadMe < prev    next >
Text File  |  1992-12-13  |  14KB  |  292 lines
  1. Help file for !tnc Version 2.10   © Garry Orford, G4FRO
  2. ===============================
  3.  
  4. Getting started
  5. ---------------
  6.  
  7. Make sure you have your tnc set at the same baud rate and word length as
  8. required by !tnc.   The program default is 2400 baud, 8n1 but this will be
  9. over-ridden by the parameters that you save from the SETUP dialogue box.
  10. Make sure you have wired the Arc/tnc correctly, including the curious Acorn
  11. hardware handshake arrangement.
  12.  
  13. This software is supplied on the understanding that you are a Radio Amateur
  14. interested in experimentation.   The most sophisticated professional
  15. programs have bugs (99% OK is considered adequate) - what chance do we have !
  16. You MUST solve problems to give Radio Hams a bit of cred.   
  17.  
  18. It is very difficult to start with both a new tnc and new software.   If you
  19. do so, well good luck but you WILL have problems.   Bear in mind, you will
  20. have to wire the Arc/tnc together correctly, learn to drive the tnc and work
  21. this software.   Speak nicely to a local !
  22.  
  23. This software has been extensively tested on various Arc/tnc combinations
  24. and has proved popular as it offers DeskTop facilities.   Eat your heart out
  25. PCs, Amigas and Ataris !
  26.  
  27. More details
  28. ------------
  29.  
  30. (1)  Click SELECT on iconbar, opens the main window.
  31. (2)  Click MENU  on iconbar, brings up menu.
  32. (3)  Click ADJUST on iconbar, brings up WimpKeys window.
  33.  
  34. (1)  Main window
  35.  
  36. Received text will be displayed in the upper part of the window.   Holding
  37. down SHIFT/CTRL or <Scroll Lock> will pause the display.
  38.  
  39. Click SELECT in TX window, puts caret on line in TX window (and highlights
  40. the task if not already active).   This can be done at any time, allowing
  41. input line to be re-sent.   Normal editting works, ie CTRL/U (delete line),
  42. left/right/up/down arrows etc.   Note line is not sent to tnc until <Return>
  43. is typed.  Typed lines are limited to 80 characters as the receiving
  44. computer may get upset with a greater number.   Setting WRAP will cause a
  45. <cr> to be sent after a maximum of 77 characters, breaking your typed line
  46. intelligently.   Control codes are sent by enclosing the ASCII value
  47. in square brackets; example, [03] represents CTRL/C or ASCII 3; widely
  48. used to enter command mode.   Typing CTRL/V or CTRL/Z will
  49. automatically append a <Return> to the control code.    Note, this
  50. works in fkey/wkey definitions also.
  51.  
  52. Hitting <Esc> will force a disconnect on the current stream.   If KAM is set,
  53. this will be achieved by sending a 50 mS BREAK level (for command mode), then
  54. d[13].    If KAM is not set, [03]d[13] will be sent. The reason for this
  55. difference is owing to the fact that some KAM Ver 5.0n users, experience KAM
  56. crashes with the latter method.
  57.  
  58. The following commands may be used in the TX window, fkeys or WimpKeys
  59. with the exception of {peckoff} which MUST be used from a WimpKey or
  60. fkey.  Note the use of curly brackets.    Commands should be entirely in
  61. upper case or entirely in lower case.
  62.  
  63. {time}         Sends the current time in the format defined in SETUP.
  64. {date}         Sends the current date in the format defined in SETUP.
  65. {upload}<file> Sends the file !tnc.Uploadfile.<file>
  66. {peckon}       Causes typed characters to be immediately sent to the serial port
  67. {peckoff}      Reverses the effect of {peckon}
  68. {break}        Sends a 50 mS BREAK level
  69.  
  70. {peckon} and {peckoff} are intended for use by non-KAM tncs on non-packet
  71. modes; example, for use by the PK232 on AMTOR.   
  72.  
  73. Packets will be received by the Arc from the tnc whenever !tnc is running,
  74. whether or not the main window is open.   Also, packets can be SPOOLed in
  75. this state.   You may review up to 1000 lines by the standard Wimp controls.
  76. HOME toggles between the TX lines out/in sight, provided no other window
  77. hold the caret; PageUp/Down work in the usual way.
  78.  
  79. Drag a file to window and UPLOAD window appears.   You may then SEND file or
  80. ABORT.   You can abort at any time but note part of file will have already been
  81. sent to the tnc for tx'ing.   Files can be dragged from a Filer window or,
  82. if less than 1024 bytes, direct from another !Application.   Function key f11
  83. may optionally be sent after the file.
  84.  
  85. A nice feature is that hitting PRINT will bring up a standard save box
  86. which can be used to save the entire current RX window.    This is
  87. handy if you forget to SPOOL or notice something interesting going by.
  88.  
  89. (2)  Menu
  90.  
  91. INFO shows the version and date of this copy of !tnc.
  92.  
  93. SETUP brings up a dialogue box for customising !tnc to your own use.
  94.  
  95. TNC BAUD and WORD FORMat alter the serial link parameters between the Arc and
  96. the tnc.   By clicking on the appropriate up/down arrows, the baud rate and
  97. word format of !tnc can be adjusted to various values that should cover most
  98. tncs.   The parameters are immediately used following a Save, so ensure that
  99. your tnc is set correctly.   Abort will abandon the serial link parameters
  100. adjustment and continue as before.
  101.  
  102. SPOOL and GRAB are the default names for SPOOL (to disc) and GRAB (from RX
  103. window) files respectively.
  104.  
  105. BEEPS disables received beeps (typed CTRL/Gs will still be heard) but you may
  106. send [07].
  107.  
  108. WRAP enables the wrap feature on packet.
  109.  
  110. KAM permits or otherwise the selection of KAM on the MENU.
  111.  
  112. CARET.  Selection of CARET will, against Acorn advice (they call it esoteric !), forces the caret to be red on a non-white background.   This works fine
  113. for certain combinations of MEMC and mode.    However, other combinations
  114. are slightly uncomfortable.    It also slows !tnc down.   Non-selection of
  115. CARET will restore the Acorn acceptable green on grey and not cause MEMC
  116. problems.   You may then use !Palette to choose the caret colour of your
  117. choice.
  118.  
  119. DATE and TIME formats set the style of {date} and {time} when typed or added
  120. to WimpKeys or function keys.    You have to read your User Guide for the
  121. full range of options.
  122.  
  123. ABORT abandons your changes and resets parameters to the previously selected.
  124.  
  125. USE makes immediate use of your changes without saving to disc.
  126.  
  127. SAVE makes immediate use of your changes and saves to disc
  128.  
  129. CTEXTS provides intelligent CTEXTs.   To enable this feature, click SELECT on
  130. the MENU item Ctexts, so that CTEXTS becomes ticked.   To set the ctexts,
  131. follow the right arrow on the MENU item Ctexts and click SELECT on Open.  
  132. This will open a dialogue box showing callsigns and associated ctext.   You
  133. may set the last callsign to OTHER, which will send the associated ctext to
  134. any station whose callsign is not specifically listed.   If you have set your
  135. tnc to send its own ctext, this will continue to work as normal.   After
  136. writing to the ctext window, use MENU on the window to UPDATE or SAVE.  
  137. {commands} and [control codes] may be used in the definitions.   Following
  138. typing in the TX window or using an Fkey or WimpKey, the CTEXT feature will
  139. be disabled for 30 seconds. This has two purposes; one, to avoid sending the
  140. CTEXT to a station in which you initiate a connect and two, to avoid sending
  141. a 'Sorry, I'm not here Fred' style of message to a station who plainly can
  142. see you are !
  143.  
  144. FKEYS allows the opening of any of the four function key set; fkeys alone,
  145. SHIFT/fkey, CTRL/fkey and SHIFT/CTRL/fkey.   After writing to the fkey
  146. window, use MENU on the window to UPDATE or SAVE.   {commands} and [control
  147. codes] may be used in the definitions.
  148.  
  149. <Print> saves the RX window as a file (see above).
  150. f12 is not programmable as it is used by RISC OS.
  151.  
  152. WKEYS (WimpKeys) are the RISC OS version of function keys.    The WimpKey
  153. definitions are set in directory !tnc.WimpKeys.    You may have as many sets
  154. of definitions as you like; they should be numbered 1 upwards.   Click SELECT
  155. on the number at the left side of the WimpKey window to advance to the next
  156. WimpKeys, ADJUST to revert to the previous set.  WimpKey definitions are in
  157. line pairs. The first line is definition itself; the second line is WimpKey
  158. text.   You may have up to eight definitions (16 lines) per set of WimpKeys.
  159. {time}, {date} and [control codes] may be used in the definitions.   You may
  160. also use {upload}<filename> to send !tnc.UploadFile.<filename> when clicking
  161. on the WimpKey.    Using SELECT on the WimpKey sends the text; ADJUST sends
  162. the text and closes the WimpKey window; MENU