Tone definitions
(Added playing tones section) |
(Added tone strings.) |
||
Line 1: | Line 1: | ||
=== Tone definitions === | === Tone definitions === | ||
− | It is possible through the [[Toolpack]] [[Web Portal]] to specify the parameters of ringing, busy, congestion (or fast busy) and warning call progress tones. | + | It is possible through the [[Toolpack]] [[Web Portal]] to specify the parameters of ringing, busy, congestion (or fast busy) and warning call progress tones. These settings are available in the Profiles -> Tone Profile Params section of the Web Portal. |
− | The tones are described using a programmable string of characters as defined in the [[H.248]] Dynamic Tone Definition Package. | + | The tones are described using a programmable string of characters as defined in the [[H.248]] Dynamic Tone Definition Package. To learn more about tone description strings, see the [[CAF:_Working_With_Call_Legs#Play_Tone_with_Signal_Id_String|section]] related to this subject. |
− | === Examples | + | === Examples of Call Progress tones === |
− | The following table contains a few tone definition strings that can be used to replace the default ones in the Toolpack Web Portal. | + | The following table contains a few call progress tone definition strings that can be used to replace the default ones in the Toolpack Web Portal. |
{| cellspacing="1" cellpadding="2" border="1" | {| cellspacing="1" cellpadding="2" border="1" | ||
Line 73: | Line 73: | ||
*Busy: <code>cg/bt</code> | *Busy: <code>cg/bt</code> | ||
*Congestion: <code>cg/ct</code> | *Congestion: <code>cg/ct</code> | ||
− | *Warning: <code>cg/wt</code> | + | *Warning: <code>cg/wt</code> |
+ | |||
+ | === Available tones === | ||
+ | |||
+ | Below is a comprehensive list of all the tone strings that can be passed to the '''AddToneString()''' function. | ||
+ | |||
+ | {| cellspacing="1" cellpadding="2" border="1" | ||
+ | |+ Tone generation | ||
+ | |- | ||
+ | ! Package | ||
+ | ! Signal | ||
+ | ! String | ||
+ | |- | ||
+ | | rowspan="16" valign="top" | Basic DTMF generation | ||
+ | | 0 | ||
+ | | dg/d0 | ||
+ | |- | ||
+ | | 1 | ||
+ | | dg/d1 | ||
+ | |- | ||
+ | | 2 | ||
+ | | dg/d2 | ||
+ | |- | ||
+ | | 3 | ||
+ | | dg/d3 | ||
+ | |- | ||
+ | | 4 | ||
+ | | dg/d4 | ||
+ | |- | ||
+ | | 5 | ||
+ | | dg/d5 | ||
+ | |- | ||
+ | | 6 | ||
+ | | dg/d6 | ||
+ | |- | ||
+ | | 7 | ||
+ | | dg/d7 | ||
+ | |- | ||
+ | | 8 | ||
+ | | dg/d8 | ||
+ | |- | ||
+ | | 9 | ||
+ | | dg/d9 | ||
+ | |- | ||
+ | | * | ||
+ | | dg/ds | ||
+ | |- | ||
+ | | # | ||
+ | | dg/do | ||
+ | |- | ||
+ | | A | ||
+ | | dg/da | ||
+ | |- | ||
+ | | B | ||
+ | | dg/db | ||
+ | |- | ||
+ | | C | ||
+ | | dg/dc | ||
+ | |- | ||
+ | | D | ||
+ | | dg/dd | ||
+ | |- | ||
+ | | rowspan="4" valign="top" | Call Progress generation | ||
+ | | Ring | ||
+ | | cg/rt | ||
+ | |- | ||
+ | | Busy | ||
+ | | cg/bt | ||
+ | |- | ||
+ | | Congestion | ||
+ | | cg/ct | ||
+ | |- | ||
+ | | Warning | ||
+ | | cg/wt | ||
+ | |- | ||
+ | | rowspan="12" valign="top" | MF tone generation | ||
+ | | 0 | ||
+ | | mfg/mf0 | ||
+ | |- | ||
+ | | 1 | ||
+ | | mfg/mf1 | ||
+ | |- | ||
+ | | 2 | ||
+ | | mfg/mf2 | ||
+ | |- | ||
+ | | 3 | ||
+ | | mfg/mf3 | ||
+ | |- | ||
+ | | 4 | ||
+ | | mfg/mf4 | ||
+ | |- | ||
+ | | 5 | ||
+ | | mfg/mf5 | ||
+ | |- | ||
+ | | 6 | ||
+ | | mfg/mf6 | ||
+ | |- | ||
+ | | 7 | ||
+ | | mfg/mf7 | ||
+ | |- | ||
+ | | 8 | ||
+ | | mfg/mf8 | ||
+ | |- | ||
+ | | 9 | ||
+ | | mfg/mf9 | ||
+ | |- | ||
+ | | KP | ||
+ | | mfg/mfa | ||
+ | |- | ||
+ | | ST | ||
+ | | mfg/mfe | ||
+ | |- | ||
+ | | rowspan="2" valign="top" | Telcofax | ||
+ | | CNG | ||
+ | | telcofax/cng | ||
+ | |- | ||
+ | | g164 | ||
+ | | telcofax/g164 | ||
+ | |} | ||
=== References === | === References === |
Revision as of 15:00, 14 July 2010
Contents |
Tone definitions
It is possible through the Toolpack Web Portal to specify the parameters of ringing, busy, congestion (or fast busy) and warning call progress tones. These settings are available in the Profiles -> Tone Profile Params section of the Web Portal.
The tones are described using a programmable string of characters as defined in the H.248 Dynamic Tone Definition Package. To learn more about tone description strings, see the section related to this subject.
Examples of Call Progress tones
The following table contains a few call progress tone definition strings that can be used to replace the default ones in the Toolpack Web Portal.
Ring | Busy | Congestion | Warning | |
---|---|---|---|---|
Brazil | ((#425,1000),(#0,4000))*0 | ((#425,250),(#0,250))*0 | ((#425,750),(#0,250),(#425,250),(#0,250))*0 | unused |
China | ((#450,1000),(#0,4000))*0 | ((#450,350),(#0,350))*0 | ((#450,700),(#0,700))*0 | unused |
France | ((#440,1500),(#0,3500))*0 | ((#450,500),(#0,500))*0 | unused | unused |
Germany | ((#425,1000),(#0,4000))*0 | ((#425,480),(#0,480))*0 | ((#425,240),(#0,240))*0 | ((#425,240),(#0,240),(#425,240),(#0,1280))*0 |
Hong Kong | ((((#440)+(#480)),400),(#0,200),(((#440)+(#480)),400),(#0,3000))*0 | ((((#480)+(#620)),500),(#0,500))*0 | ((((#480)+(#620)),250),(#0,250))*0 | unused |
Spain | ((#425,1500),(#0,3000))*0 | ((#425,200),(#0,200))*0 | ((#425,200),(#0,200),(#425,200),(#0,200),(#425,200),(#0,600))*0 | (((#1400),400),(#0,5000))*0 |
US | ((((#440)+(#480)),2000),(#0,4000))*0 | ((((#480)+(#620)),500),(#0,500))*0 | ((((#480)+(#620)),250),(#0,250))*0 | ((#1400),500) |
UK | ((((#400)+(#450)),400),(#0,200),(((#400)+(#450)),400),(#0,2000))*0 | ((#400,375),(#0,375))*0 | ((#400,400),(#0,350),(#400,225),(#400,525))*0 | unused |
Playing tones
To learn how to play these tones using the Call Leg API, refer to the Playing and Collecting Tones section. Here are the tone strings that must be passed to the AddToneString() function in order to play the call progress tones discussed in this article:
- Ring:
cg/rt
- Busy:
cg/bt
- Congestion:
cg/ct
- Warning:
cg/wt
Available tones
Below is a comprehensive list of all the tone strings that can be passed to the AddToneString() function.
Package | Signal | String |
---|---|---|
Basic DTMF generation | 0 | dg/d0 |
1 | dg/d1 | |
2 | dg/d2 | |
3 | dg/d3 | |
4 | dg/d4 | |
5 | dg/d5 | |
6 | dg/d6 | |
7 | dg/d7 | |
8 | dg/d8 | |
9 | dg/d9 | |
* | dg/ds | |
# | dg/do | |
A | dg/da | |
B | dg/db | |
C | dg/dc | |
D | dg/dd | |
Call Progress generation | Ring | cg/rt |
Busy | cg/bt | |
Congestion | cg/ct | |
Warning | cg/wt | |
MF tone generation | 0 | mfg/mf0 |
1 | mfg/mf1 | |
2 | mfg/mf2 | |
3 | mfg/mf3 | |
4 | mfg/mf4 | |
5 | mfg/mf5 | |
6 | mfg/mf6 | |
7 | mfg/mf7 | |
8 | mfg/mf8 | |
9 | mfg/mf9 | |
KP | mfg/mfa | |
ST | mfg/mfe | |
Telcofax | CNG | telcofax/cng |
g164 | telcofax/g164 |
References
- Various tones used in national networks
- H.248 Gateway Control Protocol Dynamic Tone Definition Package
- H.248 Gateway Control Protocol section E.7 (Call Progress Tone Definitions Package)