FBRCAPI - Remote CAPI over TCP Kernel Module For Fritz!Box Fon Router Series

---

Description

fbrcapi (Fritz!Box Remote CAPI over TCP) is a kernel module, for
Fritz!Box Fon Routers to transport CAPI messages over TCP.
It uses the transport protocol of the capiotcp_server daemon.

This kernel module is for v2.6.X kernel only.
You'll need CAPI 2.0 subsystem enabled in your kernel and
libcapi20 from isdn4linux (libcapi20-3).

Getting started

Get the kernel headers:


apt-cache search linux-headers # (see 'uname -r' for the correct version)

The Linux kernel headers should normally be located under /usr/src
Of course you'll need CAPI subsystem enabled in your current kernel.
Required modules are kernelcapi.ko and capi.ko


Then run make && make install. After that, you can load the module:


modprobe kernelcapi
modprobe capi
modprobe fbrcapi addr=[your FB IP] port=[5031] controllers=[1,2,...] debug=[0-4] boost=[0|1]

The module parameters are optional and only needed, if your Fritz!Box
has another IP than the default one (or for debugging purposes):


  addr=		The Fritz!Box IP address (default: 192.168.178.1)
  port=		The Fritz!Box capiotcp server port (default: 5031)
  debug=	The syslog debugging level
  controllers=  The remote controllers to attach (default: all)
  boost=	Renice kthread process with 1 (default)
                0 to turn it off

An init script is included in the fbrcapi package (rc.fbrcapi).

To check if everything is ok, you can run capiinfo from the
capiutils package. This should show the attached remote CAPI controllers.

To uninstall the module, run: make uninstall.

Attention

Remote CAPI should be enabled, when loading the kernel module, otherwise
it will fail to load. This is required to attach the CAPI controllers!

To disable remote CAPI: #96*2*
To enable remote CAPI:  #96*3*

When connection is lost when the module was loaded, fbrcapi will
automatically try to reconnect.

Also, the addr= parameter HAS TO be an IP address!!

Download

fbrcapi-0.4.tar.gz

Licence

  Copyright (C) 2010 Marco Zissen

  fbrcapi is free software; you can redistribute it and/or modify
  it under the terms of the GNU General Public License as published by
  the Free Software Foundation; either version 2 of the License, or
  (at your option) any later version.

  This program is distributed in the hope that it will be useful,
  but WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  GNU General Public License for more details.

  You should have received a copy of the GNU General Public License
  along with this program; if not, write to the Free Software
  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

ChangeLog

v0.4:
• fix: Kernel 2.6.31 'capi_ctr_resetet' -> 'capi_ctr_down' (thx to all who spotted this)
• Changed Makefile to fit Kbuild requirements

v0.3:
• fix: Send socket buffer didn't get freed

v0.2:
• fix: non-linear skb
• check and give error whenever "addr=..." is not an IP
• added module parameter "controllers=x,y,..." to enable/disable remote controllers
• added "make [install|uninstall]"
• added init script

v0.1:
• ported from libcapi20_fb-0.7 (user space / lib) to fbrcapi (kernel space / module) (NG)
• the default libcapi20 from isdn4linux can be used (no libcapi20 hacking anymore)
• some module parameters (addr=, port=, debug=, boost=)
• auto reconnect
• first release :)

Troubleshooting

When something went wrong, try to increase debug= module parameter and
look into dmesg. When everything is ok, something like that should be shown:


[44956.628068] fbrcapi: Fritz!Box Remote CAPI over TCP 0.4 (c) 2010 Marco Zissen 
[44956.628276] fbrcapi: Connecting to Fritz!Box CAPI server 192.168.178.1:5031 ...
[44956.636022] fbrcapi: Connected successfully!
[44956.662111] fbrcapi: 5 CAPI controllers found!
[44956.662724] kcapi: Controller [001]: fbrcapi_ctrl_1 attached
[44956.663584] kcapi: card [001] "fbrcapi_ctrl_1" ready.
[44956.664220] kcapi: Controller [002]: fbrcapi_ctrl_2 attached
[44956.664631] kcapi: card [002] "fbrcapi_ctrl_2" ready.
[44956.665066] kcapi: Controller [003]: fbrcapi_ctrl_3 attached
[44956.665461] kcapi: card [003] "fbrcapi_ctrl_3" ready.
[44956.665835] kcapi: Controller [004]: fbrcapi_ctrl_4 attached
[44956.666369] kcapi: card [004] "fbrcapi_ctrl_4" ready.
[44956.666748] kcapi: Controller [005]: fbrcapi_ctrl_5 attached
[44956.667132] kcapi: card [005] "fbrcapi_ctrl_5" ready.

... and capiinfo should output something like this:

Number of Controllers : 5
Controller 1:
Manufacturer: AVM Berlin
CAPI Version: 2.0
Manufacturer Version: 0.0-04  (0.4)
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

Supplementary services support: 0x000003ff
   Hold / Retrieve
   Terminal Portability
   ECT
   3PTY
   Call Forwarding
   Call Deflection
   MCID
   CCBS

Controller 2:
Manufacturer: AVM Berlin
CAPI Version: 2.0
Manufacturer Version: 0.0-04  (0.4)
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

Supplementary services support: 0x000003ff
   Hold / Retrieve
   Terminal Portability
   ECT
   3PTY
   Call Forwarding
   Call Deflection
   MCID
   CCBS

Controller 3:
Manufacturer: AVM Berlin
CAPI Version: 2.0
Manufacturer Version: 0.0-04  (0.4)
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

Supplementary services support: 0x000003ff
   Hold / Retrieve
   Terminal Portability
   ECT
   3PTY
   Call Forwarding
   Call Deflection
   MCID
   CCBS

Controller 4:
Manufacturer: AVM Berlin
CAPI Version: 2.0
Manufacturer Version: 0.0-04  (0.4)
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

Supplementary services support: 0x000003ff
   Hold / Retrieve
   Terminal Portability
   ECT
   3PTY
   Call Forwarding
   Call Deflection
   MCID
   CCBS

Controller 5:
Manufacturer: AVM Berlin
CAPI Version: 2.0
Manufacturer Version: 0.0-04  (0.4)
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

Supplementary services support: 0x000003ff
   Hold / Retrieve
   Terminal Portability
   ECT
   3PTY
   Call Forwarding
   Call Deflection
   MCID
   CCBS

Contact

<< back