Dialogic DIALOGIC MULTIMEDIA SOFTWARE FOR ADVANCEDTCA RELEASE 1.0 manual

Dialogic ® Multimedia Software f or Ad v ancedTCA Release 1.0 Release Update January 23, 2008 05-2548-00 6[...]

Dialogic ® Multimedia Software for AT CA Release 1.0 Release Update, Rev 06 – Janua ry 23, 2008 Dialogic Corp oration Copy r ight © 2007-2008, Dialogic Corporation. All Rights Reserved. Y ou may not repro duce this document in whole or in par t witho ut permission in writing from Dialogic Corporation. All contents of t his document are furnishe[...]

Dialogic ® Multimedia Software for ATCA Release 1.0 Release Update, Rev 06 — January 23, 2008 3 Dialogic Corporatio n About This Pub lication This section contains inf orm ation ab out the fo llowing topics: • Purpose • Intended Audience • How to Use This Publication • Related Information Purpose This Release Update addre sses issues ass[...]

4 Dialogic ® Multimedia Software for ATCA Release 1.0 Release Update, Rev 06 — January 23, 2008 Dialogic Corporation About This Public ation Related Inf ormation See the f ollowing f or additi onal information: • http://www.d ialogic.com/manu als/ (f or Dialogic ® product documentation) • http://www.d ialogic.com/suppo rt/ (f or Dialogic te[...]

Dialogic ® Multimedia Software for ATCA Release 1.0 Release Update, Rev 06 — January 23, 2008 5 Dialogic Corporatio n Document Re vision Histor y This Re vision History summar izes the cha nges made in each published v ersion of the Release Update f or the Dialogic ® Multimedia Platf or m for Adv ancedTCA, which is a document that is per iodica[...]

6 Dialogic ® Multimedia Software for ATCA Release 1.0 Release Update, Rev 06 — January 23, 2008 Dialogic Corporation Document Revision History structure ha ve updates f or QCELP; updated tab le of suppor ted audio coders in IPM_A UDIO_CODER_INFO section (EVRC cha nge); updated IPM_A UDIO_CODER_OPTIONS_IN FO structure (remov ed CODER_OPT_EVRC_SIG[...]

Dialogic ® Multimedia Software for ATCA Release 1.0 Release Update, Rev 06 — January 23, 2008 7 Dialogic Corporatio n Document Revision History • Added the f ollowin g Resolved Def ects: IPY00036309, I PY00036311, IPY00036314, IPY00036601, IPY00036911. In the Document ation Updates chap ter : • Added update t o the Dialogic® Multimedia API [...]

Dialogic ® Multimedia Software for ATCA Release 1. 0 Release Update, Rev 06 — January 23, 2008 8 Dialogic Corporatio n 1 1 . P ost-Release De velopments This section describes significant changes to Dia logic ® Multimedia Software f or Adv ancedTCA Release 1.0 su bsequent to the general a vailability release date . • Ser vice Update f or Dial[...]

Dialogic ® Multimedia Software for ATCA Release 1. 0 Release Update, Rev 06 — January 23, 2008 9 Dialogic Corporatio n 1.2 Summary of Features The f ollowing table lists the f eatures introduc ed in serv ice updates a fte r the initial release of Dialogic ® Multimedia Softw are fo r AdvancedTCA Relea se 1.0 and where to find more inf or mation [...]

10 Dialogic ® Multimedia Software for ATCA Release 1.0 Release Update, Rev 06 — January 23, 2008 Dialogic Corporation The QCELP coder type supports frame size of 20 ; frames per pack et of 1, 2, or 3; and eV adEnableV alue of CODER_V AD_DISABLE. Updates to IPM_A UDI O_CODER_OPTIONS_INFO The IPM_A UDIO_CODER_OPTIONS_INFO data structure has the f [...]

Dialogic ® Multimedia Software for ATCA Release 1. 0 Release Update, Rev 06 — January 23, 2008 11 Dialogic Corporatio n 2 2 . Release Issues The tab le below lists issues th at can affect the hardware and so ftware suppor ted in the Dialogic ® Multimedia Platf or m f or AdvancedTCA. The f ollowing inf or mation is provided f or each issue: Issu[...]

12 Dialogic ® Multimedia Software for ATCA Release 1.0 Release Update, Rev 06 — January 23, 2008 Dialogic Corporation Issues Sor ted by T ype , Dialogic ® Multimedi a Platform Issue T ype Defect No. SU No. Product or Component Description Known IPY00035453 call control User cannot select TCP or UDP as mode of transpor t for SIP on per call basi[...]

Dialogic ® Multimedia Software for ATCA Release 1. 0 Release Update, Rev 06 — January 23, 2008 13 Dialogic Corporatio n Known IPY00034601 clocking The TDM clock manager does not s witch to a valid clock that is located earlier in the fallbac k list before the failed entry . For e xample, if the last valid trunk clo ck source fails , the fir mwar[...]

14 Dialogic ® Multimedia Software for ATCA Release 1.0 Release Update, Rev 06 — January 23, 2008 Dialogic Corporation Known IPY00038149 hardware Shut down is not suppor ted by opening of the Dialogic ® Multimedia Blade latch. The blue LED (hots wap LED) on the blade will b link indefinitely but ne ver turn solid to indicate shut down complete. [...]

Dialogic ® Multimedia Software for ATCA Release 1. 0 Release Update, Rev 06 — January 23, 2008 15 Dialogic Corporatio n Known (permanent) IPY00033953 IPML Calling ipm_SetPa rm( ) without calling ipm_Open( ) causes the library to crash and the application to ex ception. W orkaround: Do not call any IPML functions without first opening the device.[...]

16 Dialogic ® Multimedia Software for ATCA Release 1.0 Release Update, Rev 06 — January 23, 2008 Dialogic Corporation Resolved IPY00036911 70 MSML F ailure occurs when r unning 120 G.711 and 120 G.729 coders on the Dialogic ® Multimedia Blade. Resolved IPY00036601 70 MSML CMR bits in octet aligned mode are in the wrong location of the AMR-NB RT[...]

Dialogic ® Multimedia Software for ATCA Release 1. 0 Release Update, Rev 06 — January 23, 2008 17 Dialogic Corporatio n Resolved IPY00035425 77 PSTN call control The fir mwa re is printing unnecessar y logs to the messages file. These me ssages can be ignored. The messages are similar to the follo wing: Oct 19 11:10:31 py1atcatvl16 CLIA GENT: F [...]

18 Dialogic ® Multimedia Software for ATCA Release 1.0 Release Update, Rev 06 — January 23, 2008 Dialogic Corporation Resolved IPY00034276 -- video During video record, the recorded file may ha ve missing video RTP p ack ets. In a 3- second recording, 1 or 2 video RTP pack ets are dropped about 10% o f the time. The problem can occur at both low[...]

Dialogic ® Multimedia Software for ATCA Release 1.0 Release Update, Rev 06 — January 23, 2008 19 Dialogic Corporatio n 3 3 . Documentation Updates The document ation updates are divid ed into the f ollowing sect ions, which corr espond to the top le vel cat egor ies used on the online documentat ion navigation page: • System Releas e Documenta[...]

20 Dialogic ® Multimedia Software for AT C A Release 1.0 Release Update, Rev 06 — January 23, 2008 Dialogic Corporation • Dialogic® Conf erencing (C NF) API Programming Guide • Dialogic® De vice Management API Library Ref erence • Dialogic® F ax Software Ref erence • Dialogic® Global Call API Libr ar y Ref erence • Dialogic® Globa[...]

Dialogic ® Multimedia Software for ATCA Release 1. 0 Release Update, Rev 06 — January 23, 2008 21 Dialogic Corporatio n 3.3.7 Dialogic ® Global Call IP T echnolog y Guide Update to Section 4.3.2, Setting Coder Inf ormation In T able 2, “Coder s Suppor ted f or Dialogic ® Host Media Proc essing (HMP) So ftware, ” the f ollowing note should [...]

22 Dialogic ® Multimedia Software for AT C A Release 1.0 Release Update, Rev 06 — January 23, 2008 Dialogic Corporation • T o retrieve T .38 fax port info rmation, set the eMedi aT ype field to MEDIA TYPE_LOCAL_UDPTL_T38_ INFO and unCount to 1. Note: It is not possible to ret rie ve T .38 fax port inform ation together with audio and /or video[...]

Dialogic ® Multimedia Software for ATCA Release 1. 0 Release Update, Rev 06 — January 23, 2008 23 Dialogic Corporatio n P ARMCH_LA TENCYFR AMEINIT_A UDIO Specifies the amount of P acket Loss Recov er y (PLR) latency (delay) that can be introduced by defining the initial number of frames that can be buff ered. This parameter defines the star ting[...]

24 Dialogic ® Multimedia Software for AT C A Release 1.0 Release Update, Rev 06 — January 23, 2008 Dialogic Corporation Update to t he ipm_StartMedia ( ) function An inv alid state erro r is retur ned if a coder is not reser v ed pr ior to calling the ipm_StartMedia( ) function. All aud io coders must be reserved using the dev_Reserve ResourceEx[...]

Dialogic ® Multimedia Software for ATCA Release 1. 0 Release Update, Rev 06 — January 23, 2008 25 Dialogic Corporatio n Update f or the unRedP a yloadT ype field: F or AMR, negotiate d by call control. Update f or the supported audio coders tabl e: T able 1, “Supported Audio Cod er Proper ties , ” should include the f ollo wing additional co[...]

26 Dialogic ® Multimedia Software for AT C A Release 1.0 Release Update, Rev 06 — January 23, 2008 Dialogic Corporation • MEDIA TYPE_VIDEO_REMO TE_CO DER_INFO – remote receiv e video coder informatio n • MEDIA TYPE_VIDEO_REMOTE_R TCP_INFO – remote R TCP video port information • MEDIA TYPE_VIDEO_REMO TE_R TP_IN FO – remote R TP video [...]

Dialogic ® Multimedia Software for ATCA Release 1. 0 Release Update, Rev 06 — January 23, 2008 27 Dialogic Corporatio n ipm_GetCapabilities( ) retriev es capab ility (for example, coder) informatio n  Description The ipm_GetCapab ilities( ) function returns the number of cap abilities of the specified type (for example, coders) and details of[...]

28 Dialogic ® Multimedia Software for AT C A Release 1.0 Release Update, Rev 06 — January 23, 2008 Dialogic Corporation The datatype for the a_CapabilitiesArray[] pa rameter is a union, IPM_CAP ABILITIES, which is defined as follo ws: typedef stru ct ipm_capabil ities_tag { unsigned int version; union { IPM_CO DER_INFO Coder ; // Fut ure types h[...]

Dialogic ® Multimedia Software for ATCA Release 1. 0 Release Update, Rev 06 — January 23, 2008 29 Dialogic Corporatio n  Example In this example, the fi rst ipm_GetCapabilities( ) call retr ie ves only the number of capabilities av ailable (count). That number is then used to allocat e the right amount of memory an d retriev e details of all [...]

30 Dialogic ® Multimedia Software for AT C A Release 1.0 Release Update, Rev 06 — January 23, 2008 Dialogic Corporation IPM_A UDIO_CODER_OPTIONS_INFO AMR and EVRC audio coder o ptions typedef stru ct ipm_audio_c oder_options_i nfo_tag { unsign ed int unVersi on; unsign ed int unCoder Options; unsign ed int unParm1 ; int nV alue1; unsign ed int u[...]

Dialogic ® Multimedia Software for ATCA Release 1. 0 Release Update, Rev 06 — January 23, 2008 31 Dialogic Corporatio n unParm1 set to a value from the eIPM _CODER_OPTION_P ARMS enumeration For AMR, set to 0. For EVRC, where the media type is MEDIA TYPE_A UDIO_REMOTE_CODER_OP TIONS_INFO, v alid value is: • CODER_OPT_INTERLEA VE_LENGTH - Reduce[...]

32 Dialogic ® Multimedia Software for AT C A Release 1.0 Release Update, Rev 06 — January 23, 2008 Dialogic Corporation ipmMediaInfo .MediaData[unC ount].eMediaTy pe = MEDIATYPE_AUDI O_REMOTE_CODER _OPTIONS_INFO; ipmMediaInfo .MediaData[unC ount].mediaInf o.AudioCoderOp tionsInfo.unVe rsion = IPM_AUDIO_CO DER_OPTIONS_IN FO_VERSION; ipmMediaInfo [...]

Dialogic ® Multimedia Software for ATCA Release 1. 0 Release Update, Rev 06 — January 23, 2008 33 Dialogic Corporatio n This feature is only supported when using the Se ssion Initiation Protocol (SIP). N one of the av ailable Session Description Proto col (SDP) optio ns are currently supporte d throu gh Global Call (that is, direct first-party c[...]

34 Dialogic ® Multimedia Software for AT C A Release 1.0 Release Update, Rev 06 — January 23, 2008 Dialogic Corporation • “Octet-aligned, ” to make the packet pa rsing easier for the AMR appl ication. The AMR R TP payload format is specified in the ne w IPM_A UDIO_CODER_OPTION S_INFO AudioCoderOptionsInfo structure (in the IPM_MED IA struc[...]

Dialogic ® Multimedia Software for ATCA Release 1. 0 Release Update, Rev 06 — January 23, 2008 35 Dialogic Corporatio n The following code demonstrates the confi guration required to handle this scenario. ... /* Setup IP address here */ // Local Audio Coder ipmMediaInfo.M ediaData[unCou nt].eMediaType = MEDIATYPE_A UDIO_LOCAL_CO DER_INFO; ipmMed[...]

36 Dialogic ® Multimedia Software for AT C A Release 1.0 Release Update, Rev 06 — January 23, 2008 Dialogic Corporation Note: While the diagram abov e implies an immediate reaction to a CMR fr om the other side, in real ity , the other side’ s response to a CMR may take a fe w packets. The sequence of activities is as follo ws: 1. The host is [...]

Dialogic ® Multimedia Software for ATCA Release 1. 0 Release Update, Rev 06 — January 23, 2008 37 Dialogic Corporatio n ipmMediaInfo.M ediaData[unCou nt].mediaInfo. AudioCoderInfo .eCoderType = CODER_TYPE_AMRNB _7_4k; ipmMediaInfo.M ediaData[unCou nt].mediaInfo. AudioCoderInfo .eFrameSize = CODER_FRAMESIZE_ 20; ipmMediaInfo.M ediaData[unCou nt].[...]

38 Dialogic ® Multimedia Software for AT C A Release 1.0 Release Update, Rev 06 — January 23, 2008 Dialogic Corporation Resource reservation of audio co ders The f ollowing information, which is applic able to the A TCA Multimedia Platform, should be added to th e programming guide , possibly as a ne w chapter . Resource Reserv ation of Audio Co[...]

Dialogic ® Multimedia Software for ATCA Release 1. 0 Release Update, Rev 06 — January 23, 2008 39 Dialogic Corporatio n Inbound Call 1. The INVITE from re mote side specifies a list of coders. 2. Application may choose to reserve all or some of the coders that the remote side offered and then respond to the remote side with local coder capabilit[...]

40 Dialogic ® Multimedia Software for AT C A Release 1.0 Release Update, Rev 06 — January 23, 2008 Dialogic Corporation 8. Application releases coder b y issui ng a call to release RESOURCE_IPM_G723. Handling a Resour ce Reser va tion Failure 1. A call to reserve resources (RESOURCE_IPM_G726, RESOURCE_IPM_G729) fails for lack of av ailable resou[...]

Dialogic ® Multimedia Software for ATCA Release 1. 0 Release Update, Rev 06 — January 23, 2008 41 Dialogic Corporatio n 6. Application i ssues call to release resource RESOURCE_IPM_G7 26. Reservation State after a Subsequen t Call to Resour ce Reser vation Fai l s 1. Application issu es call to re serve resources (RESOURCE_IPM_G726, RESOURCE_IPM[...]

42 Dialogic ® Multimedia Software for AT C A Release 1.0 Release Update, Rev 06 — January 23, 2008 Dialogic Corporation 9. Application issues call to rel ease resources (RESOURCE_IPM_G726, RESOURCE_IPM_G729). It may also use a single enum RESOURCE_IPM_ALL_A UDIO_CODERS to release all the reserved audio coders as opposed to having to list e very [...]

Dialogic ® Multimedia Software for ATCA Release 1. 0 Release Update, Rev 06 — January 23, 2008 43 Dialogic Corporatio n 3.3.12 Dialogic ® Standard Runtime Librar y API Library Reference There are curre ntly no updates to this documen t. 3.3.13 Dialogic ® Standard Runtime Librar y API Programming Guide There are curre ntly no updates to this do[...]

44 Dialogic ® Multimedia Software for AT C A Release 1.0 Release Update, Rev 06 — January 23, 2008 Dialogic Corporation[...]