DAIC.CFG(5)

NAME
daic.cfg - Configuration database for legacy Diehl active ISDN controllers

DESCRIPTION
The configuration file for the daicctl 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 daicctl the top-level sections are “[global]” and “[boards]”. Under “[boards]” there are subsections for every Diehl board known to the system. The section for each board contains the necessary key / value pairs for the settings needed to run the board.

  Global settings
The top-level section “[global]” contains common settings for all boards in the configuration file.

BaseDir
    The directory for the firmware files to load onto the boards. All files for the bootstrap code and the protocol firmware must be in this directory. The default value is /usr/share/capi/daic.

  The section for all boards
This section collects subsections for all boards known to the system. The subsections are named after the controller names delivered by “daicctl -l”, e.g. “[boards/Diehl SCOM-1]”. For a Quadro board the section gets the base name of the controller names of its ISDN ports, e.g. “[boards/Diehl Quadro-2]”.

The section for a board has the following entries:

DProtocol
    The D-channel protocol to use. The string for this field is used to create a firmware file name. Currently the only protocol name directly supported is “etsi” for the DSS1 (Euro-ISDN) protocol. Other strings may be specified only if the corresponding firmware file for the board in question is placed into the base directory specified as the value for “BaseDir” in the section “[global]” in the configuration file. The firmware file name is constructed after the pattern “te_<DProtocol>.<extension>”. The extension is derived from the board type. See daic(4) for more information.

    Note that case is significant for the D-channel protocol string.

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

TEI This value must be set to the TEI number to use when the line the board is attached to works in point-to-point mode. Possible values are 0-63. Normally the value “0” is correct. But that depends on the configuration of the local PBX or the attached public switch.

Permanent
    Set this field to “1” if the line for the board is a leased line. For normal operation set it to “0”.

Layer2
    The D-channel layer 2 connection can be handled in several ways. It can be established on-demand, when an outgoing call shall be made, and disconnected as soon as it is not needed any more. Or it can be established permanently. The following values may be specified:

    0   Layer 2 of the D-channel is established on-demand and disconnected as soon as it is not needed any more.

    1   Layer 2 of the D-channel is established as soon as a call is to be made or when the attached switch establishes it. The controller will never disconnect it by itself. This is the recommended setting for S0 lines.

    2   Layer 2 of the D-channel is established right after downloading the board and never be disconnected. When it is disconnected by the attached switch the controller will re-establish it again. This is the recommended setting for S2m lines.

LowChannel
    Only for S2m boards: The value of this field defines the low B-channel to use when selecting the next channel to use for outgoing calls. “0” means default setting, other values from “1” to “30” select a specific B-channel.

ProtocolVersion
    This field should be set to “0”. The effects of other values is currently unknown and may differ between different protocol firmware files.

CRC4
    Only for S2m boards: Enable or disable the use of CRC4 checksum computation. The following values are defined:

    0   Default operation according to the D-channel protocol.

    1   Explicitly enable CRC4 checksum handling.

    2   Explicitly disable CRC4 checksum handling.

MemoryTest
    Leave this field set to “0” to not perform an additional board memory check. Such a test is already done on board initialisation and need not be performed a second time when loading the firmware. Set it to “1” to perform an additional board memory test when loading the firmware.

OAD1, OSA1 SPID1, OAD2, OSA2, SPID2
    These fields are not used for DSS1 (Euro-ISDN). They may be used for North American D-channel protocols, for which the firmware files are currently not installed with CAPI for BSD. The “OAD” values take the originator address for the first or second B-channel, the “OSA” values are the originator subaddresses. The “SPID” strings are the service profile identifiers for the respective B-channel.

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

SEE ALSO
c4b(4), daic(4), daicctl(8)

HISTORY
The daicctl tool first appeared as an add-on for FreeBSD 5.3.

ACKNOWLEDGEMENTS
The information needed to implemented the daicctl tool (and the daic device driver) was taken from the board manual for S, SX, SXn and SCOM boards, an old attempt by Martin Husemann to create an i4b driver and the Linux driver for Eicon boards.

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