Cisco Systems OL-15790-01 User Manual

CHAP T E R

Customizing the Cisco Unified IP Phone

This chapter explains how you customize configuration files, phone ring sounds, background images, and other phone features.

This chapter includes these topics:

• Customizing and Modifying Configuration Files, page 6-1

• Creating Custom Phone Rings, page 6-2

• Creating Custom Background Images, page 6-3

• Configuring Wideband Codec, page 6-6

• Configuring the Idle Display, page 6-7

• Automatically Disabling the Cisco Unified IP Phone Touchscreen, page 6-7

Customizing and Modifying Configuration Files

You can modify configuration files (for example, edit the xml files) and add customized files (for example, custom ring tones, call back tones, phone backgrounds) to the TFTP directory. You can modify files and add customized files to the TFTP directory in Cisco Unified Communications Operating System Administration, from the TFTP Server File Upload window. Refer to Cisco Unified Communications Operating System Administration Guide for information about how to upload files to the TFTP folder on a Cisco Unified Communications Manager server.

You can obtain a copy of the Ringlist.xml and List.xml files from the system by using the following admin command-line interface (CLI) “file” commands:

• admin:file

–

file list*

–

file view*

–

file search*

–

file get*

–

file dump*

–

file tail*

–

file delete*

OL-15790-01

Cisco Unified IP Phone 7975G Administration Guide for Cisco Unified Communications Manager 7.0 (SCCP and SIP)

6-1

Creating Custom Phone Rings

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 directory on each Cisco Unified Communications Manager server.

For more information, see the “Cisco TFTP” chapter in Cisco Unified Communications Manager System

Guide and the “Software Upgrades” chapter in 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, page 6-2

• PCM File Requirements for Custom Ring Types, page 6-3

• Configuring a Custom Phone Ring, page 6-3

Chapter 6 Customizing the Cisco Unified IP Phone

Ringlist.xml File Format Requirements

The Ringlist.xml file defines an XML object that contains a list of phone ring types. This file can include 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 will appear 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:

The following characteristics apply to the definition names. You must include the required DisplayName and FileName for each phone ring type.

• DisplayName defines the name of the custom ring for the associated PCM file that will display on

the Ring Type menu of the Cisco Unified IP Phone.

• FileName specifies the name of the PCM file for the custom ring to associate with DisplayName.

Note The DisplayName and FileName fields must not exceed 25 characters.

This example shows a Ringlist.xml file that defines two phone ring types:

<CiscoIPPhoneRingList> <Ring> <DisplayName>Analog Synth 1</DisplayName> <FileName>Analog1.raw</FileName> </Ring> <Ring> <DisplayName>Analog Synth 2</DisplayName> <FileName>Analog2.raw</FileName> </Ring> </CiscoIPPhoneRingList>

6-2

Cisco Unified IP Phone 7975G Administration Guide for Cisco Unified Communications Manager 7.0 (SCCP and SIP)

OL-15790-01

Chapter 6 Customizing the Cisco Unified IP Phone

PCM File Requirements for Custom Ring Types

The PCM files for the rings must meet the following requirements for proper playback on Cisco Unified IP Phones:

• Raw PCM (no header)

• 8000 samples per second

• 8 bits per sample

• uLaw compression

• Maximum ring size—16080 samples

• Minimum ring size—240 samples

• Number of samples in the ring is evenly divisible by 240.

• Ring starts and ends at the zero crossing.

• To create PCM files for custom phone rings, you can use any standard audio editing package that

supports these file format requirements.

Creating Custom Background Images

Configuring a Custom Phone Ring

To create custom phone rings for the Cisco Unified IP Phone 7975G, follow these steps:

Procedure

Step 1 Create a PCM file for each custom ring (one ring per file). Ensure the PCM files comply with the format

guidelines that are listed in the “PCM File Requirements for Custom Ring Types” section on page 6-3.

Step 2 Place the new PCM files that you created to the Cisco TFTP server for each Cisco Unified

Communications Manager in your cluster. For more information, see the “Software Upgrades” chapter in Cisco Unified Communications Operating System Administration Guide.

Step 3 Use a text editor to edit the Ringlist.xml file. See the “Ringlist.xml File Format Requirements” section

on page 6-2 for information about how to format this file and for a sample Ringlist.xml file.

Step 4 Save your modifications and close the Ringlist.xml file.

Step 5 To cache the new Ringlist.xml file, stop and start the TFTP service by using Cisco Unified

Serviceability or disable and re-enable the Enable Caching of Constant and Bin Files at Startup TFTP service parameter (located in the Advanced Service Parameters).

Creating Custom Background Images

OL-15790-01

You can provide users with a choice of background images for the LCD screen on their phones. Users can select a background image by choosing Settings > User Preferences > Background Images on the phone.

The image choices that users see come from PNG images and an XML file (called List.xml) that are stored on the TFTP server used by the phone. By storing your own PNG files and editing the XML file on the TFTP server, you can designate the background images from which users can choose. In this way, you can provide custom images, such as your company logo.

Cisco Unified IP Phone 7975G Administration Guide for Cisco Unified Communications Manager 7.0 (SCCP and SIP)

6-3

+ 7 hidden pages