# Welcome to CAPI4Linux for passive AVM ISDN-Controllers and the AVM DSL/ISDN-Controller!

## Contents

A What Is the CAPI4Linux Project and What Is It for?

B What Are the Basic Differences Between CAPI4Linux and Its Predecessor, ISDN4Linux?

C Which AVM DSL/ISDN-Controllers Are Currently Supported by CAPI4Linux?

D What Are the Prerequisites for Installing the CAPI4Linux Package?

E Installing CAPI4Linux in SuSE Linux Distributions

> 1 Installing Passive AVM ISDN-Controllers in SuSE Linux 8.1 or Higher

> 1.1 Installation Requirements
> 1.2 Update with the CAPI4Linux Package for the Passive AVM ISDN-Controller FRITZ!Card PCI/PCI v2.x
> 1.3 Update with the CAPI4Linux Package for the Passive AVM ISDN-Controller FRITZ!Card Classic/A1
> 1.4 Update with the CAPI4Linux Package for the Passive AVM ISDN-Controller FRITZ!Card PnP
> 1.5 Update with the CAPI4Linux Package for the Passive AVM ISDN-Controller FRITZ!Card PCMCIA/A1 PCMCIA
> 1.6 Update with the CAPI4Linux Package for the Passive AVM ISDN-Controller FRITZ!Card USB/FRITZ!Card USB 2.x/FRITZ!X USB/FRITZ!X USB v2.0/FRITZ!X USB v3.0
> 1.7 Update with the CAPI4Linux Package for the Passive AVM ISDN-Controller FRITZ!Card DSL
> 1.8 Update with the CAPI4Linux Package for the Passive AVM ISDN-Controller FRITZ!Card DSL USB (SuSE Linux 8.2 or higher)
> 1.9 Installing the Passive AVM DSL/ISDN-Controller FRITZ!Card DSL USB with the CAPI4Linux Package in SuSE Linux 8.1
> 1.10 Installing the Passive AVM DSL-Controller FRITZ!Card DSL SL with the CAPI4Linux Package in SuSE Linux 8.2
> 1.11 Installing the Passive AVM DSL-Controller FRITZ!Card DSL v2.0 with the CAPI4Linux Package in SuSE Linux 8.2

> 2 Installing Passive AVM DSL/ISDN-Controllers in up to SuSE Linux 8.0

> 2.1 Installing the Passive AVM ISDN-Controller FRITZ!Card PCI/PCI v2.x
> 2.2 Installing the Passive AVM ISDN-Controller FRITZ!Card Classic/A1
> 2.3 Installing the Passive AVM ISDN-Controller FRITZ!Card PnP
> 2.4 Installing the Passive AVM ISDN-Controller FRITZ!Card PCMCIA/A1 PCMCIA
> 2.5 Installing the Passive AVM ISDN-Controller FRITZ!Card USB/FRITZ!Card USB 2.x/FRITZ!X USB/FRITZ!X USB v2.0/FRITZ!X USB v3.0
> 2.6 Installing the Passive AVM DSL/ISDN-Controller FRITZ!Card DSL

F Information about USB Support in Linux

G Installation Instructions for Integrating the AVM ISDN-Controllers in Other Linux Distributions

H Removing the Controller / Driver Update

> 1 Removing the Controller / Driver Update in SuSE 8.1 or Higher
> 2 Removing the Controller/Driver Update in SuSE 8.0 or Below
> 3 Removing the AVM DSL-Controller FRITZ!Card DSL SL in SuSE 8.2

I Information About the CAPI 2.0 Plug-in Module for the "Generic PPP" Stack (pppd)

J Help Programs

> 1 ISDN Monitor "K ISDN Watch" for KDE
> 2 ADSL Monitor "K ADSL Watch" for KDE

K Additional Information Sources

L Support

## A What Is the CAPI4Linux Project and What Is It for?

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:

- the AVM Software Development Kit (SDK) as tool and resource for software developers for the generation of CAPI 2.0-compatible applications,
- an adaptation (CAPI plug-in) of the "Generic PPP" stack (pppd) to allow the use of Internet applications like web browsers, ftp clients based on the Internet protocol IP and
- a CAPI 2.0 interface for the popular Fax G3 application "HylaFAX".

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.

Back to top

## B What Are the Basic Differences Between CAPI4Linux and Its Predecessor, ISDN4Linux?

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.

Back to top

## C Which AVM DSL/ISDN-Controllers Are Currently Supported by CAPI4Linux?

CAPI4Linux currently supports the following AVM DSL/ISDN-Controllers:

- AVM ISDN Controller FRITZ!Card Classic (compatible with the AVM ISDN-Controller A1)
- AVM ISDN-Controller FRITZ!Card PnP
- AVM ISDN-Controller FRITZ!Card PCI/FRITZ!Card PCI v2.x
- AVM ISDN Controller FRITZ!Card PCMCIA (compatible with the AVM ISDN-Controller A1 PCMCIA)
- AVM ISDN-Controller FRITZ!Card USB / FRITZ!Card USB v2.x
- AVM DSL/ISDN-Controller FRITZ!Card DSL/ v2.0
- AVM DSL/ISDN-Controller FRITZ!Card DSL USB
- AVM DSL-Controller FRITZ!Card DSL SL
- AVM ISDN-Controller B1 v1.4/v2.0/v3.0 (ISA)
- AVM ISDN-Controller B1 PCI / B1 PCI v4.0
- AVM ISDN-Controller B1 PCMCIA
- AVM ISDN-Controller C2
- AVM ISDN-Controller C4
- AVM ISDN-Controller T1
- AVM ISDN-Controller T1-B
- AVM FRITZ!X USB/ v2.0/ v3.0 (compatible with FRITZ!X ISDN)

For the following controllers with a V.24 interface, no drivers in accordance with the CAPI4Linux-Model will be available:

- AVM FRITZ!X PC
- AVM FRITZ!X PC v2.0
- AVM FRITZ!X PC v3.0

For information about new releases, see the AVM home page and the file "hist-eng.txt" in the root directory of ftp.avm.de.

Back to top

## D What Are the Prerequisites for Installing the CAPI4Linux Package?

On computers with the INTEL i386 platform one passive AVM ISDN-Controller or the FRITZ!Card DSL installed is supported. 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:

- 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 and 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)
- SuSE Linux 8.1 (Kernel 2.4.19-4GB)
- SuSE Linux 8.2 (Kernel 2.4.20-4GB)

* "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 K.

Back to top

## E Installing CAPI4Linux in SuSE Linux Distributions

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).

When using SuSE Linux distributions from version 8.1 onwards, an installation of the AVM DSL/ISDN-Controller requires a previous installation of the controller using YaST2 (exception: FRITZ!Card DSL USB in SuSE Linux 8.1 and FRITZ!Card DSL SL in SuSE Linux 8.2). 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.

Back to top

## 1 Installing Passive AVM ISDN-Controllers in SuSE Linux 8.1 or Higher

The following sections describe the installation of passive AVM ISDN-Controllers in SuSE Linux 8.1 or higher. Before beginning with installation, note the following system requirements.

### 1.1 Installation Requirements

- SuSE Linux 8.1 (Kernel 2.4.19-4 GB), SuSE Linux 8.2 (Kernel 2.4.20-4GB) and higher distibutions
- i386
- a passive AVM DSL/ISDN-Controller: A1/A1 PCMCIA, FRITZ!Card Classic, FRITZ!Card PnP, FRITZ!Card PCI, FRITZ!Card PCI, v2.x, FRITZ!Card PCMCIA, FRITZ!Card USB, FRITZ!X USB/v2.0/v3.0, FRITZ!Card DSL, FRITZ!Card DSL SL or FRITZ!Card DSL USB
- You have to perform the installation as "root", i.e. you must have write rights in the root directory as "root" or "Superuser".
- For the FRITZ!Card DSL / FRITZ!Card DSL USB / FRITZ!Card DSL SL, 1 ADSL access in accordance with the ITU-T G.992.1 Annex B (DSL over ISDN) standard. A current overview of the providers supported at this time is presented at http://www.avm.de/DSL/aktiv (unfortunately, this FAQ site is only available in German).
  You can use your AVM DSL/ISDN-Controller FRITZ!Card DSL in the Deutsche Telekom AG network at an ADSL access together with an analog access, since this combination is configured according to ITU-T G.992.1 Annex B (DSL over ISDN) standard. FRITZ!Card DSL is a "full rate DSL controller", and supports a download speed of up to 8 Mbit/s. The speed actually available at your DSL access depends on the physical conditions and on your DSL provider (charge).
- pppd version ppp-2.3.11-24 or higher (included in the SuSE package from version 6.4). 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) at the conclusion of installation. This test simulates a connection to an ISP (Internet Service Provider).

NOTE | This section assists you in installing your AVM DSL/ISDN-Controller in SuSE Linux 8.1 or higher for the first time. The AVM driver is already integrated into the operating system for these SuSE versions. After installation, you can perform an update with the AVM CAPI4Linux package. If you have already installed your controller in SuSE using YaST2, continue reading with the section that describes the installation of your AVM DSL/ISDN-Controller. FRITZ!Card DSL USB users who use SuSE Linux 8.1 should continue according to the instructions in 1.9. FRITZ!Card DSL SL users who use SuSE Linux 8.2 should continue according to the instructions in 1.10. FRITZ!Card DSL v2.0 users who use SuSE Linux 8.2 should continue according to the instructions in 1.11.

If you have already performed a YaST installation in SuSE Linux 8.1 or higher, skip straight to the driver update (update with the CAPI4Linux package):
1.2 AVM ISDN-Controller FRITZ!Card PCI / FRITZ!Card PCI v2.x
1.3 AVM ISDN-Controller FRITZ!Card Classic / A1
1.4 AVM ISDN-Controller FRITZ!Card PnP
1.5 AVM ISDN-Controller FRITZ!Card PCMCIA / A1 PCMCIA
1.6 AVM ISDN-Controller FRITZ!Card USB / FRITZ!Card USB v2.x/ FRITZ!X USB / FRITZ!X USB v2.0 / FRITZ!X USB v3.0
1.7 AVM DSL/ISDN-Controller FRITZ!Card DSL
1.8 AVM DSL/ISDN-Controller FRITZ!Card DSL USB (SuSE Linux 8.2 or higher)

If you are using SuSE 8.0 or an older version, proceed as described in the installation section 2.

Back to top

### Installation with YaST

1. Insert the AVM DSL/ISDN-Controller in your system and connect it to the DSL/USB/ISDN socket (see the manual).
2. After login, SuSE's hardware recognition announces "New hardware has been found! Configure the ISDN-Controller?". Confirm by clicking "Yes". If necessary start YaST2 manually (YaST2 Control Center) and select "ISDN configuration" in the "Network/Basic" menu.

   NOTE | Enter the following command in a console to find out the exact designation of your controller: "hwinfo --isdn | grep Model" (only available to the "root" user, or Superuser).

3. System administration rights (root privileges) are necessary for hardware configuration. If you are not already logged in as "root", i.e. as "Superuser", then you must provide the "root" password in the following dialog.
4. In the following YaST dialog "ISDN cards configuration" select your controller and click "Configure".

   NOTE | FRITZ!Card PCI v2.0 is compatible with FRITZ!Card PCI v2.1.

5. In the "ISDN low-level configuration" window, insert both your "Areacode" and "Dialprefix".
6. If necessary, review the parameters "I/O Address" and "IRQ" (please also see the section How Can I Find Out Which Resources Are Already in Use).
7. Under "Driver", choose the option "AVM CAPI2.0" Binary only CAPI with FAX G3.
8. Confirm your entries by clicking "OK".
9. Ignore the following warning and confirm the question "You accept this?" with "Yes".
10. If required, you may be then prompted to install the following packages:
    - i4l-base
    - i4l-isdnlog
    - capi4linux
    - avm_fcdsl (FRITZ!Card DSL / FRITZ!Card DSL USB only)
11. The subsequent configuration of the ISDN connection for KInternet is optional.
    Choose "Skip" and "Finish" to conclude the installation now if you wish to dial into the Internet using a dial-in script via the console. After the controller installation, relevant sample scripts can be found in the folders:
    "etc/ppp/peers/" (for dsl)
    "etc/ppp/peers/isdn" (for ISDN).

Additional information regarding pppd and the script's usage can be found in the following section and in section I Information about the CAPI 2.0 Plug-in Module for the "Generic PPP" Stack (pppd).
If you want to configure a connection using KInternet, 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/suselinux-userguide_de/
/usr/share/doc/packages/suselinux-adminguide_de/

Back to top

### 1.2 Update with the CAPI4Linux Package for the Passive AVM ISDN-Controller FRITZ!Card PCI/FRITZ!Card PCI v2.x

Operating system: | SuSE Linux 8.1 (Kernel 2.4.19-4 GB), SuSE Linux 8.2 (Kernel 2.4.20-4GB) and other distributions
Version: | 03.11.02
Build: | 03.07.08

1. Make sure that your FRITZ!Card PCI is connected with the ISDN socket (see the manual) and that the ISDN-Controller was already installed using YaST.
2. Copy the archive "fcpci-susexx-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).

   NOTE | Enter the following command in a console to find out the exact designation of your AVM ISDN-Controller: "hwinfo --isdn | grep Model" (only available to the "root" user, or Superuser).

   Extract the archive with the command

   tar -xzvf fcpci-susexx-yy.yy.yy.tar.gz

   Example for FRITZ!Card PCI in SuSE 8.2:

   tar -xzvf fcpci-suse8.2-03.11.02.tar.gz

   A directory called "fritz" is created.

3. Switch to the new directory "fritz".
4. Run "./install" (Superuser rights are required).
5. A successful installation of your AVM ISDN-Controller concludes with the message "The driver files have been updated. Reboot or restart the ISDN package in order to activate the changes... Ready.".
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:
   -fcpci
   -capi
   -capifs
   -kernelcapi
   -capiutil

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 RFC 1618 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
3. 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
4. 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 I.

Back to top

### 1.3 Update with the CAPI4Linux Package for the Passive AVM ISDN-Controller FRITZ!Card Classic/A1

Operating system: | SuSE Linux 8.1 (Kernel 2.4.19-4 GB), SuSE Linux 8.2 (Kernel 2.4.20-4GB) and other distributions
Version: | 03.11.02
Build: | 03.09.11

1. Make sure that your FRITZ!Card Classic/A1 is connected with the ISDN socket (see the manual) and that the ISDN-Controller was already installed using YaST (see also the section Installation with YaST).
2. Copy the archive "fcclassic-susexx-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).

   NOTE | Enter the following command in a console to find out the exact designation of your AVM ISDN-Controller: "hwinfo --isdn | grep Model" (only available to the "root" user, or Superuser).

   Extract the archive with the command

   tar -xzvf fcclassic-susexx-yy.yy.yy.tar.gz

   Example for FRITZ!Card Classic in SuSE 8.2:

   tar -xzvf fcclassic-suse8.2-03.11.02.tar.gz

   A directory called "fritz" is created.

3. Switch to the new directory "fritz".
4. Run "./install" (Superuser rights are required).
5. A successful installation of your AVM ISDN-Controller concludes with the message "The driver files have been updated. Reboot or restart the ISDN package in order to activate the changes... Ready.".
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:
   -fcclassic
   -capi
   -capifs
   -kernelcapi
   -capiutil

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 RFC 1618 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
3. 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
4. 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 I.

Back to top

### 1.4 Update with the CAPI4Linux Package for the Passive AVM ISDN-Controller FRITZ!Card PnP

Operating system: | SuSE Linux 8.1 (Kernel 2.4.19-4 GB), SuSE Linux 8.2 (Kernel 2.4.20-4GB) and other distributions
Version: | 03.11.02
Build: | 03.09.11

1. Make sure that your FRITZ!Card PnP is connected with the ISDN socket (see the manual) and that the ISDN-Controller was already installed using YaST (see also the section Installation with YaST).
2. Copy the archive "fcpnp-susexx-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).

   NOTE | Enter the following command in a console to find out the exact designation of your AVM ISDN-Controller: "hwinfo --isdn | grep Model" (only available to the "root" user, or Superuser).

   Extract the archive with the command

   tar -xzvf fcpnp-susexx-yy.yy.yy.tar.gz

   Example for FRITZ!Card PnP in SuSE 8.2:

   tar -xzvf fcpnp-suse8.2-03.11.02.tar.gz

   A directory called "fritz" is created.

3. Switch to the new directory "fritz".
4. Run "./install" (Superuser rights are required).
5. A successful installation of your AVM ISDN-Controller concludes with the message "The driver files have been updated. Reboot or restart the ISDN package in order to activate the changes... Ready.".
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:
   -fcpnp
   -capi
   -capifs
   -kernelcapi
   -capiutil

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 RFC 1618 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
3. 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
4. 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 I.

Back to top

### 1.5 Update with the CAPI4Linux Package for the Passive AVM ISDN-Controller FRITZ!Card PCMCIA/A1 PCMCIA

Operating system: | SuSE Linux 8.1 (Kernel 2.4.19-4 GB), SuSE Linux 8.2 (Kernel 2.4.20-4GB) and other distributions
Version: | 03.11.02
Build: | 03.09.11

1. Make sure that your FRITZ!Card PCMCIA/A1 PCMCIA is connected with the ISDN socket (see the manual) and that the ISDN-Controller was already installed using YaST (see also the section Installation with YaST).
2. Copy the archive "fcpmcia-susexx-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).

   NOTE | Enter the following command in a console to find out the exact designation of your AVM ISDN-Controller: "hwinfo --isdn | grep Model" (only available to the "root" user, or Superuser).

   Extract the archive with the command

   tar -xzvf fcpcmcia-susexx-yy.yy.yy.tar.gz

   Example for FRITZ!Card PCMCIA in SuSE 8.2:

   tar -xzvf fcpcmcia-suse8.2-03.11.02.tar.gz

   A directory called "fritz" is created.

3. Switch to the new directory "fritz".
4. Run "./install" (Superuser rights are required).
5. A successful installation of your AVM ISDN-Controller concludes with the message "The driver files have been updated. Reboot or restart the ISDN package in order to activate the changes... Ready.".
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:
   -fcpcmcia
   -fcpcmcia_cs
   -capi
   -capifs
   -kernelcapi
   -capiutil

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 RFC 1618 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
3. 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
4. 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 I.

Back to top

### 1.6 Update with the CAPI4Linux Package for the Passive AVM ISDN-Controller FRITZ!Card USB / FRITZ!Card USB 2.x / FRITZ!X USB / FRITZ!X USB v2.0 / FRITZ!X USB v3.0

Operating system: | SuSE Linux 8.1 (Kernel 2.4.19-4 GB), SuSE Linux 8.2 (Kernel 2.4.20-4GB) and other distributions
Version: | 03.11.02
Build: | 03.08.06

1. Make sure that your FRITZ!Card USB / FRITZ!X USB is connected with the USB/ISDN socket (see the manual) and that the ISDN-Controller was already installed using YaST (see also the section Installation with YaST).
2. Copy the archive "fcusb-susexx-yy.yy.yy.tar.gz"/"fcusb2-susexx-yy.yy.yy.tar.gz"/ "fxusb-susexx-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).

   NOTE | Enter the following command in a console to find out the exact designation of your AVM ISDN-Controller: "hwinfo --isdn | grep Model" (only available to the "root" user, or Superuser).

   Extract the archive with the command

   tar -xzvf fcusb-susexx-yy.yy.yy.tar.gz (FRITZ!Card USB)

   tar -xzvf fcusb2-susexx-yy.yy.yy.tar.gz (FRITZ!Card USB 2.x)

   tar -xzvf fxusb-susexx-yy.yy.yy.tar.gz (FRITZ!X USB)

   Example for FRITZ!Card USB in SuSE 8.2:

   tar -xzvf fcusb-suse8.2-03.11.02.tar.gz

   A directory called "fritz" is created.

3. Switch to the new directory "fritz".
4. Run "./install" (Superuser rights are required).
5. A successful installation of your AVM ISDN-Controller concludes with the message "The driver files have been updated. Reboot or restart the ISDN package in order to activate the changes... Ready.".
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:
   -fcusb / fcusb2 / fxusb (depending on which AVM ISDN-Controller is installed)
   -capi
   -capifs
   -kernelcapi
   -capiutil

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 RFC 1618 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
3. 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
4. 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 I.

Back to top

### 1.7 Update with the CAPI4Linux Package for the Passive AVM ISDN-Controller FRITZ!Card DSL

Operating system: | SuSE Linux 8.1 (Kernel 2.4.19-4 GB), SuSE Linux 8.2 (Kernel 2.4.20-4GB) and other distributions
Version: | 03.11.02
Build: | 03.07.08

1. Make sure that your FRITZ!Card DSL is connected with the DSL/ISDN socket (see the manual) and that the DSL/ISDN-Controller was already installed using YaST (see also the section Installation with YaST).
2. Copy the archive "fcdsl-susexx-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).

   NOTE | Enter the following command in a console to find out the exact designation of your AVM ISDN-Controller: "hwinfo --isdn | grep Model" (only available to the "root" user, or Superuser).

   Extract the archive with the command

   tar -xzvf fcdsl-susexx-yy.yy.yy.tar.gz

   Example for FRITZ!Card DSL in SuSE 8.2:

   tar -xzvf fcdsl-suse8.2-03.11.02.tar.gz

   A directory called "fritz" is created.

3. Switch to the new directory "fritz".
4. Run "./install" (Superuser rights are required).
5. A successful installation of your AVM DSL/ISDN-Controller concludes with the message "The driver files have been updated. Reboot or restart the ISDN package in order to activate the changes... Ready.".
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:
   -fcdsl
   -capi
   -capifs
   -kernelcapi
   -capiutil

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 RFC 1618 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
3. 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 DSL/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
4. Enter the keyboard shortcut "Strg+C" to clear down the connection.

   DSL dial-up: To establish a DSL connection, besides KInternet, 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".

Additional options of the CAPI 2.0 plug-in module for the "Generic PPP" stack (pppd) are described in section I.

Back to top

### 1.8 Update with the CAPI4Linux Package for the Passive AVM DSL/ISDN-Controller FRITZ!Card DSL USB (SuSE Linux 8.2 or higher)

Operating system: | SuSE Linux 8.2 (Kernel 2.4.20-4GB) and other distributions
Version: | 03.11.02
Build: | 03.07.08

1. Make sure that your FRITZ!Card DSL USB is connected with the USB/DSL/ISDN socket (see the manual) and that the DSL/ISDN-Controller was already installed using YaST (see also the section Installation with YaST).
2. Copy the archive "fcdslusb-susexx-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).

   NOTE | Enter the following command in a console to find out the exact designation of your AVM ISDN-Controller: "hwinfo --isdn | grep Model" (only available to the "root" user, or Superuser).

   Extract the archive with the command

   tar -xzvf fcdslusb-susexx-yy.yy.yy.tar.gz

   Example for FRITZ!Card DSL USB in SuSE 8.2:

   tar -xzvf fcdslusb-suse8.2-03.11.02.tar.gz

   A directory called "fritz" is created.

3. Switch to the new directory "fritz".
4. Run "./install" (Superuser rights are required).
5. A successful installation of your AVM DSL/ISDN-Controller concludes with the message "The driver files have been updated. Reboot or restart the ISDN package in order to activate the changes... Ready.".
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:
   -fcdslusb
   -capi
   -capifs
   -kernelcapi
   -capiutil

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
3. 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
4. Enter the keyboard shortcut "Strg+C" to clear down the connection.

   DSL dial-up: To establish a DSL connection, besides KInternet, 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".

Additional options of the CAPI 2.0 plug-in module for the "Generic PPP" stack (pppd) are described in section I.

Back to top

### 1.9 Installing the Passive AVM DSL/ISDN-Controller FRITZ!Card DSL USB with the CAPI4Linux Package in SuSE Linux 8.1

Operating system: | SuSE Linux 8.1 (Kernel 2.4.19-4GB) and other distributions
Version: | 03.10.05
Build: | 03.03.05

NOTE | The driver for the AVM DSL/ISDN-Controller FRITZ!Card DSL USB is not included in SuSE Linux 8.1. Therefore the latest CAPI4Linux package available on the AVM server is required for installation of the AVM FRITZ!Card DSL USB in SuSE Linux 8.1. Proceed as described in the following section. Users of SuSE 8.2 or higher should proceed from section 1.8.

Install the AVM DSL/ISDN-Controller FRITZ!Card DSL USB just as you would install an AVM FRITZ!Card DSL in SuSE 8.0 (see Installing the AVM ISDN-Controller FRITZ!Card DSL up to SuSE 8.0). After installation with the CAPI4Linux package, remove the DSL/ISDN-Controller from the USB socket and plug it in again to load the firmware of the DSL/ISDN-Controller.

After installation with the CAPI4Linux package the DSL/ISDN-Controller is also registered in YaST. This means that the can also be removed via YaST. An additional entry (Outside Dialing Prefix/Area Code) is required in the "/etc/sysconfig/isdn/cfg-conDSL-ControllertrX" file to allow DSL and ISDN connections to be configured using YaST. To do so, proceed as follows:

1. To find out which files require changes, enter the following command on the console:
   grep -H fcdslusb /etc/sysconfig/isdn/cfg-contr*
   The response will look something like this: /etc/sysconfig/isdn/cfg-contr0:DRIVER="fcdsl.usb".
2. Open the file returned in step one, here "cfg-contr0", in an editor such as "vi".
3. After the last entry in this file, enter the "AREACODE" and any required "DIALPREFIX" required for outside calls:
   DRIVER="fcdslusb"
   NAME="AVM FRITZ!Card DSL USB"
   PARA_SUBTYPE="2"
   PARA_TYPE="8004"
   PROTOCOL="euro"
   STARTMODE="hotplug"
   AREACODE="030"
   DIALPREFIX="0"
4. Next, select "ISDN Configuration" in the YaST2 "Network Basics" control center. Select "Change" under "Already Configured Devices". Then select "Add" under the "Provider" menu command. For DSL, click the "Add DSL CAPI interface" command or for ISDN, or "Add new SyncPPP network interface". Follow the instructions on the screen.

ATTENTION: | Do NOT use the "Edit" command for the ISDN-Controller already configured, but ONLY for the "Provider" or "Interface"! Otherwise you will have to "Delete" the controller again over YaST and then re-install it with the CAPI4Linux package.

Back to top

### 1.10 Installing the Passive AVM DSL-Controller FRITZ!Card DSL SL with the CAPI4Linux Package in SuSE Linux 8.2

Operating system: | SuSE Linux 8.2 (Kernel 2.4.20-4GB) and other distributions
Version: | 03.11.02
Build: | 03.08.21

NOTE | The driver for the AVM DSL-Controller FRITZ!Card DSL SL is not included in SuSE Linux 8.2. Therefore the current CAPI4Linux package from the AVM server is required for installation of the AVM FRITZ!Card DSL SL in SuSE Linux 8.2. A YaST configuration of FRITZ!Card DSL SL or dial in via KInternet is not possible in SuSE Linux 8.2.

ATTENTION | If you want to use FRITZ!Card DSL SL together with an active or passive ISDN-Controller (AVM ISDN-Controller B1, for example), please install the ISDN-Controller first (!) and then FRITZ!Card DSL SL.

1. Connect FRITZ!Card DSL SL with the ADSL line (see the manual) and, if necessary, close the Hardware Wizard, which reports that the new hardware has been found.
2. Copy the archive " "fcdslsl-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 for the SuSE version used with the command

   tar -xzvf fcdslsl-susex.x-yy.yy.yy.tar.gz

   Example for FRITZ!Card DSL SL under SuSE 8.2:

   tar -xzvf fcdslsl-suse8.2-03.11.02.tar.gz

   A directory called "fritz" is created.

3. Switch to the new directory "fritz".
4. Run "./install" (Superuser rights are required).
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 1TR112 [U-R2]:
   Ready.
   The driver files have been copied. Starting the driver...
   Starting FRITZ!Card DSL SL loader (ctrl 1) done
   DSL Assistant version 1.0.3 copyright AVM 2002
   The DSL Assistant is examining your DSL configuration...
   The DSL-Controller has the number 1.
   Searching for remote vendor ID... (This could take over a minute)
   Found remote vendor: U-R2 (Texas Instruments)
   Testing different config values, please wait...
   Found working values from another vendor!
   Found following values for DSL:
   controller 1
   protocol adslpppoe
   vpi 1
   vci 32
   vcc 1
   Now the driver is loaded an the DSL-Controller is ready for DSL operation. If the line parameter " / ATM parameter" could not (!) be detected automatically, please check the following:
   - cabling (are the cables connected with the DSL splitter?)
   - the access (Is the access compatible with 1TR112 [U-R2]?)

   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 when the computer is restarted. 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:

- fcdslsl
- capi
- capifs
- kernelcapi
- capiutil

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 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 tdsl usepeerdns

To clear down the connection, enter the keyboard shortcut "Strg+C".

Additional options of the CAPI 2.0 plug-in module for the "Generic PPP" stack (pppd) are described in section I.

Back to top

### 1.11 Installing the Passive AVM DSL/ISDN-Controller FRITZ!Card DSL v2.0 with the CAPI4Linux Package in SuSE Linux 8.2

Operating system: | SuSE Linux 8.2 (Kernel 2.4.20-4GB) and other distributions
Version: | 03.11.03
Build: | 03.09.26

NOTE | The driver for the AVM DSL-Controller FRITZ!Card DSL v2.0 is not included in SuSE Linux 8.2. Therefore the current CAPI4Linux package from the driver CD-ROM or the AVM server is required for installation of the AVM FRITZ!Card DSL v2.0 in SuSE Linux 8.2.

ATTENTION | If you want to use FRITZ!Card DSL v2.0 together with an active ISDN-Controller (AVM ISDN-Controller B1, for example), please install the ISDN-Controller first (!) and then FRITZ!Card DSL v2.0. The ISDN features of FRITZ!Card DSL v2.0 are then deactivated.

1. Connect FRITZ!Card DSL v2.0 with the ISDN/ADSL line (see the manual) and, if necessary, close the Hardware Wizard, which reports that the new hardware has been found.
2. Copy the archive " "fcdsl2-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 for the SuSE version used with the command

   tar -xzvf fcdsl2-susex.x-yy.yy.yy.tar.gz

   Example for FRITZ!Card DSL v2.0 under SuSE 8.2:

   tar -xzvf fcdsl2-suse8.2-03.11.03.tar.gz

   A directory called "fritz" is created.

3. Switch to the new directory "fritz".
4. Run "./prepare" (Superuser rights are required).
5. You will see the following console output:
   Driver version: 3.11-03
   The driver files have been copied.
   Please run YaST to setup your controller.
6. Start YaST2 Control Center to install and configure FRITZ!Card DSL v2.0 with YaST, therefor continue with Step 2 of the YaST Installation section.
7. 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 for DSL and ISDN is present in the system. The following loaded modules should be included in the output:

- fcdsl2
- capi
- capifs
- kernelcapi
- capiutil

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
3. 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
4. Enter the keyboard shortcut "Strg+C" to clear down the connection.

   DSL dial-up: To establish a DSL connection, besides KInternet, 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".

Additional options of the CAPI 2.0 plug-in module for the "Generic PPP" stack (pppd) are described in section I.

Back to top

## 2 Installing Passive AVM ISDN-Controllers or the AVM DSL/ISDN-Controller up to SuSE 8.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.

2.1 AVM ISDN-Controller FRITZ!Card PCI / FRITZ!Card PCI v2.x
2.2 AVM ISDN-Controller FRITZ!Card Classic / A1
2.3 AVM ISDN-Controller FRITZ!Card PnP
2.4 AVM ISDN-Controller FRITZ!Card PCMCIA / A1 PCMCIA
2.5 AVM ISDN-Controller FRITZ!Card USB, FRITZ!Card USB v2.x, FRITZ!X USB, FRITZ!X USB v2.0
2.6 AVM DSL/ISDN-Controller FRITZ!Card DSL

Back to top

### 2.1 Installing the AVM ISDN-Controller FRITZ!Card PCI / FRITZ!Card PCI v2.x up to SuSE Linux 8.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:

- SuSE Linux 8.0/7.3/7.2/7.1/7.0/6.4/6.3
- i386 / single CPU platform (no SMP)
- 1 AVM ISDN-Controller FRITZ!Card PCI, FRITZ!Card PCI v2.0 or FRITZ!Card PCI v2.1
- You have to perform the installation as "root", i.e. you must have write rights in the root directory as "root" or "Superuser".
- pppd version ppp-2.3.11-24 or higher (included in the SuSE package from version 6.4). 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) 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. 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 D.

(1) Copy the archive "fcpci-susexx-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-susexx-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:

- fcpci
- capi
- capifs
- kernelcapi
- capiutil

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 RFC 1618 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 I.

Back to top

### 2.2 Installing the AVM ISDN-Controller FRITZ!Card Classic / A1 up to SuSE 8.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:

- SuSE Linux 8.0/7.3/7.2/7.1/7.0/6.4/6.3
- i386 / single CPU platform (no SMP)
- 1 AVM ISDN-Controller FRITZ!Card Classic (or AVM A1)
- You have to perform the installation as "root", i.e. you must have write rights in the root directory as "root" or "Superuser".
- pppd version ppp-2.3.11-24 or higher (included in the SuSE package from version 6.4). 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) 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. 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 D.

(1) Copy the archive "fcclassic-susexx-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-susexx-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.

Back to top

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:

- fcclassic
- capi
- capifs
- kernelcapi
- capiutil

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 I.

Back to top

### 2.3 Installing the AVM ISDN-Controller FRITZ!Card PnP up to SuSE 8.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:

- SuSE Linux 8.0/7.3/7.2/7.1/7.0/6.4/6.3
- i386 / single CPU platform (no SMP)
- 1 AVM ISDN-Controller FRITZ!Card PnP
- You have to perform the installation as "root", i.e. you must have write rights in the root directory as "root" or "Superuser".
- pppd version ppp-2.3.11-24 or higher (included in the SuSE package from version 6.4). 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) 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. 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 D.

(1) Copy the archive "fcpnp-susexx-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-susexx-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 2.1.

Back to top

### 2.4 Installing the AVM ISDN-Controller FRITZ!Card PCMCIA / A1 PCMCIA up to SuSE 8.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:

- SuSE Linux 8.0/7.3/7.2/7.1/7.0/6.4/6.3
- i386 / single CPU platform (no SMP)
- 1 AVM ISDN-Controller FRITZ!Card PCMCIA (or AVM A1 PCMCIA)
- You have to perform the installation as "root", i.e. you must have write rights in the root directory as "root" or "Superuser".
- Install the "pcmcia" and the "pcmcia-cardinfo" package for general PCMCIA ability, if the PCMCIA chip of your controller is not recognized automatically during the installation by, for example, YaST.
- pppd version ppp-2.3.11-24 or higher (included in the SuSE package from version 6.4). 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) 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. 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 D.

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-susexx-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-susexx-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 2.1.

Back to top

### 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

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:

- SuSE Linux 8.0/7.3/7.2/7.1 (with Kernel 2.4.0-4GB)
- i386 / single CPU platform (no SMP)
- 1 AVM ISDN-Controller FRITZ!Card USB, FRITZ!Card USB v2.x, FRITZ!X USB, FRITZ!X USB v2.0
- You have to perform the installation as "root", i.e. you must have write rights in the root directory as "root" or "Superuser".
- pppd version ppp-2.3.11-24 or higher (included in the SuSE package from version 6.4). 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) 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, the additional installation step (4) is required. Please see the additional information in section D.

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-susexx-yy.yy.yy.tar.gz"
FRITZ!Card USB v2.x: | "fcusb2-susexx-yy.yy.yy.tar.gz"
FRITZ!X USB / FRITZ!X USB v2.0: | "fxusb-susexx-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-susexx-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:

- fcusb / fcusb2 / fxusb (depending on the ISDN-Controller installed)
- capi
- capifs
- kernelcapi
- capiutil

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 RFC 1618 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 I.

Back to top

### 2.6 Installing the AVM ISDN-Controller FRITZ!Card DSL up to SuSE Linux 8.0

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:

- SuSE Linux 8.0/7.3
- i386 / single CPU platform (no SMP), PII 300 or compatible, 64 MB RAM
- 1 AVM ADSL/ISDN-Controller FRITZ!Card DSL
- You have to perform the installation as "root", i.e. you must have write rights in the root directory as "root" or "Superuser".
- 1 ADSL access in accordance with the ITU-T G.992.1 Annex B (DSL over ISDN) standard. In Germany, the following ADSL provider are supported: Deutsche Telekom AG supplies as "T-DSL" (T-Online, 1&1 and others), Business Online; Citykom Münster (Tropolys) supplies as "citykom.münster DSL"; Swisscom AG (ADSL service in Swisscom Fixnet Wholesale); Belgacom (ADSL service). A current overview is presented at http://www.avm.de/DSL/aktiv (unfortunately, this site is only available in German).
  NOTE: You can use your AVM DSL/ISDN-Controller FRITZ!Card DSL in the Deutsche Telekom AG network at an ADSL access together with an analog access, since this combination is configured according to ITU-T G.992.1 Annex B (DSL over ISDN) standard. FRITZ!Card DSL is a "full rate DSL controller", and supports a download speed of up to 8 Mbit/s. The speed actually available at your DSL access depends on the physical conditions and on your DSL provider (charge).
- pppd version ppp-2.3.11-24 or higher (included in the SuSE package from version 6.4). 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 D.

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-susexx-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-susexx-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:

- the cabling (Did you mistake the ISDN for the DSL cable? Did you connect your FRITZ!Card DSL with the DSL splitter and the ISDN Network Terminator (NT)?)
- the access (Is the access compatible with U-R2?)

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:

- fcdsl
- capi
- capifs
- kernelcapi
- capiutil

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 I.

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".

Back to top

## F Information about USB Support in Linux

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-Controller 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. From SuSE 8.0 on, your operating system automatically selects 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 DSL/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").

Back to top

## G Installation Instructions for Integrating the AVM ISDN-Controllers in Other Linux Distributions

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 K for useful links.

## H. Removing the Controller / Driver Update

The procedure required to remove or update the CAPI 2.0 driver software is identical for all internal DSL/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 SuSE 8.1 AVM Controllers are installed with YaST2 and you have to remove the controller with YaST2. In all other SuSE Linux versions, please proceed as described in section 2 Removing the Controller / Driver Update up to SuSE 8.0 to remove your AVM DSL/ISDN-Controller manually. Because the AVM DSL-Controller FRITZ!Card DSL SL was installed in SuSE 8.2 without YaST, it can be removed as described in section 3 Removing the AVM DSL-Controller FRITZ!Card DSL SL in SuSE 8.2.

Back to top

### 1 Removing the Controller / Driver Update in SuSE 8.1 or Higher

In SuSE 8.1 or higher, you have to remove your AVM DSL/ISDN-Controller using the YaST2 Control Center.
Proceed as follows:

1. Open the YaST2 Control Center.
2. System administration rights (root privileges) are necessary for hardware configuration. If you are not already logged in as "root", i.e. as "Superuser", then you must provide the "root" password in the following dialog.
3. In the YaST2 Control Center, select "ISDN configuration" under "Network/Basic".
4. Under "ISDN cards configuration", select "Already configured devices" and click "Change".
5. In the "ISDN configuration overview" dialog, select the AVM DSL/ISDN-Controller. Click "Delete" and confirm by clicking "Finish".

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.

Back to top

### 2 Removing the Controller / Driver Update in SuSE 8.0 or Below

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.

Back to top

### 3 Removing the AVM DSL-Controller FRITZ!Card DSL SL in SuSE 8.2

Proceed as follows to uninstall the driver and to remove the driver service from the start process so that it will not be started when the computer is booted:

1. Open the console as "root" or "superuser".
2. Enter "/etc/init.d/load-fcdslsl stop".
3. Next, enter "insserv -r load-fcdslsl".

This completes the removal of your DSL-Controller.

Back to top

## I Information About the CAPI 2.0 Plug-in Module for the "Generic PPP" Stack (pppd)

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!

Back to top

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
...

Back to top

## J Help Programs

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 CAPI 2.0 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

Back to top

### 1 ISDN Monitor "K ISDN Watch" for KDE

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.

### 2 ADSL Monitor "K ADSL Watch" for KDE

AVM provides with the CAPI 2.0 application "K ADSL Watch" a tool especially for AVM DSL-Controllers. "K ADSL Watch" is an ADSL-Monitor that offers powerful monitoring functions of the activities of the installed AVM DSL-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.

Back to top

## K Additional Information Sources

(01) 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 to: news:comp.dcom.isdn.capi.

(02) Useful discussions of ISDN and Linux issues can be found at news:comp.os.linux.isdn.

(03) 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).

(04) 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-xxxx-yy-zz.tar.gz):

- capiintest (test incoming connections)
- capioutest (test outgoing connections)
- capipppd (establish connection and start pppd)
- capimwout (establish connection and start any program)

(05) 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/download.

(06) CAPISuite, a CAPI-based solution for fax and answering machine is located at: www.capisuite.de.

(07) CAPI4Linux and Slackware (7.0 and higher) information about integration in Slackware plus capi4k-utils, VBOX etc. is available at: www.scorrano.de.

(08) CAPI 4 BSD (C4B) CAPI module for FreeBSD: www.nord-com.net/thomas.wintergerst.

(09) RedHat CAPI4Linux RPMs are located at: http://mungo.homelinux.org.

(10) Mandrake CAPI4Linux RPMs are located at: ftp.berlios.de/pub/avm-capi4linux.

(11) Information on Bluetooth and Linux are located at: www.holtmann.org.

Back to top

## L Support

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.

- The "Products" category provides detailed information about all AVM products as well as announcements of new products and product versions.
- Through the "Service" area, you may contact the AVM Support.
- The current driver software for all AVM DSL/ISDN-Controllers can be downloaded from the "Download" area.

All programs and drivers available on AVM's Internet site can also be downloaded 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 www.avm.de/en/support.

Fill out the form and mail it to AVM Support by clicking the "Send" button.

EOF

SAS; SR; FS; 10/2003