Chapter 8: Administering Applications and Options

Customizing 1600 Series IP Telephone Applications and

Options

The 1600 Series IP Telephones have some unique and powerful capabilities that take advantage of their display and access to LAN facilities. You need to provide the information

called for in relevant sections of Table 17 in a customized script file. For more information, see

1600 Series IP Telephone Scripts and Application Files on page 62.

!

CAUTION:

CAUTION:

For the telephones to work properly, you must have a 46xxsettings.txt file in the same directory as the application file. If you do not edit the 46xxsettings.txt file, those telephones use default settings only. The 46xxsettings file is available as a standalone download. If you already have such a file because you downloaded it for a previous 1600 Series, 9600 Series, or 4600 Series IP Telephone release, installing the standalone file overwrites the original file.

Note:

Note:

To facilitate administration, the 1600 Series, 9600 Series, and 4600 Series IP

Telephones use the same 46xxsettings.txt file.

In Table 17 , parameters shown with a Mandatory status must be accurate and non-null for the

application to work. You can change parameters with an Optional status to suit your environment. If you do not change parameters, the defaults are used.

Issue 5 April 2010 111

Administering Applications and Options

Table 17: 1600 Series IP Telephone Customizable System Parameters

Parameter Name Default Value Status Description and Value Range

General User Parameters:

APPSTAT 1

OPSTAT 111

Optional Applications status flag. See

The

Application Status Flag

(APPSTAT) on page 114 for a

description. See

Table 18

for the range of values.

Optional Options status flag(s) (1 or 3 ASCII numeric digits) indicate which options are user-selectable. The default of 111 grants access to all options and related applications.

Single digit valid values are:

1=user can access all options, including Logout,

2= user can access only view-oriented applications.

Three-digit valid values are a concatenation of binary values, in the form abc, where each letter represents a 0 (disabled/off) or 1

(enabled/on), interpreted as:

a = base settings for all user options and related applications, except as noted in b or c.

b = setting for view-oriented applications (for example, the

Network Information application), as applicable.

c = setting for Logout application, if applicable.

The binary "0" does not allow an end user to see or invoke options and related applications. The binary "1" allows full display and access to all options and related applications.

1 of 2

112 Avaya 1600 Series IP Deskphones Administrator Guide

Customizing 1600 Series IP Telephone Applications and Options

Table 17: 1600 Series IP Telephone Customizable System Parameters (continued)

Parameter Name Default Value Status Description and Value Range

Web Access Application Parameters:

SUBSCRIBELIST " " (Null)

TPSLIST " " (Null)

Optional Subscription list for potential pushed content. List of zero or more fully qualified URLs, separated by commas without intervening spaces, with up to 255 total characters.

Optional List of Trusted Push Servers. List of zero or more fully qualified domain/ path strings, separated by commas without intervening spaces, with up to 255 total characters. For more information, see the 9600 Series IP

Telephone Application Programmer

Interface (API) Guide (Document

Number 16-601442).

Backup/Restore Parameters

BRURI " " (Null) Mandator y

URL used for backup and retrieval of user data. Specify HTTP server and directory path to backup file. Do not specify backup file name. Value:

0-255 ASCII characters. Null is a valid value and spaces are allowed.

If this value is null or begins with a character sequence other than http:/

/ or https:// the Backup/Restore option will not display to the telephone user.

Backlight Parameters

BAKLIGHTOFF 120 Optional Number of idle minutes after which the backlight turns off (1-3 ASCII digits, from 0-999).

2 of 2

Issue 5 April 2010 113

Administering Applications and Options

The Application Status Flag (APPSTAT)

The 1600 Series IP Telephones offer the user numerous applications like Contacts, Call Log,

Redial, and so on. Each of these applications allows the user to add, delete, or in some cases, edit entries. You, as the administrator, might not want the user to have that level of functionality.

For example, a hotel lobby telephone probably should not allow a user to delete the concierge’s contact number. Further, for privacy reasons, that same telephone should not allow a Call Log display. You can use the Application Status Flag, APPSTAT, to administer specific application functionality permission levels for one or more telephones.

APPSTAT consists of one number, specifying a certain level of allowed functionality. A Zero (“0”) value is the most limiting setting. Values “2” and “3” allow increasing levels of functionality, and

“1” allows the user complete application functionality.

Table 18: Application Status Flags and Their Meaning

APPSTAT Value Meaning

0

1

2

3

Redial and Call Log are suppressed. Contact changes are not allowed.

All administered applications are displayed, with full functionality.

This is the default value.

Call Log is suppressed. Contact changes are not allowed. Only one-number Redial is allowed.

Contact changes are not allowed.

In Table 18 , “suppressed” applications are not displayed to the user. Softkey labels, application

tabs, and so on are not labeled or displayed. Options associated with suppressed applications can continue to display unless you override them by appropriate OPSTAT parameter administration. Displayed options have no effect while the application is suppressed.

In Table 18

, “Contact changes are not allowed” means the Contact application displays and the user can make calls as normal. Any controls that allow the user to change any aspect of the

Contact application do not display. This restriction includes the ability to add, delete, or edit any

Contact name or number.

In Table 18 , “Only one-number Redial is allowed” means the user Option that allows a choice

between displaying last numbers dialed is suppressed. The Redial buffer stores only one number. The Redial application does not display since the user can redial only one number.

This restriction allows privacy once a given user has left the telephone.

You can:

● set APPSTAT to 1, for example, in a staging area,

● administer a given telephone with Contact entries of your choice, like the Concierge

telephone number button in the earlier example,

● then move the telephone to where it will be used, where you have administered APPSTAT to be, for example, 0 (zero).

114 Avaya 1600 Series IP Deskphones Administrator Guide

Customizing 1600 Series IP Telephone Applications and Options

When the relocated telephone resets, it retains its Contact entries, like Concierge, but does not allow the user to create new entries.

When you set APPSTAT to any valid value other than 1, the telephone does not accept any

Contact button label changes that might have been made directly on a backup file. Only the existing labels of the telephone are used. This restriction prevents circumvention of the

APPSTAT restrictions.

Variable parameters for improving audio quality

Set the following parameters to improve the audio quality of the 46xx phones (4610/20/21/22/

25) using the script file variable.

The system downloads these variable names and their values from the script file at initialization, and then decodes and stores the variable names and their values in internal RAM memory

(volatile memory) for use by the audio software.

Table 19: Variable parameters for improving audio quality

Parameter Name Default Value Status Description and Value Range

AUDIOENV: The value associated with this script file variable (range of 0 to 299) controls the following four audio flags. The AUDIOENV value serves as an index into a table where the system extracts the flags for the four parameters. Each flag allows the audio code to set a PhonexChange register to a specific value to accomplish the required audio performance characteristic. If you set the AUDIONEV values outside the valid range or set non-numeric values, the system ignores these values and retains the default values for these parameters.

AGC_Dyn_Range 0 for +/-9dB

1 for +/-12 dB

2 for +/-15 dB

3 for +/-18 dB

0 for +/-9dB

This is the default setting (typical office environment). The system uses this setting if you do not specify any values or set any values in the script file.

1 of 8

Issue 5 April 2010 115

Administering Applications and Options

Parameter Name Default Value Status

NR_thresh_Hd 0 (6dB noise reduction) for a typical office environment

1 (15dB noise reduction) for call center applications

2 (24dB noise reduction) for

“other” audio environments

3 (0 dB noise reduction) for disabling the noise reduction algorithm altogether

4 (48dB noise reduction)

Description and Value Range

The transmit noise reduction threshold for the headset. These thresholds correspond to the maximum amount of noise reduction that is applied in the transmit path.

2 of 8

116 Avaya 1600 Series IP Deskphones Administrator Guide

Customizing 1600 Series IP Telephone Applications and Options

Parameter Name Default Value Status

NR_thresh_Hs 0 (6dB noise reduction) for a typical office environment

1 (15dB noise reduction) for call center applications

2 (24dB noise reduction) for

“other” audio environments

3 (0 dB noise reduction) for disabling the noise reduction algorithm altogether

4 (48dB noise reduction)

Description and Value Range

The transmit noise reduction threshold for the handset. The values are same as the headset noise reduction threshold.

Hd_Tx_Gain 0 for normal transmit gain

1 for +6dB

2 for -6dB

The transmit noise gain threshold for the headset.

3 of 8

Issue 5 April 2010 117

Administering Applications and Options

Parameter Name Default Value Status

EXP_slope_Hd 0 for a typical office environment

1 for call center applications

2 for other audio environments

3 for disabling the noise reduction algorithm altogether

Description and Value Range

The expander threshold for the headset.

These thresholds correspond to the maximum amount of expansion that is applied in the transmit path. These numbers define the slope of the expander curve.

Note:

Note:

When Noise

Reduction is enabled, you can use the same values from NR_thresh_Hd in

EXP_slope_Hd.They have analogous meanings. For example, the NR numbers refer to noise reduction thresholds while the

EXP numbers refer to the slope of the expander curve.

NR_thresh_Hd=3 means that there is no Noise Reduction and EXP_slope_Hd means that the slope is linear (Expander is off).

4 of 8

118 Avaya 1600 Series IP Deskphones Administrator Guide

Customizing 1600 Series IP Telephone Applications and Options

Parameter Name Default Value Status

EXP_slope_Hs 0 for a typical office environment

1 for call center applications

2 for other audio environments

3 for disabling the noise reduction algorithm altogether

Description and Value Range

The expander threshold for the handset. The values are same as the expander threshold for the headset.

5 of 8

Issue 5 April 2010 119

Administering Applications and Options

Parameter Name Default Value Status Description and Value Range

AUDIOSTHD: The value associated with this script file variable controls the side tone for the headset.

AUDIOSTHD

0 for default setting

1 for 3 steps below default

The system ignores values other the ones specified and retains the default values for

Sidetone_Gain_Hd.

2 for infinite loss or no sidetone

3 for one step below default

4 for 2 steps below default

5 for 4 steps below default

6 for 5 steps below default

7 for 6 steps below default

8 for 1 step above default

9 for 2 steps above default

6 of 8

120 Avaya 1600 Series IP Deskphones Administrator Guide

Customizing 1600 Series IP Telephone Applications and Options

Parameter Name Default Value Status Description and Value Range

AUDIOSTHS: The value associated with this script file variable controls the side tone for the handset.

AUDIOSTHS

0 for default setting

1 for 3 steps below default

The system ignores values other the ones specified and retains the default values for

Sidetone_Gain_Hs.

2 for infinite loss or no sidetone

3 for one step below default

4 for 2 steps below default

5 for 4 steps below default

6 for 5 steps below default

7 for 6 steps below default

8 for 1 step above default

9 for 2 steps above default.

7 of 8

Issue 5 April 2010 121

Administering Applications and Options

Parameter Name

EXPANENHS

EXPANENHD

Default Value Status Description and Value Range

If this system variable is 1, then the system changes the default noise-reduction algorithm operating in the transmit path, and uses an actual expander algorithm. If the value is 0 or not specified, then the system takes the normal noise-reduction algorithms.

If this system variable is 1, then the system changes the default noise-reduction algorithm operating in the transmit path changes, and uses an actual expander algorithm.

If the value is 0 or not specified, then the system takes the normal noise-reduction algorithms.

8 of 8

An example of the format for setting the script file variables is as follows:

SET AUDIOENV 14

SET AUDIOSTHD 1

SET AUDIOSTHS 2

122 Avaya 1600 Series IP Deskphones Administrator Guide