Introduction

Eicon build and sell some nice BRI card for voice or data exchanges. It can be nicely integrated with Asterisk. You can find a presentation of the cards here.

Why choose binary drivers whereas some drivers included in Ubuntu kernel exists ? Because Eicon only supports its own binary drivers and the drivers are coming with a nice tools set for configuring and managing your card.

Installation

Download driver on Eicon website

The list of the drivers can be found on this webpage. Download the corresponding version for your card. You would have to choose the source Debian package. For exemple, for our Diva Card 4BRI, we choose the 8.2beta1 (which is much better than 7.7) linux driver. You have to fill the form for downloading...

Install the package

Install the package you have downloaded on Eicon website. It will install:

• kernel module source (that will be compiled in next section)
• binary firmwire
• utilities

Just proceed to installation:

sudo dpkg -i divas4linux_EICON-106.57-1.deb

Building kernel modules

First, install the necessary packages for building modules: linux-source, build-essentials, libncurses-dev (see InstallingSoftware).

You have to manually unpack kernel sources and create the symlink in order that your kernel sources can be found under /usr/src/linux:

cd /usr/src
tar xvjf linux-source-2.6.15.tar.bz2
ln -s linux-source-2.6.15 linux

You are ready to launche the build:

cd /usr/lib/eicon/divas/src
./Build -mrproper -nowait

-mrproper is the same as usual (clean everything before starting) and -nowait is for not waiting 15 seconds !

The license informations should be displayed and you have to accept it. The you should have the following messages:

OK
PROCESSING: Call 'make dep', please be patient ... update 'version.h' ... OK
PROCESSING: Call 'make modules', please be patient ... OK
PROCESSING: Build MTPX adapter driver ... OK
PROCESSING: Install Diva modules ... divadidd.ko, divas.ko, diva_mnt.ko, diva_idi.ko, divacapi.ko, kernelcapi.ko, capi.ko diva_mtpx.ko OK
PROCESSING: Cleanup ... OK
PROCESSING: Build Divatty ...  OK
PROCESSING: Cleanup ... OK

SUCCESS. You can configure and start your Diva adapter now.

Launch the configuration utility.

cd ..
./Config

Tuning your installation

Those modifications are not mandatory. Your software may work, as it may not work. Those modifications are made for making the drivers Debian compliant.

udev

All the stuff is installed, it has to be a little tuned to work properly. First, disabled melware (opensource) kernel module to load during boot phase by adding them to the blacklist udev section. For this edit /etc/modprobe.d/blacklist-eicon with your favorite editor and enters the following lines:

# do not load melware eicon drivers
blacklist       divacapi
blacklist       divadidd
blacklist       diva_idi
blacklist       diva_mnt
blacklist       divas

Init script

The installation process add a script in /etc/rc2.d. This script call at startup /usr/lib/eicon/divas/divas_cfg.rc script. Now, we are going to add some minor changes to this script to correctly position rights on the device (the device should belong to the dialout group and be group writable).

Patching the Divas Init Script

• A patch for version 8.2 can be found here.

• A patch for version 9.0 can be found here.

Apply it:

cd /usr/lib/eicon/divas
patch -p0 patch-divas_cfg.rc.diff

Reboot the machine. Your /dev/capi20 should have the following rights:

ls -l /dev/capi20
crw-rw-r-- 1 root dialout 68, 0 2006-05-11 17:25 /dev/capi20

Administration / Maintenance

Eicon drivers come with a light http server for managing the card. Installation process add the following line to the /etc/inetd.conf:

diva-cfg        stream  tcp     nowait  root.daemon     /usr/lib/eicon/divas/diva_httpd diva_httpd /usr/lib/eicon/divas/httpd

By default, there is no inetd on Ubuntu. In order to get access to this server inetd is necessary, you have to install the following packages netkit-inetd (see InstallingSoftware).

Add a password to access the interface by editing the following file /usr/lib/eicon/divas/httpd/login/login and replacing (as it is explained) the XX.

You have access to the card manager interface by accessing in your favourite browser http://server:10005

Conclusion

Then, you should be able to use your card. You just have to setup your application. Enjoy !