1 What Is the CAPI4Linux Project and What Is It for?
2 Which AVM ISDN-Controllers Are Currently Supported by CAPI4Linux?
3 What Are the Prerequisites for Installing the CAPI4Linux Package?
4 Installing CAPI4Linux in SuSE Linux Distributions
5 Installation Instructions for Integrating the AVM ISDN-Controllers in Other Linux Distributions
6 Removing the Controller and Updating the Drivers
7 Information about the CAPI 2.0 Plug-in Module for the "Generic PPP" Stack (pppd)
8 Information about Installing Multiple Active AVM ISDN-Controllers
10 Further Information Sources
The idea behind the CAPI4Linux project is a new approach for ISDN communication in Linux. Through the adoption of an obligatory CAPI 2.0 standard for Linux by the CAPI Association (www.capi.org) in fall 1999, for the first time a unified standard was created for ISDN communication in Linux: the CAPI 2.0 interface already in regular use on other platforms. This now allows applications and drivers which can run on all ISDN-Controllers with a compatible CAPI 2.0 driver to be developed in Linux.
CAPI4Linux consists of a complete CAPI 2.0 driver for the respective AVM ISDN-Controller and, based on this:
CAPI4Linux makes it possible to use the entire range of ISDN services like Internet access, Remote Access Service, telephony, Fax G3 and file transfer over a standardized applications interface ("CAPI 2.0") with corresponding applications.
For comprehensive information about CAPI4Linux, use the "Search" command on the AVM home page at www.avm.de/en.
ISDN4Linux is based on direct programming of a common ISDN chip set ("HiSax") by Siemens, which is also used by AVM on the ISDN-Controller FRITZ!Classic (AVM ISDN-Controller A1). If the manufacturer of your ISDN adapter uses a different chip set, the specification for addressing this new chip set (port addresses, etc.) must be provided each time by the manufacturer. This is not always possible, and every change to the hardware by the manufacturer generally requires a consequent adaptation of the chip set driver. Only a unified, mandatory interface allows the development of applications based on this application interface, such as fax servers and various user-mode applications. Hardware and applications thus can be exchanged at will. These were the reasons for creating the applications interface CAPI at the beginning of the 1990s.
CAPI4Linux currently supports the following AVM DSL/ISDN-Controllers:
NOTE: |
The ISDN-Controller T1/T1-B does not support fax services. |
For the following ISDN-Controllers with a V.24 interface, no drivers in accordance with the CAPI4Linux-Model will be available:
For information about new releases, see the AVM home page and the file "hist-eng.txt" in the root directory of ftp.avm.de.
For simple installation, AVM provides pre-compiled driver archives for a number of popular Linux distributions. Thanks to the open concept of Linux, all current distribution can be used with the software. The pre-compiled driver archives support the INTEL i386 platform (single CPU). In order to use the drivers on another CPU platform and/or on an SMP machine, they must simply be re-translated or compiled. For instructions about translating the sources, see the /src directory.
The driver supports a maximum of four active AVM ISDN-Controllers installed at any given time, e.g four AVM ISDN-Controllers B1. A system may have any combination of active AVM ISDN-Controllers installed for the ISA/PCI/PCMCIA/USB bus. A "mixed" configuration of active and passive AVM ISDN-Controllers (e.g. AVM FRITZ!Card) is not possible. Because CAPI4Linux is a completely new development, it is not yet embedded in all popular Linux distributions. For other distributions, therefore, it is still necessary to install the package "by hand". This document describes installation in:
* "Out of maintainance state (EOM)". This means that these older versions are no longer supported by current drivers.
This means that installation is particularly simple in these distributions. In SuSE 7.1, both specified kernel versions are supported with just one installation program. Support of additional distributions by means of pre-configured modules is planned.
Up to SuSE 8.0 it is not necessary to install the ISDN4Linux (I4L) package before installing CAPI4Linux. To continue using features and interfaces provided by ISDN4Linux, such as ippp, tty ports parallel to CAPI and pppd, see the additional configuration information in the Service/FAQ area of the AVM home page www.avm.de (unfortunately, this FAQ site is only available in German).
From SuSE Linux 8.1, a previous controller installation with YaST2 is a prerequisite for installing an AVM ISDN-Controller with the AVM CAPI4Linux package! It is imperative that you follow the special tips in the installation instructions for the given active AVM ISDN-Controller. A description detailing the installation of the AVM ISDN-Controllers using YaST2 can be found in the following section.
The following sections describe the installation of active AVM ISDN-Controllers in SuSE Linux 8.1. Before beginning with installation, note the installation tips below.
Operating system: | SuSE Linux 8.1 (Kernel 2.4.19-4GB) and other distributions |
Version: | 03.10.02 B1 Family |
03.09.11 C2 / C4 | |
01.03.01 T1 / T1-B | |
Build: | 03.02.21 |
Installation requirements:
*NOTE: |
Up to four active AVM ISDN-Controllers can be operated at the same time. For technical reasons found in SuSE 8.1, the installation of multiple controllers is possible only to a limited degree in SuSE 8.1. It is possible to install, for instance, 2 x T1 ISA with 2 x B1 ISA or 1 x T1 PCI with 1 x B1 PCI and one C2/C4 in SuSE 8.1. However, no PCI controllers of the same kind can be installed together (e.g., 3 x B1 PCI or 1 x C2 with 1 x C4 or 2 x T1 PCI). For more information about installing multiple controllers, please see section 8. |
NOTE: |
Enter the following command in a console to find out the exact designation of your AVM controller: "hwinfo --isdn | grep Model" (only available to the "root" user, or Superuser). |
For more information about using pppd and scripts, see the following section and section 7. If you want to configure a connection using KInternet then choose the option "Add DSL CAPI Interface" for DSL or "Add new SyncPPP network interface" for ISDN from "ISDN Service Selection" under "Network services" and follow the instructions.
Additional information for hardware configuration can also be found in
the SuSE documentation in the following folders:
/usr/share/doc/packages/susehelp
/usr/share/doc/packages/suselinux-adminguide_de/
All prerequisites for the installing the AVM ISDN-Controller using the AVM CAPI4Linux package in SuSE 8.1 have now been fulfilled. Now perform an installation by following the installation instructions below.
ATTENTION: |
The installation method described here is valid only for SuSE Linux 8.1 or higher. A necessary prerequisite is a previous installation of the AVM ISDN-Controller using YaST2. Installation with the AVM CAPI4Linux package cannot be carried out until the YaST2 installation has been completed! A description detailing the installation of the AVM B1 ISDN-Controllers using YaST2 can be found in section 4.1.1. |
Upon conclusion of installation, perform a PING test of the installation. This checks whether installation was completed successfully. Establish a test connection to the AVM Data Call Center (ADC) in Berlin over the "pppd" (Point-to-point Protocol Daemon) module. This simulates dialing in to any ISP (Internet Service Provider) using PPP sync in accordance with RFC1618 over HDLC. The necessary parameters are pre-defined under the argument "AVM".
The number for the test server is ++49 30 39 98 43 20.
Additional options of the CAPI 2.0 plug-in module for the "Generic PPP" stack (pppd) are described in section 7.
ATTENTION: |
In SuSE 8.1, a YaST installation of the AVM ISDN-Controller C4 is the basis of the AVM CAPI4Linux package. However, an online update must be performed before a YaST installation. Therefore this section describes how to dial into the Internet with a C4 and SuSE 8.1 installed by CD in order to download all of the necessary updates. If your system has already been updated using the packets (i4l-base...rpm, i4l-isdnlog...rpm, i4lfirm...rpm, capi4linux...rpm) available at ftp://ftp.suse.com/pub/suse/i386/update/8.1/rpm/i586, or with the "i4l-base (Basic Programs for ISDN Devices in Linux)" package installed by means of a YOU update, skip this section and continue with section 4.1.3.2 and then section 4.1.3.3. For more information about installing multiple controllers, please also see the information in section 4.1 and section 8. |
Next, install the AVM ISDN-Controller with YaST as described in the following section so that you can then perform an update from the AVM server with the current CAPI4Linux package.
ATTENTION: |
Be sure to follow the instructions in section 4.1.3 if you have not yet updated your system with the "i4l-base (Basic Programs for ISDN devices in Linux)" through YOU or with the packages (i4l-base...rpm, i4l-isdnlog...rpm, i4lfirm...rpm, capi4linux...rpm) available at ftp://ftp.suse.com/pub/suse/i386/update/8.1/rpm/i586. |
Additional information regarding pppd and the script's usage can be found in the following section and in section Section 7, along with information on the CAPI 2.0 plug-in module for the "Generic PPP" stack (pppd). If you want to configure a connection using KInternet then choose the option "Add new SyncPPP network interface" from "ISDN Service Selection" under "Network services" and follow the instructions.
Additional information for hardware configuration can also be found in
the SuSE documentation in the following folders:
/usr/share/doc/packages/susehelp
/usr/share/doc/packages/suselinux-adminguide_de/
All prerequisites for the installing the AVM ISDN-Controller using the AVM CAPI4Linux package in SuSE 8.1 have now been fulfilled. Now perform an installation by following the installation instructions below.
NOTE: |
An installation with the CAPI4Linux package can be performed in SuSE 8.1 only when the AVM ISDN-Controller C4 was previously installed with YaST2 (be sure to read the sections 4.1.3.1 and 4.1.3.2). |
Upon conclusion of installation, perform a PING test of the installation. This checks whether installation was completed successfully. Establish a test connection to the AVM Data Call Center (ADC) in Berlin over the "pppd" (Point-to-point Protocol Daemon) module. This simulates dialing in to any ISP (Internet Service Provider) using PPP sync in accordance with RFC1618 over HDLC. The necessary parameters are pre-defined under the argument "AVM".
The number for the test server is ++49 30 39 98 43 20.
Additional options of the CAPI 2.0 plug-in module for the "Generic PPP" stack (pppd) are described in section 7.
NOTE: |
The AVM CAPI4Linux package from the AVM server is required for the installation of the AVM ISDN-Controller C2 in SuSE Linux 8.1. An installation by means of YaST2 will not function without a system update. For more information about installing multiple controllers, please also see the information in section 4.1 and section 8. |
NOTE: |
If you have already performed an online update with the files i4l-base...rpm, i4l-isdnlog...rpm, i4lfirm...rpm, capi4linux...rpm, or with the update package "i4l-base (Basic Programs for ISDN Devices in Linux)" by means of YOU, perform a YaST2 installation as described up to step 9 here. Then continue with section 4.1.4.2. |
NOTE: |
If you have already performed an online update with the files i4l-base...rpm, i4l-isdnlog...rpm, i4lfirm...rpm, capi4linux...rpm (ftp://ftp.suse.com/pub/suse/i386/update/8.1/rpm/i586/) or installed the update package "i4l-base (Basic Programs for ISDN Devices in Linux)" by means of YOU, continue with section 4.1.4.2. |
Establish a pppd connection with the following command (here with the
example script Arcor, DNS is assigned over the PPP connection):
pppd call isdn/arcor usepeerdns
or, for extensions with outside dialing access "0":
pppd call isdn/arcor numberprefix 0 usepeerdns
Additional options of the CAPI 2.0 plug-in module for the "Generic PPP" stack (pppd) are described in section 7.
After the system reboots the option of dialing in by K-Internet is available as well as the pppd dial-in.
NOTE: |
A prerequisite for this installation method is an online update of the files i4l-base...rpm, i4l-isdnlog...rpm, i4lfirm...rpm, capi4linux...rpm or a YOU update of the "i4l-base (Basic Programs for ISDN Devices in Linux)" package, including steps 1 through 9 described in section 4.1.4.1. |
Upon conclusion of installation, perform a PING test of the installation. This checks whether installation was completed successfully. Establish a test connection to the AVM Data Call Center (ADC) in Berlin over the "pppd" (Point-to-point Protocol Daemon) module. This simulates dialing in to any ISP (Internet Service Provider) using PPP sync in accordance with RFC1618 over HDLC. The necessary parameters are pre-defined under the argument "AVM". The number for the test server is ++49 30 39 98 43 20.
Additional options of the CAPI 2.0 plug-in module for the "Generic PPP" stack (pppd) are described in section 7.
NOTE: |
The AVM CAPI4Linux package from the AVM server is required for the installation of the AVM ISDN-Controller T1/T1-B in SuSE Linux 8.1. An installation by means of YaST2 will not function. For more information about installing multiple controllers, please also see the information in section 4.1 and section 8. |
Installation of the AVM ISDN-Controller T1/T1-B does not differ from the installation in SuSE 8.0. Please continue by following the instructions in section 4.2.6.
The following section describes the installation of active AVM ISDN-Controllers in systems with SuSE 8.0 or lower. Read the section that describes the installation of your controller.
Version: 03.10.02
Build: 02.09.27
ATTENTION: |
If different active AVM ISDN-Controllers are installed (for example, AVM ISDN-Controller C2 together with ISDN-Controller C4 or ISDN-Controller C2 together with ISDN-Controller B1), please see section 8. |
The driver can be used for both the ISDN-Controller B1 PCI and the ISDN-Controller B1 PCI v4.0. The special features of the B1 PCI v4.0 like PCI Busmaster DMA are automatically recognized and enabled by this driver. This is also true, of course, for combined operation with different active AVM ISDN-Controllers.
(1) Copy the archive "b1-suseX.X-YY.YY.YY.tar.gz" from the CAPI4Linux archive to your computer For instance, from a diskette by typing the command "mcopy" at the console. Start a console (command prompt). Extract the archive with the command:
tar
-xzvf b1-SuSEX.X-YY.YY.YY.tar.gz
Example for SuSE 8.0:
tar -xzvf b1-SuSE8.0-03.10.02.tar.gz
A directory called "active" is created.
(2) Switch to the new directory "active".
(3) Run "./install b1pci". If no options for special protocol variants were specified (see 3a), a succession of selection menus now appears. In these dialogs, make the selections for:
Your entries are automatically registered under the relevant controller type "b1pci" in the "/etc/capi.conf" file.
(3a) As an alternative to menu-controlled installation, you can install the controller also directly from the command prompt. The following options can be used:
./install b1pci -dss1 |
D-channel protocol DSS1 [EURO-ISDN] |
./install b1pci -1tr6 |
D-channel protocol 1TR6 [former national German protocol] |
./install b1pci -ni1 |
D-channel protocol NI1 [National ISDN 1 / USA] |
./install b1pci -ddi |
ISDN DDI line [Direct Dial-In, DSS1] |
(4) Now restart your computer. The CAPI 2.0 driver is loaded automatically when the computer is restarted. Check with the "lsmod" command (only available to the "root" user, or "Superuser") whether the CAPI module is present in the system. The following loaded modules should be included in the output:
As an installation test, perform a PING test at the conclusion of installation to check whether the software has been installed correctly. Establish a test connection to the AVM Data Call Center (ADC) in Berlin over the "pppd" (Point-to-point Protocol Daemon) module. This simulates dialing in to any ISP (Internet Service Provider) using PPP sync in accordance with RFC1618 over HDLC. The necessary parameters are pre-defined under the argument "AVM". The number for the test server is ++49 30 39 98 43 20.
(1) Start a console (command prompt).
Establish a pppd connection with the following command:
pppd call isdn/avm
or, for extensions with outside dialing access "0":
pppd call isdn/avm numberprefix 0
Once a test connection has been established, the output window contains among other information the ping transit time to the AVM server over your ISDN-Controller. This means that installation was successful. To access the AVM home page with a web browser (like Netscape) directly with this test connection, the following command can also be used (DNS is assigned over the PPP connection):
pppd call isdn/avm usepeerdns
or, for extensions with outside dialing access "0":
pppd call isdn/avm numberprefix 0 usepeerdns
Additional options of the CAPI 2.0 plug-in module for the "Generic PPP" stack (pppd) are described in section 7.
Version: 03.10.02
Build: 02.09.27
ATTENTION: |
If different active AVM ISDN-Controllers are installed (for example, AVM ISDN-Controller C2 together with ISDN-Controller C4 or ISDN-Controller C2 together with ISDN-Controller B1), please see section 8. |
The driver can be used for all AVM ISDN-Controllers B1 for the ISA/EISA bus. The special features of the individual models like Fax G3 at up to 14,400 bit/s with the B1 v2.0/v3.0 are automatically recognized and enabled by the driver. This is also true, of course, for combined operation with different active AVM ISDN-Controllers.
(1) Copy the archive "b1-suseX.X-YY.YY.YY.tar.gz" from the CAPI4Linux archive to your computer For instance, from a diskette by typing the command "mcopy" at the console. Start a console (command prompt). Extract the archive with the command
tar -xzvf b1-SuSEX.X-YY.YY.YY.tar.gz
Example for SuSE 8.0:A directory called "active" is created.
(2) Because the ISDN-Controller B1 is not a Plug and Play adapter, you must determine manually whether the necessary resources (free I/O address, free IRQ) are occupied by other hardware extensions. The driver software is set by default to use the resources "I/O address 150" and "IRQ 5". The jumper on the ISDN-Controller B1 is also set to the I/O address 150 (factory default).
The I/O address required by the ISDN-Controller B1 is set by jumper on the controller such that conflicts with other hardware extensions should be avoided. The ISDN-Controller B1 can use the following I/O addresses:
Assistance is provided in the following files, which list all *occupied* resources resp. list the resources used by other drivers:
These list contain all *occupied* resources by listing the resources used by other drivers. These lists are not exhaustive, i.e., some resources *not* listed in these files may also be occupied!
When trying out values for the I/O port and IRQ, always monitor the driver outputs in the system log when the system is started. If loading of a driver is not successful, corresponding error messages will be returned there.
Once you have identified a free I/O port and a free IRQ, the selected I/O address also must be set by means of the jumper on the AVM ISDN-Controller B1. The IRQ is set automatically by the software driver. Please make a note of these values, as they will be required in step (4).
(3) Now insert the AVM ISDN-Controller B1 into a free ISA slot. Be sure to position the jumper correctly according to the instructions in step 2.
(4) Switch to the new "active" directory and start the installation program by entering "./install b1isa" at the console. If no options for special protocol variants were specified (see 4a), a succession of selection menus now appears. In these dialogs, make the selections for:
Your entries are automatically registered under the relevant controller type "b1isa" in the "/etc/capi.conf" file.
(4a) As an alternative to menu-controlled installation, you can install the controller also directly from the command prompt. The following options can be used:
./install b1isa -dss1 |
D-channel protocol DSS1 [EURO-ISDN] |
./install b1isa -1tr6 |
D-channel protocol 1TR6 [former national German protocol] |
./install b1isa -ni1 |
D-channel protocol NI1 [National ISDN 1 / USA] |
./install b1isa -ddi |
ISDN DDI line [Direct Dial-In, DSS1] |
The value for the I/O address, i.e. the entry in the "/etc/capi.conf" file, and the position of the jumper on the controller must always be identical.
(5) Now restart your computer. The CAPI 2.0 driver is loaded automatically when the computer is restarted. Check with the "lsmod" command (only available to the "root" user, or "Superuser") whether the CAPI module is present in the system. The following loaded modules should be included in the output:
When installation is concluded, you can perform a ping test of the installation. For this purpose a test connection to the AVM Data Call Center (ADC) in Berlin is established over the "pppd" module. This simulates dialing in to any ISP (Internet Service Provider) using PPP sync in accordance with RFC1618 over HDLC. The necessary parameters are pre-defined under the argument "AVM". The number for the test server is ++49 30 39 98 43 20.
(1) Start a console (command prompt)
Establish a pppd connection with the following command:
pppd call isdn/avm
or, for extensions with outside dialing access "0":
pppd call isdn/avm numberprefix 0
Once a test connection has been established, the output window contains among other information the ping transit time to the AVM server over your ISDN-Controller. This means that installation was successful. To access the AVM home page with a web browser (like Netscape) directly with this test connection, the following command can also be used (DNS is assigned over the PPP connection):
pppd call isdn/avm usepeerdns
or, for extensions with outside dialing access "0":
pppd call isdn/avm numberprefix 0 usepeerdns
Additional options of the CAPI 2.0 plug-in module for the "Generic PPP" stack (pppd) are described in section 7.
Version: 03.10.02
Build: 02.09.27
ATTENTION: |
If different active AVM ISDN-Controllers are installed (for example, AVM ISDN-Controller C2 together with ISDN-Controller C4 or ISDN-Controller C2 together with ISDN-Controller B1), please see section 8. |
Install the "external PCMCIA package", in SuSE 8.0, for example, containing the packages "pcmcia-3.1.31" and "pcmcia-cardinfo-3.10.31", from the SuSE CD-ROM. After the installation of these packages, set the variable "PCMCIA_SYSTEM" in the file "/etc/sysconfig/pcmcia" to "external". If not yet listed, enter in the variable "PCMCIA_PCIC" the type of PCMCIA controller (see also the following comprehensive comments). Determine the PCMCIA controller hardware (chip set of the existing PCMCIA controller) by running the "probe" program:
/sbin/probe
Start the package with the command "rcpcmcia start". If the package does not start, restart your computer.
(1) Copy the archive "b1-suseX.X-YY.YY.YY.tar.gz" from the CAPI4Linux archive to your computer (e.g. from a diskette using the "mcopy" command from a console) and start the console (command prompt).
Extract the archive with the command
tar -xzvf b1-SuSEX.X-YY.YY.YY.tar.gz
Example for SuSE 8.0:
tar -xzvf b1-SuSE8.0-03.10.02.tar.gz
A directory called "active" is created.
(2) Switch to the new directory "active".
NOTE: |
For SuSE Linux 7.2 or higher, the subsequent installation is the same as for a B1 PCI installation, since the allocated resources of the PCMCIA card are detected automatically. In this case, slide the card into the PCMCIA slot and proceed with step (2) in paragraph 4.2.1 as you would for the installation of a PCI card ("./install b1pcmcia"). |
Version: 03.09.11
Build: 02.09.27
ATTENTION: |
If different active AVM ISDN-Controllers are installed (for example, AVM ISDN-Controller C2 together with ISDN-Controller C4 or ISDN-Controller C2 together with ISDN-Controller B1), please see section 8. |
(1) Copy the archive "c4-suseX.X-YY.YY.YY.tar.gz" from the CAPI4Linux archive to your computer (e.g. from a diskette using the "mcopy" command from a console) and start the console (command prompt). Extract the archive with the command
tar -xzvf c4-SuSEX.X-YY.YY.YY.tar.gz
Example for SuSE 8.0:
tar -xzvf c4-SuSE8.0-03.09.11.tar.gz
A directory called "active" is created.
(2) Switch to this new directory "active".
(3) Start the installation by entering "./install c4". If no options for special protocol variants were specified (see 3a), a succession of selection menus now appears. The only ISDN D-channel protocol available is DSS-1 [EURO-ISDN].
You can either configure all S0 ports (=controller numbers) of the ISDN-Controller C4 together (default setting), or individually, if desired. In either case, one of the two possible line types can be selected:
Select the line type for the configuration used on your ISDN line. The logical controller numbers are assigned to the ISDN-Controllers physically connected to the S0 ports as illustrated in the sketch below. The horizontal line represents the screw plate of the plug-in card. Any other ISDN-Controller B1, ISDN-Controller C2 or ISDN-Controller C4 installed then receives the logical controller number 5 for its first S0 port, 6 for the second, and so on. This is especially important for the configuration of CAPI applications (like CAPI4HylaFAX) when using multiple active AVM ISDN-Controllers. The exact designation of the four S0 ports on the blanking plate of the AVM ISDN-Controller C4 is described in the manual.
The resources required for the controller are determined from the PCI BIOS of the computer (Plug-and-Play). Your entries are automatically registered under the relevant controller type "c4" in the "/etc/capi.conf" file.
(3a) As an alternative to menu-controlled installation, you can install the controller also directly from the command prompt. The following options can be used:
./install c4 -dss1 |
D-channel protocol DSS1 [EURO-ISDN] |
./install c4 -ddi1 |
DDI line (DSS1) on controller number 1 |
./install c4 -ddi2 |
DDI line (DSS1) on controller number 2 |
./install c4 -ddi3 |
DDI line (DSS1) on controller number 3 |
./install c4 -ddi4 |
DDI line (DSS1) on controller number 4 |
./install c4 -ddi |
DDI line (DSS1) for all controller numbers |
(4) Now restart your computer. The CAPI 2.0 driver is loaded automatically when the computer is restarted. Check with the "lsmod" command (only available to the "root" user, or "Superuser") whether the CAPI module is present in the system. The following loaded modules should be included in the output:
As an installation test, perform a PING test over the first S0 port/Controller 1 of the ISDN-Controller C4. For more information, see the manual and section 7 of this document. This checks whether installation was completed successfully. Establish a test connection to the AVM Data Call Center (ADC) in Berlin over the "pppd" (Point-to-point Protocol Daemon) module. This simulates dialing in to any ISP (Internet Service Provider) using PPP sync in accordance with RFC1618 over HDLC. The necessary parameters are pre-defined under the argument "AVM". The number for the test server is ++49 30 39 98 43 20.
(1) Start a console (command prompt).
Establish a pppd connection with the following command:
pppd call isdn/avm
or, for extensions with outside dialing access "0":
pppd call isdn/avm numberprefix 0
Once a test connection has been established, the output window contains among other information the ping transit time to the AVM server over your ISDN-Controller. This means that installation was successful. To access the AVM home page with a web browser (like Netscape) directly with this test connection, the following command can also be used (DNS is assigned over the PPP connection):
pppd call isdn/avm usepeerdns
or, for extensions with outside dialing access "0":
pppd call isdn/avm numberprefix 0 usepeerdns
Additional options of the CAPI 2.0 plug-in module (for example, GSM dial-in) for the "Generic PPP" stack (pppd) are described in section 7.
Version: 03.09.11
Build: 02.09.27
ATTENTION: |
If different active AVM ISDN-Controllers are installed (for example, AVM ISDN-Controller C2 together with ISDN-Controller C4 or ISDN-Controller C2 together with ISDN-Controller B1), please see section 8. |
(1) Copy the archive "c2-suseX.X-YY.YY.YY.tar.gz" from the CAPI4Linux archive to your computer (e.g. from a diskette using the "mcopy" command from a console) and start the console (command prompt). Extract the archive with the command:
tar -xzvf c2-SuSEX.X-YY.YY.YY.tar.gz
Example for SuSE 8.0:
tar -xzvf c2-SuSE8.0-03.09.11.tar.gz
A directory called "active" is created.
(2) Switch to this new directory "active".
(3) Start the installation by entering "./install c2". If no options for special protocol variants were specified (see 3a), a succession of selection menus now appears. The only ISDN D-channel protocol available is DSS-1 [EURO-ISDN]. You can either configure all S0 ports (=controller numbers) of the AVM C2 together (default setting), or individually, if desired. In either case, one of the two possible line types can be selected:
Select the line type for the configuration used on your ISDN line. The logical controller numbers are assigned to the ISDN-Controllers physically connected to the S0 ports as illustrated in the sketch below. The horizontal line represents the screw plate of the plug-in card. Any other ISDN-Controller B1, ISDN-Controller C2 or ISDN-Controller C4 installed then receives the logical controller number 3 for its first S0 port, 4 for the second, and so on. This is especially important for the configuration of CAPI applications (like CAPI4HylaFAX) when using multiple active AVM ISDN-Controllers. The exact designation of the two S0 ports on the blanking plate is described in the manual.
The resources required for the controller are determined from the PCI BIOS of the computer (Plug-and-Play). Your entries are automatically registered under the relevant controller type "c2" in the "/etc/capi.conf" file.
(3a) As an alternative to menu-controlled installation, you can install the controller also directly from the command prompt. The following options can be used:
./install c2 -dss1 |
D-channel protocol DSS1 [EURO-ISDN] |
./install c2 -ddi1 |
DDI line (DSS1) on controller number 1 |
./install c2 -ddi2 |
DDI line (DSS1) on controller number 2 |
./install c2 -ddi |
DDI line (DSS1) for all controller numbers |
(4) Now the system must be rebooted. The CAPI 2.0 driver is loaded automatically when the computer is restarted. Check with the "lsmod" command (only available to the "root" user, or "Superuser") whether the CAPI module is present in the system. The following loaded modules should be included in the output:
As an installation test, perform a PING test at the conclusion of installation over the first S0 port/Controller 1 of the AVM ISDN-Controller C2 to check whether the software has been installed correctly (see also the manual and section 7 of this document). Establish a test connection to the AVM Data Call Center (ADC) in Berlin over the "pppd" (Point-to-point Protocol Daemon) module. This simulates dialing in to any ISP (Internet Service Provider) using PPP sync in accordance with RFC1618 over HDLC. The necessary parameters are pre-defined under the argument "AVM". The number for the test server is ++49 30 39 98 43 20.
(1) Start a console (command prompt).
Establish a pppd connection with the following command:
pppd call isdn/avm
or, for extensions with outside dialing access "0":
pppd call isdn/avm numberprefix 0
Once a test connection has been established, the output window contains among other information the ping transit time to the AVM server over your ISDN-Controller. This means that installation was successful. To access the AVM home page with a web browser (like Netscape) directly with this test connection, the following command can also be used (DNS is assigned over the PPP connection):
pppd call isdn/avm usepeerdns
or, for extensions with outside dialing access "0":
pppd call isdn/avm numberprefix 0 usepeerdns
Additional options of the CAPI 2.0 plug-in module (for example, GSM dial-in) for the "Generic PPP" stack (pppd) are described in section 7.
Version: 03.09.07
Build: 02.09.27
Installation of the two AVM ISDN-Controllers T1 and T1-B is identical. The only difference is that T1 and T1-B are initialized by different firmware files (T1.T4) in order to use the special features of the T1-B such as DTMF. For more details, see the manual of the ISDN-Controller in question.
Both ISDN-Controllers can be obtained in combination with two different T1 link adapters (T1 LA). These link adapters constitute the link between the ISDN-Controller T1 and the host PC and are available in PCI and ISA versions. The installation procedures are thus slightly different. Each of the driver archives contains the drivers required for all versions of the controller (T1 / T1-B) and also for both T1 LA versions (PCI and ISA).
Install the ISDN-Controller in a free slot. Read the manual for more information. In the case of the PCI link adapter, make sure to use a busmaster-capable PCI slot. For detail, see the manual for your computer or motherboard.
(1) Copy the archive "t1-suseX.X-YY.YY.YY.tar.gz" from the CAPI4Linux archive to your computer (e.g. from a diskette using the "mcopy" command from a console) and start the console (command prompt). Extract the archive with the command
tar -xzvf t1-SuSEX.X-YY.YY.YY.tar.gz
Example for SuSE 8.0:
tar -xzvf t1-SuSE8.0-03.09.07.tar.gz
A directory called "active" is created.
(2) Switch to this new directory "active".
(3) Start the installation program (according to the ISDN-Controller used) by entering
./install t1pci |
for AVM ISDN-Controller T1 with PCI link adapter |
./install t1bpci |
for AVM ISDN-Controller T1-B with PCI link adapter |
./install t1isa |
for AVM ISDN-Controller T1 with ISA link adapter |
./install t1bisa |
for AVM ISDN-Controller T1-B with ISA link adapter |
If no options for special protocol variants were specified (see 3a), a succession of selection menus now appears. Depending on the link adapter used, continue with step (3b) or (3c).
(3a) As an alternative to menu-controlled installation, you can install the controller also directly from the command prompt. The following options can be used:
./install t1pci -dss1 |
for AVM ISDN-Controller T1 with PCI link adapter and DSS1 [EURO-ISDN] |
./install t1pci -1tr6 |
for AVM ISDN-Controller T1 with PCI link adapter and 1TR6 [former national German protocol] |
./install t1isa -dss1 |
for AVM ISDN-Controller T1 with ISA link adapter and DSS1 [EURO-ISDN] |
./install t1isa -1tr6 |
for AVM ISDN-Controller T1 with ISA link adapter and 1TR6 [former national German protocol] |
./install t1bpci -dss1 |
for AVM ISDN-Controller T1-B with PCI link adapter and DSS1 [EURO-ISDN] |
./install t1bpci -1tr6 |
for AVM ISDN-Controller T1-B with PCI link adapter and 1TR6 [former national German protocol] |
./install t1bisa -dss1 |
for AVM ISDN-Controller T1-B with ISA link adapter and DSS1 [EURO-ISDN] |
./install t1bisa -1tr6 |
for AVM ISDN-Controller T1-B with ISA link adapter and 1TR6 [former national German protocol] |
(3b) Installation for ISDN-Controller with PCI link adapter
Make the appropriate selections for the D-channel protocol used on your ISDN line: E-DSS1 [EURO-ISDN] or 1TR6 (former German D-channel protocol)
The resources required for the controller are determined from the PCI BIOS of the computer (Plug-and-Play). Your entries are automatically registered under the relevant controller type "t1pci" or "t1bpci" in the "/etc/capi.conf" file.
(3c) Installation for ISDN-Controller with ISA link adapter
Because the T1 / T1-B link adapter (LA) is not a Plug&Play card, you must determine manually whether the necessary resources (free I/O address, free IRQ) are occupied by other hardware extensions. The driver software is set by default to use the resources "I/O address 150" and "IRQ 5". The ISA link adapter can use the following I/O addresses:
Assistance is provided in the following files, which list all *occupied* resources resp. list the resources used by other drivers:
These list contain all *occupied* resources by listing the resources used by other drivers. ATTENTION: These lists are not exhaustive, i.e., some resources *not* listed in these files may also be occupied!
When trying out values for the I/O port and IRQ, always monitor the driver outputs in the system log when the system is started. If loading of a driver is not successful, corresponding error messages will be returned there.
Once you have identified a free I/O port and a free IRQ, use this information for the remaining installation steps.
In these dialogs, make the selections for:
Your entries are automatically registered under the relevant controller type "t1isa" or "t1bisa" in the "/etc/capi.conf" file.
NOTE: |
If more than one ISA link adapter is to be used in the system, each link adapter must be assigned its own card ID through the SW1 jumper. For detailed information, see the ISDN-Controller T1/T1-B manual. A corresponding entry with the selected card ID must also be set in the "cardnr" column for the relevant AVM T1/T1-B controller in the "/etc/capi.conf" file! |
(4) Now restart your computer. The CAPI 2.0 driver is loaded automatically when the computer is restarted. Check with the "lsmod" command (only available to the "root" user, or "Superuser") whether the CAPI module is present in the system. The following loaded modules should be included in the output:
When installation is concluded, you can perform a ping test of the installation. For this purpose a test connection to the AVM Data Call Center (ADC) in Berlin is established over the "pppd" module. This simulates dialing in to any ISP (Internet Service Provider) using PPP sync in accordance with RFC1618 over HDLC. The necessary parameters are pre-defined under the argument "AVM". The number for the test server is ++49 30 39 98 43 20.
(1) Start a console (command prompt).
Establish a pppd connection with the following command:
pppd call isdn/avm
or, for extensions with outside dialing access "0":
pppd call isdn/avm numberprefix 0
Once a test connection has been established, the output window contains among other information the ping transit time to the AVM server over your ISDN-Controller. This means that installation was successful. To access the AVM home page with a web browser (like Netscape) directly with this test connection, the following command can also be used (DNS is assigned over the PPP connection):
pppd call isdn/avm usepeerdns
or, for extensions with outside dialing access "0":
pppd call isdn/avm numberprefix 0 usepeerdns
Additional options of the CAPI 2.0 plug-in module for the "Generic PPP" stack (pppd) are described in section 7.
Thanks to the open concept of Linux, all current distribution can be used with the software. Manual installation in these distributions must be adapted individually depending on the components installed (e.g. supplementary PCMCIA modules required, etc.). All driver components required to integrate the software, including source code and short instructions (the file "compile.en" or "compile-help-english.txt"), are supplied in the "fritz" directory of the respective driver archive. The binary-only modules contained in the drivers are kernel-independent. They cannot perform any direct kernel calls. This means that they can be integrated into any Linux kernel. The CAPI4Linux packages SuSE 8.1 and higher are already compatible with gcc 3.x. See section 10 for useful links.
The procedure required to remove or update the CAPI 2.0 driver software is identical for all internal ISDN-Controllers and for the AVM ISDN-Controller for the PCMCIA bus. USB devices load or unload the driver software dynamically when they are plugged into or out of the USB socket. Since the AVM ISDN-Controller in SuSE 8.1 is installed with YaST2, you have to remove the controller with YaST2. In all other SuSE Linux versions, please proceed as described in section 6.2 to remove your AVM ISDN-Controller manually.
In SuSE 8.1 or higher, you have to remove your AVM ISDN-Controller using the YaST2 Control Center. Proceed as follows:
This completes the removal of your controller. For an update in SuSE 8.1 or higher, simply start the new version of the CAPI 2.0 driver software.
For an update, simply start the new version of the CAPI 2.0 driver software after removing the previously used driver software. Proceed as follows:
The CAPI 2.0 plug-in module for pppd (Point-to-point Protocol Daemon) is loaded automatically with the ISDN-Controller driver and can be started with additional options if desired. This makes sense, for instance, when the charges for your online costs are to be billed separately by setting signaling of an outgoing number from the number block of MSNs. You may also choose between different protocols (analog modem for C2/C4, etc.) for different remote sites. A complete description of the CAPI 2.0 plug-in module for pppd is included as a UNIX manual page and can be viewed on the console by entering the command:
man capiplugin
A number of already pre-configured dial-in scripts for various call-by-call providers are included in delivery. In order to establish a connection to T-Online, for instance, a suitable dial-in script called "/etc/ppp/peers/isdn/t-online" should be configured as follows:
----- start -----
debug
sync
noauth
plugin /etc/ppp/plugins/userpass.so
username 11111\#22222\#0001\#@t-online.de
password 3333333
defaultroute
plugin /etc/ppp/plugins/capiplugin.so
number 0191011
protocol hdlc
ipcp-accept-local
ipcp-accept-remote
/dev/null
----- end -----
Enter the following parameter:
11111: max 12-digit connection ID
22222: max 12-digit T-Online number 0001: co-user
33333: password
ATTENTION: |
The character "\" before "#" is important! |
A maximum of up to four active AVM ISDN-Controllers are supported per system or server. Any mixed configuration can be installed using any of the supported bus systems ISA, PCI, PCMCIA and USB. It is not possible to install a mixed configuration of passive AVM ISDN-Controllers (such as FRITZ!Card) and active AVM ISDN-Controllers.
To install an additional active AVM ISDN-Controller, simply perform the installation for the desired controller again. Each single ISDN-Controller can be set to an individual configuration, such as different D-channel protocols and line types (P2P / P2M). In the case of an AVM ISDN-Controller C4 (4BRI), the logical controller is comprised of four individual CAPI controllers (1 through 4) with two B channels each, although these "controllers" are physically combined on one plug-in card. If another controller is added, for instance, a AVM ISDN-Controller B1, this controller then can be addressed by an application as CAPI controller number 5.
The same applies for the ISDN-Controller C2. If a mixed installation of an ISDN-Controller C4 together with an ISDN-Controller 2 is installed, please install the ISDN-Controller C4 first to ensure the correct CAPI controller numbers assignment (CAPI controller numbers 1 through 4 on the C4, 5 through 6 on the C2).
An example of a modified "/etc/capi.conf" file for a mixed installation of different controllers: |
|||||||
# card |
file |
proto |
io |
irq |
mem |
cardnr |
options |
# |
|
|
|
|
|
|
|
c4 |
c4.bin |
DSS1 |
- - - - |
- - - - |
- - - - |
- - - - |
- - - - |
c4 |
- - - - |
DSS1 |
- - - - |
- - - - |
- - - - |
- - - - |
- - - - |
c4 |
- - - - - |
DSS1 |
- - - - |
- - - - |
- - - - |
- - - - |
- - - - |
c4 |
- - - - - |
DSS1 |
- - - - |
- - - - |
- - - - |
- - - - |
- - - - |
c2 |
c2.bin |
DSS1 |
- - - - |
- - - - |
- - - - |
- - - - |
- - - - |
c2 |
- - - - - |
DSS1 |
- - - - |
- - - - |
- - - - |
- - - - |
- - - - |
When the installation program is run, all of the options specified in the command line for all CAPI controllers on the card, i.e., the four lines in the "/etc/capi.conf" file, have the same structure.
For instance, to set two of the four controllers of the ISDN-Controller C4 to an Point-to-Point (P2P) line, simply change the "/etc/capi.conf" file manually. The same is true for multiple ISDN-Controllers B1 and B1 PCI.
An example of a modified "/etc/capi.conf": |
|||||||
# card |
file |
proto |
io |
irq |
mem |
cardnr |
options |
# |
|
|
|
|
|
|
|
# b1pci |
b1.t4 |
DSS1 |
- - - - |
- - - - |
- - - - |
- - - - |
|
c4 |
c4.bin |
DSS1 |
- - - - |
- - - - |
- - - - |
- - - - |
|
c4 |
- - - - |
DSS1 |
- - - - |
- - - - |
- - - - |
- - - - |
|
c4 |
- - - - |
DSS1 |
- - - - |
- - - - |
- - - - |
- - - - |
PPP |
c4 |
- - - - |
DSS1 |
- - - - |
- - - - |
- - - - |
- - - - |
PPP |
In the above example, the first two ISDN-controllers of the ISDN-Controller C4 are set to the ISDN Point-to-Multipoint line, while the remaining two ISDN-Controllers use the Point-to-Point protocol.
When installing multiple ISDN-Controllers, always be sure to avoid any resource conflicts in your system. The CAPI4Linux drivers support IRQ sharing in accordance with the PCI 2.x Spec. as a matter of course. This means that the IRQs required by the AVM ISDN-Controllers for the PCI bus (!) can be used multiple times, thus preventing resource conflicts.
It must be possible to configure CAPI applications accordingly for the use of an nth CAPI controller. The CAPI4HylaFAX module and the pppd plug-in support this feature.
The CAPI4Linux driver package contains a number of help programs which present additional information about the technical features of the CAPI 2.0 drivers and offer diagnosis options.
Note | The help programs capiinit stop, capiinit start und capiinit show are valid only for SuSE Linux 8.0 and below. |
Command: |
option: |
Meaning |
capiinit |
stop |
Stops the CAPI driver manually. |
|
start |
Starts the CAPI driver manually. |
|
show |
The output contains the name of the driver used, the firmware module, occupied resources and selected protocol options (P2P). |
capiinfo |
|
Shows additional information about the capabilities of the CAPI 2.0
driver. |
cat /proc/capi/controller |
|
Shows information including the logical controller numbers of all installed ISDN-Controllers in accordance with CAPI 2.0. |
cat /proc/capi/controllers/<n> |
|
Shows additional configuration information about the ISDN-Controller with the number "<n/" (see also "cat /proc/capi/controller"). This output is generated directly by the driver and contains such information as the serial number and the selected line type, e.g. Point-to-Point (P2P) or Point-to-Multipoint (P2M). |
A complete description of the "capi" help program is contained in the form of a "UNIX manual page" and can be opened on a console with the command:
man capiinfo
AVM provides with the CAPI 2.0 application "K ISDN Watch" a powerful monitoring tool for all AVM ISDN-Controllers supported by CAPI4Linux. The ISDN Monitor "K ISDN Watch" is subject to the GPL, is based on "kimon" and can be translated for KDE . The application can be downloaded from: ftp.avm.de/tools/k_isdn_watch.linux
(1) Information about the CAPI 2.0 Specification
The CAPI 2.0 Specification can be downloaded free of charge from the
Internet site:
Additional questions about the CAPI 2.0 Specification should be asked in Usenet and addressed to
news:comp.os.linux.networking or news:comp.dcom.isdn.capi
(2) Useful discussions of ISDN and Linux issues can be found at:
(3) FAQs
(4) Mailing List / ftp Server
The Linux drivers for active AVM ISDN-Controllers originally were developed by Carsten Paeth ("Calle"). The "CAPI4Linux" model for active AVM ISDN-Controllers is based on these developments. Typical development issues continue to be discussed on this mailing list.
The mailing list is located at:
linux-avmb1@calle.in-berlin.de
To subscribe to the mailing list:
Send an e-mail to majordomo@calle.in-berlin.de with the following
contents:
subscribe linux-avmb1 <your_email_address>
To unsubscribe to the mailing list: Send an e-mail to
majordomo@calle.in-berlin.de with the following contents:
unsubscribe linux-avmb1 <your_email_address>
There is also an ftp server with additional patches for special
implementations, e.g. for combination with VBOX. A number of sample
programs for CAPI 2.0 applications programming in Linux are also available
here. The site is located at:
ftp.in-berlin.de/pub/capi4linux
or ftp.in-berlin.de/pub/users/calle/capi4linux
This site provides patches developed independently of AVM for a number of special implementations. CAPI 2.0 demo programs currently stored here include (capiconn-xxxx-yy-zz.tar.gz):
(5) Information about faxing with capircvd, an already existing CAPI
2.0-based program for receiving faxes (G3) and voice calls, is provided at
the URL:
http://capircvd.de
(6) CAPI4Linux and Slackware (7.0 and higher) information about integration in Slackware plus capi4k-utils, VBOX etc. is available at:
(7) FRITZ!Card PCI v2.0 in RedHat 7.1 mini HowTo:
http://lauer.monweb.lu/howtos/FRITZ!PCI_RH71_HowTo.html
AVM offers e-mail support for this product. This support is limited to the actual installation and the ISDN functionality up to the successful completion of the test connection or the test fax of over CAPI 2.0 drivers and the CAPI4HylaFAX module in combination with AVM ISDN-Controllers using the provided installation programs.
For questions about network configuration, integrated functions of the operating system Linux and applications from other manufacturers, please contact the relevant manufacturer or the support service of the distribution used. Please address your questions concerning configuration and operation of HylaFAX to www.hylafax.org.
The AVM web site offers detailed information and updates free of charge. Visit the site at www.avm.de/en.
The "Products" category provides detailed information about all AVM products as well as announcements of new products and product versions.
Through "Service" the FAQs (Frequently Asked Questions) can be accessed along with a list of their answers. Solutions to concrete problems are offered here.
The current driver software for all AVM ISDN-Controllers can be downloaded from the "Download" area. All programs and drivers available from the Internet site can also be obtained from the AVM Data Call Center (ADC).
Please use the information sources described above before contacting the support. If these instructions and the various information sources have not helped to resolve your problem, contact AVM Support for additional technical assistance. You may send your support requests to AVM by e-mail. Support inquiries can be sent to AVM using the e-mail form provided at the Internet address
Fill out the form and mail it to AVM Support by clicking the "Send" button.
EOF
SAS; 02/2003