====================================================================================== readme.txt December 2012 - Dialogic(R) NaturalAccess(TM) Development Environment Release 9.0.8 Readme (C)Copyright 2012 Dialogic Corporation ====================================================================================== - Refer to Section 6 of this document for new features supported in this release. - Before carrying out a NaturalAccess installation, uninstall all previous versions. This procedure will ensure a valid NaturalAccess product configuration on your system. - NaturalAccess products do not include patent or other intellectual property rights ("IPR") with respect to vocoders complying with the industry standards G.723.1 and/or G.729. For those customers who have not licensed such rights independently from the respective IPR holders, Dialogic will provide such rights with respect to either or both standards for an additional charge. This charge is passed through to the respective holders. Contact your Dialogic sales representative. - The cgsetkey program, installed as part of NaturalAccess, was derived from source code obtained from the KAME project,http://www.kame.net. This source code was used in accordance with the following license: /* * Copyright (C) 1995, 1996, 1997, 1998, and 1999 WIDE Project. * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions * are met: * 1. Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * 2. Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * 3. Neither the name of the project nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE PROJECT AND CONTRIBUTORS ``AS IS'' AND * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE PROJECT OR CONTRIBUTORS BE LIABLE * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF * SUCH DAMAGE. */ ******************************************************************************** ****************************IMPORTANT NOTICES*********************************** - For the availability of this software package for other operating system platforms, or for updates for this software package, please check the "Software and Downloads" page at http://www.dialogic.com/products/tdm_boards/system_release_software/download/natural-access-software.htm ================================================================================ 1. Contents of NaturalAccess ================================================================================ NaturalAccess 9.0.8 contains the following products: ag-cas - 2.363 ag-isdn - 1.993 cnf - 2.223 ctaccess - 4.233 cx2000 - 1.153 dlcp_cg - 1.223 fusion - 4.593 naabstrct - 4.233 nabase - 4.233 naccess - 9.04 nacore - 4.233 nademos - 4.233 nadriver - 4.233 nadsp - 4.233 naruntime - 4.233 nccsip - 2.013 nfx - 4.323 nmslm - 2.273 oam - 1.243 spaccess - 1.213 Each Natural Access product now includes a module identification signature file (*.sgn). A pair of utilities, installed by the Natural Access package, use the signature files to provide version information about product modules (files). The utilities are nmsabout and nmssearch. ================================================================================ 2. Product Compatibility ================================================================================ All products contained in NaturalAccess are fully compatible with each other. Product compatibility and dependency checking for the products is part of the NaturalAccess installation procedure. You will be informed of known dependencies and incompatibilities during the NaturalAccess installation process. This release of NaturalAccess supports the following operating systems: Windows Server 2012 Red Hat Enterprise Linux 6.2 ================================================================================ 3. Installation Overview ================================================================================ Refer to the installation booklet (install.pdf) for detailed installation instructions. ================================================================================ 3.1. Dialogic Products ================================================================================ The installation program prompts you for system environment information so it can determine the applicable Dialogic products for your system. It then launches the individual installation programs for each of these products using the information specified. ================================================================================ 4. Installation Specifications ================================================================================ Only one installation cycle is required to install all the applicable products for your system. ================================================================================ 4.1. Cta Configuration Specifications ================================================================================ The NaturalAccess installation updates the [ctasys] section of the cta.cfg file with service and service manager specifications as follows: Package cta.cfg Update ------------------------------------------------------------------ NaturalAccess | Service = ncc, adimgr | Service = adi, adimgr | Service = dtm, adimgr | Service = swi, swimgr | Service = vce, vcemgr | Service = ncc, sipmgr ------------------------------------------------------------------- OAM | Service = oam, oammgr ------------------------------------------------------------------- CX 2000 | Service = cdi, cdimgr ------------------------------------------------------------------ NaturalFax | Service = nfx, nfxmgr | Service = fax, faxmgr | Service = fxm, adimgr ------------------------------------------------------------------ NaturalConference | Service = cnf, cnfmgr ------------------------------------------------------------------ ISDN | Service = isdn, adimgr | Service = imgt, adimgr ------------------------------------------------------------------ Fusion | Service = msp, mspmgr ------------------------------------------------------------------ USAI | Service = sai, saimgr ------------------------------------------------------------------ ================================================================================ 4.2. Minimum Installation Requirements ================================================================================ Typical installation will require approx. 140.0 MB ================================================================================ 5. Product Release Notes ================================================================================ Each Natural Access product has its own release notes. These files are installed with their package in the \nms\doc directory (Windows) or /opt/nms/doc (Linux). ================================================================================ 5.1. Product Documentation ================================================================================ NaturalAccess documentation is available from the NaturalAccess Software Download page on the Dialogic web site, www.dialogic.com. ================================================================================ 5.2 Compiler Support ================================================================================ Visual C++ 9.0 (64 bit) has been used to build Natural Access 9.0.8 for Windows gcc version 4.4.6 has been used to build Natural Access 9.0.8 for Linux ================================================================================ 5.4 Supported Boards ================================================================================ CG 6060 CG 6565 CG 6565 pci-x CG 6565 pci Express ================================================================================ 6. New Features included in NA 9.0.8 ================================================================================ The following new features are included: - Per-channel disable control added to echo canceler ================================================================================ 6.1 Per-channel disable control added to echo canceler ================================================================================ The disable/enable control allows you to enable or disable the hardware echo cancellation feature for a trunk port. Unlike the bypass control, the disable control resets the echo canceler. Use swiConfigLocalTimeslot to disable or enable the canceler, and swiGetLocalTimeslotInfo to retrieve the echo canceler disable state. Set the arguments for these functions as follows: Argument Field Value -------- ----- ----- swihd Handle returned by swiOpenSwitch. args localstream Identifies the target trunk on the local bus. Specify the number of either the transmit or receive voice stream. localtimeslot Identifies the target timeslot on the trunk. Specify the timeslot number of the target trunk port on the local bus. deviceid Device type on the local bus. Valid values are MVIP95_T1_TRUNK_DEVICE and MVIP95_E1_TRUNK_DEVICE. parameterid Data item to configure or query. Set to NMS_ECHO_CHANNEL_DISABLE (0x80000023). buffer Points to the NMS_ECHO_CHANNEL_DISABLE_PARMS structure. Valid values are: 0 = NMS_ECHO_ENABLE_CHANNEL 1 = NMS_ECHO_DISABLE_CHANNEL size Size of buffer, in bytes. The NNMS_ECHO_CHANNEL_DISABLE_PARMS structure is: typedef struct { DWORD disable_channel; // 0=channel enabled, 1=channel disabled } NMS_ECHO_CHANNEL_DISABLE_PARMS; The value returned from the NMS_ECHO_CHANNEL_DISABLE_PARMS structure indicates whether the echo cancellation is enabled or disabled for the specified device. For more information about swiConfigLocalTimeslot or swiGetLocalTimeslotInfo, refer to the Dialogic® NaturalAccess™ Point-to-Point Switching API Developer's Manual. The following example shows how to set the echo canceler disable state: #include "swidef.h" /* Switching service */ #include "mvip95.h" /* MVIP-95 definitions */ #include "nmshw.h" /* Hardware-specific definitions */ DWORD mySetDisable(SWIHD swihd, SWI_TERMINUS terminus, int bDisable) { SWI_LOCALTIMESLOT_ARGS args; NMS_ECHO_CHANNEL_DISABLE_PARMS parms; args.localstream = terminus.stream; /* from board switch model */ args.localtimeslot = terminus.timeslot; /* from board switch model */ args.deviceid = MVIP95_T1_TRUNK_DEVICE; /* mvip95.h */ args.parameterid = NMS_ECHO_CHANNEL_DISABLE; /* nmshw.h */ if ( bDisable) parms.disable_channel = NMS_ECHO_DISABLE_CHANNEL; /* nmshw. */ else parms.disable_channel = NMS_ECHO_ENABLE_CHANNEL; /* nmshw.h */ return swiConfigLocalTimeslot ( swihd, /* switch handle */ & args, /* target device and config item */ ( void*) & parms, /* buffer (defined by parameterid) */ sizeof(parms)); /* buffer size in bytes */ } The following example shows how to retrieve the echo canceler disable state: #include "swidef.h" /* Switching service */ #include "mvip95.h" /* MVIP-95 definitions */ #include "nmshw.h" /* Hardware-specific definitions */ DWORD myGetDisable(SWIHD swihd, SWI_TERMINUS terminus, int* pbDisabled) { SWI_LOCALTIMESLOT_ARGS args; NMS_ECHO_CHANNEL_DISABLE_PARMS parms; DWORD swi = SWI_SUCCESS; args.localstream = terminus.stream; /* from board switch model */ args.localtimeslot = terminus.timeslot; /* from board switch model */ args.deviceid = MVIP95_T1_TRUNK_DEVICE; /* mvip95.h */ args.parameterid = NMS_ECHO_CHANNEL_DISABLE; /* nmshw.h */ swi = swiGetLocalTimeslotInfo ( swihd, /* switch handle */ & args, /* target device and config item */ ( void*) & parms, /* buffer (defined by parameterid) */ sizeof(parms)); /* buffer size in bytes */ if (parms.disable_channel == NMS_ECHO_DISABLE_CHANNEL) /* nmshw.h */ *pbDisabled = 1; // true else *pbDisabled = 0; // false return swi; } ================================================================================