IntelメーカーIP Gateway (Global Call) for Linux and Windowsの使用説明書/サービス説明書
ページ先へ移動 of 56
IP Gateway (Global Call) Demo Guide for Linux and Windows Copyright © 2002-2005 Intel Corporation 05-1662-005.
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.
iii Table of Contents 1. About This Guide ............................................................................................ 1 1.1. Purpose .....................................................................................................
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 .................................................................
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 .
IP Gateway (Global Call) Demo Guide for Linux and Windows vi.
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 ..............................................................................
IP Gateway (Global Call) Demo Guide for Linux and Windows viii.
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.
IP Gateway (Global Call) Demo Guide for Linux and Windows 2.
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.
IP Gateway (Global Call) Demo Guide for Linux and Windows 4.
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.
IP Gateway (Global Call) Demo Guide for Linux and Windows 6.
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.
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.
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.
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 .
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.
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.
4. Preparing to Run the Demo 13 The following is an example of a configuration file. ######################################################################################## # Telephony Protocol : # F.
IP Gateway (Global Call) Demo Guide for Linux and Windows 14 DTMFmode = OutOfBand AudioRxCodecs { CoderType = g711Mulaw CoderFramesPerPkt = 30 CoderVAD = 0 } AudioTxCodecs { CoderType = g711Mulaw Code.
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 = strin.
.
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.
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.
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.
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.
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.
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.
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.
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 $(I.
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.
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.
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.
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( ) .
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.
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.
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( ) I.
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 ca.
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 .
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.
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.
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.
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.
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.
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.
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.
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.
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.
Appendix B 43 DATE: 08/16/01 TIME: 11:00:05 TRACE: File: gateip.c Line: 466 End of ipGetEvent function on channel 10.
IP Gateway (Global Call) Demo Guide for Linux and Windows 44.
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.
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(.
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.
48.
デバイスIntel IP Gateway (Global Call) for Linux and Windowsの購入後に（又は購入する前であっても）重要なポイントは、説明書をよく読むことです。その単純な理由はいくつかあります：
Intel IP Gateway (Global Call) for Linux and Windowsをまだ購入していないなら、この製品の基本情報を理解する良い機会です。まずは上にある説明書の最初のページをご覧ください。そこにはIntel IP Gateway (Global Call) for Linux and Windowsの技術情報の概要が記載されているはずです。デバイスがあなたのニーズを満たすかどうかは、ここで確認しましょう。Intel IP Gateway (Global Call) for Linux and Windowsの取扱説明書の次のページをよく読むことにより、製品の全機能やその取り扱いに関する情報を知ることができます。Intel IP Gateway (Global Call) for Linux and Windowsで得られた情報は、きっとあなたの購入の決断を手助けしてくれることでしょう。
Intel IP Gateway (Global Call) for Linux and Windowsを既にお持ちだが、まだ読んでいない場合は、上記の理由によりそれを行うべきです。そうすることにより機能を適切に使用しているか、又はIntel IP Gateway (Global Call) for Linux and Windowsの不適切な取り扱いによりその寿命を短くする危険を犯していないかどうかを知ることができます。
ですが、ユーザガイドが果たす重要な役割の一つは、Intel IP Gateway (Global Call) for Linux and Windowsに関する問題の解決を支援することです。そこにはほとんどの場合、トラブルシューティング、すなわちIntel IP Gateway (Global Call) for Linux and Windowsデバイスで最もよく起こりうる故障・不良とそれらの対処法についてのアドバイスを見つけることができるはずです。たとえ問題を解決できなかった場合でも、説明書にはカスタマー・サービスセンター又は最寄りのサービスセンターへの問い合わせ先等、次の対処法についての指示があるはずです。
