home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / ctcoll95.zip / BASTELST / PAPI020.ZIP / README < prev    next >
Text File  |  1993-10-06  |  5KB  |  134 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.20 05.Oct.1993
  16.  
  17.  
  18. The newest version will always be available through ftp.germany.eu.net.
  19. If you do not have access to ftp use their mail server:
  20. send mail to <archive-server@Germany.EU.net> and place the keyword "help" 
  21. in the body of the mail.
  22.  
  23. History - Why I wrote it:
  24. I use a small 286 MSDOS box as a router to the Internet (EUNET).
  25. The box is equipped with an ISDN card and an ethernet card.
  26. It connects my small network to the EUNET-POP via ISDN.
  27. The packet driver which came with the first ISDN board was not very
  28. stable.
  29.  
  30. I found a not too expensive ISDN board from teles Berlin.
  31. Their software interface is the ISDN-CAPI. The board is very simple
  32. (only two chips from Siemens). It is not intelligent (i.e. it does
  33. not have a processor on board).
  34.  
  35. I use ka9q and pc-route as routers.
  36. The only part missing was a piece of software interfacing ISDN-CAPI
  37. and ka9q. ka9q supports the packet driver interface very well.
  38. papi is the missing link.
  39.  
  40. Restrictions:
  41.     - only 1 application registered per program.
  42.     - only 1 controller supported per computer.
  43.     - only 1 papi packet driver per computer
  44.     - only 1 ISDN destination and the destination is fixed at the time
  45.       the driver is invoked.
  46.     - a tcp/ip packet has to be <= 2K
  47.     - only X75 and HDLC-UI frames as supported level 2 protocols.
  48.     - only tested with ka9q
  49.  
  50. It works now with Dr. Neuhaus Niccy 3008 and Niccy 1000 cards.
  51. With AVM-A1 and Teles S0 Boards.
  52. I did not arrive to make the packet driver work stable with the Diehl
  53. implementation of the CAPI. It might be the problem of my packet driver.
  54. Anyway they sell their own packet driver.
  55. The packet driver is exercising the interrupt scheme of a CAPI.
  56. It is working in a heavily interrupt driven environment.
  57.  
  58.  
  59. How to use PAPI:
  60.  
  61. First install the CAPI Interface you get with the ISDN-Card.
  62. Then install papi. It is a Terminate and Stay Resident (TSR) program.
  63. Then install the application you want to use i.e. ka9q.
  64.  
  65. Installation of papi:
  66.  
  67.     papi [-v] [-x] [-u] [-o eaz] -n telno [ -N telno1 ]
  68.          [-p PacketIntNo] [-c CAPIIntNo] [-w Timeout] [-s BufSize]
  69.          [ -S BufSize1 ]
  70.  
  71. -v    The packet driver is verbose when installing.
  72. -V LN    The packet driver is writing a status into line LN of the
  73.     display. Status resembles the display of an ISDN-Telephone.
  74. -x    Layer 2 protocol X75
  75. -u    Layer 2 protocol UI-HDLC Frames (default)
  76. -c INT    Soft interrupt of ISDN-CAPI (default 0xF1)
  77. -p INT    Soft interrupt of papi (default 0x60)
  78. -o eaz    The digit which selects calls to your card. (default 2). Has to be
  79.     between 1 and 8.
  80. -n ISDN# The ISDN number of the host you want to connect to. This is the
  81.     only host which might call back. If you do not give a number papi
  82.     is not installed. If the host is not identifying himself with
  83.     his number when calling the call is not accepted!
  84.     If you want to use Semi Permanent Circuits add an 's' to the number.
  85.     The ISDN number is not checked. It is passed directly to the capi.
  86. -N ISDN# The ISDN number of the host as it is given from the network.
  87.     Under certain conditions the number coming from the network is
  88.     different from the number you have to dial. The packet driver is
  89.     using this number as a sort of password.
  90. -i    ignore. Do not check the incoming caller id.
  91. -w n    The line is disconnected when idle for n seconds. (default 10)
  92. -s bytes maximal size for ip packets ( default and maximum 2048).
  93.     The actual maximum for NICCY 3008 is 1024.
  94. -S bytes size used for b2 protocol size.
  95. -P    The driver is working in a sort of polling mode. I.e. instead of
  96.     handling the incoming message in the interrupt only a mark is set
  97.     and the message is handled later in a timer interrupt.
  98.     The AVM-A1 Board is only working with this option.
  99.  
  100. Examples:
  101.  
  102.     # start the capi for your card:
  103.     START_S0
  104.     # start the packet driver:
  105.     c:\capi\papi -v -n 12345678 -o 3 -w 240 -u -c 0xF1 -p 0x60 -s 2048
  106.     # start your application (i.e. ka9q):
  107.     c:\nett\net -d c:\nett c:\nett\autoexec.net
  108.  
  109. More reasonable is:
  110.     c:\capi\papi -n 123456 -w 240
  111.  
  112. What else should you know:
  113.  
  114. Copyright: see file copy.
  115.  
  116. Acknowledgement:
  117. slfp.c, a C-language driver for 8250 slip written by
  118. Glenn H McGregor, and William A Simpson, served as a
  119. skeleton for papi.c. The printf is adapted from the 386BSD
  120. stand alone printf.
  121. The slightly changed getopt.c is coming with Turbo-C.
  122. Many thanks to teles GmbH, Berlin and Dr. Neuhaus, Hamburg for their support.
  123.  
  124. Comments, Questions, Error Reports, Support, Consulting ...:
  125. capi@friede.de
  126. Dietmar Friede, Westendstr. 117, D-80339 Muenchen, Germany.
  127. Do not expect me to answer fast or ever.
  128.  
  129. Registration:
  130. If you use capi, please fill out the file REGISTER and send it to
  131. capi@friede.de
  132.  
  133. Dietmar Friede
  134.