Cisco 6941 Administration Guide - Page 112

Creating Custom Phone Rings, DistinctiveRingList File Format Requirements

Page 112 highlights

Creating Custom Phone Rings Chapter Creating Custom Phone Rings The Cisco Unified IP Phone ships with two default ring types that are implemented in hardware: Chirp1 and Chirp2. Cisco Unified Communications Manager also provides a default set of additional phone ring sounds that are implemented in software as pulse code modulation (PCM) files. The PCM files, along with an XML file (named DistinctiveRinglist.xml) that describes the ring list options that are available at your site, exist in the TFTP directory on each Cisco Unified Communications Manager server. For more information, see the Cisco Unified Communications Manager System Guide, Cisco TFTP, and the Cisco Unified Communications Operating System Administration Guide, Software Upgrades. The following sections describe how you can customize the phone rings that are available at your site by creating PCM files and editing the DistinctiveRinglist.xml file: • DistinctiveRingList File Format Requirements, page 6-2 • PCM File Requirements for Custom Ring Types, page 6-3 • Configuring a Custom Phone Ring, page 6-3 DistinctiveRingList File Format Requirements The DistinctiveRingList.xml file defines an XML object that contains a list of phone ring types. This file can include up to 50 ring types. Each ring type contains a pointer to the PCM file that is used for that ring type and the text that will appear on the Ring Type menu on a Cisco Unified IP Phone for that ring. The Cisco TFTP server for each Cisco Unified Communications Manager contains this file. The CiscoIPPhoneRinglist XML object uses the following simple tag set to describe the information: The following characteristics apply to the definition names. You must include the required DisplayName and FileName for each phone ring type. • DisplayName defines the name of the custom ring for the associated PCM file that will display on the Ring Type menu of the Cisco Unified IP Phone. • FileName specifies the name of the PCM file for the custom ring to associate with DisplayName. Note The DisplayName and FileName fields must not exceed 25 characters. This example shows a DistinctiveRinglist.xml file that defines two phone ring types: Analog Synth 1 Analog1.raw Analog Synth 2 Analog2.raw Cisco Unified IP Phone 6921, 6941, 6945, and 6961 Administration Guide for Cisco Unified Communications Manager 8.5 (SCCP and SIP) 6-2 OL-23769-01

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60
  • 61
  • 62
  • 63
  • 64
  • 65
  • 66
  • 67
  • 68
  • 69
  • 70
  • 71
  • 72
  • 73
  • 74
  • 75
  • 76
  • 77
  • 78
  • 79
  • 80
  • 81
  • 82
  • 83
  • 84
  • 85
  • 86
  • 87
  • 88
  • 89
  • 90
  • 91
  • 92
  • 93
  • 94
  • 95
  • 96
  • 97
  • 98
  • 99
  • 100
  • 101
  • 102
  • 103
  • 104
  • 105
  • 106
  • 107
  • 108
  • 109
  • 110
  • 111
  • 112
  • 113
  • 114
  • 115
  • 116
  • 117
  • 118
  • 119
  • 120
  • 121
  • 122
  • 123
  • 124
  • 125
  • 126
  • 127
  • 128
  • 129
  • 130
  • 131
  • 132
  • 133
  • 134
  • 135
  • 136
  • 137
  • 138
  • 139
  • 140
  • 141
  • 142
  • 143
  • 144
  • 145
  • 146
  • 147
  • 148
  • 149
  • 150
  • 151
  • 152
  • 153
  • 154
  • 155
  • 156
  • 157
  • 158
  • 159
  • 160
  • 161
  • 162
  • 163
  • 164
  • 165
  • 166
  • 167
  • 168
  • 169
  • 170
  • 171
  • 172
  • 173
  • 174
  • 175
  • 176
  • 177
  • 178
  • 179
  • 180
  • 181
  • 182
  • 183
  • 184
  • 185
  • 186
  • 187
  • 188
  • 189
  • 190
  • 191
  • 192
  • 193
  • 194
  • 195
  • 196

6-2
Cisco Unified IP Phone 6921, 6941, 6945, and 6961 Administration Guide for Cisco Unified Communications Manager 8.5 (SCCP and SIP)
OL-23769-01
Chapter
Creating Custom Phone Rings
Creating Custom Phone Rings
The Cisco Unified IP Phone ships with two default ring types that are implemented in hardware: Chirp1
and Chirp2. Cisco Unified Communications Manager also provides a default set of additional phone ring
sounds that are implemented in software as pulse code modulation (PCM) files. The PCM files, along
with an XML file (named DistinctiveRinglist.xml) that describes the ring list options that are available
at your site, exist in the TFTP directory on each Cisco Unified Communications Manager server.
For more information, see the
Cisco Unified Communications Manager System Guide
,
Cisco TFTP,
and
the
Cisco Unified Communications Operating System Administration Guide,
Software Upgrades.
The following sections describe how you can customize the phone rings that are available at your site by
creating PCM files and editing the DistinctiveRinglist.xml file:
DistinctiveRingList File Format Requirements, page 6-2
PCM File Requirements for Custom Ring Types, page 6-3
Configuring a Custom Phone Ring, page 6-3
DistinctiveRingList File Format Requirements
The DistinctiveRingList.xml file defines an XML object that contains a list of phone ring types. This file
can include up to 50 ring types. Each ring type contains a pointer to the PCM file that is used for that
ring type and the text that will appear on the Ring Type menu on a Cisco Unified IP Phone for that ring.
The Cisco TFTP server for each Cisco Unified Communications Manager contains this file.
The CiscoIPPhoneRinglist XML object uses the following simple tag set to describe the information:
<CiscoIPPhoneRingList>
<Ring>
<DisplayName/>
<FileName/>
</Ring>
</CiscoIPPhoneRingList>
The following characteristics apply to the definition names. You must include the required DisplayName
and FileName for each phone ring type.
DisplayName defines the name of the custom ring for the associated PCM file that will display on
the Ring Type menu of the Cisco Unified IP Phone.
FileName specifies the name of the PCM file for the custom ring to associate with DisplayName.
Note
The DisplayName and FileName fields must not exceed 25 characters.
This example shows a DistinctiveRinglist.xml file that defines two phone ring types:
<CiscoIPPhoneRingList>
<Ring>
<DisplayName>Analog Synth 1</DisplayName>
<FileName>Analog1.raw</FileName>
</Ring>
<Ring>
<DisplayName>Analog Synth 2</DisplayName>
<FileName>Analog2.raw</FileName>
</Ring>
</CiscoIPPhoneRingList>