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
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
|
Configuration of OpenH323 Channel driver
==========================================
General
---------
This section describes the configurable parameters
of the OpenH323 channel driver (OH323), through its configuration
file (usually /etc/asterisk/oh323.conf).
There are three categories:
(1) "general", with generic configuration information (address,
ports, gatekeeper, ...),
(2) "register", with associations of H.323 aliases/prefixes and
related ASTERISK contexts,
(3) "codecs", with configuration information
about supported codecs.
Parameters in "general" section:
----------------------------------
"listenAddress" - Address to bind to for incoming H.323 connections.
The default value is "0.0.0.0"
"listenPort" - This is the TCP port the H.323 listener will listen
on for incoming connections.
The default value is 1720.
"connectPort" - This is the TCP port of the remote H.323 endpoint, where
Asterisk will try to connect to.
The default value is 1720.
NOTE: This option is deprecated and will be removed. The user
may specify the remote port of the connection through the dial-string.
"tcpStart", "tcpEnd" - The TCP port range to be used by OpenH323
channel driver. This port range is used by the H.245 and H.225.0
elements of the protocol.
The default range is 5000-31000.
"udpStart", "udpEnd" - The UDP port range to be used by OpenH323
channel driver. This range refers to the ports used by the H.225.0
RAS element and doesn't include the RTP port range which can be
configured in "rtp.conf" file.
The default range is 5000-31000.
"fastStart" - Disables or enables the fast start mechanism of H.323.
Default value is "no".
"h245Tunnelling" - Disables or enables the H.245 tunnelling mechanism
of H.323.
Default value is "no".
"h245inSetup" - Disables or enables early H.245 messages in SETUP messages.
Default value is "no".
"inBandDTMF" - Disables or enables in-band DTMF detection. This operation
is performed using Asterisk's in-band DTMF detector. Currently,
this capability works only on G.711 A/ulaw streams.
Default value is "no".
"silenceSuppression" - Disables or enables silence detection for software
codecs GSM and G.711.
Default value is "no".
NOTE: This option is deprecated and will be removed.
"jitterMin", "jitterMax" - Set jitter buffer min and max values. The
values are in milliseconds, in the range 20...10000ms.
The default range is 20-100.
"ipTos" - IP Type-of-Service byte for RTP channels.
Valid values for this option are:
"lowdelay"
"throughput"
"reliability"
"mincost"
"none"
The default value is "none".
"inboundMax", "outboundMax" - These are the upper limits of inbound
and outbound H.323 connections. If both parameters are 0, then the
OpenH323 channel driver is disabled (no H.323 calls are permitted
or received).
The default values are "0", "0" (disabled!).
"gatekeeper" - Select a gatekeeper option. Valid values for this
parameter are:
DISABLE - disable gatekeeper,
DISCOVER - enable gatekeeper discovery (through UDP broadcasts)
<hostname> or <ip> - explicitly specify a gatekeeper
with its hostname or IP,
GKID:<gatekeeper's id> - explicitly specify a gatekeeper
with its ID.
The default value is "DISABLE".
"gatekeeperPassword" - The password to be used for gatekeeper authentication.
"userInputMode" - Specify the mode for sending user-input (DTMF).
Valid values are:
Q931 - Q.931 Keypad Information Element
STRING - H.245 string
TONE - H.245 tone
RFC2833 - RFC2833 (this option is not supported yet)
The default value is "TONE".
"accountCode" - This parameter sets the account code for records generated
by the OpenH323 channel driver.
No default value.
"amaFlags" - This parameter sets the AMA (Automated Machine Accounting)
flags on the created H.323 channels. Valid values are:
default - Select system's default
omit - No record is written
billing - Write record as "BILLING"
documentation - Write record as "DOCUMENTATION"
"context" - This is the default context in "extensions.conf" file
where all the incoming H.323 calls without an associated context,
are routed to.
The default value is "default".
"wrapTraceLevel", "libTraceLevel", "libTraceFile" - Trace options for
the wrapper library used by the OpenH323 channel driver.
These options provide access to the tracing capabilities
of the OpenH323 library. "libTraceFile" can be 'stdout'
or a full path name to a file. "wrapTraceLevel" and
"libTraceLevel" can be set to 0 to disable tracing.
Parameters in "register" section:
-----------------------------------
This section contains one or more groups with the following format:
context=...
alias=...
alias=...
...
gwprefix=...
gwprefix=...
...
The various fields have the following meaning:
"context" - This is the context in "extensions.conf" file where all the
incoming H.323 calls, with a calling party number that matches
any of the alias(es)/prefix(es) following this option, are routed.
Actually, a "context" option, groups together a set of
"alias" and/or "gwprefix" options (see below).
"alias" - Specify H.323 alias(es) for ASTERISK PBX. This parameter
can be used multiple times. If this parameter contains
only numbers, then this alias will be registered to the
gatekeeper as a E.164 number otherwise will be registered
as a H323ID. Incoming calls with a calling party number
matching this alias, are routed into the context specified
in the preceding "context" option.
"gwprefix" - Specify H.323 gateway prefix(es) for ASTERISK PBX.
This parameter can be used multiple times. Incoming
calls with a calling party number matching this prefix,
are routed into the context specified in the preceding
"context" option.
Parameters in "codecs" section:
---------------------------------
This section contains one or more groups with the following format:
codec=...
frames=...
The various fields have the following meaning:
"codec" - Specify a codec to be used by the H.323 channel driver.
Valid values are:
G711U - G.711 u-Law
G711A - G.711 A-Law
G7231 - G.723.1(6.3k)
G72316K3 - G.723.1(6.3k)
G72315K3 - G.723.1(5.3k)
G7231A6K3 - G.723.1A(6.3k)
G7231A6K3 - G.723.1A(6.3k)
G728 - G.728
G729 - G.729
G729A - G.729A
G729B - G.729B
G729AB - G.729AB
GSM0610 - GSM 0610
MSGSM - Microsoft GSM Audio Capability
LPC10 - LPC-10
Currently, only G711U, G711A, G7231, G729, GSM0610
can be used.
"frames" - This option may follow a "codec" option, specifying
the number of voice encoded frames in RTP packets for this
codec.
Dial string of OpenH323 (OH323) channels
------------------------------------------
The following are some examples of the usage of the channel driver
through the "Dial" application.
Dial(OH323/123)
Here we assume that a gatekeeper is used. The H.323 endpoint with
the alias "123", registered to the gatekeeper, will be called.
Dial(OH323/1.2.3.4)
The H.323 endpoint with IP address "1.2.3.4" will be called. No
lookup to a gatekeeper (if one is used) is performed.
Dial(OH323/5.6.7.8:1234)
The same as above, but the port "1234" will be used to reach the
remote H.323 endpoint (not the default 1720).
Dial(OH323/ws1.inaccessnetworks.com)
The H.323 endpoint with DNS name "ws1.inaccessnetworks.com" will
be called.
Dial(OH323/user1@gw1.inaccessnetworks.com:2004)
Call the H.323 endpoint with alias or H.323 ID "user1", at
host "gw1.inaccessnetworks.com", port "2004".
|
