%
% dahdi.tex
% Last update: $Id$
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%% Kapitel DAHDI %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\chapter{Das DAHDI-Paket - (Telephony interface)}
\marklabel{DAHDIADMIN}{}
\index{DAHDI}

\section{Allgemeines}

    Das DAHDI-Paket (Telephony interface) stellt die Unterst"utzung f"ur
    Asterisk Hardware Karten zur Verf"ugung.


\section{Die Hardware}

    Die Entwicklung und Anpassung der Dahdi Hardware Treiber, an die neuen
    Kernelversionen, erfolgt nur noch sehr gering, daher ist es m"oglich,
    dass auch einzelne Karten die hier gelistet sind nicht mehr funktionieren.

    Mit diesem DAHDI Paket werden FXO, FXS, ISDN-Karten mit Cologne-Chip
    unterst"utzt. Wie z.B.


    \begin{tabular}{lll}
    & wct4xxp & \\
    & Digium & TE205P/TE207P/TE210P/TE212P: PCI dual-port T1/E1/J1 \\
    & Digium & TE405P/TE407P/TE410P/TE412P: PCI quad-port T1/E1/J1 \\
    & Digium & TE220: PCI-Express dual-port T1/E1/J1 \\
    & Digium & TE420: PCI-Express quad-port T1/E1/J1 \\
    & Digium & TE820: PCI-Express eight-port T1/E1/J1 \\
    &        & \\
%    & wct1xxp & \\
%    & Digium & T100P: PCI single-port T1 \\
%    & Digium & E100P: PCI single-port E1 \\
%    &        & \\
    & wcte11xp & \\
    & Digium & TE110P: PCI single-port T1/E1/J1 \\
    &        & \\
    & wcte12xp & \\
    & Digium & TE120P: PCI single-port T1/E1/J1 \\
    & Digium & TE121: PCI-Express single-port T1/E1/J1 \\
    & Digium & TE122: PCI single-port T1/E1/J1 \\
    &        & \\
    & wcte13xp & \\
    & Digium & TE131: PCI-Express single-port T1/E1/J1 \\
    & Digium & TE132: PCI single-port T1/E1/J1 \\
    & Digium & TE133: PCI-Express single-port T1/E1/J1 with hardware echocan \\
    & Digium & TE134: PCI single-port T1/E1/J1 with hardware echocan \\
    &        & \\
    & wcte43x & \\
    & Digium & TE435: PCI express quad-port T1/E1/J1 \\
    & Digium & TE436: PCI quad-port T1/E1/J1 \\
    & Digium & TE235: PCI express dual-port T1/E1/J1 \\
    & Digium & TE236: PCI dual-port T1/E1/J1 \\
    \end{tabular}

    \begin{tabular}{lll}
    & wcb4xxp & \\
    & Digium & B410: PCI quad-port BRI \\
    & Digium & B233: PCI-Express dual-port BRI with echo can \\
    & Digium & B234: PCI dual-port dual-port BRI with echo can \\
    & Digium & B433: PCI-Express quad-port BRI with echo can \\
    & Digium & B434: PCI quad-port BRI with echo can \\
    &        & \\
    & wctdm24xxp & \\
    & Digium & TDM2400P/AEX2400: up to 24 analog ports \\
    & Digium & TDM800P/AEX800: up to 8 analog ports \\
    & Digium & TDM410P/AEX410: up to 4 analog ports \\
    & Digium & Hx8 Series: Up to 8 analog or BRI ports \\
    &        & \\
    & wcaxx  & \\
    & Digium & A8A: PCI up to 8 mixed FXS/FXO ports \\
    & Digium & A8B: PCI express up to 8 mixed FXS/FXO ports \\
    & Digium & A4A: PCI up to 4 mixed FXS/FXO ports \\
    & Digium & A4B: PCI express up to 4 mixed FXS/FXO ports \\
%     &        & \\
%    & wcfxo  & \\
%    & X100P  & Single port FXO interface \\
%    & X101P  & Single port FXO interface \\
    &        & \\
    & wctdm  & \\
    & Digium & TDM400P: up to 4 analog ports \\
    &        & \\
    & wcb4xxp & \\
    & Digium & B410P: 4 NT/TE BRI ports \\
    &        & \\
    & wctc4xxp & \\
    & Digium & TC400B: G729 / G723 Transcoding Engine \\
    &        & \\
    & xpp\_usb & \\
    & Xorcom & Astribank Devices \\
    &        & \\
%    & cwain  & \\
%    & qozap  & \\
%    & ztgsm  & \\
    & dahdi\_hfcs &  Karten mit Cologne-Chip \\
    \end{tabular}

    \mbox{}

    und jeweils dazu kompatible Karten, wie z.B Beronet

    Hier sind auch die dahdi-tools sehr hilfreich wie

    lsdahdi \\
    dahdi\_hardware \\
    etc ...

\newpage

    Um bei der Konfiguration den richtigen Treiber zu ermitteln, ist es
    Hilfreich, wenn mehrere Konsolen zur Verf"ugung stehen.

    z.B

    \begin{tabular}{lll}
    & Konsole 1: & die DAHDI Konfiguration \\
    &            & \\
    & Konsole 2: & stellt die Ausgabe von messages da \\
    &            &  1. System administration \\
    &            &  2. Logfile view \\
    &            &  1. Messages \\
    &            &  oder tail -f /var/log/messages \\
    &            &  \\
    & Konsole 3: & lspci -v \\
    \end{tabular}

    Somit sieht man in der messages Ausgabe wie die Treiber geladen werden,
    mit welchen Optionen sie geladen werden und welche CARD Nummer zugewiesen
    wird, z.B bei HFS-S Karten und in welchem Modus sie Konfiguriert sind NT
    oder TE, FXO oder FXS.

    \begin{tabular}{lll}
    & TE & \pfeil  Netzanschluss \\
    &    & TE ist wenn der Asterisk den ISDN-Bus nicht selbst bereitstellt, \\
    &    & sondern nur daran teilnimmt (passiv). Der ISDN-Bus wird hier von \\
    &    & z.B. einer TK-Anlage bereitgestellt. Hier reicht iirc eine passive \\
    &    & ISDN-Karte ohne HFC-S Chip - z.B. eine Fritz!CARD von AVM - ein NTBA \\
    &    & ist iirc auch nicht n"otig. \\
    &    & \\
    & NT & \pfeil Telefon \\
    &    & NT ist wenn der Asterisk den ISDN-Bus selbst bereitstellen muss \\
    &    & (aktiv), weil daran nur Telefone h"angen. Hier ist iirc eine sog. \\
    &    & aktive ISDN-Karte mit HFC-S Chip n"otig. Hier ist iirc zwingend \\
    &    & ein NTBA n"otig. \\
    &    & \\
    &    & Je nach Kartentyp ist es erforderlich auch ein gekreuztes Kabel \\
    &    & zu verwenden. \\
    \end{tabular}

    Die HFC-S Karten erkannte man fr"uher daran, dass der K"olner Dom
    (Cologne-Chip) auf dem Chip abgebildet war.


    \begin{tabular}{lll}
    & FXO & \pfeil  Netzanschluss \\
    & FXS & \pfeil  Telefon \\
    \end{tabular}

\newpage

\section{Men"u im Setup-Programm}


    Das Men"u im Setup-Programm ist wie folgt aufgebaut:

    \mbox{}

    \begin{tabular}{lll}
    & x. & System administration \\
    \end{tabular}
\eline
    \begin{tabular}{p{1cm}lll}
    & x. & Hardware administration \\
    \end{tabular}
\eline
    \begin{tabular}{p{2cm}lll}
    & x. & DAHDI administration \\
    \end{tabular}
\eline
    \begin{tabular}{p{3cm}lll}
    & 1. & View documentation \\
    & 2. & Edit configuration \\
    & 3. & Advanced configuration file handling \\
    & 4. & Show status \\
    & 5. & Stop service \\
    & 6. & Start service \\
    & 7. & List DAHDI controller \\
    \end{tabular}

    \mbox{}


\section{Die "Anderung der Konfiguration}

    Die Konfiguration kann "uber den Men"upunkt \glqq{}Edit configuration\grqq{}
    ge"andert werden.



\section{Die Konfigurationsdatei}

    In der Konfigurationsdatei, die "uber das Men"u zug"anglich ist, sind
    folgende Parameter vorhanden; wer sie von Hand editieren will, findet
    sie unter \\
    \texttt{/etc/config.d/dahdi}.


\subsection{Allgemeine Einstellungen}

\begin{description}


\config{START\_DAHDI}
{START\_DAHDI}
{STARTDAHDI}
{
    F"ur die Aktivierung des DAHDI-Services muss diese Variable
    lediglich auf den Wert 'yes' gestellt werden. Die Einstellung
    'no' schaltet den DAHDI-Services ab.

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{START\_DAHDI='no'}
}


\config{DAHDI\_TONEZONE}
{DAHDI\_TONEZONE}
{DAHDITONEZONE}
{
    Tonzone Einstellung

    \begin{tabular}{lll}
    & ae  & = United Arab Emirates \\
    & ar  & = Argentina \\
    & at  & = Austria \\
    & au  & = Australia \\
    & be  & = Belgium \\
    & bg  & = Bulgaria \\
    & br  & = Brazil \\
    & ch  & = Switzerland \\
    & cl  & = Chile \\
    & cn  & = China \\
    & cr  & = Costa Rica \\
    & cz  & = Czech Republic \\
    & de  & = Germany \\
    & dk  & = Denmark \\
    & ee  & = Estonia \\
    & es  & = Spain \\
    & fi  & = Finland \\
    & fr  & = France \\
    & gr  & = Greece \\
    & hu  & = Hungary \\
    & il  & = Israel \\
    & in  & = India \\
    & it  & = Italy \\
    & jp  & = Japan \\
    & lt  & = Lithuania \\
    & mo  & = Macao China \\
    & mx  & = Mexico \\
    & my  & = Malaysia \\
    & nl  & = Netherlands \\
    & no  & = Norway \\
    & nz  & = New Zealand \\
    & pa  & = Panama \\
    & ph  & = Philippines \\
    & pl  & = Poland \\
    & pt  & = Portugal \\
    & ru  & = Russian Federation \\
    & se  & = Sweden \\
    & sg  & = Singapore \\
    & th  & = Thailand \\
    & tr  & = Turkey \\
    & tw  & = Taiwan \\
    & uk  & = United Kingdom \\
    & us  & = United States / North America \\
    & us-old & = United States Circa 1950 / North America \\
    & ve  & = Venezuela \\
    & za  & = South Africa \\
    \end{tabular}

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{DAHDI\_TONEZONE='de'}
}


\config{DAHDI\_CARDS\_N}
{DAHDI\_CARDS\_N}
{DAHDICARDSN}
{
    Hier wird die Anzahl der zu verwendenden Treiber eingetragen.
    Jeder Treiber wird nur einmal ben"otigt, auch wenn mehrere
    Karten denselben Treiber ben"otigen.

    G"ultige Werte: Zahl

    Standardeinstellung: \texttt{DAHDI\_CARDS\_N='1'}
}


\config{DAHDI\_CARDS\_x\_NAME}
{DAHDI\_CARDS\_x\_NAME}
{DAHDICARDSxNAME}
{
    Hier kann der Name der Karte eingetragen werden oder
    was auch immer, DAHDI wertet es nicht aus.

    G"ultige Werte: alles

    Standardeinstellung: \texttt{DAHDI\_CARDS\_x\_NAME='{}'}
}


\config{DAHDI\_CARDS\_x\_ACTIVE}
{DAHDI\_CARDS\_x\_ACTIVE}
{DAHDICARDSxACTIVE}
{
    Hier wird der Datensatz aktiviert.

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{DAHDI\_CARDS\_x\_ACTIVE='no'}
}


\config{DAHDI\_CARDS\_x\_DRIVER}
{DAHDI\_CARDS\_x\_DRIVER}
{DAHDICARDSxDRIVER}
{
    Hier wird der Name des Treibers eingetragen.
    Zum ermitteln des Treibers, ist 'lspci -v' auf der Konsole
    hilfreich.

    G"ultige Werte: Treiber Name

    Standardeinstellung: \texttt{DAHDI\_CARDS\_x\_DRIVER='{}'}
}


\config{DAHDI\_CARDS\_x\_OPTION}
{DAHDI\_CARDS\_x\_OPTION}
{DAHDICARDSxOPTION}
{
    Bei diesem Parameter werden ben"otigte Optionen eingestellt.
    z.B bei HFC-S Karten der NT Modus.\\
        nt\_modes=0,1  (CARDS Nummer, mit Komma getrennt) \\
    Weitere Optionen sind bei den jeweiligen Modulen ersichtlich,
    durch den Aufruf von 'modinfo \$modul'

    G"ultige Werte: vom Treiber

    Standardeinstellung: \texttt{DAHDI\_CARDS\_x\_OPTION='{}'}
}

\end{description}


\subsection{List controller}


    Hier werden die erkannten Controller aufgelistet und der aktive
    Zustand.

\jump{MENUSYSTEMHARDWARE}{Zur"uck zum Men"u: Hardware administration}
