Thanks for your feedback.
Feedback?You can provide users with a choice of background images (or wallpaper) for the Cisco Wireless Phone 9821 LCD screen. Users can select a background image by accessing the Settings
app.
The image choices that users see come from PNG images and an XML file (called
List.xml) that are stored on the TFTP server that the phone uses. 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.
All file names are case-sensitive. If you use list.xml for the file
name, the phone will not apply your changes.
You can disable the option for users to select a background image. Follow these steps:
- In Cisco Unified Communications Manager Administration, select .
-
In the Common Phone Profile Information area, uncheck the Enable End User Access to Phone Background Image Setting check box.
When this check box is unchecked, users have no access to the appearance settings.
- Select Save.
- Select Apply Config.
Set up a custom background image
| 1 |
Create two PNG files for each image (a full-size version and a thumbnail version). Ensure the PNG files comply with the format guidelines that are listed in Custom background file formats. |
| 2 |
Upload the new PNG files that you created to the following subdirectory on the TFTP server for the Cisco Unified CM: Desktops/WP-9821 The file name and subdirectory parameters are case-sensitive. Be sure to use the forward slash / when you specify the subdirectory path. For more information about how to upload the files, see Upload Backgrounds to TFTP Server. If the folder does not exist, the folder gets created and the files get uploaded to the folder. |
| 3 |
Copy the customized images and files to the other TFTP servers that the phone may contact to obtain these files. |
| 4 |
Use a text editor to edit the |
| 5 |
Save your modifications and close the When upgrading Cisco Unified Communications Manager (Unified CM), the default |
| 6 |
Restart the TFTP service to cache the new |
Custom background file formats
The List.xml file defines an XML object that contains a list
of background images. It can include up to 10 background images, which appear consecutively
in the Custom Wallpaper menu on the phone. This file is stored in the
following subdirectory on the TFTP server:
Desktops/WP-9821
If you are manually creating the directory structure and the
List.xml file, ensure that the directories and files can be
accessed by the user\CCMService, which is used by the TFTP service.
For more information, see the documentation for your particular Cisco Unified Communications Manager release.
The following example shows a List.xml file that defines two
images.
<CiscoIPPhoneImageList version="1.5">
<ImageItem Name="Lake" Image="TFTP:Desktops/WP-9821/wallpaper-lake.png" Thumbnail="TFTP:Desktops/WP-9821/thumbnail-lake.png" Theme="dark"/>
<ImageItem Name="Moon" Image="TFTP:Desktops/WP-9821/wallpaper-moon.png" Thumbnail="TFTP:Desktops/WP-9821/thumbnail-moon.png" Theme="dark"/>
</CiscoIPPhoneImageList>The version attribute specifies the version of the
List.xml file. Each time you update the List.xml
file, you must increment the version number. For example, if the current version is 1.5,
update it to 1.6 after making changes. If you do not increment the version, your updates
will not take effect.
For each image, the List.xml file contains one element type, called
ImageItem. It includes these two attributes:
-
Image—Uniform resource identifier (URI) that specifies where the phone obtains the thumbnail image that appears on the Custom Wallpaper menu on a phone.
-
URL—URI that specifies where the phone obtains the full-size 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.
Each background image requires two PNG files:
-
Full size image—Version that appears on the on the phone.
-
Thumbnail image—Version that displays on the Background Images screen from which users can select an image. Must be 25% of the size of the full-size image.
The PNG files for background images must meet the following requirements for proper display on the phone:
-
Full size image—240 pixels (width) x 320 pixels (height).
-
Thumbnail image—117 pixels (width) x 117 pixels (height).
If you are using a graphics program that supports a posterize feature for grayscale, set the number of tonal levels per channel to 16, and the image posterizes to 16 shades of grayscale.
The filenames for background images must meet the following requirements:
- For phone wallpaper images, use
wallpaper-xxx.png. Replacexxxwith your desired name. For example,wallpaper-lake.png. - For phone wallpaper thumbnail images, use
thumbnail-xxx.png. Replacexxxwith your desired name. For example,thumbnail-lake.png. - For the
xxxin the filename, do not use special characters. Only use letters and numbers.
