home *** CD-ROM | disk | FTP | other *** search
/ Hacker Chronicles 2 / HACKER2.BIN / 1069.KANT.DOC < prev    next >
Text File  |  1989-03-26  |  10KB  |  244 lines
  1. KANT.DOC
  2.  
  3. Notes on using Kantronics KPC-4 and KAM dual port TNCs with the W0RLI Mailbox:
  4. ------------------------------------------------------------------------------
  5.  
  6. (Revised from July 23, 1988 notes - for use with W0RLI V9.xx and later software
  7. and Kantronics KPC-4 and KAM with V2.85 ROMs or later.)
  8.  
  9. Date: March 25, 1989
  10. From: Greg Day - KC8JN @ KC8JN
  11.       Wintersville, OH 43952
  12.  
  13.  
  14. GENERAL INFORMATION
  15. -------------------
  16.  
  17. This information is provided for those SYSOPs using the W0RLI Mailbox software
  18. with either a Kantronics KPC-4 or KAM dual port TNC, to allow for port
  19. switching during mail forwarding.  Because the command structure for port
  20. switching is the same for both the KPC-4 VHF TNC and the KAM VHF/HF TNC, the
  21. following discussion will pertain to the KPC-4 only, but will apply to use of
  22. the KAM as well.
  23.  
  24. Because the KPC-4 uses software commands to switch between the two radio ports,
  25. and since the TNC provides only one serial (RS-232) port for connection to the
  26. computer, it is necessary to implement a method by which the SYSOP may easily
  27. switch ports, both from the console and during mail forwarding.  This is
  28. accomplished through the use of the KPC-4 STREAMSW parameter to permit
  29. switching between the streams on radio ports 1 or 2.  The use of this method of
  30. switching streams (radio ports) requires the use of a 2.85 or later version
  31. ROM.  The MAXUSERS parameter MUST be set to 0/0 to allow for a single exclusive
  32. connect from either port (the TNC will switch to the proper stream or radio
  33. port upon a valid connect from either port).  The actual switching of streams
  34. (radio ports) is accomplished through the issuance of a stream switch character
  35. (set by the STREAMSW parameter) unique to thepport desired followed by a
  36. selected channel number, which for use with the Mailbox system will always be
  37. "A".  This stream switching information may be issued when in either the
  38. command or converse modes, but will be confined to the command mode when using
  39. the Mailbox software.
  40.  
  41. The following parameters MUST be set as shown in the KPC-4 to permit proper
  42. port switching operation:
  43.  
  44.      MAXUSERS 0
  45.      STATSHRT ON
  46.      STREAMSW 0/0
  47.      USERS 1/1
  48.  
  49.  
  50. SWITCHING IN TERMINAL MODE
  51. --------------------------
  52.  
  53. The SYSOP should create the following two files to allow for easy stream (radio
  54. port) switching from the local console:
  55.  
  56. For port 1, save to a file named "P1" under the \BBS subdirectory:
  57.  
  58.      ^CSTR 35/36
  59.      #ASTR 0
  60.      S
  61.  
  62. For port 2, save to a file named "P2" under the \BBS subdirectory:
  63.  
  64.      ^CSTR 35/36
  65.      $ASTR 0
  66.      S
  67.  
  68. An explanation of the above command sequence is in order.
  69.  
  70. 1) The first line issues a CTRL-C (to get the "cmd:" prompt) and sets the
  71.    stream switch (STREAMSW) characters temporarily to "#" for port 1 and "$"
  72.    for port 2.  Please note that the CTRL-C is displayed as "^C" which is
  73.    treated as a single ASCII character and not the individual characters "^"
  74.    and "C".  Refer to your text editor documentation for specifics on how to
  75.    embed control charcters into your ASCII text.
  76.  
  77.  
  78. 2) The third line actually switches the stream (radio port) using the stream
  79.    switch character ("#" for port 1 or "$" for port 2) followed by the channel
  80.    letter (ALWAYS use "A" since you will be dealing with only one channel in
  81.    the mailbox).  The remainder of the line sets the STREAMSW characters for
  82.    both ports back to null (0/0) so that incoming characters from the console
  83.    will not inadvertently switch the stream (radio ports).
  84.  
  85. (Please note that it is no longer necessary to perform the additional steps
  86. outlined in my previous documentation for clearing the KPC-4 buffer to prevent
  87. confusion to the BBS software.  The V2.85 ROM corrects this problem and greatly
  88. simplifies stream switching while maintaining BBS compatibility.)
  89.  
  90. 3) The last line issues the STATUS command and will list the current selected
  91.    stream (radio port) of the TNC.  This is merely a confirmation message to
  92.    the SYSOP at the console and is not necessary.  The STATSHRT command should
  93.    be set to ON to make this function operate correctly.
  94.  
  95. To use the above from the console, type the following:
  96.  
  97.      Tp             (go to Terminal mode on port "p")
  98.      <CTRL-E>       (return to local BBS console - this may be a different
  99.                     character or key combination if you have deviated from the
  100.                     standard CTRL-E sequence provided in W0RLI's COMFIG.MB
  101.                     file)
  102.      Op P1        (for switching to port 1 on serial port "p")
  103.  
  104. OR......
  105.  
  106.      Tp             (go to Terminal mode on port "p")
  107.      <CTRL-E>       (return to local BBS console - this may be a different
  108.                     character or key combination if you have deviated from the
  109.                     standard CTRL-E sequence provided in W0RLI's COMFIG.MB
  110.                     file)
  111.      Op P2        (for switching to port 2 on serial port "p")
  112.  
  113. (Please note that the entry into the terminal mode, return to the local console
  114. mode, and subsequent transmission of the "Pn" file with re-entry into the
  115. terminal mode is a required sequence of the W0RLI software.  Use of the "Op"
  116. command without first accessing the port via the "Tp" command is not
  117. permissible.  See the "H O" help listing on your BBS for information concerning
  118. this procedure.)
  119.  
  120. Under the W0RLI system, the above will send the port switching file to the TNC
  121. and select the desired port for local (SYSOP) access and use.
  122.  
  123.  
  124. SWITCHING DURING FORWARDING
  125. ---------------------------
  126.  
  127. Next you will want to modify the forwarding file (FWD.MB) to accomplish stream
  128. (radio port) switching when forwarding.  You will use the "P" scripts available
  129. for use in the W0RLI system forwarding files to send commands to the TNC for
  130. stream (radio port) switching.  This is discussed in detail in the FWD.DOC file
  131. that accompanies the W0RLI system.  Place the "P" scripts with the radio port
  132. switching commands at the beginning of each forwarding connect list to a
  133. speciffic BBS (see examples below).  The following are the lines used to
  134. accomplish port switching:
  135.  
  136. To forward on radio port 1......
  137.  
  138.      PSTR 35/36     (establishes stream switching characters: #=1, $=2)
  139.      P#ASTR 0       (switches to port 1 with #A then sets stream switch off)
  140.      PS             (displays which port has been selected - optional)
  141.  
  142. To forward on radio port 2......
  143.  
  144.      PSTR 35/36     (establishes stream switching characters: #=1, $=2)
  145.      P$ASTR 0       (switches to port 2 with $A then sets stream switch off)
  146.      PS             (displays which port has been selected - optional)
  147.  
  148. Again, the "S" command (third line) will cause the current stream (radio port)
  149. status to be displayed and is optional (STATSHRT must be set ON).  Stream
  150. switching is done using either the "#" or "$" characters (followed by the "A"
  151. channel character) in the second line.  As noted above, the "#" character
  152. corresponds to radio port 1 and the "$" character corresponds to radio port 2.
  153.  
  154. A complete forwarding file might look like this:
  155.  
  156.      PSTR 35/36
  157.      P#ASTR 0                     (Switch to radio port 1)
  158.      PS
  159.      CC K8AL-2
  160.      NC K8EIW-5
  161.      NC CLE
  162.      NC KB8CI
  163.      FA0023KB8CI
  164.      @C:\BBS\KB8CI.FWD
  165.      *** EOF
  166.      PSTR 35/36
  167.      P$ASTR 0                     (Switch to radio port 2)
  168.      PS
  169.      CC AD8J-1
  170.      NC W2XO
  171.      FA0421W2XO
  172.      @C:\BBS\W2XO.FWD
  173.      *** EOF
  174.      PSTR 35/36
  175.      P#ASTR 0                     (Switch to radio port 1)
  176.      PS
  177.      CC K8AL-2
  178.      NC N8FSY
  179.      FA0023N8FSY
  180.      C:\BBS\N8FSY.FWD
  181.      *** EOF
  182.      PSTR 35/36
  183.      P$ASTR 0                     (Switch to radio port 2)
  184.      PS
  185.      CC AD8J-1
  186.      NC KA3NVP
  187.      FA0421KA3NVP
  188.      @C:\BBS\KA3NVP.FWD
  189.      *** EOF
  190.  
  191. The above examples use BBS port "A" (COM1) for the TNC serial I/O.  If you use
  192. another COM port, substitute the appropriate letter ("FB", "FC", etc.).
  193.  
  194. It is not necessary to use "Q" scripts to return to a specific radio port after
  195. forwarding is completed to a given BBS.  The TNC will automatically select the
  196. active port when a user connects and exclude all others (ring "Busy") on the
  197. unused port during normal user access.  The only reason you might want to
  198. implement the "Q" scripts would be if you want to ensure that you are ALWAYS on
  199. a specified radio port when entering the terminal mode.  However, this is
  200. easily overcome through the use of the "P1" and "P2" files outlined in above.
  201.  
  202.  
  203. LIMITING ACCESS ON A SPECIFIC RADIO PORT
  204. ----------------------------------------
  205.  
  206. SYSOPs may desire to limit access on a specific radio port to only those BBSes
  207. that are involved in forwarding.  This would force normal users to access the
  208. system only on the alternate (open) radio port.  This arrangement is usually
  209. implemented when a network and frequency are designated for mail forwarding
  210. only in a geographical area.
  211.  
  212. The use of the KPC-4 BUDACLLS and CONLIST parameters will limit access on one
  213. (or both) ports to only those calls placed in the BUDCALLS list.  BUDCALLS can
  214. contain up to ten call signs (including SSIDs).  All calls NOT in the BUDCALLS
  215. list will be ignored when the CONLIST parameter is set to ON for the exclusive
  216. use port.
  217.  
  218. An example of the use of the BUDCALLS list is:
  219.  
  220.      BUDCALLS AD8I,N8FSY,KA3NVP
  221.  
  222. The CONLIST parameter may be set to one of the following:
  223.  
  224.      CONLIST ON/OFF    (radio port 1 set for exclusive use, radio port 2 open)
  225.    
  226.      CONLIST OFF/ON    (radio port 1 open, radio port 2 set for exclusive use)
  227.  
  228. Be sure that you don't set the BUDLIST parameter to ON, otherwise you will
  229. affect the stations that you can monitor when the BBS is idle.  Also note that
  230. any users that try to connect on the exclusive port but are not contained in
  231. the BUDCALLS list will not only fail to connect but also NOT recive a "Busy"
  232. message either.  The TNC actually IGNORES excluded calls as if they don't
  233. exist.
  234.  
  235.  
  236. CONCLUSION
  237. ----------
  238.  
  239. If you have any questions regarding the use of the Kantronics TNCs with the
  240. W0RLI Mailbox, pleae contact me via packet "@ KC8JN", located in eastern Ohio.
  241.  
  242. 73, Greg - KC8JN
  243.  
  244.