1 What Is the CAPI4Linux Project and What Is
It for?
1.1 What Are the Basic Differences Between CAPI4Linux and its Predecessor, ISDN4Linux?
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
4.1 Installing Passive AVM ISDN-Controllers or the AVM DSL/ISDN-Controller in SuSE Linux 8.1 or Higher
4.1.1 Preparing the AVM ISDN-Controllers or the AVM DSL/ISDN-Controller for Installation with YaST2 in SuSE Linux 8.1 or Higher
4.1.2 Installing Passive AVM ISDN-Controllers or the AVM DSL/ISDN-Controller together with the CAPI4Linux Package in SuSE 8.1 or Higher
4.2 Installing Passive AVM ISDN-Controllers or the AVM DSL/ISDN-Controller up to SuSE 8.0
4.2.1 Installing the AVM ISDN-Controller FRITZ!Card PCI / FRITZ!Card PCI v2.x up to SuSE 8.0
4.2.2 Installing the AVM ISDN-Controller FRITZ!Card Classic / A1 up to SuSE 8.0
4.2.2 Installing the AVM ISDN-Controller FRITZ!Card PnP up to SuSE 8.0
4.2.4 Installing the AVM ISDN-Controller FRITZ!Card PCMCIA / A1 PCMCIA up to SuSE 8.0
4.2.5 Installing the AVM ISDN-Controller FRITZ!Card USB, FRITZ!Card USB v2.x, FRITZ!X USB or FRITZ!X USB v2.0 up to SuSE 8.0
4.2.6 Installing the AVM DSL/ISDN-Controller FRITZ!Card DSL
5 Installation Instructions for Integrating the AVM ISDN-Controllers in Other Linux Distributions
6 Removing the Controller / Driver Update
6. 1Removing the Controller / Driver Update in SuSE 8.1 or Higher
6. 2Removing the Controller/Driver Update in SuSE 8.0 or Below
7 Information About the CAPI 2.0 Plug-in Module for the "Generic PPP" Stack (pppd)
8.1 ISDN Monitor "K ISDN Watch" for KDE 2.x / 3.x
8.2 ADSL Monitor "K ADSL Watch" for KDE 2.x / 3.x
The CAPI Association (www.capi.org) adopted an obligatory CAPI 2.0 standard for Linux in fall 1999. 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.
In addition, FRITZ!Card DSL provides you access to DSL via the CAPI interface. Now ISDN services can be used parallel to DSL services via only one single interface.
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.
The idea behind the CAPI4Linux project is a new approach for ISDN communication in Linux. Only a unified, mandatory interface allows the development of applications based on this 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 CAPI interface at the beginning of the 1990s.
CAPI4Linux currently supports the following internal AVM ISDN-Controllers:
For the following 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.
The INTEL i386 platform is supported on any single-CPU computer with one passive AVM ISDN-Controller or the FRITZ!Card DSL installed. AVM's active ISDN-Controllers are also supported. They are especially suitable for server operation and offer support for SMP computers and additional Linux-supported hardware platforms. Up to four active controllers can be installed on each system.
For simple installation, AVM provides pre-compiled driver archives for the following Linux distributions:
* "Out of maintenance state (EOM)", i.e., these older versions are no longer supported with current drivers.
Installation for these distributions is described in this document. 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.
The chip set driver "HiSAX" runs as an application packet on CAPI 2.0 over the modules "capidrv.o" and "isdn.o".
The chip set driver HiSAX as low-level hardware driver is replaced by the CAPI 2.0 driver and may not be installed in the same system as the CAPI4Linux package.
By now there are a multitude of Internet pages with information, tips and tricks, HowTos and the like about integrating CAPI4Linux in further distributions and kernel versions. For more information, please see section 9.
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/de (unfortunately, this FAQ site is only available in German).
When using SuSE Linux distributions from version 8.1 onwards, an installation of the AVM DSL/ISDN-Controllers requires a previous installation of the 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 DSL/ISDN-Controllers using YaST2 can be found in the following section.
The installation of passive AVM ISDN-Controllers or the AVM DSL/ISDN-Controller in SuSE Linux 8.1 is described in the following sections. Before beginning with installation, prepare your system as follows.
Operating system: | SuSE Linux 8.1 (Kernel 2.4.19-4GB) and other distributions |
Version: | 03.10.02 or 3.10.05 for FRITZ!Card DSL |
Build: | 02.12.13 |
Installation requirements:
NOTE: | This section provides assistance to meet the installation requirements for the installation of the CAPI4Linux package using SuSE Linux 8.1 or higher. If you already have installed your controller in SuSE 8.1 using YaST2, continue with section 4.1.2 Installing Passive AVM ISDN-Controllers or the AVM DSL/ISDN-Controller together with the CAPI4Linux Package in SuSE 8.1 or Higher. |
If you are working with SuSE 8.0 or lower, please continue with the installation section relevant to your AVM ISDN-Controller or DSL/ISDN-Controller! Please click the corresponding link for your controller:
AVM ISDN-Controller FRITZ!Card PCI / PCI v2.x
AVM ISDN-Controller FRITZ!Card Classic / A1
AVM ISDN-Controller FRITZ!Card PnP
AVM ISDN-Controller FRITZ!Card PCMCIA / A1 PCMCIA
AVM ISDN-Controller FRITZ!Card USB, FRITZ!Card USB v2.x,
FRITZ!X USB, FRITZ!X USB v2.0
AVM DSL/ISDN-Controller FRITZ!Card DSL
Additional information regarding pppd and the script's usage can be
found in the following section and in section 7 Information
about 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 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 controller using the AVM CAPI4Linux package in SuSE 8.1 have now been fulfilled. Please install your AVM DSL/ISDN-Controller now, as described in the following section 4.1.2 Installing Passive AVM ISDN-Controllers or the AVM DSL/ISDN-Controller together with the CAPI4Linux Package in SuSE 8.1 or Higher.
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 DSL/ISDN-Controller using YaST2. Installation with the AVM CAPI4Linux package cannot be carried out until the YaST2 installation has been completed! Instructions for installing your AVM DSL/ISDN-Controller with YaST2 are available in section 4.1.1 Preparing the AVM ISDN-Controllers or the AVM DSL/ISDN-Controllers for Installation with YaST2 in SuSE Linux 8.1 or Higher |
A1 / FRITZ!Card Classic: | fcclassic-susex.x-yy.yy.yy.tar.gz |
FRITZ!Card DSL | fcdsl-susex.x-yy.yy.yy.tar.gz |
FRITZ!Card PCI: | fcpci-susex.x-yy.yy.yy.tar.gz |
FRITZ!Card PCI v2.x: | fcpci-susex.x-yy.yy.yy.tar.gz |
A1 / FRITZ!Card PCMCIA: | fcpcmcia-susex.x-yy.yy.yy.tar.gz |
FRITZ!Card PnP: | fcpnp-susex.x-yy.yy.yy.tar.gz |
FRITZ!Card USB: | fcusb-susex.x-yy.yy.yy.tar.gz |
FRITZ!Card USB v2.x: | fcusb2-susex.x-yy.yy.yy.tar.gz |
FRITZ!X USB: | fxusb-susex.x-yy.yy.yy.tar.gz |
tar -xzvf fcusb-SuSEX.X-YY.YY.YY.tar.gz
Example for FRITZ!Card DSL in SuSE 8.1: tar
-xzvf fcdsl-suse8.1-03.10.05.tar.gz
A directory called "fritz" is created.
*Only for installed PCMCIA drivers the module fcpcmicia_cs is also present!
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.0.
The installation of passive AVM ISDN-Controllers or the AVM DSL/ISDN-Controller up to SuSE 8.0 is described below. Read the section that describes the installation of your controller.
AVM ISDN-Controller FRITZ!Card PCI / PCI v2.x
AVM ISDN-Controller FRITZ!Card Classic / A1
AVM ISDN-Controller FRITZ!Card PnP
AVM ISDN-Controller FRITZ!Card PCMCIA / A1 PCMCIA
AVM ISDN-Controller FRITZ!Card USB, FRITZ!Card USB v2.x,
FRITZ!X USB, FRITZ!X USB v2.0
AVM DSL/ISDN-Controller FRITZ!Card DSL
Operating system: | SuSE Linux 6.3 (Kernel 2.2.13), SuSE Linux 6.4 (Kernel 2.2.14), SuSE Linux 7.0 (Kernel 2.2.16), SuSE Linux 7.1 (Kernel 2.2.18/2.4.0-4GB), SuSE Linux 7.2 (Kernel 2.4.4-4GB), SuSE Linux 7.3 (Kernel 2.4.10-4GB), SuSE Linux 8.0 (Kernel 2.4.18-4GB) and other distributions |
Version: | 03.09.10 |
Build: | 02.09.06 |
Installation requirements:
ISDN4Linux is not required for installation of the controller. To switch from ISDN4Linux to CAPI4Linux and continue using the ISDN4Linux features (upgrade), the additional installation step (4) is required. Please see the additional information in section 3.
(1) Copy the archive "fcpci-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 corresponding to the SuSE version used with the command
tar -xzvf fcpci-SuSEX.X-YY.YY.YY.tar.gz
Example for SuSE 8.0:tar -xzvf
fcpci-SuSE8.0-03.09.10.tar.gz
A directory called "fritz" is created.
(2) Switch to the new directory "fritz".
(3) Run "./install".
If "ISDN4Linux" was already installed and is to remain active,
the following step must be performed:
(4) The "Start I4L" menu command must be activated with [X].
Change the entry "ippp0" into an AVM B1 PCI (!) using the
program "YaST". This activates the AVM section in the exchanged
script below:
"/sbin/init.d/i4l_hardware"
(Start YaST 1.x / System Administration / Configuring Network /
Configuring ISDN Parameter / select "ISDN Hardware" using the
TABULATOR key / activate "Start I4L" / select "AVM B1 PCI"
as ISDN adapter / save the settings / click "Next" / ESC and
exit YaST).
(YaST2 users proceed as follows: "K Menu / Control Center / 'Index'
settings page / open 'YaST2' / click 'ISDN' / on the dialog page 'ISDN low
level configuration, click the 'Manual ISDN Setup...' button / click
'Next' / select 'AVM B1 PCI' as type of card / click 'Next' / if
necessary, enter the settings in the 'ISDN Protocol', 'ISP Selection',
'ISP parameters' and 'ISDN connection parameters' / conclude by clicking
'Finish'").
(5) Restart your computer. The CAPI 2.0 driver is initialized automatically. 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:
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.
(1) Start a console (command prompt).
(2) Establish a pppd connection by entering the following command:
pppd call isdn/avm
If you are working at a PBX extension with outside dialing access "0", please enter the following command:
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, the following command can also be used (DNS is assigned over the PPP connection):
pppd call isdn/avm usepeerdns
If you are working at a PBX extension with outside dialing access "0", please enter the following command:
pppd call isdn/avm numberprefix 0 usepeerdns
Enter the keyboard shortcut "Strg+C" to clear down the connection.
Additional options of the CAPI 2.0 plug-in module for the "Generic PPP" stack (pppd) are described in section 7.
Operating system: | SuSE Linux 6.3 (Kernel 2.2.13), SuSE Linux 6.4 (Kernel 2.2.14), SuSE Linux 7.0 (Kernel 2.2.16), SuSE Linux 7.1 (Kernel 2.2.18/2.4.0-4GB), SuSE Linux 7.2 (Kernel 2.4.4-4GB), SuSE Linux 7.3 (Kernel 2.4.10-4GB), SuSE Linux 8.0 (Kernel 2.4.18-4GB) and other distributions |
Version: | 03.09.10 |
Build: | 02.09.06 |
Installation requirements:
ISDN4Linux is not required for installation of the controller. To switch from ISDN4Linux to CAPI4Linux and continue using the ISDN4Linux features (upgrade), the additional installation step (5) is required. Please see the additional information in section 3.
(1) Copy the archive "fcclassic-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 fcclassic-SuSEX.X-YY.YY.YY.tar.gz
Example for SuSE 8.0: tar -xzvf
fcclassic-SuSE8.0-03.09.10.tar.gz
A directory called "fritz" is created.
(2) Because FRITZ!Card Classic 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 300" and "IRQ 5". The jumper on the FRITZ!Card Classic is also set to the I/O address 300 (factory default).
The I/O address required by the FRITZ!Card Classic is set by jumper on
the controller such that conflicts with other hardware extensions should
be avoided.
FRITZ!Card Classic can use the following I/O addresses: 200, 240, 300,
340.
How Can I Find out Which Resources on My Computer Can Be Used for
FRITZ!Card Classic?
Assistance is provided in the following files, which list all *occupied*
resources which are used by other drivers:
cat /proc/ioports | //shows the occupied I/O addresses |
cat /proc/interrupts | //shows the occupied IRQs |
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, the selected I/O
address also must be set by means of the jumper on the AVM ISDN-Controller
FRITZ!Card Classic. 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 FRITZ!Card Classic into a free ISA slot.
(4) Switch to the new "fritz" directory and start the
installation program by entering "./install".
Open the file "/etc/capi.conf" in an editor and enter the I/O
address and IRQ identified in step (2) at the entry of the controller type
"fcclassic".
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!
If "ISDN4Linux" was already installed and is to remain active,
the following step must be performed:
(5) The "Start I4L" menu command must be activated with [X].
Change the entry "ippp0" into an AVM B1 PCI (!) using the
program "YaST". This activates the AVM section in the exchanged
script below:
"/sbin/init.d/i4l_hardware"
(Start YaST 1.x / System Administration / Configuring Network /
Configuring ISDN Parameter / select "ISDN Hardware" using the
TABULATOR key / activate "Start I4L" / select "AVM B1 PCI"
as ISDN adapter / save the settings / click "Next" / ESC and
exit YaST)
(YAST2 users proceed as follows: "K Menu / Control Center / 'Index'
settings page / open 'YaST2' / click 'ISDN' / on the dialog page 'ISDN low
level configuration, click the 'Manual ISDN Setup...' button / click
'Next' / select 'AVM B1 PCI' as type of card / click 'Next' / if
necessary, enter the settings in the 'ISDN Protocol', 'ISP Selection',
'ISP parameters' and 'ISDN connection parameters' / conclude by clicking
'Finish'").
(6) Restart your computer. The CAPI 2.0 driver is initialized automatically. 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:
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.
(1) Start a console (command prompt).
(2) Establish a pppd connection by entering the following command:
pppd call isdn/avm
If you are working at a PBX extension with outside dialing access "0", please enter the following command:
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, the following command can also be used (DNS is assigned over the PPP connection):
pppd call isdn/avm usepeerdns
If you are working at a PBX extension with outside dialing access "0", please enter the following command:
pppd call isdn/avm numberprefix 0 usepeerdns
Enter the keyboard shortcut "Strg+C" to clear down the connection.
Additional options of the CAPI 2.0 plug-in module for the "Generic PPP" stack (pppd) are described in section 7.0.
Operating system: | SuSE Linux 6.3 (Kernel 2.2.13), SuSE Linux 6.4 (Kernel 2.2.14), SuSE Linux 7.0 (Kernel 2.2.16), SuSE Linux 7.1 (Kernel 2.2.18/2.4.0-4GB), SuSE Linux 7.2 (Kernel 2.4.4-4GB), SuSE Linux 7.3 (Kernel 2.4.10-4GB), SuSE Linux 8.0 (Kernel 2.4.18-4GB) and other distributions |
Version: | 03.09.10 |
Build: | 02.09.06 |
Installation requirements:
ISDN4Linux is not required for installation of the controller. To switch from ISDN4Linux to CAPI4Linux and continue using the ISDN4Linux features (upgrade), the additional installation step (5) is required. Please see the additional information in section 3.
(1) Copy the archive "fcpnp-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 fcpnp-SuSEX.X-YY.YY.YY.tar.gz
Example for SuSE 8.0: tar -xzvf
fcpnp-SuSE8.0-03.09.10.tar.gz
A directory called "fritz" is created.
(2) Install the AVM FRITZ!Card PnP in your computer. The next installation steps depend on the distribution resp. kernel version used, since facilitation regarding automatic recognition of plug-and-play cards are only available in the Linux kernel of SuSE 7.2 and higher.
In SuSE 7.2 or later, the installation is similar to the installation of FRITZ!Card PCI, since the allocated resources of an ISA plug-and-play card can be detected automatically. Continue with step (2) in section 4.2.1.
Operating system: | SuSE Linux 6.3 (Kernel 2.2.13), SuSE Linux 6.4 (Kernel 2.2.14), SuSE Linux 7.0 (Kernel 2.2.16), SuSE Linux 7.1 (Kernel 2.2.18/2.4.0-4GB), SuSE Linux 7.2 (Kernel 2.4.4-4GB), SuSE Linux 7.3 (Kernel 2.4.10-4GB), SuSE Linux 8.0 (Kernel 2.4.18-4GB) and other distributions |
Version: | 03.09.10 |
Build: | 02.09.06 |
Installation requirements:
ISDN4Linux is not required for installation of the controller. To switch from ISDN4Linux to CAPI4Linux and continue using the ISDN4Linux features (upgrade), the additional installation step (4) is required. Please see the additional information in section 3.
Preparation for PCMCIA capability:
Install the "external PCMCIA package", from the package pcmcia-Y.Y.YY and the pcmcia-cardinfo-Y.Y.YY ("Y" stands for the package version), from the SuSE-CDs. 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). Start the package with the command "rcpcmcia start". If the package does not start, restart your computer.
(1) Copy the archive "fcpcmcia-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 fcpcmcia-SuSEX.X-YY.YY.YY.tar.gz
Example for SuSE 8.0: tar -xzvf
fcpcmcia-SuSE8.0-03.09.10.tar.gz
A directory called "fritz" is created.
(2) Switch to the new directory "fritz".
NOTE: | In SuSE 7.2 or higher, the installation is similar to the installation of FRITZ!Card PCI. If you are working in SuSE 7.2 or higher, insert the card in the PCMCIA slot and proceed with step (2) in section 4.2.1. |
Operating system: | SuSE Linux 7.1 (Kernel 2.2.18/2.4.0-4GB), SuSE Linux 7.2 (Kernel 2.4.4-4GB), SuSE Linux 7.3 (Kernel 2.4.10-4GB), SuSE Linux 8.0 (Kernel 2.4.18-4GB) and other distributions |
Version: | 03.09.10 |
Build: | 02.09.06 |
Installation requirements:
ISDN4Linux is not required for installation of the controller. If you want to switch from ISDN4Linux to CAPI4Linux, but want to continue using the ISDN4Linux features, the additional installation step (4) is required. Please see the additional information in section 3.
Instructions for FRITZ!X USB / FRITZ!X USB v2.0 users | Both devices are addressed by a uniform CAPI 2.0 driver. The following installation allows the ISDN-Controller integrated in these external devices to be used in Linux. For the configuration of the analog a/b ports of these device, please use a touch-tone dialing (DTMF) telephone or the enclosed software for MS Windows. See the documentation of your AVM ISDN-Controller for details. |
(1) Copy the appropriate driver archive for your ISDN-Controller
FRITZ!Card USB: | "fcusb-SuSEX.X-YY.YY.YY.tar.gz" |
FRITZ!Card USB v2.x: | "fcusb2-SuSEX.X-YY.YY.YY.tar.gz" |
FRITZ!X USB / FRITZ!X USB v2.0: | "fxusb-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 corresponding to the distribution used with the command
tar -xzvf fcusb-SuSEX.X-YY.YY.YY.tar.gz
Example for SuSE 8.0: tar -xzvf
fcusb-SuSE8.0-03.09.10.tar.gz
A directory called "fritz" is created.
(2) Switch to the new directory "fritz".
(3) Run "./install".
(4) Connect the AVM ISDN-Controller to your computer's USB socket. The "USB" LED on the ISDN-Controller now signals a correct physical connection to the USB (root) hub.
(5) The CAPI 2.0 driver is activated automatically. 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:
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.
(1) Start a console (command prompt)
(2) Establish a pppd connection by entering the following command:
pppd call isdn/avm
If you are working at a PBX extension with outside dialing access "0", please enter the following command:
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, the following command can also be used (DNS is assigned over the PPP connection):
pppd call isdn/avm usepeerdns
If you are working at a PBX extension with outside dialing access "0", please enter the following command:
pppd call isdn/avm numberprefix 0 usepeerdns
Enter the keyboard shortcut "Strg+C" to clear down the connection.
Additional options of the CAPI 2.0 plug-in module for the "Generic PPP" stack (pppd) are described in section 7.
Operating system: | SuSE Linux 7.3 (Kernel 2.4.10-4 GB), SuSE Linux 8.0 (Kernel 2.4.18-4GB) and other distributions |
Version: | 03.09.14 |
Build: | 02.09.06 |
Installation requirements:
The module "pppd" (Point-to-point Protocol Daemon) is required for Internet access. "pppd" can also be used to establish a test connection to the AVM Data Call Center (ADC) over ISDN at the conclusion of installation. This test simulates a connection to an ISP (Internet Service Provider).
ISDN4Linux is not required for installation of the controller. If you want to switch from ISDN4Linux to CAPI4Linux, but want to continue using the ISDN4Linux features, please note the information in section (3).
If you want to use FRITZ!Card DSL together with an active ISDN-Controller (AVM ISDN-Controller B1, for example), please install the active ISDN-Controller first (!) and then FRITZ!Card DSL. The ISDN features of FRITZ!Card DSL are then deactivated. Both modules for DSL and for ISDN operation on your FRITZ!Card DSL can work independently of each another.
(1) Connect the FRITZ!Card DSL with the DSL access (for detailed information, please see the manual).
(2) Copy the archive "fcdsl-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 corresponding to the SuSE version used with the command
tar -xzvf fcdsl-SuSEX.X-YY.YY.YY.tar.gz
Example for SuSE 8.0: tar -xzvf
fcdsl-SuSE8.0-03.09.14.tar.gz
A directory called "fritz" is created.
(3) Switch to the new directory "fritz".
(4) Run "./install".
(5) After the installation of the driver software, the DSL Assistant
starts automatically and detects the ATM parameters of your ADSL access.
You will see the following console output for a T-DSL access [U-R]:
Analyzing DSL parameters...
Driver versions: stack: 3.09-14, firmware: 1.00.37
Please wait... (up to 3 minutes)
Line parameters found: VPI=1 VCI=32 VCC=1
Ready.
NOTE: The format of the pppd peer scripts has been changed! The peer
scripts have been checked/updated.
Starting CAPI4Linux...
1 fcdsl | running | fcdsl-pci | A1 3.09-14 io E2800000 mem E300 |
2 fcdsl | running | fcdsl-pci | A1 3.09-14 io E2800000 mem E300 |
Now the driver is loaded an the controller is ready for DSL and ISDN operation. If the "line parameter" / "ATM parameter" could not (!) be detected automatically, please check the following:
After installation, you can start the DSL Assistant manually with the
following command:
drdsl
The DSL parameters detected at a T-DSL access are entered automatically in
the file "/etc/modules.conf" as follows:
options fcdsl VPI=1 VCI=32 VCC=1
(6) The CAPI 2.0 driver is loaded automatically the next time the system is started. Check with the "lsmod" command (only available to the "root" user, or "Superuser") whether the CAPI module for DSL and ISDN is present in the system. The following loaded modules should be included in the output:
Upon conclusion of installation, perform a PING test (via ISDN) of the
installation. This checks whether installation was completed successfully.
Establish an ISDN 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).
(2) Establish a pppd connection by entering the following command:
pppd call isdn/avm
If you are working at a PBX extension with outside dialing access "0", please enter the following command:
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, the following command can also be used (DNS is assigned over the PPP connection):
pppd call isdn/avm usepeerdns
If you are working at a PBX extension with outside dialing access "0", please enter the following command:
pppd call isdn/avm numberprefix 0 usepeerdns
Enter the keyboard shortcut "Strg+C" to clear down the connection.
Additional options of the CAPI 2.0 plug-in module for the "Generic PPP" stack (pppd) are described in section 7.
DSL dial-up: To establish a DSL connection, you can use the CAPI 2.0 plug-in module for the pppd stack. A pre-defined dial-in script simplifies connecting to T-Online. Please change the script accordingly for other DSL providers. To use the script, enter your access data. After the installation of the driver software the sample script for the T-DSL access can be found in the directory "/etc/ppp/peers".
Establish the connection with the following command:
pppd call t-dsl
To clear down the connection, enter the keyboard shortcut "Strg+C".
Communication between any USB device with the USB host controller generally requires a special driver for the respective operating system. In the Linux community, four different drivers have been developed and are provided: "uhci.o" or "usb-uhci.o", "usb-ohci.o" and "ehci-hcd.o". You may use any of the four drivers to install an AVM ISDN-Controllers for the USB port. All drivers are equipped with similar features, but are not identical. Usually, a suitable host controller driver is selected and installed during the SuSE installation. In SuSE 8.0, your operating system selects automatically a suitable USB driver. For stable operation of AVM USB devices in SuSE 7.1/7.2, the "uhci" driver is recommended. The installation program automatically activates this driver for these SuSE versions, as long as no (!) other USB devices (such as scanners, mouses, etc.) are registered at "usb-uhci". In that case, a prompt will appear, and you have to reboot your computer.
Normally all other USB devices already installed in the system should cooperate smoothly with the "uhci" driver. In exceptional cases where problems arise, the "usb-uhci" driver (in SuSE 7.1/7.2) can be initialized manually by editing the "/etc/usbmgr/host" file after a reboot. This file contains the name of the host controller driver used by the system, i.e. "usb-ohci", "usb-uhci" or "uhci".
(SuSE 7.3: see the file "/etc/rc.config.d/hotplug.rc.config", which lists in the entry HOTPLUG_USB_HOSTCONTROLLER_LIST all host controller drivers. These drivers should be loaded following the order presented there. In SuSE 8.0, you will find the entry HOTPLUG_USB_HOSTCONTROLLER_LIST in the "/etc/sysconfig/hotplug file".)
The AVM ISDN-Controllers in Linux provide the same features as in MS Windows: power is supplied without an external power plug ("bus powered"), the controllers can be connected to the USB bus dynamically without restarting the operating system ("Hot Plug&Play").
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 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 DSL/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 DSL/ISDN-Controller manually.
In SuSE 8.1 or higher, you have to remove your AVM
DSL/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:
(1) Exit all CAPI applications (CAPI4HylaFAX or ISDNWatch, for example).
If a PCMCIA controller is installed, remove the AVM ISDN-Controller from
the PCMCIA slot.
(2) Open the console and enter "capiinit stop".
To remove the driver in SuSE 8.0, enter "./install -r".
(3) Deactivate the AVM ISDN-Controller entry in the "/etc/capi.conf"
file by entering a "#".
If you want to perform an update, you can start the installation now.
Skip the next two steps.
(4) Shut down the computer and then remove the controller.
(5) Restart the computer.
This completes the removal of your controller.
The CAPI 2.0 plug-in module for pppd (Point-to-point Protocol Daemon) is loaded automatically with the CAPI 2.0 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.
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
user 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 -----
The following parameters have to be included in the T-Online script:
11111: max 12-digit connection ID
22222: max 12-digit T-Online number
0001: joint user
33333: Password
!!!!! The character "\" before "#" is important!
If your DSL access is provided by the DSL carrier "1&1", the script "t-dsl" in "etc/ppp/peers/" has to be edited as follows:
Replace the following line:
user 000000000000\#000000000000\#0001\#@t-online.de
password 00000000
with the following entries:
user 1und1/<your
login-id>@online.de
password <your password>
Please note that the entries <your login ID> and <your password> have to be replaced by the user ID ("1111-222", for instance) and the corresponding password assigned to you by 1&1.
Extract from an adapted example script:
# Connection ID T-Online number joint user ID
# | | |
user 1und1/1234-5678@online.de
password confidential
linkname t-dsl
ipparam internet
plugin capiplugin.so
avmadsl
:# /dev/null
...
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 and capiinit show are only valid for installations up to SuSE Linux 8.0. |
Command: capiinit
Option: stop
Definition: Stops the CAPI driver manually.
Command: capiinit
Option: start
Definition: Starts the CAPI driver manually.
The output contains first the CAPI 2.0 controller number, followed by the run status of the driver, the name of the driver module, the type of the controller and the occupied resources.
Command: capiinit
Option: show
Definition: The output contains the name of the driver used, the firmware
module, occupied resources and selected protocol options (P2P).
Command: Capiinfo
Definition: Shows additional information about the capabilities of the
CAPI 2.0 driver.
The output contains detailed information about the driver version,
B-channel protocols supported by the driver and about the supplementary
services in the D channel.
Command: cat /proc/capi/controller
Definition: Shows information including the logical controller numbers of
all installed CAPI 2.0 controllers in accordance with CAPI 2.0.
Command: cat /proc/capi/controllers/<n/
Definition: 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 "capiinfo" help program is contained in the form of a UNIX manual page and can be opened on a console with the following 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. "K ISDN Watch" is an ISDN-Monitor that offers powerful monitoring functions of the activities of the installed AVM ISDN-Controller and can be translated for KDE 2.x and 3.x. "K ISDN Watch" is subject to the GPL and based on "kimon". The application can be downloaded from the following ftp directory: ftp://ftp.avm.de/tools/k_isdn_watch.linux
AVM provides with the CAPI 2.0 application "K ADSL Watch" a tool especially for the AVM DSL/ISDN-Controller FRITZ!Card DSL. "K ADSL Watch" is an ADSL-Monitor that offers powerful monitoring functions of the activities of the installed AVM DSL/ISDN-Controller and can be translated for KDE 2.x and 3.x. "K ADSL Watch" is subject to the GPL and based on "kimon". The application can be downloaded from the following ftp directory: ftp://ftp.avm.de/tools/k_adsl_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: www.capi.org.
Additional questions about the CAPI 2.0 Specification should be
asked in Usenet and addressed tonews:comp.dcom.isdn.capi.
(2) Useful discussions of ISDN and Linux issues can be found at news:comp.dcom.isdn.
(3) FAQs
AVM provides its own page of frequently asked questions (FAQs), including
questions about CAPI4Linux at
www.avm.de/de/Service/FAQs/Linux/index.html
(unfortunately, this site is only available in German).
(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. Here
you can discuss all questions concerning the development of CAPI4Linux
applications. 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 sign out from 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 programming CAPI 2.0 applications in Linux are also
presented here.
You find the server at the following ftp address:
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-2002-11-29.tar.gz):
(5) Faxing with capircvd
Information about an already existing CAPI 2.0-based program for
receiving faxes (G3) and voice calls is provided at the URL:
http://capircvd.berlios.de/index_eng.php3.
(6) CAPI4Linux and Slackware (versions 7.0 and higher)
Information about integration in Slackware plus capik-utils, VBOX, etc.
are available at the URL: www.scorrano.de
(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 or DSL 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.
All programs and drivers available from the Internet site can also be
obtained from the AVM Data Call Center (ADC).
Please try all of the information sources described above before
contacting AVM 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
www.avm.de/en/service/support
Fill out the form and mail it to AVM Support by clicking the "Send" button.
EOF
=======================================================================================================
AZ; SAS; SK, FS; 01/2003