Dialogic DIALOGIC MULTIMEDIA SOFTWARE FOR ADVANCEDTCA RELEASE 1.0 manual

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44

Go to page of

A good user manual

The rules should oblige the seller to give the purchaser an operating instrucion of Dialogic DIALOGIC MULTIMEDIA SOFTWARE FOR ADVANCEDTCA RELEASE 1.0, along with an item. The lack of an instruction or false information given to customer shall constitute grounds to apply for a complaint because of nonconformity of goods with the contract. In accordance with the law, a customer can receive an instruction in non-paper form; lately graphic and electronic forms of the manuals, as well as instructional videos have been majorly used. A necessary precondition for this is the unmistakable, legible character of an instruction.

What is an instruction?

The term originates from the Latin word „instructio”, which means organizing. Therefore, in an instruction of Dialogic DIALOGIC MULTIMEDIA SOFTWARE FOR ADVANCEDTCA RELEASE 1.0 one could find a process description. An instruction's purpose is to teach, to ease the start-up and an item's use or performance of certain activities. An instruction is a compilation of information about an item/a service, it is a clue.

Unfortunately, only a few customers devote their time to read an instruction of Dialogic DIALOGIC MULTIMEDIA SOFTWARE FOR ADVANCEDTCA RELEASE 1.0. A good user manual introduces us to a number of additional functionalities of the purchased item, and also helps us to avoid the formation of most of the defects.

What should a perfect user manual contain?

First and foremost, an user manual of Dialogic DIALOGIC MULTIMEDIA SOFTWARE FOR ADVANCEDTCA RELEASE 1.0 should contain:
- informations concerning technical data of Dialogic DIALOGIC MULTIMEDIA SOFTWARE FOR ADVANCEDTCA RELEASE 1.0
- name of the manufacturer and a year of construction of the Dialogic DIALOGIC MULTIMEDIA SOFTWARE FOR ADVANCEDTCA RELEASE 1.0 item
- rules of operation, control and maintenance of the Dialogic DIALOGIC MULTIMEDIA SOFTWARE FOR ADVANCEDTCA RELEASE 1.0 item
- safety signs and mark certificates which confirm compatibility with appropriate standards

Why don't we read the manuals?

Usually it results from the lack of time and certainty about functionalities of purchased items. Unfortunately, networking and start-up of Dialogic DIALOGIC MULTIMEDIA SOFTWARE FOR ADVANCEDTCA RELEASE 1.0 alone are not enough. An instruction contains a number of clues concerning respective functionalities, safety rules, maintenance methods (what means should be used), eventual defects of Dialogic DIALOGIC MULTIMEDIA SOFTWARE FOR ADVANCEDTCA RELEASE 1.0, and methods of problem resolution. Eventually, when one still can't find the answer to his problems, he will be directed to the Dialogic service. Lately animated manuals and instructional videos are quite popular among customers. These kinds of user manuals are effective; they assure that a customer will familiarize himself with the whole material, and won't skip complicated, technical information of Dialogic DIALOGIC MULTIMEDIA SOFTWARE FOR ADVANCEDTCA RELEASE 1.0.

Why one should read the manuals?

It is mostly in the manuals where we will find the details concerning construction and possibility of the Dialogic DIALOGIC MULTIMEDIA SOFTWARE FOR ADVANCEDTCA RELEASE 1.0 item, and its use of respective accessory, as well as information concerning all the functions and facilities.

After a successful purchase of an item one should find a moment and get to know with every part of an instruction. Currently the manuals are carefully prearranged and translated, so they could be fully understood by its users. The manuals will serve as an informational aid.

Table of contents for the manual

  • Page 1

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

  • Page 2

    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[...]

  • Page 3

    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[...]

  • Page 4

    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[...]

  • Page 5

    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[...]

  • Page 6

    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[...]

  • Page 7

    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 [...]

  • Page 8

    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[...]

  • Page 9

    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 [...]

  • Page 10

    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 [...]

  • Page 11

    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[...]

  • Page 12

    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[...]

  • Page 13

    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[...]

  • Page 14

    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. [...]

  • Page 15

    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.[...]

  • Page 16

    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[...]

  • Page 17

    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 [...]

  • Page 18

    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[...]

  • Page 19

    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[...]

  • Page 20

    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[...]

  • Page 21

    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 [...]

  • Page 22

    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[...]

  • Page 23

    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[...]

  • Page 24

    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[...]

  • Page 25

    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[...]

  • Page 26

    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 [...]

  • Page 27

    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[...]

  • Page 28

    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[...]

  • Page 29

    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 [...]

  • Page 30

    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[...]

  • Page 31

    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[...]

  • Page 32

    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 [...]

  • Page 33

    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[...]

  • Page 34

    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[...]

  • Page 35

    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[...]

  • Page 36

    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 [...]

  • Page 37

    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].[...]

  • Page 38

    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[...]

  • Page 39

    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[...]

  • Page 40

    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[...]

  • Page 41

    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[...]

  • Page 42

    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 [...]

  • Page 43

    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[...]

  • Page 44

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