Home >  User Guide - UPLINX Phone Control Tool > Using Remote Phone Control Tool > Bulk Background Images > How Background Images work with TFTP Servers

  How Background Images work with TFTP Servers

 

 

 

 

 

How Common Phone Profiles work with background images / wallpaper

In CUCM, all phones are assigned to a Common Phone Profile (CPP). The default CPP on CUCM is 'Standard Common Phone Profile', but custom CPPs can be created and assigned to phones. The CPP allows setting many different phone features to a group of phones. There are two (2) settings that affect the image on the phone screen :

1.Checkbox "Enable End User Access to Phone Background Image Setting": Allow phone users to choose a wallpaper (background image) on the phone, from a predefined selection available in the phone's preferences menu. Images that shall appear to be selected by a user must be listed in the file List.xml and also placed in the TFTP folder as defined below. The image must be resized accordingly and also have a thumbnail image to be displayed in the menu to select an image.
 

2.The Background Image setting in the Product Specific Configuration Layout section, where an background image name can be specified.

Above two (2) settings are unfortunately mutually exclusive. If the "Enable End User Access ..." checkbox is checked, the Background Image setting will not apply and must be empty. Equally, to apply a background image across all phones in the CPP, the "Enable User ..." checkbox must be unchecked. So, if the user is allowed to choose a wallpaper image, the CPP will not assign the image specified in the "Background Image" setting.

Common Phone Profile (CPP) in the CUCM configuration does not allow to have several user's selectable Wallpaper images (phone background) in List.xml and also a default image (like a corporate logo) at the same time. These 2 settings are mutually exclusive.

The UPLINX Phone Control Tool wizard will deploy a default image (like a corporate logo) shown on all phones and several user's selectable Wallpaper images (phone background) in two (2) steps, though if you add new phones to this CPP later on, the default image (like a corporate logo)  will not automatically show and you must run the Bulk Background Image wizard again for the new phones.

Usage of the TFTP Server

Wallpaper images (phone backgrounds) are stored and downloaded by phones (based on phone model and Common Phone Profile (CPP) from the TFTP servers where the phone is registered. All files reside in the CUCM folder /Desktops/<TFTP folder name>/.  The TFTP folder name is defined per phone model by resolution and color depth and given in the table below.

You can upload images in the "Cisco Unified OS Administration" web page of CUCM, in the menu "Software Upgrades", then "TFTP File Management". The direct link is https://<CUCM name or IP>/cmplatform/tftpFindList.do. 

Image files must be resized and placed as PNG format in the folder per phone model listed below. The Bulk Background Wizard of the UPLINX Phone Control Tool will this for you but you can of course manually overwrite these image files to better crop and optimize images. For best results (for company logos etc.), you may want to resize the images to the exact screen size of each phone model with an image tool, so that automatic resizing and rendering is not required. 

Model

Resolution

TFTP Folder Name

7941/7942/7961/7962

320x196x4

Desktops/320x196x4

7945/7965

320x212x16

Desktops/320x212x16

7970, 7971

320x212x12

Desktops/320x216x12

7975

320x216x16

Desktops/320x216x16

8821

240x320x24

Desktops/240x320x24

89xx/99xx

640x480x24

Desktops/640x480x24

88xx

800x480x24

Desktops/800x480x24

Any image name specified in the setting "Background Image" of the Common Phone Profile needs to be uploaded to these directories, in all required resolutions.

The wallpaper selection on the phones also requires the available images to have been uploaded in all required directories/resolutions, including a correctly sized thumbnail file for each one.

The creation of a List.xml file that enumerates the image files for each directory/resolution to be included in the phone wallpaper menu. A sample of List.xml is below.

List.xml example

The content of the file List.xml must look similar to the following sample and the XML list must contain the images that you want to show to the user.

This file needs to be uploaded with filename "List.xml" to each TFTP Folder (folder names are listed above) for all phone models that are in use. The Bulk Background Wizard of the UPLINX Phone Control Tool will create this file for you when you choose the deployment option "Deployment Scenario B: Deploy multiple images".

 

<CiscoIPPhoneImageList> 
<ImageItem Image="TFTP:Desktops/320x212x16/tnlogo_back.png" URL="TFTP:Desktops/320x212x16/logo_back.png"/> 
<ImageItem Image="TFTP:Desktops/320x212x16/tntg_world.png" URL="TFTP:Desktops/320x212x16/tg_world.png"/> 
<ImageItem Image="TFTP:Desktops/320x212x16/tn7.png" URL="TFTP:Desktops/320x212x16/7.png"/>  
<ImageItem Image="TFTP:Desktops/320x212x16/tn10.png" URL="TFTP:Desktops/320x212x16/10.png"/>  
<ImageItem Image="TFTP:Desktops/320x212x16/tn11.png" URL="TFTP:Desktops/320x212x16/11.png"/> 
<ImageItem Image="TFTP:Desktops/320x212x16/tn13.png" URL="TFTP:Desktops/320x212x16/13.png"/> 
<ImageItem Image="TFTP:Desktops/320x212x16/tn14.png" URL="TFTP:Desktops/320x212x16/14.png"/> 
<ImageItem Image="TFTP:Desktops/320x212x16/tn15.png" URL="TFTP:Desktops/320x212x16/15.png"/> 
<ImageItem Image="TFTP:Desktops/320x212x16/tn16.png" URL="TFTP:Desktops/320x212x16/16.png"/> 
<ImageItem Image="TFTP:Desktops/320x212x16/tn17.png" URL="TFTP:Desktops/320x212x16/17.png"/> 
<ImageItem Image="TFTP:Desktops/320x212x16/tn18.png" URL="TFTP:Desktops/320x212x16/18.png"/> 
<ImageItem Image="TFTP:Desktops/320x212x16/tn42.png" URL="TFTP:Desktops/320x212x16/42.png"/>
</CiscoIPPhoneImageList>

 

 

 

 

 

 

Copyright © 2024 UPLINX - Last updated 28 Jan 2024