SEPMAC.cnf.xml
The main configuration file for the phone. The actual name of the file is based on the MAC address of the phone, eg:SEP58971ECC97C1.cnf.xml
. An sample version of this file is included in the sample tftpboot directory from HTTP Provisioning.<device>
<fullConfig>true</fullConfig>
<deviceProtocol>SIP</deviceProtocol>
ipAddressMode link
IP address family to use on the phone.0 | IPv4 | 1 | IPv6 | 2 | IPv4 and IPv6 |
<ipAddressMode>0</ipAddressMode>
allowAutoConfig link
Allow IPv6 auto-configuration.false | Disabled | true | Enabled |
<allowAutoConfig>true</allowAutoConfig>
dadEnable link
IPv6 Duplicate IP address Detection.false | Disabled | true | Enabled |
<dadEnable>true</dadEnable>
<redirectEnable>false</redirectEnable>
<echoMultiEnable>false</echoMultiEnable>
ipPreferenceModeControl link
Preferred IP address family for signalling.0 | IPv4 | 1 | IPv6 |
<ipPreferenceModeControl>0</ipPreferenceModeControl>
ipMediaAddressFamilyPreference link
Preferred IP address family for media.0 | IPv4 | 1 | IPv6 |
<ipMediaAddressFamilyPreference>0</ipMediaAddressFamilyPreference>
<devicePool>
<dateTimeSetting>
dateTemplate link
How the date and time is displayed. Alternate date field delimiters are-
(dash) and .
(period). D and M fields can be swapped to display date in American format.D/M/Y | 2 Digit Year, 24 Hour Time | D/M/YY | 4 Digit Year, 24 Hour Time |
D/M/YA | 2 Digit Year, 12 Hour Time | D/M/YYA | 4 Digit Year, 12 Hour Time |
<dateTemplate>D/M/Y</dateTemplate>
timeZone link
Name of the local time zone. Display time is adjusted by the number of minutes from UTC.Dateline Standard Time | -720 | Samoa Standard Time | -660 | Hawaiian Standard Time | -600 |
Alaskan Standard/Daylight Time | -540 | Pacific Standard/Daylight Time | -480 | Mountain Standard/Daylight Time | -420 |
US Mountain Standard Time | -420 | Central Standard/Daylight Time | -360 | Mexico Standard/Daylight Time | -360 |
Canada Central Standard Time | -360 | SA Pacific Standard Time | -300 | Eastern Standard/Daylight Time | -300 |
US Eastern Standard Time | -300 | Atlantic Standard/Daylight Time | -240 | SA Western Standard Time | -240 |
Pacific SA Standard Time | -240 | Newfoundland Standard/Daylight Time | -210 | E. South America Standard/Daylight Time | -180 |
SA Eastern Standard Time | -180 | Pacific SA Daylight Time | -180 | Mid-Atlantic Standard/Daylight Time | -120 |
Azores Standard/Daylight Time | -60 | GMT Standard/Daylight Time | +0 | Greenwich Standard Time | +0 |
W. Europe Standard/Daylight Time | +60 | GTB Standard/Daylight Time | +60 | Egypt Standard/Daylight Time | +60 |
E. Europe Standard/Daylight Time | +60 | Romance Standard/Daylight Time | +120 | Central Europe Standard/Daylight Time | +120 |
South Africa Standard Time | +120 | Jerusalem Standard/Daylight Time | +120 | Saudi Arabia Standard Time | +180 |
Russian Standard/Daylight Time | +180 | Iran Standard/Daylight Time | +210 | Caucasus Standard/Daylight Time | +240 |
Arabian Standard Time | +240 | Afghanistan Standard Time | +270 | West Asia Standard Time | +300 |
Ekaterinburg Standard Time | +300 | India Standard Time | +330 | Central Asia Standard Time | +360 |
SE Asia Standard Time | +420 | China Standard/Daylight Time | +480 | Taipei Standard Time | +480 |
Tokyo Standard Time | +540 | Cen. Australia Standard/Daylight Time | +570 | AUS Central Standard Time | +570 |
E. Australia Standard Time | +600 | AUS Eastern Standard/Daylight Time | +600 | West Pacific Standard Time | +600 |
Tasmania Standard/Daylight Time | +600 | Central Pacific Standard Time | +660 | Fiji Standard Time | +720 |
New Zealand Standard/Daylight Time | +720 |
<timeZone>TIME ZONE</timeZone>
<ntps>
<ntp>
name link
Host name or IP address of the NTP server when usingunicast
mode. Maximum length of 50 characters. <name>HOST</name>
ntpMode link
How the phone synchronises the clock.unicast | Query the NTP server specified in <name > for the current time |
directedbroadcast | Listen to broadcasts from NTP servers for the current time |
<ntpMode>unicast</ntpMode>
</ntp>
</ntps>
</dateTimeSetting>
<callManagerGroup>
<members>
member link
Specifies the host name or IP address and SIP port of the server running Asterisk. Up to5
members can be defined with the phone will automatically failing-over to a member with a higher priority when it is disconnected from the current member.priority | 0 to 4 , the connection priority of this member, lower priorities are tried first. |
<member priority="0">
<callManager>
<ports>
sipPort link
SIP port to connect to on the server running Asterisk. <sipPort>5060</sipPort>
securedSipPort link
SIP-TLS port to connect to on the server running Asterisk. <securedSipPort>5061</securedSipPort>
</ports>
processNodeName link
Host name or IP address of the server running Asterisk. Maximum length of 50 characters. <processNodeName>HOST</processNodeName>
</callManager>
</member>
</members>
</callManagerGroup>
</devicePool>
<TVS>
<members>
member link
Specifies the host name or IP address and port of the server running the Trust Verification Service. Up to5
members can be defined with the phone will automatically failing-over to a member with a higher priority when it cannot connect to a member. Maximum length of 50 characters.priority | 0 to 4 , the connection priority of this member, lower priorities are tried first. |
<member priority="0">
port link
Port to connect to on the server running the Trust Verification Service. <port>2445</port>
address link
Host name or IP address of the server running the Trust Verification Service. <address>HOST</address>
</member>
</members>
</TVS>
<vpnGroup>
<mtu>1290</mtu>
<failConnectTime>30</failConnectTime>
authMethod link
Method the phone uses to authenticate to the VPN server.0 | User name and password | 1 | Password only | 2 | Certificate (MIC or LSC) |
<authMethod>0</authMethod>
pswdPersistent link
Locally store the password entered by the user. If disabled the user has to re-enter the password if the phone is reset.0 | Disabled | 1 | Enabled |
<pswdPersistent>1</pswdPersistent>
autoNetDetect link
When the phone starts it will attempt to ping the TFTP server. If it does not receive a response it will automatically connect to the VPN server.0 | Disabled | 1 | Enabled |
<autoNetDetect>1</autoNetDetect>
enableHostIDCheck link
Compare the host name part of the URL set below to the name in the certificate that the VPN server uses and abort the connection if the do not match.0 | Disabled | 1 | Enabled |
<enableHostIDCheck>0</enableHostIDCheck>
<addresses>
url1 link
URL of the VPN server using the format https://HOST/svc. Up to3
URLs can be specified by including <url2
> ... <url3
>. Maximum length of 255 characters. Note: the path must be /svc
when using the patched version of OpenConnect Server. <url1>URL</url1>
</addresses>
<credentials>
<hashAlg>0</hashAlg>
certHash1 link
Encoded hash of the VPN server certificate generated bycerthash
. See VPN Connection for an archive containing scripts for managing certificates. Up to 10
hashes can be specified by including <certHash2
> ... <certHash10
> <certHash1>HASH</certHash1>
</credentials>
</vpnGroup>
<sipProfile>
<sipProxies>
registerWithProxy link
Register with Asterisk, must be set totrue
. <registerWithProxy>true</registerWithProxy>
</sipProxies>
<sipCallFeatures>
<callForwardURI>x-cisco-serviceuri-cfwdall</callForwardURI>
<callPickupURI>x-cisco-serviceuri-pickup</callPickupURI>
<callPickupListURI>x-cisco-serviceuri-opickup</callPickupListURI>
<callPickupGroupURI>x-cisco-serviceuri-gpickup</callPickupGroupURI>
<meetMeServiceURI>x-cisco-serviceuri-meetme</meetMeServiceURI>
<abbreviatedDialURI>x-cisco-serviceuri-abbrdial</abbreviatedDialURI>
callHoldRingback link
Have the phone ring if a user hangs up an while the phone has another call on hold.0 | Disabled | 1 | Enabled |
<callHoldRingback>1</callHoldRingback>
semiAttendedTransfer link
Allow transfers to be completed before the remote party has answered.false | Disabled | true | Enabled |
<semiAttendedTransfer>true</semiAttendedTransfer>
anonymousCallBlock link
Whether the phone rejects incoming anonymous calls. Depending on the phone model, this setting is parsed differently.7900 series | |||||||
0 | Disabled (User Modifiable) | 1 | Enabled (User Modifiable) | 2 | Disabled (Not User Modifiable) | 3 | Enabled (Not User Modifiable) |
6900, 7800, 8800, 8900 and 9900 series | |||||||
0 or 1 | Disabled | 2 or 3 | Enabled |
<anonymousCallBlock>0</anonymousCallBlock>
callerIdBlocking link
Whether the phone hides the outgoing caller ID. Actual phone details will be included the Remote-Party-ID header. Depending on the phone model, this setting is parsed differently.7900 series | |||||||
0 | Disabled (User Modifiable) | 1 | Enabled (User Modifiable) | 2 | Disabled (Not User Modifiable) | 3 | Enabled (Not User Modifiable) |
6900, 7800, 8800, 8900 and 9900 series | |||||||
0 or 1 | Disabled | 2 or 3 | Enabled |
<callerIdBlocking>0</callerIdBlocking>
remoteCcEnable link
Enable remote call control. Must be set totrue
. <remoteCcEnable>true</remoteCcEnable>
<rfc2543Hold>false</rfc2543Hold>
<cnfJoinEnabled>true</cnfJoinEnabled>
<dndControl>0</dndControl>
<localCfwdEnable>true</localCfwdEnable>
<retainForwardInformation>false</retainForwardInformation>
uriDialingDisplayPreference link
Whether to display the full SIP user@domain URI or just the user part only.0 | Full user@domain URI | 1 | User part only |
<uriDialingDisplayPreference>1</uriDialingDisplayPreference>
</sipCallFeatures>
<sipStack>
<sipInviteRetx>6</sipInviteRetx>
<sipRetx>10</sipRetx>
<timerInviteExpires>180</timerInviteExpires>
<timerRegisterExpires>3600</timerRegisterExpires>
<timerRegisterDelta>5</timerRegisterDelta>
<timerKeepAliveExpires>120</timerKeepAliveExpires>
<timerSubscribeExpires>120</timerSubscribeExpires>
<timerSubscribeDelta>5</timerSubscribeDelta>
<timerT1>500</timerT1>
<timerT2>4000</timerT2>
<maxRedirects>70</maxRedirects>
remotePartyID link
Send and receive the SIP Remote-Party-ID header, allows the called or calling party information to be updated by the ${CONNECTEDLINE
()} function. Must be set to true
. <remotePartyID>true</remotePartyID>
<userInfo>Phone</userInfo>
</sipStack>
autoAnswerTimer link
Seconds to wait before automatically answering the call for lines with <autoAnswerEnabled
> set to 1
. <autoAnswerTimer>1</autoAnswerTimer>
autoAnswerAltBehavior link
Prevent automatically answering of a incoming call if the phone already has a call on any line.false | Disabled | true | Enabled |
<autoAnswerAltBehavior>false</autoAnswerAltBehavior>
<autoAnswerOverride>true</autoAnswerOverride>
transferOnhookEnabled link
Allow transfers to be completed by placing the handset back on-hook.false | Disabled | true | Enabled |
<transferOnhookEnabled>false</transferOnhookEnabled>
enableVad link
Enable support for Voice Activity Detection (also know as Silence Suppression).false | Disabled | true | Enabled |
<enableVad>false</enableVad>
<preferredCodec>none</preferredCodec>
<dtmfAvtPayload>101</dtmfAvtPayload>
<dtmfDbLevel>3</dtmfDbLevel>
<dtmfOutofBand>avt</dtmfOutofBand>
alwaysUsePrimeLine link
Always select the primary line when the phone is taken off-hook. Incoming calls on any other lines would not be automatically answered.false | Disabled | true | Enabled |
<alwaysUsePrimeLine>false</alwaysUsePrimeLine>
alwaysUsePrimeLineVoicemail link
Always select the primary line when the messages button is pressed while on-hook. Otherwise, the first line that has a message waiting is used.false | Disabled | true | Enabled |
<alwaysUsePrimeLineVoiceMail>false</alwaysUsePrimeLineVoiceMail>
<kpml>0</kpml>
phoneLabel link
Label appears in the top of the phone's screen. Maximum length of 12 characters. Note: the 7900 series does not support spaces in the label. <phoneLabel>LABEL</phoneLabel>
<stutterMsgWaiting>0</stutterMsgWaiting>
callStats link
Include call statistics (packets sent and received, jitter) in SIP BYE message.false | Disabled | true | Enabled |
<callStats>true</callStats>
<offhookToFirstDigitTimer>15000</offhookToFirstDigitTimer>
<silentPeriodBetweenCallWaitingBursts>10</silentPeriodBetweenCallWaitingBursts>
<startMediaPort>16384</startMediaPort>
<stopMediaPort>32766</stopMediaPort>
<natEnabled>false</natEnabled>
<natReceivedProcessing>false</natReceivedProcessing>
<natAddress></natAddress>
<sipLines>
line link
Defines the line keys on the phone, you can specify as many lines as your phone has line keys. Line keys are used for phone lines, BLF speed dials, service URLs etc. There must be at least one line key of <featureID
> type 9
defined. See Line Keys for examples for a list of available features.button | Button to assign this line definition to |
lineIndex | Index for <featureID > type 9 buttons. |
<line button="1" lineIndex="1">
featureID link
Number determining which feature is assigned to this line key. <featureID>9</featureID>
featureLabel link
Text label to display next to the line key. Maximum length of 30 characters. <featureLabel>PEERNAME</featureLabel>
proxy link
Proxy must be the keywordUSECALLMANAGER
. <proxy>USECALLMANAGER</proxy>
<port>5060</port>
name link
Name to use when registering. Maximum length of 30 characters. This is the name of the peer defined in sip.conf. <name>PEERNAME</name>
displayName link
Name to use in SIP From header (optional). Maximum length of 30 characters. <displayName>NAME</displayName>
<autoAnswer>
autoAnswerEnabled link
Automatically answer incoming calls on this line.0 | Disabled | 1 | Enabled |
<autoAnswerEnabled>0</autoAnswerEnabled>
autoAnswerMode link
Where to send the audio for automatically answered calls.Auto Answer with Speakerphone | Speakerphone | Auto Answer with Headset | Headset |
<autoAnswerMode>Auto Answer with Headset</autoAnswerMode>
</autoAnswer>
callWaiting link
Enable call waiting.7900 series | |||||||
0 | Disabled (User Modifiable) | 1 | Enabled (User Modifiable) | 2 | Disabled (Not User Modifiable) | 3 | Enabled (Not User Modifiable) |
6900, 7800, 8800, 8900 and 9900 series | |||||||
0 or 1 | Disabled | 2 or 3 | Enabled |
<callWaiting>1</callWaiting>
authName link
Username to use when registering. Maximum length of 30 characters. <authName>PEERNAME</authName>
authPassword link
Password to use when registering. Maximum length of 30 characters. This is the secret for the peer defined in sip.conf. <authPassword>SECRET</authPassword>
contact link
SIP contact header username to use (optional). <contact>PEERNAME</contact>
<sharedLine>false</sharedLine>
messageWaitingLampPolicy link
How the phone alerts the user to unheard voicemail messages.0 | Light Lamp and Display Prompt if message is waiting (Primary Line Only) |
1 | Display Prompt if message is waiting (Primary Line Only) |
2 | Light Lamp if message is waiting (Primary Line Only) |
3 | Light Lamp and Display Prompt if message is waiting |
4 | Display Prompt if message is waiting |
5 | Light Lamp if message is waiting |
6 | Do not Light Lamp or Display Prompt if a message is waiting |
<messageWaitingLampPolicy>3</messageWaitingLampPolicy>
messageWaitingAMWI link
Play an brief audible tone when the phone is taken off-hook and a there is an unheard voicemail message.0 | Disabled | 1 | Enabled |
<messageWaitingAMWI>0</messageWaitingAMWI>
messagesNumber link
Number to dial when the messages key is pressed. <messagesNumber>VOICEMAIL EXTENSION</messagesNumber>
ringSettingIdle link
How the phone rings when not on a call.0 | Use System Default | 1 | Disable | 2 | Flash Only | 3 | Ring Once | 4 | Ring |
<ringSettingIdle>4</ringSettingIdle>
ringSettingActive link
How the phone rings when it already has a call.0 | Use System Default | 1 | Disable | 2 | Flash Only | 3 | Ring Once | 4 | Ring | 5 | Beep Only |
<ringSettingActive>5</ringSettingActive>
<forwardCallInfoDisplay>
<callerName>true</callerName>
<callerNumber>true</callerNumber>
<redirectedNumber>true</redirectedNumber>
<dialedNumber>true</dialedNumber>
</forwardCallInfoDisplay>
maxNumCalls link
Maximum number of calls the line can have at a time. The table below shows the highest value that can be used for each phone model.6 | 8831 |
12 | 6921, 7811, 7821, 7832, 8832 |
24 | 6941, 6945, 7841, 8821, 8941, 8945 |
50 | 7911, 7941, 7942, 7945, 7961, 7962, 7965, 7971, 7975 |
72 | 6961 |
200 | 8811, 8841, 8845, 8851, 8861, 8865, 8961, 9951, 9971 |
<maxNumCalls>5</maxNumCalls>
busyTrigger link
Number of calls the line can have at a time before returning a busy signal. <busyTrigger>4</busyTrigger>
recordingOption link
Allow user-initiated recording of calls on this line.disable | Disabled | enable | Enabled |
<recordingOption>enable</recordingOption>
</line>
</sipLines>
<externalNumberMask></externalNumberMask>
<voipControlPort>5060</voipControlPort>
<dscpForAudio>184</dscpForAudio>
<dscpVideo>136</dscpVideo>
<ringSettingBusyStationPolicy>0</ringSettingBusyStationPolicy>
dialTemplate link
Name of the file containing the digit timeout patterns. See Dial Templates for further information. Note: default timeout is 15 seconds if you don not specify a dial template. <dialTemplate>DIAL TEMPLATE FILE</dialTemplate>
softKeyFile link
Name of the file containing the soft key definitions and layouts. See Soft Keys for further information. <softKeyFile>SOFTKEY FILE</softKeyFile>
</sipProfile>
featurePolicyFile link
Name of the file containing the enabled features policy for the 8961, 9951 and 9971 models. See Feature Policy for further information. <featurePolicyFile>FEATURE POLICY FILE</featurePolicyFile>
MissedCallLoggingOption link
List of one or more0
or 1
characters indicating which lines should log missed calls. Lines are indexed by the position of the character in the string (eg: 100
enables logging on the first line and disables it on the second and third). Note: this element uses non-standard capitalization.0 | Disabled | 1 | Enabled |
<MissedCallLoggingOption>1</MissedCallLoggingOption>
<commonProfile>
<phonePassword></phonePassword>
backgroundImageAccess link
Allow the end user to change the background wallpaper image on the phone.false | Disabled | true | Enabled |
<backgroundImageAccess>true</backgroundImageAccess>
callLogBlfEnabled link
Show whether an extension is in either busy or idle in the phone's call history. A hint for that extension must exist in the Asterisk dial-plan.7900 series | |||
0 | Disabled (User Modifiable) | 1 | Enabled (User Modifiable) |
2 | Disabled (Not User Modifiable) | 3 | Enabled (Not User Modifiable) |
6900, 7800, 8800, 8900 and 9900 series | |||
0 or 1 | Disabled | 2 or 3 | Enabled |
<callLogBlfEnabled>2</callLogBlfEnabled>
</commonProfile>
loadInformation link
Name of the firmware load file without the.loads
file extension. <loadInformation>LOADS FILE</loadInformation>
inactiveLoadInformation link
Name of the inactive firmware load file without the.loads
file extension. Allows the phone to revert to using this load without having to re-download firmware, 8800, 8900 and 9900 series only. <inactiveLoadInformation>LOADS FILE</inactiveLoadInformation>
<vendorConfig>
defaultWallpaperFile link
Default background image for the phone, the file must be located in the directory the phone uses for user selecable background images and <backgroundImageAccess
> must also be set to false
. 8800, 8900 and 9900 series only. See Background Images for directory and image size. <defaultWallpaperFile>FILE<defaultWallpaperFile>
disableSpeaker link
Whether a user can use the speaker.false | Enabled | true | Disabled |
<disableSpeaker>false</disableSpeaker>
disableSpeakerAndHeadset link
Whether a user can use the either the speaker or headset.false | Enabled | true | Disabled |
<disableSpeakerAndHeadset>false</disableSpeakerAndHeadset>
enableMuteFeature link
Provide the user with aMute
soft key that can be used to mute or unmute calls for phones that do not have a dedicated mute key.false | Disabled | true | Enabled |
<enableMuteFeature>false</enableMuteFeature>
enableGroupListen link
Allow the use of the headset and handset simultaneously when the headset is in use.false | Disabled | true | Enabled |
<enableGroupListen>true</enableGroupListen>
g722CodecSupport link
Whether the G.722 codec is enabled.0 | Use device default | 1 | Disabled | 2 | Enabled |
<g722CodecSupport>2</g722CodecSupport>
holdResumeKey link
Whether the hold key can be used to hold and resume a call or only hold the call. 7800 and 8800 series only.0 | Hold and Resume | 1 | Hold only |
<holdResumeKey>0</holdResumeKey>
recentsSoftKey link
Whether to display therecents
soft key. 7800 series only.0 | Disabled | 1 | Enabled |
<recentsSoftKey>1</recentsSoftKey>
<handsetWidebandEnable>2</handsetWidebandEnable>
<headsetWidebandEnable>2</headsetWidebandEnable>
<headsetWidebandUIControl>1</headsetWidebandUIControl>
<handsetWidebandUIControl>1</handsetWidebandUIControl>
settingsAccess link
Whether a user can access the phone settings.0 | Disabled | 1 | Enabled |
<settingsAccess>1</settingsAccess>
videoCapability link
Enable video capability.0 | Disabled | 1 | Enabled |
<videoCapability>0</videoCapability>
separateMute link
When transmitting video, pressing mute will only mutes the audio instead of muting both audio and video. 9900 series only.0 | Disabled | 1 | Enabled |
<separateMute>0</separateMute>
hideVideoByDefault link
Hide the video window by default. Video from the phone's camera will still be transmitted. 8900 and 9900 series only.0 | Disabled | 1 | Enabled |
<hideVideoByDefault>0</hideVideoByDefault>
ciscoCamera link
Enable camera.0 | Disabled | 1 | Enabled |
<ciscoCamera>0</ciscoCamera>
webAccess link
Enable the phone's web server.0 | Enabled | 1 | Disabled |
<webAccess>0</webAccess>
webProtocol link
Protocols the phone's web server supports.0 | HTTP and HTTPS | 1 | HTTPS only |
<webProtocol>0</webProtocol>
tls12Only link
Only allow TLS 1.2 ciphers for web access via HTTPS.0 | Disabled | 1 | Enabled |
<tls12Only>0</tls12Only>
webAdmin link
Enable remote administration using the phone's web server. 8821 model only.0 | Disabled | 1 | Enabled |
<webAdmin>1</webAdmin>
adminPassword link
Password to access the phone's remote administration web interface. 8821 model only. <adminPassword></adminPassword>
sshAccess link
Enable the phone's SSH server.0 | Enabled | 1 | Disabled |
<sshAccess>0</sshAccess>
displayRefreshRate link
The refresh rate of the display to prevent flicker caused by some lighting environments.0 | Normal | 1 | Flicker Correction |
<displayRefreshRate>0</displayRefreshRate>
daysDisplayNotActive link
Comma separated list of days that the phone's display is not active and will be automatically turned off after the time specified by <displayIdleTimeout
> has elapsed.1 | Sunday | 2 | Monday | 3 | Tuesday | 4 | Wednesday | 5 | Thursday | 6 | Friday | 7 | Saturday |
<daysDisplayNotActive>1,7</daysDisplayNotActive>
displayOnTime link
Time in HH:MM format to automatically turn on the phone display. <displayOnTime>08:00</displayOnTime>
displayOnDuration link
Time duration in HH:MM format to automatically turn off the phone display after it was turned on. <displayOnDuration>10:00</displayOnDuration>
displayIdleTimeout link
Timeout in HH:MM format to automatically turn off phone display if outside the time specified by <daysDisplayNotActive
>, <displayOnTime
> and <displayOnTimeout
>. <displayIdleTimeout>00:10</displayIdleTimeout>
displayOnWhenIncomingCall link
Automatically turn on display when there is an incoming call and outside the time specified by <daysDisplayNotActive
>, <displayOnTime
> and <displayOnDuration
>.0 | Disabled | 1 | Enabled |
<displayOnWhenIncomingCall>1</displayOnWhenIncomingCall>
daysBacklightNotActive link
Comma separated list of days that the phone's backlight is not active and will be automatically turned off after the time specified by <backlightIdleTimeout
> has elapsed. See <daysDisplayNotActive
> for examples. <daysBacklightNotActive>1,7</daysBacklightNotActive>
backlightOnTime link
Time in HH:MM format to automatically turn on the phone backlight. <backlightOnTime>08:00</backlightOnTime>
backlightOnDuration link
Time duration in HH:MM format to automatically turn off the phone backlight after it was turned on. <backlightOnDuration>10:00</backlightOnDuration>
backlightOnIdleTimeout link
Timeout in HH:MM format to automatically turn off phone backlight if outside the time specified by <daysBacklightNotActive
>, <backlightOnTime
> and <backlightOnTimeout
>. <backlightIdleTimeout>00:10</backlightIdleTimeout>
backlightOnWhenIncomingCall link
Automatically turn on backlight when there is an incoming call and outside the time specified by <daysBacklightNotActive
>, <backlightOnTime
> and <backlightOnDuration
>. See <backlightOnWhenIncomingCall
> for examples. <backlightOnWhenIncomingCall>1</backlightOnWhenIncomingCall>
recordingTone link
Periodically play a beep tone during the call. Note: the tone is played regardless of whether the call is being recorded or not.0 | Disabled | 1 | Enabled |
<recordingTone>0</recordingTone>
recordingToneLocalVolume link
0 to 100 | Volume % |
<recordingToneLocalVolume>100</recordingToneLocalVolume>
recordingToneRemoteVolume link
0 to 100 | Volume % |
<recordingToneRemoteVolume>50</recordingToneRemoteVolume>
<recordingToneDuration></recordingToneDuration>
moreKeyReversionTimer link
Number of seconds between0
and 30
to wait after the more
soft key is pressed before reverting to the initial set of soft keys. A timer of 0
prevents reversion. <moreKeyReversionTimer>5</moreKeyReversionTimer>
autoSelectLineEnable link
Change focus to incoming calls on all lines, otherwise only change focus to calls on the currently selected line.0 | Disabled | 1 | Enabled |
<autoSelectLineEnable>1</autoSelectLineEnable>
autoCallSelect link
When the phone has a incoming call, automatically change focus to that call.0 | Disabled | 1 | Enabled |
<autoCallSelect>1</autoCallSelect>
incomingCallToastTimer link
Time in seconds to display the incoming call toast (popup) notification. A value of0
disables the notification. <incomingCallToastTimer>5</incomingCallToastTimer>
<joinAndDirectTransferPolicy>0</joinAndDirectTransferPolicy>
minimumRingVolume link
Minimum volume of the phone's ringer. A number between0
(off) to 15
(full). <minimumRingVolume></minimumRingVolume>
adminConfigurableRinger link
Set the ring-tone to one of the the built-in tones, cannot be changed by the user.0 | Disabled | 1 | Sunrise (8800 series only) | 2 | Chirp 1 | 3 | Chirp 2 |
<adminConfigurableRinger></adminConfigurableRinger>
simplifiedNewCall link
Use a simplified new call window when dialing which only displays the number being dialed rather than displaying a list of call history entries that the phone number matches. 7800, 8800, 8900 and 9900 series only.0 | Disabled | 1 | Enabled |
<simplifiedNewCall>0</simplifiedNewCall>
actionableAlert link
Display a window at the bottom of the screen with the call details instead of next to the session key. 7800, 8800, 8900 and 9900 series only.0 | Disabled | 1 | Enabled |
<actionableAlert>0</actionableAlert>
softKeyControl link
Use soft key feature definitions in <softKeyFile
> instead of <featureControlPolicy
>. 7800, 8800 and 9900 series only.0 | Disabled | 1 | Enabled |
<softkeyControl>0</softkeyControl>
peerFirmwareSharing link
Enable firmware sharing, the phone will attempts to download the new firmware files from another phone on the same subnet rather than the TFTP or HTTP server.0 | Disabled | 1 | Enabled |
<peerFirmwareSharing>1</peerFirmwareSharing>
loadServer link
Alternate TFTP or HTTP server to download firmware files. <loadServer>HOST</loadServer>
problemReportUploadURL link
URL to use when the report problem option is selected in the phone information menu. Maximum length of 255 characters. 7800 and 8800 series only. <problemReportUploadURL>URL</problemReportUploadURL>
detectCMConnectionFailure link
How long the phone waits before failing-over to the backup proxy after losing connectivity to the primary. In delayed mode the phone waits approximately 4 times longer.0 | Normal | 1 | Delayed |
<detectCMConnectionFailure>0</detectCMConnectionFailure>
disableTLSCiphers link
Comma separated list of TLS ciphers to be disabled.1 | TLS_RSA_WITH_3DES_EDE_CBC_SHA | 2 | TLS_RSA_WITH_AES_128_CBC_SHA | 3 | TLS_RSA_WITH_AES_256_CBC_SHA |
4 | TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 | 5 | TLS_ECDHE_ECDHE_WITH_AES_128_GCM_SHA256 | 6 | TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 |
7 | TLS_ECDHE_ECDHE_WITH_AES_256_GCM_SHA384 |
<disableTLSCiphers></disableTLSCiphers>
<rtcp>1</rtcp>
<videoRtcp>1</videoRtcp>
<garp>0</garp>
bluetooth link
Enable bluetooth, 8845, 8851, 8861, 8865, 8945, 9951 and 9971 models only.0 | Disabled | 1 | Enabled |
<bluetooth>1</bluetooth>
bluetoothProfile link
Comma separated list of supported bluetooth profiles.0 | Handsfree | 1 | Human Interface Device |
<bluetoothProfile>0,1</bluetoothProfile>
btpbap link
Include the bluetooth device's address book in the contacts menu.0 | Disabled | 1 | Enabled |
<btpbap>0</btpbap>
bthfu link
Register the bluetooth device as a second line on the phone and allow calls to be dialed out through the device.0 | Disabled | 1 | Enabled |
<bthfu>0</bthfu>
wifi link
Enable wifi, 8861, 8865 and 9971 models only.0 | Disabled | 1 | Enabled |
<wifi>1</wifi>
<sdio>1</sdio>
usb1 link
Enable USB port 1.0 | Disabled | 1 | Enabled |
<usb1>1</usb1>
usb2 link
Enable USB port 2.0 | Disabled | 1 | Enabled |
<usb2>1</usb2>
usbClasses link
Comma separated list of supported USB device classes.0 | Mass Storage | 1 | Human Interface Device | 2 | Audio Class |
<usbClasses>0,1,2</usbClasses>
ehookEnable link
Enable Electronic Hook-Switch support on the AUX port.0 | Disabled | 1 | Enabled |
<ehookEnable>0</ehookEnable>
kemOneColumn link
Display only one line key per row for the KEM and BEKEM expansion modules. The provides more room for the label and allows the feature to be accessed by pressing either the left or right line-key.0 | Disabled | 1 | Enabled |
<kemOneColumn>0</kemOneColumn>
lineMode link
Make the session keys on the right of the phone's display be configurable as line keys. 7800 and 8800 series only.0 | Disabled | 1 | Enabled |
<lineMode>0</lineMode>
callParkMonitor link
Monitor the parked call's status using a line key. 7800 and 8800 series only.0 | Disabled | 1 | Enabled |
<callParkMonitor>1</callParkMonitor>
showCallHistoryForSelectedLine link
When viewing the phone's call history only show calls for the currently selected line.0 | Disabled | 1 | Enabled |
<showCallHistoryForSelectedLine>0</showCallHistoryForSelectedLine>
dialToneFromReleaseKey link
Provide the new call screen when a user ends a call.0 | Disabled | 1 | Enabled |
<dialToneFromReleaseKey>0</dialToneFromReleaseKey>
markCallAsSpam link
Show mark as call as spam soft-key. 7800 and 8800 series only.0 | Disabled | 1 | Enabled |
<markCallAsSpam>1</markCallAsSpam>
lowerYourVoiceAlert link
Enable an alert when input sound level is too high. 7800 and 8800 series only.0 | Disabled | 1 | Enabled |
<lowerYourVoiceAlert>0</lowerYourVoiceAlert>
dfBit link
Set the DF (Don't Fragement) bit in the IP packet header.0 | Disabled | 1 | Enabled |
<dfBit>0</dfBit>
pcPort link
Disable the PC (computer) port.0 | Enabled | 1 | Disabled |
<pcPort>0</pcPort>
spanToPCPort link
Forward packets sent and received on the SW (network) port to the PC (computer) port.0 | Enabled | 1 | Disabled |
<spanToPCPort>1</spanToPCPort>
voiceVlanAccess link
Allow devices connected to the PC (computer) port to access the voice VLAN.0 | Disabled | 1 | Enabled |
<voiceVlanAccess>0</voiceVlanAccess>
enableCdpSwPort link
Enable Cisco Discovery Protocol on the SW (network) port.0 | Disabled | 1 | Enabled |
<enableCdpSwPort>1</enableCdpSwPort>
enableCdpPcPort link
Enable Cisco Discovery Protocol on the PC (computer) port.0 | Disabled | 1 | Enabled |
<enableCdpPcPort>0</enableCdpPcPort>
enableLldpSwPort link
Enable Link Layer Discovery Protocol on the SW (network) port.0 | Disabled | 1 | Enabled |
<enableLldpSwPort>1</enableLldpSwPort>
enableLldpPcPort link
Enable Link Layer Discovery Protocol on the PC (computer) port.0 | Disabled | 1 | Enabled |
<enableLldpPcPort>0</enableLldpPcPort>
cdpEnable link
Enable Cisco Discovery Protocol. 8821 model only.0 | Disabled | 1 | Enabled |
<cdpEnable>1</cdpEnable>
powerNegotiation link
Enable power negotiation when connected to a PoE switch that supports 802.3at (PoE+). The phone may not power-up accessories if it cannot receive enough power.0 | Disabled | 1 | Enabled |
<powerNegotiation>0</powerNegotiation>
eapAuthentication link
Enable port authentication on a switch supports 802.1x.0 | User controlled | 1 | Disabled | 2 | Enabled |
<eapAuthentication>1</eapAuthentication>
accessContacts link
Allow access to the phone's contacts. 8821 model only.0 | Disabled | 1 | Enabled (read and write) | 2 | Enabled (read only) |
<accessContacts>1</accessContacts>
accessFavorites link
Allow access to the phone's favorites. 8821 model only.0 | Disabled | 1 | Enabled (read and write) | 2 | Enabled (read only) |
<accessFavorites>1</accessFavorites>
accessVoicemail link
Allow access to the phone's voicemail. 8821 model only.0 | Disabled | 1 | Enabled |
<accessVoicemail>1</accessVoicemail>
accessApps link
Allow access to the phone's applications. 8821 model only.0 | Disabled | 1 | Enabled |
<accessApps>1</accessApps>
applicationURL link
URL to use when the applications button is pressed 8821 model only. Maximum length of 255 characters. <applicationURL>URL</applicationURL>
appButtonTimer link
Time in seconds the applications button must be held down before the phone will access the applications URL. 8821 model only.0 to 5 | Seconds |
<appButtonTimer>0</appButtonTimer>
appButtonPriority link
How the phone behaves when applications button is pressed. 8821 model only.0 | Low, the applications button only works if the phone is idle |
1 | Medium, the applications button will take priority over other tasks unless the keypad is locked |
2 | High, the applications button will take priority over other task even if the keypad is locked |
<appButtonPriority>1</appButtonPriority>
homeScreen link
The default view on the phone's screen. 8821 model only.0 | Application View | 1 | Line View |
<homeScreen>1</homeScreen>
sendKeyAction link
The dialing mode the phone uses when the send key is first pressed. 8821 model only.0 | On-hook dialing | 1 | Off-hook dialing |
<sendKeyAction>1</sendKeyAction>
specialNumbers link
Comma separated list of numbers the phone will allow to be dialed even if the keypad is locked. 8821 model only. <specialNumbers></specialNumbers>
outOfRangeAlert link
Alert when the phone is out of range of the wireless access point. 8821 model only.0 | No Alert | 1 | Beep Once | 2 | Beep Every 10 Seconds | 3 | Beep Every 30 Seconds | 4 | Beep Every 60 Seconds |
<outOfRangeAlert>1</outOfRangeAlert>
scanningMode link
Control how the phone scans for access points. 8821 model only.0 | Scan when in a call or low signal strength during a call | 1 | Scan when powered on or connection to the access point is lost | 2 | Continually scan even when not in in a call |
<scanningMode>2</scanningMode>
powerOffWhenCharging link
Automatically power off the phone during charging. 8821 model only.0 | Disabled | 1 | Enabled |
<powerOffWhenCharging>0</powerOffWhenCharging>
</vendorConfig>
<addOnModules>
addOnModule link
Describes a add-on (key expansion) module attached to the phone.idx | Number from 1 to 3 specifiying the position of the module, counting from the left. |
<addOnModule idx="1">
deviceType link
Model of the add-on module. Note: For the 8800 series all modules connected must be of the same type.7914 | 14 Line Module (7900 series) | 7915 | 24 Line Module (7900 series) | 7916 | 24 Line Module (7900 series) |
BEKEM | 36 Line Module (8800 series) | CP-8800-Audio | 28 Line Module (8861 model) | CP-8800-Video | 28 Line Module (8865 model) |
CKEM | 36 Line Module (9900 series) |
<deviceType>TYPE</deviceType>
deviceLine link
Number of line keys available, see above for the number of lines. <deviceLine>LINES</deviceLine>
loadInformation link
Name of the firmware load file without the.loads
file extension, only required for the 7914, 7915 and 7916 models. <loadInformation>LOADS FILE</loadInformation>
</addOnModule>
</addOnModules>
<versionStamp>d902ed5a-c1e5-4233-b1d6-a960d53d1c3a</versionStamp>
<userLocale>
name link
The dowloadable user locale allows the messages displayed by the phone to be in in the local language. If you do not have the locale file use the default ofEnglish_United_States
. See Network Locale for examples. <name>USER LOCALE NAME</name>
<uid>1</uid>
<langCode></langCode>
version link
User locale version, the phone will only download a new locale when the version changes. <version>VERSION</version>
winCharSet link
Character set used by the locale, eitheriso-8859-1
or utf-8
. <winCharSet>utf-8</winCharSet>
</userLocale>
<networkLocale>NETWORK LOCALE NAME</networkLocale>
<networkLocaleInfo>
name link
The dowloadable network locale allows the tones (dial-tone, ringing, busy etc.) to be those specified by the local phone network. If you do not have the locale file use the default ofUnited_States
See User Locale for examples. <name>NETWORK LOCALE NAME</name>
version link
Network locale version, the phone will only download a new locale when the version changes. <version>VERSION</version>
</networkLocaleInfo>
deviceSecurityMode link
Specifies which cipher to use when connecting using TLS as the <transportLayerProtocol
>. See Device Security for more information.1 | Insecure | 2 | Authenticated (TLS using NULL cipher) | 3 | Encrypted (TLS using AES cipher) |
<deviceSecurityMode>1</deviceSecurityMode>
authenticationURL link
URL to use when checking whether XML posted to the phone's CGI Execute URL will be accepted. Leave blank to accept all requests. Maximum length of 255 characters. <authenticationURL>URL</authenticationURL>
secureAuthenticationURL link
Secure <authenticationURL
>. Maximum length of 255 characters. <secureAuthenticationURL>URL</secureAuthenticationURL>
messagesURL link
URL to use when the messages key is pressed, overrides <messagesNumber
>. Maximum length of 255 characters. <messagesURL>URL</messagesURL>
secureMessagesURL link
Secure <messagesURL
>. Maximum length of 255 characters. <secureMessagesURL>URL</secureMessagesURL>
servicesURL link
URL to use when the services key is pressed. Maximum length of 255 characters. <servicesURL>URL</servicesURL>
secureServicesURL link
Secure <servicesURL
>. Maximum length of 255 characters. <secureServicesURL>URL</secureServicesURL>
directoryURL link
URL to use when the directories or contacts key is pressed. Maximum length of 255 characters. <directoryURL>URL</directoryURL>
secureDirectoryURL link
Secure <directoryURL
>. Maximum length of 255 characters. <secureDirectoryURL>URL</secureDirectoryURL>
informationURL link
URL to use when the information key is pressed, 7900 series only. Maximum length of 255 characters. <informationURL>URL</informationURL>
secureInformationURL link
Secure <informationURL
>. Maximum length of 255 characters. <secureInformationURL>URL</secureInformationURL>
idleURL link
URL to use when the phone is idle. Maximum length of 255 characters. <idleURL>URL</idleURL>
secureIdleURL link
Secure <idleURL
>. Maximum length of 255 characters. <secureIdleURL>URL</secureIdleURL>
idleTimeout link
Timeout in seconds after the phone becomes idle before going to the <idleURL
>. Maximum length of 255 characters. <idleTimeout>0</idleTimeout>
<proxyServerURL></proxyServerURL>
phoneServices link
An optional method for specifiying the various service URLs above. Maximum length of 255 characters.useHTTPS | false or true on whether to use HTTPS to access services. |
<phoneServices useHTTPS="false">
provisioning link
Tells the phone whether to ignore, override or merge the service URLs specified in <phoneServices
>.0 | Use <phoneServices > only |
1 | Use <servicesURL >, <directoryURL > and <messagesURL > only |
2 | Use both |
<provisioning>2</provisioning>
phoneService link
Specifies a phone service URL. Maximum length of 255 characters.type | Which menu the service appears in | 0 | Services or Applications menu | 1 | Directories or Contacts menu | 2 | Messages menu |
<phoneService type="1" category="0">
<name>Missed Calls</name>
<url>Application:Cisco/MissedCalls</url>
<vendor></vendor>
<version></version>
</phoneService>
<phoneService type="1" category="0">
<name>Received Calls</name>
<url>Application:Cisco/ReceivedCalls</url>
<vendor></vendor>
<version></version>
</phoneService>
<phoneService type="1" category="0">
<name>Placed Calls</name>
<url>Application:Cisco/PlacedCalls</url>
<vendor></vendor>
<version></version>
</phoneService>
<phoneService type="2" category="0">
<name>Voicemail</name>
<url>Application:Cisco/Voicemail</url>
<vendor></vendor>
<version></version>
</phoneService>
</phoneServices>
transportLayerProtocol link
What protocol the phone will use to connect to Asterisk. Only use1
(TCP) or 3
(TLS), as the phone causes SIP retransmit errors when using UDP. Note: <deviceSecurityMode
> must be set to either 2
(Authenticated) or 3
(Encrypted) to enable TLS as well as configuring Device Security.1 | TCP | 2 | UDP | 3 | TLS |
<transportLayerProtocol>1</transportLayerProtocol>
<TLSResumptionTimer>3600</TLSResumptionTimer>
phonePersonalization link
Enable support for phone personalization. XML can be sent to the phone via the http://x.x.x.x/CGI/Execute URL to change the background image and ringtone.0 | Disabled | 1 | Enabled |
<phonePersonalization>1</phonePersonalization>
<autoCallPickupEnable>true</autoCallPickupEnable>
blfAudibleAlertSettingOfIdleStation link
Play a beep tone when a extension monitored by a BLF line key becomes idle.0 | Disabled | 1 | Enabled |
<blfAudibleAlertSettingOfIdleStation>0</blfAudibleAlertSettingOfIdleStation>
blfAudibleAlertSettingOfBusyStation link
Play a beep tone when a extension monitored by a BLF line key becomes busy.0 | Disabled | 1 | Enabled |
<blfAudibleAlertSettingOfBusyStation>0</blfAudibleAlertSettingOfBusyStation>
dndCallAlert link
How the phone displays an incoming call when DND is enabled anddndbusy
is set to no
in sip.conf.0 | Disable | 1 | Beep Only | 5 | Flash Only |
<dndCallAlert>1</dndCallAlert>
dndReminderTimer link
How often in minutes to play a beep tone through the speaker when DND is enabled. <dndReminderTimer>5</dndReminderTimer>
advertiseG722Codec link
Whether to advertise the G722 codec in SDP.0 | Disabled | 1 | Enabled | 2 | Use device default |
<advertiseG722Codec>2</advertiseG722Codec>
<rollover>0</rollover>
<joinAcrossLines>0</joinAcrossLines>
capfAuthMode link
Specifies how the phone authenticates itself to the Certificate Authentication Proxy Function.1 | Password | 2 | Empty password | 3 | Locally Significant Certificate (LSC), fallback to Manufacturer Installed Certificate (MIC) | 4 | Manufacturer Installed Certificate (MIC) |
<capfAuthMode>1</capfAuthMode>
<capfList>
capf link
Specifies the host name or IP address and port of the server running the Certificate Authentication Proxy Function. Up to5
members can be defined. <capf>
port link
Port to connect to on the server running the Certificate Authentication Proxy Function. <phonePort>3804</phonePort>
processNodeName link
Host name or IP address of the server running the Certificate Authentication Proxy Function. <processNodeName>HOST</processNodeName>
</capf>
</capfList>
<certHash></certHash>
<encrConfig>false</encrConfig>
<userId></userId>
<ownerId></ownerId>
sshUserId link
SSH username that the SSH server on the phone will accept. Once logged in enter the usernamedebug
and the password debug
for the 7800, 7900, 8800, and 9900 series or admin
with no password for the 6900 series to access the debugging shell. <sshUserId>USERNAME</sshUserId>
sshPassword link
SSH password that the SSH server on the phone will accept. <sshPassword>PASSWORD</sshPassword>
</device>