From SIPfoundry sipXecs IP PBX, The Open Source SIP PBX for Linux - Calivia

Contents 1 How to change the phone's home screen display (phone top UI) 1.1 Define the home screen title 1.2 Define home screen image (logo) 1.3 Define the splash sound when the phone boots 1.4 Setting sipXphone window preferences

How to change the phone's home screen display (phone top UI)

You can customize the appearance of sipXphone�s home screen by:

• Changing the data that displays in the title bar
• Presenting a corporate logo or other graphic image

You can also control whether or not sipXphone will play a distinctive audio file or �splash� sound each time it starts. In addition users can set a phone top preference to control window behavior for receiving a new call.

Define the home screen title

PHONESET_HOME_SCREEN_TITLE

You use this parameter to customize the information that displays in the title bar of a phone's home screen. By default, phones display the time and date, then, after 5 seconds, change to display the phone's SIP URL. This default is expressed as the following value for the PHONESET_HOME_SCREEN_TITLE parameter:

{h:mm a MM/dd/yy} \n {displayname}<{sipurl}>

The following can be specified as part of this value string:

1. A simple text string.
2. One or more of the options that follow.

Note: These options use data from the SIP URL that is designated as the USER_DEFAULT_OUTBOUND_LINE.

	Option	Description
	{displayname} {hostname} {sipurl} {username} \n	The display name from the SIP URL. The domain name of the host in the SIP URL. The phone's SIP URL in the format <resource ID>@<host>. The resource ID from the phone's SIP URL. Defines a complete display segment. Each segment displays for 5 seconds, then the next segment displays. There is no limit on the number of segments you can define.

Note: Symbols for dates and times are based on java.text.SimpleDateFormat. Frequently used symbols include:

	Symbol	Meaning & Example
	y M d E h H a m s	year (e.g 2005) month in year (text & number) (e.g. July & 07) day in month (e.g. 24) day in week (e.g. Tuesday) hour in am/pm (1~12) (e.g. 8) hour in day (0~23) (e.g. 19) am/pm marker (e.g. PM) minute in hour (e.g. 30) second in minute (e.g. 55)

Define home screen image (logo)

PHONESET_LOGO_URL

This configuration parameter stores the URL of an image file. If defined, the phone displays the specified image on its home screen. For example:

• Must be in .GIF or .JPG format
• Should be no larger than 24 x 126 pixels

You use the browser-based interface to define a value for this parameter. To define an image for the home screen:

1. Store the image file on a Web server in your network.
2. Set the PHONESET_LOGO_URL parameter on the phone(s) to indicate the URL for that file�s location.

Define the splash sound when the phone boots

PHONESET_SPLASH_SOUND

This configuration parameter determines whether a phone will play a distinctive sound when it starts up.

• When set to ENABLE, the splash sound plays each time the phone starts up.
• When set to DISABLE, the splash sound does not play.

Defaults to ENABLE, which plays the audioSplash.raw file that is delivered with all sipXphones.

Setting sipXphone window preferences

To set the preference for bringing the sipXphone to the top of all other windows when a new call comes in, you use the Prefs application on the phone top. You do not use a browser to change this preference.

Basic configuration steps:

1. On the phone top, press MORE.
2. On the Apps tab press Prefs
3. The list of preferences categories displays.
4. Select the Phone Top Settings preference category and press Adjust. The Phone Top Settings screen displays.
5. Check or clear the check box.
6. Press Ok.
7. Press MORE again to return to the screen where you started.

Tip: You do not define a value for a configuration parameter to control this feature.