Tone definitions

From TBwiki
(Difference between revisions)
Jump to: navigation, search
(→Examples of Call Progress tones)
m (Added Bangladesh tone)
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. These settings are available in the Profiles -> Tone Profile Params section of the Web Portal.
+
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 [[CAF:_Working_With_Call_Legs#Play_Tone_with_Signal_Id_String|section]] related to this subject.
+
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 of Call Progress tones ===
+
=== 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.  
 
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.  
Line 11: Line 11:
 
{| cellspacing="1" cellpadding="2" border="1"
 
{| cellspacing="1" cellpadding="2" border="1"
 
|-
 
|-
−
!  
+
! <br>
 
! Ring  
 
! Ring  
 
! Busy  
 
! Busy  
 
! Congestion  
 
! Congestion  
 
! Warning
 
! Warning
 +
|-
 +
! Bangladesh<br>
 +
| ((#425,1000),(#0,4000))*0<br>
 +
| ((#450,200),(#0,300),(#450,700),(#0,800))*0 <br>
 +
| ((#425,250),(#0,250))*0 <br>
 +
| ((#450,200),(#0,20),(#450,200),(#0,140))*0 <br>
 
|-
 
|-
 
! Brazil  
 
! Brazil  
Line 53: Line 59:
 
| (((#1400),400),(#0,5000))*0
 
| (((#1400),400),(#0,5000))*0
 
|-
 
|-
−
! US
+
! United States of America
 
| ((((#440)+(#480)),2000),(#0,4000))*0  
 
| ((((#440)+(#480)),2000),(#0,4000))*0  
 
| ((((#480)+(#620)),500),(#0,500))*0  
 
| ((((#480)+(#620)),500),(#0,500))*0  
Line 59: Line 65:
 
| ((#1400),500)
 
| ((#1400),500)
 
|-
 
|-
−
! UK
+
! United Kingdom
 
| ((((#400)+(#450)),400),(#0,200),(((#400)+(#450)),400),(#0,2000))*0  
 
| ((((#400)+(#450)),400),(#0,200),(((#400)+(#450)),400),(#0,2000))*0  
 
| ((#400,375),(#0,375))*0  
 
| ((#400,375),(#0,375))*0  
 
| ((#400,400),(#0,350),(#400,225),(#0,525))*0  
 
| ((#400,400),(#0,350),(#400,225),(#0,525))*0  
 
| ''unused''
 
| ''unused''
−
|-
 
 
|}
 
|}
 +
 
{| cellspacing="1" cellpadding="2" border="1"
 
{| cellspacing="1" cellpadding="2" border="1"
−
! The Moon...
+
|-
−
| ((#262,2000),(#391,2000),(#523,4000),(((#659)+(#523)),250),(((#622)+(#523)),3750),(#262,400),(#196,400),(#262,400),(#196,400),(#262,400),(#196,400),(#262,400),(#196,400),(#262,420),(#196,460),(#262,540),(#196,620))*0  
+
! The Moon...  
 +
| ((#262,2000),(#391,2000),(#523,4000),(((#659)+(#523)),250),(((#622)+(#523)),3750),(#262,400),(#196,400),(#262,400),(#196,400),(#262,400),(#196,400),(#262,400),(#196,400),(#262,420),(#196,460),(#262,540),(#196,620))*0
 
|}
 
|}
  
 
=== Playing and collecting tones  ===
 
=== Playing and collecting tones  ===
  
−
To learn how to play these tones using the [[CAF: Working With Call Legs|Call Leg API]], refer to the [[CAF: Working With Call Legs#Playing_and_Collecting_Tones|Playing and Collecting Tones section]].
+
To learn how to play these tones using the [[CAF: Working With Call Legs|Call Leg API]], refer to the [[CAF: Working With Call Legs#Playing_and_Collecting_Tones|Playing and Collecting Tones section]].  
  
−
For example, to play the '''ringing''' tone, one could pass either directly <code>((((#440)+(#480)),2000),(#0,4000))*0</code> or <code>cg/rt</code> to the '''AddToneString()''' function. The <code>cg/rt</code> string refers to the current Tone Profile Params ringing tone setting from the Web Portal.
+
For example, to play the '''ringing''' tone, one could pass either directly <code>((((#440)+(#480)),2000),(#0,4000))*0</code> or <code>cg/rt</code> to the '''AddToneString()''' function. The <code>cg/rt</code> string refers to the current Tone Profile Params ringing tone setting from the Web Portal.  
  
−
=== Available tones ===
+
=== Available tones ===
  
−
Below is a comprehensive list of all the tone strings that can be passed to the '''AddToneString()''' function.
+
Below is a comprehensive list of all the tone strings that can be passed to the '''AddToneString()''' function.  
  
 
{|
 
{|
−
| valign="top" |
+
|-
 +
| valign="top" |  
 
{| cellspacing="1" cellpadding="2" border="1"
 
{| cellspacing="1" cellpadding="2" border="1"
−
|+ '''Tone generation'''
+
|+ '''Tone generation'''  
 
|-
 
|-
−
! Package
+
! Package  
−
! Signal
+
! Signal  
 
! String
 
! String
 
|-
 
|-
−
| rowspan="16" valign="top" | Basic DTMF generation
+
| valign="top" rowspan="16" | Basic DTMF generation  
−
| 0
+
| 0  
 
| dg/d0
 
| dg/d0
 
|-
 
|-
−
| 1
+
| 1  
 
| dg/d1
 
| dg/d1
 
|-
 
|-
−
| 2
+
| 2  
 
| dg/d2
 
| dg/d2
 
|-
 
|-
−
| 3
+
| 3  
 
| dg/d3
 
| dg/d3
 
|-
 
|-
−
| 4
+
| 4  
 
| dg/d4
 
| dg/d4
 
|-
 
|-
−
| 5
+
| 5  
 
| dg/d5
 
| dg/d5
 
|-
 
|-
−
| 6
+
| 6  
 
| dg/d6
 
| dg/d6
 
|-
 
|-
−
| 7
+
| 7  
 
| dg/d7
 
| dg/d7
 
|-
 
|-
−
| 8
+
| 8  
 
| dg/d8
 
| dg/d8
 
|-
 
|-
−
| 9
+
| 9  
 
| dg/d9
 
| dg/d9
 
|-
 
|-
−
| *
+
| *  
 
| dg/ds
 
| dg/ds
 
|-
 
|-
−
| #
+
| #  
 
| dg/do
 
| dg/do
 
|-
 
|-
−
| A
+
| A  
 
| dg/da
 
| dg/da
 
|-
 
|-
−
| B
+
| B  
 
| dg/db
 
| dg/db
 
|-
 
|-
−
| C
+
| C  
 
| dg/dc
 
| dg/dc
 
|-
 
|-
−
| D
+
| D  
 
| dg/dd
 
| dg/dd
 
|-
 
|-
−
| rowspan="4" valign="top" | Call Progress generation
+
| valign="top" rowspan="4" | Call Progress generation  
−
| Ring
+
| Ring  
 
| cg/rt
 
| cg/rt
 
|-
 
|-
−
| Busy
+
| Busy  
 
| cg/bt
 
| cg/bt
 
|-
 
|-
−
| Congestion
+
| Congestion  
 
| cg/ct
 
| cg/ct
 
|-
 
|-
−
| Warning
+
| Warning  
 
| cg/wt
 
| cg/wt
 
|-
 
|-
−
| rowspan="12" valign="top" | MF tone generation
+
| valign="top" rowspan="12" | MF tone generation  
−
| 0
+
| 0  
 
| mfg/mf0
 
| mfg/mf0
 
|-
 
|-
−
| 1
+
| 1  
 
| mfg/mf1
 
| mfg/mf1
 
|-
 
|-
−
| 2
+
| 2  
 
| mfg/mf2
 
| mfg/mf2
 
|-
 
|-
−
| 3
+
| 3  
 
| mfg/mf3
 
| mfg/mf3
 
|-
 
|-
−
| 4
+
| 4  
 
| mfg/mf4
 
| mfg/mf4
 
|-
 
|-
−
| 5
+
| 5  
 
| mfg/mf5
 
| mfg/mf5
 
|-
 
|-
−
| 6
+
| 6  
 
| mfg/mf6
 
| mfg/mf6
 
|-
 
|-
−
| 7
+
| 7  
 
| mfg/mf7
 
| mfg/mf7
 
|-
 
|-
−
| 8
+
| 8  
 
| mfg/mf8
 
| mfg/mf8
 
|-
 
|-
−
| 9
+
| 9  
 
| mfg/mf9
 
| mfg/mf9
 
|-
 
|-
−
| KP
+
| KP  
 
| mfg/mfa
 
| mfg/mfa
 
|-
 
|-
−
| ST
+
| ST  
 
| mfg/mfe
 
| mfg/mfe
 
|-
 
|-
−
| rowspan="2" valign="top" | Telcofax
+
| valign="top" rowspan="2" | Telcofax  
−
| CNG
+
| CNG  
 
| telcofax/cng
 
| telcofax/cng
 
|-
 
|-
−
| g164
+
| g164  
 
| telcofax/g164
 
| telcofax/g164
 
|}
 
|}
−
| valign="top" |
+
 
 +
| valign="top" |  
 
{| cellspacing="1" cellpadding="2" border="1"
 
{| cellspacing="1" cellpadding="2" border="1"
−
|+ '''Tone detection'''
+
|+ '''Tone detection'''  
 
|-
 
|-
−
! Package
+
! Package  
−
! Signal
+
! Signal  
 
! String
 
! String
 
|-
 
|-
−
| rowspan="16" valign="top" | Basic DTMF detection
+
| valign="top" rowspan="16" | Basic DTMF detection  
−
| 0
+
| 0  
 
| dd/d0
 
| dd/d0
 
|-
 
|-
−
| 1
+
| 1  
 
| dd/d1
 
| dd/d1
 
|-
 
|-
−
| 2
+
| 2  
 
| dd/d2
 
| dd/d2
 
|-
 
|-
−
| 3
+
| 3  
 
| dd/d3
 
| dd/d3
 
|-
 
|-
−
| 4
+
| 4  
 
| dd/d4
 
| dd/d4
 
|-
 
|-
−
| 5
+
| 5  
 
| dd/d5
 
| dd/d5
 
|-
 
|-
−
| 6
+
| 6  
 
| dd/d6
 
| dd/d6
 
|-
 
|-
−
| 7
+
| 7  
 
| dd/d7
 
| dd/d7
 
|-
 
|-
−
| 8
+
| 8  
 
| dd/d8
 
| dd/d8
 
|-
 
|-
−
| 9
+
| 9  
 
| dd/d9
 
| dd/d9
 
|-
 
|-
−
| *
+
| *  
 
| dd/ds
 
| dd/ds
 
|-
 
|-
−
| #
+
| #  
 
| dd/do
 
| dd/do
 
|-
 
|-
−
| A
+
| A  
 
| dd/da
 
| dd/da
 
|-
 
|-
−
| B
+
| B  
 
| dd/db
 
| dd/db
 
|-
 
|-
−
| C
+
| C  
 
| dd/dc
 
| dd/dc
 
|-
 
|-
−
| D
+
| D  
 
| dd/dd
 
| dd/dd
 
|-
 
|-
−
| rowspan="12" valign="top" | MF tone generation
+
| valign="top" rowspan="12" | MF tone generation  
−
| 0
+
| 0  
 
| mfd/mf0
 
| mfd/mf0
 
|-
 
|-
−
| 1
+
| 1  
 
| mfd/mf1
 
| mfd/mf1
 
|-
 
|-
−
| 2
+
| 2  
 
| mfd/mf2
 
| mfd/mf2
 
|-
 
|-
−
| 3
+
| 3  
 
| mfd/mf3
 
| mfd/mf3
 
|-
 
|-
−
| 4
+
| 4  
 
| mfd/mf4
 
| mfd/mf4
 
|-
 
|-
−
| 5
+
| 5  
 
| mfd/mf5
 
| mfd/mf5
 
|-
 
|-
−
| 6
+
| 6  
 
| mfd/mf6
 
| mfd/mf6
 
|-
 
|-
−
| 7
+
| 7  
 
| mfd/mf7
 
| mfd/mf7
 
|-
 
|-
−
| 8
+
| 8  
 
| mfd/mf8
 
| mfd/mf8
 
|-
 
|-
−
| 9
+
| 9  
 
| mfd/mf9
 
| mfd/mf9
 
|-
 
|-
−
| KP
+
| KP  
 
| mfd/mfa
 
| mfd/mfa
 
|-
 
|-
−
| ST
+
| ST  
 
| mfd/mfe
 
| mfd/mfe
 
|-
 
|-
−
| rowspan="3" valign="top" | Telcofax
+
| valign="top" rowspan="3" | Telcofax  
−
| CNG
+
| CNG  
 
| telcofax/cng
 
| telcofax/cng
 
|-
 
|-
−
| g164
+
| g164  
 
| telcofax/g164
 
| telcofax/g164
 
|-
 
|-
−
| g165
+
| g165  
 
| telcofax/g165
 
| telcofax/g165
 
|}
 
|}
 +
 
|}
 
|}
  

Revision as of 06:46, 10 May 2011

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
Bangladesh
 ((#425,1000),(#0,4000))*0
 ((#450,200),(#0,300),(#450,700),(#0,800))*0
((#425,250),(#0,250))*0
((#450,200),(#0,20),(#450,200),(#0,140))*0
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
United States of America ((((#440)+(#480)),2000),(#0,4000))*0 ((((#480)+(#620)),500),(#0,500))*0 ((((#480)+(#620)),250),(#0,250))*0 ((#1400),500)
United Kingdom ((((#400)+(#450)),400),(#0,200),(((#400)+(#450)),400),(#0,2000))*0 ((#400,375),(#0,375))*0 ((#400,400),(#0,350),(#400,225),(#0,525))*0 unused
The Moon... ((#262,2000),(#391,2000),(#523,4000),(((#659)+(#523)),250),(((#622)+(#523)),3750),(#262,400),(#196,400),(#262,400),(#196,400),(#262,400),(#196,400),(#262,400),(#196,400),(#262,420),(#196,460),(#262,540),(#196,620))*0

Playing and collecting tones

To learn how to play these tones using the Call Leg API, refer to the Playing and Collecting Tones section.

For example, to play the ringing tone, one could pass either directly ((((#440)+(#480)),2000),(#0,4000))*0 or cg/rt to the AddToneString() function. The cg/rt string refers to the current Tone Profile Params ringing tone setting from the Web Portal.

Available tones

Below is a comprehensive list of all the tone strings that can be passed to the AddToneString() function.

Tone generation
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
Tone detection
Package Signal String
Basic DTMF detection 0 dd/d0
1 dd/d1
2 dd/d2
3 dd/d3
4 dd/d4
5 dd/d5
6 dd/d6
7 dd/d7
8 dd/d8
9 dd/d9
* dd/ds
# dd/do
A dd/da
B dd/db
C dd/dc
D dd/dd
MF tone generation 0 mfd/mf0
1 mfd/mf1
2 mfd/mf2
3 mfd/mf3
4 mfd/mf4
5 mfd/mf5
6 mfd/mf6
7 mfd/mf7
8 mfd/mf8
9 mfd/mf9
KP mfd/mfa
ST mfd/mfe
Telcofax CNG telcofax/cng
g164 telcofax/g164
g165 telcofax/g165

References

Retrieved from "https://docs.telcobridges.com/mediawiki/index.php?title=Tone_definitions&oldid=9035"
Personal tools