Tone definitions
From TBwiki
(Difference between revisions)
(Added tone detection strings) |
m (needs revising edit) |
||
| (20 intermediate revisions by 6 users not shown) | |||
| 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 | + | 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 defined in the [[H.248]] Dynamic Tone Definition Package. To learn more about tone description strings, see the [[CAF: Working With Cmc 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 | ||
| + | |- | ||
| + | ! Australia<br> | ||
| + | | ((((#400)+(#450)),400),(#0,200),(((#400)+(#450)),400),(#0,2000))*0 <br> | ||
| + | | ((#425,375),(#0,375))*0<br> | ||
| + | | ((#425,375),(#0,375))*0<br> | ||
| + | | ((#900),500) <br> | ||
| + | |- | ||
| + | ! 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 31: | Line 43: | ||
! France | ! France | ||
| ((#440,1500),(#0,3500))*0 | | ((#440,1500),(#0,3500))*0 | ||
| − | | ((# | + | | ((#440,500),(#0,500))*0 |
| − | | | + | | ((#440,250),(#0,250))*0 |
| ''unused'' | | ''unused'' | ||
|- | |- | ||
| Line 47: | Line 59: | ||
| ''unused'' | | ''unused'' | ||
|- | |- | ||
| − | ! | + | ! Netherlands<br> |
| − | | ((#425, | + | | ((#425,1000),(#0,4000))*0 <br> |
| − | | ((#425, | + | | ((#425,500),(#0,500))*0 <br> |
| − | | ((#425, | + | | ((#425,250),(#0,250))*0 <br> |
| − | | | + | | ''unused''<br> |
|- | |- | ||
| − | ! | + | ! North 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 71: | ||
| ((#1400),500) | | ((#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)+(#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),(# | + | | ((#400,400),(#0,350),(#400,225),(#0,525))*0 |
| ''unused'' | | ''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, pass, either directly the <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. | |
| − | Below is a comprehensive list of all the tone strings that can be passed to the '''AddToneString()''' function. | + | === 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" | | + | |- |
| + | | valign="top" | | ||
{| cellspacing="1" cellpadding="2" border="1" | {| cellspacing="1" cellpadding="2" border="1" | ||
| − | |+ '''Tone generation''' | + | |+ '''Tone generation''' |
|- | |- | ||
| − | ! Package | + | ! Package |
| − | ! Signal | + | ! Signal |
! String | ! String | ||
|- | |- | ||
| − | | | + | | 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 | ||
|- | |- | ||
| − | | | + | | 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 | ||
|- | |- | ||
| − | | | + | | 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 | ||
|- | |- | ||
| − | | | + | | valign="top" rowspan="3" | Telcofax |
| − | | CNG | + | | CNG |
| telcofax/cng | | telcofax/cng | ||
|- | |- | ||
| − | | g164 | + | | g164 |
| telcofax/g164 | | telcofax/g164 | ||
| + | |- | ||
| + | | g165 | ||
| + | | telcofax/g165 | ||
|} | |} | ||
| − | | 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 | ||
|- | |- | ||
| − | | | + | | 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 | ||
|- | |- | ||
| − | | | + | | 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 | ||
|- | |- | ||
| − | | | + | | valign="top" rowspan="7" | Telcofax |
| − | | CNG | + | | CNG |
| telcofax/cng | | telcofax/cng | ||
|- | |- | ||
| − | | g164 | + | | g164 |
| telcofax/g164 | | telcofax/g164 | ||
| + | |- | ||
| + | | g165 | ||
| + | | telcofax/g165 | ||
| + | |- | ||
| + | | ansam | ||
| + | | telcofax/ansam | ||
| + | |- | ||
| + | | phase_rev_ansam | ||
| + | | telcofax/phase_rev_ansam | ||
| + | |- | ||
| + | | v21_flags | ||
| + | | telcofax/v21_flags | ||
| + | |- | ||
| + | | bell_ans | ||
| + | | telcofax/bell_ans | ||
|} | |} | ||
| + | |||
|} | |} | ||
| Line 302: | Line 351: | ||
*[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.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) | *[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) | ||
| − | |||
| − | |||
Latest revision as of 11:56, 1 May 2018
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
Profiles -> Tone Profile Params
The tones are described using a programmable string of characters 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 |
|---|---|---|---|---|
| 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 | ((#440,500),(#0,500))*0 | ((#440,250),(#0,250))*0 | 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 |
| 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, pass, either directly the ((((#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.
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.
|
|
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)
