Sign in using DevConnect ID

Forgot password?

Trouble logging in?

Submit a ticket for Registration Support.

I have an SSO ID

?
sign in

Don't have a DevConnect or SSO ID ?

Create a DevConnect account or join the program.

register now
^

FAQ: Avaya IP Deskphones

This document contains the Frequently Asked Questions on Avaya 4600 and 9600 Series IP Telephones.

4600 and 9600 Series IP Telephone Web Browser

What version of WML does the Web Browser support?

The Web Browser supports the WML 1.3 (June 2002) release.

What is the relation between XML and WML?

WML (Wireless Markup Language) is a markup language based on XML. WML is a XML specification proposed by the Open Mobile Alliance (http://www.wapforum.org/) and follows the XML rules and specifications. WML uses tag pairs and attributes for all language features. Essentially, WML is an XML application.

Why is the browser called an XML Browser and not a WML Browser?

Since WML is an XML application, the Web browser is a XML browser that supports WML tags. Avaya supports industry standard WML specifications on the Web Browser.

What is difference between HTML and WML? What can I do with HTML that I cannot do with WML? Which one is better?

HTML is a specification that was first proposed by w3c org. HTML is not based on an XML specification.

WML is an application of XML (EXtensible Markup Language), Essentially WML is a stripped down version of syntactically valid HTML with 35 strictly applied semantic tags.

HTML has well over 120 tags (three times that of WML) helping to give its characteristically messy ad-hoc nesting syntax. Rules for HTML tag nesting are loose.

EXtensible Markup Language (XML) presents a solution to the HTML mess. Using XML developers can define their own markup languages by referencing to an external DTD (Document Type Definition). The DTD is a sequence of rules describing the markup language. However this enforces strict rules governing language syntax in stark contrast to HTML.

  • HTML has a comparatively deep and complex nesting structure.
  • HTML is not well-formed allowing tagsets to remain unclosed.
  • HTML can display special Unicode characters not recognized in WML.
  • WML tags must all be in lowercase.
  • WML is unforgiving of incorrectly nested tags.

HTML and WML also share a lot of features together. The WML set of tags was designed to cover most of the functionality that could be achieved using HTML. The list of functionality includes features such as: Text Presentation and layout, Images, User Input (Form controls such as choice lists, multilevel choice lists, text entry and task controls), Navigation, and Hyperlinks etc.

In short, what are the capabilities of WML?

WML supports six key areas:

  • Text presentation and layout - Line breaks, basic text formatting and alignment are supported by WML.
  • Images - WML supports Wireless Bitmap images and alignment on the screen. NOTE: 4625 Color set also supports JPEG color images
  • User Input - WML supports choice lists, multilevel choice lists, text entry and task controls.
  • Cards and decks - User interaction is divided into cards. Navigation is primarily between cards. Decks are related sets of cards and are saved as a single file
  • Navigation - WML supports the standard Internet URL naming scheme and anchored links, allowing navigation between cards in a deck, between decks, or between other resources on the network such as databases.
  • State and context management - WML allows for variables to be passed between files. Instead of sending a complete string, variables can be sent and substituted at runtime. The user agent can cache both variables and WML files, minimizing cache hits and server requests. It is also possible to pass variables between different cards in the same deck.

Are there any references for the WML language?

The "4600 Series IP Telephone Interfaces API Guide" describes the WML tags and attributes supported by the 4600 IP Telephone's Web Browser. The "Avaya one-X Deskphone Edition for 9600 Series IP Telephones Application Programmer Interface (API) Guide" describes the WML tags and attributes supported by the 9600 IP Telephone's Web Browser.These documents are available on the DevConnect web site, http://devconnect.avaya.com . In addition, there are several good web sites with WML language references and tutorials. Among them, at the time of this writing, are:

http://www.devguru.com/Technologies/wml/quickref/wml_intro.html
http://www.developershome.com/wap/wml/

There are also books available on WML programming.

Does the Web Browser support WMLScript?

WMLScript is not Supported.

Does the Web Browser support images?

Yes, WBMP images are supported on all models of the 4600 and 9600 series IP phones. The 4625 IP phone also supports JPEG images. All 9600 Series IP Telephones support JPEG iamges.

Does the Web Browser cache pages in the browser?

The Web Browser will only store the current WML file (or the current deck of cards) in memory.

When a user tries to go back in history and if the page corresponds to a different WML page from that corresponding to the one that is displayed on the screen, the Web Browser will retrieve/fetch a new copy of the page. Any user selection or text entry made by the user will be lost.

How can I setup a standard web server to serve WML pages and WBMP images for the Web Browser?

To set up a Web server for the Avaya IP Telephones, just add two MIME types for wml and wbmp extensions to the web servers configuration. For more information on setting up MIME types or setting up a Web server, see the "WML Server (MIME Types) Setup Guide - 4600 Series" document available on the DevConnect web site, http://devconnect.avaya.com/ . Note that the information in this guide also applies to the 9600 Series IP Telephones as well.

Does the Web Browser support cookies?

Cookies are not supported on the Web Browser.

Does the Web Browser support sessions and session variables?

A browser handles "Session" and "Session variables" by storing temporary cookies. Since cookies are not supported on the Web Browser, sessions and session variables are not supported.

Can I change the font or the size of a font displayed on the Web Browser?

It is not possible to change the typeface itself on the browser. Also there is no WML tag specifically to do this.

Alternatively, you can create a WBMP image with the choice of your font and display it on the phone.

With the 4625SW phone, you can create a color JPEG image with different font style and display it on the phone. On the 4625SW, you can also change the font color.

What are the values needed for the Web Browser in the 46xxsettings.txt or 96xxsettings.txt settings files?

There are four settings in the 46xxsettings.txt which affect Web Browser applications: WMLHOME, WMLPROXY, WMLPORT and WMLEXCEPT.

WMLHOME contains the URL of the home page for the Web application. The IP phone will not display the Web softkey label if the value of WMLHOME is null.

WMLPROXY contains the IP address, in dotted-decimal or DNS name format, of an HTTP proxy server. If the web pages accessed by the 4620 are completely on the customer's intranet, then WMLPROXY, WMLPORT, and WMLEXCEPT need not be set. If WMLPROXY is null, then the values of WMLPORT and WMLEXCEPT do not matter.

WMLPORT contains the TCP port number used for the HTTP proxy server. The default value is "8000".

WMLEXCEPT contains Web application HTTP proxy server exception domains (domains for which the proxy server will not be used), which is a list of one or more domains, separated by commas without any intervening spaces (up to 127 total ASCII characters, including commas).

How can I uniquely identify/detect the Web Browser in my web server application?

The Web Browser sets the User-Agent HTTP header field included in all HTTP messages initiated by the browser. The User-Agent field is formatted as follows for the 4600 Series IP telephones.

The general format of the User_Agent field is: "AVAYA/IGEN/Firmware Version+(SetType)/MinorRelease"

For the 4610SW IP Telephone for example: "AVAYA/IGEN/v2.2+(4610x)/0.0"
For the 4620/4620SW, 4621SW and 4622SW IP Telephones for example: "AVAYA/IGEN/v2.2+(4620x)/0.0"
Note that 4620SW, 4621SW, and 4622SW are aliased as 4620 IP Telephones, andtherefore use the same header as that phone.
For the 4625SW IP Telephone for example: "AVAYA/IGEN/v2.5+(4625x)/0.0"

The User-Agent field is formatted as follows for the 9600 Series IP telephones.

The general format of the User_Agent field is: "AVAYA/SPICE/Firmware Version+(SetType)/Browser Type/MinorRelease"

For the 9620 IP Telephone for example: "AVAYA/SPICE/v1.0+(9620)/Std/0.1"
For the 9630 IP Telephone for example: "AVAYA/SPICE/v1.0+(9630)/Std/0.1"

Does the Web Browser support WML variables?

Yes. It supports variables of the form $(variablename).

What form methods are supported in the Web Browser?

Both HTTP GET and POST methods are supported.

Does the Web Browser support Cascading Style Sheets (CSS)?

The Web Browser for the 4610SW, 4620/4620SW, 4621SW and 4622SW do not support CSS. However, the <template> tag can be used to define deck-level event bindings, i.e. characteristics that apply to all cards in the deck. You can override these characteristics for a particular card by specifying the same event bindings within the <card> definition.

The Web Browser for the 4625SW supports CSS2. See http://www.w3.org/TR/CSS21/cascade.html for further details about CSS2. The 4625SW phone does not support the external linkage of stylesheets. Only in-line stylesheets are supported. See "4600 Series IP Telephone Interfaces API Guide" which describes the use of CSS2 by the 4625SW IP Telephone's Web Browser. This document is available on the DevConnect web site, http://devconnect.avaya.com .

The Web Browser for the 9600 Series IP Telephones support CSS2. See http://www.w3.org/TR/CSS21/cascade.html for further details about CSS2. The 9600 phones do not support the external linkage of stylesheets. Only in-line stylesheets are supported. See "Avaya one-X Deskphone Edition for 9600 Series IP Telephones Application Programmer Interface (API) Guide" which describes the use of CSS2 by the 9600 Series IP Telephone's Web Browser. This document is available on the DevConnect web site, http://devconnect.avaya.com .

Is font coloring supported on the 4625SW?

Yes, the font coloring is supported by using the ?foreground? as the selector for CSS. Please see the example below.

Example:
In this case, the background is set to blue color and the text ?Sample Text? is displayed in red color.
<p style=?background-color:blue; text:red;?> Sample Text </p>

You can also have a style for an <a> tag as below:

Example:
<a style="color:blue;" href="wtai://wp/mc; 7325551234">Call 7325551234</a>

So, in this case, the phone number ?Call 7325551234? is displayed in blue color.

Apache web server has been configured with PHP module, but still the Push operation does not succeed on the phone. Are there any additional configuration changes that need to be made to PHP?

In order to perform a push operation the "cURL" handle needs to be initialized. Check if the libcurl library is installed with the PHP module that allows you to connect and communicate to different types of servers using protocols like HTTP, HTTPS, FTP, FTPS, GOPHER, LDAP, DICT, TELNET and FILE.

"cURL" can then be enabled by uncommenting the line 'extension=php_curl.dll' in the "php.ini file". From PHP version 4.2.3 on, you need a "cURL" version of at least 7.9.0. From PHP version 4.3.0 on, you need a "cURL" version of at least 7.9.8.

Does the WML Browser support the < table > tag?

The < table > tag is not supported on the Avaya IP Phones WML Browser. Also, other related tags like < tr > and < td > are not supported by the Avaya IP phone.

Refer to the Programmer's Guide for more details on tags that are supported by the WML browser - Application Programmer Interface (API) Guide - 4600 Series, Avaya one-X Deskphone Edition for 9600 Series IP Telephones Application Programmer Interface(API) Guide.

How can the Idle phone web page (page to be displayed when the phone has been idle for specified time period) on the WML Browser be configured?

This can be configured in the "46xxsettings.txt" file. Set the "WMLIDLEURI" variable to the URL of the web page that needs to be displayed when the idle period expires. Depending on how your "46xxsettings.txt" file is organized, this variable can appear globally, affecting all phones, or within a section specific to a particular model.

How do I set the idle time required before the WMLIDLEURI web page is displayed on the screen?

The idle time out can be set in the "46xxsettings.txt" file. Set the "WMLIDLETIME" variable to the required time out period in minutes. Depending on how your "46xxsettings.txt" file is organized, this variable can appear globally, affecting all phones, or within a section specific to a particular model.

In spite of setting 'WMLHOME', the browser menu option does not appear on the Avaya IP Telephone. What could be the reason?

Depending on how the 46xxsettings.txt file is set up, the 'WMLHOME' parameter, which sets the URL of the homepage, can be different for each set type so as to take advantage of the capabilities of the individual sets. 'WMLHOME' must be set in the section for the individual set types in the '46xxsettings.txt' file.

Check whether the 'WMLHOME' parameter has been set in the appropriate section based on the set type of the Avaya 4600 or 9600 Series IP telephones in the '46xxsettings.txt' file.

Make sure the 46xxsetting.txt file is being read by the phone. Depending on which mechanism you are using, make sure either the TFTP or HTTP server is running that the phone is configured to use to retrieve the settings file. Ensure that the phone is reading this file by using a network sniffer such as WireShark. Make sure you reboot the phone after modifying the settings file.

Always make sure that you are using the most current release of the phone firmware which is available for download at support.avaya.com.

When an input field (such as a text box) is encountered by the Avaya IP Telephone's Web browser, the default input type is always alphabetical. Is there any way to specify the default input type as numeric so that numbers may directly be entered using the keypad?

The current release of the firmware for the Avaya IP Telephone does not support this. The default input type is alpha. You must use the alpha-num softkey to change the input mode after entering the input field.

Four softkeys are available on the Avaya IP Telephone screen, being mapped to SpDial, Log and Web, with the fourth one blank. Can the fourth softkey be used to configure a second Web entry point (i.e. to go to another web page via the fourth softkey)?

Right now, on the Avaya 4600 Series IP Telephones, it is NOT possible to configure additional URLs as new buttons. On the Avaya 9600 Series IP Telephones, additional links can be configured as shown under the 'A Menu'.

On the 9600 Series IP Telephones, all additional links to applications show up when the 'A Menu' button is pressed. These buttons are configured using the 'AMenuAdmin.txt' file. The package containing this file can be downloaded from the Avaya support website (http://support.avaya.com).