will send a notification of the return tone event (Note that
notification of the return tone event therefore must not be sent
prior to detection of the removal of the return tone).
The "T/co1" and "T/co2" signals are TO signals so that an
operation complete event will occur when the signal times out. If
a timeout value other than the default is desired, the "to"
parameter may be used (e.g., "S: T/co1(to=2000)").
If the gateway detects the failure of the continuity test prior to
the timeout, an operation failure event will be generated.
Otherwise, the failure of the continuity test is determined by the
failure to receive the return tone event before the timeout occurs
(operation complete event). As with TO signals in general,
operation complete and operation fail events are parameterized
with the name of the signal.
In the example above where the go tone is "co1" and the return
tone is "co2":
* A notification of the "co2" event indicates success (i.e.,
"O: t/co2").
* A notification of the operation failure event indicates
failure prior to timeout (i.e., "O: t/of(t/co1)").
* A notification of the operation complete event indicates
that the return tone was not received properly prior to the
occurrence of the timeout (i.e., "O: t/oc(t/co2)").
On a terminating end of a trunk, either a "loopback" connection
(single tone test) or "conttest" connection (dual tone test) is
made (or alternatively the "T/lb" or "T/ct" signals are
requested). It is up to the termination end to make sure that the
return tone is removed as soon as the go tone disappears. The
Call Agent requests the removal of "contest" or "loopback"
connections (or "T/lb" or "T/ct" signals) at a termination end
when the results of the continuity test are obtained.
When "conttest" is used, the endpoint is provisioned as to which
transponder test is being performed (2010 Hz received and 1780 Hz
sent or vice versa). In the case of the corresponding "T/ct"
signal, the Call Agent can specify which tone is received and sent
as parameters.
Note that continuity tones in the trunk package are only ever sent
to the telephony endpoint. For network-based continuity, there
are continuity tones available in the RTP ("R") package. Although
a transponder (dual tone) test can be done, a single tone test is
generally sufficient in the case of continuity testing across an
IP network.
Continuity Transponder(ct(in=<tone-in>,out=<tone-out>, <+ or ->)):
This signal is used to provide transponder functionality
independent of the connection mode, i.e., this is an alternative
way to provide the same functionality as the "conttest" connection
mode. The parameters can be provided in any order. The <tone-in>
and <tone-out> parameters can have values "co1" or "co2",
corresponding to the 2010 Hz and 1780 Hz tones associated with
those symbols. If one of the tones is "co1", then the other must
be "co2" and vice versa (i.e., <tone-in> and <tone-out> must have
different values; if loopback is required, then the "lb" signal in
this package or "loopback" connection mode should be used).
On detecting <tone-in>, <tone-out> will be generated in return.
The tone corresponding to <tone-out> will continue to be generated
until either:
* The signal is explicitly turned off (e.g., "S: t/ct(-)") or
* Removal of the <tone-in> tone is detected.
Note that while the signal is active (regardless of whether a tone
is active or not), media from the endpoint will not be forwarded
to or from the packet network (i.e., the continuity transponder
signal must be explicitly turned off by the Call Agent in order to
resume passing media between the packet network and the endpoint).
Loopback (lb):
This signal is used to provide loopback functionality independent
of the connection mode, i.e., this is an alternative way to
provide the same functionality as "loopback" connection mode.
Note that while the loop-back signal is active (regardless of
whether a tone is active or not), media from the endpoint will not
be forwarded to or from the packet network (i.e., the loopback
signal must be explicitly turned off by the Call Agent in order to
resume passing media between the packet network and the endpoint).
New Milliwatt Tone (nm):
1004 Hz tone - refer to [4] and section 8.2.5 of [5].
Newest Milliwatt Tone (mm):
1013.8 Hz - refer to [4].
Operation Complete (oc):
This is the standard definition of operation complete [1].
Operation Failure (of):
This is the standard definition of operation failure [1].
Old Milliwatt Tone (om):
1000 Hz tone - refer to [4] and section 8.2.5 of [5].
Permanent Signal Tone (pst):
In North America, this tone is applied to a busy line
verify/operator interrupt under specific circumstances as
described in [17].
Quiet Termination (qt):
Quiet Termination is used in a 102 trunk test. Reference section
6.20.5 [5] as well as [4].
Reorder Tone(ro):
This maps to congestion tone in the ITU-T E.182 specification. In
North America, reorder tone is a combination of two AC tones with
frequencies of 480 and 620 Hertz and levels of -24 dBm each, to
give a combined level of -21 dBm. The cadence for reorder tone is
0.25 seconds on, followed by 0.25 seconds off, repeating
continuously (until time-out). See GR-506-CORE [7], Section
17.2.7.
Special Information Tone(sit(#)):
As described in ITU-T E.180 [8], the special information tone
consists of a tone period in which 3 tones are produced followed
by a silent period of 1 second (total TO period of approximately 2
seconds). When used as a signal, it MUST be parameterized with a
parameter value from 1 to 7, with the following meaning as defined
in SR-2275, section 6.21.2 of [5].
-------------------------------------------
| sit(1) | RO’ | reorder SIT, intra-LATA |
| sit(2) | RO" | reorder SIT, inter-LATA |
| sit(3) | NC’ | no circuit SIT, intra-LATA |
| sit(4) | NC" | no circuit SIT, inter-LATA |
| sit(5) | IC | intercept SIT |
| sit(6) | VC | vacant code SIT |
| sit(7) | IO | ineffective other SIT |
-------------------------------------------
When requested as an event, the event MUST be parameterized with a
decimal number from 1 to 7 to indicate which tone the gateway is
required to detect. The resulting notification also includes the
parameter. Other countries may have one or more special
information tones with country specific definitions (refer to
ITU-T E.180 supp. 2 [9]). In this case, special information tone
1 as defined in [9] is sit(1), special information tone 2 is
sit(2) etc.
As an example, the Call Agent might make a request such as:
RQNT 1234 ds/ds1-1/17@tgw2.example.net
X: AB123FE0
R: t/sit(N)(2)
If the tone is detected, the resulting notification might appear
as follows:
NTFY 3002 ds/ds1-3/6@gw-o.whatever.net MGCP 1.0
X: AB123FE0
O: t/sit(2)
Test Line (tl):
105 Test Line test progress tone (2225 Hz + or - 25 Hz at -10
dBm0). Refer to section 8.2.5 of [5].
Test Pattern (tp(###)):
The tp(###) signal inserts the pattern ### continuously into the
channel until the timeout period expires. The parameter is
provided as a decimal number from 0 to 255. If the parameter is
omitted, the default value is decimal 95.
In RequestedEvents, the parameter MAY be supplied to indicate what
pattern the Call Agent wishes the gateway to detect. If the
parameter is omitted, the value 95 is assumed. The pattern MUST
be returned in the ObservedEvent (even if the parameter was not
requested).
A typical use for the test pattern signal is for the test line 108
(digital loopback) test (refer to section 8.2.5 of [5]). At the
termination side of a trunk, the Call Agent would request a
connection in "loopback" mode, which would do a digital loopback.
On the origination side of the trunk, the Call Agent would request
that the test pattern be injected into the digital channel, and
would check to see that the pattern was returned within the
timeout period. As an example, the Call Agent would make the
following request on the origination side:
RQNT 1234 ds/ds1-1/17@tgw2.example.net
X: AB123FE0
S: t/tp
R: t/tp, t/oc, t/of
In this case the Call Agent will either receive:
* An ObservedEvent indicating that the test has passed (i.e.,
"O:t/op(95)") or
* An ObservedEvent indicating that the timeout occurred before
the pattern was received (i.e., "O:t/oc(t/tp)"), indicating
that the test failed. Of course an operation failure would
indicate failure as well.
No Circuit (zz):
This is an alias for Special Information Tone 2, i.e., "sit(2)".
2.4. Line Package
Package Name: L
Version: 1
----------------------------------------------------------------
|Symbol | Definition | R | S Duration |
|----------------------------------------------------------------|
|adsi(string) | ADSI Display | | BR |
|aw | Answer Tone | x | OO |
|bz | Busy Tone | | TO 30 sec. |
|ci(ti,nu,na) | Caller-id | | BR |
|dl | Dial Tone | | TO 16 sec. |
|e | Error Tone | x | TO 2 sec. |
|hd | Off-hook Transition | S | |
|hf | Flash-hook | x | |
|ht | On Hold Tone | | OO |
|hu | On-hook Transition | S | |
|lsa | Line Side Answer Sup. | | OO |
|mwi | Message Waiting ind. | | TO 16 sec. |
|nbz | Network busy | x | TO infinite |
|oc | Operation Complete | x | |
|of | Operation Failure | x | |
|osi | Network Disconnect | | TO 900 ms |
|ot | Off-hook Warning Tone | | TO infinite |
|p | Prompt Tone | x | BR |
|rg | Ringing | | TO 180 sec. |
|r0, r1, r2, | Distinctive Ringing | | TO 180 sec. |
|r3, r4, r5, | | | |
|r6 or r7 | | | |
|ro | Reorder Tone | | TO 30 sec. |
|rs | Ringsplash | | BR |
|s(###) | Distinctive Tone Pattern | x | BR |
|sit(#) | Special Information Tone | | TO 2 sec. |
| | | | (see notes) |
|sl | Stutter Dial Tone | | TO 16 sec. |
|v | Alerting Tone | | OO |
|vmwi | Visual Message | | OO |
| | Waiting Indicator | | |
|wt | Call Waiting Tone | | TO 12 sec |
|wt1, wt2, | Alternative Call | | TO 12 sec |
|wt3, wt4 | Waiting Tones | | (see notes) |
|y | Recorder Warning Tone | | TO infinite |
|z | Calling Card Service Tone| | BR |
----------------------------------------------------------------
New events added to this package from the previously unversioned
package: "ht", "osi", and "lsa".
Changes in event types: signals "y", "z", changed from OO to TO and
BR respectively. Ringing tones were extended to allow for a ring
repetition signal parameter.
Note that default time-out values may be over-ridden by the Call
Agent for any Time-Out signal defined in this package by a "to"
signal parameter. Refer to section 2 of this document, as well as
[1] for details.
The description of events and signals in the line package are as
follows:
ADSI Display (adsi):
This signal is included here to maintain compatibility with the
previous version of this package. The signal is not well-defined
and its use is discouraged.
Answer Tone (aw):
This event is included here to maintain compatibility with the
previous version of this package. The event is not well-defined
and its use is discouraged.
Busy Tone (bz):
Refer to ITU-T E.180 [8]. In North America, station Busy is a
combination of two AC tones with frequencies of 480 and 620 Hertz
and levels of -24 dBm each, to give a combined level of -21 dBm.
The cadence for Station Busy Tone is 0.5 seconds on followed by
0.5 seconds off, repeating. See GR-506-CORE [7], Section 17.2.6.
It is considered an error to try and play busy tone on a phone
that is on-hook and an error MUST consequently be returned when
such attempts are made (error code 402 - phone on-hook).
Caller-id (ci(time, number, name)):
See GR-1188 [24], GR-30-CORE [14], and GR-31 [25]. For backwards
compatibility, each of the three fields are optional, but each of
the commas will always be included. In accordance with the
general MGCP grammar, it is RECOMMENDED to always include all
three fields - an empty quoted string can then be used in lieu of
omitting a parameter:
The time parameter is coded as "MM/DD/HH/MM", where MM is a two-
digit decimal value for a Month between 01 and 12, DD is a two-
digit value for a Day between 01 and 31, and Hour and Minute are
two-digit values coded according to military local time, e.g., 00
is midnight, 01 is 1 a.m., and 13 is 1 p.m. (Note: two digits
MUST always be provided for each of the values of month, day,
hour, minutes e.g., the month of January is indicated by the two
digits "01" rather than just "1").
The number parameter is coded as an ASCII character string of
decimal digits that identify the calling line number. White
spaces are permitted if the string is quoted, but they will be
ignored. If a quoted-string is provided, the string itself is
UTF-8 encoded (RFC 2279) as usual for signal parameters.
The name parameter is coded as a string of ASCII characters that
identify the calling line name. White spaces are permitted if the
string is quoted. If a quoted-string is provided, the string
itself is UTF-8 encoded (RFC 2279).
A "P" in the number or name field is used to indicate a private
number or name, and an "O" is used to indicate an unavailable
number or name. Other letters MAY be used to provide additional
clarification as per provider or vendor specifications.
The following example illustrates the use of the caller-id signal:
S: l/ci(09/14/17/26, "555 1212", "John Doe")
An example indicating that the name and number are private:
S: l/ci(09/14/17/26,P,P)
Dial Tone (dl):
Refer to the ITU-T E.180 [8] specification. In North America,
dial tone is a combination of two continuous AC tones with
frequencies of 350 and 440 Hertz and levels of -13dBm each, to
give a combined level of -10 dBm. See GR-506-CORE [7] - LSSGR:
SIGNALING, Section 17.2.1. It is considered an error to try and
play dial-tone on a phone that is on-hook and an error MUST
consequently be returned when such attempts are made (error code
402 - phone on-hook).
Error Tone (e):
This tone is maintained for backwards compatibility. The tone is
not well defined and its use is discouraged.
Off-hook Transition (hd):
See GR-506-CORE [7], Section 12. It is considered an error to try
and request off-hook on a phone that is off-hook and an error MUST
consequently be returned when such attempts are made (error code
401 - phone off-hook).
Flash Hook (hf):
See GR-506-CORE [7], Section 12. It is considered an error to try
and request flash hook on a phone that is on-hook and an error
MUST consequently be returned when such attempts are made (error
code 402 - phone on-hook).
Tone On Hold (ht):
A tone used to reassure a calling subscriber who has been placed
on "hold". Refer to ITU-T E.182 [10].
On-hook Transition (hu):
See GR-506-CORE [7], Section 12. The timing for the on-hook
signal is for flash response enabled, unless provisioned
otherwise. It is considered an error to try and request flash
hook on a phone that is on-hook and an error MUST consequently be
returned when such attempts are made (error code 402 - phone on-
hook).
Line Side Answer Supervision (lsa):
This provides Reverse Loop Current Feed (RLCF) on the line (refer
to GR-506-CORE [7]) and is a way of indicating that the called
party has answered for some line-side equipment.
Message Waiting Indicator (mwi):
Message Waiting indicator tone uses the same frequencies and
levels as dial tone (350 and 440 Hertz at -13dBm each), but with a
cadence of 0.1 second on, 0.1 second off, repeated 10 times,
followed by steady application of dial tone. See GR-506-CORE [7],
Section 17.2.3. It is considered an error to try and play
message-waiting indicator on a phone that is on-hook and an error
MUST consequently be returned when such attempts are made (error
code 402 - phone on-hook).
Network Busy (nbz):
This is included here to maintain compatibility with the previous
version of this package. The "nbz" signal is an alias for re-
order tone signal("ro"). Future Call Agent implementations that
require a network busy signal should use the "ro" signal. It is
also recommended that future Call Agents not request to be
notified of the "nbz" event (a network busy event is generally not
required in a line package; hence, "ro" is only a signal, not an
event).
Operation Complete (oc):
This is the standard definition of operation complete [1].
Operation Failure (of):
This is the standard definition of operation failure [1].
Network Disconnect (osi):
Network Disconnect indicates that the far-end party has
disconnected. The signal that is sent on the line is provisioned
in the media gateway since it may vary from country to country.
In North America, this signal is an open switch interval which
results in a Loop Current Feed Open Signal (LCFO) being applied to
the line (refer to GR-506-CORE [7], see also See GR-505-CORE [6],
Section 4.5.2.1). The default time-out value for this signal is
900 ms.
Off-hook Warning Tone (ot):
Off-hook warning tone, also known as receiver Off-Hook Tone (ROH
Tone). This is the irritating noise a telephone makes when it is
not hung up correctly. In North America, ROH Tone is generated by
combining four tones at frequencies of 1400 Hertz, 2060 Hertz,
2450 Hertz and 2600 Hertz, at a cadence of 0.1 second on, 0.1
second off, then repeating. GR-506-CORE [7], Section 17.2.8