Linksys SPA 900 IP Phone User Manual


 
3-19
Linksys IP Phone Administrator Guide
Firmware Version 5.1
Chapter 3 Managing Linksys IP Phones
Configuring the Web Service
RingScript – A script that describes a ring tone.
Syntax: 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 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