home *** CD-ROM | disk | FTP | other *** search
/ HAM Radio 1 / HamRadio.cdr / misc / bpq403a / switch.doc < prev    next >
Encoding:
Text File  |  1989-12-09  |  7.3 KB  |  187 lines
  1.     The G8BPQ AX25 Networking Package.
  2.  
  3.  
  4. 1. Introduction.
  5.  
  6. This software allows an IBM PC, or similar machine, equiped with suitable
  7. Communications hardware, to act as a Node in a NET/ROM compatible AX25 
  8. network, and/or to support a multiuser Mailbox, or other similar applications.
  9.  
  10. It supports multiple AX25 links, limited only by the connectivity of the 
  11. hardware and available storage. The interface to other software in the PC
  12. (Mailbox, application, or other terminal programs) is equivalent to a number
  13. (max 16, but possibly limited by memory requrements) of TNC's, accessed via
  14. the COMBIOS interface. One virtual TNC may be configured to run in a mode
  15. similar to the PK88 Host mode (for use with the UFQ BBS), others provide an
  16. interface similar to the TNC2.
  17.  
  18.  
  19. Note the software is NOT Public Domain. It may be used only by licenced
  20. Radio Amateurs in Amateur Packet Radio systems.
  21.  
  22.  
  23.  
  24. 2 Hardware Requirements.
  25.  
  26. The system is written in 8086 assembler, and is currently only available for
  27. the MSDOS/PCDOS environment, although once loaded it makes no use of operating
  28. system facilities. It has been tested on IBM PC and XT machines, and a number
  29. of similar machines. (AST Premium, Toshiba T1100+, OPUS). The software needs
  30. about 48 - 80k RAM, varying with number of buffers, comms links and COMBIOS
  31. ports configured.
  32.  
  33. Drivers are available for the following comms hardware:
  34.  
  35.     PAC-COM  PC120 card
  36.     DRSI PCPA card
  37.     Software Forge HDLC card for the Toshiba T1100 (with external modem).
  38.     KISS mode TNC via a standard PC ASYNC card or QUADRAM Quadport .
  39.     Link to NET/ROM or TheNet Async port.
  40.     RLC100 4 port HDLC card.
  41.  
  42. The system has been tested up to 38400 bps on a DRSI card
  43.  
  44.  
  45. The software should by modifyable to run on any system with the following:
  46.  
  47.     8086/88/186/286 Processor
  48.     64k RAM
  49.     32k ROM or Bootstrap ROM plus disk
  50.     Timer interrupt with resolution of at most 50ms (better 10ms)
  51.     Interrupt driven SCC comms port(s) with suitable modems
  52.  
  53.  
  54. 3. Networking Facilities.
  55.  
  56. The system is designed to be operationally compatible with existing NET/ROM
  57. or TheNet nodes, but there are a few minor differences. As it can support
  58. an integrated BBS, it has 2 Callsign/Alias pairs, one for accessing the node,
  59. and the other the BBS. Note, however, that a multiport node does not need a
  60. different callsign for each port. Because of the multiport support, the 
  61. 'Downlink' connect command needs a port number as the first parameter (eg
  62. C 2 G8BPQ). A connect to another Node doesnt need this - the system selects
  63. the 'best' port as found from the NODEs and ROUTEs lists.
  64.  
  65. Although multiple applications are allowed, only one (BBS) has its own
  66. Callsign/Alias pair. Others are accessed by connecting to the switch, then
  67. entering the service name.
  68.  
  69. There are  extra commands for normal use (BBS, or other application name, to
  70. connect to the applications, and PORTS to display available port descriptions),
  71. and 2 commands intended primarily for the system operator (STATS and LINKS).
  72.  
  73. Two extra commands PACLEN and L4T1 are available to set Paclen for NODE
  74. generated messages (nodes lists, etc), and the Transport timeout. At the
  75. moment these are primarily for me to experiment with, but feel free to fiddle.
  76.  
  77.  
  78. The system is also able to link to the 'back end' async port on a normal
  79. NET/ROM or TheNet node.
  80.  
  81.  
  82. 4. Mailbox/Application Support Facilities.
  83.  
  84.  
  85. The system may be configured to run multiple copies of WA7MBL/W0RLI/G4YFB
  86. BBS software, (or others designed to talk to a standard TNC using the COMBIOS
  87. interface) running under DesqView, or one copy of G8UFQ or AA4RE BBS,
  88. supporting up to 9 users via a single virtual 'Host Mode' TNC. The Mailbox
  89. callsign and alias are included in 'NODES' broadcasts, allowing level 4 
  90. connects direct to the BBS (ie it is not necessary to connect to the node, 
  91. then issue a connect to the BBS). The software has recently been tested with 
  92. BBS systems written by GW3TMH and G1NNA.
  93.  
  94.  
  95. Applications other than BBS must use the COMBIOS interface. (ie not Host Mode).
  96.  
  97.  
  98. 5. TNC Emulation Facilities.
  99.  
  100.  
  101. The Host Mode TNC emulation provides the minimum support necessary for use
  102. with the UFQ BBS.
  103.  
  104. The TNC2 emulation code accepts the following commands:
  105.  
  106.  
  107. CONOK ON/OFF    - Indicates the port is available for use. By default, it
  108.           will be for the BBS application. See APPL comand.
  109.  
  110.  
  111. APPL        - Bit significant field, to indicate which application the
  112.           port is supporting. The first three are reserved for BBS,
  113.           connects to the SYSOP (HOST support), and remote SYSOP
  114.           facilities. The other 5 are available for you to define your
  115.           own application servers (eg DATABASE, UNIX gateway).
  116.           Default is 01, the BBS.
  117.  
  118.           To allow users to connect to you (using the C command 
  119.           from the switch without a param), set APPL=02, and CONOK ON
  120.  
  121.  
  122. BBSMON ON/OFF    - Reduces the monitor output to calls only (enough to maintain
  123.           the JA list). Place in the MBL config file startup section.
  124.  
  125. MTX ON/OFF    - Monitors transmitted frames - mainly used for debugging
  126.  
  127. MONITOR ON/OFF    - As in normal TNC
  128. MALL ON/OFF
  129. MCOM ON/OFF
  130. MCON ON/OFF       Note that to monitor whilst connected to the Node, you 
  131.           need MCON ON 
  132.  
  133. MMASK         - Selects which (radio) ports will be monitored. A bit
  134.           significant field - setting bit 0 allows monitoring of 
  135.           the first port, bit 1 the second, and so on. Default is
  136.           hex FF, monitoring all radio ports. Setting it to zero
  137.           will suppress all monitoring.
  138.  
  139. The monitor code will decode and display the network headers from messages
  140. between nodes. This enables you to see what routes are being used between
  141. nodes, as well as removing a lot of garbage from the monitor display!
  142.  
  143.  
  144. NOMODE ON/OFF    The next 2 are accepted, but are not fully implemented. In 
  145. NEWMODE ON/OFF  general BBS connects assume NOMODE on, others NOMODE off.
  146.  
  147. CONNECT
  148.  
  149. To connect to the node, use the command NODE (or K). This is equivalent to
  150. connecting to a normal node. There is a (roughly) equivalent command
  151. C SWITCH, which returns the string *** CONNECTED to SWITCH, and is used
  152. in MBL forward files, as the MBL software is expecting the first connect
  153. to be at Level 2. A Connect command without a parameter returns the
  154. current state, again mainly for use by MBL software. A connect with any other
  155. parameter connects to the Node, then passes the command to the Node's command
  156. processor, thus allowing you to enter a normal Connect from either TNC or NODE
  157. command level.
  158.  
  159. CONV
  160. TRANS 
  161. UNPROTO CALL [VIA CALL ...]
  162. BTEXT
  163.  
  164. The CONV and TRANS command enter the appropriate state, and if not connected
  165. to the Node, allow you to send UI frames. This is used for the MBL 'Mail for
  166. xxxx' broadcasts, and can be used for CQ's , etc. Beaconing is not supported,
  167. but the BTEXT text is saved, and may be send instead of the predefined ID
  168. message at intervals. This is primarily for RLI 'MAIL' beacons.
  169.  
  170.  
  171. Note that K is an abbreviation for NODE, not CONV, as in a normal TNC, as 
  172. normally you want to switch easily between TNC command and Node command modes.
  173.  
  174. SENDPAC
  175. CPACTIME    
  176. CR        - As normal TNC.
  177.  
  178. FLOW ON/OFF    - Similar to normal TNC, but a bit simpler. in particular
  179.           echoing is suppressed, so if you need to use FLOW ON, I
  180.           suggest you set ECHO OFF
  181.  
  182.  
  183.                             John Wiseman, G8BPQ
  184.                             9 Dec 89.
  185.  
  186.  
  187.