home *** CD-ROM | disk | FTP | other *** search
/ HAM Radio 3 / hamradioversion3.0examsandprograms1992.iso / bbs / msys113 / msyshapn.doc < prev    next >
Text File  |  1991-01-04  |  7KB  |  164 lines
  1.  
  2. MSYS Support for HAPN-1 and DRSI PC-Packet Adapters
  3. (C) Copyright HAPN Hamilton and Area Packet Network, 1990
  4.  
  5. Jack Botner, VE3LNY
  6. 222 Divadale Drive
  7. Toronto, Ontario
  8. Canada   M4G 2P7
  9.  
  10. Aug. 15, 1990
  11.  
  12.  
  13. Support for the HAPN-1 and PC-Packet adapters is available in MSYS
  14. version 1.09 and later. This support is made up of the following
  15. components:
  16.  
  17. 1. An interface built into MSYS. Until version 1.09, MSYS would talk
  18.    only to KISS TNCs attached via serial port. An interface was added
  19.    to optionally talk to any other device using a software interrupt
  20.    vector. The alternate interface is selected by a certain specification
  21.    in the port name.
  22.  
  23. 2. The use of a HAPN device driver for either the HAPN-1 adapter or the
  24.    PC-Packet adapter. These device drivers provide hardware support for
  25.    the adapters and a programming interface for applications.
  26.  
  27. 3. A KISS application interface that works between the new MSYS software
  28.    interrupt interface and the HAPN device driver. The HAPN device
  29.    driver provides a simple block-oriented interface to the application
  30.    program; this module converts this interface to the KISS standard
  31.    used by MSYS.
  32.  
  33. With these components in place and the proper port specification in the
  34. MSYS.OPT file, MSYS will use the HAPN-1 and PC-Packet adapters like
  35. another port.
  36.  
  37.  
  38. MSYS Interface
  39.  
  40. You must have version 1.09 or later. To specify a HAPN-1 or PC-Packet
  41. adapter, you must set up a PORT statement in MSYS.OPT with a port
  42. name beginning with an *. For example,
  43.  
  44.     port 0 at $0 int 4 speed 1200 name *HAPN-1
  45.  
  46. For a system with 2 HAPN-1 adapters or 1 PC-Packet adapter,
  47.  
  48.     port 0 at $0 int 4 speed 4800 name *port0
  49.     port 1 at $1 int 4 speed 1200 name *port1
  50.  
  51. Please note that the information normally used by MSYS to access a
  52. serial port, the interrupt level, and the serial port line speed are
  53. irrelevant. The port number is important for the reasons stated in the
  54. MSYS documentation, and the port name beginning with * is critical to
  55. the port being recognized as using the alternate software vector
  56. interface; however after the * the name may be anything you like.
  57.  
  58.  
  59. HAPN Device Driver
  60.  
  61. If you own a HAPN-1 adapter, you are already familiar with the device
  62. driver HAPN1.SYS used with the software package. (If you have an old
  63. version, you should know that the current HAPN-1 software supports
  64. multiple connects and multiple ports. Software updates are available
  65. for $10 US for registerd customers, and $35 US for others.)  HAPN
  66. has also developed an 8530 device driver, called HAPNDRSI.SYS, that
  67. works with the PC-Packet adapter and provides the identical function. You
  68. need one or the other of these device drivers depending on which adapter
  69. you are using. The specification for loading one of these device drivers
  70. may be found in a separate document for each driver. Hardware-related
  71. parameters such as adapter address, interrupt level, etc. are specified
  72. on the command line in CONFIG.SYS. The driver will be loaded when you
  73. boot your system. Watch your screen when you boot up. The device driver
  74. will display a number of messages indicating that it has been loaded, or
  75. an error message if a parameter is in error.  If the driver does not load,
  76. the port cannot be used.
  77.  
  78. Further documentation on the HAPN-1 device driver may be found in file
  79. HAPN-API.DOC, and on the PC-Packet driver in file HAPNDRSI.DOC.
  80.  
  81.  
  82. HAPNKISS Interface Module
  83.  
  84. Finally, before running MSYS, load HAPNKISS.COM. It is a small TSR
  85. program that searches out the HAPN-1/PC-Packet device drivers then
  86. sets up the software interrupt for MSYS to use. The default interrupt
  87. is D0 (hex). Loading HAPNKISS is as simple as typing HAPNKISS and
  88. pressing enter, but the following things should be kept in mind:
  89.  
  90. 1. MSYS uses vector D0 by default, and so does HAPNKISS. However if
  91.    it is necessary to use a different vector, the vector can be
  92.    specified on the command line as follows:
  93.  
  94.         HAPNKISS 9E
  95.  
  96.    The 2-digit hexadecimal number (upper case not necessary) will be
  97.    interpreted as the interrupt vector to use instead of D0. (Don't
  98.    ask me how to make MSYS use a different vector 'cause I don't know.)
  99.  
  100. 2. HAPNKISS expects the vector (4 bytes in low memory) to contain all
  101.    zeroes. If it does not, another program could be using this vector,
  102.    or it just may not have been initialized properly. If you determine
  103.    that it is ok to use the vector even when it does not contain zeroes,
  104.    add /f to the command line, for example:
  105.  
  106.         HAPNKISS /F
  107.  
  108.    You will know if there is a problem because when /f is not present,
  109.    HAPNKISS will not load, and displays an error message when the vector
  110.    is not zeroes. Adding the /f parameter overrides the error and
  111.    HAPNKISS will load.
  112.  
  113. 3. You cannot load HAPNKISS twice. If you try, an error message will
  114.    be displayed. One copy of HAPNKISS can support up to 4 ports made up
  115.    of HAPN-1 and PC-Packet adapters. To get rid of HAPNKISS, re-boot.
  116.  
  117. 4. When it loads, HAPNKISS reports all the ports it recognizes. You
  118.    could have up to 4 ports made up of HAPN-1 and PC-Packet adapters.
  119.    The report will give you the information you need to set up the
  120.    PORT statements for MSYS.OPT. So, if you are using more than one
  121.    of these ports, set up the device drivers, boot your system, and
  122.    load HAPNKISS to see what the ports are, then use the information
  123.    to set up the MSYS PORT statements.
  124.  
  125. 5. HAPNKISS uses the timer tick interrupt for timing purposes. It
  126.    takes over interrupt 8, and when it is done, calls the previous
  127.    int 8 address. If desired, HAPNKISS can be made to use interrupt
  128.    vector 1c (hex) instead, by adding the switch /a or /A on the
  129.    HAPNKISS command line. The HAPN-1 adapter manual contains more
  130.    information on the use of the timer tick interrupt by the HAPN-1
  131.    programs.
  132.  
  133.  
  134. Terms of Distribution
  135.  
  136. The HAPN device drivers and the KISS interface are available from HAPN
  137. at the above address. $5 US is required to cover the cost of diskette,
  138. mailer, and postage.
  139.  
  140. This software is distributed under the following conditions:
  141.  
  142. 1. It may be used for Amateur Radio purposes only.
  143.  
  144. 2. It may be re-distributed to other amateurs for use with MSYS only.
  145.    In this case, it should be distributed as a package including this
  146.    documentation.
  147.  
  148. 3. The programs are Copyright HAPN (Hamilton and Area Packet Network).
  149.    THEY MAY NOT BE USED FOR ANY PURPOSE BY ANY COMMERCIAL ORGANIZATION,
  150.    OR REDISTRIBUTED BY ANYONE FOR A PRICE. HAPN has put a lot of work
  151.    into these programs that we are distributing for free, and we don't
  152.    want anyone else making profits from them.
  153.  
  154. 4. The programs are distributed "as is". HAPN will endeavor to provide
  155.    support to users experiencing problems with them, but time can only
  156.    be allocated as available. In addition, the multitude of PC
  157.    configurations in use is not available to us, so we may not be able
  158.    to reproduce your problem.
  159.  
  160. 5. The HAPNDRSI.SYS driver is at Beta test level. If you have a problem,
  161.    please report it to us. Messages can be sent to VE3LNY @VE3NUU or
  162.    private mail on Compuserve ID 73327,176 or to the address above.
  163.  
  164.