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