Surf Wiki
Save to docs
general/telephony-signals

From Surf Wiki (app.surf) — the open knowledge base

ToneScript

ToneScript is a description syntax for the characteristics of call-progress tones.

A call progress tone is a pattern of audible tones played to the caller in a telephone call, conveying the status of the call. ToneScript describes the pattern of frequency, cadence, and level of the signal. Many Internet telephony devices support configuration options for users to customize the tones, but standard patterns are provided for various telephone administrations. ToneScript is used in Sipura, Linksys and Cisco family of IP telephony products.

Format

  • A ToneScript syntax may have at most 120 characters.
  • A calling tone may use up to 6 frequency components n_k where 1
  • A cadence section Z_i indicates its Duration D_i followed by up to 6 subsections ZZ_{i,j} in parentheses. A subsection consists of an ON duration (* for always on), an OFF duration and the list of frequency components f_{i,j} used in that subsection. :f_{i,j} := n_1[+n_2[+n_3[+n_4[+n_5[+n_6]]]]] :ZZ_{i,j} := on_{i,j}/off_{i,j}/f_{i,j} :Z_i := D_i([ZZ_{i,1} [,ZZ_{i,2} [,ZZ_{i,3} [,ZZ_{i,4} [,ZZ_{i,5} [,ZZ_{i,6}]]]]])
  • A FreqScript is a sequence of frequencies F_i in hertz and their corresponding levels L_i in dBm
  • :FreqScript:=F_1@L_1[,F_2@L_2]
  • A Tone Script has a frequency specification and one or two cadence sections. :ToneScript:=FreqScript;Z_1[;Z_2]

Examples

  • 350@-19,440@-19;10(*/0/1+2)
  • : Contains 2 frequency components
  • :: Frequency component 1 is 350 Hz at -19 dBm
  • :: Frequency component 2 is 440 Hz at -19 dBm
  • : There is 1 Cadence Section
  • :: In this section, The duration is 10 seconds and the tone has only 1 subsections
  • ::: In the only subsection the tone is always on, off for 0 seconds, and composed of both the Frequency components 1 and 2 (350 Hz and 440 Hz)
  • 350@-19,440@-19;2(.2/.2/1+2);10(*/0/1+2)
  • : Contains 2 frequency components
  • :: Frequency component 1 is 350 Hz at -19 dBm
  • :: Frequency component 2 is 440 Hz at -19 dBm
  • : There are two Cadence Sections
  • :: In the first Cadence Section, The duration is 2 seconds and the tone has only 1 subsections
  • ::: In the only subsection the tone is on for 0.2 seconds, off for 0.2 seconds, and composed of both the Frequency components 1 and 2 (350 Hz and 440 Hz)
  • :: In the second Cadence Section, The duration is 10 seconds and again the tone has only 1 subsections
  • ::: In the only subsection the tone is always on, off for 0 seconds, and composed of both the Frequency components 1 and 2 (350 Hz and 440 Hz)
  • 349@-21,392@-21,440@-21,466@-21,523@-24,540@-24;2.1(.6/0/3,.2/0/2,.7/0/1,.2/0/2,.2/0/3,.3/0/4);30(*/0/5+6)
  • : Christmas theme dialtone (seven notes of ′The First Noel′ then continuous dialtone for 30 seconds)
  • : Contains 6 frequency components
  • :: Frequency components are 349, 392, 440, 466, 523 and 540 Hz (five musical notes) plus a beat frequency tone mix to give a warble dialtone beat thereafter.
  • : There are two Cadence Sections
  • :: In the first Cadence Section, the total duration is 2.1 seconds and the tone has 6 subsections with timing set for music.
  • ::: The tones are turned on and off to give the ′notes′ of the familiar Christmas carol.
  • :: In the second Cadence Section, the duration is 30 seconds. It combines tones 5 and 6 to give the last note and the familiar 17 Hz beat of dialtone.
  • :::
  • 392@-19,440@-19,494@-19,294@-19,457@-19;3.5(.7/0/4,.8/0/1,.6/0/1,.5/0/3,.7/0/2,.2/0/1);30(*/0/2+5)
  • : New Year theme dialtone (four notes of ′Auld Lang Syne′ then continuous dialtone for 30 seconds)
  • : Contains 5 frequency components
  • :: Frequency components are 392, 440, 494, 292 and 457 Hz (four musical notes) plus a beat frequency tone mix to give a warble dialtone beat thereafter.
  • : There are two Cadence Sections
  • :: In the first Cadence Section, the total duration is 3.5 seconds and the tone has 6 subsections with timing set for music.
  • ::: The tones are turned on and off to give the ′notes′ of the familiar New Year's Eve tune.
  • :: In the second Cadence Section, the duration is 30 seconds. It combines tones 4 and 5 to give the last note in the familiar 17 Hz beat of dialtone.
  • :::

North American tones

NameToneScript
Dial tone
Second dial tone
Outside dial tone
Prompt tone
Busy tone
Reorder tone
Howler/off-hook warning tone
Audible ringing
Confirm tone
Special information tone SIT1
Special information tone SIT2
Special information tone SIT3
Special information tone SIT4
MWI dial tone
Call forward dial tone
Holding tone
Conference call tone
Call waiting tone

Australian tones

NameToneScript
Dial tone
Busy tone
Reorder tone
Ringback tone
Confirm tone
MWI dial tone
Cfwd dial tone
Conference tone
Call waiting tone

Ireland tones

NameToneScript
Dial tone (ETSI standard)
Second dial tone
Busy tone (ETSI standard)
Reorder tone (ETSI standard)
Ringback tone (same as UK, NZ etc.)
Special information tone SIT (ETSI standard)
MWI dial tone
Call forward dial tone
Call waiting tone
Confirm tone / routing tone
Prompt tone

(ETSI standard) is indicated where tones are in compliance with European Telecommunications Standards Institute recommendations.

References

Wikipedia Source

This article was imported from Wikipedia and is available under the Creative Commons Attribution-ShareAlike 4.0 License. Content has been adapted to SurfDoc format. Original contributors can be found on the article history page.

telephony-signals
Want to explore this topic further?

Ask Mako anything about ToneScript — get instant answers, deeper analysis, and related topics.

Research with Mako

Free with your Surf account

Content sourced from Wikipedia, available under CC BY-SA 4.0.

This content may have been generated or modified by AI. CloudSurf Software LLC is not responsible for the accuracy, completeness, or reliability of AI-generated content. Always verify important information from primary sources.

Report