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 https://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.

Each build of the connector contains in its name the version of LumenVox and Asterisk it is built for. So a build of the connector for LumenVox 9.2 built against Asterisk 1.6.2 would be named: asterisk-1.6.2-lumenvox-support-linux-i686-32bit-b25-engine9.2.tar.gz

Connectors are generally built by Digium for the very latest supported releases of Asterisk. It is highly recommended that you be on the latest stable and released version of Asterisk.

Also, there is sometimes a delay between a new LumenVox release and a new build of the connector bridge. In that case, the most recent connector bridge will generally work.

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
  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 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.

© 2012 LumenVox LLC. All rights reserved.