Welcome to CAPI4Linux for active AVM ISDN-Controllers!

Contents

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

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

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

3 What Are the Prerequisites for Installing the CAPI4Linux Package?

4 Installing CAPI4Linux in SuSE Linux Distributions

4.1 Installing Active AVM ISDN-Controllers in SusE Linux 8.1 or Higher
4.1.1 Preparing Installation of the AVM ISDN-Controller B1 v1.4 / B1 v2.0 / B1 v3.0 / B1 PCMCIA / B1 PCI / B1 PCI v4.0 in SuSE 8.1 or Higher with YaST2
4.1.2 Installing the CAPI4Linux Package for the AVM ISDN-Controller B1 v1.4 / B1 v2.0 / B1 v3.0 / B1 PCMCIA / B1 PCI / B1 PCI v4.0 in SuSE 8.1
4.1.3 Installing the Active AVM ISDN-Controller C4 in SuSE Linux 8.1
4.1.4 Installing the Active AVM ISDN-Controller C2 in SuSE Linux 8.1
4.1.4 Installing the Active AVM ISDN-Controller T1/T1-B in SuSE Linux 8.1 or Higher
4.2 Installations for Active AVM ISDN-Controllers in SuSE 8.0 or Lower
4.2.1 Installing the AVM ISDN-Controller B1 PCI and B1 PCI v4.0
4.2.2 Installing the AVM ISDN-Controller B1
4.2.3 Installing the AVM ISDN-Controller B1 PCMCIA
4.2.4 Installing the AVM ISDN-Controller C4
4.2.5 Installing the AVM ISDN-Controller C2
4.2.6 Installing the AVM ISDN-Controller T1 and T1-B

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

6 Removing the Controller and Updating the Drivers

6.1 Removing the Controller / Driver Update in SuSE 8.1 or Higher
6.2 Removing the Controller/Driver Update in SuSE 8.0 or Lower

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

8 Information about Installing Multiple Active AVM ISDN-Controllers

9 Help Programs

9.1 ISDN Monitor "K ISDN Watch" for KDE

10 Further Information Sources

11 AVM Support

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

The idea behind the CAPI4Linux project is a new approach for ISDN communication in Linux. Through the adoption of an obligatory CAPI 2.0 standard for Linux by the CAPI Association (www.capi.org) in fall 1999, for the first time a unified standard was created for ISDN communication in Linux: the CAPI 2.0 interface already in regular use on other platforms. This now allows applications and drivers which can run on all ISDN-Controllers with a compatible CAPI 2.0 driver to be developed in Linux.

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

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

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

Previous

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 on the ISDN-Controller FRITZ!Classic (AVM ISDN-Controller A1). If the manufacturer of your ISDN adapter uses a different chip set, the specification for addressing this new chip set (port addresses, etc.) must be provided each time by the manufacturer. This is not always possible, and every change to the hardware by the manufacturer generally requires a consequent adaptation of the chip set driver. Only a unified, mandatory interface allows the development of applications based on this application interface, such as fax servers and various user-mode applications. Hardware and applications thus can be exchanged at will. These were the reasons for creating the applications interface CAPI at the beginning of the 1990s.

Previous

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

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

Passive ISDN-Controllers

Active ISDN-Controllers

NOTE:

The ISDN-Controller T1/T1-B does not support fax services.

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

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

Previous

3 What Are the Prerequisites for Installing the CAPI4Linux Package?

For simple installation, AVM provides pre-compiled driver archives for a number of popular Linux distributions. Thanks to the open concept of Linux, all current distribution can be used with the software. The pre-compiled driver archives support the INTEL i386 platform (single CPU). In order to use the drivers on another CPU platform and/or on an SMP machine, they must simply be re-translated or compiled. For instructions about translating the sources, see the /src directory.

The driver supports a maximum of four active AVM ISDN-Controllers installed at any given time, e.g four AVM ISDN-Controllers B1. A system may have any combination of active AVM ISDN-Controllers installed for the ISA/PCI/PCMCIA/USB bus. A "mixed" configuration of active and passive AVM ISDN-Controllers (e.g. AVM FRITZ!Card) is not possible. Because CAPI4Linux is a completely new development, it is not yet embedded in all popular Linux distributions. For other distributions, therefore, it is still necessary to install the package "by hand". This document describes installation in:

* "Out of maintainance state (EOM)". This means that these older versions are no longer supported by current drivers.

This means that installation is particularly simple in these distributions. In SuSE 7.1, both specified kernel versions are supported with just one installation program. Support of additional distributions by means of pre-configured modules is planned.

Previous.

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

From SuSE Linux 8.1, a previous controller installation with YaST2 is a prerequisite for installing an AVM ISDN-Controller with the AVM CAPI4Linux package! It is imperative that you follow the special tips in the installation instructions for the given active AVM ISDN-Controller. A description detailing the installation of the AVM ISDN-Controllers using YaST2 can be found in the following section.

Previous

4.1 Installing Active AVM ISDN-Controllers in SusE Linux 8.1 or Higher

The following sections describe the installation of active AVM ISDN-Controllers in SuSE Linux 8.1. Before beginning with installation, note the installation tips below.

Operating system: SuSE Linux 8.1 (Kernel 2.4.19-4GB) and other distributions
Version: 03.10.02 B1 Family
03.09.11 C2 / C4
01.03.01 T1 / T1-B
Build: 03.02.21

Installation requirements:

*NOTE:

Up to four active AVM ISDN-Controllers can be operated at the same time. For technical reasons found in SuSE 8.1, the installation of multiple controllers is possible only to a limited degree in SuSE 8.1. It is possible to install, for instance, 2 x T1 ISA with 2 x B1 ISA or 1 x T1 PCI with 1 x B1 PCI and one C2/C4 in SuSE 8.1. However, no PCI controllers of the same kind can be installed together (e.g., 3 x B1 PCI or 1 x C2 with 1 x C4 or 2 x T1 PCI). For more information about installing multiple controllers, please see section 8.

Previous

4.1.1 Preparing Installation of the AVM ISDN-Controller B1 v1.4 / B1 v2.0 / B1 v3.0 / B1 PCMCIA / B1 PCI / B1 PCI v4.0 in SuSE 8.1 or Higher with YaST2

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

    NOTE:

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

  3. System administration rights (root privileges) are necessary for hardware configuration. If you are not already logged in as "root", i.e. as "Superuser", then you must provide the "root" password in the following dialog.
  4. In the following YaST dialog "ISDN cards configuration" select the controller to be configured and click "Configure".
  5. In the "ISDN low-level configuration" window, insert both your "Areacode" and "Dialprefix".
  6. If necessary, check that the parameters "I/O Address" and "IRQ" match the resources available in your system and the jumper settings on the controller.
  7. Confirm your entries by clicking "OK".
  8. Ignore the following warning and confirm the question "You accept this?" with "Yes".
  9. You may be required to install a number of packages after this; if so, follow the corresponding instructions on the screen.
  10. The subsequent configuration of the ISDN connection for KInternet is optional. Choose "Skip" and "Finish" to conclude the installation now if you wish to dial into the Internet using a dial-in script via the console. Corresponding example scripts are available in the "etc/ppp/peers/isdn" folger after installation of the controller.

For more information about using pppd and scripts, see the following section and section 7. If you want to configure a connection using KInternet then choose the option "Add DSL CAPI Interface" for DSL or "Add new SyncPPP network interface" for ISDN from "ISDN Service Selection" under "Network services" and follow the instructions.

Additional information for hardware configuration can also be found in the SuSE documentation in the following folders:
/usr/share/doc/packages/susehelp
/usr/share/doc/packages/suselinux-adminguide_de/

All prerequisites for the installing the AVM ISDN-Controller using the AVM CAPI4Linux package in SuSE 8.1 have now been fulfilled. Now perform an installation by following the installation instructions below.

Previous

4.1.2 Installing the CAPI4Linux Package for the AVM ISDN-Controller B1 v1.4 / B1 v2.0 / B1 v3.0 / B1 PCMCIA / B1 PCI / B1 PCI v4.0 in SuSE 8.1

ATTENTION:

The installation method described here is valid only for SuSE Linux 8.1 or higher. A necessary prerequisite is a previous installation of the AVM ISDN-Controller using YaST2. Installation with the AVM CAPI4Linux package cannot be carried out until the YaST2 installation has been completed! A description detailing the installation of the AVM B1 ISDN-Controllers using YaST2 can be found in section 4.1.1.

  1. Make sure that your AVM B1 ISDN-Controller is connected to the ISDN line (see the manual).
  2. Copy the driver archive
    b1-susex.x-yy.yy.yy.tar.gz
    from the CAPI4Linux archive to your computer (e.g. from a diskette using the "mcopy" command from a console) and start the console (command prompt).
    Then extract the archive using the command
    tar -xzvf b1-susex.x-yy.yy.yy.tar.gz
    Example for the B1 in SuSE 8.1:

    tar -xzvf b1-suse8.1-03.10.02.tar.gz.
    A directory called "active" is created.
  3. Switch to the new directory "active".
  4. Run "./install" (Superuser rights are required).
  5. A successful installation of your AVM ISDN-Controller concludes with the message "The driver files have been updated. Reboot or restart the ISDN package in order to activate the changes... Ready." quittiert.
  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:
    -b1/b1isa/b1pci"/b1pcmcia*/   (depending on the AVM B1 ISDN-Controller installed)
    -capi
    -capifs
    -kernelcapi
    -capiutil
*If a B1 PCI v4.0 is installed, an additional module, b1dma, exists
*If a PCMCIA driver is installed, an additional module, avm_cs, exists

Upon conclusion of installation, perform a PING test of the installation. This checks whether installation was completed successfully. Establish a test connection to the AVM Data Call Center (ADC) in Berlin over the "pppd" (Point-to-point Protocol Daemon) module. This simulates dialing in to any ISP (Internet Service Provider) using PPP sync in accordance with RFC1618 over HDLC. The necessary parameters are pre-defined under the argument "AVM".

The number for the test server is ++49 30 39 98 43 20.

  1. Start a console (command prompt).
  2. Establish a pppd connection by entering the following command:
    pppd call isdn/avm
  3. If you are working at a PBX extension with outside dialing access "0", please enter the following command:
    pppd call isdn/avm numberprefix 0
    Once a test connection has been established, the output window contains among other information the ping transit time to the AVM server over your ISDN-Controller. This means that installation was successful. To access the AVM home page with a web browser (like Netscape) directly, the following command can also be used (DNS is assigned over the PPP connection):
    pppd call isdn/avm usepeerdns
    If you are working at a PBX extension with outside dialing access "0", please enter the following command:
    pppd call isdn/avm numberprefix 0 usepeerdns
  4. Enter the keyboard shortcut "Ctrl+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.

Previous

4.1.3 Installing the Active AVM ISDN-Controller C4 in SuSE Linux 8.1

ATTENTION:

In SuSE 8.1, a YaST installation of the AVM ISDN-Controller C4 is the basis of the AVM CAPI4Linux package. However, an online update must be performed before a YaST installation. Therefore this section describes how to dial into the Internet with a C4 and SuSE 8.1 installed by CD in order to download all of the necessary updates. If your system has already been updated using the packets (i4l-base...rpm, i4l-isdnlog...rpm, i4lfirm...rpm, capi4linux...rpm) available at ftp://ftp.suse.com/pub/suse/i386/update/8.1/rpm/i586, or with the "i4l-base (Basic Programs for ISDN Devices in Linux)" package installed by means of a YOU update, skip this section and continue with section 4.1.3.2 and then section 4.1.3.3. For more information about installing multiple controllers, please also see the information in section 4.1 and section 8.

4.1.3.1 Preparing Installation of an AVM C4 on a SuSE 8.1 Without Updates Installed
4.1.3.2 Preparing Installation for the Active AVM ISDN-Controller C4 with YaST2 in SuSE Linux 8.1 or Higher
4.1.3.3 Installing the active AVM ISDN-Controller C4 with the CAPI4Linux Package in SuSE Linux 8.1

Previous

4.1.3.1 Preparing Installation of an AVM C4 on a SuSE 8.1 Without Updates Installed

  1. Insert the AVM C4 in your system and connect the ISDN-Controller to the ISDN socket (see the manual).
  2. If after system login the SuSE hardware recognition reports "New hardware has been detected. Configure ISDN card?", cancel with "NO".
  3. Switch to the concolse and log in as root or Superuser.
  4. Check whether CAPI modules have already been loaded (using "lsmod"). If the modules capi / kernelcapi / capiutil / capifs are already loaded, continue from step 8.
  5. If no modules are loaded, enter the following command:
    echo "" > /etc/capi.conf
  6. Run "capiinit start".
  7. Run "lsmod" to verify again that the CAPI modules were loaded.
  8. Enter "modprobe -v c4" to load the controller AVM C4.
  9. To find out which controller number the C4 was assigned, enter the command "cat /proc/capi/controller".
  10. To load the firmware of the controller, enter "avmcapictrl load /usr/lib/isdn/c4.bin 1" (1 represents the assigned controller number).
  11. Dial in to the Internet with the command "pppd". For a number of call-by-call providers, preconfigured dial-in scripts are located in the "/etc/ppp/peers/isdn" folder. These scripts can be adapted for other providers.
    Establish a pppd connection with the following command (here with the example script Arcor, DNS is assigned over the PPP connection):
    pppd call isdn/arcor usepeerdns
    or, for PBX extensions with the outside dialing access "0":
    pppd call isdn/arcor numberprefix 0 usepeerdns
    Additional options of the CAPI 2.0 plug-in module for the "Generic PPP" stack (pppd) are described in section 7.
    Start the YaST online update (YOU) and update YOU first, as prompted, and then the package manager.
  12. Then select at least the update package "i4l-base (Basic Programs for ISDN Devices in Linux)"
    (alternatively the packages -i4l-base...rpm, i4l-isdnlog...rpm, i4lfirm...rpm, capi4linux...rpm) separately at ftp://ftp.suse.com/pub/suse/i386/update/8.1/rpm/i586.
  13. After a successful update, remove the capi.conf with "rm /etc/capi.conf".

Next, install the AVM ISDN-Controller with YaST as described in the following section so that you can then perform an update from the AVM server with the current CAPI4Linux package.

Back to 4.1.3

4.1.3.2 Preparing Installation for the Active AVM ISDN-Controller C4 with YaST2 in SuSE Linux 8.1 or Higher

ATTENTION:

Be sure to follow the instructions in section 4.1.3 if you have not yet updated your system with the "i4l-base (Basic Programs for ISDN devices in Linux)" through YOU or with the packages (i4l-base...rpm, i4l-isdnlog...rpm, i4lfirm...rpm, capi4linux...rpm) available at ftp://ftp.suse.com/pub/suse/i386/update/8.1/rpm/i586.

  1. Make sure that the AVM C4 ISDN-Controller is connected to the ISDN line (see the manual).
  2. Start YaST2 manually (YaST2 Control Center) and select "ISDN configuration" in the "Network/Basic" menu.
  3. System administration rights (root privileges) are necessary for hardware configuration. If you are not already logged in as "root", i.e. as "Superuser", then you must provide the "root" password in the following dialog.
  4. In the following YaST dialog "ISDN cards configuration" select the AVM ISDN-Controller C4 to be configured and click "Configure".
  5. In the "ISDN low-level configuration" window, insert both your "Areacode" and "Dialprefix".
  6. Confirm your entries by clicking "OK".
  7. Ignore the following warning and confirm the question "You accept this?" with "Yes".
  8. You may be required to install a number of packages after this; if so, follow the corresponding instructions on the screen.
  9. The subsequent configuration of the ISDN connection for KInternet is optional. Choose "Skip" and "Finish" to conclude the installation now if you wish to dial into the Internet using a dial-in script via the console. Corresponding example scripts are available in the "etc/ppp/peers/isdn" folder after installation of the controller.

Additional information regarding pppd and the script's usage can be found in the following section and in section Section 7, along with information on the CAPI 2.0 plug-in module for the "Generic PPP" stack (pppd). If you want to configure a connection using KInternet then choose the option "Add new SyncPPP network interface" from "ISDN Service Selection" under "Network services" and follow the instructions.

Additional information for hardware configuration can also be found in the SuSE documentation in the following folders:
/usr/share/doc/packages/susehelp
/usr/share/doc/packages/suselinux-adminguide_de/

All prerequisites for the installing the AVM ISDN-Controller using the AVM CAPI4Linux package in SuSE 8.1 have now been fulfilled. Now perform an installation by following the installation instructions below.

Back to 4.1.3

4.1.3.3 Installing the active AVM ISDN-Controller C4 with the CAPI4Linux Package in SuSE Linux 8.1

NOTE:

An installation with the CAPI4Linux package can be performed in SuSE 8.1 only when the AVM ISDN-Controller C4 was previously installed with YaST2 (be sure to read the sections 4.1.3.1 and 4.1.3.2).

  1. Make sure that the AVM C4 ISDN-Controller is connected to the ISDN line (see the manual).
  2. Copy the driver archive
    c4-susex.x-yy.yy.yy.tar.gz
    from the CAPI4Linux archive to your computer (e.g. from a diskette using the "mcopy" command from a console) and start the console (command prompt).
    Then extract the archive using the command
    tar -xzvf c4-susex.x-yy.yy.yy.tar.gz

    Example for the C4 in SuSE 8.1:
    tar -xzvf c4-suse8.1-03.09.11.tar.gz.
    A directory called "active" is created.
  3. Switch to the new directory "active".
  4. Run "./install" (Superuser rights are required).
  5. A successful installation of your AVM ISDN-Controller concludes with the message "The driver files have been updated. Reboot or restart the ISDN package in order to activate the changes... Ready." quittiert.
  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:
    -c4
    -capi
    -capifs
    -kernelcapi
    -capiutil

Upon conclusion of installation, perform a PING test of the installation. This checks whether installation was completed successfully. Establish a test connection to the AVM Data Call Center (ADC) in Berlin over the "pppd" (Point-to-point Protocol Daemon) module. This simulates dialing in to any ISP (Internet Service Provider) using PPP sync in accordance with RFC1618 over HDLC. The necessary parameters are pre-defined under the argument "AVM".

The number for the test server is ++49 30 39 98 43 20.

  1. Start a console (command prompt).
  2. Establish a pppd connection by entering the following command:
    pppd call isdn/avm
  3. If you are working at a PBX extension with outside dialing access "0", please enter the following command:
    pppd call isdn/avm numberprefix 0
    Once a test connection has been established, the output window contains among other information the ping transit time to the AVM server over your ISDN-Controller. This means that installation was successful. To access the AVM home page with a web browser (like Netscape) directly, the following command can also be used (DNS is assigned over the PPP connection):
    pppd call isdn/avm usepeerdns
    If you are working at a PBX extension with outside dialing access "0", please enter the following command:
    pppd call isdn/avm numberprefix 0 usepeerdns
  4. Enter the keyboard shortcut "Ctrl+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.

Back to 4.1.3

4.1.4 Installing the Active AVM ISDN-Controller C2 in SuSE Linux 8.1

NOTE:

The AVM CAPI4Linux package from the AVM server is required for the installation of the AVM ISDN-Controller C2 in SuSE Linux 8.1. An installation by means of YaST2 will not function without a system update. For more information about installing multiple controllers, please also see the information in section 4.1 and section 8.

4.1.4.1 Installing the AVM ISDN-Controller C2 in SuSE Linux 8.1 with YaST2 Without Updates Installed
4.1.4.2 Installing the active AVM ISDN-Controller C2 with the CAPI4Linux Package in SuSE Linux 8.1

Previous

4.1.4.1 Installing the AVM ISDN-Controller C2 in SuSE Linux 8.1 with YaST2 Without Updates Installed

NOTE:

If you have already performed an online update with the files i4l-base...rpm, i4l-isdnlog...rpm, i4lfirm...rpm, capi4linux...rpm, or with the update package "i4l-base (Basic Programs for ISDN Devices in Linux)" by means of YOU, perform a YaST2 installation as described up to step 9 here. Then continue with section 4.1.4.2.
  1. Insert the AVM C2 in your system and connect the ISDN-Controller to the ISDN socket (see the manual).
  2. After login, SuSE's hardware recognition announces "New hardware has been found! Configure the ISDN-Controller?" Confirm by clicking "Yes". If necessary start YaST2 manually (YaST2 Control Center) and select "ISDN configuration" in the "Network/Basic" menu.
  3. System administration rights (root privileges) are necessary for hardware configuration. If you are not already logged in as "root", i.e. as "Superuser", then you must provide the "root" password in the following dialog.
  4. In the following YaST dialog "ISDN cards configuration" select the AVM ISDN-Controller C2 to be configured and click "Configure".
  5. In the "ISDN low-level configuration" window, insert both your "Areacode" and "Dialprefix".
  6. Confirm your entries by clicking "OK".
  7. Ignore the subsequent warning that may appear and confirm the question "You accept this?" with "Yes".
  8. You may be required to install a number of packages after this; if so, follow the corresponding instructions on the screen.
  9. The subsequent configuration of the ISDN connection for KInternet is optional. You can select "Skip" and conclude the installation with "Finish". If you want to configure a connection using KInternet then choose the option "Add new SyncPPP network interface" from "ISDN Service Selection" under "Network services" and follow the instructions.

    NOTE:

    If you have already performed an online update with the files i4l-base...rpm, i4l-isdnlog...rpm, i4lfirm...rpm, capi4linux...rpm (ftp://ftp.suse.com/pub/suse/i386/update/8.1/rpm/i586/) or installed the update package "i4l-base (Basic Programs for ISDN Devices in Linux)" by means of YOU, continue with section 4.1.4.2.

  10. Enter the command "rcisdn stop" at the console.
  11. Then extract the AVM driver archive the c2 with the
    tar -xzvf c2-suse8.1-03.09.11.tar.gz
    A directory called "active" is created.
  12. Change to the new "active" directory.
  13. Enter the command "./install" (Superuser rights required).
  14. A successful installation of your AVM ISDN-Controller concludes with the message "The driver files have been updated. Reboot or restart the ISDN package in order to activate the changes... Ready."
  15. Do NOT restart your computer.
  16. Enter the following command: echo "" > /etc/capi.conf
  17. Run "capiinit start".
  18. Run "lsmod" to verify again that the CAPI modules were loaded.
  19. Enter "modprobe -v c4" to load the controller AVM C2.
  20. To find out which controller number the C2 was assigned, enter the command "cat /proc/capi/controller".
  21. To load the firmware of the controller, enter "avmcapictrl load /usr/lib/isdn/c2.bin 1" (1 representes the assigned controller number).
  22. Dial in to the Internet with the command "pppd". For a number of call-by-call providers, preconfigured dial-in scripts are located in the "/etc/ppp/peers/isdn" folder. These scripts can be adapted for other providers.

Establish a pppd connection with the following command (here with the example script Arcor, DNS is assigned over the PPP connection):
pppd call isdn/arcor usepeerdns

or, for extensions with outside dialing access "0":
pppd call isdn/arcor numberprefix 0 usepeerdns

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

  1. Start the YaST online update (YOU) and update YOU first, as prompted, and then the package manager.
  2. Then select at least the update package "i4l-base (Basic Programs for ISDN Devices in Linux)"
    (alternatively the packages -i4l-base...rpm, i4l-isdnlog...rpm, i4lfirm...rpm, capi4linux...rpm separately at ftp://ftp.suse.com/pub/suse/i386/update/8.1/rpm/i586 )
  3. Once the update is complete, you can restart the system.
  4. The CAPI 2.0 driver is initialized automatically. Then 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:
    -c4
    -capi
    -capifs
    -kernelcapi
    -capiutil

    After the system reboots the option of dialing in by K-Internet is available as well as the pppd dial-in.

Back to 4.1.4

4.1.4.2 Installing the active AVM ISDN-Controller C2 with the CAPI4Linux Package in SuSE Linux 8.1

NOTE:

A prerequisite for this installation method is an online update of the files i4l-base...rpm, i4l-isdnlog...rpm, i4lfirm...rpm, capi4linux...rpm or a YOU update of the "i4l-base (Basic Programs for ISDN Devices in Linux)" package, including steps 1 through 9 described in section 4.1.4.1.

  1. Copy the driver archive
    c2-susex.x-yy.yy.yy.tar.gz
    from the CAPI4Linux archive to your computer (e.g. from a diskette using the "mcopy" command from a console) and start the console (command prompt).
    Then extract the archive using the command
    tar -xzvf c2-susex.x-yy.yy.yy.tar.gz

    Example for the C2 in SuSE 8.1:
    tar -xzvf c2-suse8.1-03.09.11.tar.gz
    A directory called "active" is created.
  2. Switch to the new directory "active".
  3. Run "./install" (Superuser rights are required).
  4. A successful installation of your AVM ISDN-Controller concludes with the message "The driver files have been updated. Reboot or restart the ISDN package in order to activate the changes... Ready." quittiert.
  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:
    -c2
    -capi
    -capifs
    -kernelcapi
    -capiutil

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

  1. Start a console (command prompt).
  2. Establish a pppd connection by entering the following command:
    pppd call isdn/avm
  3. If you are working at a PBX extension with outside dialing access "0", please enter the following command:
    pppd call isdn/avm numberprefix 0
    Once a test connection has been established, the output window contains among other information the ping transit time to the AVM server over your ISDN-Controller. This means that installation was successful. To access the AVM home page with a web browser (like Netscape) directly, the following command can also be used (DNS is assigned over the PPP connection):
    pppd call isdn/avm usepeerdns
  4. 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
  5. Enter the keyboard shortcut "Ctrl+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.

Back to 4.1.4

4.1.5 Installing the Active AVM ISDN-Controller T1/T1-B in SuSE Linux 8.1 or Higher

NOTE:

The AVM CAPI4Linux package from the AVM server is required for the installation of the AVM ISDN-Controller T1/T1-B in SuSE Linux 8.1. An installation by means of YaST2 will not function. For more information about installing multiple controllers, please also see the information in section 4.1 and section 8.

Installation of the AVM ISDN-Controller T1/T1-B does not differ from the installation in SuSE 8.0. Please continue by following the instructions in section 4.2.6.

Previous

4.2 Installations for Active AVM ISDN-Controllers in SuSE 8.0 or Lower

The following section describes the installation of active AVM ISDN-Controllers in systems with SuSE 8.0 or lower. Read the section that describes the installation of your controller.

AVM ISDN-Controller B1 PCI / B1 PCI v4.0
AVM ISDN-Controller B1 (B1 v1.4 / v2.0 / v3.0 (ISA))
AVM ISDN-Controller B1 PCMCIA
AVM ISDN-Controller C4
AVM ISDN-Controller C2
AVM ISDN-Controller T1 and T1-B

Previous

4.2.1 Installing the AVM ISDN-Controller B1 PCI and B1 PCI v4.0

Operating system

Version: 03.10.02
Build: 02.09.27

Installation requirements:

ATTENTION:

If different active AVM ISDN-Controllers are installed (for example, AVM ISDN-Controller C2 together with ISDN-Controller C4 or ISDN-Controller C2 together with ISDN-Controller B1), please see section 8.

The driver can be used for both the ISDN-Controller B1 PCI and the ISDN-Controller B1 PCI v4.0. The special features of the B1 PCI v4.0 like PCI Busmaster DMA are automatically recognized and enabled by this driver. This is also true, of course, for combined operation with different active AVM ISDN-Controllers.

(1) Copy the archive "b1-suseX.X-YY.YY.YY.tar.gz" from the CAPI4Linux archive to your computer For instance, from a diskette by typing the command "mcopy" at the console. Start a console (command prompt). Extract the archive with the command:

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

Example for SuSE 8.0:

tar -xzvf b1-SuSE8.0-03.10.02.tar.gz

A directory called "active" is created.

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

(3) Run "./install b1pci". If no options for special protocol variants were specified (see 3a), a succession of selection menus now appears. In these dialogs, make the selections for:

Your entries are automatically registered under the relevant controller type "b1pci" in the "/etc/capi.conf" file.

(3a) As an alternative to menu-controlled installation, you can install the controller also directly from the command prompt. The following options can be used:

./install b1pci -dss1

D-channel protocol DSS1 [EURO-ISDN]

./install b1pci -1tr6

D-channel protocol 1TR6 [former national German protocol]

./install b1pci -ni1

D-channel protocol NI1 [National ISDN 1 / USA]

./install b1pci -ddi

ISDN DDI line [Direct Dial-In, DSS1]

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

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

(1) Start a console (command prompt).

Establish a pppd connection with the following command:

pppd call isdn/avm

or, for extensions with outside dialing access "0":

pppd call isdn/avm numberprefix 0

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

pppd call isdn/avm usepeerdns

or, for extensions with outside dialing access "0":

pppd call isdn/avm numberprefix 0 usepeerdns

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

Previous

4.2.2 Installing the AVM ISDN-Controller B1

Operating system

Version: 03.10.02
Build: 02.09.27

Installation requirements:

ATTENTION:

If different active AVM ISDN-Controllers are installed (for example, AVM ISDN-Controller C2 together with ISDN-Controller C4 or ISDN-Controller C2 together with ISDN-Controller B1), please see section 8.

The driver can be used for all AVM ISDN-Controllers B1 for the ISA/EISA bus. The special features of the individual models like Fax G3 at up to 14,400 bit/s with the B1 v2.0/v3.0 are automatically recognized and enabled by the driver. This is also true, of course, for combined operation with different active AVM ISDN-Controllers.

(1) Copy the archive "b1-suseX.X-YY.YY.YY.tar.gz" from the CAPI4Linux archive to your computer For instance, from a diskette by typing the command "mcopy" at the console. Start a console (command prompt). Extract the archive with the command

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

Example for SuSE 8.0:
tar -xzvf b1-SuSE8.0-03.10.02.tar.gz

A directory called "active" is created.

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

The I/O address required by the ISDN-Controller B1 is set by jumper on the controller such that conflicts with other hardware extensions should be avoided. The ISDN-Controller B1 can use the following I/O addresses:

How Can I Find Out Which Resources on My Computer Can Be Used for the ISDN-Controller B1?

Assistance is provided in the following files, which list all *occupied* resources resp. list the resources used by other drivers:

These list contain all *occupied* resources by listing the resources used by other drivers. These lists are not exhaustive, i.e., some resources *not* listed in these files may also be occupied!

When trying out values for the I/O port and IRQ, always monitor the driver outputs in the system log when the system is started. If loading of a driver is not successful, corresponding error messages will be returned there.

Once you have identified a free I/O port and a free IRQ, the selected I/O address also must be set by means of the jumper on the AVM ISDN-Controller B1. The IRQ is set automatically by the software driver. Please make a note of these values, as they will be required in step (4).

(3) Now insert the AVM ISDN-Controller B1 into a free ISA slot. Be sure to position the jumper correctly according to the instructions in step 2.

(4) Switch to the new "active" directory and start the installation program by entering "./install b1isa" at the console. If no options for special protocol variants were specified (see 4a), a succession of selection menus now appears. In these dialogs, make the selections for:

Your entries are automatically registered under the relevant controller type "b1isa" in the "/etc/capi.conf" file.

(4a) As an alternative to menu-controlled installation, you can install the controller also directly from the command prompt. The following options can be used:

./install b1isa -dss1

D-channel protocol DSS1 [EURO-ISDN]

./install b1isa -1tr6

D-channel protocol 1TR6 [former national German protocol]

./install b1isa -ni1

D-channel protocol NI1 [National ISDN 1 / USA]

./install b1isa -ddi

ISDN DDI line [Direct Dial-In, DSS1]

The value for the I/O address, i.e. the entry in the "/etc/capi.conf" file, and the position of the jumper on the controller must always be identical.

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

When installation is concluded, you can perform a ping test of the installation. For this purpose a test connection to the AVM Data Call Center (ADC) in Berlin is established over the "pppd" module. This simulates dialing in to any ISP (Internet Service Provider) using PPP sync in accordance with RFC1618 over HDLC. The necessary parameters are pre-defined under the argument "AVM". The number for the test server is ++49 30 39 98 43 20.

(1) Start a console (command prompt)

Establish a pppd connection with the following command:

pppd call isdn/avm

or, for extensions with outside dialing access "0":

pppd call isdn/avm numberprefix 0

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

pppd call isdn/avm usepeerdns

or, for extensions with outside dialing access "0":

pppd call isdn/avm numberprefix 0 usepeerdns

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

Previous

4.2.3 Installing the AVM ISDN-Controller B1 PCMCIA

Operating system

Version: 03.10.02
Build: 02.09.27

Installation requirements:

ATTENTION:

If different active AVM ISDN-Controllers are installed (for example, AVM ISDN-Controller C2 together with ISDN-Controller C4 or ISDN-Controller C2 together with ISDN-Controller B1), please see section 8.

Preparation for PCMCIA Ability

Install the "external PCMCIA package", in SuSE 8.0, for example, containing the packages "pcmcia-3.1.31" and "pcmcia-cardinfo-3.10.31", from the SuSE CD-ROM. After the installation of these packages, set the variable "PCMCIA_SYSTEM" in the file "/etc/sysconfig/pcmcia" to "external". If not yet listed, enter in the variable "PCMCIA_PCIC" the type of PCMCIA controller (see also the following comprehensive comments). Determine the PCMCIA controller hardware (chip set of the existing PCMCIA controller) by running the "probe" program:

/sbin/probe

Start the package with the command "rcpcmcia start". If the package does not start, restart your computer.

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

Extract the archive with the command

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

Example for SuSE 8.0:

tar -xzvf b1-SuSE8.0-03.10.02.tar.gz

A directory called "active" is created.

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

NOTE:

For SuSE Linux 7.2 or higher, the subsequent installation is the same as for a B1 PCI installation, since the allocated resources of the PCMCIA card are detected automatically. In this case, slide the card into the PCMCIA slot and proceed with step (2) in paragraph 4.2.1 as you would for the installation of a PCI card ("./install b1pcmcia").

Previous

4.2.4 Installing the AVM ISDN-Controller C4

Operating system

Version: 03.09.11
Build: 02.09.27

Installation requirements:

ATTENTION:

If different active AVM ISDN-Controllers are installed (for example, AVM ISDN-Controller C2 together with ISDN-Controller C4 or ISDN-Controller C2 together with ISDN-Controller B1), please see section 8.

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

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

Example for SuSE 8.0:

tar -xzvf c4-SuSE8.0-03.09.11.tar.gz

A directory called "active" is created.

(2) Switch to this new directory "active".

(3) Start the installation by entering "./install c4". If no options for special protocol variants were specified (see 3a), a succession of selection menus now appears. The only ISDN D-channel protocol available is DSS-1 [EURO-ISDN].

You can either configure all S0 ports (=controller numbers) of the ISDN-Controller C4 together (default setting), or individually, if desired. In either case, one of the two possible line types can be selected:

Select the line type for the configuration used on your ISDN line. The logical controller numbers are assigned to the ISDN-Controllers physically connected to the S0 ports as illustrated in the sketch below. The horizontal line represents the screw plate of the plug-in card. Any other ISDN-Controller B1, ISDN-Controller C2 or ISDN-Controller C4 installed then receives the logical controller number 5 for its first S0 port, 6 for the second, and so on. This is especially important for the configuration of CAPI applications (like CAPI4HylaFAX) when using multiple active AVM ISDN-Controllers. The exact designation of the four S0 ports on the blanking plate of the AVM ISDN-Controller C4 is described in the manual.

The resources required for the controller are determined from the PCI BIOS of the computer (Plug-and-Play). Your entries are automatically registered under the relevant controller type "c4" in the "/etc/capi.conf" file.

(3a) As an alternative to menu-controlled installation, you can install the controller also directly from the command prompt. The following options can be used:

./install c4 -dss1

D-channel protocol DSS1 [EURO-ISDN]

./install c4 -ddi1

DDI line (DSS1) on controller number 1

./install c4 -ddi2

DDI line (DSS1) on controller number 2

./install c4 -ddi3

DDI line (DSS1) on controller number 3

./install c4 -ddi4

DDI line (DSS1) on controller number 4

./install c4 -ddi

DDI line (DSS1) for all controller numbers

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

As an installation test, perform a PING test over the first S0 port/Controller 1 of the ISDN-Controller C4. For more information, see the manual and section 7 of this document. This checks whether installation was completed successfully. Establish a test connection to the AVM Data Call Center (ADC) in Berlin over the "pppd" (Point-to-point Protocol Daemon) module. This simulates dialing in to any ISP (Internet Service Provider) using PPP sync in accordance with RFC1618 over HDLC. The necessary parameters are pre-defined under the argument "AVM". The number for the test server is ++49 30 39 98 43 20.

(1) Start a console (command prompt).

Establish a pppd connection with the following command:

pppd call isdn/avm

or, for extensions with outside dialing access "0":

pppd call isdn/avm numberprefix 0

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

pppd call isdn/avm usepeerdns

or, for extensions with outside dialing access "0":

pppd call isdn/avm numberprefix 0 usepeerdns

Additional options of the CAPI 2.0 plug-in module (for example, GSM dial-in) for the "Generic PPP" stack (pppd) are described in section 7.

Previous

4.2.5 Installing the AVM ISDN-Controller C2

Operating system

Version: 03.09.11
Build: 02.09.27

Installation requirements:

ATTENTION:

If different active AVM ISDN-Controllers are installed (for example, AVM ISDN-Controller C2 together with ISDN-Controller C4 or ISDN-Controller C2 together with ISDN-Controller B1), please see section 8.

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

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

Example for SuSE 8.0:

tar -xzvf c2-SuSE8.0-03.09.11.tar.gz

A directory called "active" is created.

(2) Switch to this new directory "active".

(3) Start the installation by entering "./install c2". If no options for special protocol variants were specified (see 3a), a succession of selection menus now appears. The only ISDN D-channel protocol available is DSS-1 [EURO-ISDN]. You can either configure all S0 ports (=controller numbers) of the AVM C2 together (default setting), or individually, if desired. In either case, one of the two possible line types can be selected:

Select the line type for the configuration used on your ISDN line. The logical controller numbers are assigned to the ISDN-Controllers physically connected to the S0 ports as illustrated in the sketch below. The horizontal line represents the screw plate of the plug-in card. Any other ISDN-Controller B1, ISDN-Controller C2 or ISDN-Controller C4 installed then receives the logical controller number 3 for its first S0 port, 4 for the second, and so on. This is especially important for the configuration of CAPI applications (like CAPI4HylaFAX) when using multiple active AVM ISDN-Controllers. The exact designation of the two S0 ports on the blanking plate is described in the manual.

The resources required for the controller are determined from the PCI BIOS of the computer (Plug-and-Play). Your entries are automatically registered under the relevant controller type "c2" in the "/etc/capi.conf" file.

(3a) As an alternative to menu-controlled installation, you can install the controller also directly from the command prompt. The following options can be used:

./install c2 -dss1

D-channel protocol DSS1 [EURO-ISDN]

./install c2 -ddi1

DDI line (DSS1) on controller number 1

./install c2 -ddi2

DDI line (DSS1) on controller number 2

./install c2 -ddi

DDI line (DSS1) for all controller numbers

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

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

(1) Start a console (command prompt).

Establish a pppd connection with the following command:

pppd call isdn/avm

or, for extensions with outside dialing access "0":

pppd call isdn/avm numberprefix 0

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

pppd call isdn/avm usepeerdns

or, for extensions with outside dialing access "0":

pppd call isdn/avm numberprefix 0 usepeerdns

Additional options of the CAPI 2.0 plug-in module (for example, GSM dial-in) for the "Generic PPP" stack (pppd) are described in section 7.

Previous

4.2.6 Installing the AVM ISDN-Controller T1 and T1-B

Operating system

Version: 03.09.07
Build: 02.09.27

Installation requirements:

Installation of the two AVM ISDN-Controllers T1 and T1-B is identical. The only difference is that T1 and T1-B are initialized by different firmware files (T1.T4) in order to use the special features of the T1-B such as DTMF. For more details, see the manual of the ISDN-Controller in question.

Both ISDN-Controllers can be obtained in combination with two different T1 link adapters (T1 LA). These link adapters constitute the link between the ISDN-Controller T1 and the host PC and are available in PCI and ISA versions. The installation procedures are thus slightly different. Each of the driver archives contains the drivers required for all versions of the controller (T1 / T1-B) and also for both T1 LA versions (PCI and ISA).

Install the ISDN-Controller in a free slot. Read the manual for more information. In the case of the PCI link adapter, make sure to use a busmaster-capable PCI slot. For detail, see the manual for your computer or motherboard.

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

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

Example for SuSE 8.0:

tar -xzvf t1-SuSE8.0-03.09.07.tar.gz

A directory called "active" is created.

(2) Switch to this new directory "active".

(3) Start the installation program (according to the ISDN-Controller used) by entering

./install t1pci

for AVM ISDN-Controller T1 with PCI link adapter

./install t1bpci

for AVM ISDN-Controller T1-B with PCI link adapter

./install t1isa

for AVM ISDN-Controller T1 with ISA link adapter

./install t1bisa

for AVM ISDN-Controller T1-B with ISA link adapter

If no options for special protocol variants were specified (see 3a), a succession of selection menus now appears. Depending on the link adapter used, continue with step (3b) or (3c).

(3a) As an alternative to menu-controlled installation, you can install the controller also directly from the command prompt. The following options can be used:

./install t1pci -dss1

for AVM ISDN-Controller T1 with PCI link adapter and DSS1 [EURO-ISDN]

./install t1pci -1tr6

for AVM ISDN-Controller T1 with PCI link adapter and 1TR6 [former national German protocol]

./install t1isa -dss1

for AVM ISDN-Controller T1 with ISA link adapter and DSS1 [EURO-ISDN]

./install t1isa -1tr6

for AVM ISDN-Controller T1 with ISA link adapter and 1TR6 [former national German protocol]

./install t1bpci -dss1

for AVM ISDN-Controller T1-B with PCI link adapter and DSS1 [EURO-ISDN]

./install t1bpci -1tr6

for AVM ISDN-Controller T1-B with PCI link adapter and 1TR6 [former national German protocol]

./install t1bisa -dss1

for AVM ISDN-Controller T1-B with ISA link adapter and DSS1 [EURO-ISDN]

./install t1bisa -1tr6

for AVM ISDN-Controller T1-B with ISA link adapter and 1TR6 [former national German protocol]

(3b) Installation for ISDN-Controller with PCI link adapter

Make the appropriate selections for the D-channel protocol used on your ISDN line: E-DSS1 [EURO-ISDN] or 1TR6 (former German D-channel protocol)

The resources required for the controller are determined from the PCI BIOS of the computer (Plug-and-Play). Your entries are automatically registered under the relevant controller type "t1pci" or "t1bpci" in the "/etc/capi.conf" file.

(3c) Installation for ISDN-Controller with ISA link adapter

Because the T1 / T1-B link adapter (LA) is not a Plug&Play card, you must determine manually whether the necessary resources (free I/O address, free IRQ) are occupied by other hardware extensions. The driver software is set by default to use the resources "I/O address 150" and "IRQ 5". The ISA link adapter can use the following I/O addresses:

How Can I Find out Which Resources on My Computer Can Be Used for T1/T1-B LA?

Assistance is provided in the following files, which list all *occupied* resources resp. list the resources used by other drivers:

These list contain all *occupied* resources by listing the resources used by other drivers. ATTENTION: These lists are not exhaustive, i.e., some resources *not* listed in these files may also be occupied!

When trying out values for the I/O port and IRQ, always monitor the driver outputs in the system log when the system is started. If loading of a driver is not successful, corresponding error messages will be returned there.

Once you have identified a free I/O port and a free IRQ, use this information for the remaining installation steps.

In these dialogs, make the selections for:

Your entries are automatically registered under the relevant controller type "t1isa" or "t1bisa" in the "/etc/capi.conf" file.

NOTE:

If more than one ISA link adapter is to be used in the system, each link adapter must be assigned its own card ID through the SW1 jumper. For detailed information, see the ISDN-Controller T1/T1-B manual. A corresponding entry with the selected card ID must also be set in the "cardnr" column for the relevant AVM T1/T1-B controller in the "/etc/capi.conf" file!

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

When installation is concluded, you can perform a ping test of the installation. For this purpose a test connection to the AVM Data Call Center (ADC) in Berlin is established over the "pppd" module. This simulates dialing in to any ISP (Internet Service Provider) using PPP sync in accordance with RFC1618 over HDLC. The necessary parameters are pre-defined under the argument "AVM". The number for the test server is ++49 30 39 98 43 20.

(1) Start a console (command prompt).

Establish a pppd connection with the following command:

pppd call isdn/avm

or, for extensions with outside dialing access "0":

pppd call isdn/avm numberprefix 0

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

pppd call isdn/avm usepeerdns

or, for extensions with outside dialing access "0":

pppd call isdn/avm numberprefix 0 usepeerdns

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

Previous

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

Thanks to the open concept of Linux, all current distribution can be used with the software. Manual installation in these distributions must be adapted individually depending on the components installed (e.g. supplementary PCMCIA modules required, etc.). All driver components required to integrate the software, including source code and short instructions (the file "compile.en" or "compile-help-english.txt"), are supplied in the "fritz" directory of the respective driver archive. The binary-only modules contained in the drivers are kernel-independent. They cannot perform any direct kernel calls. This means that they can be integrated into any Linux kernel. The CAPI4Linux packages SuSE 8.1 and higher are already compatible with gcc 3.x. See section 10 for useful links.

Previous

6 Removing the Controller / Updating the Drivers

The procedure required to remove or update the CAPI 2.0 driver software is identical for all internal ISDN-Controllers and for the AVM ISDN-Controller for the PCMCIA bus. USB devices load or unload the driver software dynamically when they are plugged into or out of the USB socket. Since the AVM ISDN-Controller in SuSE 8.1 is installed with YaST2, you have to remove the controller with YaST2. In all other SuSE Linux versions, please proceed as described in section 6.2 to remove your AVM ISDN-Controller manually.

Previous

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

Previous

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 your computer. This completes the removal of your controller.

Previous

7 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 ISDN-Controller driver and can be started with additional options if desired. This makes sense, for instance, when the charges for your online costs are to be billed separately by setting signaling of an outgoing number from the number block of MSNs. You may also choose between different protocols (analog modem for C2/C4, etc.) for different remote sites. A complete description of the CAPI 2.0 plug-in module for pppd is included as a UNIX manual page and can be viewed on the console by entering the command:

man capiplugin

A number of already pre-configured dial-in scripts for various call-by-call providers are included in delivery. In order to establish a connection to T-Online, for instance, a suitable dial-in script called "/etc/ppp/peers/isdn/t-online" should be configured as follows:

----- start -----

debug

sync

noauth

plugin /etc/ppp/plugins/userpass.so

username 11111\#22222\#0001\#@t-online.de

password 3333333

defaultroute

plugin /etc/ppp/plugins/capiplugin.so

number 0191011

protocol hdlc

ipcp-accept-local

ipcp-accept-remote

/dev/null

----- end -----

Enter the following parameter:

11111: max 12-digit connection ID

22222: max 12-digit T-Online number 0001: co-user

33333: password

ATTENTION:

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

Previous

8 Information about Installing Multiple Active AVM ISDN-Controllers

A maximum of up to four active AVM ISDN-Controllers are supported per system or server. Any mixed configuration can be installed using any of the supported bus systems ISA, PCI, PCMCIA and USB. It is not possible to install a mixed configuration of passive AVM ISDN-Controllers (such as FRITZ!Card) and active AVM ISDN-Controllers.

To install an additional active AVM ISDN-Controller, simply perform the installation for the desired controller again. Each single ISDN-Controller can be set to an individual configuration, such as different D-channel protocols and line types (P2P / P2M). In the case of an AVM ISDN-Controller C4 (4BRI), the logical controller is comprised of four individual CAPI controllers (1 through 4) with two B channels each, although these "controllers" are physically combined on one plug-in card. If another controller is added, for instance, a AVM ISDN-Controller B1, this controller then can be addressed by an application as CAPI controller number 5.

The same applies for the ISDN-Controller C2. If a mixed installation of an ISDN-Controller C4 together with an ISDN-Controller 2 is installed, please install the ISDN-Controller C4 first to ensure the correct CAPI controller numbers assignment (CAPI controller numbers 1 through 4 on the C4, 5 through 6 on the C2).

An example of a modified "/etc/capi.conf" file for a mixed installation of different controllers:

# card

file

proto

io

irq

mem

cardnr

options

#

 

 

 

 

 

 

 

c4

c4.bin

DSS1

- - - -

- - - -

- - - -

- - - -

- - - -

c4

- - - -

DSS1

- - - -

- - - -

- - - -

- - - -

- - - -

c4

- - - - -

DSS1

- - - -

- - - -

- - - -

- - - -

- - - -

c4

- - - - -

DSS1

- - - -

- - - -

- - - -

- - - -

- - - -

c2

c2.bin

DSS1

- - - -

- - - -

- - - -

- - - -

- - - -

c2

- - - - -

DSS1

- - - -

- - - -

- - - -

- - - -

- - - -

When the installation program is run, all of the options specified in the command line for all CAPI controllers on the card, i.e., the four lines in the "/etc/capi.conf" file, have the same structure.

For instance, to set two of the four controllers of the ISDN-Controller C4 to an Point-to-Point (P2P) line, simply change the "/etc/capi.conf" file manually. The same is true for multiple ISDN-Controllers B1 and B1 PCI.

An example of a modified "/etc/capi.conf":

# card

file

proto

io

irq

mem

cardnr

options

#

 

 

 

 

 

 

 

# b1pci

b1.t4

DSS1

- - - -

- - - -

- - - -

- - - -

 

c4

c4.bin

DSS1

- - - -

- - - -

- - - -

- - - -

 

c4

- - - -

DSS1

- - - -

- - - -

- - - -

- - - -

 

c4

- - - -

DSS1

- - - -

- - - -

- - - -

- - - -

PPP

c4

- - - -

DSS1

- - - -

- - - -

- - - -

- - - -

PPP

In the above example, the first two ISDN-controllers of the ISDN-Controller C4 are set to the ISDN Point-to-Multipoint line, while the remaining two ISDN-Controllers use the Point-to-Point protocol.

When installing multiple ISDN-Controllers, always be sure to avoid any resource conflicts in your system. The CAPI4Linux drivers support IRQ sharing in accordance with the PCI 2.x Spec. as a matter of course. This means that the IRQs required by the AVM ISDN-Controllers for the PCI bus (!) can be used multiple times, thus preventing resource conflicts.

It must be possible to configure CAPI applications accordingly for the use of an nth CAPI controller. The CAPI4HylaFAX module and the pppd plug-in support this feature.

Previous

9 Help Programs

The CAPI4Linux driver package contains a number of help programs which present additional information about the technical features of the CAPI 2.0 drivers and offer diagnosis options.

Note The help programs capiinit stop, capiinit start und capiinit show are valid only for SuSE Linux 8.0 and below.

Command:

option:

Meaning

capiinit

stop

Stops the CAPI driver manually.

 

start

Starts the CAPI driver manually.
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.

 

show

The output contains the name of the driver used, the firmware module, occupied resources and selected protocol options (P2P).

capiinfo

 

Shows additional information about the capabilities of the CAPI 2.0 driver.
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.

cat /proc/capi/controller

 

Shows information including the logical controller numbers of all installed ISDN-Controllers in accordance with CAPI 2.0.

cat /proc/capi/controllers/<n>

 

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

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

man capiinfo

Previous

9.1 ISDN Monitor "K ISDN Watch" for KDE

AVM provides with the CAPI 2.0 application "K ISDN Watch" a powerful monitoring tool for all AVM ISDN-Controllers supported by CAPI4Linux. The ISDN Monitor "K ISDN Watch" is subject to the GPL, is based on "kimon" and can be translated for KDE . The application can be downloaded from: ftp.avm.de/tools/k_isdn_watch.linux

Previous

10 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:comp.os.linux.networking or news:comp.dcom.isdn.capi

(2) Useful discussions of ISDN and Linux issues can be found at:

news:comp.dcom.isdn

(3) FAQs

(4) Mailing List / ftp Server

The Linux drivers for active AVM ISDN-Controllers originally were developed by Carsten Paeth ("Calle"). The "CAPI4Linux" model for active AVM ISDN-Controllers is based on these developments. Typical development issues continue to be discussed on this mailing list.

The mailing list is located at:
linux-avmb1@calle.in-berlin.de

To subscribe to the mailing list:

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

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

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

This site provides patches developed independently of AVM for a number of special implementations. CAPI 2.0 demo programs currently stored here include (capiconn-xxxx-yy-zz.tar.gz):

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

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

http://www.scorrano.de

(7) FRITZ!Card PCI v2.0 in RedHat 7.1 mini HowTo:

http://lauer.monweb.lu/howtos/FRITZ!PCI_RH71_HowTo.html

11 AVM Support

AVM offers e-mail support for this product. This support is limited to the actual installation and the ISDN functionality up to the successful completion of the test connection or the test fax of over CAPI 2.0 drivers and the CAPI4HylaFAX module in combination with AVM ISDN-Controllers using the provided installation programs.

For questions about network configuration, integrated functions of the operating system Linux and applications from other manufacturers, please contact the relevant manufacturer or the support service of the distribution used. Please address your questions concerning configuration and operation of HylaFAX to www.hylafax.org.

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

Products:

The "Products" category provides detailed information about all AVM products as well as announcements of new products and product versions.

Service

Through "Service" the FAQs (Frequently Asked Questions) can be accessed along with a list of their answers. Solutions to concrete problems are offered here.

Download

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.

Previous

EOF

SAS; 02/2003