Dialogic® Host Media Processing Software Release 4.
Copyright and Legal Notice Copyright © 2009 - 2011, Dialogic Inc. All Rights Reserved. You may not reproduce this document in whole or in part without permission in writing from Dialogic Inc. 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 Inc. and its affiliates or subsidiaries (“Dialogic”).
Contents Document Revision History. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 About This Publication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 Applicability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents 5.7 5.8 5.9 5.10 5.11 5.12 5.13 6 Supported Hardware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 6.1 6.2 7 Dialogic® HMP Interface Boards . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 Dialogic® DSI SS7 Boards and Dialogic® DSI Signaling Servers. . . . . . . . . . . . . . . . . . . . 45 Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Document Revision History This revision history summarizes the changes made in each published version of the Release Guide for Dialogic® Host Media Processing Software Release 4.1LIN, which is a document that may be subject to updates during the lifetime of the release. Document Rev 05 – published June 2011 Includes updates for Service Update 32 through 86. Updates to the Basic Software Requirements section: • In Supported Compilers, added version 4.1.x to the GNU Compiler Collection (GCC).
Document Revision History uninstalling the existing version.” This statement is incorrect. You must uninstall the previous version before upgrading to a later version. • In Licensing section, added additive licensing. In the Programming Libraries chapter: • In New Dialogic® Media Toolkit API Library, replaced the text under the “Media toolkit (mtk) functions” item. (IPY00081664) • In Dialogic® 3G-324M API Library, added H.264. • In Dialogic® Conferencing (CNF) API Library, added monitor mode.
Document Revision History Document Rev 03 – published January 2010 Updated to include support for the following features of the Dialogic® HMP Software Release for 3.1LIN added in Service Update 23: • Continuous Speech Processing (CSP) • H.323 Signaling Support • Modified Media (SIP re-INVITE and IP Call Control) • Multimedia user I/O • Automatic Gain Control (AGC) and Volume Control In the Features chapter: • Added Multimedia User I/O under Multimedia (Audio/Video) Play and Record. • Added H.
Document Revision History 8 Dialogic® Host Media Processing Software Release 4.
About This Publication The following topics provide more information about this publication: • Applicability • Intended Audience • How to Use This Publication • Related Information Applicability This document provides information about the features, system requirements, and release documentation for the Dialogic® Host Media Processing Software Release 4.1LIN (also referred to as Dialogic® HMP Software 4.1LIN). Intended Audience This document is intended for all users of Dialogic® HMP Software 4.1LIN.
About This Publication Related Information See the following for additional information: • Dialogic® Host Media Processing Software Release 4.1LIN Release Update for information about known problems, resolved problems, and documentation updates associated with this release. Refer to the Release Update for late-breaking changes or corrections to the release information. Information is intended to be updated in the Release Update, as needed, during the life cycle of the release. • http://www.dialogic.
Release Overview 1. 1 This chapter provides an overview of the Dialogic® Host Media Processing (HMP) Software as well as a high-level overview of the products and features that are newly supported in Dialogic® Host Media Processing Software Release 4.1LIN (also known as Dialogic® HMP Software 4.1LIN). Dialogic® HMP Software performs media processing tasks on general-purpose servers without the need for specialized hardware. Media processing takes place on the host processor.
Release Overview Software Restrictions This software is subject to the U.S. Export Administration Regulations and other U.S. law, and may not be exported or re-exported to certain countries (as of the date of publication of the most recent release, Burma, Cuba, Iran, Libya, N. Korea, Sudan and Syria). Dialogic will not participate in an export or reexport transaction subject to the EAR with a person whose export privileges have been denied by the BIS.
System Requirements 2. 2 This chapter describes the hardware and software requirements for Dialogic® Host Media Processing Software Release 4.1LIN. • Basic Hardware Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 • Basic Software Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 2.
System Requirements Supported Operating Systems • Red Hat Enterprise Linux Release 5.0 with Update 2, Update 3, Update 4, Update 5, and Update 6 • Red Hat Enterprise Linux Release 4.
Features 3. 3 This chapter describes the features that are supported in Dialogic® Host Media Processing Software Release 4.1LIN (Dialogic® HMP Software 4.1LIN). Features and functionality that are new since Dialogic® Host Media Processing Software Release 3.1LIN are identified. • New Multimedia (Audio/Video) Transcoding . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 • New Multimedia (Audio/Video) Conferencing . . . . . . . . . . . . . . . . . . . . . . . . . . 16 • New Image Overlay . . . . . .
Features different format than that of the locally stored file. Transcoding involves decoding and decompressing the original data to a raw intermediate format (YUV format), then converting the raw intermediate format to another encoding format. Video transrating adjusts the number of video frames per second (and bitrate of the video) between two endpoints to suit the requirements of the device at each endpoint.
Features Multimedia conferencing allows a real-time audio/video session between two or more participants whose call can originate from the IP network or TDM network. Participants in a multimedia conference can be audio only, video only, or audio and video. You must apply multimedia transcoding for all participants of a conference; apply audio transcoding for audio participants and video transcoding for video participants. For more information on transcoding, see Section 3.
Features If the Dialogic® HMP Software 4.1LIN is installed on a media server (MS), the MSML media server software enables a remote client, also known as an application server (AS), to control media resources. The MSML media server software is based on the evolving MSML language, as defined in the IETF RFC 5707.
Features For additional information about operating system requirements, see Section 2.2, “Basic Software Requirements”, on page 13. This feature specifically focuses on the VMware® ESXi 4.0 installable product which provides a native (or full) virtualization layer running on physical servers for abstracting processor, memory, storage, and resources into multiple virtual machines. For more information about virtualization, refer to the VMware web site at www.vmware.com. Notes:1.
Features CPU Affinity Settings To run real-time software on VMware® ESXi, use CPU affinity. This is the recommended method for real-time voice since each virtual processor can get CPU resources directly from one or more of the available host CPUs, reducing the likelihood that virtual processors are rescheduled to give CPU time to another virtual machine. Each virtual machine is more isolated, which helps real-time software run as though it were in a physical server environment.
Features For HMP media quality, it is recommended that the guest operating system operates with the ntpd process disabled to prevent NTP timing synchronization conflicts between the guest operating system and the ESX server. Use the setup command from the console to disable the ntpd feature prior to starting HMP software. Resource Budgeting The same HMP requirements for system resources are required when operating in a VMware® ESXi environment.
Features 3.8 SS7 Support No new SS7 features are added in this release. For a list of currently supported boards, see Section 6.2, “Dialogic® DSI SS7 Boards and Dialogic® DSI Signaling Servers”, on page 45. For technical specifications, see http://www.dialogic.com/products/signalingip_ss7components/signaling_boards.htm. The Dialogic® Global Call software supports the development of call control applications that use SS7 technology.
Features • Video picture formats – QCIF • Frame rate – Up to 15 frames per second (fps) • Bit rate – Up to approximately 43 kbps Video transcoding, video transrating, and image resizing Video transcoding enables applications to record incoming video in a different format than what is being received from the network and to play back outgoing video in a different format than that of the locally stored file.
Features 3.10 Codecs for RTP Interface This section describes supported audio codecs and video codecs for RTP. Audio Codecs for RTP Supported audio codecs for RTP include: • G.711 – 64 kbps format, mu-law and A-law, at 10, 20, or 30 ms frames • G.723.1 – 5.3 and 6.3 kbps, 30 ms frames, and 1, 2 or 3 frames per packet • G.726 – 16, 24, 32 and 40 kbps – 20 ms frame size, 1, 2, or 3 frames per packet • G.729A (compatible with G.729 format) – 8 kbps, 10 ms frames, and 2, 3, or 4 frames per packet • G.
Features • Bit Rate – Up to 384 kbps RTP video data is compliant with Internet Engineering Task Force RFC 3016, RTP Payload Format for MPEG-4 Audio/Visual Streams. H.264 video codec H.264 is supported with these characteristics: Baseline Profile, Level 1 • Video picture formats – QCIF • Frame rate – Up to 15 fps • Bit rate – Up to 64 kbps Baseline Profile, Level 1b • Video picture formats – QCIF • Frame rate – Up to 15 fps • Bit rate – Up to 128 kbps Baseline Profile, Level 1.
Features • Frame rate – Up to 15 fps • Bit rate – Up to 64 kbps Profile 0, Level 20 • Video picture formats – Sub-QCIF, QCIF, CIF • Frame rate – Sub-QCIF and QCIF up to 30 fps; CIF up to 15 fps • Bit rate – Up to 128 kbps Profile 0, Level 30 • Video picture formats – Sub-QCIF, QCIF, CIF • Frame rate – Up to 30 fps • Bit rate – Up to 384 kbps RTP video data is compliant with Internet Engineering Task Force RFC 2190, RTP Payload Format for H.263 Video Streams. 3.
Features Digital Video Recorder (DVR) controls These controls enable the user to pause, resume, and seek during video and audio playback. DVR controls are supported for native connections or transcoding-enabled connections. This feature is implemented in the Dialogic® Multimedia API Library. Direct 3GP (3GPP) file play This feature enables a standard 3GP file to be played. The file can contain AMR-NB audio format and MPEG-4 video format; or AMR-NB and hinted H.263 using RFC 2190 or RFC 2429 (H.
Features • Play to and record from SIP devices, depending on capability of device (audio or audio/video). Play video only if no audio is required. Play audio only for non-video devices.
Features In addition to IPM to IPM connections, native hairpinning connections may also be formed between 3G-324M and IPM devices. Connections between devices are made using the Dialogic® Device Management API library. Use cases for native RTP hairpinning include switching type applications, such as an IPPBX, or streaming data to/from an external speech server.
Features enhancement to RTP that provides confidentiality, message authentication, and replay protection for RTP and the companion Real Time Control Protocol (RTCP). “Replay protection” is protection against the interception of an RTP packet and later reintroduction into the packet stream. For more information, see the Dialogic® IP Media Library API Programming Guide and Library Reference. 3.17 Audio (Voice) Play and Record New voice play and record features in Dialogic® HMP Software 4.
Features For information about multimedia play and record, see Section 3.12, “Multimedia (Audio/Video) Play and Record”, on page 26. 3.18 Other Features The following features from Dialogic® Host Media Processing Software Release 3.1LIN are supported: IP Call Control IP call control resources supports 3PCC. This feature enables one entity to create, modify, or terminate a media session between two or more endpoints. Call control signaling and media exchange are independently managed.
Installation, Configuration, and Licensing 4. 4 This chapter describes the installation, configuration, and licensing features that are supported in Dialogic® Host Media Processing Software Release 4.1LIN. • Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32 • Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32 • Licensing. . . . . . . . . . . . . . . . . . . . . . . . . .
Installation, Configuration, and Licensing 4.3 Licensing The following licensing capabilities are supported in this release: Host-based licensing The license is associated with a particular machine based on the machine’s MAC address (Host ID). Note: If you have a board in the system, then a host-based license will not work (board-based licensing has a higher priority than host licensing).
Programming Libraries 5. 5 This chapter describes the development libraries that are available in Dialogic® Host Media Processing Software Release 4.1LIN. • New Dialogic® Media Toolkit API Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34 • Dialogic® 3G-324M API Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35 • Dialogic® Conferencing (CNF) API Library . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Programming Libraries Features The Media Toolkit API library provides the following functionality in Dialogic® HMP Software 4.1LIN: Media toolkit (mtk) functions Used to create templates for images and frames. For images, only YUV 4:2:0 format and JPEG format are supported. Note: The input YUV 4:2:0 or JPEG image file size should not exceed 152,064 bytes. This limit is based upon the maximum file size required to support CIF (352x288) frames in YUV 4:2:0 format.
Programming Libraries The 3G-324M API library can be used in conjunction with other API libraries to develop multimedia services such as video conferencing, video-on-demand, surveillance, and multimedia entertainment services. For more information about this API library, see the Dialogic® 3G-324M API Programming Guide and Library Reference. New Features The 3G-324M API library provides the following new capabilities in Dialogic® HMP Software 4.
Programming Libraries New Features The Dialogic® Conferencing (CNF) API library provides the following new capabilities in Dialogic® HMP Software 4.1LIN: Multimedia (audio/video) conferencing Provides the ability to combine images from conference participants into a single image viewed by the conference participants.
Programming Libraries New Features The Dialogic® Device Management API library provides the following new capabilities in Dialogic® HMP Software 4.1LIN: Video transcoding, video transrating, and image resizing The device management API library provides the ability to connect devices together, as a native connection or for transcoding. Transcoding is invoked when connections are formed. Use the DMFL_TRANSCODE_ON flag in the DM_PORT_CONNECT_INFO structure to enable transcoding.
Programming Libraries 5.7 Dialogic® Fax API Library The Dialogic® Fax API library supports development of a wide variety of fax applications such as fax mail, fax broadcast and fax-on-demand. The fax software includes library functions, device drivers, and firmware files. See the Dialogic® Fax Software Reference for more information. New Features No new features have been added since Dialogic® Host Media Processing Software Release 3.1LIN. 5.
Programming Libraries application can let the far end UA request the bit rate. Feature enablement and disablement can be controlled either at the IPT board-level device or the IPT network device (channel). Overlap-receive support for limited SIP-I interworking scenarios Provides a method for handling overlap-receive SIP calls, where called party addressing is supplied in multiple INVITEs but needs to be propagated to the application as standard en bloc signaling calls.
Programming Libraries 5.9 Dialogic® IP Media API Library The Dialogic® IP Media Library API (IPML API) is used to control media on IP devices.
Programming Libraries 5.10 Dialogic® Multimedia API Library The Dialogic® Multimedia API library is used to play and record digitized multimedia in support of applications providing video services, such as video mail, video color ring, video caller ID, and video location-based services. For more information, see the Dialogic® Multimedia API Programming Guide and Library Reference.
Programming Libraries Proprietary audio and video file formats This format is used with RTP play and record. The MM_AUDIO_CODEC structure and MM_VIDEO_CODEC structure are updated with enumerated values. For more information on the proprietary file formats, see the Dialogic® Multimedia File Conversion Tools User Guide. Multimedia user I/O This feature enables applications to directly play and record RTP data via user I/O buffers.
Programming Libraries New Features The Dialogic® Voice API library provides the following new capabilities in this release: New audio codec Record and playback of G.729A audio files in Microsoft WAV file format. Support for dx_setchxfercnt( ) This function sets the bulk queue buffer size for a channel and is typically used in conjunction with user I/O or streaming to board. Support for dx_listentransparent( ) This function is used in recording/playing raw E1/T1 DS0 64 Kbps bit streams.
Supported Hardware 6. 6 This chapter lists the boards supported in Dialogic® HMP Software 4.1LIN. • Dialogic® HMP Interface Boards . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 • Dialogic® DSI SS7 Boards and Dialogic® DSI Signaling Servers . . . . . . . . . . 45 6.
Supported Hardware For technical specifications, see http://www.dialogic.com/products/signalingip_ss7components/signaling_boards.htm and http://www.dialogic.com/products/signalingip_ss7components/signaling_servers_and_gat eways.htm. 46 Dialogic® Host Media Processing Software Release 4.
7 Documentation 7. This chapter provides information about the documentation that supports the Dialogic® Host Media Processing Software Release 4.1LIN (Dialogic® HMP Software 4.1LIN). This information is organized into the following sections: • Documentation Feature Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47 • Release Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49 • Installation and Configuration Documentation .
Documentation Table 1. Documentation Feature Support (Continued) Topic or Feature 3G-324M interface Dialogic® HMP Software 4.
Documentation Table 1. Documentation Feature Support (Continued) Topic or Feature Multimedia (audio/video) transcoding Dialogic® HMP Software 4.
Documentation 7.3 Installation and Configuration Documentation The following installation and configuration documentation is provided for this release: • Dialogic® Host Media Processing Software Release 4.
Documentation • Dialogic® Standard Runtime Library API Library Reference • Dialogic® Standard Runtime Library API Programming Guide • Dialogic® Voice API Library Reference † • Dialogic® Voice API Programming Guide † Note: A dagger (†) next to a document title indicates that the document is new or has been updated since Dialogic® HMP Software 3.1LIN. 7.
