Intel 05-2352-005 manual

Intel NetStructure ® Host Media Pr ocessing Software Release 1.2 fo r L i n u x Release Update September 2006 05-2352-00 5[...]

HMP Linux 1 .2 Release U p date, Rev 05 — Se ptember 2006 INFORMA TION IN THIS DOCUMENT IS PRO VIDED IN CONNECTION WITH I NTEL® PRODUCTS. NO LI CENSE, EXPRESS OR IMPLIED , BY EST OPPEL OR OT HERWISE, T O ANY INTELLECTU AL PROPER TY RIGHTS IS GRANTED BY THIS DOCUMENT . EXCEPT AS PR OVI DED IN INTEL'S TERMS AND CONDITIONS OF SALE FOR SUCH PR [...]

HMP Linux 1.2 Release Update, Re v 05 — September 200 6 3 About This Pub lication This se ction co ntains infor mation abo ut the f ol lowing topics: • Purpose • Intended A udience • How to U se This Public ation • Relat ed Informatio n Purpose This Relea se Update addres ses issues as sociated wi th Intel ® NetStr ucture™ Host Med ia [...]

HMP Linux 1.2 Release Update, Re v 05 — September 200 6 4 About This Publication Related Information See the following f or add itional infor mation: • For furth er inf or mation on issue s that hav e an ass ociated defect number , you ma y use the web-ena b led Def ect Q uer y tool at: http:// membersreso urce.intel.co m/defects/ When you se l[...]

HMP Linux 1.2 Release Update, Re v 05 — September 200 6 5 Document Re vision Histor y This revision h istory summar izes the changes made in eac h published version of t he Release Update fo r In tel ® NetStr ucture™ Ho st Media Pr ocessing So ftware Release 1.2 for Linux, which is a docume nt that is su bject to updat es duri ng the lifetime [...]

HMP Linux 1.2 Release Update, Re v 05 — September 200 6 6 Document Revision Hist or y The P ost -Release De velopmen ts section includes th e f ollowing changes: • Added s uppor t for T ransacti on Record. See Sectio n 1.6, “Transaction Record ” , on page 12. The Rel ease Issues s ection con tains the following changes : • Added th e f ol[...]

HMP Linux 1.2 Release Update, Re v 05 — September 200 6 7 Document Revision Hist or y • In the Rel ease Docu mentation se ction, add ed inf or matio n about revising T able 2 of the Relea se Guide to suppor t 12 0 low bit rate coders ( Enhanced RTP resourc es). • In the Dem onstration Sof tware Documentati on section, added note with respect [...]

HMP Linux 1.2 Release Update, Re v 05 — September 200 6 8 1 1 . P ost-Release De velopments This secti on describe s significant chang es to the Intel® NetStr ucture™ Host Media Process ing Software Rel ease 1.2 for Linux subs equent to the ge neral av ailabi lity relea se date. • Service Upd ate for Host M edia Proces sing Software 1 .2 for[...]

HMP Linux 1.2 Release Update, Re v 05 — September 200 6 9 1.2.1 Assumptions and Prerequisites The following a re basic req uirement s to inst all and r un the HMP s oftware: • Before installing th e HMP Sof tware , ma k e s ure that the sy stem meets th e hardware and software “System Require ments” as des cribed the HMP Software Releas e G[...]

HMP Linux 1.2 Release Update, Re v 05 — September 200 6 10 3. Manuall y star t HMP s er vices usi ng dlsta rt . HMP ser vi ces will star t automatically whenev er you reboo t y our system. 1.2.3 Installing the Service Update The following pro cedure descr ibes how to ins tall the Ser vi ce Update. 1. Log in to the Linux syste m as root. 2. Downlo[...]

HMP Linux 1.2 Release Update, Re v 05 — September 200 6 11 7. At this point, you hav e two opti ons: • Enter y if you already have obtained a li cense or want to use the verif ication license s upplied with the software. F ollow the proc edure f or act iv ati ng a license in Sectio n 2.4 of the Host Media Pr ocessing S oftware Release 1 .2 f or[...]

HMP Linux 1.2 Release Update, Re v 05 — September 200 6 12 Update 1 li braries. F ailure to us e this environment variable in mak efiles m a y caus e linking failures due to po tential name c onflict s . 1.3 Suppor t f o r SUSE Lin ux Ente rprise Server 9.2 The Se rv ice Update al so provides sup por t f o r SUSE Linux E nter prise Ser v er 9 .2.[...]

HMP Linux 1.2 Release Update, Re v 05 — September 200 6 13 For additional I nf or mation about T ran saction Rec ord, see Section 3.4 .14, “Voice A PI for Host Medi a Processi ng Library Refer ence” , on page 34 and S ection 3.4.15, “Voic e API for Host Med ia Pr ocessing Prog ramming Guide ” , on page 41 .[...]

HMP Linux 1.2 Release Update, Re v 05 — September 200 6 14 2 2 . Release Issues This ch apter inclu des the following topics that relate to release issues: • Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 • Restri ctions and Limitations . . . . . . . . . . . . . . . . [...]

HMP Linux 1.2 Release Update, Re v 05 — September 200 6 15 Descripti on A summ ar y descr iption of the issue. For non-res olv e d issues, a work around is includ ed when av ai lab l e. T able 1. Issues Re solved in HMP 1. 2 Defect Number PTR Number SU No. Pr oduct or Component Description IPY00033948 -- 18 HMP dlstop does not s top all Dialogic [...]

HMP Linux 1.2 Release Update, Re v 05 — September 200 6 16 IPY00009204 33894 6 CSP/V oice During heavy load, while running CSP and voice together , the HMP system may miss an e vent and ha ve a channel st ay bus y . IPY00009082 33762 6 Global Call Segmentation f ault in gc_Star t() when more than 1024 files hav e been opened prior to calling gc_S[...]

HMP Linux 1.2 Release Update, Re v 05 — September 200 6 17 IPY00011249 33376 6 Install During the install, instead of entering 1 to install the HMP software, if a 1` entered. (the 1 and the k ey to the left of the 1 ke y), the install prints out some error messages and then installs only two of the pac kages (O OC and DMDEV). IPY00011233 33363 6 [...]

HMP Linux 1.2 Release Update, Re v 05 — September 200 6 18 2.2 Restrictions an d Limitations Known rest rictio ns and limi tations in th is release c an be categor ized as follows: • Genera l • Vo i c e • Fa x • Global Cal l, IP , and IPML • Vo i c e General • High I/O activity (for e x ample, updatedb) dur ing heavy HMP a ctivity may[...]

HMP Linux 1.2 Release Update, Re v 05 — September 200 6 19 • DM3Stder r and DebugAngel di agnostics tools are not s uppor ted in this releas e . As a wa y to d ebug DM3 firmware, all fi rmware pr ints are se nt to /var/log/messages b y default. They can be sent to stdout when th e boot ker nel is r un in n on-daemon m ode. Y ou must ens ure tha[...]

HMP Linux 1.2 Release Update, Re v 05 — September 200 6 20 • If usin g a non-G lobal Call call co ntrol stack, the ap plicatio n should st op RTP session s b y using ipm_Stop() . • Using the dlstop and dl start c ommands t o stop and then star t HMP . • An appl ication sho uld not open m ore than 1024 files in a p rocess. If an a pplication[...]

HMP Linux 1.2 Release Update, Re v 05 — September 200 6 21 Global Cal l applicat ions that us e the host-ba sed H.323 protocol stack may generate the follo wi ng error mes sage in the g c_h3r .log f ile if the applicatio n enables the s tac k to send the PROCEEDING messa ge automatic ally . ! 22:22:19 .393 ! M_SI GNAL ! L_ERROR ! 1 ! << SIG[...]

HMP Linux 1.2 Release Update, Re v 05 — September 200 6 22 3. Using a te xt edi tor , op en the .con fig file. 4. Locate th e [IPVSC] section in the .config file. 5. In the [IP VSC] sectio n, locate the line setparm 0x4005, 49512 !set the rtpPortBas e on IPVSC The numbe r 49512 is t he default v alu e f or th is parameter . Y ou m a y cha nge the[...]

HMP Linux 1.2 Release Update, Re v 05 — September 200 6 23 The numbe r 6000 is th e def ault v alue f or thi s parameter . Y ou may change t he beginni ng of the T .38 se rv ice por t range b y fi rst editing this value and saving th e .config file. 6. After you hav e sa ved the .co nfig file with the new T .38 ser vice p or t value, open the Com[...]

HMP Linux 1.2 Release Update, Re v 05 — September 200 6 24 the 32 se cond tim eout is reac hed, a CAN CEL will be s ent by HMP to the r emote site. If there i s no response by t he remote si te to the CANCEL , there will be an additio nal 32 second timeout, at the end of whic h, a GCEV_D ISCONNECTED ev e nt will be repo r ted. Supervised T ransfe[...]

HMP Linux 1.2 Release Upda te, Rev 05 — Septe mber 2006Sep tember 2006 25 3 3 . Documentation Updates The doc umentation u pdates are d ivided into the f o llowing sectio ns , which corres pond to the to p le vel catego ries use d in the onli ne docume ntation navigatio n page: • Release Documentatio n . . . . . . . . . . . . . . . . . . . . . [...]

HMP Linux 1.2 Release Upda te, Rev 05 — Septe mber 2006Sep tember 2006 26 In Chapter 2, “System Requi rements” , the following sect ion is added : 2.4 Running a Demo Usin g a Single Channel The default cha nnel license provided with the HM P Linux 1.2 so ftware relies on th e correctn ess of the / etc/hosts fi le. In valid entr ies in thi s f[...]

HMP Linux 1.2 Release Upda te, Rev 05 — Septe mber 2006Sep tember 2006 27 4. Sele ct Red Hat Enterpr ise Linux AS from the Channel Name l ist. 5, Sele ct Downloads from the menu selectio ns . 6. After rea ding and a cceptin g the License A greement, follow the in struct ions provided on the Web page to download the four ISO Bina ry Discs that com[...]

HMP Linux 1.2 Release Upda te, Rev 05 — Septe mber 2006Sep tember 2006 28 • The IP Me dia Ser ver (Global Call ) Demo Guide (P/N 05-2065-00 1) has been repl aced by the IP Medi a Ser v er for Host M edia Proces sing Demo G uide (P/N 05 -2389-001). • The co rrect t itle f or th e Diagno stics Guid e is Intel NetSr ucture Host Medi a Processing[...]

HMP Linux 1.2 Release Upda te, Rev 05 — Septe mber 2006Sep tember 2006 29 3.3.1 Host Media Pr ocessing Software Release 1.2 f o r Lin ux License Manager Admini stration Guide In all i nstances, the cor rect procedu re f or sta r ting the L icense Mana ger is: 1. Ente r the confi g.sh command (located i n the /usr/d ialogic/bin di rector y) to sta[...]

HMP Linux 1.2 Release Upda te, Rev 05 — Septe mber 2006Sep tember 2006 30 3.4 De velopm ent So ftware D ocumen tatio n This se ction co ntains update s to the following docume nts: • A u dio Conf e rencing API f o r Linux and Windows Operating Sys tems Librar y Ref e rence • A u dio Conferencing AP I f or Li nux Operating S ystems P rogrammin[...]

HMP Linux 1.2 Release Upda te, Rev 05 — Septe mber 2006Sep tember 2006 31 disable the acti ve talker feature , which is alway s enabled. It only disab les the notification to the application program. T he activ e talker featur e sums the 3 most acti ve talk ers in a conference, so that the con versation doesn’ t ge t drowned out when too man y [...]

HMP Linux 1.2 Release Upda te, Rev 05 — Septe mber 2006Sep tember 2006 32 3.4.4 Continuous S p eec h Process ing API for Linux and Window s Operating Systems Pr ogramming Guide There ar e currently no updates to this docume nt. 3.4.5 De vice Management API f or Window s and Linux O perating Systems Library Reference There ar e currently no update[...]

HMP Linux 1.2 Release Upda te, Rev 05 — Septe mber 2006Sep tember 2006 33 countr y_code The co untr y code. Range : 0 to 255; a n y value x> 255 is trea ted as x%256. extension The extension numbe r . Rang e: 0 to 255; an y v alue x>255 is treate d as x%256. man uf actur er_c ode The ma nuf acturer c ode. Range: 0 to 655 35; any v a lue x&g[...]

HMP Linux 1.2 Release Upda te, Rev 05 — Septe mber 2006Sep tember 2006 34 3.4.10 IP Media Li b rary AP I fo r Host Media Pr ocessing Library Reference There ar e currently no updates to this docume nt. 3.4.11 IP Media Li b rary AP I fo r Host Media Pr ocessing Pr ogrammi ng Guide There ar e currently no updates to this docume nt. 3.4.12 Standar d[...]

HMP Linux 1.2 Release Upda te, Rev 05 — Septe mber 2006Sep tember 2006 35  Descripti on The dx_mreciottdata( ) function records v oice data from two TDM b us time slots. The data may be recorded to a combination of data f iles, memory or custom de vices. This function is used for the transaction record feature, which allo ws you to record two [...]

HMP Linux 1.2 Release Upda te, Rev 05 — Septe mber 2006Sep tember 2006 36 • When recording V O X files, the data format is specified in DC_XPB rather than through the dx_setparm( ) funct ion. • V oice data files that are specified in th e DX_IO TT structure must be opened with the O_BIN AR Y flag. • If both time slots transm it a DTMF digit[...]

HMP Linux 1.2 Release Upda te, Rev 05 — Septe mber 2006Sep tember 2006 37  Example The follo wing example is for Linux applications. #include <fcnt l.h> #include <stdi o.h> #include <stdl ib.h> #include <srll ib.h> #include <dxxx lib.h> #define MAXLEN 10000 main() { int devh1, devh2, devh3; short fd; DV_TPT tpt; D[...]

HMP Linux 1.2 Release Upda te, Rev 05 — Septe mber 2006Sep tember 2006 38 /* Set up D X_XPB structure */ xpb.wFileFo rmat = FILE_FORM AT_VOX; xpb.wDataFo rmat = 0; xpb.nSample sPerSec = 0L; xpb.wBitsPe rSample = 0; /*Set up DV _TPT structure * / dx_clrtpt ( &tpt,1); tpt.tp_type = IO_EOT; tpt.tp_term no = DX_MAXDTMF; tpt.tp_leng th = 1; tpt.tp[...]

HMP Linux 1.2 Release Upda te, Rev 05 — Septe mber 2006Sep tember 2006 39 main() { int devh1, devh2, devh3; short fd; DV_TPT tpt; DX_IOTT iot t[2]; DX_XPB xpb; SC_TSINFO t sinfo; long scts; long tslots [32]; char basebu fp[MAXLEN]; /* open two voice channels */ if ((devh1 = dx_open("dxxxB 1C1", NULL)) == - 1) { printf(" Could not o[...]

HMP Linux 1.2 Release Upda te, Rev 05 — Septe mber 2006Sep tember 2006 40 /* Set up D X_IOTT structure */ iott[0].io_ fhandle = fd; iott[0].io_ type = IO_DEV; iott[0].io_ offset = 0; iott[0].io_ length = MAXLEN; iott[0].io_ offset = IO_EOT; /* And reco rd from both voi ce channels */ if ( d x_mreciottdata(de vh3, &iott[0], & tpt, &xpb[...]

HMP Linux 1.2 Release Upda te, Rev 05 — Septe mber 2006Sep tember 2006 41 3.4.15 V oice API f or Host Media Proces sing Programm ing Guid e In se ction 8. 7.4 Str eamin g to Boar d Hints a nd Tips , the de f ault bulk qu eue buff er si z e is incorr ectly de scribed as 32 kbytes , rather than 16 kb ytes. Th e second, f ifth and si xth bullets in [...]

HMP Linux 1.2 Release Upda te, Rev 05 — Septe mber 2006Sep tember 2006 42 3.5 Demonstration Software Docume ntation This se ction co ntains update s to the following docume nts: • A u dio Conferencing AP I f or Hos t Media Pr ocessing Demo Guide • Continuous Speech Proc essing AP I f or Host M edia Proce ssing Demo Gu ide • IP Media Ser v e[...]

HMP Linux 1.2 Release Upda te, Rev 05 — Septe mber 2006Sep tember 2006 43 3.5.2 Continu o us Speec h Processi ng API f or Host Media Pr ocessing Demo Guide The Conti n uo us Speech Pr ocessing API for HMP Demo is des igned to run using a serie s of four or fe wer contiguo us channel s . T he highest channel num ber in the ser ies must be 120 or l[...]

HMP Linux 1.2 Release Upda te, Rev 05 — Septe mber 2006Sep tember 2006 44 • In Section 4.1, “Starting the Demo” of Chapter 4, “Running the Demo” , the informat ion in the Linux subsecti on should r ead: The ex ecutable is loc ated in: $(INTEL_ DIALOGIC_DIR) /demos/IPMe diaServer/Re lease/ Run the ex ecuta b le fr om this lo cation by ty[...]