-
Notifications
You must be signed in to change notification settings - Fork 12
/
Copy pathREADME
189 lines (132 loc) · 6.12 KB
/
README
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
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
Copyright (C) 2004-2010 by Objective Systems, Inc.
Objective Open H.323 README
Introduction
============
Thank you for downloading the Objective Open H.323 software. This
package contains linux binaries of H.323 stack developed in C.
The ASN.1 messaging code was developed using the Objective Systems ASN1C
compiler to implement the core H.323 specifications (H.225, H.235,
and H.245). Additional code was then developed which makes use of
the compiler generated code for presenting a comparatively high level
stack API.
The media part, which includes RTP and audio support, is implemented
as a sample library. The media library uses G.711 code made available
by Sun Microsystems to the open source community. Please refer to their
license for more details.
Features
========
Features supported in this package include the following:
* H.225/Q.931 - the following message types are supported (including
support for FastStart and H.245 tunneling):
- Setup
- Connect
- Call Proceeding
- Alerting
- Facility
- ReleaseComplete
* H.225/RAS - the following message types are supported
- GateKeeperRequest / Response
- RegistrationRequest / Response
- AdmissionRequest / Response
- DisengageRequest / Response
* H.245 - the following message types are supported
- MasterSlaveDetermination
- MasterSlaveDeterminationAck
- MasterSlaveDeterminationReject
- MasterSlaveDeterminationRelease
- TerminalCapabilitySet
- TerminalCapabilitySetReject
- TerminalCapabilitySetRelease
- TerminalCapabilitySetAck
- OpenLogicalChannel
- OpenLogicalChannelAck
- OpenLogicalChannelReject
- CloseLogicalChannel
- CloseLogicalChannelAck
- RequestChannelClose
- RequestChannelCloseAck
- RequestChannelCloseReject
- RequestChannelCloseRelease
* A sample media library is provided with the test programs that can
send and receive RTP data. It can play the received audio onto
speakers and can collect audio from a microphone for transmission
as an RTP stream. This library also supports transmitting audio files
over the RTP channel. The Windows version supports 16 bit, 8000 samples
per second wave file whereas the Linux version supports raw 16 bit audio
data files.
Getting Started
===============
Sample Programs
To run the sample programs, first make sure the path to the media shared
object library (liboomedia.so) is set in LD_LIBRARY_PATH:
LD_LIBRARY_PATH=<install-dir>/lib
export LD_LIBRARY_PATH
The sample programs are locates in the 'tests' subdirectory. The following
programs are available:
* receiver - an audio receiver program that will listen for incoming
requests and then play audio as it is received.
* player - an audio player program that will play a sample audio file.
* simple - an H.323 endpoint sample program. This is a sample H.323
VoIP phone application which opens g711ulaw64k channels and transmits
and receives voice. It has been tested successfully against ohPhone,
a widely used open source H.323 phone application and NetMeeting.
* chansetup - This is a sample program developed for testing multiple calls.
This program allows stack testing by placing multiple calls. The number of
calls, duration of each call and interval between successive calls are
configurable.
The receiver and player program must be run in parallel as follows:
1. Run receiver first to listen for incoming connections:
cd tests/receiver
./ooReceiver [--use-ip <ip>] [--use-port <port>]
where, [--use-ip <ip>] and [--use-port <port>] options are used to specify
local ip address and port number. By deafault, receiver application tries
to determine ip address on it's own and uses standard H.323 port 1720.
A log file will be created in the tests/receiver directory
(ooReceiver.log). Also, the log file for the media plugin will
be created in the same directory (media.log).
2. Run the player:
cd ../player
./ooPlayer --audio-file space.raw [--use-ip <ip>]
where, --audio-file is used to specify the audio file to be played.
[--use-ip <ip>] is used to specify local ip address. By deafault, player
application tries to determine ip address on it's own.
A log file will be created in the tests/player directory
(ooPlayer.log). Also, a log file for the media plug-in will be
created in the same directory (media.log).
To run the H.323 endpoint sample application:
1. Set working directory to the simple test directory:
cd tests/simple
2. To see the usage information including various options:
./simple OR ./simple --help
3. To make a call:
./simple [options] <remote>
where,
<remote> - is the dotted representation of the destinations IP address. In
case of gatekeeper, aliases can also be used.
4. To receive a call:
./simple [options] --listen
You will find simple.log and media.log in the current directory.
To run the stack test application chansetup
1. Two instances of this program have to be run. Can be run on same machine or
different machines.
2. First change to chansetup directory.
cd tests/chansetup
2. For running listener instance,
./h323peer [--use-ip ip] [--use-port port]
where local ip address and port can be specified for listening to incoming
calls. By default, application determines ip address and uses default H323
port number 1720.
3. For running calling instance
./h323peer [--use-ip ip] -n <number of calls> -duration <call duration>
-interval <inetrval between successive calls> destination
where all times are in seconds. Interval of 0 means next call will be placed
after current call finishes. "destination" is the dotted ip address of the
endpoint running listener instance.
Reporting Problems:
==================
Report problems you encounter by sending E-mail to
ooh323c-devel@lists.sourceforge.net.
If you have any further questions or comments on what you would like to
see in the product or what is difficult to use or understand, please
communicate them to us. Your feedback is important to us. Please let us
know how it works out for you - either good or bad.