1 Prerequisites for Installing the CAPI4Linux Package
2 Installing the DSL/ISDN-Controllers FRITZ!Card DSL USB in SUSE Linux x64 Platform
2.1 Installation Requirements
2.2 Preparing for Installation
2.3 Installation with YaST
2.4 Establishing an Internet Connection
3 Installation Instructions for Integrating FRITZ!Card DSL USB in Other Linux Distributions
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 (AMD64/EM64T)?
7.1 ISDN Monitor K ISDN Watch for KDE
7.2 DSL Monitor K ADSL Watch for KDE
7.3 CAPI4HylaFAX: The Interface for HylaFAX
The x64 platform (AMD/INTEL EM64T) is supported on any single-CPU
computers with one passive DSL/ISDN-Controller installed.
This driver is NOT suitable for the
64-bit INTEL IA64 platform (ITANIUM 1/2)!
AVM manufactures active ISDN-Controllers for this server platform,
whose CAPI 2.0 drivers are already included directly in the
operating system software.
FRITZ!Card DSL USB is a universal communications solution for DSL and ISDN networks. The external DSL/ISDN-Controller can be connected to any USB port. The minimum system requirements are a Pentium II processor with 300 MHz (or comparable, i.e. Celeron 300A, AMD K6-III with at least 400 MHz) and 64 MB RAM.
The DSL and ISDN components on the controller can be operated fully independent of each other. It is also possible to install this controller in a system which already has an AVM ISDN-Controller installed. In this case the ISDN section of FRITZ!Card DSL USB will be deactivated automatically. The features of the ISDN section correspond to those of an AVM FRITZ!Card USB. Both functional components are addressed via the COMMON-ISDN-API -2.0 (CAPI 2.0) interface.
Find out which protocol is provided for your DSL/ISDN line. FRITZ!Card DSL USB supports only the following subscriber lines:
To facilitate easy installation, a pre-compiled driver archive is included for the following Linux 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
NOTE: |
These drivers can only be used with kernel version 2.6 or higher. |
Operating system: |
SUSE Linux Pro 9.3 (Kernel 2.6.11.4-20a-default) |
Version: |
03.11.07 |
Build: |
06.01.05 |
NOTE |
The driver for this AVM-Controller is not included in SUSE Linux 9.3 for the x64 platform. To install the product in this operating system, you will need the CAPI4Linux package by AVM. The CAPI4Linux package must be installed in order to configure the controller using YaST2 or by dialing in via KInternet. The controller should not be connected to the PC until this package has been installed. |
Extract the archive with the command
tar -xzvf fcdslusb-susexx-64bit-yy.yy-yy.tar.gz
Example for SUSE 9.3:
tar -xzvf fcdslusb-suse93-64bit-3.11-07.tar.gz
A directory called "fritz" is created.
Note: |
Please complete step 2.2 before continuing with the instructions below. |
Follow the additional instructions in the next section on how to use KInternet, on "ppd" and on the scripts.
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/
If you would like to configure a connection over KInternet, proceed as follows:
Configuring DSL Dial-In Using YaST
Configuring ISDN Dial-In Using YaST
DSL Dial-in using the Point-to-Point Protocol Daemon (pppd)
To establish a DSL connection, you can use the CAPI 2.0 plug-in
module for the pppd stack. A pre-defined dial-in script simplifies
connecting to T-Online. Please change the script accordingly for other
DSL providers. To use the script, enter your access data. After the
installation of the driver software the sample script for the T-DSL
access can be found in the directory "/etc/ppp/peers".
Establish the connection with the following command (DNS is assigned over the PPP connection):
pppd call t-dsl usepeerdns
To clear down the connection, enter the keyboard shortcut "Strg+C".
ISDN Dial-in using the Point-to-Point Protocol Daemon (pppd)
Use the pppd module to establish a test connection to the AVM Data
Call Center (ADC) in Berlin to test the installation. 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.
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).
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.
Proceed as follows:
This concludes uninstallation.
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.
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
22222: max 12-digit T-Online-Nummer
0001: Mitbenutzer
33333: password
ATTENTION: |
The character "\" before "#" is important! |
If your DSL access is provided by the DSL carrier "1&1", the script "t-dsl" in "etc/ppp/peers/" has to be edited as follows:
Replace the following line:
user 000000000000\#000000000000\#0001\#@t-online.de
password 00000000
with the following entries:
user 1und1/<your
login-id>@online.de
password <your password>
Please note that the entries <your login ID> and <your password> have to be replaced by the user ID ("1111-222", for instance) and the corresponding password assigned to you by 1&1.
Extract from an adapted example script:
# Connection ID T-Online number joint user ID
# | | |
user 1und1/1234-5678@online.de
password confidential
linkname t-dsl
ipparam internet
plugin capiplugin.so
avmadsl
:
/dev/null
...
CAPI4Linux (AMD64/EM64T) currently supports the following AVM DSL/ISDN-Controllers:
* "End Of Maintenance" status (EOM): AVM will not continue development of the CAPI4Linux driver for this ISDN-Controller.
For information about new releases, see the AVM home page and the file "hist-eng.txt" in the root directory of ftp.avm.de
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
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-Controller. "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: ftp://ftp.avm.de/tools/k_isdn_watch.linux
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 DSL monitor for keeping track of the activities of the installed AVM DSL-Controller. "K ADSL 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: ftp://ftp.avm.de/tools/k_adsl_watch.linux
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: ftp://ftp.avm.de/tools/capi4hylafax.linux
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 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
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; 06/2005