Yealink SIP VP-T49G Instruction Manual

i
i

Table of Contents
i
Table of Contents....................................................................... i
About This Guide ......................................................................iii
Who should use this guide? ........................................................................................iii
Summary of Changes................................................................................................. iv
Changes for Release 80, Guide Version 80.81..................................................... iv
Changes for Release 80, Guide Version 80.80..................................................... iv
Changes for Release 80, Guide Version 80.60..................................................... iv
Changes for Release 80, Guide Version 80.20..................................................... iv
Changes for Release 80, Guide Version 80.6........................................................ v
Changes for Release 80, Guide Version 80.5........................................................ v
Changes for Release 73, Guide Version 73.16...................................................... v
Changes for Release 72, Guide Version 72.60...................................................... v
Changes for Release 72, Guide Version 72.30...................................................... v
Changes for Release 72, Guide Version 72.2....................................................... vi
Changes for Release 72, Guide Version 72.1....................................................... vi
Changes for Release 71, Guide Version 71.165................................................... vi
Changes for Release 71, Guide Version 71.140................................................... vi
Changes for Release 71, Guide Version 71.111................................................... vi
Changes for Release 71, Guide Version 71.110................................................... vi
XML and Yealink IP Phones ...................................................... 1
What is XML? ................................................................................................................ 1
XML Format................................................................................................................... 2
Functionality.................................................................................................................. 3
How does it work?........................................................................................................ 4
Phone initiated application..................................................................................... 4
Server initiated application .................................................................................... 4
XML display control and keys on Yealink IP phones................................................ 5
Yealink IP Phone XML Objects ................................................. 9
XML Object Definitions................................................................................................ 9
TextMenu Object.................................................................................................... 10
TextScreen Object.................................................................................................. 19
InputScreen Object................................................................................................ 25
Directory Object..................................................................................................... 38

XML Browser Developer’s Guide for Yealink IP Phones
ii
Status Object .......................................................................................................... 46
Execute Object ....................................................................................................... 51
Configuration Object ............................................................................................. 56
FormattedTextScreen Object................................................................................ 57
ImageScreen Object ............................................................................................. 65
ImageMenu Object ............................................................................................... 71
Customizable Soft keys ............................................................................................. 78
XML Objects Pushed to the Phone ........................................................................... 81
Some Development Guidelines ............................................................................... 83
Configuring the HTTP Server .................................................. 85
Configuring the Push XML Server .......................................... 87
Yealink IP Phone XML Configurations .................................... 93
Configuring an XML Browser Key ............................................................................ 93
Configuring the Block XML in Calling ...................................................................... 99
Configuring the Push XML Server Address ........................................................... 100
Configuring the XML SIP Notify............................................................................... 102
Configuring the Default Input Method .................................................................. 104
Troubleshooting .....................................................................107
Troubleshooting Tools............................................................................................... 107
Parsing Error Debug Example................................................................................. 108
Appendix ...............................................................................109
Customizing an Image File ..................................................................................... 109

About This Guide
iii
XML browser simply means that the SIP phones’LCD screen display can be managed
by external applications.
This guide shows you how to use XML API to control the LCD screen display of Yealink
IP phones as well as its configuration. The XML API is intended to provide you with
flexibility in developing applications on the phones while tightly integrating into the
phone’s telephony capabilities and functions.
This guide applies to SIP VP-T49G, SIP-T48G, SIP-T46G, SIP-T42G, SIP-T41P, SIP-T40P,
SIP-T29G, SIP-T27P, SIP-T23P/G, SIP-T21(P) E2, SIP-T19(P) E2 and CP860 IP phones running
firmware version 80 or later.
This guide is designed specifically to provide development engineers, system
administrators, or network engineers with information for developing and deploying
customized client services to Yealink IP phones using the XML browser feature.
This guide is not intended for end users and does not provide user-level information on
how to use any specific XML applications.
Before reading this guide, you should be familiar with the following:
Basic text editors, or full IDE-like Eclipse or Microsoft Visual Studio for creating or
writing code.
General application and software development.
Adequate planning, creating, and testing resources needed to produce a fully
deployable web-based application.
Yealink IP phones and provisioning methods.
How to use an XML editor.
The XML-based schema and syntax.

XML Browser Developer’s Guide for Yealink IP Phones
iv
This section describes the changes to this guide for each release and guide version.
Documentations of the newly released CP860 and SIP VP-T49G IP phones have been
added.
Documentations of the newly released SIP-T40P IP phones have been added.
Major updates have occurred to the following sections:
Execute Object on page 51
Documentations of the newly released SIP-T19(P) E2 IP phones have been added.
The following section is new:
Configuring the Default Input Method on page 104
Major updates have occurred to the following sections:
XML display control and keys on Yealink IP phones on page 5
Yealink IP Phone XML Objects on page 9
TextMenu Object on page 10
This version is updated to remove SIP-T28P, SIP-T26P, SIP-T22(P), SIP-T21(P), SIP-T20(P) and
SIP-T19(P) IP phones. Documentations of the newly released SIP-T27P and SIP-T21(P) E2
IP phones have also been added.
Major updates have occurred to the following sections:
XML display control and keys on Yealink IP phones on page 5
Yealink IP Phone XML Objects on page 9
Configuring an XML Browser Key on page 93

About This Guide
v
Documentations of the newly released SIP-T29G IP phones have also been added.
Major updates have occurred to the following sections:
XML display control and keys on Yealink IP phones on page 5
Yealink IP Phone XML Objects on page 9
Customizable Soft keys on page 78
Configuring an XML Browser Key on page 93
Documentations of the newly released SIP-T23P/G IP phones have also been added.
Major updates have occurred to the following sections:
XML display control and keys on Yealink IP phones on page 5
Yealink IP Phone XML Objects on page 9
Customizable Soft keys on page 78
Configuring an XML Browser Key on page 93
This version is updated to remove SIP-T3xG and VP530 IP phones. Major updates have
occurred to the following section:
Yealink IP Phone XML Objects on page 9
Major updates have occurred to the following section:
Yealink IP Phone XML Objects on page 9
The following sections are new:
XML Format on page 2
Some Development Guidelines on page 83
Troubleshooting on page 107
Appendix on page 109

XML Browser Developer’s Guide for Yealink IP Phones
vi
Major updates have occurred to the following section:
Yealink IP Phone XML Objects on page 9
This version is updated to incorporate SIP-T48G IP phones. Major updates have
occurred to the following section:
Yealink IP Phone XML Objects on page 9
This version is updated to incorporate SIP-T46G, SIP-T42G and SIP-T41P IP phones. Major
updates have occurred to the following section:
Yealink IP Phone XML Objects on page 9
Major updates have occurred to the following section:
Yealink IP Phone XML Objects on page 9
Major updates have occurred to the following sections:
XML display control and keys on Yealink IP phones on page 5
Yealink IP Phone XML Objects on page 9
Customizable Soft keys on page 78
XML Objects Pushed to the Phone on page 81
Documentations of the newly released SIP-T19(P) and SIP-T21(P) IP phones have also
been added.
The following sections are new:
Configuring the Push XML Server on page 87

About This Guide
vii
Configuring the Block XML in Calling on page 99
Major updates have occurred to the following section:
Yealink IP Phone XML Objects on page 9

XML and Yealink IP Phones
1
XML stands for extensible Markup Language. It is a markup language much like HTML.
HTML is designed to display data and to focus on how data looks, while XML is
designed to describe data and to focus on what data is.
XML enables SIP phones to serve as output devices for many exciting applications.
The XML infrastructure allows the phones to interact with external applications in a
flexible and programmable manner.
The following are characteristics of XML:
XML tags are not predefined. You must define your own tags.
XML uses an XML schema to describe the data.
XML with an XML schema is designed to be self-descriptive.
XML is a W3C Standard Recommendation.
Sample of Basic XML document:
<?xml version="1.0" encoding="ISO-8859-1"?>
<YealinkIPPhoneTextMenu
destroyOnExit="no"
style="numbered"
Beep="no"
Timeout="30"
LockIn="no">
<Title wrap="yes">Phone Services</Title>
<MenuItem>
<Prompt>Ask Google</Prompt>
<URI>http://10.2.11.158/yealink/google/google.php?user=</URI>
<Dial>456</Dial>
</MenuItem>
<MenuItem>
<Prompt>CNN News</Prompt>
<URI>http://10.2.11.158/yealink/rss/rss.php?feed=cnn</URI>
<Dial>1001</Dial>
</MenuItem>
</YealinkIPPhoneTextMenu>
Root element
Child elements of the root
XML Declaration

XML Browser Developer’s Guide for Yealink IP Phones
2
XML is written in the form of XML elements consisting of tags enclosed in angle
brackets (e.g., <YealinkIPPhoneTextMenu>). XML contains 3 kinds of tags: the start
tag, the end tag and the empty-element tag. The empty-element tag has two kinds of
form: in pairs (e.g., <MenuItem></MenuItem>) and not in pairs (e.g., <MenuItem />).
With the exception of the empty-element tag not in pairs, XML tags most commonly
come in pairs like <YealinkIPPhoneTextMenu> and </YealinkIPPhoneTextMenu>. The
first tag in a pair is the start tag (e.g., <YealinkIPPhoneTextMenu>), and the second
tag is the end tag (e.g., </YealinkIPPhoneTextMenu>). XML mainly follows rules as
below:
XML must have root element.
The end tag must have the character “/”.
XML tags are case-sensitive.
Each attribute value should be within double quotations.
The texts within <!-- --> are considered as comments.
XML provides escape facilities for including characters which are problematic to
include directly. For example, the characters "<" and "&" are key syntax markers and
may never appear in content. XML has five predefined entities.
XML conversion table is shown as below:
Character
Name
Escape Sequence
&
Ampersand
&amp;
“
Quote
&quot;
‘
Apostrophe
&apos;
<
Left angle bracket
&lt;
>
Right angle bracket
&gt;
To respect XML recommendations, the following header can be set at the beginning of
the XML document,
<?xml version="1.0" encoding="ISO-8859-1"?>
Or
<?xml version="1.0" encoding="UTF-8"?>
Yealink provides XML object files beginning with the XML declaration “<?xml
version="1.0" encoding="ISO-8859-1"?>”.
For more information on XML, refer to http://www.xml.com/.

XML and Yealink IP Phones
3
The XML browser feature on Yealink IP phones allows users to develop and deploy
custom services which meet user functional requirements on the server. Users can
customize practical applications, such as weather report, stock information, Google
search, news service, etc.
Phone service developers should take it into consideration that the phone is not a web
browser so it cannot parse HTML. Although the content is delivered to the phone
through HTTP messages using a web server, keep in mind that the content is not HTML.
All content comes to the IP phone either as plain text or text packaged in XML objects.
Yealink IP phones support 10 proprietary XML objects, which allow the creation of
powerful XML applications.
There are 2 types of XML objects:
UI objects: XML objects are used to control the LCD screen display of IP phones.
Non UI objects: XML objects have no direct impact on the current LCD screen display
of IP phones.
The supported objects are:
TextMenu object (UI)
TextScreen object (UI)
InputScreen object (UI)
Directory object (UI)
ImageScreen object (UI)
ImageMenu object (UI)
FormattedTextScreen object (UI)
Status object (UI)
Execute object (Non UI)
Configuration object (Non UI)

XML Browser Developer’s Guide for Yealink IP Phones
4
Depending on the IP infrastructure, Yealink has supported developing the XML
browser capability of the phones using HTTP. Yealink IP phones support two modes for
XML browser applications:
Phone-initiated
Server-initiated
You can press the predefined XML Browser key to trigger the phone initiated
application of XML browser. After you press the key, the IP phone issues an HTTP(s)
GET request message to the server, waits for the answer, decodes and displays this
response message like any web browser, such as Microsoft Internet Explorer or Firefox,
and would do as a web client. For more information on how to configure an XML
Browser key, refer to Configuring an XML Browser Key.
Figure1 Yealink IP phone acting as a client
The server initiated application would be more frequently used on the network. In this
mode, end users do not need to do any configuration and operation.
The server can push an XML object to the phone via an HTTP POST. For more
information, refer to XML Objects Pushed to the Phone.

XML and Yealink IP Phones
5
In addition, Yealink IP phones support accepting SIP NOTIFY messages from a SIP
proxy server, and act as limited web servers. For more information on how to configure
the XML SIP Notify, refer to Configuring the XML SIP Notify.
Figure2 Yealink IP phone acting as a server (HTTP(s) post)
Figure3 Yealink IP phone acting as a server (SIP NOTIFY)
This chapter describes the available part of the LCD screen for each phone model of
Yealink IP phones as well as the keys that are controlled by the XML objects.
The LCD screen and keys available for XML applications on a Yealink SIP VP-T49G IP
phone are:
16 text lines and 1 soft key line for the LCD screen

XML Browser Developer’s Guide for Yealink IP Phones
6
The soft key line is a command line and will be used to display the labels of the
available actions.
The LCD screen and keys available for XML applications on a Yealink SIP-T48G IP
phone are:
15 text lines and 1 soft key line for the LCD screen
The left and right arrow navigation keys
The up and down arrow navigation keys
The soft key line is a command line and will be used to display the labels of the
available actions. Depending on the XML object displayed on the phone, the X key
can also be interpreted as a “cancel” key, and the OK key as a “confirm” key.
The LCD screen and keys available for XML applications on a Yealink SIP-T46G/T29G IP
phone are:
10 text lines and 1 soft key line for the LCD screen

XML and Yealink IP Phones
7
The left and right arrow navigation keys
The up and down arrow navigation keys
The soft key line is a command line and will be used to display the labels of the
available actions. Depending on the XML object displayed on the phone, the X key
can also be interpreted as a “cancel” key, and the OK key as a “confirm” key.
The LCD screen and keys available for XML applications on a Yealink SIP-T42G/T41P IP
phone are:
5 text lines and 1 soft key line for the LCD screen
The left and right arrow navigation keys
The up and down arrow navigation keys
The soft key line is a command line and will be used to display the labels of the
available actions. Depending on the XML object displayed on the phone, the X key
can also be interpreted as a “cancel” key, and the OK key as a “confirm” key.
The LCD screen and keys available for XML applications on a Yealink SIP-T27P IP phone
are:
7 text lines and 1 soft key line for the LCD screen
The left and right arrow navigation keys
The up and down arrow navigation keys
The soft key line is a command line and will be used to display the labels of the
available actions. Depending on the XML object displayed on the phone, the X key
can also be interpreted as a “cancel” key, and the OK key as a “confirm” key.
The LCD screen and keys available for XML applications on a Yealink
SIP-T40P/T23P/T23G/T21(P) E2/T19(P) E2 IP phone are:
4 text lines and 1 soft key line for the LCD screen
The left and right arrow navigation keys
The up and down arrow navigation keys
The soft key line is a command line and will be used to display the labels of the
available actions. Depending on the XML object displayed on the phone, the X key
can be interpreted as a “cancel” key, and the OK key as a “confirm” key for
SIP-T23P/T23G/T21(P) E2 IP phones; the key can be as a “confirm” key for SIP-T19(P)
E2 IP phones.
The LCD screen and keys available for XML applications on a Yealink CP860 IP phone
are:
5 text lines and 1 soft key line for the LCD screen
The up and down arrow navigation keys
The soft key line is a command line and will be used to display the labels of the

XML Browser Developer’s Guide for Yealink IP Phones
8
available actions. Depending on the XML object displayed on the phone, the OK key
as a “confirm” key.

Yealink IP Phone XML Objects
9
Creating interactive service applications is relatively easy when you understand the
XML objects that are defined for Yealink IP phones and the behavior that each XML
object generates.
Regardless of what causes the phone to load an XML page, the phone always
behaves appropriately after it loads a page. Appropriate behavior depends only on
the type of data delivered in the page.
This chapter details all the XML objects supported by Yealink IP phones.
In this chapter:
Yealink IP phones with soft keys are:
Yealink SIP-T46G IP phones
Yealink SIP-T42G IP phones
Yealink SIP-T41P IP phones
Yealink SIP-T40P IP phones
Yealink SIP-T29G IP phones
Yealink SIP-T27P IP phones
Yealink SIP-T23P/G IP phones
Yealink SIP-T21(P) E2 IP phones
Yealink SIP-T19(P) E2 IP phones
Yealink CP860 IP phones
Yealink IP phones with a color graphical touch screen are:
Yealink SIP VP-T49G IP phones
Yealink SIP-T48G IP phones
This section details each proprietary XML object supported by Yealink IP phones. You
can ask the distributor or Yealink FAE for XML object files or obtain XML object files
online:
http://support.yealink.com/documentFront/forwardToDocumentFrontDisplayPage.
Note
The size of an XML object cannot exceed 10000 bytes (10 kb).
Per XML specifications, only one XML object is supported in an XML document sent to the
phone.
XML objects do not support Chinese characters.

XML Browser Developer’s Guide for Yealink IP Phones
10
The TextMenu object allows users to create a list of menu items on the IP phones. You
can use the TextMenu object to customize some functions such as weather report,
stock information, new services, etc. You can browse the menu items by linking HTTP
requests.
XML description of the TextMenu object:
<?xml version="1.0" encoding="ISO-8859-1"?>
<YealinkIPPhoneTextMenu
destroyOnExit="yes/no"
defaultIndex = "integer"
style = "numbered/none"
Beep = "yes/no"
wrapList="yes/no"
Timeout = "integer"
cancelAction = "URI"
LockIn = "yes/no"
>
<Title wrap = "yes/no">Menu Title</Title>
<MenuItem>
<Prompt>First menu item</Prompt>
<URI>HTTP(s) URL</URI>
<Dial>Number for dial</Dial >
<Selection>Selection</Selection>
</MenuItem>
<!--Additional menu items may be added (up to 30) -->
<!--Additional soft key items may be added -->
</YealinkIPPhoneTextMenu>
The parameters of the TextMenu object are listed in the following table:
Parameter
Position
Type
Value
Description
YealinkIPPh
oneTextMe
nu
Root tag
mandatory
none
The root element of the
TextMenu object.
destroyOn
Exit
Root tag
optional
“yes”
“no”
Select “yes”to return to
the previous XML object
after exit. Select “no”to