7940/7960 sip configuration settings
This page is under heavy construction!!
I've been asked many times just what is available to be placed in a 'sip'
configuration file and what items can be changed on a phone.
Before we show the list, let's get a few things out of on the table first.
'sip' only. We'll only address the options available with the 'sip' protocol
on this page. And we're using sip ver. 8.x for our 'source of info'. We all know
(hopefully) that you can have only one protocol (sip, sccp, or mgcp) loaded on the
phone at any one time. But some of the settings for these protocols (i.e. 'Network')
are much the same for all. If you're not using 'sip', you're free to read along but
we can't guarantee this will help much.
Let's look at the above and work backwards. Some items on the phone can be
changed by the user without "unlocking" the phone. These are "user settings".
Many items (Network & Sip settings, etc) can be changed on the phone if it is
"unlocked". Lastly, some items must only be changed using a configuration
file loaded into the phone via TFTP server when the phone boots.
Gotch'a #1 - In some cases, if a particular setting you could set on
the phone existed, if you make a 'special' change via a 'config' file that option
is no longer available on the phone.
Loading config files. When the 'sip' phone boots and contacts the TFTP
server, it asks for two config files in order. They are "SIPDefault.cnf" and
SIP[mac address].cnf - Either of these files can contain any of the
configuration items we discuss below.
Gotch'a #2 - Previously stated, you put the sip configuration 'items' in
ither 'SIPDefault.cnf' -or- 'SIP[mac address].cnf', either will work.
- but - Please remember that "SIPDefault.cnf" loads first and "SIP[mac address].cnf
loads second. If you have anything in the "SIP[mac address].cnf" that differ from
anything in "SIPDefault.cnf", the ones in "SIP[mac address].cnf" will be the ones
the phone uses. - To keep confusion down, it's best to ONLY put "phone specific"
items in "SIP[mac address].cnf".
Finally - You don't have to put ALL the settings we list in your config
file(s). If the phone doesn't see a particular setting, it will revert to whatever is
stored in its flash memory.
Cisco 7940/7960 Configuration
OptionsParameters are in alphabetical order although they can be entered
in any order in your SIPDefault.cnf or SIP[mac address].cnf file. |
Parameter |
Type |
Importance |
User setting (w/o unlock)? |
Phone setting (w/ unlock)? |
Factory default |
anonymous_call_block |
user option (under "Call Preferences") |
optional |
yes |
yes |
'0' - NO - but see explanation |
auto_answer |
user option (under "Call Preferences") |
optional |
yes |
yes |
'Intercom' - see explanation |
autocomplete |
user option (under "Call Preferences") |
optional |
yes |
yes |
'1'- "Yes" - but see explanation |
call_hold_ringback |
user option (under "Call Preferences") |
optional |
yes |
yes |
'0'- "No" - but see explanation |
call_managerx_addr - Reserved by Cisco. |
call_managerx_sip_port - Reserved Cisco. |
call_stats |
Sip setting |
optional |
no |
yes |
'0' - Disabled |
call_waiting |
user option (under "Call Preferences") |
optional |
yes |
yes |
'0' - Disabled - but see explanation |
callerid_blocking |
user option (under "Call Preferences") |
optional |
yes |
yes |
'0' - Disabled - but see explanation |
cfwd_url |
user option (under "Call Preferences"?) |
optional |
? |
? |
'null' - but see explanation |
cnf_join_enable |
user option (under "Call Preferences"?) |
optional |
? |
? |
'1' - Enabled - but see explanation |
connection_manager_duration - Reserved by Cisco. |
date_format |
user option (under "Localization") |
optional |
yes |
yes |
'M/D/Y' |
dial_template |
? |
optional? |
? |
? |
null - see description |
directory_url |
? |
optional? |
? |
? |
null - see description |
dnd_control |
user option (under "Call Preferences") |
optional |
yes |
yes |
'0' - Off |
Domain Name |
"Network Config" option |
optional |
no |
yes - if not using DHCP |
'null' - See description |
dscpForAudio |
"Sip Config" option? |
prob need something? |
? |
? |
'184' - See description |
We have so many parameters regarding daylight
savings time, we've grouped them together. |
Parameter |
Type |
Importance |
User setting (w/o unlock)? |
Phone setting (w/ unlock)? |
Factory default |
dst_auto_adjust |
"SNTP Config" option |
optional |
no |
yes |
'1' - Adjust |
dst_auto_adjust |
"SNTP Config" option |
optional |
no |
yes |
'1' - Adjust |
dst_offset |
SNTP parameter for config file |
optional |
no |
no |
'02:00' - (guessing?) |
dst_start_day |
SNTP parameter for config file |
optional |
no |
no |
'0' - See Description |
dst_start_day_of_week |
SNTP parameter for config file |
optional |
no |
no |
'Sunday' - See Description |
dst_start_month |
SNTP parameter for config file |
optional |
no |
no |
'April' - See Description |
dst_start_time |
SNTP parameter for config file |
optional |
no |
no |
'02:00' - See Description |
dst_start_week_of_month |
SNTP parameter for config file |
optional |
no |
no |
'1' - See Description |
dst_stop_day |
SNTP parameter for config file |
optional |
no |
no |
'0' - See Description |
dst_stop_day_of_week |
SNTP parameter for config file |
optional |
no |
no |
'Sunday' - See Description |
dst_stop_month |
SNTP parameter for config file |
optional |
no |
no |
'October' - See Description |
dst_stop_time |
SNTP parameter for config file |
optional |
no |
no |
'02:00' - See Description |
dst_stop_week_of_month |
SNTP parameter for config file |
optional |
no |
no |
'8' - See Description |
Whew! - Finished with the DST stuff. - Continuing...
|
Parameter |
Type |
Importance |
User setting (w/o unlock)? |
Phone setting (w/ unlock)? |
Factory default |
dtmf_avt_payload |
SIP parameter for config file |
optional |
no |
no |
'101' - See Description |
dtmf_db_level |
SIP parameter for config file |
optional |
no |
no |
'3' - See Description |
dtmf_inband - Obsolete. |
dtmf_outofband |
"SIP Settings" config item |
optional |
no |
yes |
'avt' - See Description |
dyn_dns_addr_1 |
Network config item for file? |
optional |
no |
no? |
varies - See Description |
dyn_dns_addr_2 |
Network config item for file? |
optional |
no |
no? |
varies - See Description |
dyn_tftp_addr |
Network config item for file? |
optional |
no |
no? |
varies - See Description |
enable_vad |
"SIP config" item |
optional |
no |
yes |
'0' - disabled |
encrypt_key - Reserved by Cisco. |
end_media_port |
"SIP config" item |
optional |
no |
yes |
'323766' |
garp_enable |
"Network config" item |
optional |
no |
yes |
'1' - enabled |
Host Name |
"Network config" item |
required |
no |
no |
'SIPmac' - See Description |
http_proxy_addr |
"Network config" item |
optional |
no |
yes |
'null' - See Description |
http_proxy_port |
"Network config" item |
optional |
no |
yes |
'80' |
image_version |
"Network/SIP config" item? |
?? |
?? |
?? |
?? - See Description |
language - Reserved for future use. - Presently only
'English' is supported. |
linex_authname |
"SIP config" item |
optional |
no |
yes |
'UNPROVISIONED' - See Description |
linex_contact |
"SIP config" item? |
optional |
? |
? |
'null' - See Description |
linex_displayname |
"SIP config" item |
optional |
no |
yes |
'null' - See Description |
linex_name |
"SIP config" item |
optional |
no |
yes |
'null' - See Description |
linex_password |
"SIP config" item |
optional |
no |
yes |
'UNPROVISIONED' - See Description |
linex_shortname |
"SIP config" item |
optional |
no |
yes |
'null' - See Description |
local_cfwd_ennable |
SIP item for config file |
optional |
no |
no |
'1' - Enabled |
logo_url |
"Network Config" item |
optional |
no |
no |
'null' - See Description!! |
Parameter |
Type |
Importance |
User setting (w/o unlock)? |
Phone setting (w/ unlock)? |
Factory default |
messages_uri |
Network item for config file |
optional |
no |
no |
See Description |
mwi_status |
"Network/Sip" Config item? |
optional? |
? |
? |
See Description |
nat_address |
"Sip Config" item |
optional |
no |
yes |
'null' - See Description |
nat_enable |
"Sip Config" item |
optional |
no |
yes |
'0' - Disabled |
nat_received_processing |
Sip item for config file |
optional |
no |
no |
'0' - Disabled |
network_media_type |
"Network Config" item |
optional |
no |
yes |
'auto' |
network_port2_type |
"Network Config" item |
optional |
no |
yes |
'Hub/Switch' |
outbound_proxy |
"SIP Config" item |
optional |
no |
yes |
'null' |
outbound_proxy_port |
"SIP Config" item |
optional |
no |
yes |
'5060' |
phone_label |
SIP Config item for file |
optional |
no |
no |
'null' |
phone_password |
SIP Config item for file |
optional |
no |
no |
'cisco' - See Description!! |
phone_prompt |
SIP Config item for file |
optional |
no |
no |
'null' |
preferred_codec |
"SIP Config" item |
optional |
no |
yes |
'g711ulaw' |
proxy_backup |
"SIP Config" item |
optional |
no |
yes |
'null' |
proxy_backup_port |
"SIP Config" item |
optional |
no |
yes |
'5060' |
proxy_emergency |
"SIP Config" item |
optional |
no |
yes |
'null' |
proxy_emergency_port |
"SIP Config" item |
optional |
no |
yes |
'5060' |
proxy_register |
"SIP Config" item |
optional |
no |
yes |
'0' - disabled |
proxyx_address |
"SIP Config" item |
optional |
no |
yes |
'null' |
proxyx_port |
"SIP Config" item |
optional |
no |
yes |
'5060' |
remote_party_id |
SIP Config item for file? |
optional |
no? |
no? |
'0' - disabled |
rfc_2543_hold |
SIP Config item for file? |
optional |
no? |
no? |
'0' |
semi_attended_transfer |
SIP Config item for file? |
optional |
no? |
no? |
'1' |
services_url |
SIP Config item for file? |
optional |
no |
no |
'??' |
sip_invite_retx |
SIP Config item for file |
optional |
no |
no |
'6' |
sip_max_forwards |
SIP Config item for file |
optional |
no |
no |
'70' |
Parameter |
Type |
Importance |
User setting (w/o unlock)? |
Phone setting (w/ unlock)? |
Factory default |
sip_retx |
SIP Config item for file |
optional |
no |
no |
'10' |
sntp_mode |
SIP Config item for file |
optional |
no |
no |
'anycast' |
sntp_server |
SIP Config item for file |
optional |
no |
no |
'null' |
speed_labelx |
"Localization Config" item |
optional |
yes |
yes |
'null' |
speed_linex |
"Localization Config" item |
optional |
yes |
yes |
'null' |
start_media_port |
Sip Config item for file |
optional |
no |
no |
'16384' |
stutter_msg_waiting |
"Localization Config" item |
optional |
no |
yes |
'0' - off |
sync |
Sip Config item for file |
optional |
no |
no |
'??' - See Description |
telnet_level |
Network Config item for file |
optional |
no |
no |
'0' - Disabled |
tftp_cfg_dir |
Network Config item for file |
optional |
no |
no |
'null' |
time_format_24hr |
"Localization Config" item |
optional |
yes |
yes |
'1' |
time_zone |
"Localization Config" item |
optional |
no |
yes |
'PST' |
timer_invite_expires |
SIP Config file item |
optional |
no |
no |
'180' |
timer_keepalive_expires - Reserved by Cisco |
timer_register_delta |
SIP Config file item |
optional |
no |
no |
'5' |
timer_register_expires |
SIP Config file item |
optional |
no |
no |
'3600' |
timer_t1 |
SIP Config file item |
optional |
no |
no |
'500' |
timer_t2 |
SIP Config file item |
optional |
no |
no |
'4000' |
tos_media - Obsolete |
transfer_on_hook_enabled |
SIP Config file item |
optional |
no |
no |
'0' - Disabled |
user_info |
SIP Config file item |
optional |
no |
no |
'none' |
version_stamp |
SIP Config file item |
optional |
no |
no |
'null' |
voip_control_port |
SIP Config file item |
optional |
no |
no |
'5060' |
xml_card_dir - Reserved by Cisco |
xml_card_file - Reserved by Cisco |
anonymous_call_block - Optional -
Configures anonymous call block.
Valid values:
0 - Disabled, but can be turned on and off using the user. When disabled, anonymous
calls are received.
1 - Enabled, but can be turned on and off using the user. When enabled, anonymous
calls are rejected
2 - Disabled permanently and cannot be turned on and off locally by the user.
Specify this parameter in the phone-specific configuration file.
3 - Enabled permanently and cannot be turned on and off locally by user. Specify
this parameter in the phone-specific configuration file.
Factory default is 0
Back to the Table --
Back to the top of this page
auto_answer - Optional - Configures the
intercom functionality so that the user can define one or more of their lines for
this feature. It is an integer field that represents a bit mask of 'on' or 'off'
for each line key. The bit mask reads from the least significant bit of 0 equal to line 1 to the most significant
bit of 5 for line 6.
Valid values are as follows:
Cisco 7960 - 0 to 63
Cisco 7940 - 0 to 3
Note: This parameter CANNOT be set in the configuration file.
gg Note: If you can figure this one out, let me know.
Back to the Table --
Back to the top of this page
autocomplete - Optional - Configures
automatic completion of numbers being dialed.
Valid values:
0 - The autocomplete feature is disabled by default but can be turned on and off
by the user.
1 - The autocomplete feature is enabled by default but can be turned off and on
by the user.
2 - The autocomplete feature is disabled and cannot be turned on and off by the
user. To set this parameter for a specific phone, configure it in that phone's
configuration file.
3 - The autocomplete feature is enabled and cannot be turned off and on by the
user. To set this parameter for a specific phone, configure it in that phone's
configuration file.
The factory default is 1
Back to the Table --
Back to the top of this page
call_hold_ringback - Optional - If you
have a call on hold and are talking on another call, when you hang up the call,
this parameter causes the phone to ring, letting you know that you still have
another party on hold.
Valid values:
0 - Off, but can be turned on and off locally using the user interface.
1 - On, but can be turned on and off locally using the user interface.
2 - Off permanently and cannot be turned on and off locally using the user
interface. Specify this parameter in the phone-specific configuration file.
3 - On permanently and cannot be turned on and off locally using the user interface.
Specify this parameter in the phone-specific configuration file.
Factory default is 0
Back to the Table --
Back to the top of this page
call_stats - Optional - Includes RTP statistics
in BYE requests and responses.
This is a 'Sip' setting.
Valid values:
0 - disable
1 - enable
Factory default is 0
If this parameter is enabled, the phone inserts the headers RTP-RxStat and
RTP-TxStat as follows:
RTP-RxStat: Dur=a,Pkt=b,Oct=c,LatePkt=d,LostPkt=e,AvgJit=f
RTP-TxStat: Dur=g,Pkt=h,Oct=i
where the following apply:
Dur - Total number of seconds since the beginning of reception or transmission.
Pkt - Total number of RTP packets received or transmitted.
Oct - Total number of RTP payload octets received or transmitted (not including
RTP header).
LatePkt - Total number of late RTP packets received.
LostPkt - Total number of lost RTP packets received (not including late RTP
packets).
AvgJit - Average jitter, which is an estimate of the statistical variance of the
RTP packet inter-arrival time, measured in timestamp unit and calculated according
to RFC 1889.
a, b, c, d, e, f, g, h, and i - Integers.
gg note - Don't enable this if your server can't handle the responses.
Back to the Table --
Back to the top of this page
call_waiting - Optional - Configures call waiting.
Valid values:
0 - Disabled, but can be turned on and off using the user. When disabled,
call waiting calls are not received.
1 - Enabled, but can be turned on and off using the user. When enabled,
call waiting calls are accepted.
2 - Disabled permanently and cannot be turned on and off by the user. Specify this
parameter in the phone-specific configuration file.
3 - Enabled permanently and cannot be turned on and off locally by the user.
Specify this parameter in the phone-specific configuration file.
Factory default is 1
Back to the Table --
Back to the top of this page
callerid_blocking - Optional - Configures caller ID blocking. When enabled,
the phone blocks its own number or e-mail address from phones that have caller
identification enabled.
Valid values:
0 - Disabled, but can be turned on and off by the user. When disabled, the caller
identification is included in the Request-URI header field.
1 - Enabled, but can be turned on and off by the user. When enabled, "Anonymous" is
included in place of the user identification in the Request-URI header field.
2 - Disabled permanently and cannot be turned on and off by the user.
Specify this parameter in the phone-specific configuration file.
3 - Enabled permanently and cannot be turned on and off by the user. Specify this
parameter in the phone-specific configuration file.
Factory default is 0
Back to the Table --
Back to the top of this page
cfwd_url - Optional - Configures the call forwarding feature. The maximum
allowable characters for the string is 128. The characters can be a telephone
number or a URL.
Note: This parameter cannot be set in the configuration file.
gg note - parameter does not appear in a Sip 7.5 phone
Back to the Table --
Back to the top of this page
cnf_join_enable - Optional - Whether the conference bridge, when it
hangs up, should attempt to join the two leaf nodes.
Valid values:
0 - Do not join the two leaf nodes.
1 - Join the two leaf nodes.
Factory default is 1
gg note - parameter does not appear in a Sip 7.5 phone
Back to the Table --
Back to the top of this page
date_format - Optional - Format for dates being displayed on the top
line on the phone (when a SNTP server is configured).
Valid values:
M/D/Y - Month/day/year
D/M/Y - Day/month/year
Y/M/D - Year/month/day
Y/D/M - Year/day/month
Y-M-D - Year-month-day
YY-M-D - 4-digit year-month-day
Default is M/D/Y
Back to the Table --
Back to the top of this page
dial_template - Template with which you specify which file to download
for your dial plan.
gg note1 - Very little info is available for this parameter.
gg note2 - Parameter does not appear in a 'Sip 7.5' phone.
Back to the Table --
Back to the top of this page
directory_url - Optional - URL of the external directory server. This
URL is accessed when you select Directory > External Directory. For example,
use directory_url: "http://10.10.10.10/CiscoServices/Directory.asp".
gg note1 - This needs some more research.
gg note2 - 'External Directory' does not appear on a 'Sip 7.5' phone
Back to the Table --
Back to the top of this page
dnd_control - Optional - Sets the Do Not Disturb (DND) feature.
Valid values:
0 - Off, but can be turned on and off by the user.
1 - On, but can be turned on and off by the user. The phone blocks all calls
placed to the phone and logs those calls in the Missed Calls directory.
2 - Off permanently and cannot be turned on and off by the user. Specify this
parameter in the phone-specific configuration file.
3 - On permanently and cannot be turned on and off by the user. This setting sets
the phone to be a call-out phone only. Specify this parameter in the phone-specific
configuration file.
Default is 0
Back to the Table --
Back to the top of this page
Domain Name - Name of the DNS domain in which the phone resides.
If using DHCP, this parameter is ignored.
If using, its a good idea to put the domain name in double-quotes.
gg note: - I thought parmeters can not have white spaces. - Hmmm.. Need to
check this out.
Back to the Table --
Back to the top of this page
dscpForAudio - Differentiated Services Code Point (DSCP) specifies the
class of service for each audio packet.
Valid value is any positive integer.
Factory default is 184.
gg note - Haven't a clue what this means. - Needs research.
Back to the Table --
Back to the top of this page
dst_auto_adjust - Optional - Whether daylight savings time (DST) is
automatically adjusted on the phones.
Valid values are:
0 (do not adjust)
1 (adjust)
Factory default is 1
Back to the Table --
Back to the top of this page
dst_offset - Optional - Offset from the phone time when DST is in effect.
When DST is over, the specified offset is no longer applied to the phone time.
Valid values:
hour/minute
-hour/minute
+hour/minute
hour
-hour
+hour
Factory Default: (probably)02:00 (for USA)
This setting is not available on the phone. It MUST be put in a phone's config file
to be set.
If "dst_auto_adjust" is disabled, this parameter is ignored.
Back to the Table --
Back to the top of this page
dst_start_day - Optional - Day of the month on which DST begins.
Valid values:
1 to 31 (for days of the month)
0 (ignore this field and use the value in the dst_start_day_of_week parameter
instead)
Factory default is 0
This setting is not available on the phone. It MUST be put in a phone's config file
to be set.
If "dst_auto_adjust" is disabled, this parameter is ignored.
Back to the Table --
Back to the top of this page
dst_start_day_of_week - Optional - Day of the week on which DST begins.
Valid values:
Any of the following: Sunday or Sun, Monday or Mon, Tuesday or Tue, Wednesday or Wed,
Thursday or Thu, Friday or Fri, Saturday or Sat, Sunday or Sun
1 to 7 (1 is Sunday; 7 is Saturday)
Name of the day is not case-sensitive.
Factory default: Sunday (in the USA).
This setting is not available on the phone. It MUST be put in a phone's config file
to be set.
If "dst_auto_adjust" is disabled, this parameter is ignored.
Back to the Table --
Back to the top of this page
dst_start_month - Optional - Month in which DST starts.
Valid values:
January, February, March, April, May, June, July, August, September, October,
November, and December
1 to 12, with 1 being January and 12 being December
When the name of a month is specified, the value is not case-sensitive.
Factory default: April (in the USA).
Factory default: Sunday (in the USA).
This setting is not available on the phone. It MUST be put in a phone's config file
to be set.
If "dst_auto_adjust" is disabled, this parameter is ignored.
Back to the Table --
Back to the top of this page
dst_start_time - Optional - Time of day on which DST begins.
Valid values:
hour/minute (02/00)
hour:minute (02:00)
Factory default: '02:00' (in the USA).
This setting is not available on the phone. It MUST be put in a phone's config file
to be set.
If "dst_auto_adjust" is disabled, this parameter is ignored.
Back to the Table --
Back to the top of this page
dst_start_week_of_month - Optional - Week of month in which DST begins.
Valid values:
1 to 6 and 8 (1 is the first week; each subsequent number is a subsequent week;
8 is the last week in the month regardless of which week the last week is).
Factory default: 1 (in the USA)
This setting is not available on the phone. It MUST be put in a phone's config file
to be set.
If "dst_auto_adjust" is disabled, this parameter is ignored.
Back to the Table --
Back to the top of this page
dst_stop_day - Optional - Day of the month on which DST ends.
Valid values:
1 to 31 (for the days of the month)
0 (ignore this field and use the value in the dst_stop_day_of_week parameter
instead)
Factory default is 0
This setting is not available on the phone. It MUST be put in a phone's config file
to be set.
If "dst_auto_adjust" is disabled, this parameter is ignored.
Back to the Table --
Back to the top of this page
dst_stop_day_of_week - Optional - Day of the week on which DST ends.
Valid values:
Sunday or Sun, Monday or Mon, Tuesday or Tue, Wednesday or Wed, Thursday or Thu,
Friday or Fri, Saturday or Sat, Sunday or Sun
1 to 7, with 1 being Sunday and 7 being Saturday.
When the name of the day is specified, the value is not case-sensitive.
Factory default: Sunday (in the USA)
This setting is not available on the phone. It MUST be put in a phone's config file
to be set.
If "dst_auto_adjust" is disabled, this parameter is ignored.
Back to the Table --
Back to the top of this page
dst_stop_month - Optional - Month in which DST ends.
Valid values:
January, February, March, April, May, June, July, August, September, October,
November, and December
1 to 12 with 1 being January and 12 being December.
When the name of a month is specified, the value is not case-sensitive.
Factory default: October (in the USA)
This setting is not available on the phone. It MUST be put in a phone's config file
to be set.
If "dst_auto_adjust" is disabled, this parameter is ignored.
Back to the Table --
Back to the top of this page
dst_stop_time - Optional - Time of day on which DST ends.
Valid values:
hour/minute (02/00)
hour:minute (02:00)
Factory default: 02:00 (in the USA)
This setting is not available on the phone. It MUST be put in a phone's config file
to be set.
If "dst_auto_adjust" is disabled, this parameter is ignored.
Back to the Table --
Back to the top of this page
dst_stop_week_of_month - Optional - Week of month on which DST ends.
Valid values:
1 to 6 and 8, with 1 being the first week, each number thereafter being subsequent
weeks, and 8 being the last week in the month regardless of which week the last
week is.
Factory default: 8 (in the USA)
This setting is not available on the phone. It MUST be put in a phone's config file
to be set.
If "dst_auto_adjust" is disabled, this parameter is ignored.
Back to the Table --
Back to the top of this page
dtmf_avt_payload - Optional - Configures the payload type for Audio/Video
Transport (AVT) packets.
Valid values:
from 96 to 127
If the value specified is null or invalid, the default value of 101 is used.
This setting is not available on the phone. It MUST be put in a phone's config file
to be set.
Back to the Table --
Back to the top of this page
dtmf_db_level - Optional - In-band DTMF digit tone level.
Valid values:
1 - 6 dB below nominal
2 - 3 dB below nominal
3 - nominal
4 - 3 dB above nominal
5 - 6 dB above nominal
Factory default: 3
This setting is not available on the phone. It MUST be put in a phone's config file
to be set.
Back to the Table --
Back to the top of this page
dtmf_outofband - Optional - Configures the out-of-band signaling (for
tone detection on the IP side of a gateway).
Note The Cisco SIP IP phone supports out-of-band signaling using the AVT tone
method.
Valid values:
none - Do not generate DTMF digits out-of-band.
avt - If requested by the remote side, generate DTMF digits out-of-band (and disable
in-band DTMF signaling); otherwise, do not generate DTMF digits out-of-band.
avt_always - Always generate DTMF digits out-of-band. This option disables in-band
DTMF signaling.
Factory default: avt
Back to the Table --
Back to the top of this page
dyn_dns_addr_1 - Optional - IP address of a new dynamic DNS server. If a
new DNS server address is specified, it is used for any further DNS requests after
the phone uses the initial DNS address upon bootup. The DNS addresses are used in
the following order:
1. dyn_dns_addr_1 (if present)
2. dyn_dns_addr_2 (if present)
3. DNS Server 1
4. DNS Server 2
5. DNS Server 3
6. DNS Server 4
7. DNS Server 5
The dynamic DNS address is not stored in flash memory. Only dotted IP addresses
are accepted. This value can be cleared by removing it from the configuration
file or by changing its value to a null value " " or to "UNPROVISIONED."
Note The dynamic DNS address is not stored in flash memory.
gg note - This shows up on the phone's 'Network Settings' but I can't edit
it even with the phone's unlocked & DHCP turned off. - Config file item only?
Back to the Table --
Back to the top of this page
dyn_dns_addr_2 - Optional - IP address of a second dynamic DNS to be
used for DNS requests. See dyn_dns_addr_1 for more information.
Back to the Table --
Back to the top of this page
dyn_tftp_addr - Optional - IP address of a new dynamic TFTP server.
After initially querying the default TFTP server, the phone rerequests the
default and phone-specific configuration files from the new TFTP server. The
dynamic TFTP server address is not stored in flash memory. The number of
dyn_tftp_addr values supported by the phone is limited to prevent the phone
configuration being downloaded repeatedly from multiple TFTP servers.
Only dotted IP addresses are accepted. This value can be cleared by removing it
from the configuration file or by changing its value to a null
value " " or to "UNPROVISIONED."
gg note - Like the two above, I can't get it to work. - Config file item
only?
Back to the Table --
Back to the top of this page
enable_vad - Optional - Enables voice activation detection (VAD).
Valid values:
0 (disable)
1 (enable)
Factory default: 0
Back to the Table --
Back to the top of this page
end_media_port - Optional - Configures the Real-Time Transport Protocol
(RTP) end range for media.
Valid values:
16384 to 32766
Factory default: 32766.
Back to the Table --
Back to the top of this page
garp_enable - Optional - Enables Gratuitous ARP for the phone.
Valid values:
0 - GARP is disabled.
1 - GARP is enabled.
Factory default: 1 - enabled
Back to the Table --
Back to the top of this page
Host Name - Unique host name assigned to the phone. The value in this
field is always SIPmac where mac is the MAC address of the phone.
This parameter cannot be changed.
Back to the Table --
Back to the top of this page
http_proxy_addr - Optional - IP address of the HTTP proxy server. You
can use either a dotted IP address or a DNS name. If you use a 'null' value, the word
"UNPROVISIONED" shows up in the phone's Network Config setting screen.
Factory default: null
Back to the Table --
Back to the top of this page
http_proxy_port - Optional - Number of the HTTP proxy port.
Vaid values: any port number
Factory default: 80
Back to the Table --
Back to the top of this page
image_version -required?- Firmware version that the phone should use.
Enter the name of the image version as it is released by Cisco. Do not enter the
filename extension (.bin).
Note You cannot change the image version by changing the filename because the
version is also built into the file header. Trying to change the image version
by changing the filename causes the firmware to fail when it compares the
version in the header against the filename.
gg note - Is not available on a 'Sip 7.5' phone.
Back to the Table --
Back to the top of this page
linex_authname -Optional but required if you need to log into a SIP
server.- Name used by the phone for authentication if a registration is
challenged by the proxy server during initialization.
It is required only if a proxy server requires authentication from phones.
If a value is not configured for the linex_authname parameter when registration is
enabled, the default name is used.
Factory default is UNPROVISIONED
The x argument:
'linex_authname' is in reality: 'line1_authname', or 'line2_authname', etc. The values
for 'x' can be:
1 or 2 (Cisco 7940 phones)
1 - 6 (Cisco 7960 phones)
gg note - We use these phones a lot with Asterisk servers. - We usually assign
the phone number we want the phone to register with the server as it's authx_authname
value.
This setting should be placed in the phone's specific configuration file.
Back to the Table --
Back to the top of this page
linex_contact - Optional - The URL that appears in the contact field for
SIP messages on a particular line.
See 'linex_authname' for our discussion on the 'x' modifier.
Factory default: null
gg note - Doesn't show on a 'Sip 7.5' phone.
Back to the Table --
Back to the top of this page
linex_displayname - Optional - Identification as it should appear for
caller-identification purposes. For example, instead of jdoe@company.com appearing
on phones that have caller ID, you can specify User A in this parameter to have
User A appear on the called party display. If a value is not specified for this
parameter, nothing is used.
See 'linex_authname' for our discussion on the 'x' modifier.
Factory default: ' ' (nothing)
Place this setting in the phone's specific configuration file.
Back to the Table --
Back to the top of this page
linex_name -phone-specific- Number or e-mail address for use when
registering. Enter a number without dashes. For example, enter 555-0100 as 5550100.
Enter an e-mail ID without the host name.
See 'linex_authname' for our discussion on the 'x' modifier.
Factory default: null
Place this setting in the phone's specific configuration file.
Back to the Table --
Back to the top of this page
linex_password - Optional - Password used by the phone for authentication
if a registration is challenged by the proxy server during initialization. If a
value is not configured for the linex_password parameter when registration is
enabled, the default password is used.
When the proxy challenges for authentication, it usually uses the 'authname' as the
'login name'.
See 'linex_authname' for our discussion on the 'x' modifier.
Factory default: UNPROVISIONED
Place this setting in the phone's specific configuration file.
gg note - I know it's a pain to try to remember what all these 'names' are
for. But when in doubt, just accept the defaults and don't worry about it. - Until
something screws up!
Back to the Table --
Back to the top of this page
linex_shortname - Optional - Labels a line key with a name other than the
directory number.
Valid values: name or phone number (? # of bytes)
Factory default: null
Place this setting in the phone's specific configuration file.
Back to the Table --
Back to the top of this page
local_cfwd_enable -enabled/disabled- Whether the phone can do local call
forwarding.
Valid values:
0 (disable)
1 (enable)
Factory default: 1
This option is NOT available on the phone menu. - To change it, put it in the
phone's specific configuration file.
Back to the Table --
Back to the top of this page
logo_url - Optional - Location of the company logo file. This logo
appears on the phone display. The background space allocated for the image
is 90 x 56 pixels. Images that are larger than this will automatically be scaled
down to 90 x 56 pixels. The recommended file size for the image is from
5 to 15 Kb.
For example, use logo_url: "http://10.10.10.10/companylogo.bmp"
Note This parameter supports Windows 256 color bitmap format only. CMXML
PhoneImage objects are not supported for this parameter. Using anything other
than a Windows bitmap (.bmp) file can cause unpredictable results.
Factory default: null
This parameter cannot be set on the phone. It MUST be set using one of the
configuration files.
gg note - We have dedicated a separate page on creating your own logos for
use on your phones. - It's in the same place you found this page. - Check it out!
Back to the Table --
Back to the top of this page
messages_uri - Optional - Configures the voice-mail number that is
dialed when the messages button is pressed. Value is typically a phone number but
can be a URI.
Factory default: some number to "comm-pilot" who wants you to pay a bunch of money
to collect your messages. - Thank you, Cisco.
This parameter MUST be set in a configuration file.
Back to the Table --
Back to the top of this page
mwi_status - Optional - Displays the message waiting status.
Note You cannot set this parameter in the configuration file.
gg note - Can't find this setting on a 'Sip 7.5' phone unless I'm confusing it
with the "Call Waiting" setting. - Hmmmmmm.
Back to the Table --
Back to the top of this page
nat_address - Optional - WAN IP address of the Network Address
Translation (NAT) or firewall server.
Valid values:
dotted IP address
DNS name
Factory default: null
If this is not set and 'nat_enable' is turned on, the address of your gateway is
used.
Back to the Table --
Back to the top of this page
nat_enable - Optional - Enables Network Address Translation (NAT).
Valid values:
0 (disable)
1 (enable)
Factory default: 0
If NAT is enabled, the Contact header appears as follows:
Contact: sip:lineN_name@nat_address:voip_control_port
If the nat_address is invalid or UNPROVISIONED, the Contact header appears as
follows:
Contact: sip:lineN_name@phone_ip_address:voip_control_port -AND- and the Via
header appears as follows:
Via: SIP/2.0/UDP phone_ip_address:voip_control_port
If NAT is enabled, the Session Description Protocol (SDP) message uses the
nat_address and an RTP port between the start_media_port and the end_media_port
range in the C and M fields. All RTP traffic is sourced from the port advertised
in the SDP message.
gg note - Ahh! - Got it. - Clear as mud!!
Back to the Table --
Back to the top of this page
nat_received_processing - Optional - Enables NAT received processing.
Valid values:
0 (disable)
1 (enable)
Factory default: 0
If nat_received_processing is enabled, and the received= tag is in the Via header
of the 200 OK response from a REGISTER, the IP address in the received= tag is
used instead of the nat_address in the Contact header. If this switch occurs,
the phone unregisters the old IP address and reregisters with the new IP
address.
This setting can only be made using a phone config file.
Back to the Table --
Back to the top of this page
network_media_type - Optional - Ethernet port negotiation mode.
Valid values:
Auto - Port is autonegotiated
Full100 - Port is configured to be a full-duplex, 100 - MB connection
Half100 - Port is configured to be a half-duplex, 100 - MB connection
Full10 - Port is configured to be a full-duplex, 10 - MB connection
Half10 - Port is configured to be a half-duplex, 10 - MB connection
Factory default: Auto
Back to the Table --
Back to the top of this page
network_port2_type - Optional - Configures the device type that is
connected to port 2 of the phone.
Valid values:
Hub/Switch
Factory default: Hub/Switch
Note If the value is PC, port 2 can be connected only to a PC. If you are not
sure about the connection, use the Hub/Switch default value. Specifying the
PC option and then connecting port 2 to a switch results in spanning-tree loops
and network confusion.
Back to the Table --
Back to the top of this page
outbound_proxy - Optional - IP address of the outbound proxy server.
You can use either a dotted IP address or a DNS name.
Factory default: (blank)
Back to the Table --
Back to the top of this page
outbound_proxy_port - Optional - Port number of the outbound proxy
server.
Valid values: any port number
Factory default: 5060
When an outbound proxy is enabled, all SIP requests are sent to the outbound proxy
server instead of to the proxyx_address. All responses continue to reconcile the
normal Via processing rules. The media stream is not routed through the outbound
proxy.
NAT and outbound proxy modes can be independently enabled or disabled.
The received= tag is added to the Via header of all responses if there is
no received= tag in the uppermost Via header and if the source IP address is
different from the IP address in the uppermost Via header.
Keep the following rules in mind:
If a received= tag is in the uppermost Via header, the response is sent back to
the IP address contained in the received= tag.
If there is no received= tag and the IP address in the uppermost Via header is
different from the source IP address, the response is sent back to the source
IP address.
Back to the Table --
Back to the top of this page
phone_label - Optional - Text to display on the top right status line
of the LCD.
This field is for end-user display only and has no effect on caller identification
or messaging. For example, a phone label can display "User A's phone."
Valid values: up to 11 characters
Factory default: (blank)
This setting can ONLY be made using a phone config file
gg note - If your label has whitespaces, enclose the entire value in
double-quotes. It also looks better if you can add a couple of spaces to the end
of the label.
Back to the Table --
Back to the top of this page
phone_password - Optional - Password to be used for console or Telnet
access.
Valid valus: up to 31 characters
Factory default: cisco
This setting MUST be made in a phone config file.
This is the password you use to 'unlock' a phone to make changes.
gg note - We have dedicated a separate page here at Jtech for those who
have problems 'unlocking' a phone with an unknown password. - Check it out!!
Back to the Table --
Back to the top of this page
phone_prompt - Optional - Prompt to display during Telnet or console
access.
Valid values: up to 15 characters
This setting can ONLY be made using a phone config file.
Factory default: (blank)
Back to the Table --
Back to the top of this page
preferred_codec - Optional - Codec to use when a call is initiated.
Valid values:
g711alaw
g711ulaw
g729a
none
Factory default: g711ulaw
Back to the Table --
Back to the top of this page
proxy_backup - Optional - IP address of the backup proxy server or
gateway.
Valid values: IP address in dotted-decimal notation.
Factory default: (blank)
Note You must specify at least one address in any proxy or the phone cannot
register.
Back to the Table --
Back to the top of this page
proxy_backup_port - Optional - Port number of the backup proxy server.
Valid values: any port number
Factory default: 5060
Back to the Table --
Back to the top of this page
proxy_emergency - Optional - IP address of the emergency proxy server or
gateway.
Valid values: IP address in dotted-decimal notation.
Factory default: (blank)
Back to the Table --
Back to the top of this page
proxy_emergency_port - Optional - Port number of the emergency proxy
server.
Valid values: any port number
Factory default: 5060
Back to the Table --
Back to the top of this page
proxy_register - Optional - Specifies if the phone should register/login
to a proxy server.
Valid values:
0 (disable registration during initialization)
1 (enable registration during initialization).
Factory default: 0
Note You can also use this parameter in a phone-specific configuration file.
After a phone has initialized and registered with a proxy server, you can remove
the registration by changing this value to 0 in the phone-specific
configuration file. To reinitiate registration, change the value back to 1.
Note If you enable registration and authentication is required, you must specify
values for the linex_authname and linex_password parameters in the
phone-specific configuration file.
gg note - KISS - Just use either 1 or 0 and don't bother trying to switch
back and forth. - You'll be fine.
Back to the Table --
Back to the top of this page
proxyx_address - IP address of the SIP proxy servers that are used by
the phones.
Valid values:
IP addresses in dotted-decimal notation
FQDN
Factory default: (blank)
The "x" argument:
The value of "x" is number corresponding to the line on the phone that phone number
is assigned. Valid values:
7940 phone: 1 or 2
7960 phone: 1 - 6
So in reality, if we were using a 7960 and the phone number is configured on line-3,
we would use 'proxy3_address' for the parameter.
If the proxyx_address parameter is provisioned with an FQDN, the phone
sends REGISTER and INVITE messages by using the FQDN in the Req-URI, To, and
From fields.
If the value of x is not specified in the proxyx_address parameter, the phone uses
proxy1_address as the default value.
Back to the Table --
Back to the top of this page
proxyx_port - Port number of the SIP proxy server that will be used by
phone lines other than line 1. The "x" variable represents a phone line. See
'proxyx_address' (above) for our discussion on the "x" variable.
Valid values: any port number
Factory default: 5060
Note For additional phone lines, the proxyx_port parameter and the proxyx_port
parameter can be used to assign different proxy addresses to different phone
lines. If the value of the "x" is not specified in the proxyx_address parameter,
the phone uses proxy1_address as the default.
Back to the Table --
Back to the top of this page
remote_party_id - Optional - The Remote-Party-ID header supports network
verification and screening of a call participant's identity (for example,
name and number) and provides privacy for call participants.
Valid values:
0 - Remote party ID is disabled. The phone does not send or accept the remote
party ID.
1 - Remote party ID is enabled. The phone sends the remote party ID, and can
accept the remote party ID.
Factory default: 0
gg note - Don't see this item on a 'SIP 7.5' phone.
Back to the Table --
Back to the top of this page
rfc_2543_hold - Optional - Determine the SDP that a phone uses to place a
remote party on hold. If this value is 1, the phone uses the RFC 2543 method
and sets the media address to 0.0.0.0. If this value is 0, the phone uses the
RFC 3264 style and instructs the other side to be in recvonly mode.
Factory default: 0
Back to the Table --
Back to the top of this page
semi_attended_transfer - Optional - Whether or not the caller can
transfer the second leg of an attended transfer while the call is ringing.
Valid values:
0 - Semi-attended transfer is disabled
1 - Semi-attended transfer is enabled
Factory default is 1
Back to the Table --
Back to the top of this page
services_url - Optional - URL of the services BTXML files. This URL is
accessed when the Services button is pressed. For example, use
services_url: "http://10.10.10.10/CiscoServices/Services.asp."
Factory Default: ??
This parameter MUST be set using a phone's config file.
Back to the Table --
Back to the top of this page
sip_invite_retx - Optional - Maximum number of times that an INVITE
request will be retransmitted.
Valid value: any positive integer
Factory default: 6
This parameter can only be set using a phone's config file.
Back to the Table --
Back to the top of this page
sip_max_forwards - Optional - The phone uses the value specified in this
parameter in the Max-Forwards header of the SIP requests that it generates.
Valid values: any positive number?
Factory default is 70
This parameter can only be set using a phone's config file.
Back to the Table --
Back to the top of this page
sip_retx - Optional - Maximum number of times that a SIP message other
than an INVITE request will be retransmitted.
Valid values: any positive integer
Factory default: 10
This parameter can only be set using a phone's config file.
Back to the Table --
Back to the top of this page
sntp_mode - Optional - Mode in which the phone listens for the SNTP
server.
Valid values:
unicast
multicast
anycast
directedbroadcast
Factory default: anycast
This parameter can only be set using a phone's config file.
Back to the Table --
Back to the top of this page
sntp_server - IP address of the SNTP server from which the phone
obtains time data.
Valid values: any IP address in dotted decimal notation
Factory default: (blank)
This parameter can only be set using a phone's config file.
Back to the Table --
Back to the top of this page
speed_labelx - Optional - Configures the speed-dial key label. The x
variable is from label 2 to label 6. There are five possible labels that can be
configured on the Cisco IP 7960G but only one on the Cisco IP 7940G. The x
variable is a string of up to 15 characters.
Note This parameter cannot be set in the configuration file.
Back to the Table --
Back to the top of this page
speed_linex - Optional - Configures the speed-dial keys so that the
user can set up one-touch dialing. There are five possible numbers that can be
configured on the Cisco IP 7960G but only one on the Cisco IP 7940G. The x
variable is a string of up to 128 bytes.
Note This parameter cannot be set in the configuration file.
Back to the Table --
Back to the top of this page
start_media_port - Optional - Start RTP range for media.
Range is from 16384 to 32766.
Factory default: 16384
This setting can only be made using a phone's config file.
Back to the Table --
Back to the top of this page
stutter_msg_waiting - Optional - Enables a stutter dial tone when there
is a message waiting.
Valid values:
0 (off)
1 (on)
Factory default: 0
Back to the Table --
Back to the top of this page
sync - Optional - Value against which to compare the value in the
syncinfo.xml file before a remote reboot is performed.
Valid values: up to 32 characters
Factory default: ??
This setting can only be made using a phone's config file.
Back to the Table --
Back to the top of this page
telnet_level - Optional - Enables Telnet for the phone.
Valid values:
0 - Disabled
1 - Enabled, and no privileged commands can be executed.
2 - Enabled, and privileged commands can be executed.
Factory default: is 0
This setting can only be made using a phone's config file.
Back to the Table --
Back to the top of this page
tftp_cfg_dir - Path to the TFTP subdirectory in which phone-specific
configuration files are stored.
Note This parameter is only required if the phone-specific files are in a
subdirectory and not in the root directory.
Factory default: (blank)
This setting can only be made using a phone's config file.
Back to the Table --
Back to the top of this page
time_format_24hr - Optional - Whether a 12-hour or 24-hour time format
is displayed by default on the user interface.
Valid values:
0 - 12-hour format is displayed by default but can be changed to a 24-hour format
by the user.
1 - 24-hour format is displayed by default but can be changed to a 12-hour format
by the user.
2 - 12-hour format is displayed and cannot be changed to a 24-hour format by the user.
3 - 24-hour format is displayed and cannot be changed to a 12-hour format by the user.
Factory default: 1
Back to the Table --
Back to the top of this page
time_zone - Optional - Time zone in which the phone is located.
Valid values are the time-zone abbreviations shown in Table 3-5. Abbreviations
are case sensitive and must be in all capital letters.
Factory default: PST
Back to the Table --
Back to the top of this page
timer_invite_expires - Optional - Amount of time, in seconds, after
which a SIP INVITE expires. This value is used in the Expire header field.
Valid values: any positive number. However, Cisco recommends 180.
Factory default: is 180
This setting can only be made using a phone's config file.
Back to the Table --
Back to the top of this page
timer_register_delta - Configures the time interval at which
reregistration will occur. This is a numeric field in which the time interval
is measured in seconds.
Valid values: range from 32767 to 0
Factory default: 5 (phone will attempt to reregister 5 seconds before
its registration period expires).
This setting can only be made using a phone's config file.
Back to the Table --
Back to the top of this page
timer_register_expires - Optional - Amount of time, in seconds, after
which a REGISTRATION request expires. This value is inserted into the Expire
header field.
Valid values: any positive number. However, Cisco recommends 3600.
Factory default: 3600
This setting can only be made using a phone's config file.
Back to the Table --
Back to the top of this page
timer_t1 - Optional - Lowest value, in milliseconds, of the
retransmission timer for SIP messages.
Valid values: any positive integer
Factory default: 500
This setting can only be made using a phone's config file.
Back to the Table --
Back to the top of this page
timer_t2 - Optional - Highest value, in milliseconds, of the
retransmission timer for SIP messages.
Valid values: any positive integer greater than timer_t1
Factory default: 4000
This setting can only be made using a phone's config file.
Back to the Table --
Back to the top of this page
transfer_onhook_enabled - Optional - If enabled, a user can transfer a
call to a second user by hanging up the phone once the second user picks up the
line. If disabled, a user must, before hanging up, press the Transfer button again
to complete the transfer.
Valid values:
0 - Disabled
1 - Enabled
Factory default: 0
This setting can only be made using a phone's config file.
Back to the Table --
Back to the top of this page
user_info - Optional - Configures the "user=" parameter in the
REGISTER message.
Valid values:
none - No value is inserted.
phone - The value user=phone is inserted in the To, From, and Contact Headers
for REGISTER.
ip - The value user=ip is inserted in the To, From, and Contact Headers
for REGISTER.
Factory default: none
This setting can only be made using a phone's config file.
Back to the Table --
Back to the top of this page
version_stamp - The version of the configuration file, used by the
phone to determine when a new confguration file appears on the TFTP server.
Valid value: a 64-byte string
Factory default: null
This setting can only be made using a phone's config file.
Back to the Table --
Back to the top of this page
voip_control_port - Optional - UDP port used for SIP messages. All
SIP REQUESTS use voip_control_port as the UDP source port when nat_enable = 1.
Valid values: 1025 - 65535
Factory default is 5060
This setting can only be made using a phone's config file.
Back to the Table --
Back to the top of this page
End of Listing
|