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

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

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.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 active controllers can be installed on each system.

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

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

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

The chip set driver "HiSAX" runs as an application packet on CAPI 2.0 over the modules "capidrv.o" and "isdn.o".

The chip set driver HiSAX as low-level hardware driver is replaced by the CAPI 2.0 driver and may not be installed in the same system as the CAPI4Linux package.

By now there are a multitude of Internet pages with information, tips and tricks, HowTos and the like about integrating CAPI4Linux in further distributions and kernel versions. For more information, please see section 9.0.

4.0   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-Controllers requires a previous installation of the controller using YaST2. Only then can an installation with the AVM CAPI4Linux package be carried out! A description detailing the installation of the AVM DSL/ISDN-Controllers can be found in the following section.

4.1   Preparing the AVM ISDN-Controller and the AVM DSL/ISDN-Controller for Installation with YaST2 in SuSE Linux 8.1 or higher

NOTE: This section provides assistance for meeting the installation requirements for the installation of the CAPI4Linux package using SuSE Linux from version 8.1 onwards. If you have already installed your controller with SuSE Linux 8.1 using YaST2 or when you use an older version, please continue with the installation section relevant to your AVM ISDN-Controller or DSL/ISDN-Controller! Please click the corresponding link for your controller:
AVM ISDN-Controller FRITZ!Card PCI / PCI v2.x
AVM ISDN-Controller FRITZ!Card Classic / A1
AVM ISDN-Controller FRITZ!Card PnP
AVM ISDN-Controller FRITZ!Card PCMCIA / A1 PCMCIA
AVM ISDN-Controller FRITZ!Card USB, FRITZ!Card USB v2.x, FRITZ!X USB, FRITZ!X USB v2.0
AVM DSL/ISDN-Controller FRITZ!Card DSL

  1. Insert the AVM DSL/ISDN-Controller FRITZ!Card DSL into your PC and connect the AVM DSL/ISDN-Controller with the DSL or ISDN line.
  2. After the 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 menu "Network/Basic".
  3. If you are not already logged in as "root", i.e. as "Superuser", then you must provide the "root" password in the following dialog as system administration rights (root privileges) are necessary for hardware configuration.
  4. In the following YaST dialog "ISDN cards configuration", select your controller and click "Configure".
  5. In the "ISDN low-level configuration" window, insert both your "Areacode" and "Dialprefix".
  6. If necessary, review the parameters "E/A Address" and "IRQ".
  7. If possible, choose under "Driver" 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:
  11. The subsequent configuration of the DSL/ISDN connection for KInternet is optional.
    You can chose "Skip" and "Finish" to conclude the installation in order to dial from this point 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).
    Further Information regarding the script's usage can be found in AVM ISDN-Controllers instructions.
    If you want to configure a connection using KInternet then choose the option "Add DSL CAPI Interface" for DSL or "Add new SyncPPP network interface" for ISDN from "ISDN Service Selection" under "Network services" and follow the instructions.
    Further information for hardware configuration can also be found in the SuSE documentation in the folders:
    /usr/share/doc/packages/susehelp
    /usr/share/doc/packages/suselinux-adminguide_de/

All prerequisites for the controllers installation using the AVM CAPI4Linux package in SuSE 8.1 are now fulfilled. Continue with the installation of your AVM ISDN-Controller or your AVM DSL/ISDN-Controller using the relevant installation instructions. Please click the corresponding link for your controller:
AVM ISDN-Controller FRITZ!Card PCI / PCI v2.x
AVM ISDN-Controller FRITZ!Card Classic / A1
AVM ISDN-Controller FRITZ!Card PnP
AVM ISDN-Controller FRITZ!Card PCMCIA / A1 PCMCIA
AVM ISDN-Controller FRITZ!Card USB, FRITZ!Card USB v2.x, FRITZ!X USB, FRITZ!X USB v2.0
AVM DSL/ISDN-Controller FRITZ!Card DSL

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

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

4.4   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

Beispiel für SuSE 8.0: tar -xzvf fcpnp-SuSE7.1-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 lower, 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.2.

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. Please 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 must 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))
Both these entries contain details of an IO address or an IRQ from your system which is free and therefore possible to use. In the cane of the example above it is the 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 this 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            
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,120.15 I/O: Any 32 Byte I/O window between 0200 and ffe0 hex
Selecting the wrong settings here can lead to a situation where the driver wont start. 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) "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 the 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 for 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 7.0.

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

Preparation for PCMCIA ability:

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

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

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

Example for SuSE 8.0: tar -xzvf fcpnp-SuSE7.1-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.2. 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 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'").

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). Start the program "Probe":
/usr/sbin/probe or /sbin/probe
The result displayed is the PCMCIA-Controller chip used in your system, i.e. i82365. Make a note of this output.

(5a) Register the PCMCIA hardware used. Open the file below in an editor.
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 loaded automatically when the computer is restarted.
Check with the "lsmod" command (only available to the "root" user, or "Superuser") whether the CAPI module is present in the system. The following loaded modules should be included in the output:

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

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 with this test connection, the following command can also be used (DNS is assigned over the PPP connection):

pppd call isdn/avm usepeerdns

If you are working at a PBX extension with outside dialing access "0", please enter the following command:

pppd call isdn/avm numberprefix 0 usepeerdns

Enter the keyboard shortcut "Strg+C" to clear down the connection.

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

4.6   Installation of the AVM ISDN-Controller 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 are using 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.6.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 for the test server is ++49 30 39 98 43 20.

(1) Start a console (command prompt)

(2) Establish a pppd connection by entering the following command:

pppd call isdn/avm

If you are working at a PBX extension with outside dialing access "0", please enter the following command:

pppd call isdn/avm numberprefix 0

Once a test connection has been established, the output window contains among other information the ping transit time to the AVM server over your ISDN-Controller. This means that installation was successful. To access the AVM home page with a web browser (like Netscape) directly, the following command can also be used (DNS is assigned over the PPP connection):

pppd call isdn/avm usepeerdns

If you are working at a PBX extension with outside dialing access "0", please enter the following command:

pppd call isdn/avm numberprefix 0 usepeerdns

Enter the keyboard shortcut "Strg+C" to clear down the connection.

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

4.6.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 these SuSE versions, as long as no (!) other USB devices (such as scanners, mouses, etc.) are registered at "usb-uhci". In that case, a prompt will appear, and you have to reboot your computer.

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

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

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

4.7   Installing the AVM DSL/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) SuSE Linux 8.1 (Kernel 2.4.19-4GB) and other distributions
Version: 03.09.14
Build: 02.12.04

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

Up to SuSE 8.0, 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 and section 4.0.

ATTENTION: When using SuSE Linux distributions from version 8.1 onwards, an installation of the AVM DSL/ISDN-Controllers requires a previous installation of the controller using YaST2. Only then can an installation with the AVM CAPI4Linux package be carried out! A description detailing the installation of the AVM DSL/ISDN-Controllers can be found in section 4.1.

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 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.1: tar -xzvf fcdsl-SuSE8.1-03.09.14.tar.gz
A directory called "fritz" is created.

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

(4) Run "./install".

(5a) In SuSE 8.1 or higher, a successful installation of your AVM DSL/ISDN-Controller is prompted with the following message:

"The driver files have been updated. Reboot or restart the ISDN package in order to activate the changes... Ready."

If you are using SuSE 8.1, please continue reading with step (6).

(5b) Up to SuSE 8.0, the DSL Assistant starts automatically after the installation of the driver software and detects the ATM parameters of your ADSL access. You will see the following console output for a T-DSL access [U-R]:
Analyzing DSL parameters...
Driver versions: stack: 3.09-14, firmware: 1.00.37
Please wait... (up to 3 minutes)
Line parameters found: VPI=1 VCI=32 VCC=1
Ready.
NOTE: The format of the pppd peer scripts has been changed! The peer scripts have been checked/updated.
Starting CAPI4Linux...
1 fcdsl      running   fcdsl-pci         A1 3.09-14 io E2800000 mem E300
2 fcdsl      running   fcdsl-pci         A1 3.09-14 io E2800000 mem E300

Now the driver is loaded an the controller is ready for DSL and ISDN operation. If the "line parameter" / "ATM parameter" could not (!) be detected automatically, please check the following:

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

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

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 for the test server is ++49 30 39 98 43 20.

(1) Start a console (command prompt).

(2) Establish a pppd connection by entering the following command:

pppd call isdn/avm

If you are working at a PBX extension with outside dialing access "0", please enter the following command:

pppd call isdn/avm numberprefix 0

Once a test connection has been established, the output window contains among other information the ping transit time to the AVM server over your ISDN-Controller. This means that installation was successful. To access the AVM home page with a web browser (like Netscape) directly, the following command can also be used (DNS is assigned over the PPP connection):

pppd call isdn/avm usepeerdns

If you are working at a PBX extension with outside dialing access "0", please enter the following command:

pppd call isdn/avm numberprefix 0 usepeerdns

Enter the keyboard shortcut "Strg+C" to clear down the connection.

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

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

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

6.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. Since the AVM DSL/ISDN-Controller in SuSE 8.1 is installed with YaST2, you have to remove the controller with YaST2. In all other SuSE Linux versions, please proceed as described in section 6.2 to remove your AVM DSL/ISDN-Controller manually.

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

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

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

!!!!! The character "\" before "#" is important!

If your DSL access is provided by the DSL carrier "1&1", the script "t-dsl" in "etc/ppp/peers/" has to be edited as follows:

Replace the following line:

user 000000000000\#000000000000\#0001\#@t-online.de
password 00000000

with the following entries:

user 1und1/<your login ID>@online.de
password <your password>

Please note that the entries <your login ID> and <your password> have to be replaced by the user ID ("1111-222", for instance) and the corresponding password assigned to you by 1&1.

Extract from an adapted example script:

# connection ID T-Online No. co-user
# | | |
user 1und1/1234-5678@online.de
password secret
linkname t-dsl
ipparam internet
plugin capiplugin.so
avmadsl
:
/dev/null
...

8.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 ISDN-Controller with the number "<n/" (see also "cat /proc/capi/controller").
This output is generated directly by the driver and contains such information as the serial number and the selected line type, e.g. Point-to-Point (P2P) or Point-to-Multipoint (P2M).

A complete description of the "capiinfo" help program is contained in the form of a "UNIX manual page" and can be opened on a console with the following command:

man capiinfo

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

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

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

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

9.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: www.capi.org.
Additional questions about the CAPI 2.0 Specification should be asked in Usenet and addressed to news:news:comp.dcom.isdn.capi.

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

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

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

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

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

There is also an ftp server with additional patches for special implementations, e.g. for combination with VBOX. A number of sample programs for programming CAPI 2.0 applications in Linux are also presented here.
You find the server at the following ftp address: ftp.in-berlin.de/pub/capi4linux or ftp.in-berlin.de/pub/users/calle/capi4linux/.

This site provides patches developed independently of AVM for a number of special implementations.
CAPI 2.0 demo programs currently stored here include (capiconn-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

10.0   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 current driver software for all AVM ISDN-Controllers can be downloaded from the "Download" area.
All programs and drivers available from the Internet site can also be obtained from the AVM Data Call Center (ADC).
Please use the information sources described above before contacting the support.

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

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 run. The required file (series "n", package "ppp") can be accessed directly from 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; RG; FS; 12/2002