Digium Siren7 Software Codec for Asterisk README for Version 1.0.x modules ============================================================================== Digium offers a software implementation of Siren7 that is compatible with Asterisk and is properly licensed from the intellectual property rights and patent holders. Follow the instructions below to download and install the Digium Siren7 Software Codec for Asterisk. ==[ Installation Overview ]=================================================== There are three primary tasks to perform in order to install the Siren7 software codec. 1) Download and execute the 'benchsiren7' utility to determine the optimum build. 2) Use the 'Siren7 Selector' web utility to determine the recommended Siren7 codec binary download package. 3) Download and install the 'codec_siren7' binary that is built for your platform. The steps to complete these tasks are described in the Installation Procedure section. The benchsiren7 utility may be downloaded from: http://downloads.digium.com/pub/telephony/codec_siren7/benchsiren7 The Siren7 Selector may be viewed from: http://www.digium.com/en/docs/SIREN7/siren7-download.php The Siren7 codec binary may be downloaded from: http://downloads.digium.com/pub/telephony/codec_siren7 Notes: - Supported software builds are provided for 32-bit and 64-bit x86 platforms, and are optimized for a variety of processor types. Choose the directory that closest matches your Asterisk version and processor type. Each of these directories contains codec TAR files which include the Siren7 codec binary for each type of supported processor. ==[ Installation Procedure ]================================================== 1) Download and execute the benchsiren7 utility to determine the optimum build. There are various optimized versions of the Siren7 codec binary available for different CPU types in both x86-32 and x86-64 architectures. To determine which build of the module performs best on your system, the benchsiren7 utility will run a series of tests, and report which codec module will maximize encoding performance on your system. 1.1) Download the benchsiren7 utility to the root home directory of your Asterisk server. Command-line Example for 32-bit Linux: # cd /root # wget http://downloads.digium.com/pub/telephony/codec_siren7/\ benchsiren7/x86-32/benchsiren7-1.0.0-x86_32 -O benchsiren7 1.2) Change the permissions of the /root/benchsiren7 file to r-x------. Command-line Example: # chmod 500 /root/benchsiren7 1.3) Run the benchsiren7 utility and record the build that it recommends should be used for your platform. Command-line Example: # /root/benchsiren7 2) Use the 'Siren7 Selector' web utility to determine the recommended Siren7 codec binary download package. Depending upon your version of Asterisk and processor architecture, different Siren7 codec binaries are recommended for the use of Siren7. Digium provides a Siren7 Selector web utility in order to assist with choosing the correct Siren7 codec binary. The Siren7 Selector web utility should be viewed with a standard web browser and may be accessed via the following URL: http://www.digium.com/en/docs/SIREN7/siren7-download.php The file that the Siren7 Selector web utility informs you is recommended for your platform should be the file that you use in place of the examples provided in step 3 of this section. 3) Download and install the codec_siren7 binary that is built for your platform. The Siren7 codec module is only available for Asterisk versions 1.6.2.0 and later. Take note that these modules are *not* loadable in prior releases of Asterisk, and will only load in the specific version for which they are designed. Be sure that you download the correct version of the Siren7 codec binary for your Asterisk version, as recommended by the Siren7 Selector web utility in step 2. In addition, updated builds of the Siren7 codec binary are frequently released. Each build has a 'version number'. This version number is part of the filename, and is also included in the copyright/license message that is displayed when the module is loaded into Asterisk. In this document, build number '1.0.0' has been used as an example. Keep in mind that the current build number may be newer when you read this document. 3.1) Download Siren7 to the root home directory of your Asterisk server, replacing 'pentium4m' in the example with the recommended build and '_32' in the example with your CPU architecture. Command-line Example for 32-bit Linux: # cd /root # wget http://downloads.digium.com/pub/telephony/codec_siren7/\ asterisk-1.6.2/x86-32/codec_siren7a-1.6.2_1.0.0-pentium4m_32.tar.gz 3.2) Expand the codec_siren7 archive and copy the codec_siren7a.so file to the /usr/lib/asterisk/modules directory. Command-line Example for 32-bit Linux: # tar xzvf codec_siren7a-1.6.2_1.0.0-pentium4m_32.tar.gz # cp /root/codec_siren7a-1.6.2_1.0.0-pentium4m/codec_siren7a.so /usr/lib\ /asterisk/modules 3.3) The Siren7 codec binary must be loaded in order to utilize Siren7 channels. Command-line Example: # asterisk -rx "module load codec_siren7a.so" ==[ General Notes ]=========================================================== - It is not required or suggested to specify a load line in the /etc/asterisk/modules.conf for the codec_siren7a.so file. Asterisk will automatically load it using the autoload option. The autoload option is set on by default. ==[ Asterisk CLI Commands ]=================================================== The Siren7 codec binary provides the following Asterisk CLI commands: "siren7 show version" These are explained in greater detail below. - Issuing "siren7 show version" on the Asterisk CLI will display the Siren7 codec binary version. Command-line Example: # asterisk -rvvv *CLI> siren7 show version Digium Siren7A Module Version 1.6.2_1.0.0 (optimized for pentium4m_32) ==[ Technical Support ]======================================================= For more help, please visit the Siren7 category of the Digium Knowledgebase: http://kb.digium.com/?CategoryID=30 If you have any questions or concerns, contact Digium Technical Support by phone, either toll-free within the US at 1.877.DIGIUM.1(1.877.344.4861) or directly at +1.256.428.6000. You may also contact Digium Technical Support by visiting http://www.digium.com/support. ==============================================================================