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

This document contains

Contents:

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

The CAPI Association (www.capi.org) has adopted an obligatory CAPI 2.0 standard for Linux in fall 1999. This now allows applications and drivers which can run on all ISDN-Controllers with a compatible CAPI 2.0 driver to be developed in Linux.

CAPI4Linux consists of a complete CAPI 2.0 driver for the respective AVM ISDN-Controller and, based on this:

CAPI4Linux makes it possible to use the entire range of ISDN services like Internet access, Remote Access Service, telephony, Fax G3 and file transfer over a standardized applications interface ("CAPI 2.0") with corresponding applications.

In addition, FRITZ!Card DSL provides you access to ADSL via the CAPI interface. Now ISDN services can be used parallel to ADSL services via only one single interface.

For comprehensive information about CAPI4Linux, use the "Search" command on the AVM home page at http://www.avm.de/en

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

2.0   Which AVM ISDN-Controllers Are Currently Supported by CAPI4Linux?

CAPI4Linux currently supports the following internal AVM ISDN-Controllers:

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

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

3.0   What Are the Prerequisites for Installing the CAPI4Linux Package?

The INTEL i386 platform is supported on any single-CPU computer with one passive AVM ISDN-Controller or the FRITZ!Card DSL installed. AVM's also supported active ISDN-Controllers are particularly suitable for server operation and offer support for SMP computers and additional Linux-supported hardware platforms. Up to four controllers can be installed on each system.

For simple installation, AVM provides pre-compiled driver archives for the following Linux distributions:

* "Out of maintenance state (EOM)", i.e., these older versions are no longer supported with current drivers.

Installation for these distributions is described in this document. In SuSE 7.1, both specified kernel versions are supported with just one installation program. Support of additional distributions by means of pre-configured modules is planned.

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-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. Therefore they do not perform any kernel-calls, and the modules can be integrated in each Linux kernel.

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 http://www.avm.de/en.

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

4.0   Installing CAPI4Linux in SUSE Linux Distributions

4.1   Installing the AVM ISDN-Controller FRITZ!Card PCI / PCI v2.0

Operating system: SuSE Linux 6.3 (Kernel 2.2.13), SuSE Linux 6.4 (Kernel 2.2.14), SuSE Linux 7.0 (Kernel 2.2.16), SuSE Linux 7.1 (Kernel 2.2.18/2.4.0-4GB), SuSE Linux 7.2 (Kernel 2.4.4-4GB), SuSE Linux 7.3 (Kernel 2.4.10-4GB), SuSE Linux 8.0 (Kernel 2.4.18-4GB) and other distributions
Version: 03.09.10
Build: 02.09.06

Installation requirements:

ISDN4Linux is not required for installation of the controller. To switch from ISDN4Linux to CAPI4Linux and continue using the ISDN4Linux features (upgrade), the additional installation step (4) is required. Please see the additional information in section 3.0.

(1) Copy the archive "fcpci-SuSEX.X-YY.YY.YY.tar.gz" from the CAPI4LINUX archive to your computer (e.g. from a diskette using the "mcopy" command from a console) and start the console (command prompt). Extract the archive corresponding to the SuSE version used with the command

tar -xzvf fcpci-SuSEX.X-YY.YY.YY.tar.gz

Example for SuSE 8.0: tar -xzvf fcpci-SuSE8.0-03.09.10.tar.gz
A directory called "fritz" is created.

(2) Switch to the new directory "fritz".

(3) Run "./install".
If "ISDN4Linux" was already installed and shall 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 following exchanged script:
/sbin/init.d/i4l_hardware
(Start YaST 1.x / System Administration / Configuring Network / Configuring ISDN Parameter / select "ISDN Hardware" using TABULATOR key / activate "Start I4L“ / select "AVM B1 PCI" as ISDN card / save / Next / ESC and exit YaST).

(YaST2 user 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'").

ATTENTION: In SuSE 6.3, please see the additional information in Appendix A-1!

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

As an installation test, perform a PING test at the conclusion of installation to check whether the software has been installed correctly. Establish a test connection to the AVM Data Call Center (ADC) in Berlin over the "pppd" (Point-to-point Protocol Daemon) module. This simulates dialing in to any Internet provider (PPP sync in accordance with RFC1618 over HDLC). The necessary parameters are predefined under the argument "AVM".
The number of the test server is ++49 30 39 98 43 20.

ATTENTION: In SuSE 6.3, please see the additional information in Appendix A-2!

(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 others 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 6.0.

4.2   Installing the AVM ISDN-Controller FRITZ!Card Classic / A1

Operating system: SuSE Linux 6.3 (Kernel 2.2.13), SuSE Linux 6.4 (Kernel 2.2.14), SuSE Linux 7.0 (Kernel 2.2.16), SuSE Linux 7.1 (Kernel 2.2.18/2.4.0-4GB), SuSE Linux 7.2 (Kernel 2.4.4-4GB), SuSE Linux 7.3 (Kernel 2.4.10-4GB), SuSE Linux 8.0 (Kernel 2.4.18-4GB) and other distributions
Version: 03.09.10
Build: 02.09.06

Installation requirements:

ISDN4Linux is not required for installation of the controller. To switch from ISDN4Linux to CAPI4Linux and continue using the ISDN4Linux features (upgrade), the additional installation step (5) is required. Please see the additional information in section 3.0.

(1) Copy the archive "fcclassic-SuSEX.X-YY.YY.YY.tar.gz" from the CAPI4LINUX archive to your computer (e.g. from a diskette using the "mcopy" command from a console) and start the console (command prompt). Extract the archive with the command

tar -xzvf fcclassic-SuSEX.X-YY.YY.YY.tar.gz

Example for SuSE 8.0: tar -xzvf fcclassic-SuSE8.0-03.09.10.tar.gz

A directory called "fritz" is created.

(2) Because FRITZ!Card Classic is not a Plug and Play adapter, you must determine manually whether the necessary resources (free I/O address, free IRQ) are occupied by other hardware extensions. The driver software is set by default to use the resources "I/O address 300" and "IRQ 5". The jumper on the FRITZ!Card Classic is also set to the I/O address 300 (factory default).

The I/O address required by the FRITZ!Card Classic is set by jumper on the controller such that conflicts with other hardware extensions should be avoided.
FRITZ!Card Classic can use the following I/O addresses: 200, 240, 300, 340.

How Can I Find out Which Resources on My Computer Can Be Used for FRITZ!Card Classic?
Assistance is provided in the following files, which list all *occupied* resources resp. list the resources 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 following exchanged script:
/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 card / save the settings / click "Next" / ESC and exit YaST).

(YaST2 user 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'").

ATTENTION: In SuSE 6.3, please see the additional information in Appendix A-1!

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

As an installation test, perform a PING test at the conclusion of installation to check whether the software has been installed correctly. Establish a test connection to the AVM Data Call Center (ADC) in Berlin over the "pppd" (Point-to-point Protocol Daemon) module. This simulates dialing in to any ISP (Internet Service Provider) using PPP sync in accordance with RFC1618 over HDLC. The necessary parameters are pre-defined under the argument "AVM".
The number of the test server is ++49 30 39 98 43 20.

ATTENTION: In SuSE 6.3, please see the additional information in Appendix A-2!

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

4.3   Installing the AVM ISDN-Controller FRITZ!Card PnP

Operating system: SuSE Linux 6.3 (Kernel 2.2.13), SuSE Linux 6.4 (Kernel 2.2.14), SuSE Linux 7.0 (Kernel 2.2.16), SuSE Linux 7.1 (Kernel 2.2.18/2.4.0-4GB), SuSE Linux 7.2 (Kernel 2.4.4-4GB), SuSE Linux 7.3 (Kernel 2.4.10-4GB), SuSE Linux 8.0 (Kernel 2.4.18-4GB) and other distributions
Version: 03.09.10
Build: 02.09.06

Installation requirements:

ISDN4Linux is not required for installation of the controller. To switch from ISDN4Linux to CAPI4Linux and continue using the ISDN4Linux features (upgrade), the additional installation step (5) is required. Please see the additional information in section 3.0.

(1) Copy the archive "fcpnp-SuSEX.X-YY.YY.YY.tar.gz" from the CAPI4Linux archive to your computer (e.g. from a diskette using the "mcopy" command from a console) and start the console (command prompt). Extract the archive with the command

tar -xzvf fcpnp-SuSEX.X-YY.YY.YY.tar.gz

Example for SuSE 8.0: tar -xzvf fcpnp-SuSE8.0-03.09.10.tar.gz
A directory called "fritz" is created.

(2) Install the AVM FRITZ!Card PnP in your computer. The next installation steps depend on the distribution resp. kernel version used, since facilitation regarding automatic recognition of plug-and-play cards are only available in the Linux kernel of SuSE 7.2 and higher.

NOTE: If you are to perform the installation in SuSE 7.1 or earlier, please follow the instructions below. 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. If you are using SuSE 7.2 or higher, please proceed with step (2) in section 4.1.

Because FRITZ!Card PnP is an ISA plug-and-play card, the resources allocated to the FRITZ!Card PnP by the BIOS of your computer during the start-up must be determined using the "pnpdump" and "isapnp" tools from the distribution package (included in delivery of your distribution). This information has to be transmitted to the CAPI 2.0 driver via parameter entries. This applies on the basis of 2.2.18 support also for SuSE 7.1 with installed kernel version 2.4. Pleas proceed as follows:

(2a) Switch to the new "fritz" directory and start the installation program by entering "./install".

(2b) If you have installed another ISA plug-and-play card, a sound card, for example, and the file "/etc/isapnp.conf" therefore already exists in your system, please be sure to save the file under a different name. Otherwise the existing file will be overwritten in the next installation step without any request for confirmation.

(2c) Start the "pnpdump" tool with the following command:

/sbin/pnpdump > /etc/isapnp.conf

The file "isapnp.conf" is now created automatically.

(2d) Load the /etc/isapnp.conf file in an editor. The file may list several entries for other adapters installed in your system. By means of the "Vendor ID" entry, you can recognize your ISDN-Controller. AVM uses the Vendor ID AVM0900.

(2e) The parameter block to be edited includes a string that looks something like this (it may vary slightly depending on the system):
# Card 1: (serial identifier ec 00 01 04 d8 9d 00 8c 0e)
Below this is a line "ANSI string", which identifies the AVM ISDN-Controller FRITZ!Card PnP. The entry ends with
# (ACT Y)
The "#" sign in front of the "(ACT Y)" entry has to be deleted.

(2f) The relevant entries in this parameter block could look something like this, depending on the condition of your system:
# (INT 0 (IRQ 5 (MODE +E)))
# (IO 1 (BASE 0x0300) (CHECK))
These two entries contain the information for an I/O address or IRQ which may be free in your system and thus should be used. In the above example these are I/O 0300 and IRQ 5.
To activate these parameters, remove the comment mark "#" at the beginning of both lines as well as the entry "Check" in the line
# (IO 1 (BASE 0x0300))
Save the file. With the resources selected in this example, the entry should now look like the following:
(INT 0 (IRQ 5 (MODE +E)))
(IO 1 (BASE 0x0300))

NOTE: This file also includes alternative values for the I/O address and IRQ, which can be used by FRITZ!Card PnP. To determine which resources are available on your system, the two files below provide valuable assistance:
cat /proc/ioports                //shows the occupied I/O addresses
cat /proc/interrupts             //shows the occupied IRQs
All *occupied* resources are listed resp. these resources are listed which are used by other drivers.

ATTENTION: These lists are not exhaustive, i.e., some resources *not* listed in these files may also be occupied!

In any case make sure that you do not select any resources that are already designated as occupied. FRITZ!Card PnP can physically use the following settings:
IRQs: 2,3,4,5,6,7,9,10,11,12,15
I/O: any 32-byte I/O range between 0200 and ffe0 hex
If an incorrect setting is selected here, the driver cannot be started. Should any problems occur during the computer start after these settings are configured, delete the isapnp.conf file from the backup system. In this case repeat step (2c) and select other, available resources, that do not conflict with other hardware resources.

(3) Open the file "/etc/capi.conf" in an editor and enter the resources to be used on your system as determined in step (2) under "IO" and "irq". The controller type for FRITZ!Card PnP is "fcpnp".

(4) Save the "/etc/capi.conf" file.
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 user 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'").

ATTENTION: In SuSE 6.3, please see the additional information in Appendix A-1!

(6) Restart your computer. The CAPI 2.0 driver is initialized automatically when the computer is restarted. Check with the "lsmod" command (only available to the "root" user, or "Superuser") whether the CAPI module is present in the system. The following loaded modules should be included in the output:

If error messages are returned, repeat the above steps from step (2c) and enter different resources.

As an installation test, perform a PING test at the conclusion of installation to check whether the software has been installed correctly. Establish a test connection to the AVM Data Call Center (ADC) in Berlin over the "pppd" (Point-to-point Protocol Daemon) module. This simulates dialing in to any ISP (Internet Service Provider) using PPP sync in accordance with RFC1618 over HDLC. The necessary parameters are pre-defined under the argument "AVM".
The number of the test server is ++49 30 39 98 43 20.

ATTENTION: In SuSE 6.3, please see the additional information in Appendix A-2!

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

4.4   Installing the AVM ISDN-Controller FRITZ!Card PCMCIA / A1 PCMCIA

Operating system: SuSE Linux 6.3 (Kernel 2.2.13), SuSE Linux 6.4 (Kernel 2.2.14), SuSE Linux 7.0 (Kernel 2.2.16), SuSE Linux 7.1 (Kernel 2.2.18/2.4.0-4GB), SuSE Linux 7.2 (Kernel 2.4.4-4GB), SuSE Linux 7.3 (Kernel 2.4.10-4GB), SuSE Linux 8.0 (Kernel 2.4.18-4GB) and other distributions
Version: 03.09.10
Build: 02.09.06

Installation requirements:

ISDN4Linux is not required for installation of the controller. If you want to switch from ISDN4Linux to CAPI4Linux, but want to continue using the ISDN4Linux features (upgrade), the additional installation step (4) is required. Please see the additional information in section 3.0.

Preparation for PCMCIA ability:

Install the "external PCMCIA package" containing the packages "pcmcia-Y.Y.YY" and "pcmcia-cardinfo-Y.Y.YY" ("Y" is the version number of the package) from the SuSE CD-ROMs. After the installation of these packages, set the variable "PCMCIA_SYSTEM" in the file "/etc/sysconfig/pcmcia" to "external". If not yet listed, enter in the variable "PCMCIA_PCIC" the type of PCMCIA controller (see also the following comprehensive comments). Start the package with the command "rcpcmcia start". If the package does not start, restart your computer.

(1) Copy the archive "fcpcmcia-SuSEX.X-YY.YY.YY.tar.gz" from the CAPI4Linux archive to your computer (e.g. from a diskette using the "mcopy" command from a console) and start the console (command prompt). Extract the archive with the command

tar -xzvf fcpcmcia-SuSEX.X-YY.YY.YY.tar.gz

Example for SuSE 8.0: tar -xzvf fcpcmcia-SuSE8.0-03.09.10.tar.gz
A directory called "fritz" is created.

(2) Switch to the new directory "fritz".

NOTE: If you are to perform the installation in SuSE 7.1 or lower, please follow the instructions below. In SuSE 7.2 or higher, the installation is similar to the installation of FRITZ!Card PCI. If you are working in SuSE 7.2 or higher, insert the card in the PCMCIA slot and proceed with step (2) in section 4.1. The names of the modules to be loaded are listed in step (6) in this chapter.
If the PCMCIA controller is already placed in the slot, remove the controller and insert it once again to load the driver. The install program is loading the CAPI modules.

(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 card / save the settings / click "Next" / ESC and exit YaST).

(YaST2 user 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'").

ATTENTION: In SuSE 6.3, please see the additional information in Appendix A-1!

(5) Determine the PCMCIA controller hardware (chip set of the existing PCMCIA controller) by opening the "Probe" program:
/usr/sbin/probe or /sbin/probe
As a result, the PCMCIA controller chip used in your system is returned, e.g., i82365. Make a note of this output.

(5a) Register the PCMCIA hardware used.
Open the file below in an editor: /etc/rc.config
Enter the following parameter:
Variable START_PCMCIA="yes"
Variable PCMCIA=...

(enter the PCMCIA controller chip from step (4a), "i82365" or "tcic")
If necessary, enter also the following:
Variable PCMCIA_PCIC_OPTS=...
(To obtain information about this variable in the corresponding "man page", enter the command: man i82365 / man tcic)
Variable PCMCIA_PCIC_OPTS=...
(To obtain information about this variable in the corresponding "man page", enter the command: man pcmcia_core or PCMCIA-HOWTO)

(5b) Enlarge the "PCMCIA Card Configuration Database". This step is only necessary in SUSE 6.3/6.4! SUSE 7.0 users may continue with step (6).
Open the file below in an editor: /etc/pcmcia/config
Add the following lines to the end of the file after the final "card ....." entry:
device "fcpcmcia_cs"
class "avm" module "fcpcmcia_cs"
card "AVM ISDN-Controller FRITZ!Card PCMCIA"
version "AVM", "ISDN A"
bind "fcpcmcia_cs"
card "IBM International ISDN PC Card"
version "ISDN", "CARD"
bind "fcpcmcia_cs"

ATTENTION: If the database already includes another "card" entry which also includes the string 'version "AVM", "ISDN A"', this entry must be designated as an inactive entry by a preceding "#" character!

(6) Now restart your computer. The CAPI 2.0 driver is initialized automatically when the computer is restarted.
Check with the "lsmod" command (only available to the "root" user, or "Superuser") whether the CAPI module is present in the system. The following loaded modules should be included in the output:

As an installation test, perform a PING test at the conclusion of installation to check whether the software has been installed correctly. Establish a test connection to the AVM Data Call Center (ADC) in Berlin over the "pppd" (Point-to-point Protocol Daemon) module. This simulates dialing in to any ISP (Internet Service Provider) using PPP sync in accordance with RFC1618 over HDLC. The necessary parameters are pre-defined under the argument "AVM".
The number of the test server is ++49 30 39 98 43 20.

ATTENTION: In SuSE 6.3, please see the additional information in Appendix A-2!

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

4.5   Installation of the AVM ISDN-Controllers FRITZ!Card USB, FRITZ!Card USB v2.x, FRITZ!X USB, FRITZ!X USB v2.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:

ISDN4Linux is not required for installation of the controller. If you want to switch from ISDN4Linux to CAPI4Linux, but want to continue using the ISDN4Linux features, the additional installation step (4) is required. Please see the additional information in section 3.0.

Instructions for FRITZ!X USB / FRITZ!X USB v2.0 users: Both devices are addressed by a uniform CAPI 2.0 driver. The following installation allows the ISDN-Controller integrated in these external devices to be used in Linux. For the configuration of the analog a/b ports of these device, please use a touch-tone dialing (DTMF) telephone or the enclosed software for MS Windows. See the documentation of your AVM ISDN-Controller for details.

(1) Copy the appropriate driver archive for your ISDN-Controller
FRITZ!Card USB: "fcusb-SuSEX.X-YY.YY.YY.tar.gz"
FRITZ!Card USB v2.x: "fcusb2-SuSEX.X-YY.YY.YY.tar.gz"
FRITZ!X USB / FRITZ!X USB v2.0: "fxusb-SuSEX.X-YY.YY.YY.tar.gz"
from the CAPI4Linux archive to your computer (e.g. from a diskette using the "mcopy" command from a console) and start the console (command prompt). Extract the archive corresponding to the distribution used with the command

tar -xzvf fcusb-SuSEX.X-YY.YY.YY.tar.gz

Example for SuSE 8.0: tar -xzvf fcusb-SuSE8.0-03.09.10.tar.gz
A directory called "fritz" is created.

(2) Switch to the new directory "fritz".

(3) Run "./install". If you use SuSE 7.1/7.2, perhaps the USB base driver on your system (usb-uhci / uhci) must be switched. This will be performed automatically (please see the additional information in section 4.5.1). Afterwards, restart your computer by entering the "reboot" command.

(4) Connect the AVM ISDN-Controller to your computer's USB bus. 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:

As an installation test, perform a PING test at the conclusion of installation to check whether the software has been installed correctly. Establish a test connection to the AVM Data Call Center (ADC) in Berlin over the "pppd" (Point-to-point Protocol Daemon) module. This simulates dialing in to any ISP (Internet Service Provider) using PPP sync in accordance with RFC1618 over HDLC. The necessary parameters are pre-defined under the argument "AVM".
The number of 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 6.0.

4.5.1   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-Controllers for the USB port. All drivers are equipped with similar features, but are not identical. Usually, a suitable host controller driver is selected and installed during the SuSE installation. In SuSE 8.0, your operating system selects automatically a suitable USB driver. For stable operation of AVM USB devices in SuSE 7.1/7.2, the "uhci" driver is recommended. The installation program automatically activates this driver for this SuSE version, as long as no (!) other USB devices (such as scanners, mouses, etc.) are registered at "usb-uhci". In that case, a prompt will appear, and you have to reboot your computer.

Normally all other USB devices already installed in the system should cooperate smoothly with the "uhci" driver. In exceptional cases where problems arise, the "usb-uhci" driver (in SuSE 7.1/7.2) can be initialized manually by editing the "/etc/usbmgr/host" file after a reboot. This file contains the name of the host controller driver used by the system, i.e. "usb-ohci", "usb-uhci" or "uhci".

(SuSE 7.3: see the file /etc/rc.config.d/hotplug.rc.config, which lists in the entry HOTPLUG_USB_HOSTCONTROLLER_LIST all host controller drivers. These drivers should be loaded following the order presented there. In SuSE 8.0, you will find the entry HOTPLUG_USB_HOSTCONTROLLER_LIST in the /etc/sysconfig/hotplug file.)

The AVM ISDN-Controllers in Linux provide the same features as in MS Windows: power is supplied without an external power plug ("bus powered"), the controllers can be connected to the USB bus dynamically without restarting the operating system ("Hot Plug&Play").

4.6   Installing the AVM ADSL/ISDN-Controller FRITZ!Card DSL

Operating system: SuSE Linux 7.3 (Kernel 2.4.10-4GB), SuSE Linux 8.0 (Kernel 2.4.18-4GB) and other distributions
Version: 03.09.14
Build: 02.09.06

Installation requirements:

The module "pppd" (Point-to-point Protocol Daemon) is required for Internet access. "pppd" can also be used to establish a test connection to the AVM Data Call Center (ADC) over ISDN at the conclusion of installation. This test simulates a connection to an ISP (Internet Service Provider).

ISDN4Linux is not required for installation of the controller. If you want to switch from ISDN4Linux to CAPI4Linux, but want to continue using the ISDN4Linux features, please note the information in section (3.0).

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 ADSL and for ISDN operation on your FRITZ!Card DSL can work independently from one another.

(1) Connect the FRITZ!Card DSL with the ADSL access (for detailed information, please see the manual).

(2) Copy the archive "fcdsl-SuSEX.X-YY.YY.YY.tar.gz" from the CAPI4Linux archive to your computer (e.g. from a diskette using the "mcopy" command from a console) and start the console (command prompt). Extract the archive corresponding to the SuSE version used with the command

tar -xzvf fcdsl-SuSEX.X-YY.YY.YY.tar.gz

Example for SuSE 8.0: tar -xzvf fcdsl-SuSE8.0-03.09.14.tar.gz
A directory called "fritz" is created.

(3) Switch to the new directory "fritz".

(4) Run "./install".

(5) After the installation of the driver software, the DSL Assistant starts automatically and detects the ATM parameters of your ADSL access. You will see the following console output for a T-DSL access [U-R2]:
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 ADSL and ISDN operation. If the „line parameter“ / „ATM parameter“ could not (!) be detected automatically, please check the following:

After installation, you can start the DSL Assistant manually with the following command:
drdsl
The DSL parameters detected at a T-DSL access are entered automatically in the file /etc/modules.conf as follows:
options fcdsl VPI=1 VCI=32 VCC=1

(6) The CAPI 2.0 driver is loaded automatically the next time the system is started. Check with the "lsmod" command (only available to the "root" user, or "Superuser") whether the CAPI module for ADSL and ISDN is present in the system. The following loaded modules should be included in the output:

As an installation test, perform a PING test over ISDN at the conclusion of installation to check whether the software has been installed correctly. 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 of 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 6.0.

DSL dial-up: To establish an ADSL 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".

5.0   Removing the Controller / Driver Update

The procedure required to remove or update the CAPI 2.0 driver software is identical for all internal ISDN-Controllers and for the AVM ISDN-Controller for the PCMCIA bus. USB devices load or unload the driver software dynamically when they are plugged into or out of the USB bus.

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

(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. The controller is now uninstalled.
To remove the driver in SuSE 8.0 or higher, enter ./install -r.

6.0   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 contained as a „UNIX manual page“ and can be viewed on the console by entering:

man capiplugin

at a console.

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 No.
0001:   co-user
33333: Password

!!!!! The character “\“ before „#“ is important!!!!!

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

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

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 with the command

man capiinfo

at a console.

7.1   ISDN Monitor "K ISDN Watch" for KDE 2.x / 3.x

AVM provides with the CAPI 2.0 application "K ISDN Watch" an additional 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/

7.2   ADSL Monitor "K ADSL Watch" for KDE 2.x / 3.x

AVM provides with the CAPI 2.0 application "K ISDN Watch" a tool especially for the AVM ADSL/ISDN-Controller FRITZ!Card DSL. "K ADSL Watch" is an ADSL-Monitor that offers powerful monitoring functions of the activities of the installed AVM ADSL/ISDN-Controller and can be translated for KDE 2.x and 3.x. "K ADSL Watch" is subject to the GPL and based on "kimon". The application can be downloaded from the following ftp directory: ftp://ftp.avm.de/tools/k_adsl_watch.linux/

8.0   Further Information Sources

(1) Information about the CAPI 2.0 Specification
The CAPI 2.0 Specification can be downloaded free of charge from the Internet site: http://www.capi.org
Additional questions about the CAPI 2.0 Specification should be asked in Usenet and addressed to news:comp.dcom.isdn.capi

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

(3) FAQs
AVM provides its own page of frequently asked questions (FAQs), including questions about CAPI4Linux at http://www.avm.de/de/Service/FAQs/Linux/index.html (unfortunately, this site is only available in German).

(4) Mailing List / ftp Server
The Linux drivers for active AVM ISDN-Controllers originally were developed by Carsten Paeth ("Calle"). The "CAPI4Linux" model for active AVM ISDN-Controllers is based on these developments. Here you can discuss all questions concerning the development of CAPI4Linux applications. The mailing list is located at: linux-avmb1@calle.in-berlin.de

To subscribe to the mailing list:
Send an e-mail to: majordomo@calle.in-berlin.de with the following contents:
subscribe linux-avmb1 <your_email_address/

To sign out from the mailing list:
Send an e-mail to: majordomo@calle.in-berlin.de with the following contents:
unsubscribe linux-avmb1 <your_email_address/

There is also an ftp server with additional patches for special implementations, e.g. for combination with VBOX. A number of sample programs for programming CAPI 2.0 applications in Linux are also presented here.
You find the server at the following ftp address: ftp://ftp.in-berlin.de/pub/capi4linux or ftp://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-2001-02-20.tar.gz):

(5) Faxing with capircvd
Information about an already existing CAPI 2.0-based program for receiving faxes (G3) and voice calls is provided at the URL: http://capircvd.berlios.de/index_eng.php3

(6) FRITZ!Card PCI v2.0 in RedHat 7.1 mini HowTo: http://lauer.monweb.lu/howtos/FRITZ!PCI_RH71_HowTo.html

9.0   Support

AVM offers 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 http://www.hylafax.org.

The AVM web site offers detailed information and updates free of charge. Visit the site at http://www.avm.de/en.

The current driver software for all AVM ISDN-Controllers can be downloaded from the „Download“ area.
All programs and drivers available from the Internet site can also be obtained from the AVM Data Call Center (ADC).
Please use the information sources described above before contacting the support.

If these instructions and the various information sources have not helped to resolve your problem, contact AVM Support for additional technical assistance.
Support inquiries can be sent to AVM using the e-mail form provided at the Internet address http://www.avm.de/en/service

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

___________________________________________________________________________________________________________________

APPENDIX A: Special Information for Operation in SuSE 6.3

A-1   Deactivating ISDN4Linux in SuSE 6.3

Since "YaST" included in delivery of SuSE 6.3 does not support the active AVM ISDN-Controllers B1 / B1 PCI, switching from ISDN4Linux to AVM B1 PCI (as described for SuSE 6.4) takes a little longer.

Prerequisite: ISDN4Linux must be active.

When the message "Switch ISDN4Linux to AVM-B1" appears in ./install, proceed as follows in SuSE 6.3:

Open a console and enter the following: /etc/rc.config.d/i4l_hisax.rc.config:
Set: I4L_TYPE=""       (deactivate HiSax)

File: /etc/rc.config.d/i4l_b1.rc.config:
Set: I4L_USE_B1="yes" (activate capiinit)

Unfortunately, this measure does not completely switch off HiSax, for when the system is started, the "i4l" package fails because the CAPI4Linux started previously allocates the resources. However, the driver (e.g. fcpci.o) is activated and can be addressed.

A-2   Required "pppd" Update in SuSE 6.3

Unfortunately, the pppd delivered with SuSE 6.3 is not up to date. Therefore it is necessary to update the pppd to be able to perform the test connection described here successfully. Otherwise an error message is returned when pppd is opened. The required file (series "n", package "ppp") can be accessed directly from ftp://ftp.suse.com/pub/suse/discontinued/i386/update/6.3/n1/ppp.rpm.

Please unpack the file using the command "rpm --install --force ppp.rpm" and then install it.

EOF

=======================================================================================================

AZ; SAS; SR, FS; 08/2002