Downloads |
 Feedback
|
Table Of Contents
Customizing the Cisco Unified IP Phone
Customizing and Modifying Configuration Files
Ringlist.xml File Format Requirements
PCM File Requirements for Custom Ring Types
Configuring a Custom Phone Ring
Creating Custom Background Images
List.xml File Format Requirements
PNG File Requirements for Custom Background Images
Configuring a Custom Background Image
Configuring Wideband Headset Codec
Automatically Disabling the Cisco Unified IP Phone Touchscreen
Customizing the Cisco Unified IP Phone
This chapter explains how you customize configuration files, phone ring sounds, background images, and the idle display at your site. Ring sounds play when the phone receives a call. Background images appear on the phone's LCD screen. The idle display appears on the LCD screen when the phone has not been used for a designated period.
This chapter includes these topics:
•
Customizing and Modifying Configuration Files
•
•
•
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 IPT Platform Administration, from the TFTP Server File Upload page. Refer to Cisco IP Telephony Platform Administration Guide for information about how to upload files to the TFTP folder on a Cisco Unified CallManager server.
You can obtain a copy of the Ringlist.xml and List.xml files from the system using the following admin command-line interface (CLI) "file" commands:
•
–
–
–
–
–
–
–
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 CallManager 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 CallManager server.
For more information, see the "Cisco TFTP" chapter in Cisco Unified CallManager System Guide, Release 5.0(1) and the "Software Upgrades" chapter in Cisco IP Telephony Platform 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 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 CallManager contains this file.
The CiscoIPPhoneRinglist XML object uses the following simple tag set to describe the information:
<CiscoIPPhoneRingList><Ring><DisplayName/><FileName/></Ring></CiscoIPPhoneRingList>The following characteristics apply to the definition names. You must include the required DisplayName and FileName for each phone ring type.
•
•
Note
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>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:
•
•
•
•
•
•
•
•
•
Configuring a Custom Phone Ring
To create custom phone rings for the Cisco Unified IP Phone 7970 Series, follow these steps:
Procedure
Step 1
Step 2
Step 3
Step 4
Step 5
Creating Custom Background Images
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.
The following sections describe how you can customize the background images that are available at your site by creating your own PNG files and editing the List.xml file:
•
•
•
List.xml File Format Requirements
The List.xml file defines an XML object that contains a list of background images. The List.xml file is stored in the following folder on the TFTP server:
The List.xml file is stored in the TFTP server.
For more information, see the "Cisco TFTP" chapter in Cisco Unified CallManager System Guide, Release 5.0(1) and the "Software Upgrades" chapter in Cisco IP Telephony Platform Administration Guide.
The List.xml file can include up to 50 background images. The images are in the order that they appear in the Background Images menu on the phone. For each image, the List.xml file contains one element type, called ImageItem. The ImageItem element includes these two attributes:
•
•
The following example shows a List.xml file that defines two images. The required Image and URL attributes must be included for each image. The TFTP URI that is shown in the example is the only supported method for linking to full size and thumbnail images. HTTP URL support is not provided.
List.xml Example
<CiscoIPPhoneImageList><ImageItem Image="TFTP:Desktops/320x212x12/TN-Fountain.png" URL="TFTP:Desktops/320x212x12/Fountain.png"/><ImageItem Image="TFTP:Desktops/320x212x12/TN-FullMoon.png" URL="TFTP:Desktops/320x212x12/FullMoon.png"/></CiscoIPPhoneImageList>The Cisco Unified IP Phone firmware includes a default background image. This image is not defined in the List.xml file. The default image is always the first image that appears in the Background Images menu on the phone.
PNG File Requirements for Custom Background Images
Each background image requires two PNG files:
•
•
Tip
The PNG files for background images must meet the following requirements for proper display on the Cisco Unified IP Phone:
•
•
•
Tip
Configuring a Custom Background Image
To create custom background images for the Cisco Unified IP Phone, follow these steps:
Procedure
Step 1
Step 2
Note
Step 3
Step 4
Note
Step 5
Configuring Wideband Headset Codec
Users can configure a setting called Wideband Headset in the Audio Preferences menu on the phone (choose
> User Preferences > Audio Preferences> Wideband Headset). This setting is Disabled by default, and should be enabled only if the user's headset supports wideband.
If Cisco Unified CallManager has been configured to use G.722 (G.722 is enabled by default for Cisco Unified IP Phone Models 7941G, 7941G-GE, 7961G, 7961G-GE, 7970G, and 7971G-GE; other phone models may not support it), and the far endpoint also supports G.722, the call will be connected using the G.722 codec in place of G.711. This occurs regardless of whether the user has enabled a wideband headset, but if the headset is enabled, the headset user may notice greater audio sensitivity during the call. Greater sensitivity means improved audio clarity but also means that more background noise can be heard by the far endpoint—noise such as rustling papers or nearby conversations. Even without a wideband headset, some users may prefer the additional sensitivity of G.722; conversely, some users may be distracted by the additional sensitivity of G.722.
Two parameters in Cisco Unified CallManager Administration affect whether wideband is supported for this Cisco Unified CallManager server and/or a specific phone:
•
•
Configuring the Idle Display
You can specify an idle display that appears on the phone's LCD screen. The idle display is an XML service that the phone invokes when the phone has been idle (not in use) for a designated period and no feature menu is open.
XML services that can be used as idle displays include company logos, product pictures, and stock quotes.
Configuring the idle display consists of these general steps.
1.
2.
For detailed instructions about creating and displaying the idle display, refer to Creating Idle URL Graphics on Cisco Unified IP Phone at this URL:
http://www.cisco.com/warp/public/788/AVVID/idle-url.html
In addition, you can refer to Cisco Unified CallManager Administration Guide or to Cisco Unified CallManager Bulk Administration Guide for the following information:
•
–
–
•
–
–
From a phone, you can see settings for the idle display XML service URL and the length of time that the phone is not used before this service is invoked. To see these settings, choose Settings > Device Configuration and scroll to the Idle URL and the Idle URL Time parameters.
Automatically Disabling the Cisco Unified IP Phone Touchscreen
To conserve power and ensure the longevity of the LCD screen on the phone, you can set the LCD to turn off when it is not needed.
You can configure settings in Cisco Unified CallManager Administration to turn off the display at a designated time on some days and all day on other days. For example, you may choose to turn off the display after business hours on weekdays and all day on Saturdays and Sundays.
When the display is off, the LCD screen is dark and disabled, and the Display button lights. You can take any of these actions to turn on the display any time it is off:
•
If you press a button other than the Display button, the phone will take the action designated by that button in addition to turning on the display.
•
•
When you turn the display on, it remains on until the phone has remained idle for a designated length of time, then it turns off automatically.
Note
Table 6-1 explains the Cisco Unified CallManager Administration fields that control when the display turns on and off. You configure these fields in Cisco Unified CallManager Administration in the Product Specific Configuration page. (You access this page by choosing Device > Phone from Cisco Unified CallManager Administration.)
You can view the display settings for a phone from the Power Save Configuration menu on the phone. For more information, see the "Power Save Configuration Menu" section on page 4-26.
