ToneScript is a mini script used to describe the characteristics of Call progress tones

Call-progress tone

In telephony, call progress tones are audible tones sent from the public switched telephone network central office or a private branch exchange to calling parties to indicate the status of phone calls....

Description

A call progress tone is a pattern of tones made audible to the caller, conveying some status about the call. Despite its name, a call-progress tone could be a sequence of tones, that may be repeated or emitted just once. ToneScript is a mini script that describes the pattern of frequency, cadence and level of tones in call progress tones. Many internet telephony devices using more sophisticated operating systems permit users to customize the tones. Customarily the devices are preset with the standard tones defined and regulated by standards bodies in a given region. ToneScript is used in Sipura

Sipura Technology

Sipura Technology, Inc. was a Voice over IP startup company based in San Jose, California founded in 2003 with its siblings VideoCore and Komodo Technology, Inc....

, Linksys

Linksys

Linksys by Cisco, commonly known as Linksys, is a brand of home and small office networking products now produced by Cisco Systems, though once a separate company founded in 1995 before being acquired by Cisco in 2003...

 and Cisco

Cisco Systems

Cisco Systems, Inc. is an American multinational corporation headquartered in San Jose, California, United States, that designs and sells consumer electronics, networking, voice, and communications technology and services. Cisco has more than 70,000 employees and annual revenue of US$...

 family of IP telephony products.

Format

• ToneScript may have at most 120 characters.
• A calling tone may use up to 6 frequency components where
• A cadence section is indicated its Duration followed by up to 6 subsections in parenthesis. A subsection consists of an ON duration (* for always on), an OFF duration and the list of frequency components used in that subsection.
• A FreqScript is a sequence of frequencies in hertz
  Hertz
  The hertz is the SI unit of frequency defined as the number of cycles per second of a periodic phenomenon. One of its most common uses is the description of the sine wave, particularly those used in radio and audio applications....
  
   and their corresponding levels in dBm
  DBm
  dBm is an abbreviation for the power ratio in decibels of the measured power referenced to one milliwatt . It is used in radio, microwave and fiber optic networks as a convenient measure of absolute power because of its capability to express both very large and very small values in a short form...
  
  @@
• A Tone Script has a frequency specification and one or two cadence sections.

Examples

1. 350@-19,440@-19;10(*/0/1+2)

   Contains 2 frequencies 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)

2. 350@-19,440@-19;2(.2/.2/1+2);10(*/0/1+2)

   Contains 2 frequencies 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)

North American tones

No	Name	ToneScript
1	Dial tone Dial tone A dial tone is a telephony signal used to indicate that the telephone exchange is working, has recognized an off-hook, and is ready to accept a call. The tone stops when the first numeral is dialed...	350@-19,440@-19;10(*/0/1+2)
2	Second dial tone	420@-19,520@-19;10(*/0/1+2)
3	Outside dial tone	420@-16;10(*/0/1)
4	Prompt tone	520@-19,620@-19;10(*/0/1+2)
5	Busy tone	480@-19,620@-19;10(.5/.5/1+2)
6	Reorder tone	480@-19,620@-19;10(.25/.25/1+2)
7	Howler/off-hook warning tone	480@-10,620@0;10(.125/.125/1+2)
8	Ringback tone Ringback tone A ringback tone is an audible indication that is heard on the telephone line by the caller while the phone they are calling is being rung. It is normally a repeated tone, designed to assure the calling party that the called party's line is ringing, although the ring-back tone may be out of sync...	440@-19,480@-19;*(2/4/1+2)
9	Comfort tone	600@-16;1(.25/.25/1)
10	Special information tone Special information tone In telephony, a special information tone is an international standard three beep signal indicating a call did not go through and usually precedes a recorded announcement explaining the problem...  SIT1	985@-16,1428@-16,1777@-16;20(.380/0/1,.380/0/2,.380/0/3,0/4/0)
11	Special information tone SIT2	914@-16,1371@-16,1777@-16;20(.274/0/1,.274/0/2,.380/0/3,0/4/0)
12	Special information tone SIT3	914@-16,1371@-16,1777@-16;20(.380/0/1,.380/0/2,.380/0/3,0/4/0)
13	Special information tone SIT4	985@-16,1371@-16,1777@-16;20(.380/0/1,.274/0/2,.380/0/3,0/4/0)
14	MWI Dial Tone	350@-19,440@-19;2(.1/.1/1+2);10(*/0/1+2)
15	Call Forward Dial Tone	350@-19,440@-19;2(.2/.2/1+2);10(*/0/1+2)
16	hold Hold (telephone) In telephony, a call may be placed on hold, in which case the connection is not terminated but no verbal communication is possible until the call is removed from hold by the same or another extension on the key telephone system. Music on hold or On Hold Messaging may be played for the caller while... ing tone	600@-19;*(.1/.1/1,.1/.1/1,.1/9.5/1)
17	Conference call Conference call A conference call is a telephone call in which the calling party wishes to have more than one called party listen in to the audio portion of the call. The conference calls may be designed to allow the called party to participate during the call, or the call may be set up so that the called party... Tone	350@-19;20(.1/.1/1,.1/9.7/1)