Connector Bridge

The LumenVox Speech Engine communicates with Asterisk via a "connector bridge." It's an Asterisk module called res_speech_lumenvox that ties into Asterisk's generic Speech API (the Asterisk modules res_speech and app_speech_utils).

The connector bridge is included with Asterisk Business Edition, but users of Asterisk Open Source need to install it. It can be downloaded as a tarball from the LumenVox Web site. Login to your account at http://www.lumenvox.com/customers/ and choose Your Software Downloads.

There are various versions of the connector bridge depending on which version of Asterisk you use from 1.4 and forward. Download the package appropriate for your version of Asterisk. The connector bridge package includes the files README, lumenvox.conf and res_speech_lumenvox.so.

Please be sure you are installing the proper connector bridge for your combination of LumenVox and Asterisk. The following table details the valid combinations:

Installing the connector

1. Extract the tarball by typing tar -xvzf filename where filename is the name of the connector bridge tar file. This will create a new directory; move into that directory.
2. Move res_speech_lumenvox.so to /usr/lib/asterisk/modules by typing mv ./res_speech_lumenvox.so /usr/lib/asterisk/modules/res_speech_lumenvox.so
3. Move lumenvox.conf to /etc/asterisk: mv ./lumenvox.conf /etc/asterisk/lumenvox.conf
4. Change lumenvox.conf to reflect your grammars and settings.
5. Edit modules.conf in /etc/asterisk/ to ensure that you are loading both res_speech.so (the generic speech API) and res_speech_lumenvox.so. Note that res_speech.so must be loaded first, as shown below:
   load => res_speech.so
   load => res_speech_lumenvox.so

   If you are using Asterisk 1.2, you must patch your Asterisk source code to include res_speech.so.

6. Edit /etc/lumenvox/client_property.conf and set MODULE_STARTUP_MODE = 1 (the default is 0).

Once the connector is installed and configured, you may move on to testing the installation.

The latest connector bridges (b23 and above) will only work with Asterisk 1.6 and higher. If you are using an older version of Asterisk, please download an older version of the connector bridge (available on our Web site by clicking "View Previous Versions " next to the connector bridge download). Use the matrix above to find the right bridge for your version of Asterisk.