The Design and Implementation of the FreeBSD Operating System, Second Edition
Now available: The Design and Implementation of the FreeBSD Operating System (Second Edition)


[ source navigation ] [ identifier search ] [ freetext search ] [ file search ] [ list types ] [ track identifier ]

FreeBSD/Linux Kernel Cross Reference
sys/Documentation/isdn/

Version: -  FREEBSD  -  FREEBSD-13-STABLE  -  FREEBSD-13-0  -  FREEBSD-12-STABLE  -  FREEBSD-12-0  -  FREEBSD-11-STABLE  -  FREEBSD-11-0  -  FREEBSD-10-STABLE  -  FREEBSD-10-0  -  FREEBSD-9-STABLE  -  FREEBSD-9-0  -  FREEBSD-8-STABLE  -  FREEBSD-8-0  -  FREEBSD-7-STABLE  -  FREEBSD-7-0  -  FREEBSD-6-STABLE  -  FREEBSD-6-0  -  FREEBSD-5-STABLE  -  FREEBSD-5-0  -  FREEBSD-4-STABLE  -  FREEBSD-3-STABLE  -  FREEBSD22  -  l41  -  OPENBSD  -  linux-2.6  -  MK84  -  PLAN9  -  xnu-8792 
SearchContext: -  none  -  3  -  10 

Name Size Last modified (GMT) Description
Back Parent directory 2013-02-02 13:13:18
File CREDITS 1965 bytes 2008-12-11 08:29:15 list of the kind folks that brought you this stuff.
File HiSax.cert 3990 bytes 2006-12-13 11:48:13 information about the ITU approval certification of the HiSax driver.
File INTERFACE 27817 bytes 2006-12-13 11:48:13 description of isdn4linux Link Level and Hardware Level interfaces.
File INTERFACE.CAPI 14486 bytes 2011-08-10 17:02:06 description of kernel CAPI Link Level to Hardware Level interface.
File INTERFACE.fax 4584 bytes 2006-12-13 11:48:13 description of the fax subinterface of isdn4linux.
File README 29288 bytes 2010-08-24 17:11:36 general info on what you need and what to do for Linux ISDN.
File README.FAQ 721 bytes 2006-12-13 11:48:13 general info for FAQ.
File README.HiSax 23865 bytes 2011-08-10 17:02:06 info on the HiSax driver which replaces the old teles.
File README.act2000 3564 bytes 2006-12-13 11:48:13 info on driver for IBM ACT-2000 card.
File README.audio 5953 bytes 2006-12-13 11:48:13 info for running audio over ISDN.
File README.avmb1 5673 bytes 2006-12-13 11:48:13 info on driver for AVM-B1 ISDN card.
File README.concap 10745 bytes 2008-01-26 22:43:18 info on "CONCAP" encapsulation protocol interface used for X.25.
File README.diversion 6223 bytes 2006-12-13 11:48:13 info on module for isdn diversion services.
File README.fax 1111 bytes 2006-12-13 11:48:13 info for using Fax over ISDN.
File README.gigaset 17971 bytes 2012-12-25 01:40:47 info on the drivers for Siemens Gigaset ISDN adapters
File README.hfc-pci 1812 bytes 2006-12-13 11:48:13 info on hfc-pci based cards.
File README.hysdn 7945 bytes 2006-12-13 11:48:13
File README.icn 5099 bytes 2007-07-05 23:08:24 info on the ICN-ISDN-card and its driver.
File README.mISDN 328 bytes 2008-12-11 08:29:15 info on the Modular ISDN subsystem (mISDN)
File README.pcbit 1670 bytes 2006-12-13 11:48:13 info on the PCBIT-D ISDN adapter and driver.
File README.sc 12158 bytes 2006-12-13 11:48:13 info on driver for Spellcaster cards.
File README.syncppp 2167 bytes 2006-12-13 11:48:13 info on running Sync PPP over ISDN.
File README.x25 7281 bytes 2006-12-13 11:48:13 info for running X.25 over ISDN.
File syncPPP.FAQ 8063 bytes 2006-12-13 11:48:13 frequently asked questions about running PPP over ISDN.

    1 README for the ISDN-subsystem
    2 
    3 1. Preface
    4 
    5   1.1 Introduction
    6 
    7   This README describes how to set up and how to use the different parts
    8   of the ISDN-subsystem.
    9 
   10   For using the ISDN-subsystem, some additional userlevel programs are
   11   necessary. Those programs and some contributed utilities are available
   12   at
   13 
   14    ftp.isdn4linux.de
   15 
   16    /pub/isdn4linux/isdn4k-utils-<VersionNumber>.tar.gz
   17 
   18 
   19   We also have set up a mailing-list:
   20 
   21    The isdn4linux-project originates in Germany, and therefore by historical
   22    reasons, the mailing-list's primary language is german. However mails
   23    written in english have been welcome all the time.
   24 
   25    to subscribe: write a email to majordomo@listserv.isdn4linux.de,
   26    Subject irrelevant, in the message body:
   27    subscribe isdn4linux <your_email_address>
   28 
   29    To write to the mailing-list, write to isdn4linux@listserv.isdn4linux.de
   30 
   31    This mailinglist is bidirectionally gated to the newsgroup
   32 
   33      de.alt.comm.isdn4linux
   34 
   35   There is also a well maintained FAQ in English available at
   36      http://www.mhessler.de/i4lfaq/
   37   It can be viewed online, or downloaded in sgml/text/html format.
   38   The FAQ can also be viewed online at
   39      http://www.isdn4linux.de/faq/
   40   or downloaded from
   41      ftp://ftp.isdn4linux.de/pub/isdn4linux/FAQ/
   42 
   43   1.1 Technical details
   44 
   45   In the following Text, the terms MSN and EAZ are used.
   46 
   47   MSN is the abbreviation for (M)ultiple(S)ubscriber(N)umber, and applies
   48   to Euro(EDSS1)-type lines. Usually it is simply the phone number.
   49 
   50   EAZ is the abbreviation of (E)ndgeraete(A)uswahl(Z)iffer and
   51   applies to German 1TR6-type lines. This is a one-digit string,
   52   simply appended to the base phone number
   53 
   54   The internal handling is nearly identical, so replace the appropriate
   55   term to that one, which applies to your local ISDN-environment.
   56 
   57   When the link-level-module isdn.o is loaded, it supports up to 16
   58   low-level-modules with up to 64 channels. (The number 64 is arbitrarily
   59   chosen and can be configured at compile-time --ISDN_MAX in isdn.h).
   60   A low-level-driver can register itself through an interface (which is
   61   defined in isdnif.h) and gets assigned a slot.
   62   The following char-devices are made available for each channel:
   63 
   64   A raw-control-device with the following functions:
   65      write: raw D-channel-messages (format: depends on driver).
   66      read:  raw D-channel-messages (format: depends on driver).
   67      ioctl: depends on driver, i.e. for the ICN-driver, the base-address of
   68             the ports and the shared memory on the card can be set and read
   69             also the boot-code and the protocol software can be loaded into
   70             the card.
   71 
   72    O N L Y !!!  for debugging (no locking against other devices):
   73    One raw-data-device with the following functions:
   74      write: data to B-channel.
   75      read:  data from B-channel.
   76 
   77    In addition the following devices are made available:
   78 
   79    128 tty-devices (64 cuix and 64 ttyIx) with integrated modem-emulator:
   80    The functionality is almost the same as that of a serial device
   81    (the line-discs are handled by the kernel), which lets you run
   82    SLIP, CSLIP and asynchronous PPP through the devices. We have tested
   83    Seyon, minicom, CSLIP (uri-dip) PPP, mgetty, XCept and Hylafax. 
   84 
   85    The modem-emulation supports the following:
   86            1.3.1 Commands:
   87 
   88                ATA      Answer incoming call.
   89                ATD<No.> Dial, the number may contain:
   90                         [0-9] and [,#.*WPT-S]
   91                         the latter are ignored until 'S'.
   92                         The 'S' must precede the number, if
   93                         the line is a SPV (German 1TR6).
   94                ATE0     Echo off.
   95                ATE1     Echo on (default).
   96                ATH      Hang-up.
   97                ATH1     Off hook (ignored).
   98                ATH0     Hang-up.
   99                ATI      Return "ISDN for Linux...".
  100                ATI0        "
  101                ATI1        "
  102                ATI2     Report of last connection.
  103                ATO      On line (data mode).
  104                ATQ0     Enable result codes (default).
  105                ATQ1     Disable result codes (default).
  106                ATSx=y   Set register x to y.
  107                ATSx?    Show contents of register x.
  108                ATV0     Numeric responses.
  109                ATV1     English responses (default).
  110                ATZ      Load registers and EAZ/MSN from Profile.
  111                AT&Bx    Set Send-Packet-size to x (max. 4000)
  112                         The real packet-size may be limited by the
  113                         low-level-driver used. e.g. the HiSax-Module-
  114                         limit is 2000. You will get NO Error-Message,
  115                         if you set it to higher values, because at the
  116                         time of giving this command the corresponding
  117                         driver may not be selected (see "Automatic
  118                         Assignment") however the size of outgoing packets
  119                         will be limited correctly.
  120                AT&D0    Ignore DTR
  121                AT&D2    DTR-low-edge: Hang up and return to
  122                         command mode (default).
  123                AT&D3    Same as AT&D2 but also resets all registers.
  124                AT&Ex    Set the EAZ/MSN for this channel to x.
  125                AT&F     Reset all registers and profile to "factory-defaults"
  126                AT&Lx    Set list of phone numbers to listen on.  x is a
  127                         list of wildcard patterns separated by semicolon.
  128                         If this is set, it has precedence over the MSN set
  129                         by AT&E.
  130                AT&Rx    Select V.110 bitrate adaption.
  131                         This command enables V.110 protocol with 9600 baud
  132                         (x=9600), 19200 baud (x=19200) or 38400 baud
  133                         (x=38400). A value of x=0 disables V.110 switching
  134                         back to default X.75. This command sets the following
  135                         Registers:
  136                           Reg 14 (Layer-2 protocol):
  137                             x = 0:     0
  138                             x = 9600:  7
  139                             x = 19200: 8
  140                             x = 38400: 9
  141                           Reg 18.2 = 1
  142                           Reg 19 (Additional Service Indicator):
  143                             x = 0:       0
  144                             x = 9600:  197
  145                             x = 19200: 199
  146                             x = 38400: 198
  147                           Note on value in Reg 19:
  148                             There is _NO_ common convention for 38400 baud.
  149                             The value 198 is chosen arbitrarily. Users
  150                             _MUST_ negotiate this value before establishing
  151                             a connection.
  152                AT&Sx    Set window-size (x = 1..8) (not yet implemented)
  153                AT&V     Show all settings.
  154                AT&W0    Write registers and EAZ/MSN to profile. See also
  155                         iprofd (5.c in this README).
  156                AT&X0    BTX-mode and T.70-mode off (default)
  157                AT&X1    BTX-mode on. (S13.1=1, S13.5=0 S14=0, S16=7, S18=7, S19=0)
  158                AT&X2    T.70-mode on. (S13.1=1, S13.5=1, S14=0, S16=7, S18=7, S19=0)
  159                AT+Rx    Resume a suspended call with CallID x (x = 1,2,3...)
  160                AT+Sx    Suspend a call with CallID x (x = 1,2,3...)
  161 
  162            For voice-mode commands refer to README.audio
  163 
  164            1.3.2 Escape sequence:
  165                During a connection, the emulation reacts just like
  166                a normal modem to the escape sequence <DELAY>+++<DELAY>.
  167                (The escape character - default '+' - can be set in the
  168                register 2).
  169                The DELAY must at least be 1.5 seconds long and delay
  170                between the escape characters must not exceed 0.5 seconds.
  171 
  172            1.3.3 Registers:
  173 
  174               Nr.  Default  Description
  175               0    0        Answer on ring number.
  176                             (no auto-answer if S0=0).
  177               1    0        Count of rings.
  178               2    43       Escape character.
  179                             (a value >= 128 disables the escape sequence).
  180               3    13       Carriage return character (ASCII).
  181               4    10       Line feed character (ASCII).
  182               5    8        Backspace character (ASCII).
  183               6    3        Delay in seconds before dialing.
  184               7    60       Wait for carrier.
  185               8    2        Pause time for comma (ignored)
  186               9    6        Carrier detect time (ignored)
  187              10    7        Carrier loss to disconnect time (ignored).
  188              11    70       Touch tone timing (ignored).
  189              12    69       Bit coded register:
  190                             Bit 0:    0 = Suppress response messages.
  191                                       1 = Show response messages.
  192                             Bit 1:    0 = English response messages.
  193                                       1 = Numeric response messages.
  194                             Bit 2:    0 = Echo off.
  195                                       1 = Echo on.
  196                             Bit 3     0 = DCD always on.
  197                                       1 = DCD follows carrier.
  198                             Bit 4     0 = CTS follows RTS
  199                                       1 = Ignore RTS, CTS always on.
  200                             Bit 5     0 = return to command mode on DTR low.
  201                                       1 = Same as 0 but also resets all
  202                                           registers.
  203                                       See also register 13, bit 2
  204                             Bit 6     0 = DSR always on.
  205                                       1 = DSR only on if channel is available.
  206                             Bit 7     0 = Cisco-PPP-flag-hack off (default).
  207                                       1 = Cisco-PPP-flag-hack on.
  208              13   0         Bit coded register:
  209                             Bit 0:    0 = Use delayed tty-send-algorithm
  210                                       1 = Direct tty-send.
  211                             Bit 1:    0 = T.70 protocol (Only for BTX!) off
  212                                       1 = T.70 protocol (Only for BTX!) on
  213                             Bit 2:    0 = Don't hangup on DTR low.
  214                                       1 = Hangup on DTR low.
  215                             Bit 3:    0 = Standard response messages
  216                                       1 = Extended response messages
  217                             Bit 4:    0 = CALLER NUMBER before every RING.
  218                                       1 = CALLER NUMBER after first RING.
  219                             Bit 5:    0 = T.70 extended protocol off
  220                                       1 = T.70 extended protocol on
  221                             Bit 6:    0 = Special RUNG Message off
  222                                       1 = Special RUNG Message on
  223                                           "RUNG" is delivered on a ttyI, if
  224                                           an incoming call happened (RING) and
  225                                           the remote party hung up before any
  226                                           local ATA was given.
  227                             Bit 7:    0 = Don't show display messages from net
  228                                       1 = Show display messages from net
  229                                           (S12 Bit 1 must be 0 too)      
  230              14   0         Layer-2 protocol:
  231                                       0 = X75/LAPB with I-frames
  232                                       1 = X75/LAPB with UI-frames
  233                                       2 = X75/LAPB with BUI-frames
  234                                       3 = HDLC
  235                                       4 = Transparent (audio)
  236                                       7 = V.110, 9600 baud
  237                                       8 = V.110, 19200 baud
  238                                       9 = V.110, 38400 baud
  239                                      10 = Analog Modem (only if hardware supports this)
  240                                      11 = Fax G3 (only if hardware supports this)
  241              15   0         Layer-3 protocol:
  242                                       0 = transparent
  243                                       1 = transparent with audio features (e.g. DSP)
  244                                       2 = Fax G3 Class 2 commands (S14 has to be set to 11)
  245                                       3 = Fax G3 Class 1 commands (S14 has to be set to 11)
  246              16   250       Send-Packet-size/16
  247              17   8         Window-size (not yet implemented)
  248              18   4         Bit coded register, Service-Octet-1 to accept,
  249                             or to be used on dialout:
  250                             Bit 0:    Service 1 (audio) when set.
  251                             Bit 1:    Service 5 (BTX) when set.
  252                             Bit 2:    Service 7 (data) when set.
  253                             Note: It is possible to set more than one
  254                                   bit. In this case, on incoming calls
  255                                   the selected services are accepted,
  256                                   and if the service is "audio", the
  257                                   Layer-2-protocol is automatically
  258                                   changed to 4 regardless of the setting
  259                                   of register 14. On outgoing calls,
  260                                   the most significant 1-bit is chosen to
  261                                   select the outgoing service octet.
  262              19   0         Service-Octet-2
  263              20   0         Bit coded register (readonly)
  264                             Service-Octet-1 of last call.
  265                             Bit mapping is the same as register 18
  266              21   0         Bit coded register (readonly)
  267                             Set on incoming call (during RING) to
  268                             octet 3 of calling party number IE (Numbering plan)
  269                             See section 4.5.10 of ITU Q.931
  270              22   0         Bit coded register (readonly)
  271                             Set on incoming call (during RING) to
  272                             octet 3a of calling party number IE (Screening info)
  273                             See section 4.5.10 of ITU Q.931
  274              23   0         Bit coded register:
  275                             Bit 0:    0 = Add CPN to RING message off
  276                                       1 = Add CPN to RING message on
  277                             Bit 1:    0 = Add CPN to FCON message off
  278                                       1 = Add CPN to FCON message on
  279                             Bit 2:    0 = Add CDN to RING/FCON message off
  280                                       1 = Add CDN to RING/FCON message on
  281 
  282   Last but not least a (at the moment fairly primitive) device to request
  283   the line-status (/dev/isdninfo) is made available.
  284 
  285   Automatic assignment of devices to lines:
  286 
  287   All inactive physical lines are listening to all EAZs for incoming
  288   calls and are NOT assigned to a specific tty or network interface.
  289   When an incoming call is detected, the driver looks first for a network
  290   interface and then for an opened tty which:
  291 
  292   1. is configured for the same EAZ.
  293   2. has the same protocol settings for the B-channel.
  294   3. (only for network interfaces if the security flag is set)
  295      contains the caller number in its access list.
  296   4. Either the channel is not bound exclusively to another Net-interface, or
  297      it is bound AND the other checks apply to exactly this interface.
  298      (For usage of the bind-features, refer to the isdnctrl-man-page)
  299 
  300   Only when a matching interface or tty is found is the call accepted
  301   and the "connection" between the low-level-layer and the link-level-layer
  302   is established and kept until the end of the connection.
  303   In all other cases no connection is established. Isdn4linux can be
  304   configured to either do NOTHING in this case (which is useful, if
  305   other, external devices with the same EAZ/MSN are connected to the bus)
  306   or to reject the call actively. (isdnctrl busreject ...)
  307 
  308   For an outgoing call, the inactive physical lines are searched.
  309   The call is placed on the first physical line, which supports the
  310   requested protocols for the B-channel. If a net-interface, however
  311   is pre-bound to a channel, this channel is used directly.
  312 
  313   This makes it possible to configure several network interfaces and ttys
  314   for one EAZ, if the network interfaces are set to secure operation.
  315   If an incoming call matches one network interface, it gets connected to it.
  316   If another incoming call for the same EAZ arrives, which does not match
  317   a network interface, the first tty gets a "RING" and so on.
  318 
  319 2 System prerequisites:
  320 
  321   ATTENTION!
  322 
  323   Always use the latest module utilities. The current version is
  324   named in Documentation/Changes. Some old versions of insmod
  325   are not capable of setting the driver-Ids correctly.
  326 
  327 3. Lowlevel-driver configuration.
  328 
  329    Configuration depends on how the drivers are built. See the
  330    README.<yourDriver> for information on driver-specific setup.
  331 
  332 4. Device-inodes
  333 
  334    The major and minor numbers and their names are described in
  335    Documentation/devices.txt. The major numbers are:
  336 
  337      43 for the ISDN-tty's.
  338      44 for the ISDN-callout-tty's.
  339      45 for control/info/debug devices.
  340 
  341 5. Application
  342 
  343    a) For some card-types, firmware has to be loaded into the cards, before
  344       proceeding with device-independent setup. See README.<yourDriver>
  345       for how to do that.
  346 
  347    b) If you only intend to use ttys, you are nearly ready now.
  348 
  349    c) If you want to have really permanent "Modem"-settings on disk, you
  350       can start the daemon iprofd. Give it a path to a file at the command-
  351       line. It will store the profile-settings in this file every time
  352       an AT&W0 is performed on any ISDN-tty. If the file already exists,
  353       all profiles are initialized from this file. If you want to unload
  354       any of the modules, kill iprofd first.
  355 
  356    d) For networking, continue: Create an interface:
  357        isdnctrl addif isdn0
  358 
  359    e) Set the EAZ (or MSN for Euro-ISDN):
  360        isdnctrl eaz isdn0 2
  361 
  362      (For 1TR6 a single digit is allowed, for Euro-ISDN the number is your
  363       real MSN e.g.: Phone-Number)
  364 
  365    f) Set the number for outgoing calls on the interface:
  366        isdnctrl addphone isdn0 out 1234567
  367        ... (this can be executed more than once, all assigned numbers are
  368             tried in order)
  369       and the number(s) for incoming calls:
  370        isdnctrl addphone isdn0 in 1234567
  371 
  372    g) Set the timeout for hang-up:
  373        isdnctrl huptimeout isdn0 <timeout_in_seconds>
  374 
  375    h) additionally you may activate charge-hang-up (= Hang up before
  376       next charge-info, this only works, if your isdn-provider transmits
  377       the charge-info during and after the connection):
  378        isdnctrl chargehup isdn0 on
  379 
  380    i) Set the dial mode of the interface:
  381        isdnctrl dialmode isdn0 auto
  382       "off" means that you (or the system) cannot make any connection
  383         (neither incoming or outgoing connections are possible). Use
  384         this if you want to be sure that no connections will be made.
  385       "auto" means that the interface is in auto-dial mode, and will
  386         attempt to make a connection whenever a network data packet needs
  387         the interface's link. Note that this can cause unexpected dialouts,
  388         and lead to a high phone bill! Some daemons or other pc's that use
  389         this interface can cause this.
  390         Incoming connections are also possible.
  391       "manual" is a dial mode created to prevent the unexpected dialouts.
  392         In this mode, the interface will never make any connections on its
  393         own. You must explicitly initiate a connection with "isdnctrl dial
  394         isdn0". However, after an idle time of no traffic as configured for
  395         the huptimeout value with isdnctrl, the connection _will_ be ended.
  396         If you don't want any automatic hangup, set the huptimeout value to 0.
  397         "manual" is the default.
  398 
  399    j) Setup the interface with ifconfig as usual, and set a route to it.
  400 
  401    k) (optional) If you run X11 and have Tcl/Tk-wish version 4.0, you can use
  402      the script tools/tcltk/isdnmon. You can add actions for line-status
  403      changes. See the comments at the beginning of the script for how to
  404      do that. There are other tty-based tools in the tools-subdirectory
  405      contributed by Michael Knigge (imon), Volker Götz (imontty) and
  406      Andreas Kool (isdnmon).
  407 
  408    l) For initial testing, you can set the verbose-level to 2 (default: 0).
  409       Then all incoming calls are logged, even if they are not addressed
  410       to one of the configured net-interfaces:
  411       isdnctrl verbose 2
  412 
  413   Now you are ready! A ping to the set address should now result in an
  414   automatic dial-out (look at syslog kernel-messages).
  415   The phone numbers and EAZs can be assigned at any time with isdnctrl.
  416   You can add as many interfaces as you like with addif following the
  417   directions above. Of course, there may be some limitations. But we have
  418   tested as many as 20 interfaces without any problem. However, if you
  419   don't give an interface name to addif, the  kernel will assign a name
  420   which starts with "eth". The number of "eth"-interfaces is limited by
  421   the kernel.
  422 
  423 5. Additional options for isdnctrl:
  424 
  425    "isdnctrl secure <InterfaceName> on"
  426    Only incoming calls, for which the caller-id is listed in the access
  427    list of the interface are accepted. You can add caller-id's With the
  428    command "isdnctrl addphone <InterfaceName> in <caller-id>"
  429    Euro-ISDN does not transmit the leading '0' of the caller-id for an
  430    incoming call, therefore you should configure it accordingly.
  431    If the real number for the dialout e.g. is "09311234567" the number
  432    to configure here is "9311234567". The pattern-match function
  433    works similar to the shell mechanism.
  434 
  435      ?     one arbitrary digit
  436      *     zero or arbitrary many digits
  437      [123] one of the digits in the list
  438      [1-5] one digit between '1' and '5'
  439            a '^' as the first character in a list inverts the list
  440 
  441 
  442    "isdnctrl secure <InterfaceName> off"
  443    Switch off secure operation (default).
  444 
  445    "isdnctrl ihup <InterfaceName> [on|off]"
  446    Switch the hang-up-timer for incoming calls on or off.
  447 
  448    "isdnctrl eaz <InterfaceName>"
  449    Returns the EAZ of an interface.
  450 
  451    "isdnctrl delphone <InterfaceName> in|out <number>"
  452    Deletes a number from one of the access-lists of the interface.
  453 
  454    "isdnctrl delif <InterfaceName>"
  455    Removes the interface (and possible slaves) from the kernel.
  456    (You have to unregister it with "ifconfig <InterfaceName> down" before).
  457 
  458    "isdnctrl callback <InterfaceName> [on|off]"
  459    Switches an interface to callback-mode. In this mode, an incoming call
  460    will be rejected and after this the remote-station will be called. If
  461    you test this feature by using ping, some routers will re-dial very
  462    quickly, so that the callback from isdn4linux may not be recognized.
  463    In this case use ping with the option -i <sec> to increase the interval
  464    between echo-packets.
  465 
  466    "isdnctrl cbdelay <InterfaceName> [seconds]"
  467    Sets the delay (default 5 sec) between an incoming call and start of
  468    dialing when callback is enabled.
  469 
  470    "isdnctrl cbhup <InterfaceName> [on|off]"
  471    This enables (default) or disables an active hangup (reject) when getting an
  472    incoming call for an interface which is configured for callback.
  473 
  474    "isdnctrl encap <InterfaceName> <EncapType>"
  475    Selects the type of packet-encapsulation. The encapsulation can be changed
  476    only while an interface is down.
  477 
  478    At the moment the following values are supported:
  479 
  480    rawip    (Default) Selects raw-IP-encapsulation. This means, MAC-headers
  481             are stripped off.
  482    ip       IP with type-field. Same as IP but the type-field of the MAC-header
  483             is preserved.
  484    x25iface X.25 interface encapsulation (first byte semantics as defined in
  485             ../networking/x25-iface.txt). Use this for running the linux
  486             X.25 network protocol stack (AF_X25 sockets) on top of isdn.
  487    cisco-h  A special-mode for communicating with a Cisco, which is configured
  488             to do "hdlc"
  489    ethernet No stripping. Packets are sent with full MAC-header.
  490             The Ethernet-address of the interface is faked, from its
  491             IP-address: fc:fc:i1:i2:i3:i4, where i1-4 are the IP-addr.-values.
  492    syncppp  Synchronous PPP
  493 
  494    uihdlc   HDLC with UI-frame-header (for use with DOS ISPA, option -h1)
  495 
  496 
  497    NOTE:    x25iface encapsulation is currently experimental. Please
  498             read README.x25 for further details
  499 
  500 
  501    Watching packets, using standard-tcpdump will fail for all encapsulations
  502    except ethernet because tcpdump does not know how to handle packets
  503    without MAC-header. A patch for tcpdump is included in the utility-package
  504    mentioned above.
  505 
  506    "isdnctrl l2_prot <InterfaceName> <L2-ProtocolName>"
  507    Selects a layer-2-protocol.
  508    (With the ICN-driver and the HiSax-driver, "x75i" and "hdlc" is available.
  509    With other drivers, "x75ui", "x75bui", "x25dte", "x25dce" may be
  510    possible too. See README.x25 for x25 related l2 protocols.)
  511 
  512    isdnctrl l3_prot <InterfaceName> <L3-ProtocolName>
  513    The same for layer-3. (At the moment only "trans" is allowed)
  514 
  515    "isdnctrl list <InterfaceName>"
  516    Shows all parameters of an interface and the charge-info.
  517    Try "all" as the interface name.
  518 
  519    "isdnctrl hangup <InterfaceName>"
  520    Forces hangup of an interface.
  521 
  522    "isdnctrl bind <InterfaceName> <DriverId>,<ChannelNumber> [exclusive]"
  523    If you are using more than one ISDN card, it is sometimes necessary to
  524    dial out using a specific card or even preserve a specific channel for
  525    dialout of a specific net-interface. This can be done with the above
  526    command. Replace <DriverId> by whatever you assigned while loading the
  527    module. The <ChannelNumber> is counted from zero. The upper limit
  528    depends on the card used. At the moment no card supports more than
  529    2 channels, so the upper limit is one.
  530 
  531    "isdnctrl unbind <InterfaceName>"
  532    unbinds a previously bound interface.
  533 
  534    "isdnctrl busreject <DriverId> on|off"
  535    If switched on, isdn4linux replies a REJECT to incoming calls, it
  536    cannot match to any configured interface.
  537    If switched off, nothing happens in this case.
  538    You normally should NOT enable this feature, if the ISDN adapter is not
  539    the only device connected to the S0-bus. Otherwise it could happen that
  540    isdn4linux rejects an incoming call, which belongs to another device on
  541    the bus.
  542 
  543    "isdnctrl addslave <InterfaceName> <SlaveName>
  544    Creates a slave interface for channel-bundling. Slave interfaces are
  545    not seen by the kernel, but their ISDN-part can be configured with
  546    isdnctrl as usual. (Phone numbers, EAZ/MSN, timeouts etc.) If more
  547    than two channels are to be bundled, feel free to create as many as you
  548    want. InterfaceName must be a real interface, NOT a slave. Slave interfaces
  549    start dialing, if the master interface resp. the previous slave interface
  550    has a load of more than 7000 cps. They hangup if the load goes under 7000
  551    cps, according to their "huptimeout"-parameter.
  552 
  553    "isdnctrl sdelay <InterfaceName> secs."
  554    This sets the minimum time an Interface has to be fully loaded, until
  555    it sends a dial-request to its slave.
  556 
  557    "isdnctrl dial <InterfaceName>"
  558    Forces an interface to start dialing even if no packets are to be
  559    transferred.
  560 
  561    "isdnctrl mapping <DriverId> MSN0,MSN1,MSN2,...MSN9"
  562    This installs a mapping table for EAZ<->MSN-mapping for a single line.
  563    Missing MSN's have to be given as "-" or can be omitted, if at the end
  564    of the commandline.
  565    With this command, it's now possible to have an interface listening to
  566    mixed 1TR6- and Euro-Type lines. In this case, the interface has to be
  567    configured to a 1TR6-type EAZ (one digit). The mapping is also valid
  568    for tty-emulation. Seen from the interface/tty-level the mapping
  569    CAN be used, however it's possible to use single tty's/interfaces with
  570    real MSN's (more digits) also, in which case the mapping will be ignored.
  571    Here is an example:
  572 
  573    You have a 1TR6-type line with base-nr. 1234567 and a Euro-line with
  574    MSN's 987654, 987655 and 987656. The DriverId for the Euro-line is "EURO".
  575 
  576    isdnctrl mapping EURO -,987654,987655,987656,-,987655
  577    ...
  578    isdnctrl eaz isdn0 1      # listen on 12345671(1tr6) and 987654(euro)
  579    ...
  580    isdnctrl eaz isdn1 4      # listen on 12345674(1tr6) only.
  581    ...
  582    isdnctrl eaz isdn2 987654 # listen on 987654(euro) only.
  583 
  584    Same scheme is used with AT&E...  at the tty's.
  585 
  586 6. If you want to write a new low-level-driver, you are welcome.
  587    The interface to the link-level-module is described in the file INTERFACE.
  588    If the interface should be expanded for any reason, don't do it
  589    on your own, send me a mail containing the proposed changes and
  590    some reasoning about them.
  591    If other drivers will not be affected, I will include the changes
  592    in the next release.
  593    For developers only, there is a second mailing-list. Write to me
  594    (fritz@isdn4linux.de), if you want to join that list.
  595 
  596 Have fun!
  597 
  598  -Fritz
  599 

[ source navigation ] [ identifier search ] [ freetext search ] [ file search ] [ list types ] [ track identifier ]


This page is part of the FreeBSD/Linux Linux Kernel Cross-Reference, and was automatically generated using a modified version of the LXR engine.