Tone definitions

2012-04-12T18:02:37Z

Marc-Andre Harvey: updated dead link

=== 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
<pre>Profiles -> Tone Profile Params </pre>
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 ===

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"
|-
! 
! Ring
! Busy
! Congestion
! Warning
|-
! Australia 
| ((((#400)+(#450)),400),(#0,200),(((#400)+(#450)),400),(#0,2000))*0 
| ((#425,375),(#0,375))*0 
| ((#425,375),(#0,375))*0 
| ((#900),500) 
|-
! 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''
|-
! Netherlands 
| ((#425,1000),(#0,4000))*0 
| ((#425,500),(#0,500))*0 
| ((#425,250),(#0,250))*0 
| ''unused'' 
|-
! North America
| ((((#440)+(#480)),2000),(#0,4000))*0
| ((((#480)+(#620)),500),(#0,500))*0
| ((((#480)+(#620)),250),(#0,250))*0
| ((#1400),500)
|-
! 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 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''
|}

{| 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
|}

=== 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_Cmc_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.

=== Tone volume ===

It is possible to change the ring tone volume. According to the syntax, you need to specify the desired volume after the tone duration. Here is an example:
((((#440)+(#480)),2000,'''-15'''),(#0,4000))*0

The possible values are: -19, -15, -10, -5 and 0 dB.

=== Available tones ===

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

{|
|-
| valign="top" |
{| cellspacing="1" cellpadding="2" border="1"
|+ '''Tone generation'''
|-
! Package
! Signal
! String
|-
| valign="top" rowspan="16" | 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
|-
| valign="top" rowspan="4" | Call Progress generation
| Ring
| cg/rt
|-
| Busy
| cg/bt
|-
| Congestion
| cg/ct
|-
| Warning
| cg/wt
|-
| valign="top" rowspan="12" | 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
|-
| valign="top" rowspan="2" | Telcofax
| CNG
| telcofax/cng
|-
| g164
| telcofax/g164
|}

| valign="top" |
{| cellspacing="1" cellpadding="2" border="1"
|+ '''Tone detection'''
|-
! Package
! Signal
! String
|-
| valign="top" rowspan="16" | 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
|-
| valign="top" rowspan="12" | 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
|-
| valign="top" rowspan="3" | Telcofax
| CNG
| telcofax/cng
|-
| g164
| telcofax/g164
|-
| g165
| telcofax/g165
|}

|}

=== References ===

*[http://www.itu.int/publ/T-SP-E.180-2003/en Various tones used in national networks]
*[http://www.itu.int/rec/T-REC-H.248.6-200011-I/en H.248 Gateway Control Protocol Dynamic Tone Definition Package]
*[http://www.itu.int/rec/T-REC-H.248.1-200509-I/en H.248 Gateway Control Protocol] section E.7 (Call Progress Tone Definitions Package)

[[Category:Needs_revising]]

TBwiki - User contributions [en]

Tone definitions