Grandstream Networks GXP2130 Series User manual

GXP2130/GXP2140/GXP2160 XML Phonebook Guide
Grandstream Networks, Inc.
GXP2130/GXP2140/GXP2160
XML Phonebook Guide

GXP2130/GXP2140/GXP2160 XML Phonebook Guide
GXP2130/GXP2140/GXP2160
XML Based Downloadable Phone Book Guide
Index
INTRODUCTION ........................................................................................2
WHAT IS XML........................................................................................................................................2
WHY XML ..............................................................................................................................................2
XMLAPI ARCHITECTURE....................................................................................................................2
XML PHONEBOOK CONFIGURATION.....................................................4
FIRMWARE............................................................................................................................................4
WEB CONFIGURATION........................................................................................................................4
LCD CONFIGURATION.........................................................................................................................6
PROVISIONING.....................................................................................................................................8
XML PHONEBOOK SYNTAX.....................................................................9
HEADER................................................................................................................................................9
PHONEBOOK XML STRUCTURE........................................................................................................9
PHONEBOOK XML ELEMENT ........................................................................................................... 11
ROOT ELEMENT <AddressBook>...............................................................................................11
<pbgroup> ELEMENT ..................................................................................................................11
<Contact> ELEMENT...................................................................................................................12
<Phone> ELEMENT.....................................................................................................................12
XML PHONEBOOK EXAMPLE................................................................13

XML BASED DOWNLOADABLE PHONEBOOK GUIDE Page 1 of 15
Table of Figures
GXP2130/GXP2140/GXP2160 XML Based Downloadable Phone Book Guide
Figure 1: GXP2130/GXP2140/GXP2160 XML API via HTTP.......................................................................3
Figure 2: GXP2130/GXP2140/GXP2160 XML API Structure 1 ....................................................................3
Figure 3: GXP2130/GXP2140/GXP2160 XML API Structure 2 ....................................................................4
Figure 4: Web Configuration .........................................................................................................................5
Figure 5: Contacts->Local Phonebook..........................................................................................................7
Figure 6: XML Phone Book Download Soft Key ...........................................................................................7
Figure 7: Confirm to start XML Phone Book Downloading ...........................................................................8
Table of Tables
GXP2130/GXP2140/GXP2160 XML Based Downloadable Phone Book Guide
Table 1: <AddressBook> Element............................................................................................................... 11
Table 2: <pbgroup> Element.......................................................................................................................11
Table 3: <Contact> Element........................................................................................................................12
Table 4: <Phone> Element..........................................................................................................................13

XML BASED DOWNLOADABLE PHONEBOOK GUIDE Page 2 of 15
INTRODUCTION
The Grandstream GXP2130/GXP2140/GXP2160 support XML based downloadable phone book for users
to share and maintain a phone book remotely easily.
For the ease of efficient deployment and management, the XML phone book file could be stored on a web
server for the phones to download. There are also applications that require a centralized directory server
and have all phones synchronized with the server periodically.
This document specifies the Grandstream XML based downloadable phone book configuration that will be
applied to GXP2130/GXP2140/GXP2160 firmware version 1.0.0.17 or newer. An example XML phone
book file is provided at the end of this guide. Users could start a phone book by adding contacts to the
example file or exporting the existed phone book file from phone's LCD.
WHAT IS XML
XML (eXtensible Markup Language) is a markup language* for documents and applications containing
structured information. This information contains both content (text, pictures, input box and etc.) and an
indication of what role that content plays (e.g. contents in a section header are different from contents in a
footnote). Almost all documents are structured.
*A markup language is a mechanism to identify structures in a document. The XML specification defines a
standard way to add markup to documents.
WHY XML
What benefits does XML provide to SIP endpoints? XML enables our SIP phones to serve as output
devices and allows the phones to interact with external applications in a flexible and programmable
manner.
XML API ARCHITECTURE
The XML based phone book downloading for the GXP2130/GXP2140/GXP2160 could use HTTP or TFTP
as the transport protocol. The following figure shows how it works via HTTP as an example. First, the
GXP2130/GXP2140/GXP2160 initiates the HTTP GET Request to the HTTP server and waits for the
response. Once the phone receives the response with XML content in BODY, it displays the information.

XML BASED DOWNLOADABLE PHONEBOOK GUIDE Page 3 of 15
Figure 1: GXP2130/GXP2140/GXP2160 XML API via HTTP
Two types of XMLAPI architecture are introduced below, depending on whether the transaction is via LAN
or Internet.
1. A transaction in the LAN may exchange information in the following manner. The
GXP2130/GXP2140/GXP2160 sends a request to the web server via HTTP/TFTP and waits for a
response with the XML contents. The web server will handle the request and communicate with the
application server to get the information for the XML phone book content display. The following figure
shows downloading XML phone book file via HTTP within a LAN.
Figure 2: GXP2130/GXP2140/GXP2160 XML API Structure 1
2. If the above Web Server accesses Internet, it could interact with outside web server and respond with
real-time content to the GXP2130/GXP2140/GXP2160.

XML BASED DOWNLOADABLE PHONEBOOK GUIDE Page 4 of 15
Figure 3: GXP2130/GXP2140/GXP2160 XML API Structure 2
As illustrated above, all the logic lies within the server side of the architecture. The
GXP2130/GXP2140/GXP2160 phone just receives the XML documents and displays it accordingly.
XML PHONEBOOK CONFIGURATION
FIRMWARE
Before the XML phone book is used on GXP2130/GXP2140/GXP2160, please make sure the firmware on
the phone is upgraded to the latest version. Please refer to the following link for firmware upgrading
information:
http://www.grandstream.com/support/firmware
WEB CONFIGURATION
User could configure phonebook download options by enter phone’s IP on web browser and go to
Phonebook->Phonebook Management.

XML BASED DOWNLOADABLE PHONEBOOK GUIDE Page 5 of 15
Figure 4: Web Configuration
Enable Phonebook XML Download
The phone book XML file could be downloaded via HTTP or TFTP. Users could also set the option
“Enable Phonebook XML Download”to "Disabled" to disable phone book download.
XML Server Path
This specifies the path where the phone is going to download the XML phone book file. Since
download method is already specified in the previous selection, users do not have to provide this
information in the server path. The accepted formats are as follows:
IP_address[:port]/dir
Hostname[:port]/dir
Examples:
192.168.40.10/XMLphonebookdir
192.168.40.10:443/XMLphonebookdir
service.mycompany.com/XML/phonebook
mycompany.com:8080/phonebook
Note:
1. If "[:port]" is not specified, port 80 will be used as default for HTTP and Port 69 will be used as
default for TFTP;
2. The GXP2130/GXP2140/GXP2160 will always look for the phone book file phonebook.xml for
downloading if no file name is specified in the server path.

XML BASED DOWNLOADABLE PHONEBOOK GUIDE Page 6 of 15
Phonebook Download Interval
This option specifies the phone book automatic download interval (in minutes). The valid value is 5 -
720. If it's set to 0, automatic download will be disabled.
Remove Manually-edited Entries on Download
If this option is set to “Yes”, when XML phonebook is downloaded, the manually-edited entries will be
deleted.
Download XML Phonebook
Click on Download button to download the XML phonebook from GXP2130/GXP2140/GXP2160 to
local PC. When the phonebook of GXP2130/GXP2140/GXP2160 is empty, the downloaded XML
phonebook will be in below format:
<?xml version="1.0" encoding="UTF-8"?>
<AddressBook>
<version>1</version>
</AddressBook>
Upload XML Phonebook
GXP2130/GXP2140/GXP2160 also support uploading XML phonebook from local PC.
Click on the button to choose XML file and upload.
Phonebook Key Function
This option controls the behavior of Phonebook Key. By default, Phonebook Key is the short cut to
enter the contacts sub menu. With this option, user can configure the Phonebook Key as LDAP
Search, Local Phonebook, Local Group or Broadsoft Phonebook.
LCD CONFIGURATION
To download the XML phone book file to GXP2130/GXP2140/GXP2160, go to LCD Menu-> Contacts->
Local Phonebook and press Download soft key to start downloading XML Phone Book.

XML BASED DOWNLOADABLE PHONEBOOK GUIDE Page 7 of 15
Figure 5: Contacts->Local Phonebook
Figure 6: XML Phone Book Download Soft Key

XML BASED DOWNLOADABLE PHONEBOOK GUIDE Page 8 of 15
Figure 7: Confirm to start XML Phone Book Downloading
PROVISIONING
Users may also use the config file to provision the phone with the above XML phone book downloading
options. In this case, the GXP2130/GXP2140/GXP2160 needs to be rebooted and provisioned. The
corresponding P values are as shown below.
P330: Enable Phonebook XML Download. Possible values: 1 (HTTP) / 2 (TFTP)/ 3 (HTTPS); other
values are ignored. The default value is 0.
P331: Phonebook XML Server Path. This is a string for the path to download the phonebook.xml file. It
MUST be in the host/path format.
P332: Phonebook Download Interval (in minutes). Valid range: 5 - 720; other values are ignored. The
default value is 0 (automatic download disabled).
P333: Remove Manually-edited Entries on Download. Possible values: 0 (No)/ 1 (Yes). The default
value is 1.
P1526: Phonebook Key Function. Possible values: 0 (Disable)/ 1 (LDAP Search)/ 2 (Local
Phonebook)/ 3 (Local Group)/ 4 (Broadsoft Phonebook); other values are ignored. The default value is
0.
The phone will be set up with the P values when the provisioning routine is completed. It will attempt to
download the phone book XML file specified in "Download Server" with configured interval and process it.
If the "Interval" is set to a non-zero value, a recurring timer will be activated periodically to check the phone
book file in the server and the phone will repeat this process automatically.