home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / archives / packetdrivers.tar.gz / pd.tar / src / pi.doc < prev    next >
Text File  |  1995-06-25  |  5KB  |  113 lines
  1. PI Packet Driver Notes (January 1992)
  2. --------------------------------------
  3.  
  4. See the file copying.doc for important information regarding this software.
  5.  
  6. Many of you have asked for a packet driver for the Ottawa PI card which
  7. is compliant with the specification from FTP Software, Inc.  The second
  8. release is now available. It has been tested with several NOS variants
  9. and found to be functional.  Not all the features of the compiled-in
  10. driver are implemented though, so don't throw out your existing NOS
  11. with PI card support!
  12.  
  13. It should be noted that any application used with this driver must be
  14. able to understand AX.25 formatted packets. In other words, the only
  15. practical use for it right now is to enable you to use variants of NOS
  16. which do not have PI card support compiled-in.
  17.  
  18. There is an exception to this rule. The driver may be re-assembled to provide
  19. "simulated ethernet" support, ie, the card can be made to look like 
  20. an ethernet card to application software. See the comments in pi.asm for
  21. details.
  22.  
  23. Limitations of this release:
  24.  
  25. 1. Only the A port (high speed port) works.
  26. 2. Unlike the built-in driver, parameters must be specified on the command
  27.    line at the time the driver tsr is installed. They can't be changed
  28.    while NOS is running.
  29. 3. There is no status command.
  30.  
  31. Install the driver (pi.com) with the command:
  32.  
  33. pi <packet_int> [hw_int] [io_addr] [dma] [baud] [TXD] [P] [slot] [tail]
  34.     [clocking mode] [Buffer size] [Number of buffers]
  35.  
  36. The parameters are as follows:
  37.  
  38. packet_int:     Software interrupt number the driver uses to communicate
  39.                 with the application.
  40.  
  41. hw_int:         The hardware interrupt in use. (set by a jumper on the card).
  42.                 The interrupt least likely to conflict with other hardware
  43.                 is IRQ 7.
  44.  
  45. io_addr:        The address of the PI card IO registers (jumper).
  46.  
  47. dma:            The DMA channel in use (jumper).  Usually channel 1.
  48.  
  49. baud:           The desired baud rate when internal clocking is used.
  50.                 Set to zero if external clocking is desired (as when using
  51.                 the WA4DSY modem).
  52.  
  53. TXD:            The transmit delay time in milliseconds. This is the time
  54.                 which flags are sent before the actual data is transmitted.
  55.  
  56. P:              Probability factor for the P-persistance algorithm (0..255).
  57.  
  58. slot:           Slot time in milliseconds for the P-persistance algorithm.
  59.  
  60. tail:           Delay time to allow the CRC and closing flag to be transmitted
  61.                 before the transmitter is turned off. This value is calculated
  62.                 by the driver if internal clocking is used, but may be over-
  63.                 ridden from the command line if desired (value in msec.).
  64.  
  65. clocking mode:  (new in version 2) If internal clocking is used (the baud
  66.                 parm is not 0), this parameter gives further control over the
  67.                 clocking. If it is 0 (default), the receive clock is recovered
  68.                 from the received data, and NRZI coding is used. This mode is
  69.         suitable for driving a modem which does not provide external
  70.         clocking signals. The maximum baud rate in this mode is 
  71.         28,800 bits/sec.
  72.  
  73.                 If clocking mode is set to 1, a clock signal is output on
  74.                 A-TXC, while receive clocking is derived from A_RXC. NRZ
  75.                 coding is used. This mode is useful for connecting PI cards
  76.                 back-to-back for example, because higher baud rates can be
  77.                 obtained.  I have obtained 460,800 bits/sec using this mode
  78.                 (your milage may vary).
  79.  
  80.                 A secondary effect of choosing mode 1 is that the baud
  81.                 rate is 32 times that specified by the baud parameter.
  82.  
  83. buffer size:    This parameter allows you to specify the amount of memory
  84.                 to reserve for DMA buffers. The default size is 2048.
  85.  
  86. number of buffers: The number of DMA buffers allocated to the driver. The
  87.                 default is 5, and the minimum is 3. 
  88.  
  89. For example:
  90. pi 0x7e 7 0x380 1 0 15 128 10 1 0 2048 5
  91.  
  92. If any parameters after the first one are left off, defaults as shown in the
  93. above example will be used. These are typical parameters for use with the
  94. WA4DSY modem. If the first one is left off, the driver will complain.
  95.  
  96. If you are using NOS, the attach command in autoexec.net should
  97. look like this:
  98.  
  99. attach packet <packet_int_no> <label> <buffers> <MTU> <IP ADDRESS>
  100.  
  101. For example:
  102. attach packet 0x7e pi0a 1 2000 your_IP_address
  103.  
  104. Make sure that you use a TCP MSS which is at least 40 bytes less than the
  105. MTU.  Also, best results will usually be obtained with TCP WINDOW = TCP MSS.
  106.  
  107. Please report your experiences with the driver to me, good or bad.
  108.  
  109. Dave Perry
  110. VE3IFB
  111. perryd@software.mitel.com
  112. ve3ifb@ve3jf.#eon.on.can
  113.