Installation for Octasic SoftEcho with mISDN
============================================

This Package contains the Octasic SoftEcho (32bit, Intel) which is a much better Echocanceler than the Zaptel ones.


I) Kernel Modules
-----------------

First of all you will need to compile and install the octasic Kernel Module, this can be done with:

# cd mISDN-1_1_X-OCT/drivers/isdn/hardware/mISDN/octvqe
# make install

Next you need to compile and install the patched mISDN-1-1-1: 

# cd mISDN-1_1_X-OCT/
# make install

Now you can load the mISDN modules int the normal way with:

# misdn-init start

you should see in 'dmesg' the following line:

	mISDN_dsp: Audio DSP  Rev. 1.27 (debug=0x0) EchoCancellor octasic dtmfthreshold(100)


This line tells you that the DSP is using the octasic EchoCanceler.

II) Registration
----------------

As next step you will need to register your licences, use the register32 application for that:

1. putt all your keys in a plain text file where each line is one key. like:

# cat /tmp/mykeys.txt
OCTVQE8-BERONET-XXXXXX-1
OCTVQE8-BERONET-XXXXXX-2
....

2. register your licenses at octasic with:

# mISDN-1-1-X-OCT/SoftEcho/bin/register32 -b /tmp/mykeys.txt

or for 64bit systems:

# mISDN-1-1-X-OCT/SoftEcho/bin/register64 -b /tmp/mykeys.txt

you will need to enter some information during registration. 



III) SoftEcho Daemon
--------------------

We need to copy the daemon into our sbin directory and the config file into /etc:

# cp mISDN-1-1-X-OCT/SoftEcho/bin/octvqed-$yourHardware$ /usr/sbin/octvqed
# cp mISDN-1-1-X-OCT/SoftEcho/examples/octvqed.conf /etc/

$yourHardware$ needs to be replaced with either: amd32, amd64, intel32, intel64, depending on the cpu type.
For example:

"octvqed-amd32"


Modifiy /etc/octvqed.conf as you want, it makes sense to use 32ms echo tail on ISDN lines. Please
use poll=64 and dsp_poll=64 in the misdn-init.conf.

Now we're able to start the octvqed daemon, that contains the Echocancel Algorithms:

# /usr/sbin/ocvqed -f /etc/octvqed.conf

It should print out how many licenses are used.

SoftEcho has a proc interface for viewing and debuging:

# cat /proc/octvqe


IV) misdn.conf
--------------

You will need to enable the echocancel option in the misdn.conf, set it 
to echocancel=yes and the canceler should work.


Finished
========

Now whenever you make a call with echocancel enabled you should see the call 
marked as active in /proc/octvqe. 

Now you have installed your SoftEcho properly :) 

