contains details about required power levels. It is considered an
error to try and play off-hook warning 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).
Prompt Tone (p):
The definition of the prompt tone and its use may be found in
requirement GR-220 [20]. The tone in GR-220 (requirement "R3-170"
or GR-220) is a 300 ms burst of a 400 Hz tone.
Ringing (rg):
See GR-506-CORE [7], Section 14. The provisioning process may
define the ringing cadence. The ringing signal may be
parameterized with the signal parameter "rep" which specifies the
maximum number of ringing cycles (repetitions) to apply. The
value for "rep" is specified in decimal and can have any value
from 1 to 255. The following will apply the ringing signal for up
to 6 ringing cycles:
S: l/rg(rep=6)
If the "rep" parameter is specified, the signal times-out when the
number of repetitions are completed (i.e., an operation complete
event can be requested and will occur at the end of the
timeout/number of rings).
If the "rep" parameter is supplied, then any timeout ("to") value
that is included will be ignored, i.e.:
S: l/rg(rep=6,to=12000)
will be treated the same as the previous example where the
parameter "to=12000" was not included. Of course, if the "to"
parameter is included without the "rep", it will be acted upon
i.e.:
S: l/rg(to=12000)
will ring for 12 seconds.
It is considered an error to try and ring a phone that is off-hook
and an error MUST consequently be returned when such attempts are
made (error code 401 - phone off-hook).
Distinctive Ringing (r0, r1, r2, r3, r4, r5, r6 or r7):
See GR-506-CORE [7], Section 14. Default values for r1 to r5 are
as defined for distinctive ringing pattern 1 to 5 in GR-506-CORE
[7]. The default values for r0, r6 and r7 are normal ringing
(i.e., the same cadence "rg"). The provisioning process may
define the ringing cadence for each of these signals. The
distinctive ringing signals may be parameterized with the signal
parameter "rep" which specifies the maximum number of ringing
cycles (repetitions) to apply. The value for "rep" is specified
in decimal and can have any value from 1 to 255.
The following will apply the ringing signal for up to 6 ringing
cycles:
S: l/r1(rep=6)
If the "rep" parameter is specified, the signal times-out when the
number of repetitions are completed (i.e., an operation complete
event can be requested and will occur at the end of the
timeout/number of rings)
If the "rep" parameter is supplied, then any timeout ("to") value
that is included will be ignored, i.e.:
S: l/r1(rep=6,to=12000)
will be treated the same as the previous example where the
parameter "to=12000" was not included. Of course, if the "to"
parameter is included without the "rep", it will be acted upon
i.e.:
S: l/r1(to=12000)
will ring for 12 seconds.
It is considered an error to try and ring a phone that is off-hook
and an error MUST consequently be returned when such attempts are
made (error code 401 - phone off-hook).
Reorder Tone (ro):
This maps to congestion tone in the ITU-T E.182 [10]
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.
Ringsplash (rs):
Also known as "Reminder ring", this tone is a burst of ringing
that may be applied to the physical forwarding line (when idle) to
indicate that a call has been forwarded and to remind the user
that a Call Forward sub-feature is active. In the US, it is
defined to be a 0.5(-0,+0.1) second burst of power ringing (see
[11]).
Distinctive Tone Pattern (s(###)):
This is used to signal or detect a tone pattern defined by the
parameter where the parameter may have a value from 0 to 999.
When specified as an event, the parameter MUST be included. The
parameter will also be included when the event is reported. This
event (the definition of tones associated with each parameter
value) requires special provisioning in the Call Agent and gateway
to insure interoperability. This signal is included here to
maintain compatibility with the previous version of this package.
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). It MAY be parameterized with a parameter value from 1
to 7, with the following meaning as defined in SR-2275, section
6.21.2 [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 |
-------------------------------------------
If the parameter is left out, the NC’ SIT tone that corresponds to
the signal "L/sit(3)" is assumed.
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.
Stutter Dial Tone (sl):
Stutter Dial Tone (also called Recall Dial Tone in GR-506-CORE [7]
and "special dial tone" in ITU-T E.182 [10]) is used to confirm
some action and request additional input from the user. An
example application is to cancel call-waiting, prior to entering a
destination address.
The stutter dial tone signal may be parameterized with the signal
parameter "del", which will specify a delay in milliseconds to
apply between the confirmation tone and the dial tone. The
parameter can have any value from 0 to 10000 ms, rounded to the
nearest non-zero value divisible by 100 (i.e., tenth of a second).
The following will apply stutter dial tone with a delay of 1.5
seconds between the confirmation tone and the dial tone:
S: l/sl(del=1500)
It is considered an error to try and play stutter 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).
Alerting Tone (v):
A 440 Hz Tone of a 2 second duration, followed by a 1/2 second of
tone every 10 seconds. This event is included for backwards
compatibility with the previous version of the package.
Visual Message Waiting Indicator (vmwi):
The transmission of the VMWI messages will conform to the
requirements in [13] and the CPE guidelines in [12]. Refer also
to section 6.6 of GR-30-CORE [14]. VMWI messages will only be
sent from the gateway to the attached equipment when the line is
idle. If new messages arrive while the line is busy, the VMWI
indicator message will be delayed until the line goes back to the
idle state. After the gateway restarts, the state of the signal
will be "off", and hence the Call Agent MUST refresh the CPE’s
visual indicator if it is supposed to be "on".
Alternative Call Waiting Tones (wt, wt1, .., wt4):
Refer to ITU-T E.180 [8]. For North American tone definitions,
refer to GR-506-CORE [7], Section 14.2. "wt" and "wt1" are both
aliases for the default Call Waiting tone, which in North America,
is a 440-Hz tone applied for 300 plus or minus 50 ms. The tone is
then repeated once after 10 seconds.
These signals are timeout signals with a default timeout value of
12 seconds, which allows the tone to be played twice with a single
request (refer to GR-571-CORE [16]). However, there are cases
(Requirement R3-73 of GR-575-CORE [18]), in which only a single
tone is required. In that case, the Call Agent may make the
request with a shorter timeout period to eliminate the second tone
(e.g., "S: wt(to=2000)" - which stops the signal after 2 seconds
so that the second tone will not occur).
Signals wt2, wt3 and wt4 are alternates that are used for
distinctive call-waiting tone patterns (refer to GR-506-CORE,
Section 14.2 [7]. It is considered an error to try and apply
call-waiting 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).
Recorder Warning Tone(y):
Refer to ITU-T E.180 [8] - also Bellcore document SR-2275 [5]
section 6.20. When recording equipment is used, this tone is
connected to the line to inform the distant party that the
conversation is being recorded - typical value used is a 1400 Hz
Tone of a 0.5 second duration every 15 seconds.
Calling Card Service Tone(z):
This tone is used to inform the customer that credit card
information must be keyed in. Typically, it consists of 60 ms of
941 + 1477 Hz (the DTMF #digit) and 940 ms of 350 + 440 Hz (dial
tone), decaying exponentially with a time constant of 200 ms.
Refer to Bellcore document SR-2275 [5], section 6.20.
2.5. Handset Emulation Package
Package Name: H
Version: 1
----------------------------------------------------------------
|Symbol | Definition | R | S Duration |
|----------------------------------------------------------------|
|adsi(string) | ADSI Display | x | BR |
|aw | Answer Tone | x | OO |
|bz | Busy Tone | x | TO 30 sec. |
|ci(ti,nu,na) | Caller-id | x | BR |
|dl | Dial Tone | x | TO 16 sec. |
|e | Error Tone | x | TO 2 sec. |
|hd | Off-hook Transition | S | BR |
|hu | On-hook Transition | S | BR |
|hf | Flash Hook | x | BR |
|ht | Tone On Hold | x | OO |
|lsa | Line Side Answer Sup. | x | OO |
|mwi | Message Waiting Ind. | x | TO 16 sec. |
|nbz | Network Busy | x | TO infinite |
|oc | Operation Complete | x | |
|ot | Off-hook Warning Tone | x | TO infinite |
|of | Operation Failure | x | |
|osi | Network Disconnect | x | TO 900 ms |
|p | Prompt Tone | x | BR |
|rg | Ringing | x | TO 180 sec. |
|r0, r1, r2, | Distinctive Ringing | x | TO 180 sec. |
|r3, r4, r5, | | | |
|r6 or r7 | | | |
|ro | Reorder Tone | x | TO 30 sec. |
|rs | Ringsplash | x | BR |
|s(###) | Distinctive Tone Pattern | x | BR |
|sit(#) | Sit Tone | x | TO 2 sec. |
|sl | Stutter Dial Tone | x | TO 16 sec. |
|v | Alerting Tone | x | OO |
|vmwi | Vis. Message Waiting Ind.| x | OO |
|wt | Call Waiting tone | x | TO 12 sec. |
|wt1, wt2, | Alternative Call | x | TO 12 sec |
|wt3, wt4 | Waiting Tones | | (see notes) |
|y | Recorder Warning Tone | x | TO infinite |
|z | Calling Card Serv. Tone | x | BR |
----------------------------------------------------------------
The handset emulation package is similar to the line package except
that events such as "off-hook" can be signaled as well as detected.
Changes from the original package - are the same changes as were made
for the line package, plus "hu" and "hd" signal types were changed
from OO to BR.
Event definitions are the same as for the line package with the
following exceptions:
ASDI:
When requested as an event by the Call Agent, the event is not
parameterized. However, the parameter is included when the event
is reported.
Caller-id:
When requested as an event by the Call Agent, the event MUST not
be parameterized. However, parameters are included when the event
is reported i.e.:
O: l/ci(09/14/17/26,"555 1212","John Doe")
Line Side Answer Supervision:
When requested as an event by the Call Agent, it indicates when
the reverse loop current feed (RLCF) was turned on and off. The
event is not parameterized when it is requested. However, a
parameter is included when it is reported i.e.:
O: l/lsa(+) to indicate RLCF was turned on
O: l/lsa(-) to indicate RLCF was turned off
Ringing (rg):
When requested as an event, the Call Agent may optionally include
the rep parameter indicating a request to report after some number
of rings e.g.:
RQNT 1234 aaln/1@rgw2.example.net
X: AB123FE0
R: h/rg(N)(rep=3)
The resulting notification after the number of rings is detected
includes the parameter again:
NTFY 3002 ds/ds1-3/6@gw-o.whatever.net MGCP 1.0
X: AB123FE0
O: h/rg(rep=3)
If the parameter is not included in the request, it is also not
included in the report. In that case, the event is reported as
soon as ringing is detected.
Distinctive Ringing (r0, r1, r2, r3, r4, r5, r6 or r7):
As with the "rg" event, if the "rep" parameter is included when
one of these is requested as an event, it is also reported. If it
is not requested with the parameter, then the parameter is also
not included in the report. In that case, the event is reported
as soon as ringing with the requested cadence is detected.
Stutter Dial Tone (sl):
Stutter Dial Tone MUST not be parameterized when requested as an
event. However, the "del" parameter is reported.
RQNT 1234 aaln/1@rgw2.example.net
X: AB123FE0
R: h/sl
The resulting notification indicates the delay between the
confirmation tone and the dial tone:
NTFY 3002 ds/ds1-3/6@gw-o.whatever.net MGCP 1.0
X: AB123FE0
O: h/sl(del=1500)
As with the signal, the report indicates the delay rounded to the
nearest 100 ms.
Visual Message Waiting:
When requested as an event by the Call Agent, it indicates when
the visual message waiting indicator was turned on and off. The
event is not parameterized when it is requested. However, a
parameter is included when it is reported i.e.:
O: l/vmwi(+) to indicate message waiting turned on
O: l/vmwi(-) to indicate message waiting turned off
Note that:
* All TO signals in the handset package can include a "to"
parameter when requested as a signal.
* However, requests to be notified about these events MUST NOT
include the "to" parameter, i.e., the "to" parameter is not
valid in RequestedEvents.
2.6. Supplementary Services Tone Package
Package Name: SST
Version: 0
---------------------------------------------------------------
|Symbol | Definition | R | S Duration |
|---------------------------------------------------------------|
|cd | Conference Depart | | BR |
|cj | Conference Join | | BR |
|cm | Comfort Tone | | TO infinite |
|cw | Caller Waiting Tone | | TO 30 sec. |
|ht | On Hold Tone | | OO |
|ni | Negative Indication | | TO infinite |
|nu | Number Unobtainable | | TO infinite |
|oc | Operation Complete | x | |
|of | Operation Failure | x | |
|pr | Pay Phone Recognition | | BR |
|pt | Pay Tone | | BR |
----------------------------------------------------------------
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 events in this package are defined as follows:
Conference Depart(cd):
Tone used to indicate that a participant has left a conference
call. The tone characteristics are left to the specific gateway
implementation.
Conference Join (cj):
Tone used to indicate that a party has joined a conference call.
The tone characteristics are left to the specific gateway
implementation.
Comfort Tone (cm):
Comfort Tone is used to indicate that the call is being processed
and that the caller should wait. Refer to ITU-T E.182 [10].
Caller Waiting Tone (cw):
Not to be confused with a call-waiting tone, this is a tone
advising a caller that a called station, though busy, has a call
waiting service active. Refer to ITU-T E.182 [10].
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].
Negative Indication (ni):
A tone advising a subscriber that the request for service cannot
be accepted. Refer to ITU-T E.182 [10]. For North America, this
maps to the re-order tone (see GR-506-CORE [7], Section 17.2.7).
Number Unobtainable Tone (nu):
Refer to ITU-T E.180, supplement 2 [9]. This is also referred to
as "vacant tone" and maps to a "re-order tone" in North America
(see GR-506-CORE [7], Section 17.2.7).
Operation Complete (oc):
The standard definition of operation complete [1].
Operation Failure (of):
The standard definition of operation failure [1].
Pay Phone Recognition (pr):
A tone advising an operator that the endpoint is identified as a
payphone. Refer to ITU-T E.182 [10].
Pay Tone (pt):
A tone indicating that payment is required. Refer to ITU-T E.182
[10].
2.7. Digit Map Extension
Package Name: dm1 ("dm" followed by the number "1")
Version: 0
Extension Digit Map Letters: P
This package defines an Extension Digit Map Letter that is used to
override the shortest possible match behavior for a given entry in a
digit map (see [1]). The letter "P" (for partial match override), at