Français dropdown-ico

Intel IP Gateway (Global Call) for Linux and Windows manuel d'utilisation

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

Aller à la page of

Les manuels d’utilisation similaires

Un bon manuel d’utilisation

Les règles imposent au revendeur l'obligation de fournir à l'acheteur, avec des marchandises, le manuel d’utilisation Intel IP Gateway (Global Call) for Linux and Windows. Le manque du manuel d’utilisation ou les informations incorrectes fournies au consommateur sont à la base d'une plainte pour non-conformité du dispositif avec le contrat. Conformément à la loi, l’inclusion du manuel d’utilisation sous une forme autre que le papier est autorisée, ce qui est souvent utilisé récemment, en incluant la forme graphique ou électronique du manuel Intel IP Gateway (Global Call) for Linux and Windows ou les vidéos d'instruction pour les utilisateurs. La condition est son caractère lisible et compréhensible.

Qu'est ce que le manuel d’utilisation?

Le mot vient du latin "Instructio", à savoir organiser. Ainsi, le manuel d’utilisation Intel IP Gateway (Global Call) for Linux and Windows décrit les étapes de la procédure. Le but du manuel d’utilisation est d’instruire, de faciliter le démarrage, l'utilisation de l'équipement ou l'exécution des actions spécifiques. Le manuel d’utilisation est une collection d'informations sur l'objet/service, une indice.

Malheureusement, peu d'utilisateurs prennent le temps de lire le manuel d’utilisation, et un bon manuel permet non seulement d’apprendre à connaître un certain nombre de fonctionnalités supplémentaires du dispositif acheté, mais aussi éviter la majorité des défaillances.

Donc, ce qui devrait contenir le manuel parfait?

Tout d'abord, le manuel d’utilisation Intel IP Gateway (Global Call) for Linux and Windows devrait contenir:
- informations sur les caractéristiques techniques du dispositif Intel IP Gateway (Global Call) for Linux and Windows
- nom du fabricant et année de fabrication Intel IP Gateway (Global Call) for Linux and Windows
- instructions d'utilisation, de réglage et d’entretien de l'équipement Intel IP Gateway (Global Call) for Linux and Windows
- signes de sécurité et attestations confirmant la conformité avec les normes pertinentes

Pourquoi nous ne lisons pas les manuels d’utilisation?

Habituellement, cela est dû au manque de temps et de certitude quant à la fonctionnalité spécifique de l'équipement acheté. Malheureusement, la connexion et le démarrage Intel IP Gateway (Global Call) for Linux and Windows ne suffisent pas. Le manuel d’utilisation contient un certain nombre de lignes directrices concernant les fonctionnalités spécifiques, la sécurité, les méthodes d'entretien (même les moyens qui doivent être utilisés), les défauts possibles Intel IP Gateway (Global Call) for Linux and Windows et les moyens de résoudre des problèmes communs lors de l'utilisation. Enfin, le manuel contient les coordonnées du service Intel en l'absence de l'efficacité des solutions proposées. Actuellement, les manuels d’utilisation sous la forme d'animations intéressantes et de vidéos pédagogiques qui sont meilleurs que la brochure, sont très populaires. Ce type de manuel permet à l'utilisateur de voir toute la vidéo d'instruction sans sauter les spécifications et les descriptions techniques compliquées Intel IP Gateway (Global Call) for Linux and Windows, comme c’est le cas pour la version papier.

Pourquoi lire le manuel d’utilisation?

Tout d'abord, il contient la réponse sur la structure, les possibilités du dispositif Intel IP Gateway (Global Call) for Linux and Windows, l'utilisation de divers accessoires et une gamme d'informations pour profiter pleinement de toutes les fonctionnalités et commodités.

Après un achat réussi de l’équipement/dispositif, prenez un moment pour vous familiariser avec toutes les parties du manuel d'utilisation Intel IP Gateway (Global Call) for Linux and Windows. À l'heure actuelle, ils sont soigneusement préparés et traduits pour qu'ils soient non seulement compréhensibles pour les utilisateurs, mais pour qu’ils remplissent leur fonction de base de l'information et d’aide.

Table des matières du manuel d’utilisation

  • Page 1

    IP Gateway (Global Call) Demo Guide for Linux and Windows Copyright © 2002-2005 Intel Corporation 05-1662-005[...]

  • Page 2

    COPYRIGHT NOTICE INFORMATION IN THIS DOCUMENT IS PROVIDED IN CONNECTION WITH INTEL® PRODUCTS. NO LICENSE, EXPRESS OR IMPLIED, BY ESTOPPEL OR OTHERWISE, TO ANY INTELLECTUAL PROPERTY RIGHTS IS GRANTED BY THIS DOCUMENT. EXCEPT AS PROVIDED IN INTEL'S TERMS AND CONDITIONS OF SALE FOR SUCH PRODUCTS, INTEL ASSUMES NO LIABILITY WHATSOEVER, AND INTEL [...]

  • Page 3

    iii Table of Contents 1. About This Guide ............................................................................................ 1 1.1. Purpose ........................................................................................................... 1 1.2. Intended Audience ...................................................................[...]

  • Page 4

    IP Gateway (Global Call) Demo Guide for Linux and Windows iv 6.5.1. Handling Keyboard Input Events ........................................................ 29 6.5.2. Handling SRL Events .......................................................................... 29 6.5.3. Handling Application Exit Events ..............................................[...]

  • Page 5

    v List of Tables Table 2. Command Line Switches ...................................................................... 18 Table 3. Runtime Keyboard Commands ............................................................. 20 Table 4. Source Files Used by the IP Gateway (Global Call) Demo .................. 21[...]

  • Page 6

    IP Gateway (Global Call) Demo Guide for Linux and Windows vi[...]

  • Page 7

    vii List of Figures Figure 1. Hardware Configuration with Onboard NIC and PSTN Front End ....... 7 Figure 2. Hardware Configuration with Onboard NIC and separate PSTN board .............................................................................................................. 8 Figure 3. Typical Topology .....................................[...]

  • Page 8

    IP Gateway (Global Call) Demo Guide for Linux and Windows viii[...]

  • Page 9

    1 1. About This Guide This section describes the purpose of this guide, the intended audience, and references to other documents that may be useful to the user. 1.1. Purpose This guide describes the operation of the IP Gateway (Global Call) demo. 1.2. Intended Audience This guide is intended for application developers who will be developing a PSTN-[...]

  • Page 10

    IP Gateway (Global Call) Demo Guide for Linux and Windows 2[...]

  • Page 11

    3 2. Demo Description 2.1. About the Demo The IP Gateway (Global Call) demo is a host-based application that demonstrates using the Global Call API to build a PSTN − IP gateway. The demo source code can be used as sample code for those who want to begin developing an application from a working application. The demo is not designed to implement a [...]

  • Page 12

    IP Gateway (Global Call) Demo Guide for Linux and Windows 4[...]

  • Page 13

    5 3. System Requirements This chapter discusses the system requirement for running the IP Gateway (Global Call) demo. It contains the following topics: • Hardware Requirements • Software Requirements 3.1. Hardware Requirements To run the IP Gateway (Global Call) demo, you need: • One of the following: • Intel NetStructure® DM/IP Series boa[...]

  • Page 14

    IP Gateway (Global Call) Demo Guide for Linux and Windows 6[...]

  • Page 15

    7 4. Preparing to Run the Demo This chapter discusses how to prepare to run the IP Gateway (Global Call) demo. It provides information about the following topics: • Connecting to External Equipment • Editing Configuration Files 4.1. Connecting to External Equipment There are two possible hardware configurations for the IP Gateway (Global Call) [...]

  • Page 16

    IP Gateway (Global Call) Demo Guide for Linux and Windows 8 Intern et/ Intr anet li ne Intel NetStructure® IPT board CTbus cable PSTN line Intel NetStructure® DM/V-A series board Figure 2. Hardware Configuration with Onboard NIC and separate PSTN board The IP Gateway (Global Call) demo allows you to connect to gateways on an IP network and establ[...]

  • Page 17

    4. Preparing to Run the Demo 9 IP Netw ork H.323 Terminal IP Gateway Telephone PBX IP Gateway Telephone PBX Fax Fax Figure 3. Typical Topology 4.2. Editing Configuration Files This section discusses how to configure the demo for your system. It contains the following topics: • Configuration file location • Editing the gateway_r4.cfg File 4.2.1.[...]

  • Page 18

    IP Gateway (Global Call) Demo Guide for Linux and Windows 10 4.2.2. Editing the gateway_r4.cfg File Below is an example of the gateway_r4.cfg file. Update the following information: ipProtocol The IP Protocol used for opening the IP Line devices, values: H323, SIP, both Channel Channels defined by this section of the file - may be individual channe[...]

  • Page 19

    4. Preparing to Run the Demo 11 • CoderFramesPerPkt - frames per packet for the selected coder • CoderVAD - Voice Activity Detection on/off AudioTxCodecs Capability for transmit audio codecs. See AudioRxCodecs for a complete description. DataCodecs Capability for fax codecs. The demo currently support T38 only. MediaAlarmLostPackets Indicates t[...]

  • Page 20

    IP Gateway (Global Call) Demo Guide for Linux and Windows 12 UII User Input Indication string to send NonStdParm Non-standard parameter data to send NonStdCmd Non-standard command string to send ObjId Object ID Q931Facility Facility data to send on the Q.931 channel DTMF DTMF mode. Possible options: OutOfBand, inband, rfc2833 enableRegestration Reg[...]

  • Page 21

    4. Preparing to Run the Demo 13 The following is an example of a configuration file. ######################################################################################## # Telephony Protocol : # For ANAPI(Analog Front End) use the root file name of the analog protocol file for your country or telephone network) # For ICAPI (Digital Front End) u[...]

  • Page 22

    IP Gateway (Global Call) Demo Guide for Linux and Windows 14 DTMFmode = OutOfBand AudioRxCodecs { CoderType = g711Mulaw CoderFramesPerPkt = 30 CoderVAD = 0 } AudioTxCodecs { CoderType = g711Mulaw CoderFramesPerPkt = 30 CoderVAD = 0 } DataCodecs { CoderType = t38 } MediaAlarmLostPackets { Threshold = 20 # Threshold value DebounceOn = 10000 # Thresho[...]

  • Page 23

    4. Preparing to Run the Demo 15 # use 0.0.0.0 as the default address for descovering the GK regServerAddress = 10.242.214.45 NonStdRasCmd = NSC_Chan1 RasObjId = Intel # possible alias types: 1 = string, 2 = IP address, 3 = H323 ID, 4 = phone, 5 = URL, 6 = EMail Alias = 1 { AliasType = 3 AliasName = intel } Alias = 2 { AliasType = 4 AliasName = 1111[...]

  • Page 24

    [...]

  • Page 25

    17 5. Running the Demo This chapter discusses how to run the IP Gateway (Global Call) demo. It contains the following topics: • Starting the Demo • Demo Options • Using the Demo • Stopping the Demo 5.1. Starting the Demo Windows From a command prompt, change directories to: $(INTEL_DIALOGIC_DIR)samplesipt_demosgateway_r4 Release Type g[...]

  • Page 26

    IP Gateway (Global Call) Demo Guide for Linux and Windows 18 Table 1. Command Line Switches Switch Action Default -c < filename > Configuration file name gateway_r4.cfg -d Sets Debug Level (0-4): 0-FATAL: used when one or more channels are deadlocked. 1-ERROR: used when the application receives a failure which doesn’t cause the channel to b[...]

  • Page 27

    5. Running the Demo 19 Switch Action Default -l <n,…> Printouts will be printed into channel log files. If ‘all’ follows the –l, log files will be created for all available channels. If a list of channels in the following format: C1-C2, C3-C4, C5 (e.g., 1- 10,112-150,314) follows the –l, log files are created for the channel ranges [...]

  • Page 28

    IP Gateway (Global Call) Demo Guide for Linux and Windows 20 5.3. Using the Demo The demo always waits for input from the keyboard. While the demo is running, you can enter any of the following commands: Table 2. Runtime Keyboard Commands Command Function c or C Print channel information d<n> or D<n> Change debug level during runtime f [...]

  • Page 29

    21 6. Demo Details This chapter discusses the IP Gateway (Global Call) demo in more detail. It contains the following topics: • Files Used by the Demo • Handling an Incoming Call • Programming Model • Initializations • Event Handling • Demo State Machine 6.1. Files Used by the Demo 6.1.1. Demo Source Files In Windows the following files[...]

  • Page 30

    IP Gateway (Global Call) Demo Guide for Linux and Windows 22 Filename Description OS gatepars.c The demo configuration file parsing functions Both gatepars.h Function prototype for gatepars.c Both gatepstn.c PSTN-specific functions Both gatepstn.h Function prototype for gatepstn.c Both gatestate.c State machine functions Both gatestate.h Function p[...]

  • Page 31

    6. Demo Details 23 Filename Description OS register.h Function prototype for register.c Both Release gateway_r4.cfg Demo configuration file Windows Release/ gateway_r4.cfg Demo configuration file Linux Release gateway_r4.exe Executable Windows Release/ gateway_r4.exe Executable Linux 6.1.2. Utility Files In Windows the following files are located[...]

  • Page 32

    IP Gateway (Global Call) Demo Guide for Linux and Windows 24 Filename Description OS Releaseutil.lib Compiled Utility library Windows 6.1.3. PDL Files In Windows the following files are located in $(INTEL_DIALOGIC_DIR)samplesipt_demosShared In Linux the following files are located in $(INTEL_DIALOGIC_DIR)/ipt_demos/Shared Filename Description OS[...]

  • Page 33

    6. Demo Details 25 Filename Description OS /pdl_linux/pdl.c Platform dependency functions Linux /pdl_linux/pdl.h Function prototype for pdl.c Linux /pdl_linux/ pdl_linux_version.c PDL version information Linux 6.2. Handling an Incoming Call This section discusses how the demo application handles incoming calls. It contains the following topics: •[...]

  • Page 34

    IP Gateway (Global Call) Demo Guide for Linux and Windows 26 Once the destination gateway has answered the H.323 call, the IP Gateway (Global Call) demo connects the PSTN call to the IP call. An audio path is now established between the PSTN call and the destination IP station. For more details see section 6.5. Event Mechanism . 6.2.3. Handling an [...]

  • Page 35

    6. Demo Details 27 The threads are created as follows: • The first (main) thread is created by the demo application to get the keyboard input. • The second thread is an SRL thread, created as a result of the demo application calling sr_enblhdlr( ) in Windows. In Linux, the thread must be explicitly created. All Global Call events are received t[...]

  • Page 36

    IP Gateway (Global Call) Demo Guide for Linux and Windows 28 • Calculates the logical board and channel and saves them into Session.pstnParams • Closes the board, by calling dx_Close( ) or dt_Close( ) . 9. Call ipGetChannels( ) which checks how many available IP channels there are by doing the following: • Gets number of IP boards from #defin[...]

  • Page 37

    6. Demo Details 29 • Calls gc_OpenEx( ) which opens all IP devices, returns the IP LineDevH , and saves it in Session.ipParams • Saves the channel number in the global array HandleToChannel[ ] according to the LineDevH handle 13. The application main() function calls waitForKey( ) , to receive keyboard input. 6.5. Event Mechanism The IP Gateway[...]

  • Page 38

    IP Gateway (Global Call) Demo Guide for Linux and Windows 30 3. Otherwise, the application calls gc_GetUsrAttr( ) and then calls either ipGetEvent( ) to process the IP event, or pstnGetEvent( ) to process the PSTN event. 6.5.3. Handling Application Exit Events Normal application exit events don’t enter the SRL. The main() function calls PDLSetApp[...]

  • Page 39

    6. Demo Details 31 GATE_NULL IP_CONNEC TED GATE_DROP IP_OFFERED GATE_CONNECTED IP: GCEV _EXTENSION IP: gc_SetUserInfo( ) IP: gc_AnswerCall( ) IP: GCEV_ANSW ERED IP: gc_Listen( ) PSTN: gc_MakeCall( ) IP, PSTN: GCEV_DISCONNECTED pstnUnListen( ) IP, PSTN: gc_DropCa ll( ) PSTN: GCEV_CONNECTED PSTN: ag_Listen( ) or dt_Listen( ) IP, PSTN: GCEV_DROPCALL I[...]

  • Page 40

    IP Gateway (Global Call) Demo Guide for Linux and Windows 32 3. In IP_CONNECTED, when the application receives GCEV_CONNECTED from the PSTN side, the application calls pstnListen( ) , which in turn calls ag_Listen( ) or dt_Listen( ) ( ag for analog; dt for digital) to tell the PSTN line device to listen to the IP time slot The state transitions to [...]

  • Page 41

    6. Demo Details 33 2. In PSTN_OFFERED the application waits for GCEV_CONNECTED from the IP side. When the application receives GCEV_CONNECTED it calls: • gc_Extension( ) to get the call information from the IP side • gc_Listen( ) to tell the IP line device to listen to the PSTN time slot • pstnListen( ) which calls ag_Listen( ) or dt_Listen( [...]

  • Page 42

    IP Gateway (Global Call) Demo Guide for Linux and Windows 34 2. When the application receives GCEV_DROPCALL from the IP side, it calls gc_Extension( ) to get the RTCP information. When the application receives GCEV_EXTENSION the application calls gc_ReleaseCall( ) and the state transitions to GATE_NULL. 6.6.4. Glare Conditions Glare conditions occu[...]

  • Page 43

    35 Appendix A Log File of IP Call Establishment DATE: 08/16/01 TIME: 10:49:20 TRACE: File: gatepstn.c Line: 189 End of pstnOpenFrontEnd function on channel 14 DATE: 08/16/01 TIME: 10:49:21 TRACE: File: gateip.c Line: 99 Start ipOpenDevices function on channel 14 DATE: 08/16/01 TIME: 10:49:21 TRACE: File: gateip.c Line: 116 End of ipOpenDevices func[...]

  • Page 44

    IP Gateway (Global Call) Demo Guide for Linux and Windows 36 TRACE: File: gateip.c Line: 466 End of ipGetEvent function on channel 14 DATE: 08/16/01 TIME: 10:53:00 TRACE: File: gateip.c Line: 385 In ipGetEvent function on channel 14 DATE: 08/16/01 TIME: 10:53:00 TRACE: File: gateip.c Line: 227 Start OnExtension function on channel 14 DATE: 08/16/01[...]

  • Page 45

    Appendix A 37 TRACE: File: gateip.c Line: 466 End of ipGetEvent function on channel 14 DATE: 08/16/01 TIME: 10:53:01 TRACE: File: gateip.c Line: 385 In ipGetEvent function on channel 14 DATE: 08/16/01 TIME: 10:53:01 TRACE: File: gatestate.c Line: 357 In IP_OFFERED State on channel (0xe) got event GCEV_ANSWERED (0x802) from IP DATE: 08/16/01 TIME: 1[...]

  • Page 46

    IP Gateway (Global Call) Demo Guide for Linux and Windows 38 TRACE: File: gatestate.c Line: 841 Drop call on channel 14 DATE: 08/16/01 TIME: 10:54:24 TRACE: File: gateip.c Line: 466 End of ipGetEvent function on channel 14 DATE: 08/16/01 TIME: 10:54:24 TRACE: File: gatepstn.c Line: 369 In pstnGetEvent function on channel 14 DATE: 08/16/01 TIME: 10:[...]

  • Page 47

    39 Appendix B Log File of PSTN Call Establishment DATE: 08/16/01 TIME: 10:57:55 TRACE: File: gatepstn.c Line: 189 End of pstnOpenFrontEnd function on channel 10 DATE: 08/16/01 TIME: 10:57:56 TRACE: File: gateip.c Line: 99 Start ipOpenDevices function on channel 10 DATE: 08/16/01 TIME: 10:57:56 TRACE: File: gateip.c Line: 116 End of ipOpenDevices fu[...]

  • Page 48

    IP Gateway (Global Call) Demo Guide for Linux and Windows 40 TRACE: File: gateip.c Line: 140 Start ipMakeCall function on channel 10 DATE: 08/16/01 TIME: 10:58:37 TRACE: File: gateip.c Line: 205 End of ipMakeCall function on channel 10 DATE: 08/16/01 TIME: 10:58:37 TRACE: File: gatepstn.c Line: 369 In pstnGetEvent function on channel 10 DATE: 08/16[...]

  • Page 49

    Appendix B 41 DATE: 08/16/01 TIME: 10:58:38 TRACE: File: gateip.c Line: 385 In ipGetEvent function on channel 10 DATE: 08/16/01 TIME: 10:58:38 TRACE: File: gateip.c Line: 227 Start OnExtension function on channel 10 DATE: 08/16/01 TIME: 10:58:38 INFO: File: gateip.c Line: 250 Got extension data display: target DATE: 08/16/01 TIME: 10:58:38 TRACE: F[...]

  • Page 50

    IP Gateway (Global Call) Demo Guide for Linux and Windows 42 DATE: 08/16/01 TIME: 11:00:03 TRACE: File: gatepstn.c Line: 348 End of pstnUnListen function on channel 10 DATE: 08/16/01 TIME: 11:00:03 TRACE: File: gatestate.c Line: 841 Drop call on channel 10 DATE: 08/16/01 TIME: 11:00:03 TRACE: File: gatepstn.c Line: 369 In pstnGetEvent function on c[...]

  • Page 51

    Appendix B 43 DATE: 08/16/01 TIME: 11:00:05 TRACE: File: gateip.c Line: 466 End of ipGetEvent function on channel 10[...]

  • Page 52

    IP Gateway (Global Call) Demo Guide for Linux and Windows 44[...]

  • Page 53

    45 Index A ag_Listen( ), 32, 33 ag_Unlisten( ), 33 APPMAIN.C, 29 ATDV_SUBDEVS( ), 27 C Call connection, 3 Call establishment, 25 Call progress tones, 26 Call state GATE_CONNECTED, 32, 33 GATE_DROP, 33 GATE_NULL, 30 IP_CONNECTED, 31, 33 IP_DROP, 33 IP_OFFERED, 31, 33 PSTN_OFFERED, 32 Call Teardown, 33 checkArg( ), 27 Command Line Switches, 18 Config[...]

  • Page 54

    IP Gateway (Global Call) Demo Guide for Linux and Windows 46 gc_DropCall( ), 33 gc_Extension( ), 31, 33 gc_GetNetworkH( ), 28 gc_GetVoiceH( ), 28 gc_GetXmitSlot(), 30 gc_Listen( ), 31, 33 gc_MakeCall( ), 31, 32 gc_Open( ), 27 gc_OpenEx( ), 28 gc_OpenEx( ) , 28 gc_ReleaseCall( ), 33 gc_SetUserInfo( ), 31 gc_Start( ), 27 gc_Unlisten( ), 33 GCEV_ANSWE[...]

  • Page 55

    Index 47 N NetwH, 28 P PDL, 3 pdl.c, 24 PDLsr_enbhdlr( ), 27 PDLsr_getboardcnt( ), 27 Platform Dependency Library, 3 PSTN State Diagram, 32 PSTN channel, 3 PSTN, Log File, 39 PSTN_OFFERED, 32 pstnGetVOXChannels( ), 27 pstnOpenFrontEnd( ), 28 R remote phone number, 25 Routing, 25 S Session.ipParams, 28 Session.pstnParams, 27, 28 sr_enbhdlr( ), 29 SR[...]

  • Page 56

    48[...]