English dropdown-ico

Intel IP Media Server 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
45
46
47
48
49
50
51
52
53
54
55
56

Go to page of

Similar user manuals

A good user manual

The rules should oblige the seller to give the purchaser an operating instrucion of Intel IP Media Server, 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 Intel IP Media Server 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 Intel IP Media Server. 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 Intel IP Media Server should contain:
- informations concerning technical data of Intel IP Media Server
- name of the manufacturer and a year of construction of the Intel IP Media Server item
- rules of operation, control and maintenance of the Intel IP Media Server 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 Intel IP Media Server 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 Intel IP Media Server, and methods of problem resolution. Eventually, when one still can't find the answer to his problems, he will be directed to the Intel 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 Intel IP Media Server.

Why one should read the manuals?

It is mostly in the manuals where we will find the details concerning construction and possibility of the Intel IP Media Server 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

    IP Media Server f or Host Media Pr ocessing Demo Guide Ju ly 2005 05-2389-00 3[...]

  • Page 2

    IP Media Server for HMP D emo Guide – July 2005 INFORMA TION IN THIS DO CUMENT IS PRO VIDED IN CONNECTION WITH INTEL® PRODUCTS. NO LICENSE, EX PRESS OR IMPLIED , BY EST OPPEL OR O THER WISE, T O ANY INTELLECTU AL PR OPER TY RIGHTS IS GRANTED BY THIS DOCUMENT . EXCEPT AS PR O VIDED IN INTEL'S TERMS AND CONDITIONS OF SALE FOR SUCH PRODUCTS, I[...]

  • Page 3

    IP Media Server for HMP De mo Guide – July 2005 3 Contents Revision H istory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 About This Publication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 1 Demo D[...]

  • Page 4

    4 IP Media Server for HMP D emo Guide – July 2005 Contents Figures 1 Demo Voice M enu Flowchar t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 2 IP Media S erver Demo Ar chitecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 3 EventRouter[...]

  • Page 5

    IP Media Server for HMP De mo Guide – July 2005 5 Contents Ta b l e s 1 Command Line Switches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 2 Runtime Key board Com mands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20 3 Files in I[...]

  • Page 6

    6 IP Media Server for HMP D emo Guide – July 2005 Contents[...]

  • Page 7

    IP Media Server for HMP Demo Gu ide — July 2005 7 Re vision Histor y This re vision history summarizes the changes made in each published vers ion of this document. Document No. Publication Date Description of Revisions 05-2389-003 July 2005 Added updated Linux information. 05-2389-002 April 2005 Globally c hanged file paths to use installation d[...]

  • Page 8

    8 IP Media Server for HMP Demo Guide — July 2005 Revisi on History[...]

  • Page 9

    IP Media Server for HMP Demo Gu ide — July 2005 9 About This Pub lication This section describes the purpose of the guide, th e intended audience, and provides references to other documents that may be useful to the user . • Purpose • Intended Audience • How to Use This Publication • Related Information Purpose This guide provides informa[...]

  • Page 10

    10 IP Media Server for HMP Demo Guide — July 2005 About This Public ation How to Use This Pub lication Refer to this publication after you have installed the hardware and the system software. This publication assumes that you are familiar with the W i ndows or Linux operating system and the C++ programming language. The information in this guide [...]

  • Page 11

    IP Media Server for HMP Demo Gu ide — July 2005 11 1 1 . Demo Description This chapter describes the basic features of the IP Media Serv er for HMP demo. The IP Media Server for HMP demo is an object-o riented host-based application that demonstrates using the Global Call API to build an IP media server , providing voice and f ax services via IP [...]

  • Page 12

    12 IP Media Server for HMP Demo Guide — July 2005 Demo Description[...]

  • Page 13

    IP Media Server for HMP Demo Gu ide — July 2005 13 2 2 . System Requirements This chapter discusses the system requirements fo r running the IP Media Server for HMP demo. It contains the following topics: • Hardware Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 • Software Requi[...]

  • Page 14

    14 IP Media Server for HMP Demo Guide — July 2005 System Requireme nts 2.2 Software Requirements T o run the IP Media Serv er for HMP demo as documented in this guide, you need one of the following software releases: • Intel NetStruc ture Host Media Processi ng Softw are 1.3 for W indo ws (or later) • Intel NetStructure Host Media Processing [...]

  • Page 15

    IP Media Server for HMP Demo Gu ide — July 2005 15 3 3 . Preparing to Run the Demo This chapter discusses the prepar ations necessary to run the IP Media Server for HMP demo. It provides information about the following topics: • Editing Configuration Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .[...]

  • Page 16

    16 IP Media Server for HMP Demo Guide — July 2005 Preparing to Run the Demo • InBand – usually used with G.711 coders • RFC2833 Capability Describes the transmit and recei ve coders. See the Global Call IP T echnology Guide for specific information about coder suppor t. The parameters are as follows: • TxT ype – the transmit voice coder[...]

  • Page 17

    IP Media Server for HMP Demo Gu ide — July 2005 17 Preparing to Run th e Demo Sample Confi guration File ############## ########### ############## ########### ############## ########### ########### ########## # IP Protocol : # The IP Pr otocol used for opening the IP Line devices, valu es: H323, S IP, both # # DTMFmode # possib le options: # OutO[...]

  • Page 18

    18 IP Media Server for HMP Demo Guide — July 2005 Preparing to Run the Demo MediaAlar mLostPacket s { Thres hold = 20 # Thre shold value Debou nceOn = 10000 # Thre shold debou nce ON Debou nceOff = 10000 # Thre shold debou nce OFF Inter val = 1000 # Thre shold Time Interval (ms) Perce ntSuccess = 60 # Thre shold Succe ss Percent Perce ntFail = 40[...]

  • Page 19

    IP Media Server for HMP Demo Gu ide — July 2005 19 4 4 . Running the Demo This chapter discusses how to run the IP Media Server for HMP dem o. It contains the fo llowing topics: • Starting the Demo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 • Demo Options . . . . . . . . . . . [...]

  • Page 20

    20 IP Media Server for HMP Demo Guide — July 2005 Running the Demo Example The follo wing example sho ws how to launch the demo from a command line with options: IPMediaServer -n64 -cmyconfig.cfg -ea This command launches the demo with 64 channels, using th e myconfig.cfg configuration f ile and A-law encoding. 4.3 Using the Demo This section des[...]

  • Page 21

    IP Media Server for HMP Demo Gu ide — July 2005 21 Running the Demo Main Menu [Main_Men u] 1 - V oice Mail 2 - Fax 3 - Conferencing (not supported in HMP 1.x) 4 - CSP Bar ge-in * - Quit V oice Mail Menu [V oicemail_Menu] 1 - Record Message 2 - Listen to message from a mailbox * - Quit Send Message Prompt [SendMsg_Men u] Enter Mailbox Number - bet[...]

  • Page 22

    22 IP Media Server for HMP Demo Guide — July 2005 Running the Demo Fa x Menu [F ax_Menu] 1 - Send fax (to the IP Media Server demo) 2 - Recei ve fax (sent from the IP Media Serv er demo) * - Quit Send Fax Pr ompt [Send_Fax_Menu] Dial fax number - between 101 - 299 * - Quit F ax Sent Prompt [F ax_Sent_Menu] Announces that fax was sent and repeats [...]

  • Page 23

    IP Media Server for HMP Demo Gu ide — July 2005 23 Running the Demo Figure 1. Demo V oice Menu Flowc har t Main Menu Select one of the follo wing: 1 - V oice Mail 2 - F ax 4 - CSP * - Quit V oice Mail Prompt 1 - Record Message 2 - Listen to message from a mailbox * - Quit 1 Listen Message Prompt Enter Mailbox Number (Message is play ed) * - Quit [...]

  • Page 24

    24 IP Media Server for HMP Demo Guide — July 2005 Running the Demo 4.4 Stopping the Demo The IP Media Serv er demo runs until it is term inated. Press “q” or “Q” to terminate the demo application.[...]

  • Page 25

    IP Media Server for HMP Demo Gu ide — July 2005 25 5 5 . Demo Details This chapter discusses the IP Medi a Server for HMP demo in more detail. It contain s the following topics: • Files Used b y the Demo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 • Programming Model . . . . . . . . . .[...]

  • Page 26

    26 IP Media Server for HMP Demo Guide — July 2005 Demo Details In W indows, the IP Media Server demo f iles listed in T able 4 are located within: $(INTEL_DI ALOGIC_DIR) DemosIPMediaServer Modules In Linux, the IP Media Server demo file s lis t ed in T able 4 are located within: $(INTEL_DI ALOGIC_DIR )/de mos/IPMediaServer/ Modules Release 200[...]

  • Page 27

    IP Media Server for HMP Demo Gu ide — July 2005 27 Demo Details F axModule CFaxDe vice.h Function prototype for cf axdevice.cpp F axModule CFaxModule.cpp Implements the operations of the CF axModule class F axModule CFaxModule.h Function prototype for cf axmodule.cpp F axModule CFaxStateMachine.cpp Implements the operations of the CF axStateMachi[...]

  • Page 28

    28 IP Media Server for HMP Demo Guide — July 2005 Demo Details 5.1.2 PDL Files In W indows, the PDL f iles listed in T a ble 5 are located within the directory: $(INTEL_DIALOGIC_DIR )DemosSharedpdl_win In Linux, the PDL files listed in T able 5 are located within the direct ory: $(INTEL_DI ALOGIC_DIR )/ demos/Shared /pdl_Linux 5.2 Pr ogramming[...]

  • Page 29

    IP Media Server for HMP Demo Gu ide — July 2005 29 Demo Details 5.2.1 Module Structure The IP Media Server for HMP demo uses a modular architecture, in which each technology (IP , voice, f ax, CSP)) is wrapped inside a modu le so that a particular technology can be easily added or remov ed. The system contains three modules: • IP module that se[...]

  • Page 30

    30 IP Media Server for HMP Demo Guide — July 2005 Demo Details 5.2.2 EventRouter The EventRouter is responsible for communicating with the modu les. It does the following: • Maintains routing tab les • Retrie ves ev ent data from the SRL and routes it to a module for processing • Forwards e vent process result to another modu le if so reque[...]

  • Page 31

    IP Media Server for HMP Demo Gu ide — July 2005 31 Demo Details 5.2.3 Interfaces The modular architect ure implements a unified interf ace that allo ws replacement of modules by including new header f iles and adjusting routing statem ents. A module is treated by the EventRouter as a block box. It has three types of APIs: Initialization • Init([...]

  • Page 32

    32 IP Media Server for HMP Demo Guide — July 2005 Demo Details CEventRouter Responsible f or connecting all the modules. It does the follo wing: • Maintains routing tables • Retriev es ev ent data from the SRL and routes them to modules • Gets e vent process results from the modules and routes them to other modul es if the destination is no[...]

  • Page 33

    IP Media Server for HMP Demo Gu ide — July 2005 33 Demo Details Board CIPTBoard • Interacts with the Global Call library to handle IP vir tual boards Note: The public function in this class should only be accessed by classes inside the IP module. Init( ) • Opens IPT (vir tual) board and sets board parameters Exit( ) • Closes IPT (vir tual) [...]

  • Page 34

    34 IP Media Server for HMP Demo Guide — July 2005 Demo Details Device CIPDevice • Handles IP device oper ations, such as making/dropping call s, sending H.323 messages, making timeslot connections, etc. • Holds CIPStateMachine (or call control) Note: The public functions in this class should only be accessed by classes inside the IP module. I[...]

  • Page 35

    IP Media Server for HMP Demo Gu ide — July 2005 35 Demo Details T able 8. V oice Module Classes Category Class Name Interface Module CV oice Module • Interacts with CV oiceBoard and CV oiceDevice. • Expor ts V oice mod ule functions to CEventRouter . Note: The public functions in this class can be accessed by classes outside the Voice module.[...]

  • Page 36

    36 IP Media Server for HMP Demo Guide — July 2005 Demo Details Device CV oiceDevice • Handles voice de vice operations, such as play ing, recording, tone detection, and tone generation • Holds CV oiceStateMachine Note: The public functions in this class should only be accessed by classes inside the Voice module. Init( ) • Opens the voice de[...]

  • Page 37

    IP Media Server for HMP Demo Gu ide — July 2005 37 Demo Details State Machine CV oiceStateMachine • Handles voice e vents and maintains voice state machine(s) Note: The public functions in this class should only be accessed by the classes inside the voice module. Init( ) • Opens vo x files • Creates mailbo x utility object that manages mail[...]

  • Page 38

    38 IP Media Server for HMP Demo Guide — July 2005 Demo Details Board CF axBoa rd • Interacts with the f ax librar y to handle fax boards • The public function in this class should only be accessed by classes inside the Fax module Init( ) • Open fax board. Exit( ) • Close fax board. ProcessEvent( ) • Processes fax board e vents. Device C[...]

  • Page 39

    IP Media Server for HMP Demo Gu ide — July 2005 39 Demo Details 5.3 Threads The IP Media Serv er for HMP demo operates with two threads, as shown in Figure 4. Figure 4. IP Media Server Demo Threads The threads are created as follo ws: 1. The f irst (main) thread is created by the demo application to get the ke yboard input. 2. The second thread i[...]

  • Page 40

    40 IP Media Server for HMP Demo Guide — July 2005 Demo Details After all the modules are started, the Ev entRouter starts to build a static routing table that maps voice de vices to IP devices. It is important that each IP device has a dedicated v oice resource, so that when an IP channel is co nnected (an incoming call is answered) the user can [...]

  • Page 41

    IP Media Server for HMP Demo Gu ide — July 2005 41 Demo Details 5.5 Event Handling This section describes how the IP Media Serv er for HMP demo handles ev ents. It co ntains the following topics: • Event Mechanism • Handling Keyboard Input Events • Handling SRL Events • Handling Application Ex it Events • TSUsrEvent Structure 5.5.1 Even[...]

  • Page 42

    42 IP Media Server for HMP Demo Guide — July 2005 Demo Details 5.5.5 TSUsrEvent Structure The TSUsrEvent structure is used b y the demo mo dules to return event processing results to the ev ent router . The TSUserEvt structure is def i ned as follo ws: typedef stru ct { int event; TDeviceTyp e destinati on; int lineDevic e; long xmitSlot; long ne[...]

  • Page 43

    IP Media Server for HMP Demo Gu ide — July 2005 43 Demo Details Figure 6. T ypical Scenario: Call Offered CEventRouter CIPModule CIPDevice CIPState Machine CV oiceModule GCEV_OFFERED GCEV_OFFERED GCEV_OFFERED GCEV_EXTENSIONCMPL T GCEV_EXTENSIONCMPL T GCEV_EXTENSIONCMPL T GCEV_CONNECTED GCEV_CONNECTED GCEV_CONNECTED call gc_extension( ) to get cal[...]

  • Page 44

    44 IP Media Server for HMP Demo Guide — July 2005 Demo Details Pla y Prompts After the call is connected, th e V oice module is notified to play prompts and accept DTMF . Figure 7. T ypical Scenario: Pla y Prompts CEventRouter CIPModule CIPDevice CIPState Machine CV oiceModule USR_CONNECTED TDX_PLA Y (finish playing main menu) TDX_GETDIG (press &[...]

  • Page 45

    IP Media Server for HMP Demo Gu ide — July 2005 45 Demo Details Fax Mailbo x The user selects to send a fax to mailbox “101”. The Fax module is requested to send a fax. Figure 8. T ypical Scenario: Fax Mailbox CEventRouter CIPModule CF axModule USR_SENDF AX "101" CF axDevice CFaxState Machine USR_SENDF AX "101" ... source=[...]

  • Page 46

    46 IP Media Server for HMP Demo Guide — July 2005 Demo Details Establish Fax Session The Fax module requests the front end to g et ready to send a fax. If the front end is IP , it shoul d first mov e from an R TP port to a UDP port in order to send a fax. Figure 9. T ypical Scenario: Estab lish Fax Sess ion CEventRouter CIPModule CIPDevice CIPSta[...]

  • Page 47

    IP Media Server for HMP Demo Gu ide — July 2005 47 Demo Details Fax Session Estab lished The Fax module gets a reply from the front end that the fax session has been established. Figure 10. T ypical Scenario: F ax Session Established CEventRouter CIPModule CF axModule CF axDevice CFaxState Machine ... source=F AX destination=IP ev ent= USR_CLOSEF[...]

  • Page 48

    48 IP Media Server for HMP Demo Guide — July 2005 Demo Details F ax Sent The fax is sent. The front end is requested to close the fax session. Figure 11. T ypical Scenario: F ax Sent CEventRouter CIPModule CIPDevice CIPState Machine 1. Call gc_stop( ) to stop T .38 session 2. Call gc_extension ( ) to start audio session 3. Call gc_listen( ) liste[...]

  • Page 49

    IP Media Server for HMP Demo Gu ide — July 2005 49 Demo Details Fax Session Closed The Fax module gets a reply from the front end that the fax session has been closed. Figure 12. T ypical Scenario: F ax Session Closed Fax Complete The V oice module gets a reply from the Fax module that a f ax has been sent. Figure 13. T ypical Scenario: Fa x Comp[...]

  • Page 50

    50 IP Media Server for HMP Demo Guide — July 2005 Demo Details[...]

  • Page 51

    IP Media Server for HMP Demo Gu ide — July 2005 51 Glossar y Codec: see COder/DECoder COder/DECoder: A circuit used to con vert analog v oi ce data to digital and digital voice data to analog audio. Computer T elephony (CT): Adding computer intellig ence to the making, recei ving, and managing of telephone calls. DTMF: Dual-T one Multi-Frequency [...]

  • Page 52

    52 IP Media Server for HMP Demo Guide — July 2005 International T elecommunications Union (ITU): An organization established by the United Nations to set telecommunications stan dards, allocat e frequencies to various uses, and hold trade sho ws ev ery four years. Internet: An inter -netw ork of netwo rks inter connected b y bridges or routers. L[...]

  • Page 53

    IP Media Server for HMP Demo Gu ide — July 2005 53 T1: A digital transm ission link with a capacity o f 1.544 Mbps used in North America. T ypically channeled into 24 digital subscriber lev el zeros (DS0s), each capable of carry ing a single voice con versatio n or data strea m. T1 uses two pairs of twisted pair wires. TCP: see T ransmissi on Con[...]

  • Page 54

    54 IP Media Server for HMP Demo Guide — July 2005[...]

  • Page 55

    IP Media Server for HMP Demo Gu ide — July 2005 55 Inde x A application classes 31 application exit eve nts 41 C CallbackHdlr( ) 41 CConfig( ) 39 CEventRouter( ) 39 ChannelNumber( ) 31 CheckAndConvertDigits( ) 37 classes 31 application classes 31 Fax module classes 37 IP module classes 3 2 CloseFaxFile( ) 38 command-line switches 19 commands, key[...]

  • Page 56

    56 IP Media Server for HMP Demo Guide — July 2005 M main( ) 41 module structure 29 O OnPlayComplete( ) 36 OpenFaxFile( ) 38 P ParseConfigFile( ) 31 PDL files 28 PDLSetApplicationExitPath( ) 41 PDLsr_enbhdlr( ) 41 PDLsr_enblhdlr( ) 39 Play( ) 36 ProcessEvent( ) 31 programming model 28 R Record( ) 36 RecvFax( ) 38 requirements hardware 13 software [...]