home *** CD-ROM | disk | FTP | other *** search
/ HAM Radio 3 / hamradioversion3.0examsandprograms1992.iso / misc / drsi110 / hapndrsi.doc < prev    next >
Text File  |  1990-08-15  |  5KB  |  114 lines
  1.  
  2. HAPNDRSI Device Driver for the DRSI PC-Packet Adapter
  3.  
  4. by Jack Botner, VE3LNY             August 15, 1990
  5.  
  6. (C) Copyright HAPN Hamilton and Area Packet Network 1990
  7.  
  8. Jack Botner                        H. A. P. N.
  9. 222 Divadale Drive                 Box 4466, Station D
  10. Toronto, Ontario                   Hamilton, Ontario
  11. Canada   M4G 2P7                   Canada   L8V 4S7
  12.  
  13. Compuserve: 73327,176 (private mail only, please)
  14.  
  15.  
  16.    Introduction
  17.    ------------
  18.  
  19. This device driver allows the DRSI PC-Packet Adapter to operate with
  20. the HAPN-1 software. The software developed to support the HAPN-1
  21. adapter is very user-friendly and provides a high level of function.
  22. In the HAPN implementation, all Level-1 (hardware) support functions
  23. are done by the DOS device driver, making it possible to support
  24. different adapters by changing only the device driver. Higher-level
  25. functions (AX.25, KISS, etc.) are provided by separate modules that
  26. are independent of the hardware that is being used.
  27.  
  28. This driver is installed as a DOS device driver by placing an entry in
  29. CONFIG.SYS. It takes over all the hardware functions related to the
  30. adapter and provides an application program interface for accessing
  31. the packet queues and other adapter functions.
  32.  
  33. To use this device driver with MSYS, a module named HAPNKISS.COM is
  34. required to provide the KISS interface between MSYS and the device
  35. driver. Alternatively, the HAPN AX.25 Program Library (available from
  36. HAPN) may be used to provide the usual AX.25 communications support.
  37.  
  38.  
  39.    Installing HAPNDRSI.SYS
  40.    -----------------------
  41.  
  42. HAPNDRSI.SYS is installed by placing a device entry in your boot disk
  43. CONFIG.SYS file. For floppy disk only systems, a copy of HAPNDRSI.SYS must
  44. be placed on the boot diskette. The CONFIG.SYS entry appears as follows.
  45. All command line parameters appear within square brackets, which means
  46. that they are optional. The default values are satisfactory for most
  47. installations. If the parameters are coded, they must not contain any
  48. blanks between the parameters.
  49.  
  50.     device=[d:\path\]hapndrsi.sys [base=bbb][,irq=i][,ttsiz=z][,cts0=xx]
  51.                                   [,duplex0=yyy][,cts1=xx][,duplex1=yyy]
  52.                                   [,rxbuffers=rr][,txbuffers=tt]
  53.                                   [,baud0=nnnn][,baud1=nnnn][,pri=y]
  54.                                   [,tim=alt]
  55.  
  56. where bbb is the adapter 8530 base address (in hex). The default
  57.           value is 300. This value must match the setting of sw1-1.
  58.         i is the IRQ (interrupt) level. Values may be 0 through 7, and
  59.           the default value is 2. This value must match the setting
  60.           of sw1-3 through 8.
  61.        rr is the number of Rx buffers to allocate. Minimum
  62.           number is 5, maximum number is 25, default number is 10.
  63.        tt is the number of Tx buffers to allocate. Minimum
  64.           number is 5, maximum number is 30, default number is 15.
  65.        xx is the clear-to-send delay for each port in timer ticks (55 ms).
  66.           Values are 0 to 99, with default value 0.
  67.       yyy is hdx or fdx (only 1st letter scanned). Default is hdx.
  68.         z is the size of the trace table in kbytes. May be between
  69.           1 and 9. The default value is 4. Set it smaller to conserve
  70.           memory and larger to do datastream debugging.
  71.      nnnn to specify the baud rate when the driver is used with an
  72.           application that is unable to set up the baudrate. The
  73.           default value is 1200.
  74.     pri=y tells the driver to change the priority on the 8259 interrupt
  75.           controller so that the irq level specified for this adapter
  76.           has the highest priority. Don't use this unless you understand
  77.           what you're doing. Mainly used when interrupt overruns and
  78.           underruns are a problem.
  79.   tim=alt tells the driver to use int 1c (hex) for the timer tick
  80.           interrupt instead of int 8. Int 8 is generally more reliable
  81.           when programs are run that use the timer tick interrupt but
  82.           do not share it properly; however in some cases it may be
  83.           desired to use int 1c instead.
  84.  
  85. In its default configuration, HAPNDRSI.SYS uses 25K of memory. The amount
  86. of memory depends on the number of Rx and Tx buffers allocated, and the
  87. size of the trace table. For example, if you specify 8 Rx and 10 Tx
  88. buffers, and a 1K trace table, 20K of memory will be taken. If you're
  89. short of memory try using the minimum buffers but performance may suffer
  90. badly at high packet volumes.
  91.  
  92. Example of CONFIG.SYS entry with no command line parameters:
  93.  
  94.     device=hapndrsi.sys
  95.  
  96.   or
  97.  
  98.     device=c:\msys\hapndrsi.sys
  99.  
  100. Example of CONFIG.SYS entry with command line parameters to minimize
  101. memory requirements and use different irq interrupt:
  102.  
  103.     device=hapndrsi.sys irq=7,rxbuf=5,txbuf=5,ttsiz=1
  104.  
  105.  
  106.    Caution
  107.    -------
  108.  
  109. This software is currently at BETA test level. It probably contains
  110. some bugs. If you experience a problem with it, try to describe the
  111. environment and symptoms as thoroughly as possible and let me know about
  112. it. I'll try to fix it if I can.
  113.  
  114.