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

The current SoftEcho Version is : 1.3.0

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


NEW: 	Simple Installation	
----------------------------

	We have now a install-misdn-mqueue-OCT.tar.gz which makes the
	installation of mISDN-1_1_X-OCT as easy as the standard mISDN packages.
	Just get it with:

	 wget http://www.beronet.com/downloads/SoftEcho/install-misdn-mqueue-OCT.tar.gz

	then untar and install it:
	
	 tar xzf install-misdn-mqueue-OCT.tar.gz 
	 cd install-misdn-mqueue-OCT 
	 make install
	
	The Installation Process will ask you to enter your architecture, 
	please choose according your installed CPU.

	After you have installed the packages you should do the 
	Point 'II) Registration' from the Manual Installation Section below.

	The SoftEcho deamon will be installed automatically and it will be
	started automaticallyi when you do "misdn-init start"

	You will only need to edit /etc/octqved.conf and
	/etc/asterisk/misdn.conf according to IV).


Manual Installation:
--------------------


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

The Kernel modules will be compiled automatically, when you compile mISDN, just do

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

Now you can load the mISDN modules in 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.

The octasic kernel Modules "octvqe" will be loaded by misdn-init automatically too.

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 :) 

