====================================================================================== readme.txt January 2013 Dialogic(R) NaturalAccess(TM) Development Environment Release 9.0.8 Readme (C)Copyright 2013 Dialogic Corporation ====================================================================================== ************************************************************************************** ***************************IMPORTANT NOTICES****************************************** - This release of NaturalAccess supports the following operating systems: Red Hat Enterprise Linux 6.2 Windows Server 2012 - NaturalAccess 9.0.8 supports the following boards: CG 6060, all variants (CG 6060 PCI, CG 6060C) CG 6565, all variants (CG 6565 PCI, CG 6565C, CG 6565E) - Hot Swap is not supported. - Video Access is not included in this release. - Refer to Section 6 of this document for new features supported in this release. - Before carrying out a NaturalAccess installation, uninstall all previous versions, not just of NaturalAccess, but also of VideoAccess if previously installed. 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. */ - 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/media/system-release-software/download/natural-access-software.aspx ================================================================================ 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 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 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. Installation Overview ================================================================================ Refer to the installation PDF file for detailed installation instructions. Only one installation cycle is required to install all the applicable products for your system. ***Notes: Remove all existing NaturalAccess components, and VideoAccess (vaccess) before the installation of NA9.0.8. ***(Linux "Compatibility Mode" [64 bits with 32 bit applications]:) By default, installation of linux 6.2-64 kernel does not install 32-bit packages. You may need to manually install the following packages that are required by NA9.0.8. ncurse-libs-xxx.el6.i686.rpm libstdc++-xxx.el6.i686.rpm libgcc-xxx.el6.i686.rpm glibc-xxx.el6.i686.rpm (Linux only:) The /opt/nms/doc/install.log file contains a record of the NaturalAccess product installation. ================================================================================ 2.1. Minimum Installation Requirements ================================================================================ Typical installation will require approx. 150 MB ================================================================================ 3. 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 = sai, saimgr | Service = ncc, sipmgr ------------------------------------------------------------------- OAM | Service = oam, oammgr ------------------------------------------------------------------- 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. OS and Compiler Support ================================================================================ Linux ----- Red Hat Linux 6 Update 2 64 bits with 64 bit applications Red Hat Linux 6 Update 2 64 bits with 32 bit applications gcc version 4.4.6 has been used to build Natural Access 9.0.8 for Linux Windows ------- Windows Server 2012 with 64 bit applications Visual C++ 9.0 (64 bit) has been used to build Natural Access 9.0.8 for Windows ================================================================================ 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. New Features included in NA 9.x ================================================================================ - Universal Speech Access (SAI) - MRCP 1.0 - SIP for Natural Call Control (NCCSIP) - Native play & record added to EVRC codec (supports the EDTX file format and the raw EVRC file format). - The evrc_convert utility converts raw EVRC files to EDTX file formats and vice versa. Type evrc_convert -h for the list of options. - The natprtest utility has been updated to accept the new EVRC codec ids. - DTMF parameter control added to Fusion encoders - ISDN: Q.Sig Transfer (path replacement) support added - NMSabout is replacing "Ctavers" and "Naver" to check installed package versions (ctavers and Naver utilities no longer being maintained) - HiZ support for the CG 6565e PCI Express Media Board - Per-channel disable control added to echo canceler -- documented below ================================================================================ 5.3. Features no longer supported ================================================================================ - PPX service - V5.2 protocol - GR303 protocol ================================================================================ 6. New Features included in NA 9.0.8 ================================================================================ The following new features are included, and documented below: - 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; } ================================================================================