How to install and configure Dialogic® Diva® software components in order to allow them to be used by Asterisk (How2UseDiva4Asterisk_with_chan_dialogicdiva.txt) Install the Dialogic® Diva® System Release 8.5LIN software. To obtain a good voice quality, we recommend you to install Dialogic® Diva® Media Boards equipped with Digital Signal Processors (DSP). This "HowTo" document describes the configuration for Diva Media Boards with DSPs. INSTALLATION NOTES: Requirements: - Important: Perform all steps as root. 1. Install the Kernel development tools. This includes: - modutils (package module-init-tools) - ncurses, ncurses-devel headers and libraries (package ncurses resp. libncurses) - c, c++ compiler (package gcc) - make (package make) - zlib, zlib-devel headers, and libraries (package zlib, zlib-devel) - gd, gd-devel - jpeg-devel, png-devel. - xinetd 2. Install the Kernel sources (package kernel-source). The sources must match the currently running kernel. Exception: If cross compiling, the following requirements must be met: - /usr/src/linux must point to your kernel source directory - A valid .config for the target system must be present in this path - A valid version.h must be present - In RPM-based system, use # rpm -qa |grep - In Debian-based systems, use # dpkg -l to list all packages that include the specified name if you do not know the correct package name. 3. Verify if you have the suitable sources for your installed kernel version. (For cross-compiling see note above). To find out if source and kernel have the same version number do the following: a. Type "uname -r" to display the current kernel version. b. List the contents of /usr/src/ . There must be a folder, e.g., "kernel-2.4.27-1" and a link named "linux" pointing into this directory. It should have the same name as the current kernel version. c. If this link does not exist, create it pointing to the correct kernel source location: # ln -s /usr/src/ /usr/src/linux 4. The current kernel configuration file ".config" should be in the kernel source path. If the build procedure cannot find this configuration file, it will try to locate the config file of the running kernel in /boot or /proc/config.gz and use this one. Build Procedure: 1. Install the binary package: chmod 755 Diva4Linux_installer_8.5-107-33.bin ./Diva4Linux_installer_8.5-107-33.bin 2. Change to the directory /usr/lib/opendiva/divas/src. 3. Invoke "./Build". The build procedure accepts the following switches: -mrproper: A make mrproper will be performed in the kernel source dir This removes any .config files of previous runs and tries to locate these in /boot and /proc/config.gz. Important: Any applied configuration changes will be deleted! -rpm: Builds a binary rpm for your configuration. (Only on rpm-based systems) -deb: Builds a binary deb for your configuration. (Only on debian-based systems) -nowait: The build procedure will start immediately without waiting 15 seconds for user intervention. 4. The build procedure will locate the kernel sources and .config itself. 5. Accept the License Agreement to build the Dialogic® Diva® TTY driver. 6. All drivers will be installed in the directory /usr/lib/opendiva/divas. 7. If errors occur, review the build log file "divas.log" in the build directory. 8. Change to the directory /usr/lib/opendiva/divas. 9. Use "./Config" to configure the Dialogic® Diva® Media Board(s) or follow the notes to activate the web based configuration. 10. Use "./Start" and "./Stop" to start/stop the Diva Media Board(s) manually. UNINSTALLATION NOTES: You can find an uninstall script in /usr/lib/opendiva/divas. With this script all files can be removed. ASTERISK INSTALLATION AND CONFIGURATION: After installing the Dialogic® Diva® System Release 8.5LIN software, you need to install the Asterisk software. The Diva System Release 8.5LIN software supports Asterisk 1.2x und 1.4x, which you can find under http://www.asterisk.org. 1. To install Asterisk, you can either install it from the already installed distribution or translate from the sources. 2. Install the libcapi20 and chan_dialogicdiva. It is important to install libcapi20 first. You can use it from your own distribution. We recommend you to install both, libcapi20 and chan_dialogicdiva from http://www.dialogic.com/products/tdm_boards/system_release_software/Diva_for_Linux.htm The files are updated and tested periodically. a. Unzip the libcapi20 package with "tar -zxvf libcapi20-3-cm.tar.gz". b. Change into the unzipped directory and run "./configure". Check for errors and fix them as necessary. c. Finish translating with "make" and install with "make install". d. Unzip the chan_dialogicdiva with "tar -zxvf chan_capi-HEAD.tgz" and translate it. e. Change into the unzipped directory. Install with "make", "make_install", and "make_install_config". f. Copy the translated module chan_dialogicdiva.so into /usr/lib/asterisk/modules/. 3. You can now configure Asterisk. The configuration files are stored under /etc/asterisk/. 4. In the modules.conf, enable the features that should be loaded when Asterisk is started. 5. Add the chan_dialogicdiva to the module.conf: load => chan_dialogicdiva.so chan_dialogicdiva.so=yes 6. Configure the dialogicdiva.conf for the Dialogic® Diva® Media Board(s) as follows: echocancel=yes ;Dialogic® Diva® (CAPI) echo cancelation (yes=g165) ;(possible values: "no", "yes", "force", "g164", "g165") echocancelold=no ;use facility selector 6 instead of correct 8 (necessary for older Diva drivers) 7. Configure the number of available B-channels: devices=8 ;number of concurrent calls (B-channels) on this controller 8. Configure the used CAPI controller and its isdnmode: isdnmode=msn 9. The dialplan configuration (extensions.conf) for the Diva Media Board(s) is documented in the chan_dialogicdiva README, which is stored in the source directory of the chan_dialogicdiva. For making an outgoing call using the CAPI controller, the dial command should be similar to the following: exten => _X.,1,Dail(DIALOGICDIVA/contr1/${EXTEN}/b,30,trg) Copyright © 2008 Dialogic Corporation. All Rights Reserved. You may not reproduce this document in whole or in part without permission in writing from Dialogic Corporation at the address provided below. All contents of this document are furnished for informational use only and are subject to change without notice and do not represent a commitment on the part of Dialogic Corporation or its subsidiaries ("Dialogic"). Reasonable effort is made to ensure the accuracy of the information contained in the document. However, Dialogic does not warrant the accuracy of this information and cannot accept responsibility for errors, inaccuracies or omissions that may be contained in this document. INFORMATION IN THIS DOCUMENT IS PROVIDED IN CONNECTION WITH DIALOGIC® PRODUCTS. NO LICENSE, EXPRESS OR IMPLIED, BY ESTOPPEL OR OTHERWISE, TO ANY INTELLECTUAL PROPERTY RIGHTS IS GRANTED BY THIS DOCUMENT. EXCEPT AS PROVIDED IN A SIGNED AGREEMENT BETWEEN YOU AND DIALOGIC, DIALOGIC ASSUMES NO LIABILITY WHATSOEVER, AND DIALOGIC DISCLAIMS ANY EXPRESS OR IMPLIED WARRANTY, RELATING TO SALE AND/OR USE OF DIALOGIC PRODUCTS INCLUDING LIABILITY OR WARRANTIES RELATING TO FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, OR INFRINGEMENT OF ANY INTELLECTUAL PROPERTY RIGHT OF A THIRD PARTY. Dialogic products are not intended for use in medical, life saving, life sustaining, critical control or safety systems, or in nuclear facility applications. It is possible that the use or implementation of any one of the concepts, applications, or ideas described in this document, in marketing collateral produced by or on web pages maintained by Dialogic may infringe one or more patents or other intellectual property rights owned by third parties. Dialogic does not provide any intellectual property licenses with the sale of Dialogic products other than a license to use such product in accordance with intellectual property owned or validly licensed by Dialogic and no such licenses are provided except pursuant to a signed agreement with Dialogic. More detailed information about such intellectual property is available from Dialogic's legal department at 9800 Cavendish Blvd., 5th Floor, Montreal, Quebec, Canada H4M 2V9. Dialogic encourages all users of its products to procure all necessary intellectual property licenses required to implement any concepts or applications and does not condone or encourage any intellectual property infringement and disclaims any responsibility related thereto. These intellectual property licenses may differ from country to country and it is the responsibility of those who develop the concepts or applications to be aware of and comply with different national license requirements. Dialogic, Dialogic Pro, Brooktrout, Cantata, SnowShore, Eicon, Eicon Networks, Eiconcard, Diva, SIPcontrol, Diva ISDN, TruFax, Realblocs, Realcomm 100, NetAccess, Instant ISDN, TRXStream, Exnet, Exnet Connect, EXS, ExchangePlus VSE, Switchkit, N20, Powering The Service-Ready Network, Vantage, Connecting People to Information, Connecting to Growth, Making Innovation Thrive, and Shiva, among others as well as related logos, are either registered trademarks or trademarks of Dialogic. Dialogic's trademarks may be used publicly only with permission from Dialogic. Such permission may only be granted by Dialogic's legal department at 9800 Cavendish Blvd., 5th Floor, Montreal, Quebec, Canada H4M 2V9. Any authorized use of Dialogic's trademarks will be subject to full respect of the trademark guidelines published by Dialogic from time to time and any use of Dialogic's trademarks requires proper acknowledgement. The names of actual companies and products mentioned herein are the trademarks of their respective owners. This document discusses one or more open source products, systems and/or releases. Dialogic is not responsible for your decision to use open source in connection with Dialogic products (including without limitation those referred to herein), nor is Dialogic responsible for any present or future effects such usage might have, including without limitation effects on your products, your business, or your intellectual property rights.