Linksys SPA922

Linksys SPA9x2 Phone Administration Guide 66
Advanced Scripting for Cadences, Call Progress Tones, and Ring Tones
Setting Regional Parameters
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.
• Example 3: SIT Tone
• 985@-16,1428@-16,1777@-16;20(.380/0/1,.380/0/2,.380/0/
3,0/4/0)
• Number of Frequencies = 3
• Frequency 1 = 985 Hz at –16 dBm
• Frequency 2 = 1428 Hz at –16 dBm
• Frequency 3 = 1777 Hz at –16 dBm
• Number of Cadence Sections = 1
• Cadence Section 1: Section Length = 20s
• Number of Segments = 4
• Segment 1: On=0.38s, Off=0s, with Frequency 1
• Segment 2: On=0.38s, Off=0s, with Frequency 2
• Segment 3: On=0.38s, Off=0s, with Frequency 3
• Segment 4: On=0s, Off=4s, with no frequency components
• Total Tone Length = 20s