Cisco IP Phone Model 7902G, 7905G, and 7912G Administration Guide for Cisco CallManager Release 3.3 and later - Additional Configuration Methods, Parameters, and Procedures [Cisco Unified IP Phone 7900 Series]

Table Of Contents

Additional Configuration Methods, Parameters, and Procedures

TFTP Configuring

About Profile Files

Creating or Updating a Profile File

Profile File Conventions

Editing a Profile File and Converting it to Binary Format

Web Page Configuring

Device Information

Network Configuration

Network Statistics

Device Logs

Configuration Parameters

Network Parameters

Tone Parameters

Audio Parameters

Profile File Parameters

Specifying Firmware Upgrade Instructions for the Cisco IP Phone

Using the Interactive Voice Response (IVR) System on the Cisco IP Phone 7902G

IVR System Menu Codes

Entering Data in the IVR System

Navigating the IVR System

Changing the Logo on the Cisco IP Phone LCD Screen

Collecting Information for Troubleshooting

Additional Configuration Methods, Parameters, and Procedures

The Cisco IP Phone must be correctly configured before it will operate properly. When you configure a phone, you specify parameters and values that instruct the phone how to operate in your environment. Configuring provides the phone with instructions for many aspects of its operation, including how to interact with the network and how to handle IP telephony protocols.

In general, configuring the Cisco IP Phone models 7902G/7905G/7912G can be accomplished through Cisco CallManager and through the network configuration options on a phone. These processes are described in detail in this manual.

This appendix describes the following additional methods for configuring the Cisco IP Phone models 7902G/7905G/7912G. These methods are optional and are available to help you configure your phones most efficiently and to provide certain configuration options that are not available through other methods.

•Through a profile file—A profile file contains various parameters and values for phone and network settings. This file is stored on a Trivial File Transfer Protocol (TFTP) server and is downloaded to the phone.

•Through the phone's web page—Each phone has a web page from which you can view and update many parameter values.

•Through the phone's Interactive Voice Response (IVR) system (Cisco IP Phone 7902G only)

This section covers the following topics:

•TFTP Configuring

•Web Page Configuring

•Configuration Parameters

•Specifying Firmware Upgrade Instructions for the Cisco IP Phone

•Using the Interactive Voice Response (IVR) System on the Cisco IP Phone 7902G

•Changing the Logo on the Cisco IP Phone LCD Screen

•Collecting Information for Troubleshooting

TFTP Configuring

You can configure many parameters on the Cisco IP Phone models 7902G/7905G/7912G using a profile file stored on the TFTP server. A profile file is a binary file that contains a list of tag, length, and value triplets (TLVs) that represent some of the configuration parameters for the Cisco IP Phone. You can edit a text version of a profile file and then convert it to a binary file for the phone to download.

TFTP configuring works as follows:

1. The Cisco IP Phone 7902G will try to download from the TFTP server the profile file ffxxxxxxxxxxxx. The Cisco IP Phone model 7905G will try to download from the TFTP server the profile file ldxxxxxxxxxxxx. The Cisco IP Phone model 7912G will try to download from the TFTP server the profile file gkxxxxxxxxxxxx. In these file names, each xx is the two-digit lowercase hexadecimal representation of each integer in the phone's MAC address.

2. If the ffxxxxxxxxxxxx, ldxxxxxxxxxxxx, or gkxxxxxxxxxxxx profile file does not exist, the Cisco IP Phone 7902G will try to download the profile file ffdefault.cfg, the Cisco IP Phone 7905G will try to download profile file lddefault.cfg, and the Cisco IP Phone 7912G will try to download profile file gkdefault.cfg

The ffxxxxxxxxxxxx, ldxxxxxxxxxxxx, or gkxxxxxxxxxxxx profile file can be used to configure a particular Cisco IP Phone. The ffdefault.cfg, lddefault.cfg, or gkdefault.cfg profile file can be used to simultaneously configure multiple phones of the same model with the same information.

Related Topics

•About Profile Files

•Creating or Updating a Profile File

•Configuration Parameters

About Profile Files

The TFTP server stores the common profile file lddefault.cfg and each phone-specific profile file in binary format. The Cisco IP Phone 7902G profile file name is ffxxxxxxxxxxxx, where each xx is the two-digit lowercase hexadecimal representation of each integer in the phone's MAC address. The Cisco IP Phone models 7905G/7912G profile file name is ldxxxxxxxxxxxx, where each xx is the two-digit lowercase hexadecimal representation of each integer in the phone's MAC address. The file name must be exactly 14 characters. For example, if the MAC address is 0.1.45.2.10.20, the file name is ld00012d020a14.

Note Profile file names begin with "ld," which is a lowercase "L" followed by a lowercase "D."

You can edit a profile file in text format on the TFTP server and then convert it to the binary format required by the phone. See the "Creating or Updating a Profile File" section for more information.

Configuration parameters are entered in the format "Parameter:value." For example, the following entry specifies that the password for accessing a phone's web page or Network Configuration screen is 12345: UIPassword:12345. See the "Configuration Parameters" section for more information about parameters and values.

Use the file example_uprofile.txt as a template for creating the text version of your Cisco IP Phone profile files. You can obtain the latest version of this file from the CCO website. It is included with the SCCP Software Package Zip file.

Note A profile file for your phone may contain some parameters that are not described in this manual. These parameters are reserved for future use or are configured with factory default settings and should not be changed.

Related Topic

•Creating or Updating a Profile File

Creating or Updating a Profile File

Use the file example_uprofile.txt or an existing text profile file as a template for creating a text version of a Cisco IP Phone profile file.

Profile File Conventions

A text profile file must conform to the following conventions:

•The characters #txt must appear at the beginning of the first line of the file so that the formatting tool, cfgfmt.exe, will treat the file as a text file

•A pound sign (#) at the beginning of a line indicates a comment

•Parameter/value pairs are entered in the form parameter:value, where parameter is the exact name of the parameter and value is a valid value

•Each parameter/value pair must appear on a its own line

•All parameter/value pairs are optional, but the Cisco IP Phone Models 7902G and 7905G might not function properly if some values are missing.

•A parameter value is one of the following types:

–Alphanumeric string

–Numeric digit string

–Array of short integers

–IP address (for example, 192.168.2.170)

–Extended IP address—IP address with port (for example, 192.168.2.170.9001)

–Boolean (1 or 0)

–Bitmap—unsigned hexadecimal integer (for specifying bits in 32-bit integer)

–Integer (32-bit integer)

Editing a Profile File and Converting it to Binary Format

Before you can create a new binary profile file, you will need the cfgfmt.exe tool, which converts a text profile file to binary format.

The cfgfmt.exe tool requires a parameter tag file named ptag.dat. This file specifies the type and size of each parameter. It is recommended that you use the ptag.dat file provided by Cisco.

The cfgfmt.exe tool and the ptag.dat are bundled with the Cisco IP Phone software. You can also obtain them from the CCO website. They are included with the SCCP Software Package Zip file.

To create or update a profile file, follow these steps:

Procedure

Step 1 Use a text editor to open the text version of the profile file on the TFTP server.

Step 2 Make changes as needed to the profile file, and save it.

For a description of profile file parameters, see the "Configuration Parameters" section.

Step 3 Open a command window and type the following command to generate the binary profile file from the text file:
cfgfmt [-tpTagFile] input-text-file output-binary-file
where:

•pTagFile is an optional path to a folder containing the ptag.dat file. Specify this path if the ptag.dat file is not in the directory from which you are running the cfgfmt.exe tool.

•input-text-file is the name of the text version of the profile file.

•output-binary-file is the name of the binary file that the Cisco IP Phone uses as the TFTP configuration profile file. See the "About Profile Files" section for profile file name requirements.

Step 4 Put the binary file in the root directory on the TFTP server.

Web Page Configuring

You can display and configure device and network information for a Cisco IP Phone by accessing the phone's web page. You can access the web page using any graphically capable web browser.

Note It is recommended that you take care to prevent unauthorized access to a phone's web page. It is also recommended that you increase security by setting a password using the UIPassword parameter in the phone's profile file. For more information about this parameter, see Table A-4.

To access the web page for a Cisco IP Phone, perform the following steps.

If you want to edit parameters in the Network Parameters, Tone Parameters, or Audio Parameters areas, you must first set up a password with the UIPassword parameter in the profile file. If you do not set up a password, you will be able to view information in these areas, but you will not be able to change parameters, and Apply will not be available.

Procedure

Step 1 Open a web browser and enter the URL of the web page for the phone as follows:

http://<Cisco IP Phone IP address>

where Cisco IP Phone IP address is the IP address of the Cisco IP Phone.

On the Cisco IP Phone 7902G, you can determine the IP address through the IVR system, menu option 21. See the "Using the Interactive Voice Response (IVR) System on the Cisco IP Phone 7902G" section.

On the Cisco IP Phone 7905G, you can determine the IP address by pressing the Menu button, choosing Settings > Network Configuration, and then scrolling to IP Address.

For example, the configuration page for a Cisco IP Phone with the IP address 192.168.3.225 is:

http://192.168.3.225

Step 2 From the phone's web page, choose the hyperlink for the information that you want to display or configure:

•Device Information—Display only. For more information, see the "Device Information" section.

•Network Configuration—Display only. For more information, see the "Network Configuration" section.

•Network Statistics—Display only. For more information, see the "Network Statistics" section.

•Device Logs—Display only. For more information, see the "Device Logs" section.

•Network Parameters—Configurable parameters. For more information, see the "Network Parameters" section.

•Tone Parameters—Configurable parameters. For more information, see the "Tone Parameters" section.

•Audio Parameters—Configurable parameters. For more information, see the "Audio Parameters" section.

Step 3 If you selected Network Parameters, Tone Parameters, or Audio Parameters, follow these steps:

a. If you have set up a password with the UIPassword parameter in the profile file, enter the password in the UIPassword field, and then click Apply. (If you want to change the password, enter the new password in the two ChangeUIPassword fields before clicking Apply.)

b. Make changes to parameters in the Network Parameters, Tone Parameters, and Audio Parameters areas as needed and lick Apply to save your changes.

Step 4 Close your web browser.

Related Topics

•Device Information

•Network Configuration

•Network Statistics

•Device Logs

•Network Parameters

•Tone Parameters

•Audio Parameters

Device Information

The Device Information area of the Cisco IP Phone web page displays the following information about a phone:

•MAC address—Unique Media Access Control (MAC) address of the phone

•Host name—Unique host name assigned to the phone

•Phone DN—Directory number assigned to the phone

•App Load ID—Identifier of the firmware running on the phone

•Boot Load ID—Identifier of the factory-installed load running on the phone

•Software version—Version of the software running on the phone

•Hardware revision—Version of the phone hardware

•Serial number—Serial number of the phone

•Product ID—Product identifier of the phone

•Hardware features—Reserved for future use

•BTXML cards version—Version of the graphics card in the phone

Note You can access the Device Information area directly from a web browser by entering this URL: ip-address/DeviceInformation, where ip-address is the IP address of the phone.

Network Configuration

The Network Configuration area of the Cisco IP Phone web page displays the following information about a phone:

•DHCP server—If DHCP is enabled, the DHCP server that the pone contacts.

•BOOTP server—Not used.

•MAC address—Unique MAC address of the phone.

•Host name—Unique host name assigned to the phone.

•Domain name—If DHCP is enabled, Domain Name System (DNS) in which the phone resides.

•IP address—If DHCP is enabled, Internet protocol (IP) address of the phone.

•Default gateway—If DHCP is enabled, default gateway used by the phone.

•Subnet mask—If DHCP is enabled, subnet mask used by the phone.

•TFTP server 1—If DHCP is enabled, IP address of the primary TFTP server used by the phone.

•TFTP server 2—If DHCP is enabled, IP address of the alternate TFTP server used by the phone.

•DNS server 1—If DHCP is enabled, IP address of the primary DNS server used by the phone.

•DNS server 2—If DHCP is enabled, IP address of the alternate DNS server used by the phone.

•Operational VLAN ID—Auxiliary Virtual Local Area Network (VLAN) configured on a Cisco Catalyst switch in which the phone is a member. If the phone has not received an auxiliary VLAN, this field reflects the Administrative VLAN.

•CallManager 1 - 4—Prioritized list of Cisco CallManager systems that are available for processing calls from this phone. Possible states include:

–Active—Cisco CallManager server from which the phone is currently receiving call-processing services.

–Standby—Cisco CallManager server to which the phone switches if the current server goes down.

–Blank—No TCP connection to this Cisco CallManager server.

This field might also include the Survivable Remote Site Telephony (SRST) designation, indicating an SRST router that assumes control of call processing if all other Cisco CallManager servers are unreachable.

•DHCP enabled—1 if DHCP is enabled. 0 if not.

•DHCP address released—1 if the DCHP address is released. 0 if not.

Note You can access the Network Configuration area directly from a web browser by entering this URL: ip-address/NetworkConfiguration, where ip-address is the IP address of the phone.

Network Statistics

The Network Statistics area of the Cisco IP Phone web page displays the following information about a phone:

•Elapsed time—Time that has elapsed since the phone or Cisco CallManager was last reset

•Receive packets—Number of packets that the phone has received during the elapsed time

•Transmit packets—Number of packets that the phone has transmitted during the elapsed time

•Broadcast—Number of packets that the network has broadcast during the elapsed time

•Multicast—Number of multicast packets on the network during the elapsed time

•Receive errors—Number receive errors that the phone has experienced during the elapsed time

•Transmit errors—Number transmit errors that the phone has experienced during the elapsed time

•Receive overflow—Number packet overflows that the phone has experienced during the elapsed time

Note You can access the Network Statistics area directly from a web browser by entering this URL: ip-address/EthernetInformation, where ip-address is the IP address of the phone.

Device Logs

The Device Logs area of the Cisco IP Phone web page displays the name of the phone's profile file.

Note You can access the Device Logs area directly from a web browser by entering this URL: ip-address/DeviceLog, where ip-address is the IP address of your phone.

Configuration Parameters

This section provides information on the parameters that you can use to configure the Cisco IP Phone models 7902G/7905G/7912G through a profile file or through a phone's web page.

Note On the Cisco IP Phone 7902G, some of these parameters can also be configured through the IVR. See the "Using the Interactive Voice Response (IVR) System on the Cisco IP Phone 7902G" section.

These parameters are organized into the following categories:

•Network parameters—Control various network-related activities of the phone. See the "Network Parameters" section.

•Tone parameters—Control how the phone handles the various tones that it plays, and related options. See the "Tone Parameters" section.

•Audio parameters—Control how the phone handles various audio-related activities. See the "Audio Parameters" section.

•Profile file parameters—Parameters that are available only from the phone's profile file. See the "Profile File Parameters" section.

Network Parameters

Table A-1 describes the network parameters that you can configure through a phone's profile file or through its Network Parameters web page.

Table A-1 Network Parameters

Parameter

Description

Usage

TftpServer1

IP address of the primary TFTP server from which the Cisco IP Phone should download the .cnf or .cnf.xml file and the profile file.

Alphanumeric string up to 31 characters.

If specified, this TFTP server is used instead of the primary TFTP server provided by the DHCP server. If 0 is specified, the primary TFTP server provided by the DHCP server is used.

The default setting is 0.

Note Do not specify a port number. The Cisco IP Phone always contacts the TFTP server at port 69.

TftpServer2

IP address of the secondary TFTP server from which the Cisco IP Phone should download the .cnf or .cnf.xml file and the profile file.

Alphanumeric string up to 31 characters.

If specified, this TFTP server is used instead of the secondary TFTP server provided by the DHCP server. If 0 is specified, the alternate TFTP server provided by the DHCP server is used.

The default setting is 0.

Note Do not specify a port number. The Cisco IP Phone always contacts the TFTP server at port 69.

Dhcp

Specifies whether the phone contacts the DHCP server to obtain values for various network parameters, including IP address, router IP address, and subnet mask.

Set to 0 (disable) if you are not using a DHCP server.

Set to 1 (enable) if you are using a DHCP server.

The default setting is 1.

StaticIP

Static IP address of the phone when DHCP is not used.

Enter the assigned IP address for the phone.

This value is ignored when the Dhcp parameter is enabled.

StaticRoute

Static IP address of the network router when DHCP is not used.

Enter the assigned IP address of the network router.

This value is ignored when the Dhcp parameter is enabled.

StaticNetMask

Static subnet mask of the phone when DHCP is not used.

Enter the subnet mask for the phone.

This value is ignored when the Dhcp parameter is enabled.

Domain

Domain name on the network in which the phone operates, used in the creation of the endpoint identifier.

Alphanumeric string up to 31 characters.

For example, if the name of the endpoint is aaln1 and the domain is cisco.com, the endpoint identifier is aaln1@cisco.com.

•0—Use the DHCP-provided domain name if available; otherwise use the static IP address.

•string—Use the specified domain name string and overwrite any DHCP-provided domain name.

The default setting is 0.

DnsServer1

IP address of the primary DNS server.

The address specified overwrites the primary DNS server address supplied by DHCP. Set 0 or 0.0.0.0 if you want the phone to use the address supplied by DHCP.

The default setting is 0.

Note Do not specify a port number. The Cisco IP Phone uses the default DNS port.

DnsServer2

IP address of the secondary DNS server.

The address specified overwrites the secondary DNS server address supplied by DHCP. Set 0 or 0.0.0.0 if you want the phone to use the address supplied by DHCP.

The default setting is 0.

Note Do not specify a port number. The Cisco IP Phone uses the default DNS port.

OpFlags

Enables or disables various features on the phone.

Bit map, as follows:

•Bit 0 (mask 0x1)—If 1, ignore the DHCP-assigned TFTP file name and use the following file name when using TFTP for configuring: ffxxxxxxxxxxxx (Cisco IP Phone 7902G) or ldxxxxxxxxxxxx (Cisco IP Phone models 7905G/7912G), where each xx is the two-digit lowercase hexadecimal representation of each integer in the phone's MAC address.

•Bit 1 (mask 0x2)—If the phone is configured to use static IP (that is, the router and gateway addresses are statically assigned), set to 1 to prevent probing at boot time. Otherwise, the phone probes the route/gateway address to determine if there is network connectivity.

•Bit 2—Reserved for future use.

•Bit 3 (mask 0x8)—If 1, do not request DHCP option 150 in the DHCP DISCOVERY message.

•Bit 4 (mask 0x10)—If 1, assume operation under VLAN. (The VLAN ID is specified in the VLANSetting parameter.)

•Bit 5 (mask 0x20)—If 1, turn off VLAN IP encapsulation.

•Bit 6 (mask 0x40)—If 1, do not perform CDP¹ discovery.

•Bit 7 (mask 0x80)—If 1, do not allow web configuration of the phone.

•Bit 8 (mask 0x100)—Not used on the Cisco IP Phone 7905G. On the Cisco IP Phone 7902G, if set to 1, the IP address cannot be refreshed through an HTTP request.

OpFlags con't.

•Bit 9 (mask 0x200)—Not used on the Cisco IP Phone 7905G. On the Cisco IP Phone 7902G, if set to 1, the IP address cannot be reset through an HTTP request.

The default value is 0x00000002.

VLANSetting

Specifies various VLAN settings.

Bit map, as follows:

•Bits 0-2 (mask 0x7)—Designate 802.1Q priority for signalling IP packets.

•Bits 3-5 (mask 0x38)—Designates 802.1Q priority for audio voice IP packets.

•Bits 6-17 (mask 0x3ffc0)—Reserved for future use.

•Bits 18-29 (mask 0x3ffc0000)—User-specified 802.1Q VLAN id.

•Bits 30-31 (mask 0xc0000000)—Reserved for future use.

The default setting is 0x0000002b.

Nprintf

IP address and port of a server to which Cisco IP Phone troubleshooting messages are sent.

Enter the extended IP address of the server to which troubleshooting messages are sent and collected in a log file.

The default value is 0, which specifies that no messages are sent.

Note To collect troubleshooting messages, the prserv.exe tool must be running on the server specified with this parameter.

For more information about using Nprintf and preserv.exe to collect troubleshooting information, see the "Collecting Information for Troubleshooting" section.

TraceFlags

Enables specific trace features.

Bit map

Bit 0-31—Reserved for future use.

Should be set to zero (0). The default setting is 0x00000000.

¹CDP = Cisco Discovery Protocol

Tone Parameters

Table A-2 describes the tone parameters that you can configure through a phone's profile file or through its Tone Parameters web page.

Table A-2 Tone Parameters

Parameter

Description

Usage

SigTimer

Timeout values for signaling events.

Bit map, as follows:

Bits 0 - 7—Interval between each call-waiting tone. The range is 0 to 255. The setting 0 specifies the factory default. Any other number specifies the interval in 0.1 second increments. The default setting is 100 (0x64, 10 seconds).

Bits 8 - 27—Reserved for future use. Should be set to 0.

Bits 28 - 29—First repeat interval for the Volume and Navigation buttons. That is, the button takes effect the first time a user presses and holds down the button for the interval specified. The range is 0 to 3 (0 = one second; 2 = two seconds; 3 = three seconds; 1 disables the Volume and Navigation button repeat interval). The default value is 0.

Bits 30 - 31—Subsequent repeat interval for the Volume and Navigation buttons. For example, the volume increases or decreases when a user continues to hold down the Volume button for the interval specified. The range is 0 to 1 (0=0.25 seconds; 1 = 0.50 seconds; 2=0.75 seconds; 3 = one second). The default value is 0.

RingCadence

Ringer cadence pattern.

Three comma-separated integers, a,b,c, where:

•a—Number of seconds to wait before turning the ring on.

•b—Number of seconds to wait before turning the ring off.

•c—Ring frequency.

The default value is 2,4,25.

Note The ring frequency portion of this parameter is currently not enabled and must be set to 25.

DialTone

Not used because Cisco CallManager provides a tone configuration file to the phone.

—

BusyTone

Not used because Cisco CallManager provides a tone configuration file to the phone.

—

ReorderTone

Not used because Cisco CallManager provides a tone configuration file to the phone.

—

RingBackTone

Not used because Cisco CallManager provides a tone configuration file to the phone.

—

CallWaitTone

Tone that alerts a user on a call that there is an incoming call.

Comma-separated string of nine integers, a through i. See the DialTone parameter for a description of these integers.

Note For this parameter, the value for total duration of tone specifies the number of samples at 8,000 samples per second.

The default value is 1,30831,0,5493,0,0,2400,2400,4800.

ConfirmTone

Tone that confirms successful completion of an operation such as call forwarding.

Comma-separated string of nine integers, a through i. See the DialTone parameter for a description of these integers.

Note For this parameter, the value for total duration of tone specifies the number of samples at 8,000 samples per second.

The default value is 1,30467,0,5970,0,0,480,480,1920.

Audio Parameters

Table A-3 describes the network parameters that you can configure through a phone's profile file or through its Audio Parameters web page.

Table A-3 Audio Parameters

Parameter

Description

Usage

AudioMode

Allows control of audio-related functions.

Bit map, as follows:

•Bit 0 (mask 0x1)—If 0, disable G.711 or G.729 silence suppression. If 1, enable G.711 or G.729 silence suppression. The default setting is 1

•Bit 1 (mask 0x2)—If 0, use G.711 codec only; do not use low-bit-rate codec. If 1, use both G.711 and low-bit-rate codec.

•Bits 2-3 (mask 0x4)—Reserved for future use.

•Bits 4-5 (mask 0x30): DTMF transmission method:

–0—Always in-band.

–1—By negotiation.

–2—Always out-of-band.

–3—Neither in-band nor out-of-band.

•Bits 6-31—Reserved for future use.

ConnectMode

Connection mode of the protocol used by the Cisco IP Phone.

Bit map, as follows:

•Bit 0-29—Reserved for future use. Must be set to 0.

•Bit 30 (mask 0x40000000)—If 1, enable Cisco IOS Telephony Solution (ITS) support to handle the differences between Cisco CallManager and Cisco ITS. Cisco ITS runs on an IOS router and is a subset of Cisco CallManager. If you have Cisco ITS, refer to the documentation for that product.

•Bit 31 (mask 0x80000000)—If 1, enable downloading and processing of .cnf.xml configuration file information sent by Cisco CallManager.

NumTxFrames

Not used.

UDPTOS

UDP¹ IP ToS². Determines the precedence and delay of sent IP packets.

Bit map value.

Use only the lower 8 bits. Upper bits should be set to 0.

The default setting is 0xB8.

MediaPort

Port number where the Cisco IP Phone sends and receives RTP streams.

Enter an even number from 0 to 65535. Each connection uses the next available even-numbered port for RTP.

If set to 0, use the default value.

The default setting is 16384.

¹UDP = User Datagram Protocol

²ToS = type of service

Profile File Parameters

Table A-4 describes the parameters that you can configure through a phone's profile file only.

Table A-4 Profile File Parameters

Parameter

Description

Usage

UIPassword

Password for accessing the phone's Change Configuration web pages or to unlock the phone's Network Configuration screen for editing.

Alphanumeric string up to nine characters.

If set to 0, no password is required.

After a password is set with this parameter, the password can be changed from the phone's web page. For more information, see the "Web Page Configuring" section.

Note Changing a password from the phone's web page does not change the password in the profile file. If the phone downloads the profile file, the password will be reset as specified in the profile file.

upgradecode

Provides information for upgrading the firmware on the phone.

See the "Specifying Firmware Upgrade Instructions for the Cisco IP Phone" section.

upgradelogo

Allows you to specify the graphic that appears on the phone's LCD screen.

See the "Changing the Logo on the Cisco IP Phone LCD Screen" section.

Specifying Firmware Upgrade Instructions for the Cisco IP Phone

You can use the upgradecode parameter in a profile file to provide special upgrade instructions to the Cisco IP Phone models 7902G/7905G/7912G. To provide upgrade instructions in this way, add the following line to the Cisco IP Phone profile file:
upgradecode:3,type,0x0400,0x0100,tftp_server_ip,69,image_id, 
image_file_name
where:

•type is 0x401 for the Cisco IP Phone 7902G, 0x501 for the Cisco IP Phone 7905G, or 0x601 for the Cisco IP Phone 7912G.

•tftp_server_ip is the IP address of the TFTP server on which the firmware upgrade image is stored. Enter 0 to use the TFTP server specified by the TFTPServer1 parameter or by DHCP.

•image_id is a unique 32-bit integer value. This value must be different for each upgrade. For this value, it is convenient to use 0x followed by the build date on the image file name. (For example, if the image file name is CP79050101SCCP030323A.ZUP, then the build date is 30323A, and image_id would be 0x30323A.)

•image_file_name is the file name of the firmware upgrade image.

Using the Interactive Voice Response (IVR) System on the Cisco IP Phone 7902G

The IVR system on your Cisco IP Phone 7902G lets you verify or change settings on your phone. You can access the IVR system through the Menu button on your phone.

IVR System Menu Codes

The following table lists the IVR menu codes. Use these codes when you navigate the IVR system using your keypad. The codes of settings that you will probably use most often are numbers 1, 2, 10, 20, 21, 22, 23, 24, and 905.

Menu Code

Description

1

Sets the static IP address

2

Sets the static route address

10

Sets the subnet mask

20

Enables or disables DHCP

21

Reviews the IP address

22

Reviews the route address

23

Reviews the subnet mask

24

Reviews the MAC address

35

Sets the frame-per-packet

81

Sets the nprintf IP address and port

202

Sets the media port number

255

Sets the UDPTOS parameter

311

Sets the connect mode

312

Sets the audio mode

313

Sets the trace flags

318

Sets the SigTimer

323

Sets operational flags

324

Sets VLAN settings

905

Sets the TFTP Server 1

916

Sets the DNS Server 1

917

Sets the DNS Server 2

920

Sets the dial tone

921

Sets the busy tone

922

Sets the reorder tone

923

Sets the ring back tone

924

Sets the call waiting tone

925

Sets the confirmation tone

929

Sets the ring cadence

931

Sets the domain name

935

Sets the TFTP Server 2

4444

Performs a DHCP release

7387277

Sets the UI password

322873738

Resets the phone to the factory default settings

For more information about these settings, see the "Configuration Parameters" section.

Entering Data in the IVR System

You can enter both numeric and alphanumeric data in the IVR system.

Entering Numeric Data

Numeric input includes numbers from 0-9, and may include periods (.). For example, to enter an IP address, use the dial pad to enter the numbers and use the * to enter periods (.), followed by the # sign to complete your input.

Entering Alphanumeric Data

Alphanumeric input includes numbers from 0-9, alphabetic characters, both uppercase and lowercase, and symbols. When entering alphanumeric input, use the dial pad and press a number key the appropriate number of times to access the correct letter, number, or symbol you need, followed by the # sign, and another # sign to complete your input. See the following table as a guide.

Dial Pad#

Alphanumeric Characters

0

0

1

1 . /_\ @ * space return + - ! , ? | ~ ^ # = $ " ' ` % < > [ ] : ;
{ } ( ) &

2

2 a b c A B C

3

3 d e f D E F

4

4 g h i G H I

5

5 j k l J K L

6

6 m n o M N O

7

7 p q r s P Q R S

8

8 t u v T U V

9

9 w x y z W X Y Z

Examples

To enter 44_A, press the following keys:

4 # 4 # 1 1 1 1 # 2 2 2 2 2 # #

To change the UI Password (menu code 7387277) to 7902, press the following keys:

7 # 9 # 0 # 2 # #

Special Characters

When you enter data in the IVR using the dial pad, the IVR announces your input back to you after each pressed key. For example, if you press the 4 key once, the IVR announces "4". If you press the 4 key twice, the IVR announces "g". However, for special characters represented by the 1 key (except l, ., *), the IVR announces "x" plus the hexadecimal value of the ASCII character. For example, when pressing the 1 key for a / (slash) character, the IVR announces "x2f"; for a + character, the IVR announces "x2b". See the following table, which provides the hexadecimal values for special characters.

Alphanumeric Character
via the 1 Key

Hexadecimal Value Announced
by the IVR

/

x2f

_

x5f

\

x5c

@

x40

space

x20

return

x0a

+

x2b

-

x2d

!

x21

,

x2c

?

x3f

|

x7c

~

x7e

^

x5e

#

x23

=

x3d

$

x24

"

x22

'

x27

`

x60

%

x25

<

x3c

>

x3e

[

x5b

]

x5d

:

x3a

;

x3b

{

x7b

}

x7d

(

x28

)

x29

&

x26

Navigating the IVR System

To enter the IVR menu, follow these steps:

Procedure

Step 1 Lift the handset, then press and hold the Menu button for about 3 seconds.

Step 2 The IVR system plays the following prompts:

•Press 1 # to configure IP

•Press 2 # to configure route

•Press 10 # to configure subnet mask

•Press 20 # to configure DHCP

•Press # to go to the extended menu

Step 3 Enter the voice menu code for the setting that you want to verify or change, and then press #.

Note Use the * key to toggle between alphanumeric and numeric input mode. For example, when you enter 905 #, the IVR prompts you for alphanumeric input. When you enter 905 * #, the IVR prompts you for numeric data.

Step 4 Follow the prompts and enter the appropriate values.

Step 5 The IVR repeats the value you entered, then prompts you to press one of the following keys:

•1=Change your entered value

•2=Review your entered value

•3=Save your entered value

•4=Review the current saved value

Step 6 Hang up the phone. The phone resets.

Changing the Logo on the Cisco IP Phone LCD Screen

Note This section does not apply to the Cisco IP Phone 7902G.

When the Cisco IP Phone models 7905G and 7912G are not in use for a call, a graphic appears on the LCD screen. Using TFTP configuring, you can change this graphic to one that you provide. For example, you might change the graphic to your company logo.

Before you can change the graphic on the phone, you must use a graphics program to create an image with the following attributes:

•Width of 88 pixels.

•Height of 27 pixels.

•Monochrome (black-and-white).

•Saved as bitmap file with the extension .bmp. For example, mylogo.bmp.

In addition, you will need the bmp2logo.exe tool, which converts your bitmap image file to a .logo file that can be downloaded to the phone. This tool is bundled with the Cisco IP Phone software. You can also obtain it from the CCO website at the following URL. It is included with the SCCP Software Package Zip file.

http://www.cisco.com/cgi-bin/tablebuild.pl/ip_phone_client

To change the graphic that appears on a Cisco IP Phone, follow these steps:

Procedure

Step 1 Open a command window and type the following command:
bmp2logo imageID image.bmp image.logo
where:

•imageID is a unique identifier for the new graphic. This identifier must be a number from 0 through 4294967296 and must be different than the identifier of the graphic that is currently on the phone.

•image is the base file name of the image that you previously created and saved with the graphics program.

Note The imageID of the image that comes with the phone is 1.

For example, if the image identifier is 10 and the base name of your image file is mylogo, type this command:
bmp2logo 10 mylogo.bmp mylogo.logo
Step 2 Copy the image.logo file to the TFTPPATH directory on the TFTP server.

Step 3 Add the following line to the Cisco IP Phone profile file.

Note For detailed information about using profile files, see the "TFTP Configuring" section.
upgradelogo:imageID,TFTPServerID,image.logo
where:

•imageID is the same unique identifier that you specified in Step 1.

•TFTPServerID is the IP address of the TFTP server on which the image.logo file is stored. If the image.logo file is stored on the same TFTP server as the Cisco IP Phone configuration file, replace TFTPServerID with the numeral 0.

•image is the base file name of the image file.

For example, if the image identifier is 10, the converted file is stored on the same TFTP server as the Cisco IP Phone configuration file, and the base name of the converted image file is mylogo, add the following line to the configuration file:
upgradelogo:10,0,mylogo.logo
Step 4 Use the cfgfmt.exe tool to generate a binary profile file from the text file.

Put the binary file in these locations:

•The root directory on the TFTP server (C:\Program Files\cisco\tftppath)

•The network locale directories on the TFTP server for each language that is supported by Cisco CallManager.

The default network locale directory on the TFTP server is C:\Program Files\ cisco\tftppath\United_States.

Note For detailed information about using the cfgfmt.exe tool, see the "Editing a Profile File and Converting it to Binary Format" section.

Step 5 Power cycle the phone.

The new graphic appears when the phone restarts.

Collecting Information for Troubleshooting

You can collect information relating to the operations of the Cisco IP Phone models 7902G/7905G/7912G and store this information in a log file on a server that you specify. If you experience a problem with a phone, this information can be useful for troubleshooting.

To collect information for troubleshooting, you will need the nprintf.exe tool. This tool is bundled with the Cisco IP Phone software. You can also obtain this tool from the CCO website. It is included with the SCCP Software Package Zip file.

To collect troubleshooting information in a log file, follow these steps:

Step 1 Add the following line to the Cisco IP Phone profile file:
Nprintf:IPaddress.listen_port
where:

•IPaddress is the IP address of the server to which information will be sent.

•listen_port is the port to which information is sent on the server specified.

For example, if you want to send information port 9001 on a server with an IP address of 192.168.2.170, set the Nprintf parameter to 192.168.2.170.9001.

Note If you set this parameter to 0 or to 0.0.0.0.0, no information will be sent from the phone.

Step 2 On the server that will receive information, open a command window and type the following command:
prserv [listen-port]
where listen_port is the same port that you specified with the Nprintf parameter.

If you do not specify a port, 9001 is used by default.

While pserv is running, information from the Cisco IP Phone is sent to a file named listen-port.log, where listen-port is the port you specified with the Nprintf parameter and the prserv command. This file is stored on the server you specified with the Nprintf parameter in the folder from which you ran the preserv command. If the file exists, new information is appended to it.

You can open a listen-port.log file using a text editor.

Step 3 To exit prserv.exe and stop collecting information, press Ctrl-C in the command window.

Note If you want to collect information from more than one Cisco IP Phone, it is recommended that you store information in a separate listen-port.log file for each phone. If you store all information in a single file, it can be difficult to identify which messages belong to which phones. To generate separate listen-port.log files, configure each phone using its own profile file or web page. For each phone, use the Nprintf parameter in the profile file or web pate to specify a unique port number on the server to which information will be sent. Then, run prserv.exe multiple times, once for each phone from which you want to collect information. Run each instance of preserv.exe in its own command window. For each instance, make sure to specify a port number that corresponds to a port number in a Nprintf parameter.