home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / archives / packetdrivers.tar.gz / pd.tar / new / papi.hlp < prev    next >
Text File  |  1993-09-13  |  6KB  |  144 lines
  1. In this directory you find the sources for papi:
  2.  
  3. PAPI is a Packet driver for the isdn common API. 
  4. It is a MSDOS terminate and stay resident program.
  5. Compiled with tcc and tasm.
  6.  
  7. The Common ISDN API (ISDN-CAPI) is an interface defined by german telecom
  8. and german ISDN Cards manufacturer.
  9. The ISDN-CAPI supported is version 1.1, Profile A of 7.Sep.90
  10.  
  11. The packet interface implemented is version 1.09.
  12. The implemented class is slip.
  13.  
  14. This version:
  15. VERSION 0.17 02.Sep.1993
  16. is for tests only. It is an intermediate version. I will try to make a version
  17. 0.2 available end of September 93.
  18. It is still a prototype.
  19.  
  20. The newest version will always be available through ftp.germany.eu.net.
  21. If you do not have access to ftp use their mail server:
  22. send mail to <archive-server@Germany.EU.net> and place the keyword "help" 
  23. in the body of the mail.
  24.  
  25. History - Why I wrote it:
  26. I use a small 286 MSDOS box as a router to the Internet (EUNET).
  27. The box is equipped with an ISDN card and an ethernet card.
  28. It connects my small network to the EUNET-POP via ISDN.
  29. The packet driver which came with the first ISDN board was not very
  30. stable.
  31.  
  32. I found a not too expensive ISDN board from teles Berlin.
  33. Their software interface is the ISDN-CAPI. The board is very simple
  34. (only two chips from Siemens). It is not intelligent (i.e. it does
  35. not have a processor on board).
  36.  
  37. I use ka9q and pc-route as routers.
  38. The only part missing was a piece of software interfacing ISDN-CAPI
  39. and ka9q. ka9q supports the packet driver interface very well.
  40. papi is the missing link.
  41.  
  42. Restrictions:
  43.     - only 1 application registered per program.
  44.     - only 1 controller supported per computer.
  45.     - only 1 papi packet driver per computer
  46.     - only 1 ISDN destination and the destination is fixed at the time
  47.       the driver is invoked.
  48.     - a tcp/ip packet has to be <= 2K
  49.     - only X75 and HDLC-UI frames as supported level 2 protocols.
  50.     - only tested with ka9q
  51.  
  52. It works now with Dr. Neuhaus Niccy 3008 and Niccy 1000 cards.
  53. With AVM-A1 and Teles S0 Boards.
  54. I did not arrive to make the packet driver work stable with the Diehl
  55. implementation of the CAPI. It might be the problem of my packet driver.
  56. It is working in a heavily interrupt driven environment.
  57.  
  58. Todo:
  59. A lot of stuff in the code is constant what should be variable.
  60. A lot of constants are numeric and not defined in include files.
  61. There is still a lot of code which helped me to understand and debug.
  62. There are some error states which are not handled.
  63. The "state machine" in apiintr.c will be rewritten as soon as I have
  64. nothing better to do.
  65. I will write an interface to pcroute as soon as possible.
  66. Test and debug with different ISDN-Cards and their implementations of
  67. ISDN-CAPI.
  68.  
  69. How to use it:
  70.  
  71. First install the CAPI Interface you get with the ISDN-Card.
  72. Then install papi. It is a Terminate and Stay Resident (TSR) program.
  73. Then install the application you want to use i.e. ka9q.
  74.  
  75. Installation of papi:
  76.  
  77.     papi [-v] [-x] [-u] [-o eaz] -n telno [ -N telno1 ]
  78.          [-p PacketIntNo] [-c CAPIIntNo] [-w Timeout] [-s BufSize]
  79.          [ -S BufSize1 ]
  80.  
  81. -v    The packet driver is verbose when installing.
  82. -V    The packet driver is writing a status line in upper line of the
  83.     display. You should only use it to debug the driver. It degrades
  84.     performance heavily.
  85. -x    Layer 2 protocol X75
  86. -u    Layer 2 protocol UI-HDLC Frames (default)
  87. -c INT    Soft interrupt of ISDN-CAPI (default 0xF1)
  88. -p INT    Soft interrupt of papi (default 0x60)
  89. -o eaz    The digit which selects calls to your card. (default 2). Has to be
  90.     between 1 and 8.
  91. -n ISDN# The ISDN number of the host you want to connect to. This is the
  92.     only host which might call back. If you do not give a number papi
  93.     is not installed. If the host is not identifying himself with
  94.     his number when calling the call is not accepted!
  95. -N ISDN# The ISDN number of the host as it is given from the network.
  96.     Under certain conditions the number coming from the network is
  97.     different from the number you have to dial. The packet driver is
  98.     using this number as a sort of password.
  99.     The ISDN number is not checked. It is passed directly to the capi.
  100. -i    ignore. Do not check the incoming caller id.
  101. -w n    The line is disconnected when idle for n seconds. (default 10)
  102. -s bytes maximal size for ip packets ( default and maximum 2048).
  103.     The actual maximum for NICCY 3008 is 1024.
  104. -S bytes size used for b2 protocol size.
  105. -P    The driver is working in a sort of polling mode. I.e. instead of
  106.     handling the incoming message in the interrupt only a mark is set
  107.     and the message is handled later in a timer interrupt.
  108.     The AVM-A1 Board is only working with this option.
  109.  
  110. Examples:
  111.  
  112.     # start the capi for your card:
  113.     START_S0
  114.     # start the packet driver:
  115.     c:\capi\papi -v -n 12345678 -o 3 -w 240 -u -c 0xF1 -p 0x60 -s 2048
  116.     # start your application (i.e. ka9q):
  117.     c:\nett\net -d c:\nett c:\nett\autoexec.net
  118.  
  119. More reasonable is:
  120.     c:\capi\papi -n 123456 -w 240
  121.  
  122. What else should you know:
  123.  
  124. Copyright: see file copy.
  125.  
  126. Acknowledgement:
  127. slfp.c, a C-language driver for 8250 slip written by
  128. Glenn H McGregor, and William A Simpson, served as a
  129. skeleton for papi.c. The printf is adapted from the 386BSD
  130. stand alone printf.
  131. The slightly changed getopt.c is coming with Turbo-C.
  132. Many thanks to Dr. Neuhaus, Hamburg for their support.
  133.  
  134. Comments, Questions, Error Reports, Support, Consulting ...:
  135. capi@friede.de
  136. Dietmar Friede, Friede Consulting,
  137. Westendstr. 117, D-8 Muenchen 2, Germany. Please write do not call.
  138.  
  139. Registration:
  140. If you use capi, please fill out the file REGISTER and send it to
  141. capi@friede.de
  142.  
  143. Dietmar Friede
  144.