Custom Phone Ring Creation; Ringlist.xml File Format Requirements - Cisco 7975G Software Manual

Custom Phone Ring Creation

Custom Phone Ring Creation
The Cisco Unified IP Phone ships with two default ring types that are implemented in hardware: Chirp1 and
Chirp2. Cisco Unified Communications Manager also provides a default set of additional phone ring sounds
that are implemented in software as pulse code modulation (PCM) files. The PCM files, along with an XML
file (named Ringlist.xml) that describes the ring list options that are available at your site, exist in the TFTP
server on each Cisco Unified Communications Manager server.
For more information, see the "Custom Phone Rings" chapter in the Cisco Unified Communications Manager
Features and Services Guide and the "Software Upgrades" chapter in the Cisco Unified Communications
Operating System Administration Guide.
The following sections describe how you can customize the phone rings that are available at your site by
creating PCM files and editing the Ringlist.xml file:

Ringlist.xml File Format Requirements

The Ringlist.xml file defines an XML object that contains a list of phone ring types. This file includes up to
50 ring types. Each ring type contains a pointer to the PCM file that is used for that ring type and the text that
appears on the Ring Type menu on a Cisco Unified IP Phone for that ring. The Cisco TFTP server for each
Cisco Unified Communications Manager contains this file.
The CiscoIPPhoneRinglist XML object uses the following simple tag set to describe the information:
<CiscoIPPhoneRingList>
</CiscoIPPhoneRingList>
The following characteristics apply to the definition names. You must include the required DisplayName and
FileName for each phone ring type.
• DisplayName specifies the name of the custom ring for the associated PCM file that displays on the
• FileName specifies the name of the PCM file for the custom ring to associate with DisplayName.
The DisplayName and FileName fields must not exceed 25 characters in length.
Note
This example shows a Ringlist.xml file that defines two phone ring types:
<CiscoIPPhoneRingList>
Cisco Unified IP Phone 7975G, 7971G-GE, 7970G, 7965G, and 7945G Administration Guide for Cisco Unified
Communications Manager 9.0 (SCCP and SIP)
166
<Ring>
<DisplayName/>
<FileName/>
</Ring>
Ring Type menu of the Cisco Unified IP Phone.
<Ring>
<DisplayName>Analog Synth 1</DisplayName>
<FileName>Analog1.raw</FileName>
</Ring>
<Ring>
<DisplayName>Analog Synth 2</DisplayName>
<FileName>Analog2.raw</FileName>
Cisco Unified IP Phone Customization