Welcome to CAPI4Linux for the passive AVM DSL/ISDN-Controller FRITZ!Card DSL USB!

Contents

1 Prerequisites for Installing the CAPI4Linux Package

2 Installing the DSL/ISDN-Controller FRITZ!Card DSL USB in SUSE Linux 9.3

2.1 Installation Requirements
2.2 Installation with YaST
2.3 Update with the CAPI4Linux Package

3 Installation Instructions for Integrating FRITZ!Card DSL USB in Other Linux Distributions

4 Uninstallation

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

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

7 Help Programs

7.1 ISDN Monitor "K SDN Watch" for KDE
7.2 DSL Monitor "K ADSL Watch" for KDE
7.3 CAPI4HylaFAX: The Interface for HylaFAX

8 AVM Support


1 Prerequisites for Installing the CAPI4Linux Package

The package supports the INTEL i386 platform along with one passive DSL/ISDN-Controller.

To facilitate easy installation, pre-compiled driver archives are included for the following Linux distributions:

* End Of Maintenance status (EOM): AVM will not continue development of the CAPI4Linux driver for this distribution

This document describes installation in SUSE Linux.

For more information on using AVM products with Linux, see the AVM web site at www.avm.de/en.

Back to top

2 Installing the DSL/ISDN-Controller FRITZ!Card DSL USB in SUSE Linux 9.3

NOTE:

Starting from SUSE Linux 9.1, the kernel version 2.6 is implemented. The driver modules and interfaces to the kernel changed fundamentally with this generation. These drivers thus can only be used with kernel version 2.6 or higher.

2.1 Installation Requirements

Back to top

2.2 Installation with YaST

  1. Connect FRITZ!Card DSL USB with your USB port and ISDN line (see manual).
  2. After login, SUSE's hardware detection announces "New hardware found! Would you like to configure the ISDN-Controller AVM FRITZ!Card DSL USB?" Click "Yes". If necessary start YaST2 manually (YaST2 Control Center) and select "ISDN" in the "Network Devices" menu.
  3. System administration rights (root privileges) are necessary for the 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 YaST2 dialog "ISDN cards configuration", select the FRITZ!Card DSL USB and click "Configure...".
  5. In the "ISDN low-level configuration" window, insert both your "Areacode" and "Dialprefix".
  6. Confirm your selection by clicking "OK".
  7. Ignore any warnings that may appear and confirm the query with "Yes".
  8. You may be then prompted to re-install a number of packages.
  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. After the controller installation, relevant sample scripts can be found in the folders:
    "etc/ppp/peers/" (for t-dsl)
    "etc/ppp/peers/isdn" (for ISDN).

If you would still like to configure a connection over KInternet, proceed as follows:

Configuring DSL Dial-In Using YaST

  1. From the "ISDN Service Selection" under "Network services", select the command "Add DSL CAPI interface".
  2. Under "DSL Configuration", select the entry "other (not recognized)" and then click "Configure...".
  3. In the subsequent "DSL Configuration" dialog, select for "PPP Mode" the entry "CAPI for ADSL" and for "Device Activation" the entry "On Boot". Confirm your choice by clicking "Next".
  4. Configure your Internet Service Provider (with Dial on Demand, for instance) and conclude the configuration with "Finish".

Configuring ISDN Dial-In Using YaST

  1. From the "ISDN Service Selection" under "Network services", select the command "Add new SyncPPP network interface".
  2. In the "add syncppp interface" dialog you can specify your telephone number and enter settings for the firewall configuration. Then click "Next" twice.
  3. Configure your Internet Service Provider (with Dial on Demand, for instance) and conclude the configuration with "Finish".

Additional information on using "pppd" and scripts can be found in the following section and in the section 5 Information about the CAPI Plug-in Module for the "Generic PPP" Stack (pppd).

Additional information for hardware configuration can also be found in the SUSE documentation in the following directories:
/usr/share/doc/packages/suselinux-userguide_en
/usr/share/doc/packages/suselinux-adminguide_en/

Back to top

2.3 Update with the CAPI4Linux Package

Operating system:

SUSE Linux 9.3 Pro. (Kernel 2.6.11.4-20a-default)

Version:

03.11.07

Build:

05.08.05

  1. System administration rights (root privileges) are necessary for the update. You must log in to the console as "root" or "Superuser".
  2. Make sure that your FRITZ!Card DSL USB is connected with the USB port and the DSL and ISDN lines (see the manual) and that the controller was already installed using YaST2.
  3. Copy the archive "fcdslusb-susexx-yy.yy-yy.tar.gz" from the CAPI4Linux archive to your computer (e.g. from a diskette using the "mcopy" command from a console) and start the console (command prompt).

    Extract the archive with the command

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

    Example for SUSE 9.3:

    tar -xzvf fcdslusb-suse93-3.11-07.tar.gz

    A directory called "fritz" is created.

  4. Switch to the new directory "fritz".
  5. Run "./install".
  6. A successful installation of FRITZ!Card DSL USB concludes with the message "The driver files have been updated, please restart the ISDN package or reboot in order to activate the changes.".
  7. Restart your computer. The CAPI 2.0 driver is initialized automatically. Use the "Ismod" command to check whether the CAPI module is present in the system. The following loaded modules should be included in the output:
    -fcdslusb
    -capi
    -capifs
    -kernelcapi
    -capiutil

Conclude by testing the installation. Establish a test connection to the AVM Data Call Center (ADC) in Berlin over the "pppd" (Point-to-point Protocol Daemon) module. This simulates dialing in to any Internet Service Provider using PPP sync in accordance with RFC 1618 over HDLC. The necessary parameters are pre-defined under the argument "AVM".
The number for the test server is ++49 30 39 98 43 20.

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

    DSL dial-up:To establish a DSL connection, besides KInternet, you can use the CAPI 2.0 plug-in module for the pppd stack. A pre-defined dial-in script simplifies connecting to T-Online. Please change the script accordingly for other DSL providers. To use the script, enter your access data. After the installation of the driver software the sample script for the T-DSL access can be found in the directory "/etc/ppp/peers".

    Establish the connection with the following command (DNS is assigned over the PPP connection):

    pppd call t-dsl usepeerdns

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

Additional options of the CAPI 2.0 plug-in module for the "Generic PPP" stack (pppd) are described in the section 5 Information about the CAPI Plug-in Module for the "Generic PPP" Stack (pppd).

Back to top

3 Installation Instructions for Integrating FRITZ!Card DSL USB in Other Linux Distributions

Thanks to the open concept of Linux, all current distribution can be used with the software. The binary-only modules contained in the drivers are kernel-independent. They do not execute any direct kernel calls. This means that they can be integrated into any Linux kernel. However, the manual installation must be adjusted individually to the distribution (kernel configuration, etc.) and the components installed (e.g. additional PCMCIA modules required). 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" driver directory.

For more helpful instructions and links, see www.avm.de/en.

4 Uninstallation

Because FRITZ!Card DSL USB is installed over YaST2, it must also be removed using the YaST2 control center.

Proceed as follows:

  1. Open the YaST2 Control Center.
  2. System administration rights (root privileges) are necessary for uninstallation. 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" under "Network Devices".
  4. Under "ISDN cards configuration", select "Already configured devices" and click "Change...".
  5. In the "DSL configuration overview" dialog, select FRITZ!Card DSL USB. Click "Delete" and confirm by clicking "Finish".

This concludes the uninstallation of FRITZ!Card DSL USB.

Back to top

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

The CAPI plug-in module for pppd (Point-to-point Protocol Daemon) is loaded automatically with the CAPI controller driver and can be started with additional options if desired. This makes sense, for instance, when the charges for your online costs are to be billed separately by setting signaling of an outgoing number from the number block of MSNs.

A complete description of the CAPI 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.

Dialing in via T-Online

In order to establish a connection to T-Online, a suitable dial-in script called "/etc/ppp/peers/isdn/t-online" should be configured as follows:

----- start -----
debug
sync
noauth
plugin /etc/ppp/plugins/userpass.so
user 11111\#22222\#0001\#@t-online.de
password 3333333
defaultroute
plugin /etc/ppp/plugins/capiplugin.so
number 0191011
protocol hdlc
ipcp-accept-local
ipcp-accept-remote
/dev/null
----- end -----

Enter the following parameters:
11111: max 12-digit Anschlusskennung (connection ID)
22222: max 12-digit T-Online-Nummer (T-Online number)
0001: Mitbenutzer (joint user)
33333: password

ATTENTION:

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

Back to top

Dialing in via 1&1

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

Replace the following line:

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

with the following entries:

user 1und1/<Ihre login-id>@online.de
password
<Ihr Passwort>

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

Extract from an adapted example script:

# Anschlusskennung T-Online-Nummer Mitbenutzerkennung
# | | |
user
1und1/1234-5678@online.de
password
geheim
linkname t-dsl
ipparam internet
plugin capiplugin.so
avmadsl
:
/dev/null
...

Back to top

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

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

* End Of Maintenance status (EOM): AVM will not continue development of the CAPI4Linux driver for these ISDN-Controllers

NOTE:

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.

Back to top

7 Help Programs

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

Command: capiinit
Option: stop
Effect: Stops the CAPI driver manually.

Command: capiinit
Option: start
Effect: Starts the CAPI driver manually.

The output contains first the CAPI controller number, followed by the run status of the driver, the name of the driver module, the type of the controller and the occupied resources.

Command: capiinfo
Effect: Shows additional information about the capabilities of the CAPI driver.
The output contains detailed information about the driver version, B-channel protocols supported by the driver and about the supplementary services in the D channel.

Command: cat /proc/capi/controller
Effect: Displays information including the logical controller numbers of all CAPI controllers installed.

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

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

man capiinfo

Back to top

7.1 ISDN Monitor "K ISDN Watch" for KDE

AVM provides the CAPI application "K ISDN Watch" as a powerful monitoring tool for all AVM ISDN-Controllers supported by CAPI4Linux. "K ISDN Watch" is an ISDN monitor for keeping track of the activities of the installed AVM ISDN-Controllers. "K ISDN Watch" is subject to the GPL, is based on "kimon" and can be translated for KDE 2.x / KDE 3.x. The program and additional information about it can be downloaded at the following address: www.avm.de/en

Back to top

7.2 DSL Monitor "K ADSL Watch" for KDE

AVM provides the CAPI application "K ADSL Watch" as a powerful monitoring tool for all AVM DSL-Controllers supported by CAPI4Linux. "K ADSL Watch" is an ADSL monitor for keeping track of the activities of the installed AVM DSL-Controllers. "K ADSL Watch" is subject to the GPL, is based on "kimon" and can be translated for KDE 2.x and KDE 3.x. The program and additional information about it can be downloaded at the following address: www.avm.de/en

Back to top

7.3 CAPI4HylaFAX: The Interface for HylaFAX

CAPI4HylaFAX transforms your Linux computer into a powerful fax server over which the networked clients can send and receive faxes at the same time. Any passive or active ISDN controllers equipped with a CAPI driver that supports faxing can use CAPI4HylaFAX. With four active AVM ISDN-Controllers C4 you can have up to 32 ISDN B channels available for faxing. Thanks to CAPI fax polling is also possible, and multiple ISDN services like can be used in parallel, like FaxG3 reception and connections to the Internet via pppd. The ISDN B channels are assigned automatically by the CAPI driver. The program and additional information about it can be downloaded at the following address: www.avm.de/en

Back to top

8 AVM Support

Because there are so many different kernels and distributions, e-mail support is limited to the operating systems and kernel versions described in section 2.1. This support is limited to the actual installation and the ISDN or DSL functionality up to the successful completion of the test connection or the test fax of over CAPI drivers and the CAPI4HylaFAX module in combination with AVM DSL/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 desk 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

All programs and drivers available on AVM's Internet site can also be downloaded from the AVM Data Call Center (ADC).
Please try all of the information sources described above before contacting AVM 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

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

EOF


SAS; SR, FS; 06/2005