background image

 

Grandstream Networks, Inc.

 

               GXP31xx XML GUI Customization Guide  

                       Page 1 of 28  

                                                                                                                                                      Last Updated:  7/2011

 

1 O

VERVIEW

 

 

Grandstream GXV3140/3175 IP Multimedia Phone allows users to customize the GUI desktop layout as 
well as GUI configurations on the phone, offering users with flexibility and control. The XML GUI 
configuration includes display/hide certain applications, configure parameters on the phone with specific 
configuration files, control the display appearance and enable/disable some applications and much more. 

 

This application guide gives a detailed description on how to configure the GUI on the phone using the 
XML document. The first part will describe the 1) Structural implementation and the hierarchy of the XML 
document, 2) XML syntax and example XML file for the main control file, 3) XML syntax and an example 
XML file for configuring the config-file elements and 4) Provide a guide on generating the configuration file 
for the GXV3140/3175 using the Grandstream XML GUI Config Tool and downloading it to the phone. 

 

 
 

2 S

TRUCTURAL 

I

MPLEMENTATION 

 

 

All GUI configurations on the GXV3140/3175 are implemented and controlled by the XML file, which 
controls the hierarchy, display and implementation on the phone.  
 

z

 

Control File (menu.xml): GUI configuration document used to modify/control the GUI interface 
on the GXV3140/3175. It is able to implement the following functions: 
 

„

 

Modify the display hierarchy of the menu. 

„

 

Disable/Enable specific application features.  

„

 

Modify the display of applications on the menu of GUI. This includes modifying the display 
icon/text or display the application with default settings.  

„

  Specify configuration files and configure the settings for particular applications. These 

configurations includes: 
 

‹

 Parameter 

configurations. 

‹

  Function configuration: Display/Hide/Lock specific functions. 

‹

  Advanced configuration: Specify configuration files and other resource files so that the 

advanced settings on the phone can be configured using this information.  
 

„

 

Other Configurations (reserved for future modifications). 

 
Refer to the diagram below for the basic control flow.  

 

Note:

 Some of the configurations in the basic control flow diagram below are for demo purposes only. It 

may change in the actual implementations.   

Содержание GXV-3140

Страница 1: ...Grandstream Networks Inc GXV3140 3175 IP Multimedia Phone XML GUI Customization Guide...

Страница 2: ...GURATION MAINTENANCE XML 10 4 3 SCREEN LAYOUT CONFIGURATION SCREEN_LAYOUT XML 10 4 4 SCREEN DISPLAY CONFIGURATION SCREEN_DISPLAY XML 13 4 5 PHONEBOOK CONFIGURATION PHONEBOOK_CONFIG XML 14 4 6 LANGUAGE...

Страница 3: ...the phone 2 STRUCTURAL IMPLEMENTATION All GUI configurations on the GXV3140 3175 are implemented and controlled by the XML file which controls the hierarchy display and implementation on the phone z C...

Страница 4: ...element used to implement the link to specific web URL The GXV3140 3175 will link to and display the URL using the built in web browser z config file element This element specifies the configuration f...

Страница 5: ...interfaces internally This attribute is optional When nothing is specified the default value is normal Note By default we have certain pre defined menu items with func name These menu items has defau...

Страница 6: ...e_show Slide Show item No video Video Settings item No ip2location IP2Location item No twitter Twitter Application item No facebook Facebook Application item No today Today Application item No mulnews...

Страница 7: ...namic icon icon webbrowser gif display name Internet item func name webbrowser link icon icon Grandstream png dynamic icon icon Grandstream gif display name Grandstream Network link url http www grand...

Страница 8: ...nc name status menu Refer to the description below for detailed explanation on the demo file 1 submenu icon icon 2 png dynamic icon icon 3 png display name Communication item func name phonebook confi...

Страница 9: ...google com link url link Define an interface for the GMI implementation which will get the page from www google com and display it in the phone s GUI Users will then be able to use the page on the ph...

Страница 10: ...le configuration files at the end of this document for more descriptions and details Since configuration file validations are checked against XML Schema please make sure that all elements and attribut...

Страница 11: ...1 20 server outbound proxy outbound proxy auth id 8080 auth id auth pwd 8080 auth pwd user id 8080 user id display name 8080 display name account account lock 1 index 3 index active 1 active pos 3 po...

Страница 12: ...Valid values are 0 or 1 1 Factory reset option is locked Users can see it but cannot configure 0 Factory reset option is not locked Users can configure hide Valid values are 0 or 1 1 Factory reset op...

Страница 13: ...n softkey desktop4 small layout large layout desktop1 item position left Information item item position right Analog Clock item softkey key F1 Menu softkey softkey key F2 Switch Screen softkey softkey...

Страница 14: ...n on the desktop Type String Valid values are as follows z RSS News RSS News desktop application z Weather Weather desktop application z Analog Clock Analog Clock desktop application z Digital Clock D...

Страница 15: ...e parameter to make call z large layout Large layout configuration element desktopX Configure the layout for Desktop X where X is a value from 1 to 4 Every desktop has two windows left window right wi...

Страница 16: ...saver timeout period in minutes Valid values are integers from 0 to 9999 where 0 is used to turn off the screensaver functions The default value is 5 lcdoff LCD Auto Power Off Time in minutes Valid va...

Страница 17: ...ebook download server URL A downloadable phonebook xml should be placed in this server specified by the url z rm redup Replicate duplicate items If set to On the duplicate items in the phonebook will...

Страница 18: ...guage txt must exist in the same folder as the configuration file z download mode language download mode The valid values are 0 Off 1 via TFTP 2 via HTTP z update interval Language file download inter...

Страница 19: ...mization Guide Page 17 of 28 www grandstream com Last Updated 7 2011 Figure 3 GUI Customization Tool Step 1 Step 2 Specify the Source and Target Path Figure 4 GUI Customization Tool Step 2 Step 3 Move...

Страница 20: ...1 Figure 5 GUI Customization Tool Step 3 Step4 Press the Generate Button Figure 6 GUI Customization Tool Step 4 If the user is using GXV3140 the System Config Tool will start parsing the files and wil...

Страница 21: ...XV3140 will send out the request to download the gxv3140cust file every time at phone boot up Once the GXV3140 has successfully downloaded and parsed the file the settings will take place and the user...

Отзывы: