libcapi20fb - Remote CAPI over TCP Library For Fritz!Box Fon Router Series (OBSOLETE)

---

Vorwort

Für Windows gibt es seit einiger Zeit einen CAPI-Client für die Fritz!Box (capi2032.dll). Unter Linux fehlte dieser bisher.
Ziel war es nun, eine ähnliche Library unter Linux zur Verfügung zu stellen, um diese Schnittstelle ebenfalls verwenden zu können.
Dadurch ergeben sich Anwendungsfälle, wie: Fax, Asterisk-Server oder das Telefonieren über Headset.

libcapi20_fb ist eine modifizierte Version der libcapi20 aus dem isdn4linux Paket.
Mit dieser Library hat man die Möglichkeit, auf den Capi-Over-TCP Server der Fritz!Box zuzugreifen. Alles ohne Modifikation.
Es reicht aus, die Anwendungen gegen -lcapi20 zu linken und den Capi-Over-TCP der Fritz!Box zu aktivieren (#96*3*).

libcapi20_fb kann unter Linux, wie auch Windows kompiliert werden.

Kompilierung

• i386-Linux:
  

  ./configure
  make
  make install

  Nach 'make install', befindet sich die Library unter /usr/lib.
  Alternativ kann man auch die vorkompilierten Binaries aus dem Paket verwenden.
  Die Header Dateien müssen dann manuell nach /usr/include kopiert werden.
  Unter Windows wird eine statische libcapi20_fb.lib erzeugt.
  
  
• Win32:
  

  Projektmappe "libcapi20_fb.sln" unter Visual C++ 2005 öffnen und kompilieren.
  Das MS-SDK wird benötigt!

Konfiguration

Standardmäßig wird versucht, sich mit dem Host 'fritz.box' zu verbinden.
IP-Adresse und Port lassen sich über Environment Variablen festlegen:


export FB_REMOTE_CAPI_IP=192.168.178.1
export FB_REMOTE_CAPI_PORT=5031

Weitere Einstellungen:

export FB_REMOTE_CAPI_DEBUG=X   (Debug-Ausgabe. 0=nichts, 3=alles)
export FB_REMOTE_CAPI_TCP=1     (Remote-CAPI an=1, aus=0)
export FB_REMOTE_CAPI_DEV=1     (Device-CAPI an=1, aus=0)

Unter Windows würde man anstelle des 'export', 'SET' verwenden oder die Umgebungsvariablen direkt unter "Systemsteuerung\System" hinterlegen. Mithilfe von capiinfo kann man nun prüfen, ob alles funktioniert. capiinfo befindet sich ebenfalls im libcapi20_fb Paket.



• capiinfo:

  Number of Controllers : 5
  Controller 1:
  Manufacturer: AVM Berlin
  CAPI Version: 2.0
  Manufacturer Version: 0.0-05  (0.5)
  Serial Number: 0004711
  BChannels: 2
  Global Options: 0x00000039
     internal controller supported
     DTMF supported
     Supplementary Services supported
     channel allocation supported (leased lines)
  B1 protocols support: 0x80003c0b
     64 kbit/s with HDLC framing
     64 kbit/s bit-transparent operation
     V.110 synconous operation with HDLC framing
  B2 protocols support: 0x00000003
     ISO 7776 (X.75 SLP)
     Transparent
  B3 protocols support: 0x00000001
     Transparent
  
    0500
    0200
    39000000
    0b3c0080
    03000000
    01000000
    00000000 00000000 00000000 00000000 00000000 00000000
    01000001 00020000 00000000 00000000 00000000
  Controller 2:
  Manufacturer: AVM Berlin
  CAPI Version: 2.0
  Manufacturer Version: 0.0-05  (0.5)
  Serial Number: 0004711
  BChannels: 2
  Global Options: 0x00000039
     internal controller supported
     DTMF supported
     Supplementary Services supported
     channel allocation supported (leased lines)
  B1 protocols support: 0x80003c0b
     64 kbit/s with HDLC framing
     64 kbit/s bit-transparent operation
     V.110 synconous operation with HDLC framing
  B2 protocols support: 0x00000003
     ISO 7776 (X.75 SLP)
     Transparent
  B3 protocols support: 0x00000001
     Transparent
  
    0500
    0200
    39000000
    0b3c0080
    03000000
    01000000
    00000000 00000000 00000000 00000000 00000000 00000000
    01000001 00020000 00000000 00000000 00000000
  Controller 3:
  Manufacturer: AVM Berlin
  CAPI Version: 2.0
  Manufacturer Version: 0.0-05  (0.5)
  Serial Number: 0004711
  BChannels: 2
  Global Options: 0x00000039
     internal controller supported
     DTMF supported
     Supplementary Services supported
     channel allocation supported (leased lines)
  B1 protocols support: 0x80003c0b
     64 kbit/s with HDLC framing
     64 kbit/s bit-transparent operation
     V.110 synconous operation with HDLC framing
  B2 protocols support: 0x00000003
     ISO 7776 (X.75 SLP)
     Transparent
  B3 protocols support: 0x00000001
     Transparent
  
    0500
    0200
    39000000
    0b3c0080
    03000000
    01000000
    00000000 00000000 00000000 00000000 00000000 00000000
    01000000 20020000 00000000 00000000 00000000
  Controller 4:
  Manufacturer: AVM Berlin
  CAPI Version: 2.0
  Manufacturer Version: 0.0-05  (0.5)
  Serial Number: 0004711
  BChannels: 1
  Global Options: 0x00000039
     internal controller supported
     DTMF supported
     Supplementary Services supported
     channel allocation supported (leased lines)
  B1 protocols support: 0x80003c0b
     64 kbit/s with HDLC framing
     64 kbit/s bit-transparent operation
     V.110 synconous operation with HDLC framing
  B2 protocols support: 0x00000003
     ISO 7776 (X.75 SLP)
     Transparent
  B3 protocols support: 0x00000001
     Transparent
  
    0500
    0100
    39000000
    0b3c0080
    03000000
    01000000
    00000000 00000000 00000000 00000000 00000000 00000000
    01000000 40020000 00000000 00000000 00000000
  Controller 5:
  Manufacturer: AVM Berlin
  CAPI Version: 2.0
  Manufacturer Version: 0.0-05  (0.5)
  Serial Number: 0004711
  BChannels: 3
  Global Options: 0x00000039
     internal controller supported
     DTMF supported
     Supplementary Services supported
     channel allocation supported (leased lines)
  B1 protocols support: 0x80003c0b
     64 kbit/s with HDLC framing
     64 kbit/s bit-transparent operation
     V.110 synconous operation with HDLC framing
  B2 protocols support: 0x00000003
     ISO 7776 (X.75 SLP)
     Transparent
  B3 protocols support: 0x00000001
     Transparent
  
    0500
    0300
    39000000
    0b3c0080
    03000000
    01000000
    00000000 00000000 00000000 00000000 00000000 00000000
    01000000 80020000 00000000 00000000 00000000

  
  

Troubleshooting

# ./capiinfo
Number of Controllers : 0
could not register - (0x1009)

• 1. Ist der Capi-over-TCP auf der Fritz!Box eingeschaltet (an: #96*3*, aus: #96*2*)?
  
• 2. Ist die IP-Adresse und der Port korrekt? Es wird standardmäßig versucht, sich mit fritz.box:5031 zu verbinden.
  
• 3. Sind die Softlinks unter /usr/lib korrekt?
  
• 4. ldd capiinfo eingeben und prüfen, ob libcapi20.so.3 auch auf /usr/lib/libcapi20.so.3 zeigt.
  

<< back