Views

Broadsoft DMS

The Wiki of Unify contains information on clients and devices, communications systems and unified communications. - Unify GmbH & Co. KG is a Trademark Licensee of Siemens AG.

Revision as of 05:59, 12 September 2017 by Sven (talk | contribs) (Locked config menu settings)
Jump to: navigation, search

Introduction

The Device Management System (DMS) is part of the Broadworks solution. It is an HTTPS server that delivers xml files for the OpenScape Desk Phone CP devices. The format and content is described in this document.

The xml file containing configuration and file deployment instructions is requested via a generic GET request. The server address and path can be configured on the phone. The file name is hardcoded and cannot be changed. It always is <MAC-address-of-device>_config.xml

The MAC address of the device is also send as header in the format: "macaddress: 0a1b2c3d4d5f"

The OpenScape Desk Phone CP devices support HTTP digest authentication, if username and password are properly configured


Set DMS address via DHCP

When an IP phone is booting, it first obtains an IP address via DHCP. The DHCP server can provide the DMS address to the phone via Option 43 or Option 66. The DMS address is mutually exclusive with a possibly provided DLS address. A phone can either connect to a DLS or DMS server.


Option 43

DHCP vendor specific option 43 can specify a voice VLAN ID and URL of a Broadsoft DMS server. IP phones will recognize vendor specific options only, if vendor string (here: "Siemens") matches correctly. All values are given in hexadecimal numbering format. Here is a detailed description of all DHCP option 43 bytes:

Tag Len Content (Example)
01  07  5369656d656e73
02  04  00000065
03  1d  68747470733a2f2f39332E3132322E3131342E39363a3434332f646d73
ff


There are three Tags, each with an explicit length value. List if tags is delimited by a ending ff

  • Tag 01 specifies the vendor (here: Siemens)
    • Tag: 01; Length: 07; Value: Siemens
  • Tag 02 specifies VLAN ID of Voice VLAN (here: 101)
    • Tag: 02; Length: 04; Value: 65 (Hex)
  • Tag 03 specifies IP address of Broadsoft DMS (here: 93.122.114.96:443/dms)
  • End of record
    • End: ff (Hex)

Providing a VLAN ID is optional and only mentioned for completeness. You can find details for configuration of a VLAN ID here: http://wiki.unify.com/wiki/VLAN_ID_Discovery_over_DHCP


Option 66

The DHCP server needs to be configured to provide the DMS server URL via Option 66. Here is a detailed description of the Option 66 bytes

Option Len Content (Example)
42     1d  68747470733a2f2f39332e3132322e3131342e39363a3434332f646d73

Compared to Option 43, Option 66 does not have specific tags. It only has a length and content field. The above example provides the following URL in the content field


Set DMS address via menu

You can also set the URL to your DMS via the local phone menu (in case it cannot be provided via DHCP). A DHCP configured address cannot be overwritten manually. The DMS address is mutually exclusive with a possibly configured DLS address. A phone can either connect to a DLS or DMS server.

Web based management

Open the web based management in a web browser window and login to the admin area of your Desk Phone CP device. Go to Network -> Update Service and provide the required URL, username and password.

Local phone menu

Press the main menu key and select Settings -> Administrator settings. Provide the admin password and afterwards select Network -> Update Service -> DMS -> Show details. Configure the required URL, username and password.

In case the provided username and password are incorrect or missing, the phone will automatically prompt the user for a new username and password.

update check interval

The update check interval defines when the device will contact the DMS server to check for updates. It's value needs to be given in seconds. On every download of the XML file, the phone generates a hash of the file and compares the new hash value with the hash from previous XML file download. The new XML file will only be parsed and applied if the hash has changed (the file has changed)

manual triggered check

The OpenScape Desk Phone CP can be triggered by the SIP server to check the configuration file. This can be done via SIP NOTIFY with Event type "check-sync". See Event header below.

 Event: check-sync

With the same NOTIFY message, the CP devices can be triggered to perform a reboot. Please see the Event header below.

 Event: check-sync;reboot=yes

Please find a SIPp scenario file, which simulates the above behavior, here: File:DMS check-sync reboot.xml


Content of config.xml file

The content of the XML file provided by the DMS server has the following schema. It can have one Action=WriteItems and one Action=SoftwareDeployment. It can have multiple sections for Action=FileDeployment.

 <?xml version="1.0" encoding="utf-8"?>
 <Message>
   <Action>WriteItems</Action>
   <ItemList>
     <Item name="ITEMNAME">VALUE</Item>
   </ItemList>
   <Action>SoftwareDeployment</Action>
   <ItemList>
     <Item name="ITEMNAME">VALUE</Item>
   </ItemList>
   <Action>FileDeployment</Action>
   <ItemList>
     <Item name="ITEMNAME">VALUE</Item>
   </ItemList>
 </Message>

Please see the chapters below for details

Action: WriteItems

This chapter is about WriteItems. WriteItems is used to send configuration items to the phone.

Generic Items

This section describes the items that can be configured on a CP device via a config.xml file.


Network related Items

Item name Type Details Related WBM config item
ip-protocol-mode Enumeration 0=IPv4 only, 1=IPv6 only, 2=Dual stack mode IPv6_IPv4 Admin -> Network -> General IP configuration -> Protocol mode
lldp-enabled Boolean LLDP-Med enabled. true or false Admin -> Network -> General IP configuration -> LLDP-MED enabled
dhcp Boolean DHCPv4 enabled. true or false Admin -> Network -> General IP configuration -> DHCP enabled
ipv6-dhcp-enabled Boolean DHCPv6 enabled. true or false Admin -> Network -> General IP configuration -> DHCPv6 enabled
vlan-method Enumeration Discover VLAN via: 2=LLDP-Med, 1=DHCP, 0=manual Admin -> Network -> General IP configuration -> VLAN discovery
vlan-id Integer only valid if vlan-method is set to manual Admin -> Network -> General IP configuration -> VLAN ID
dns-domain-name String DNS-domain name, if not provided by DHCP server Admin -> Network -> General IP configuration -> DNS domain
dns-server-addr String Primary DNS server, if not provided by DHCP server Admin -> Network -> General IP configuration -> Primary DNS
dns-server-addr2 String Secondary DNS server, if not provided by DHCP server Admin -> Network -> General IP configuration -> Secondary DNS
dhcp-reuse Boolean DHCPv4 reuse. true or false Admin -> Network -> IPv4 configuration -> DHCP lease reuse
ipv6-dhcp-addr-reuse Boolean DHCPv6 reuse. true or false Admin -> Network -> IPv6 configuration -> DHCPv6 lease reuse
reg-port Integer SIP server port Admin -> Network -> Port configuration -> SIP server
registrar-port Integer SIP registrar port Admin -> Network -> Port configuration -> SIP registrar
sgnl-gateway-port-user Integer SIP gateway port Admin -> Network -> Port configuration -> SIP gateway
phone-port Integer SIP local phone port Admin -> Network -> Port configuration -> SIP local
rtp-base-port Integer RTP base port Admin -> Network -> Port configuration -> RTP base
port1 Enumeration LAN port speed setting. 0=Auto, 1=10/Half, 2=10/Full, 3=100/Half, 4=100/Full, 5=1000/Full Admin -> Network -> Port configuration -> LAN port speed
port2 Enumeration PC port speed setting. 0=Auto, 1=10/Half, 2=10/Full, 3=100/Half, 4=100/Full, 5=1000/Full Admin -> Network -> Port configuration -> PC port speed
port2-mode Enumeration PC port mode. 0=Disabled, 1=Enabled, 2=Mirror Admin -> Network -> Port configuration -> PC port mode
port2-auto-mdix-enabled Boolean Enable Auto-MDIX on PC port. true or false Admin -> Network -> Port configuration -> PC port autoMDIX


System related Items

Item name Type Details Related WBM config item
e164 String E164 number of device Admin -> System -> System identity -> Terminal number
display-id-unicode String optional ID to display on main menu screen Admin -> System -> System identity -> Display identity
use-display-id Boolean Enable Display identity. true or false Admin -> System -> System identity -> Enable ID
hostname String Hostname of device (DDNS) Admin -> System -> System identity -> Terminal number
automatic-hostname-type Enumeration Hostname construction. 0=None, 1=Configured hostname, 2=only E164, 3=Prefix E164 with configured hostname, 4=MAC Admin -> System -> System identity -> DNS name construction
reg-addr String SIP server address Admin -> System -> Registration -> SIP server address
registrar-addr String SIP registrar address Admin -> System -> Registration -> SIP registrar address
sgnl-gateway-addr-user String SIP gateway address Admin -> System -> Registration -> SIP gateway address
session-timer Boolean Enable SIP session timer. true or false Admin -> System -> Registration -> Session timer enabled
session-duration Integer Session refresh after seconds. Depends on session timer Admin -> System -> Registration -> Session duration (seconds)
reg-ttl Integer Registration timer (seconds) Admin -> System -> Registration -> Registration timer (seconds)
refresh-guard-time Integer Seconds (earliest) for when a re-registration or re-subscription will occur. Admin -> System -> Registration -> Refresh timer (seconds)
server-type Enumeration SIP server type. 0=Other, 1=OpenScape Voice, 2=Broadsoft Admin -> System -> Registration -> Server type
realm String SIP realm for digest authentication Admin -> System -> Registration -> Realm
sip-uder-id String SIP username for digest authentication Admin -> System -> Registration -> User ID
sip-pwd String SIP password for digest authentication Admin -> System -> Registration -> Password
outbound-proxy-user Boolean Enable SIP gateway. true or false Admin -> System -> SIP interface -> Outbound proxy
sip-transport-user Enumeration SIP transport type. 0=UDP, 1=TCP, 2=TLS Admin -> System -> SIP interface -> SIP transport
failover-on Enumeration DNS-SRV failover on timeout only or timeout & error. 0=timeout only, 1=timeout & error Admin -> System -> SIP interface -> Failover on
event-check-sync Enumeration Handle check-sync event messages. 0=disabled, 1=challenge, 2=no challenge Admin -> System -> SIP interface -> Event check-sync
transaction-timer Integer Transaction timer for call related SIP messages (milliseconds) Admin -> System -> SIP interface -> Call transaction response timer (ms)
transaction-timer-f Integer Transaction timer for non call related SIP messages (milliseconds) Admin -> System -> SIP interface -> NonCall transaction response timer (ms)
registration-backoff-timer Integer Backoff timer for Registration issues (seconds) Admin -> System -> SIP interface -> Reg. backoff (seconds)
voip-connectivity-check-interval Integer Connectivity check intervall (seconds )for TCP and TLS Admin -> System -> SIP interface -> Connectivity check timer (seconds)
media-negotiation-mode Enumeration Media negotiation. 0=Single IP, 1=ANAT, 2=ICE Admin -> System -> SIP interface -> Media negotiation
sip-media-IP-mode Enumeration SIP media IP mode. 0=IPv4, 1=IPv6, 2=IPv4_IPv6, 3=IPv6_IPv4 Admin -> System -> SIP interface -> Media IP mode

Feature related Items

Item name Type Details Related WBM config item
emergency-e164 String Emergency E164 number Admin -> System -> Features -> Configuration -> Emergency number
voice-mail-e164 String Voicemail number Admin -> System -> Features -> Configuration -> Voice mail number
uaCSTA-enabled Boolean Enable uaCSTA. true or false Admin -> System -> Features -> Configuration -> Allow uaCSTA
server-based-features Boolean Enable server-based features. true or false Admin -> System -> Features -> Configuration -> Server features
enable-bluetooth-interface Boolean Enable Bluetooth interface on CP600. true or false Admin -> System -> Features -> Configuration -> Enable bluetooth interface
call-record-phone-number String Call recording number Admin -> System -> Features -> Configuration -> Recorder address
call-record-auto-start Boolean Automatically start recording. true or falls Admin -> System -> Features -> Configuration -> Recording mode
call-record-all-calls Boolean Record all calls. true or falls Admin -> System -> Features -> Configuration -> Recording mode
call-record-audible-indication Boolean Audible indication of recording. true or false Admin -> System -> Features -> Configuration -> Audible notification
call-record-audible-indication-continuous Boolean Repeat audible indication of recording. true or false Admin -> System -> Features -> Configuration -> Audible notification
show-icon-for-all-forwarding-types Boolean Show forwarding icon and LED status for all forwarding types. true or false Admin -> System -> Features -> Configuration -> Show icon for all forwarding types
line-rollover-type Enumeration Audible notification of rollover calls. 0="no ring", 1="alert ring", 2="standard ring", 3="alert beep" Admin -> System -> Features -> Keyset operation-> Rollover ring
mwi-e164 String Message waiting server URI Admin -> System -> Features -> Addressing -> MW server URI
conference-factory-uri String Server based conference URI Admin -> System -> Features -> Addressing -> Conference

QoS related items

Item name Type Details Related WBM config item
qos-layer2 Boolean Enable QoS layer 2 tagging of packets Admin -> Network -> QoS
l2qos-default Integer Set the L2 tag for all packets except signalling and voice (values: 0-7) Admin -> Network -> QoS
l2qos-signalling Integer Set the L2 tag for all SIP signalling packets (values: 0-7) Admin -> Network -> QoS
l2qos-voice Integer Set the L2 tag for all RTP voice packets (values: 0-7) Admin -> Network -> QoS
qos-layer3 Boolean Enable QoS layer 3 tagging of packets Admin -> Network -> QoS
l3qos-signalling Enumeration Set the L3 tag for all SIP signalling packets (values: see table below) Admin -> Network -> QoS
l3qos-voice Enumeration Set the L3 tag for all RTP voice packets (values: see table below) Admin -> Network -> QoS


Enumeration L3 QoS value
0 BE
10 AF11
12 AF12
14 AF13
18 AF21
20 AF22
22 AF23
24 CS3
26 AF31
28 AF32
30 AF33
32 CS4
34 AF41
36 AF42
38 AF43
40 CS5
46 EF
56 CS7

Broadsoft Xtended Service Interface

The following section describes the settings for accessing the Broadsoft Xtended Service Interface (XSI)

 <Item name="bw-xsi-addr">https://xsp.iop1.broadworks.net</Item>
 <Item name="bw-xsi-sipauthentication">false</Item>
 <Item name="bw-xsi-username">username@broadworks.net</Item>
 <Item name="bw-xsi-password">123456</Item>
 <Item name="bw-ccl-enable">true</Item>
 <Item name="bw-cgdirectory-enable">true</Item>
 <Item name="bw-cgdirectory-name">Group Directory</Item>
 <Item name="bw-cedirectory-enable">true</Item>
 <Item name="bw-cedirectory-name">Enterprise Directory</Item>
 <Item name="bw-cgcdirectory-enable">true</Item>
 <Item name="bw-cgcdirectory-name">Group Common Directory</Item>
 <Item name="bw-cecdirectory-enable">true</Item>
 <Item name="bw-cecdirectory-name">Enterprise Common Directory</Item>
 <Item name="bw-cpdirectory-enable">true</Item>
 <Item name="bw-cpdirectory-name">Personal Directory</Item>


Item name Type Details Related WBM config item
bw-xsi-addr String IP address or FQDN of XSI server Admin -> Local functions -> XSI access
bw-xsi-sipauthentication Boolean Enable SIP credentials based authentication. true or false Admin -> Local functions -> XSI access
bw-xsi-username String Username for XSI access Admin -> Local functions -> XSI access
bw-xsi-password String Password for XSI access. Required if bw-xsi-sipauthentication is set to false Admin -> Local functions -> XSI access
bw-ccl-enable Boolean Enable centralised call log. true or false Admin -> Local functions -> Call logging
bw-cgdirectory-enable Boolean Enable Group Directory via XSI. true or false Admin -> Local functions -> Network directories
bw-cgdirectory-name String Name for Group Directory to be used on the CP phone Admin -> Local functions -> Network directories
bw-cedirectory-enable Boolean Enable Enterprise Directory via XSI. true or false Admin -> Local functions -> Network directories
bw-cedirectory-name String Name for Enterprise Directory to be used on the CP phone Admin -> Local functions -> Network directories
bw-cgcdirectory-enable Boolean Enable Group Common Directory via XSI. true or false Admin -> Local functions -> Network directories
bw-cgcdirectory-name String Name for Group Common Directory to be used on the CP phone Admin -> Local functions -> Network directories
bw-cecdirectory-enable Boolean Enable Enterprise Common Directory via XSI. true or false Admin -> Local functions -> Network directories
bw-cecdirectory-name String Name for Enterprise Common Directory to be used on the CP phone Admin -> Local functions -> Network directories
bw-cpdirectory-enable Boolean Enable Personal Directory via XSI. true or false Admin -> Local functions -> Network directories
bw-cpdirectory-name String Name for Personal Directory to be used on the CP phone Admin -> Local functions -> Network directories

Broadsoft Device Management System

The following section describes the settings for accessing the Broadsoft Device Management System (DMS)

 <Item name="bw-dms-addr">https://xsp.iop1.broadworks.net/DMS/</Item>
 <Item name="bw-dms-username">username</Item>
 <Item name="bw-dms-password">password</Item>
 <Item name="bw-dms-contact-interval">300</Item>


Item name Type Details Related WBM config item
bw-dms-addr String IP address or FQDN of DMS server Admin -> Network -> Update Service
bw-dms-username String Username for DMS access Admin -> Network -> Update Service
bw-dms-password String Password for DMS access Admin -> Network -> Update Service
bw-dms-contact-interval Integer Contact interval (seconds) for polling the DMS server Admin -> Network -> Update Service

BLF resource list subscription

The following section describes the settings for Broadsoft BLF resource list subscription settings. Please keep in mind that for every resource in the resource list, a seperate BLF key is required.

 <Item name="blf-resource-uri">user-a1</Item>
 <Item name="blf-code">*97</Item>


Item name Type Details Related WBM config item
blf-resource-uri String user part of the URI for subscribing to the resource list Admin -> System -> Features -> Addressing
blf-code String BLF pickup code. Required to pickup calls alerting at BLF resources Admin -> System -> Features -> Addressing

Date&Time Settings

The following section describes the settings for Date&Time on the phone

 <Item name="sntp-addr">0.pool.ntp.org</Item>
 <Item name="sntp-tz-offset">60</Item>
 <Item name="daylight-save">true</Item>
 <Item name="daylight-save-minutes">60</Item>
 <Item name="auto-daylight-save">true</Item>
 <Item name="daylight-save-zone-id">9</Item>


Item name Type Details Related WBM config item
sntp-addr String IP address or FQDN of NTP server Admin -> Date and Time -> SNTP primary
sntp-tz-offset Integer Offset in minutes of desired timezone Admin -> Date and Time -> Timezone offset
daylight-save Boolean Enable daylight saving. true or false Admin -> Date and Time -> Daylight saving
daylight-save-minutes Integer Offset in minutes when changing from/to daylight saving Admin -> Date and Time -> Difference
auto-daylight-save Boolean Automatically change from/to daylight saving. true or false Admin -> Date and Time -> Auto time change
daylight-save-zone-id Enumeration Daylight saving zone Admin -> Date and Time -> DST zone

A list of possible values for Enumeration "daylight-save-zone-id"

  • 0=Not set
  • 1=Australia 2007 (ACT, South Australia, Tasmania, Victoria)
  • 2=Australia 2007 (New South Wales)
  • 3=Australia (Western Australia)
  • 4=Australia 2008+ (ACT, New South Wales, South Australia, Tasmania, Victora)
  • 5=Brazil
  • 6=Canada
  • 7=Canada (Newfoundland)
  • 8=Europe (Portugal, United Kingdom)
  • 9=Europe (Rest)
  • 10=Europe (Finland)
  • 11=Mexico
  • 12=United States
  • 13=New Zealand
  • 14=New Zealand (Chatham)

Audio Codec Settings

Audio codecs require a special handling inside the config.xml file as they need to be send as a complete group. Example file below:

 <Item name="codec-type" index="1">0</Item>
 <Item name="codec-type" index="2">1</Item>
 <Item name="codec-type" index="3">2</Item>
 <Item name="codec-allowed" index="1">true</Item>
 <Item name="codec-allowed" index="2">true</Item>
 <Item name="codec-allowed" index="3">true</Item>
 <Item name="codec-packet-size" index="1">2</Item>
 <Item name="codec-packet-size" index="2">2</Item>
 <Item name="codec-packet-size" index="3">2</Item>
 <Item name="codec-rank" index="1">2</Item>
 <Item name="codec-rank" index="2">1</Item>
 <Item name="codec-rank" index="3">3</Item>
 <Item name="audio-silence-suppression">false</Item>


Item name Item index Type Details
codec-type 1,2 or 3 Enumeration 0=G.711, 1=G.722, 2=G.729
codec-allowed 1,2 or 3 Boolean Enables codec referred to by index value. true or false
codec-packet-size 1,2 or 3 Enumeration Packet size for codec referred to by index value. 0=10ms, 1=20ms, 2=Automatic, 3=30ms, 4=60ms, 5=40ms
codec-rank 1,2 or 3 Enumeration Set codec rank in SDP negotiation. 1=1st preference, 2=2nd preference, 3=3rd preference
audio-silence-suppression no index Boolean Enables silence supression. true or false


FPK programming

In order to program a free programmable key (FPK) via DMS, you need to take the phone type into account. The phone type defines the amount of keys you can program.

  • 48 keys on CP600 (with 4 Key modules attached. 4 times 12 keys on the key modules)
    • On a CP600, the first key module and the Favorites menu share the same key index (1-12)
  • 48 keys on CP400 (with 2 Key modules attached. 16 keys on the base device, 2 times 16 keys on the key modules)
  • 4 keys on CP200/CP205 (all on the base device)

First you need the key index where the functionality will be put on. The values below are valid for Desk Phone CP models running V1 R2 (or newer) software

Phone type Index base device (normal/shift) Index Key module 1 (normal/shift) Index Key module 2 (normal/shift) Index Key module 3 (normal/shift) Index Key module 4 (normal/shift)
CP600 1-12 1001-1012 1-12 1001-1012 301-312 1301-1312 401-412 1401-1412 701-712 1701-1712
CP400 1-16 1001-1016 301-316 1301-1316 401-416 1401-1416 not available
CP200/CP205 601-604 1601-1604 not available

Remember the index number of the FPK, where you want to configure a function. We will use index "1" in the following examples.

Shared call appearance

 <Item name="function-key-def" index="1">31</Item>
 <Item name="key-label-unicode" index="1">Bob Smith</Item>
 <Item name="line-primary" index="1">true</Item>
 <Item name="line-shared-type" index="1">0</Item>
 <Item name="line-sip-uri" index="1">2405551111_1</Item>
 <Item name="line-sip-user-id" index="1">bobsmith</Item>
 <Item name="line-sip-pwd" index="1">bobs</Item>
 <Item name="line-sip-realm" index="1">realm</Item>
 <Item name="line-ring" index="1">true</Item>
 <Item name="line-ring-delay" index="1">0</Item>


Item name Item index Type Details
function-key-def 1 Enumeration 31=shared call appearance
key-label-unicode 1 String Key label visible on phone
line-primary 1 Boolean This line is the primary line (only required for own line). true or false
line-shared-type 1 Enumeration 0=shared, 1=private
line-sip-uri 1 String E164 number of this specific line
line-sip-user-id 1 String SIP username for digest authentication
line-sip-pwd 1 String SIP password for digest authentication
line-sip-realm 1 String SIP realm for digest authentication
line-ring 1 Boolean Enables ringing on this line. true or false
line-ring-delay 1 Integer Make this line ring with delay of defined value in seconds

Multiple Call Arrangement

The configuration is similar to the Shared Call Appearance configuration. You need one line configured as primary line.

 <Item name="function-key-def" index="1">31</Item>
 <Item name="key-label-unicode" index="1">Line 1</Item>
 <Item name="line-primary" index="1">true</Item>
 <Item name="line-shared-type" index="1">0</Item>
 <Item name="line-sip-uri" index="1">2405551111</Item>
 <Item name="line-sip-user-id" index="1">bobsmith</Item>
 <Item name="line-sip-pwd" index="1">bobs</Item>
 <Item name="line-sip-realm" index="1">realm</Item>
 <Item name="line-ring" index="1">true</Item>
 <Item name="line-ring-delay" index="1">0</Item>

You can have up to 5 secondary lines with the same E164 number configured. Digest authentication is required on the primary line only.

 <Item name="function-key-def" index="2">31</Item>
 <Item name="key-label-unicode" index="2">Line 2</Item>
 <Item name="line-primary" index="2">false</Item>
 <Item name="line-sip-uri" index="2">2405551111</Item>
 <Item name="line-ring" index="2">true</Item>
 <Item name="line-ring-delay" index="2">0</Item>
 <Item name="function-key-def" index="3">31</Item>
 <Item name="key-label-unicode" index="3">Line 3</Item>
 <Item name="line-primary" index="3">false</Item>
 <Item name="line-sip-uri" index="3">2405551111</Item>
 <Item name="line-ring" index="3">true</Item>
 <Item name="line-ring-delay" index="3">0</Item>
Item name Item index Type Details
function-key-def 1 Enumeration 31=shared call appearance
key-label-unicode 1 String Key label visible on phone
line-primary 1 Boolean This line is the primary line (only required for own line). true or false
line-sip-uri 1 String E164 number of this specific line
line-sip-user-id 1 String SIP username for digest authentication
line-sip-pwd 1 String SIP password for digest authentication
line-sip-realm 1 String SIP realm for digest authentication
line-ring 1 Boolean Enables ringing on this line. true or false
line-ring-delay 1 Integer Make this line ring with delay of defined value in seconds

Busy Lamp Field (BLF)

 <Item name="function-key-def" index="1">59</Item>
 <Item name="key-label-unicode" index="1">Bob Smith</Item>
 <Item name="blf-audible" index="1">true</Item>
 <Item name="blf-popup" index="1">true</Item>
 <Item name="stimulus-led-control-uri" index="1">user-a2</Item>


Item name Item index Type Details
function-key-def 1 Enumeration 59=BLF
key-label-unicode 1 String Key label visible on phone
blf-audible 1 Boolean Get audible alert on incoming calls. true or false
blf-popup 1 Boolean Get popup on incoming calls. true or false
stimulus-led-control-uri 1 String User ID of resource that is part of the BLF resource list

Broadsoft Call Center

 <Item name="function-key-def" index="1">43</Item>
 <Item name="key-label-unicode" index="1">Agent Logon</Item>
 <Item name="xsi-call-center-name" index="1">my_call_center</Item>


Item name Item index Type Details
function-key-def 1 Enumeration 43=Broadsoft Call Center
key-label-unicode 1 String Key label visible on phone
xsi-call-center-name 1 String Name of the call center the agent can logon or logoff

Selected dialling

 <Item name="function-key-def" index="1">1</Item>
 <Item name="key-label-unicode" index="1">Selected Dial</Item>
 <Item name="select-dial" index="1">12345</Item>


Item name Item index Type Details
function-key-def 1 Enumeration 1=selected dialling
key-label-unicode 1 String Key label visible on phone
select-dial 1 String dialling target

Generic FPKs

 <Item name="function-key-def" index="1">nn</Item>
 <Item name="key-label-unicode" index="1">Key label text</Item>


Item name Item index Type Details
function-key-def 1 Enumeration nn=number defining the key functionality
key-label-unicode 1 String Key label visible on phone

Below you can find a list of possible values for item "function-key-def" and the corresponding functionality

Enumeration Functionality
0 No function (default)
3 Redial
9 Ringer off
10 Hold
11 Alternate
12 Blind transfer
13 Transfer
22 Conference
25 Do not disturb
29 Group pickup
43 Broadsoft Call Center
45 Directed pickup
46 Release call
48 Callback
49 Cancel callback
50 Consultation
53 Call waiting
56 Call recording
64 Built in forwarding
74 Call log
75 Directory

Feature access settings

The phone allows to restrict access to specifc features for the user. This section will show the relevant Items to configure if you want the user to not have access to a specific functionality.

 <Item name="agent-feature-enabled">false</Item>
 <Item name="enable-bluetooth-interface">false</Item>
 <Item name="enable-WBM">false</Item>
 <Item name="pb-lookups-allowed">false</Item>
 <Item name="refuse-call">false</Item>
 <Item name="callback-busy-allow">false</Item>
 <Item name="feature-availability" index="1">false</Item>
 <Item name="feature-availability" index="2">false</Item>
 <Item name="feature-availability" index="11">false</Item>
 <Item name="feature-availability" index="23">false</Item>
 <Item name="feature-availability" index="24">false</Item>
 <Item name="feature-availability" index="27">false</Item>
 <Item name="feature-availability" index="28">false</Item>
 <Item name="feature-availability" index="29">false</Item>
 <Item name="feature-availability" index="31">false</Item>
 <Item name="feature-availability" index="32">false</Item>
 <Item name="feature-availability" index="34">false</Item>
 <Item name="feature-availability" index="36">false</Item>


Item name Item index Type Details
agent-feature-enabled no index Boolean Enables Broadworks Agent feature. true or false
callback-busy-allow no index Boolean Enables Callback functionality. true or false
enable-bluetooth-interface no index Boolean Enables Bluetooth interface on CP600. true or false
enable-WBM no index Boolean Enables Web based interface. true or false
pb-lookups-allowed no index Boolean Enables phone book lookups. true or false
refuse-call no index Boolean Enables selective call rejection. true or false
feature-availability 1 Boolean Enables selective call deflection. true or false
feature-availability 2 Boolean Enables call forwarding functionality. true or false
feature-availability 11 Boolean Enables do not disturb functionality. true or false
feature-availability 23 Boolean Enables call pickup functionality. true or false
feature-availability 24 Boolean Enables call forwarding functionality. true or false
feature-availability 27 Boolean Enables blind transfer functionality. true or false
feature-availability 28 Boolean Enables repertory dial keys. true or false
feature-availability 29 Boolean Enables BLF keys. true or false
feature-availability 31 Boolean Enables feature toggle keys. true or false
feature-availability 32 Boolean Enables CTI functionality. true or false
feature-availability 34 Boolean Enables third callleg functionality. true or false
feature-availability 36 Boolean Enables phone lock functionality. true or false

Locked config menu settings

The phone allows to lock specifc features for the user. This section will show the relevant Items to configure if you want specific menus to be locked.

 <Item name="locked_config_menu_1">true</Item>
 <Item name="locked_config_menu_2">true</Item>
 <Item name="locked_config_menu_3">true</Item>
 <Item name="locked_config_menu_4">true</Item>
 <Item name="locked_config_menu_5">true</Item>
 <Item name="locked_config_menu_8">true</Item>
 <Item name="locked_config_menu_9">true</Item>
 <Item name="locked_config_menu_10">true</Item>
 <Item name="locked_config_menu_11">true</Item>
 <Item name="locked_config_menu_14">true</Item>
 <Item name="locked_config_menu_15">true</Item>
 <Item name="locked_config_menu_16">true</Item>
 <Item name="locked_config_menu_17">true</Item>
 <Item name="locked_config_menu_18">true</Item>
 <Item name="locked_config_menu_19">true</Item>
 <Item name="locked_config_menu_20">true</Item>
 <Item name="locked_config_menu_21">true</Item>
 <Item name="locked_config_menu_22">true</Item>
 <Item name="locked_config_menu_23">true</Item>


Item name CP20X CP400 CP600 Type Details
locked_config_menu_1 Yes Yes Yes Boolean Lock country settings. true or false
locked_config_menu_2 Yes Yes Yes Boolean Lock language settings. true or false
locked_config_menu_3 Yes Yes Yes Boolean Lock date and time settings. true or false
locked_config_menu_4 Yes Yes Yes Boolean Lock call deflection settings. true or false
locked_config_menu_5 Yes Yes Yes Boolean Lock call forwarding settings. true or false
locked_config_menu_8 Yes Yes Yes Boolean Lock call waiting settings. true or false
locked_config_menu_9 Yes Yes Yes Boolean Lock call transfer settings. true or false
locked_config_menu_10 Yes Yes Yes Boolean Lock call join settings. true or false
locked_config_menu_11 Yes Yes Yes Boolean Lock display contrast settings. true or false
locked_config_menu_14 Yes Yes Yes Boolean Lock daylight saving settings. true or false
locked_config_menu_15 Yes Yes Yes Boolean Lock auto dial timer settings. true or false
locked_config_menu_16 Yes Yes Yes Boolean Lock call fwd no reply timer settings. true or false
locked_config_menu_17 Yes Yes Yes Boolean Lock hold ringback timer settings. true or false
locked_config_menu_18 Yes Yes Yes Boolean Lock music on hold settings. true or false
locked_config_menu_19 Yes Yes Yes Boolean Lock do not disturb settings. true or false

User settings

The following section is all about user settings, which the user can change on their own, but still allow to be remotely configured via DMS

 <Item name="country-iso">DE</Item>
 <Item name="language-iso">de</Item>
 <Item name="date-format">0</Item>
 <Item name="time-format">0</Item>
 <Item name="pixelsaver-timeout-xt">15</Item>
 <Item name="screensaver-enabled">true</Item>
 <Item name="inactivity-screen-type">0</Item>
 <Item name="inactivity-timeout">1</Item>
 <Item name="screensaver-image-timeout">10</Item>
 <Item name="key-click-volume">0</Item>
 <Item name="click-keys">0</Item>
 <Item name="busy-when-dialling-enabled">true</Item>
 <Item name="call-waiting-enabled">true</Item>
 <Item name="call-dnd-enabled">true</Item>
 <Item name="auto-answer">false</Item>
 <Item name="beep-on-auto-answer">false</Item>
 <Item name="beep-on-auto-reconnect">false</Item>  


Item name Type Details Related WBM config item
country-iso Enumeration Country-iso defines country specific tones (2 letter codes as per ISO 3166). See: OpenScape_Desk_Phone_IP_Supported_Country_Tones User -> Locality
language-iso Enumeration Language-iso defines the display language (2 letter codes as per ISO 639). See: OpenScape_Desk_Phone_IP_Supported_Languages User -> Locality
date-format Enumeration Defines the date format displayed. 0=dd.mm.yy, 1=mm/dd/yy User -> Locality
time-format Enumeration Defines the time format displayed. 0=24h, 1=12h User -> Locality
pixelsaver-timeout-xt Enumeration Defines the timeout for dimming and shutting off display. 15=1min/5min, 16=5min/20min, 17=30min/2h, 18=45min/4h, 19=60min/8h User -> Phone -> Energy saving
screensaver-enabled Boolean Enable the idle screen feature. true or false. User -> Phone -> Idle screen
inactivity-screen-type Enumeration Defines the type of idle screen. 0=menu screen, 1=slideshow User -> Phone -> Idle screen
inactivity-timeout Integer Defines the timeout (seconds) when idle screen will be enabled. (0, 1, 5, 10, 20, 30, 60, 120) User -> Phone -> Idle screen
screensaver-image-timeout Integer Defines the picture display time (seconds) when idle screen type is slideshow. (5, 10, 20, 30, 60) User -> Phone -> Idle screen
key-click-volume Enumeration Defines the volume level for key click. 0=off, 1=low, 2=medium, 3=high User -> Phone -> Key click
click-keys Enumeration Defines the keys active for key click. 0=dialpad, 1=all User -> Phone -> Key click
busy-when-dialling-enabled Boolean Make the phone busy receiving calls when the user starts dialing. true or false User -> Configuration -> Outgoing calls
call-waiting-enabled Boolean Enable call waiting. true or false User -> Configuration -> Incoming calls -> Handling
call-dnd-enabled Boolean Enable toggline of do not disturb setting. true or false User -> Configuration -> Incoming calls -> Handling
auto-answer Boolean Enable CTI auto answer. true or false User -> Configuration -> Incoming calls -> CTI calls
beep-on-auto-answer Boolean Enable beep tone on CTI auto answer. true or false User -> Configuration -> Incoming calls -> CTI calls
beep-on-auto-reconnect Boolean Enable beep tone on CTI reconnected calls. true or false User -> Configuration -> Incoming calls -> CTI calls

Ringer settings

The following section is all about ringer settings.

Pattern ringers

This section describes the configuration of the integrated pattern ringtones

 <Item name="ringer-audio-file"></Item>
 <Item name="ringer-tone-sequence"></Item>
 <Item name="ringer-melody"></Item>
Item name Type Details
ringer-audio-file String needs to be empty when configuring built in patterns
ringer-tone-sequence Enumeration 1=1.0sec ON, 4.0sec OFF
2=1.0sec ON, 2.0sec OFF
3=0.7sec ON, 0.7sec OFF, 0.7sec ON, 3.0sec OFF
4=2.0sec ON, 4.0sec OFF
5=1.64sec ON, 0.36sec OFF
8=0.7sec ON, 0.3sec OFF
ringer-melody Enumeration 1,2,3,4,5,6,7 or 8. Different pattern melodies

Action: SoftwareDeployment

This chapter is about SoftwareDeployment. It is used to provide a new software image file to the OpenScape Desk Phone CP devices. The following items are required, so the phone can verify the software image file and proceed with the update.

 <Item name="file-name">OS_HI_SIP_V1_R1.7.0.img</Item>
 <Item name="file-type">APP</Item>
 <Item name="file-sw-version">1.1.7.0000</Item>
 <Item name="file-sw-type">SIP</Item>


Item name Item index Type Details
file-name no index String Filename, path is relative to XML config file
file-type no index Enumeration APP for software image file
file-sw-version no index String Exact version of the software image linked to in "file-name"
file-sw-type no index Enumeration SIP or HFA. Must be SIP for use with Broadsoft

The update procedure "in a nutshell":

  • The phone will periodically check the DMS server for changes to the XML file
  • When the XML file has changed, the SoftwareDeployment action will be parsed
  • If file-sw-version differs from the version currently installed, the file at "file-name" will be downloaded and installed