Grandstream Networks, Inc.
www.grandstream.com TABLE OF CONTENTS 1 OVERVIEW .................................................................................................................................................... 3 2 STRUCTURAL IMPLEMENTATION .................................................................................................................. 3 2.1 ELEMENT DESCRIPTION .........................................................................................................................................
1 OVERVIEW The GXV3140 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.
Figure 1: Configuration File Implementation Flow 2.1 ELEMENT DESCRIPTION The control file supports these following elements:
dynamic-icon: The menu displays dynamic icons when it is selected. This setting is configuration but optional. 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. This setting is configuration but optional. If nothing is specified, the phone will use the default menu text. (This element is optional) Note: If this parameter is specified, it will overwrite the default menu text.
internetradio stock currencies myprofile onlinemusic camera tones photobucket phanfare onlinevideo fxo horoscope panoramio slide_show video ip2location twitter facebook today account maintenance screen_layout screen_display Internet Radio Stock Currencies My Profile Online Music Camera Tones Photobucket Application Phanfare Application Online Video FXO Settings Horoscope World Photos Slide Show Video Settings IP2Location Twitter Application Facebook Application Today Application Accounts Maintenance Screen
Refer to the text below for detailed explanation on the demo file: 1.
Figure 2: Flow diagram of example demo file Note: All the configuration files are parsed through the XML parser, therefore it is essential to follow the standard XML schema format and refer to the example configuration files at the end of this document for more descriptions and details. Since the validity of the configuration files are checked with XML Schema, please make sure that all elements and attributes follow the standards to avoid any parsing failure/error.
This allows users to configure Accounts using the specified configuration file (e.g. acct.xml). This includes configuring the following: Account SIP server, SIP user ID, Authenticate ID, Authenticate password etc… It also defines settings such as whether the account is active, hiding the account or reordering the accounts. Refer to the account configuration file (acc.xml) below: 1 1 1 Account 2 192.168.
4.2 : Specifies whether the configuration is active or not. Valid values are 0 or 1. 1- Active, 0Inactive. : Account position index. Allows the reordering of accounts, such as moving Account 1 to Account 3. Valid values are from 1~3. : Account Name. ((Type- String) : SIP server URL. (Type- String) : Outbound proxy server URL. (Type- String) : SIP Account Authenticate ID. (Type- String) : SIP Account Authenticate Password.
1 - RSS News
- Digital Clock
- Information
- Weather
- Calendar
- Information
- Analog Clock
- RSS
4.
The various elements and attributes are described below: : Configuration file root element : configuration file version. This will increment if there are changes in the configuration file element, to identify the different configuration file version. : screensaver type, valid values are: 0: Default Folder 1: Customized Folder 2: HTTP URL 3: World Photos 4: Flickr 5: Photobucket 6: Phanfare
Step 2: Specify the Source and Target Path. Step 3: Move the source files over to the “Select File List Grandstream Networks, Inc. www.grandstream.
Step4: Press the “Generate Button” The System Config Tool will start parsing the files and will generate the gxv3140cust file when it has succeeded. This file should be available in the target path specified. Grandstream Networks, Inc. www.grandstream.
Place the gxv3140cust file in the local TFTP/HTTP server root directory and change the firmware server path on the GXV3140 to point to this server. Reboot the phone. By default, the GXV3140 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 will see the customized GUI menus.
7 APPENDIX: GXV31XX XML BASED CUSTOMIZABLE SCREEN This part of the document describes how to make a custom screen on the GXV31xx with the XML configuration file. The Gxv31xx serial products support three types of layouts: small layout, large layout and custom layout. You can select the custom layout mode and select the XML configure file which includes the layout information, save to make it take effect. 7.
0 10 2 240 10 3 10 10 7.2 XML SYNTAX EXPLANATION 7.2.1 Root Element “Screen” The XML document has root element called Screen; it contains sub-elements called IdleScreen and CallScreen.
Element “FileName”: This specifies the name of the picture that will be displayed on the desktop. It is mandatory. Element “X”: Decide the x coordinate where the picture puts on the desktop. It is mandatory. Element “Y”: Decide the y coordinate where the picture puts on the desktop. It is mandatory. Element “Width”: Decide the width of the picture, this will only take effects when the attribute “scaled” set to “true”, otherwise the original width of the picture will be kept. This element is optional.
This specifies the font size of the string. The value must be between 5 and 16. This attribute is optional. The system will use the default system font size color if it is not specified. Attribute “color”: This specifies the font color of the string. Possible value is the hexadecimal RGB value in the form #RRGGBB.
14. $M: This variable is replaced with the current month in English, possible values: January, February, ..., December 15. $o: This variable is replaced with the current month in number with leading zero, possible values: 01, 02, ..., 12 16. $n: This variable is replaced with the current month in number without leading zero, possible values: 1, 2, ..., 12 17. $Y: This variable is replaced with the current year in 4-digit number, for example: 2006, 2007 ... 18.
The function layout, possible value: “small” or “large”. For the functions: FuncAnalogClock, FuncDigtalClock and FuncInfo. If the “small” is chosen, the function will take a quarter of the screen; If the “large” is chosen, the function will take half of the screen. For other functions such as FuncRssNews, FuncWeather and FuncCalendar: The function will always take the half of the screen, so the “layout” attribute will have no effects. 7.2.2.
After the user presses the “Download” button, the phone will send out a request to the server to download the configuration file (custom_layout.xml). If the download and the parse of the XML file are successful, the phone will display a message to inform the user. The user can then press “Save” to save the settings. The phone should display the custom layout on the desktop after the settings take place. Grandstream Networks, Inc. www.grandstream.
