background image

 

Grandstream Networks, Inc. 

GXV31xx XML GUI Customization Guide 

Page

 

3 of 28  

www.grandstream.com 

 

Last Updated:  7/2011

 

¾

 

dynamic-icon

: The menu displays dynamic icons when it is selected. If nothing is specified, the 

phone will use the default menu icon. (This element is optional) 

¾

 

display-name

: The display name for the icons in the menu. If nothing is specified, the phone 

will use the default menu text. If this parameter is specified, it will overwrite the default menu text. 
(This element is optional)   

¾

 

hide

: Show/hide the menu items. 1- Hide/Disable the menu items, 0- Show/Enable the menu 

items. By default, it is set to 1.  (This element is optional) 

 
Unique attributes for elements <submenu> and <item>

 

 

¾

 

func-name

: Menu item ID that is used to identify a specific menu item uniquely. By default, 

there are pre-defined settings for the default menu items which include dynamic-icon, icon and 
display-name. For the <item> element, this is required attribute. For <submenu> element, this is 
an optional attribute and it can be configured via icon, dynamic-icon and display-name attribute.

 

 

 
Unique attributes for elements <link>

 

 

¾

 

type

: link type ID that is used to indicate the link functions. The possible value could be 

normal

 (for normal link element) and 

gmiapp

 (for GMI application). When 

gmiapp

 is used, 

it will link the GMI application (web implemented) which will control and redraw the GUI via the 
related GMI 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 

default static icon, dynamic icon and display text. The display text will be changed when the 
phone loads the language file based on the language setting on the GUI interface. Users can also 
overwrite the default display-text by configuring the display-name attribute. For pre-defined func-
name and the corresponding menu item, please refer to the table below. 

  For all self-defined submenu elements and link elements, it is required to configure the icon, 

dynamic-icon and display-name attribute so that it can be displayed properly on the phone. If 
these are not configured properly, it may have incorrect display in the menu.  

  For config-file element, currently it will work with these 6 applications: Account, Maintenance, 

Phonebook, Screen Layout, language and Screen Display.  

 

All the configuration files (including the control file and the specific application configuration file) 
use its current directory as the root directory.   

 

func-name 

Menu Item 

Element Type 

Support for 
config-file element 

callhistory Call 

History 

item 

No 

messages Messages 

item 

No 

callfeature Call 

Features 

item 

No 

webbrowser Web 

Browser 

item 

No 

status Info 

item 

No 

calendar Calendar 

item 

No 

alarmclock Alarm 

Clock 

item 

No 

calculator Calculator 

item 

No 

weather Weather 

item 

No 

rssnews RSS 

News 

item 

No 

ipcall 

Direct IP Call 

item 

No 

gstris Gstris 

item 

No 

softkey_def Softkey 

item 

No 

display Display 

item 

No 

Summary of Contents for GXV-3140

Page 1: ...Grandstream Networks Inc GXV3140 3175 IP Multimedia Phone XML GUI Customization Guide...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Reviews: