echo_canceller.rst 3.05 KB
Newer Older
1 2
.. _hwec_configuration:

3
**************************
4
Hardware Echo-cancellation
5
**************************
6 7 8

It is *recommended* to use telephony cards with an hardware echo-canceller module.

9
.. warning:: with **TE13x, TE23x and TE43x** cards, you **MUST** install the echo-canceller firmware.
10 11 12
    Otherwise the card won't work properly.


13 14
Know which firmware you need
============================
15

Etienne Allovon's avatar
Etienne Allovon committed
16
If you have an hardware echo-canceller module you **have to** install its firmware.
17

18
You first need to know which firmware you have to install.
19 20 21
The simplest way is to restart dahdi and then to lookup in the dmesg which
firmware does DAHDI request at startup::

22
   xivo-service restart
23
   dmesg |grep firmware
24 25
   [5461540.738209] wct4xxp 0000:01:0e.0: firmware: agent aborted loading dahdi-fw-oct6114-064.bin (not found?)
   [5461540.738310] wct4xxp 0000:01:0e.0: VPM450: firmware dahdi-fw-oct6114-064.bin not available from userspace
26

27
In the example above you can see that the module ``wct4xxp`` requested the ``dahdi-fw-oct6114-064.bin``
28 29
firmware file but did not found it.
But you now know that you need the ``dahdi-fw-oct6114-064.bin`` firmware.
30 31


32 33
Install the firmware
====================
34

35
When you know which firmware you need you can install it with ``xivo-fetchfw`` utility.
36

Etienne Allovon's avatar
Etienne Allovon committed
37
#. Use ``xivo-fetchfw`` to find the name of the package. You can search for ``digium``
Pascal Cadotte Michaud's avatar
Pascal Cadotte Michaud committed
38
   occurrences in the available packages::
39

40
    xivo-fetchfw search digium
41

Etienne Allovon's avatar
Etienne Allovon committed
42
#. Find the package name which matches the firmware file you need. In our example, we need the
43
   ``dahdi-fw-oct6114-064.bin`` file which is supplied by the package named ``digium-oct6114-064``::
44

45
    xivo-fetchfw install digium-oct6114-064
46 47 48


Activate the Hardware Echo-cancellation
49
=======================================
50

Etienne Allovon's avatar
Etienne Allovon committed
51
Now that you installed hardware echo-canceller firmware you must activate it
52
in :file:`/etc/asterisk/chan_dahdi.conf` file::
53 54 55 56

    echocancel = 1


57 58 59 60 61 62 63 64 65 66 67
Apply the configuration
=======================

To apply the configuration, restart the services::

  xivo-service restart


Next step
=========

68
Now that you have loaded the correct module for your card you must:
69

70 71 72 73 74
#. check if you need to follow one of the :ref:`echo_can_specific_conf` sections below,
#. and continue with the next configuration step which is to :ref:`configure your card <card_configuration>` according to the operator links.


.. _echo_can_specific_conf:
75 76 77 78 79 80 81 82

Specific configuration
======================

This section describes some specific configuration. You should not follow them
unless you have a specific need.


83 84 85
Use the Hardware Echo-canceller for DTMF detection
--------------------------------------------------

86 87
If you have an hardware echo-canceller you *may* want to use it to detect the DTMF signal
(instead of asterisk).
88

89
#. Create the file :file:`/etc/modprobe.d/xivo-hwec-dtmf.conf`::
90

91
     touch /etc/modprobe.d/xivo-hwec-dtmf.conf
Etienne Allovon's avatar
Etienne Allovon committed
92

93 94
#. Fill it with the following lines replacing ``DAHDI_MODULE_NAME`` by the correct module name
   (``wcte13xp``, ``wct4xxp`` ...)::
95

96
     options DAHDI_MODULE_NAME vpmdtmfsupport=1
97

98
#. Then, restart the services::
99

100
     xivo-service restart
101