AVMAIC.CFG(5)

NAME
avmaic.cfg - Configuration database for AVM active ISDN controllers

DESCRIPTION
The configuration file for the avmaicctl tool is layed out much like the well known INI files for Microsoft Windows. It consists of sections and each section has value assignments to keywords. As an extension the sections are organised in a hierarchy, i.e. every section can have one or more subsections. The (sub-)section level names are divided by the “/” character. This character can also be placed in front of every section, so the section names look much like a Unix path name.

For avmaicctl the configuration file contains one top-level section for every AVM active ISDN board in the system. The sections are named after the controller names delivered by “avmaicctl -l”, e.g. “[AVMB1-1]”. For a board with more than one ISDN port the section gets the base name of the controller names of its ISDN ports, e.g. “[AVMC4-2]” for a board with controller names “AVMC4-2/1” to “AVMC4-2/4”.

Under the board's section itself there is at least one sub-section for the ISDN ports and the line access settings. If a board has more than one ISDN port there is a corresponding sub-section for each port. For an AVM B1 its port section is termed “[AVMB1-1/port-1]” (assumed it is the first AVM board in the system). An AVM C4 as the second board in the system would need four ISDN port sections named “[AVMC4-2/port-1]” to “[AVMC4-2/port-4]”.

The sections of every board contain some key / value assignments defining the configuration data for the board. The following keys and their possible values are supported for active AVM boards.

  Entries in the main board section

Firmware
    The name of the board's firmware file to download. It must be an absolute filename to let the avmaicctl tool reliably find the firmware file.

  Entries in the ISDN port sub-section of each board
Key / value assignments in the port sub-sections for every board define settings specific to each ISDN port of the board. For multi-port boards like the AVM C2 or the AVM C4 their ports may be configured independently from each other. E.g. one may be configured for multipoint line access (MSN line) and the other(s) for point-to-point (direct dial-in) operation.

The port sub-sections have the short name “port-#” where “#” will be substituted by the (1-based) port number. For single-port boards there will be exactly one port section, whereas multi-port boards have as many port sections as they have ISDN ports.

The following settings are defined for the ISDN port sections:

DProtocol
    The D-channel protocol to use. The following D-channel protocols can be specified. But not all boards support all of these protocols. E.g. the AVM C2 and AVM C4 only support Euro-ISDN, the AVM B1 needs different firmware for Euro-ISDN, 1TR6 or North American protocols. See the respective hardware manual or the AVM web site for further information.

    Unfortunately the author has currently not enough information to provide an explanation for all of the D-channel protocol names.

    DSS1
        Euro-ISDN, commonly used D-channel protocol in Europe.

    D64S, DS64S2, D64SD, DS01, DS02
        D-channel protocol variants for leased line configurations.

    CT1

    VN3 French national D-channel protocol.

    AUSTEL

    5ESS
        AT&T specific D-channel protocol (USA).

    NI1 National ISDN 1 (NI1, USA).

    1TR6
        Old ISDN D-channel protocol formerly used in Germany.

P2P Set this field to “0” for multipoint lines (MSN lines) and to “1” for point-to-point lines (direct dial-in lines with extension numbers).

TEI If “P2P” is set to “1” this field must be set to the TEI value to use. Normally the value “0” is correct. But this depends on the configuration for the local PBX or public switch the board's ISDN port is attached to.

For the North American D-channel protocols “NI1” and “5ESS” some more configuration values must be added. For other protocols they are not relevant. There is not much explanation below for these keywords. But people using the North American D-channel protocols normally known their meaning and how to set them correctly.

Spid1
    SPID for the first B-channel

Dn1 Directory number for the first B-channel

Spid2
    SPID for the second B-channel

Dn2 Directory number for the second B-channel

FILES
/etc/avmaic.cfg
    By default the configuration file for the avmaicctl tool resides in the directory /etc. But the directory and the file name can be changed through the command line.

SEE ALSO
c4b(4), avmaic(4), avmaicctl(8)

HISTORY
The avmaicctl tool first appeared as an add-on for FreeBSD 4.6. The variant using a configuration file was first used under FreeBSD 5.3.

ACKNOWLEDGEMENTS
The information needed to implemented the avmaicctl tool (and the avmaic device driver) was mostly extracted from the board download tool for the Linux driver for active AVM ISDN boards written by Carsten Paeth <calle@calle.in-berlin.de>.

AUTHORS
This manual page and avmaicctl were written by Thomas Wintergerst <twinterg@gmx.de>.