Welcome to CAPI4Linux for active AVM ISDN-Controllers!

This document contains

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 the AVM ISDN-Controller B1 PCI / B1 PCI v4.0

4.2 Installing the AVM ISDN-Controller B1

4.3 Installing the AVM ISDN-Controller B1 PCMCIA

4.4 Installing the AVM ISDN-Controller C4

4.5 Installing the AVM ISDN-Controller C2

4.6 Installing the AVM ISDN-Controller T1 / T1-B

5 Removing the Controller / Updating the Drivers

6 Information about the CAPI 2.0 plug-in module for the "Generic PPP" stack (pppd)

7 Information about Installing Multiple Active AVM ISDN-Controllers

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

9 Further Information Sources

10 AVM Support

APPENDIX: Special Instructions for SUSE 6.3

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.

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. 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 Which AVM ISDN-Controllers Are Currently Supported by CAPI4Linux?

CAPI4Linux currently supports the following AVM ISDN-Controllers and ADSL/ISDN-Controllers:

Passive ISDN-Controllers

Active ISDN-Controllers

NOTE:

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

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 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, in principle any 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 maintenance state (EOM)", i.e., these older versions are no longer supported with 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.

Manual installation in other 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, are supplied in the \src directory of the respective driver archive. The firmware modules contained in the drivers (e.g. B1.T4) are kernel-independent. They cannot perform any direct kernel calls. This means that they can be integrated into any Linux kernel.

It is not necessary to install the ISDN4Linux package (I4L) first. To continue using features and interfaces provided by ISDN4Linux, such as ippp, tty ports parallel to CAPI and pppd, see the additional configuration information in the Service/FAQ area of the AVM home page http://www.avm.de/de/Service/FAQs/Linux/index.html. Unfortunately, this site is in German. 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.

4 Installing CAPI4Linux in SuSE Linux Distributions

4.1 Installing the AVM ISDN-Controller B1 PCI / B1 PCI v4.0

Operating system:

Version: 03.10.02
Build: 02.09.27

Installation requirements:

ATTENTION:

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

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

(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 you select the following:

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

ATTENTION:

In SuSE 6.3, please see the "Special Instructions" section.

(1) Start a console (command prompt).

(2) Establish a pppd connection by entering 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 6.

4.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 (for example, ISDN-Controller C2 together with ISDN-Controller C4 or ISDN-Controller C2 together with ISDN-Controller B1) are installed, please see section 7.

The driver can be used for all AVM ISDN-Controllers B1 for the ISA/EISA bus. The special features of the individual models like FaxG3 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 (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) 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:

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 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 you select the following:

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:

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 "Special Instructions" section.

(1) Start a console (command prompt)

(2) Establish a pppd connection by entering 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 6.0.

4.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 (for example, ISDN-Controller C2 together with ISDN-Controller C4 or ISDN-Controller C2 together with ISDN-Controller B1) are installed, please see section 7.

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:

If you are to perform the installation in SuSE 7.1 or earlier, please follow the instructions below. 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.1 as you would for the installation of a PCI card ("./install b1pcmcia").

(3) Start the installation by entering "./install b1pcmcia".

If no options for special protocol variants were specified (see 3a), a succession of selection menus now appears. In these dialogs you select the following:

Your entries are automatically registered under the relevant controller type "b1pcmcia" 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 b1pcmcia -dss1

D-channel protocol DSS1 [EURO-ISDN]

./install b1pcmcia -1tr6

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

./install b1pcmcia -ni1

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

./install b1pcmcia -ddi

ISDN DDI line [Direct Dial-In, DSS1]

(4) Determine the PCMCIA controller hardware (chip set of the existing PCMCIA controller).

Run the "probe" program by entering the following command:

/usr/sbin/probe

As a result, the PCMCIA controller chip used in your system is returned, e.g., i82365. Make a note of this output.

(4a) Register the PCMCIA hardware used. Open the file "/etc/rc.config" in an editor and enter the following:

Variable START_PCMCIA="yes"

Variable PCMCIA=...(enter the PCMCIA controller chip from step (4), "i82365" or "tcic")

If necessary, enter also the following:

Variable PCMCIA_PCIC_OPTS=... (read also supplementary information by entering: man i82365 / man tcic)

Variable PCMCIA_PCIC_OPTS=... (read also supplementary information by entering: man pcmcia_core or PCMCIA-HOWTO)

(4b) Add to 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 "/etc/pcmcia/config" in an editor and add the following behind the last "card ..." entry:

device "avm_cs"

class "avm" module "avm_cs"

card "AVM ISDN-Controller B1"

version "AVM", "ISDN-Controller B1" bind "avm_cs"

(4c) Activate the AVM ISDN-Controller B1 PCMCIA by opening the "/etc/capi.conf" file and remove the comment character "#" preceding the "b1pcmcia" entry.

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

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 "Special Instructions" section.

(1) Start a console (command prompt).

(2) Establish a pppd connection by entering 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 6.0.

4.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 (for example, ISDN-Controller C2 together with ISDN-Controller C4 or ISDN-Controller C2 together with ISDN-Controller B1) are installed, please see section 7.

(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 AVM 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 physical S0 ports as portrayed in the figure below, where the horizontal line at the top of the diagram represents the position of the screw. Any additional 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, etc. This is particularly important to note when CAPI applications (e.g. CAPI4HylaFAX) are configured for use of 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 required resources of the controller are determined from the PCI-BIOS of the computer (PnP). 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 at the conclusion of installation over the first S0 port/Controller 1 of the AVM ISDN-Controller C4 to check whether the software has been installed correctly (see also the manual and section 6 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 of the test server is ++49 30 39 98 43 20.

ATTENTION:

In SuSE 6.3, please see the "Special Instructions" section.

(1) Start a console (command prompt).

(2) Establish a pppd connection by entering 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 6.0.

4.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 (for example, ISDN-Controller C2 together with ISDN-Controller C4 or ISDN-Controller C2 together with ISDN-Controller B1) are installed, please see section 7.

(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 physical S0 ports as portrayed in the figure below, where the horizontal line at the top of the diagram represents the position of the screw. Any additional 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, etc. This is particularly important to note when CAPI applications (e.g. CAPI4HylaFAX) are configured for use of multiple active AVM ISDN-Controllers. The exact designation of the two S0 ports on the blanking plate of the AVM ISDN-Controller C2 is described in the manual.

The required resources of the controller are determined from the PCI-BIOS of the computer (PnP). 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 6 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 of the test server is ++49 30 39 98 43 20.

ATTENTION:

In SuSE 6.3, please see the "Special Instructions" section.

(1) Start a console (command prompt)

(2) Establish a pppd connection by entering 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 6.0.

4.6 Installing the AVM ISDN-Controller T1 / 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 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, as described in the manual. In the case of the PCI LA, 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 required resources of the controller are determined from the PCI-BIOS of the computer (PnP). 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 you select the following:

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 details, see the AVM 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:

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 "Special Instructions" section.

(1) Start a console (command prompt).

(2) Establish a pppd connection by entering 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 6.0.

5 Removing the Controller / Updating the Drivers

The required procedures are the identical for removing and updating the CAPI 2.0 driver software. For an update, simply start the new version of the CAPI 2.0 driver software after removing the previously used driver software. Proceed as follows:

(1) Exit all CAPI applications. If a PCMCIA controller is installed, remove the AVM ISDN-Controller from the PCMCIA slot.

(2) Open the console and enter "capiinit stop".

(3) Deactivate the AVM ISDN-Controller entry in the "/etc/capi.conf" file by entering a "#". If you want to perform an update, you may start now. Skip the next two steps.

(4) Shut down the computer and then remove the controller.

(5) Restart the computer. The controller is now uninstalled.

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

7 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 AVM ISDN-Controller C2. If a mixed installation of an ISDN-Controller C2 together with an ISDN-Controller C4 is installed, please install the ISDN-Controller C4 first to ensure the correct CAPI controller numbers assignment (CAPI controller number 1 to 4 on C4, 5 to 6 on 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 CAPI controllers of the AVM ISDN-Controller C4 to an Point-to-Point (P2P) line, simply change the "/etc/capi.conf" file manually. The same is true for multiple AVM ISDN-Controllers B1 / 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

- - - -

- - - -

- - - -

- - - -

P2P

c4

- - - -

DSS1

- - - -

- - - -

- - - -

- - - -

P2P

In the above example, the first two controllers of the AVM ISDN-Controller C4 are set to the ISDN Point-to-Multipoint line, while the remaining two 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 Specification 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.

8 Help Program

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:

option:

Definition

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 capi

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

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 2.x. The application can be downloaded from:

ftp://ftp.avm.de/tools/k_isdn_watch.linux

9 Further Information Sources

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

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

(3) FAQs

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

(4) Mailing List / ftp Server
The Linux drivers for active AVM ISDN-Controllers originally were developed by Carsten Paeth ("Calle"). The "CAPI4Linux" model for active AVM ISDN-Controllers is based on these developments. 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 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. The site is located at:
You find the server at the following ftp address: ftp://ftp.in-berlin.de/pub/capi4linux or ftp://ftp.in-berlin.de/pub/users/calle/capi4linux/

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

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

(6) CAPI4Linux and Slackware (from 7.0)
Information about integration in Slackware plus capik-utils, VBOX, etc. are available at the URL: 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

10 AVM Support

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

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

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. Unfortunately, this site is only available in German.

.

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. AVM Support can be reached by e-mail. Support inquiries can be sent to AVM using the e-mail form provided at the Internet address

http://www.avm.de/en/service

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

APPENDIX: Special Instructions for SUSE 6.3

Required "pppd" Update in SuSE 6.3

Unfortunately, the pppd delivered with SuSE 6.3 is not up to date. Therefore it is necessary to update the pppd to be able to perform the test connection described here successfully. Otherwise an error message is returned when pppd is opened. The necessary update can be obtained from the SUSE server at

The required file (series "n", package "ppp") can be accessed directly from

ftp://ftp.SuSE.com/pub/SuSE/discontinued/i386/update/6.3/n1/ppp.rpm

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

EOF

SAS, TC, FS 09/2002