%
% capi.tex
% Last update: $Id$
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%% Kapitel CAPI %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\chapter{CAPI - (COMMON-ISDN-API)}
\marklabel{CAPIADMIN}{}
\index{CAPI}


    Das CAPI-Paket (COMMON-ISDN-API) stellt die Unterst"utzung f"ur
    die AVM-FRITZ!Box zur Verf"ugung.


\section{Die Hardware}

    Mit diesem CAPI Paket werden die AVM FRITZ!Box unterst"utzt.

    FRITZ!Box:

    Unterst"utzung f"ur 'CAPI over TCP'.\\
    Daf"ur muss es auf der FRITZ!Box eingeschaltet werden.\\
    \begin{itemize}
        \item  ein  \pfeil  \#96*3*\\
        \item  aus  \pfeil  \#96*2*\\
    \end{itemize}


\section{Das 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. & CAPI 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 controller \\
    \end{tabular}

    \mbox{}


\section{Die "Anderung der Konfiguration}

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

\section{Die Konfigurationsdatei}

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


\subsection{Allgemeine Einstellungen}


\begin{description}

\config{START\_CAPI}
{START\_CAPI}
{STARTCAPI}
{
    F"ur die Aktivierung des CAPI-Services muss diese Variable
    lediglich auf den Wert \glqq{}yes\grqq{} gestellt werden. Die Einstellung
    \glqq{}no\grqq{} schaltet den CAPI-Services ab.

    G"ultige Werte: yes, no

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

\end{description}


\subsection{FRITZ!Box}


\begin{description}

\config{CAPI\_USE\_REMOTE\_CARD}
{CAPI\_USE\_REMOTE\_CARD}
{CAPIUSEREMOTECARD}
{
    Hier wird eingestellt ob die REMOTE CAPI aktiviert werden
    soll.

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{CAPI\_USE\_REMOTE\_CARD='no'}
}


\config{CAPI\_REMOTE\_DRIVER}
{CAPI\_REMOTE\_DRIVER}
{CAPIREMOTEDRIVER}
{
    Hier wird der Treiber eingestellt der f"ur die REMOTE CAPI
    benutzt werden soll.

    G"ultige Werte: fritzbox, rcapi

    Standardeinstellung: \texttt{CAPI\_REMOTE\_DRIVER='fritzbox'}
}


\config{CAPI\_REMOTE\_HOST}
{CAPI\_REMOTE\_HOST}
{CAPIREMOTEHOST}
{
    Hier wird der Host eingestellt der f"ur die REMOTE CAPI
    benutzt werden soll.

    G"ultige Werte: HOSTNAME oder IP-ADDRESS

    Standardeinstellung: \texttt{CAPI\_REMOTE\_HOST='{}'}
}


\config{CAPI\_REMOTE\_PORT}
{CAPI\_REMOTE\_PORT}
{CAPIREMOTEPORT}
{
    Hier wird der Port eingestellt der f"ur die REMOTE CAPI
    benutzt werden soll.

    G"ultige Werte: Portnummer, Standard=5031

    Standardeinstellung: \texttt{CAPI\_REMOTE\_PORT='5031'}
}

\end{description}


\subsection{List controller}


    Hier werden die erkannten Controller aufgelistet mit der jeweiligen
    Zuordnungsnummer.

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