CAPI stellt eine generische Schnittstelle zu den Diensten von ISDN zur Verfügung und abstrahiert den Software-Entwickler damit von der ISDN Hardware. Neben diversen anderen Anwendungen stellt CAPI auch eine Modememulation zur Verfügung. Diese Schnittstelle kann direkt mit AT-Befehlen angesprochen werden. Die Devices sind unter Linux als /dev/ttyI* ansprechbar.
Die Anbindung einer ISDN-Lösung an Hylafax setzt auf dieser Modemschnittstelle auf. Für Hylafax erscheint die ISDN-Karte als ein virtuelles Modem. Die Kommunikation mit diesem "Modem" übernehmen dabei die Programme c2faxrecv und c2faxsend.
Die Konfiguration des "Modems" für eingehende Faxe
erfolgt in config.faxCAPI und wird vom Programm c2faxrcvd
gelesen. Ausgehende Faxe werden mit dem Programm c2faxsend verschickt.
Die Konfiguration von Hylafax, damit c2faxsend für ausgehende Faxe genutzt wird,
erfolgt in config mit der Direktive SendFaxCmd:
. Falls der Wert
nicht gesetzt ist, das Fax mit "faxsend" zu verschickt, was über CAPI nicht möglich
ist.
Zur Konfiguration der ISDN Anbindung wird das Paket
capi4hylafax (Debian Sarge) benötigt. Nach Installation
des Paketes wird das Kommando capi4hylafaxconfig
aufgerufen. Das Programm fragt die erforderlichen Parameter ab und
generiert die Konfigurationsdatei /etc/config.faxCAPI.
Das virtuelle Modem wird vom Kommando c2faxrecv
beim
Queue-Manager faxq registriert. C2faxrecv kann per init-Script oder
direkt von init(8) gestartet werden. Wichtig ist, dass c2faxrecv der
Pfad zum Hylafax-Spooldir mit dem Schalter -q
bekannt
gemacht wird. Dieses Programm muss in jedem Fall gestartet werden,
auch wenn ausschliesslich der Versand von Faxdokumenten vorgesehen
ist.
Falls c2faxreqv vor hylafax gestartet wird (z.B. durch init), dann sollte das Modem nach dem Start von hylafax explizit mit faxmodem faxCAPI registriert werden.
Bei Debian Sarge wird das Modem im Init-Script von hylafax (S20hylafax) registriert. Danach wird c2faxrecv von capi4hylafax (S25capi4hylafax) gestartet.
Beim Versand eines Faxes ruft der Queue-Manager das Programm c2faxsend aus dem Paket capi4hylafax auf. Dieses Programm übernimmt den Versand des Faxdokuments über das virtuelle Modem der CAPI-Schnittstelle.