Configuring Regional Parameters and Supplementary Services
Advanced Scripting for Cadences, Call Progress Tones, and Ring Tones
Cisco Small Business SPA300 Series, SPA500 Series, and WIP310 IP Phone Administration Guide
A RingScript is a mini-script that describes a ring tone. The syntax follows:
n=ring-tone-name;w=waveform-id-or-path;c=cadence-id;b=break-
time;t=total-time
ring-tone-name is a name to identify this ring tone specification. This name
will appear on the Ring Tone menu of the phone. The same name can be
used in a SIP Alert-Info header in an inbound INVITE request to tell the
phone to play the corresponding ring tone specification. Because of this,
the name should contain characters allowed in a URL only.
Waveform-id is the index of the desired waveform to use in this ring tone
specification. There are 4 built-in waveforms:
-
1 = A classic phone with mechanical bell
-
2 = Typical phone ring
-
3 = A classic ring tone
-
4 = A wide-band frequency sweep signal
This field can also be a network path (url) to download a ring tone data file from a
server on-the-fly. In this case, the syntax of the field is
w=[tftp://]hostname[:port]/path.
cadence-id is the index of the desired cadence to play the given waveform.
8 cadences (1–8) as defined in <Cadence 1> through <Cadence 8>.
Cadence-id can be 0 If w=3,4, or an url. Setting c=0 implies the on-time is
the natural length of the ring tone file.
break-time specifies the number of seconds to break between two bursts
of ring tone, such as b=2.5
total-time specifies the total number of seconds to play the ring tone before
it times out
Example 1: SIT Tone
n=Classic-1,w=3;c=1
n=Simple-1,w=2;c=1
7
178