Yealink VP59 Administrator's Manual
  1. Manuals
  2. Brands
  3. Yealink Manuals
  4. IP Phone
  5. VP59 Teams
  6. Administrator's manual

Yealink VP59 Administrator's Manual

Hide thumbs Also See for VP59:
1
2
3
Table Of Contents
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
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
Table of Contents

Advertisement

Quick Links

Download this manual

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the VP59 and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Related Manuals for Yealink VP59

Summary of Contents for Yealink VP59

  • Page 2: Before You Begin

    For more information on configuring and administering other Yealink products not included in this guide, refer to the product support page at Yealink Technical Support. To access the latest Release Notes or other guides for Yealink devices, refer to the Document Download page for your phone at Yealink Technical Support.
  • Page 3 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Dsskey Hide Out of Service PC Mode PIN Code Provisioning Settings Configuration PSTN Account Configuration Recording Upload Smart Noise Filtering Unify Parameters Wireless Access Point Idle Clock Display Registering Android ID on VP59 Phones...

  • Page 4: Table Of Contents

    Summary of Changes Changes for Release V85, Guide Version V85.1 Table of Contents Getting Started Requirements Yealink IP Phones in a Network Initialization Process Overview Loading the ROM File Configuring the VLAN Querying the DHCP (Dynamic Host Configuration Protocol) Server...
  • Page 5 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Wi-Fi Wi-Fi Configuration Wireless Network IP Addressing Mode Configuration IPv4 Wireless Network Configuration IPv6 Wireless Network Configuration Wireless Access Point Wireless Access Point Configuration Real-Time Transport Protocol (RTP) Ports RTP Ports Configuration Network Address Translation (NAT)
  • Page 6 Table of Contents Configuration File Customization Customizing a Configuration File Configuration File Attributes Resource Files Supported Resource Files Files Download Process Provisioning Methods Provisioning Methods Priority Web User Interface Accessing the Web User Interface Quick Login Configuration Web Server Type Configuration Navigating the Web User Interface Phone User Interface Central Provisioning...
  • Page 7 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Supported Cipher Suites Supported Trusted and Server Certificates Supported Trusted Certificates TLS Configuration Secure Real-Time Transport Protocol (SRTP) SRTP Configuration Encrypting and Decrypting Files Configuration Files Encryption Tools Configuration Files Encryption and Decryption Contact Files Encryption and Decryption...
  • Page 8 Table of Contents Satellite Mode Satellite Mode Configuration Example: Configuring the Satellite Mode Feature Repeater Settings Parameters Handset Settings Parameters Custom Handset Related Configurations Handset Firmware Upgrade Configuration Using CP960 Star Connection Feature Guidelines for Configuring Star Connection Feature CP960 Star Connection Feature Configuration Example: Configuring CP960 Star Connection Feature Audio Features Alert Tone...
  • Page 9 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Acoustic Clarity Technology Acoustic Echo Cancellation (AEC) AEC Configuration Noise Suppression Noise Suppression Configuration Automatic Gain Control (AGC) Voice Activity Detection (VAD) VAD Configuration Comfort Noise Generation (CNG) CNG Configuration Jitter Buffer Jitter Buffer Configuration...
  • Page 10 Table of Contents Language for Phone Display Customization Customizing a Language Pack for Phone Display Custom Language for Phone Display Configuration Example: Setting a Custom Language for Phone Display Language for Web Display Customization Customizing a Language Pack for Web Display Customizing a Language Pack for Note Display Custom Language for Web and Note Display Configuration Wallpaper...
  • Page 11 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Display Method on Dialing Configuration Key As Send Key As Send Configuration Softkey Layout Softkey Layout File Customization Softkey Layout File Elements and Attributes Customizing Softkey Layout File Softkey Layout Configuration Example: Setting the Soft Keys Layout in Talking State...
  • Page 12 Table of Contents Example: Customizing an Icon for a Specific Programmable Key Dsskey Hide Dsskey Hide Configuration Enhanced DSS Keys Guidelines for Configuring Enhanced DSS Keys Macro Action Strings EDK Configuration EDK List Configuration EDK User Input Prompt Configuration EDK Soft Keys Configuration Example: Using EDK Macro Strings as the Contact Number Power Saving Power Saving Configuration...
  • Page 13 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Server Redundancy Behaviors When Working Server Connection Fails Registration Method of the Failover/Fallback Mode Fallback Server Redundancy Configuration Failover Server Redundancy Configuration SIP Server Name Resolution SIP Server Name Resolution Configuration Static DNS Cache...
  • Page 14 Table of Contents Directory List File Customization Directory List File Attributes Customizing Directory List File Directory List Configuration Example: Configuring a Directory List Directory Search Settings Directory Search Settings Configuration Number Matching Settings Number Matching Settings Configuration Example: Matching Contacts with the Caller's Phone Number Using the Regular Expression Call Log Call Log Display Call Log Configuration...
  • Page 15 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Speed Dial Key Configuration Password Dial Password Dial Configuration Call Timeout Call Timeout Configuration Anonymous Call Anonymous Call Configuration Call Number Filter Call Number Filter Configuration IP Address Call IP Address Call Configuration Ignoring Incoming Calls...
  • Page 16 Table of Contents Call Transfer Configuration Transfer Mode for Dsskey Configuration Conference Conference Type Configuration Local Conference Configuration Network Conference Configuration Call Recording Call Recording Configuration Recording Upload Recording Upload Configuration Multicast Paging Multicast Paging Group Configuration Multicast Listening Group Configuration Multicast Paging Settings Multicast Paging Settings Configuration Video Features...
  • Page 17 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones BLF/BLF List Subscription Configuration Visual and Audio Alert for Monitor Lines Visual and Audio Alert for BLF Lines Configuration Example: Configuring Visual and Audio Alert for Monitor Lines LED Mode for BLF/BLF List Key...
  • Page 18 Table of Contents XML Browser Configuration Hot Desking Hot Desking Key Configuration Hot Desking Configuration General Features Line Identification Presentation CLIP and COLP Configuration Return Code for Refused Call Return Code for Refused Call Configuration Return Code for Unanswered Call Return Code for Unanswered Call Configuration Hide Feature Access Codes Hide Feature Access Codes Configuration...
  • Page 19 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Broadsoft SCA Broadsoft Call Park Broadsoft Emergency Call BroadSoft Call Waiting Sync Start2Start ACD Parameters Alcatel-Lucent Barge in Parameters Ethernet Interface MTU Parameters SIP Settings Parameters Call Settings Parameters APP Settings Configuration Unify Parameters...
  • Page 20 The IP phone does not update the configurations System Log Issues Fail to export the system log to a provisioning server (FTP/TFTP server) Fail to export the system log to a syslog server Protocols and Ports Issues What communication protocols and ports do Yealink IP phones support?
  • Page 21 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Password Issues Restore the administrator password The web screen displays "Default password is in use. Please change!" Power and Startup Issues Both PoE cable and power adapter is connected to the phone The power LED indicator has no lights...

  • Page 22: Getting Started

    There are many ways to set up a phone network using Yealink phones. The following shows an example of a net- work setup:...

  • Page 23: Initialization Process Overview

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Initialization Process Overview The initialization process of the device is responsible for network connectivity and operation of the device in your local network. Once you connect your device to the network and to an electrical supply, the device begins its ini- tialization process.

  • Page 24: Configuring The Vlan

    2. The message “Welcome Initializing… please wait” appears on the phone screen when the phone starts up. 3. The main phone screen displays the following: Time and date Android keys (for VP59/T58A) Pre-installed applications (for CP960) 4. Tap Settings > Status to check the phone status, for example, firmware version.

  • Page 25: Network Configurations

    Host Configuration Protocol (DHCPv4 or DHCPv6) server. We recommend using DHCP where possible to elim- inate repetitive manual data entry. You can also configure IPv4 or IPv6 network settings manually. Note RFC 2131 : Yealink devices comply with the DHCPv4 specifications documented in , and DHCPv6 specifications doc- RFC 3315 umented in Topics...

  • Page 26: Ipv4 Wired Network Configuration

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones It specifies IPv4 or IPv6 as the preferred wired network in a Dual-Stack mode. Description Note: It works only if “static.network.ip_address_mode” is set to 2 (IPv4 & IPv6). 0-IPv6 Permitted Values 1-IPv4 Default Web UI Network >...
  • Page 27 Network Configurations It configures the IPv4 subnet mask for the wired network. Description Note: It works only if "static.network.internet_port.type" is set to 2 (Static IP). Permitted Subnet Mask Values Default Blank Web UI Network > Basic > IPv4 Config > Configuration Type (Static IP) > Subnet Mask Settings >...

  • Page 28: Ipv6 Wired Network Configuration

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones It configures the secondary IPv4 DNS server for the wired network. Description Note: It works only if “static.network.ip_address_mode” is set to 0 (IPv4) or 2 (IPv4 & IPv6). In the DHCP environment, you need to make sure “static.network.static_dns_enable" is set to 1 (On).
  • Page 29 Network Configurations It configures the IPv6 prefix for the wired network. Description Note: It works only if “static.network.ip_address_mode” is set to 1 (IPv6) or 2 (IPv4 & IPv6), and "stat- ic.network.ipv6_internet_port.type" is set to 1 (Static IP). Permitted Integer from 0 to 128 Values Default Web UI...

  • Page 30: Dhcp Option For Ipv4

    DHCP Option 66, Option 43 and Custom Option DHCP Option 42 and Option 2 DHCP Option 12 DHCP Option 120 DHCP Option 60 Supported DHCP Option for IPv4 The following table lists common DHCP options for IPv4 supported by Yealink phones. DHCP Parameters Description Option Subnet Mask Specify the client’s subnet mask.

  • Page 31: Dhcp Option 66, Option 43 And Custom Option

    DHCP Option 42 and Option 2 Yealink phones support using the NTP server address offered by DHCP. DHCP option 42 is used to specify a list of NTP servers available to the client by IP address. NTP servers should be listed in order of preference.

  • Page 32: Dhcp Option 120 Configuration

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Parameter static.network.dhcp_host_name <y0000000000xx>.cfg Description It specifies a hostname for the phone when using DHCP. Permitted String within 99 characters Values For VP59: VP59. Default For T58A: SIP-T58. For CP960: SIP-CP960. Web UI Features > General Information > DHCP Hostname If you change this parameter, the phone will reboot to make the change take effect.

  • Page 33: Dhcp Option For Ipv6

    The phone can obtain IPv6-related parameters in an IPv6 network via DHCP option. Topics Supported DHCP Option for IPv6 DHCP Option 59 and Custom Option Supported DHCP Option for IPv6 The following table lists common DHCP options for IPv6 supported by Yealink phones. DHCP Parameters Description Option DNS Server Specify a list of DNS servers available to the client.

  • Page 34: Lldp Configuration

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones In addition to manual configuration, the phone also supports the automatic discovery of VLAN via LLDP, CDP or DHCP. The assignment takes effect in this order: assignment via LLDP/CDP, manual configuration, then assign- ment via DHCP.

  • Page 35: Manual Vlan Configuration

    Network Configurations Parameter static.network.cdp.enable <y0000000000xx>.cfg Description It enables or disables the CDP feature. 0-Disabled Permitted Values 1-Enabled, the phone attempts to determine its VLAN ID through CDP. Default Web UI Network > Advanced > CDP > Active Phone UI Settings > Advanced Settings (default password: admin) > Network > CDP > CDP Status Parameter static.network.cdp.packet_interval <y0000000000xx>.cfg It configures the interval (in seconds) that how often the phone sends the CDP request.
  • Page 36 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Parameter static.network.vlan.internet_port_priority <y0000000000xx>.cfg It configures the VLAN priority for the Internet port. Description 7 is the highest priority, 0 is the lowest priority. Note: It works only if “static.network.vlan.internet_port_enable” is set to 1 (Enabled).

  • Page 37: Dhcp Vlan Configuration

    Network Configurations Devices Web UI Network > Advanced > VLAN > PC Port > Priority Phone UI Settings > Advanced Settings (default password: admin) > Network > VLAN > PC Port > Priority If you change this parameter, the phone will reboot to make the change take effect. DHCP VLAN Configuration When the VLAN discovery method is set to DHCP, the phone examines the DHCP option for a valid VLAN ID.

  • Page 38: Wi-Fi

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Wi-Fi Wi-Fi feature enables you to connect the phones to the organization’s wireless network. You can configure the phones to operate in IPv4, IPv6, or dual-stack (IPv4/IPv6) mode, and configure IPv4 or IPv6 wireless network settings manually.
  • Page 39 Network Configurations Default Web UI Network > Wi-Fi > Wi-Fi Active Phone UI Settings > Basic Settings > Wi-Fi > Wi-Fi Parameter static.wifi.X.ssid <y0000000000xx>.cfg It configures the SSID of a specific wireless network. Description SSID is a unique identifier for accessing wireless access points. Note: It works only if “static.wifi.enable”...
  • Page 40 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Permitted Auto, PEAP, TLS, TTLS or PWD Values Default Auto Web UI Network > Wi-Fi > Add > EAP Method Parameter static.wifi.X.eap_user_name <y0000000000xx>.cfg It configures the EAP authentication username of a specific wireless network.

  • Page 41: Wireless Network Ip Addressing Mode Configuration

    Network Configurations Wireless Network IP Addressing Mode Configuration The following table lists the parameters you can use to configure IP addressing mode for the wireless network. Parameter static.network.wifi.ip_address_mode <y0000000000xx>.cfg Description It configures the IP addressing mode for the wireless network. 0-IPv4 Permitted 1-IPv6...
  • Page 42 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Default Blank Web UI Network > Basic > IPv4 Config > Configuration Type (Static IP) > IP Address Settings > Advanced Settings (default password: admin) > Network > Wi-Fi Port > IPv4 > Type (Static Phone UI IP) >...

  • Page 43: Ipv6 Wireless Network Configuration

    Network Configurations Default Blank Web UI Network > Wi-Fi > IPv4 Config > Configuration Type (Static IP)/Configuration Type (DHCP) > Pri.DNS Settings > Advanced Settings (default password: admin) > Network > Wi-Fi Port > IPv4 > Type (Static IP) > Pri.DNS Phone UI In DHCP environment: Settings >...
  • Page 44 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Note: It works only if “static.network.wifi.ip_address_mode” is set to 1 (IPv6) or 2 (IPv4 & IPv6), and "static.network.wifi.ipv6_internet_port.type" is set to 1 (Static IP). Permitted IPv6 Address Values Default Blank Web UI Network > Wi-Fi > IPv6 Config > Configuration Type (Static IP) > IP Address Settings >...

  • Page 45: Wireless Access Point

    Network Configurations Permitted IPv6 Address Values Default Blank Web UI Network > Wi-Fi > IPv6 Config > Static IPv6 DNS > Primary DNS Settings > Advanced Settings (default password: admin) > Network > Wi-Fi Port > IPv6 > Type (Static IP) >...
  • Page 46 Description It configures the name of wireless AP. Permitted String within 512 characters Values Default Yealink-XXXXXX (XXXXXX refers to the last six digits of the MAC address, uppercase) Supported All phones except CP960 Devices Web UI Network > Wireless AP > AP Name Phone UI Settings >...
  • Page 47 Network Configurations Parameter static.wifiap.generation <y0000000000xx>.cfg Description It configures the frequency of the wireless AP. 2.4-2.4G Permitted Values 5-5G Default Supported All phones except CP960 Devices Web UI Network > Wireless AP > Frequency Phone UI Settings > Basic Settings > AP Configure > AP Frequency Parameter static.wifiap.channel <y0000000000xx>.cfg Description It configures the channel of the wireless AP.

  • Page 48: Real-Time Transport Protocol (Rtp) Ports

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Real-Time Transport Protocol (RTP) Ports Since the phone supports conferencing and multiple RTP streams, it can use several ports concurrently. You can specify the phone’s RTP port range. The UDP port used for RTP streams is traditionally an even-numbered port. If the port 11780 is used to send and receive RTP for the first voice session, additional calls would then use ports 11782, 11784, 11786, and so on.

  • Page 49: Network Address Translation (Nat)

    The phones can traverse NAT gateways to establish and maintain connections with external devices. Yealink phones support three NAT traversal techniques: manual NAT, STUN and ICE. If you enable manual NAT and STUN, the phone will use the manually-configured external IP address for NAT traversal. The TURN protocol is used as part of the ICE approach to NAT traversal.
  • Page 50 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Web UI Network > NAT > Manual NAT > IP Address Parameter static.sip.nat_stun.enable <y0000000000xx>.cfg Description It enables or disables the STUN (Simple Traversal of UDP over NATs) feature. Permitted 0-Disabled 1-Enabled Values Default Web UI Network >...

  • Page 51: Keep Alive Configuration

    If you change this parameter, the phone will reboot to make the change take effect. Keep Alive Configuration Yealink phones can send keep-alive packets to the NAT device for keeping the communication port open. The following table lists the parameters you can use to configure keep alive.

  • Page 52: Rport Configuration

    Web UI Account > Advanced > Keep Alive Interval(Seconds) X is the account ID. For VP59/T58A, X=1-16; for CP960, X=1. Rport Configuration Rport allows a client to request that the server sends the response back to the source IP address and port from which the request originated.

  • Page 53: Reserved Ports

    The following tables identify the number of ports required per connection by protocol and the type of call. Call Type Number of Required Ports for T58 Number of Required Ports for VP59 8 UDP ports (4 UDP ports when not Video...

  • Page 54: Internet Port And Pc Port

    If you change this parameter, the phone will reboot to make the change take effect. Internet Port and PC Port Yealink phones support two Ethernet ports: Internet port and PC port. You can enable or disable the PC port on the phones. The CP960 phones have Internet port only.

  • Page 55: Supported Transmission Methods

    <y0000000000xx>.cfg It configures the network speed over Ethernet of the Internet port. Note: For VP59/T58A phones, you can set the transmission speed to 1000Mbps/Auto Negotiation to Description transmit in 1000Mbps if the phone is connected to the switch supports Gigabit Ethernet. We recom- mend that you do not change this parameter.

  • Page 56: Vpn

    The VPN-related files include certificates (ca.crt and client.crt), key (client.key) and the configuration file (vpn.cnf) of the VPN client. The following table lists the name of the OpenVPN certificates and key in the configuration file (vpn.cnf) for Yealink phones:...

  • Page 57: Vpn Configuration

    Network Configurations VPN Files Description ca.crt CA certificate client.crt Client certificate client.key Private key of the client VPN Configuration The following table lists the parameters you can use to configure the VPN. Parameter static.network.vpn_enable <y0000000000xx>.cfg Description It enables or disables the VPN feature. 0-Disabled Permitted Values...

  • Page 58: Example: Using Vpn Based On L2Tp Prototol

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Note: It works only if "static.network.vpn.mode" is set to 0 (L2TP). Permitted String within 512 characters Values Default Blank Web UI Network > Advanced > VPN > Layer 2 Tunneling Protocol(L2TP) > L2TP Server Address Parameter static.network.l2tp_server.username...

  • Page 59: Importing The Openvpn Configuration File To Phone

    Network Configurations 3. In the Export VPN Configuration File field, click Export to open the file download window, and then save the file to your local system. Importing the OpenVPN Configuration File to Phone You can import the OpenVPN configuration file from local to the phones via the web user interface. The changes in the configuration file will take effect after the file is imported.

  • Page 60: 802.1X Authentication

    Default If you change this parameter, the phone will reboot to make the change take effect. 802.1x Authentication Yealink phones support the following protocols for 802.1x authentication: EAP-MD5 EAP-TLS (requires Device and CA certificates, requires no password) EAP-PEAP/MSCHAPv2 (requires CA certificates)

  • Page 61: 802.1X Authentication Configuration

    Network Configurations 802.1x Authentication Configuration 802.1x Authentication Configuration The following table lists the parameters you can use to configure 802.1x authentication. Parameter static.network.802_1x.mode <y0000000000xx>.cfg Description It configures the 802.1x authentication method. 0-EAP-None, no authentication 1-EAP-MD5 2-EAP-TLS 3-EAP-MSCHAPv2 Permitted Values 4-EAP-TTLS/EAP-MSCHAPv2 5-EAP-PEAP/GTC 6-EAP-TTLS/EAP-GTC 7-EAP-FAST...
  • Page 62 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Default Blank Web UI Network > Advanced > 802.1x > Identity Phone UI Settings > Advanced Settings (default password: admin) > Network > 802.1x > Identity Parameter static.network.802_1x.md5_password <y0000000000xx>.cfg It configures the password for 802.1x authentication.

  • Page 63: Tr-069 Device Management

    TR-069 uses common transport mechanisms (HTTP and HTTPS) for communication between CPE and ACS (Auto Configuration Servers). The HTTP(S) messages contain XML-RPC methods defined in the standard for configuration and management of the CPE. For more information on TR-069, refer to Yealink TR-069 Technote. Topics Supported RPC Methods...
  • Page 64 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Parameter static.managementserver.enable <y0000000000xx>.cfg Description It enables or disables the TR-069 feature. 0-Disabled Permitted Values 1-Enabled Default Web UI Settings > TR069 > Enable TR069 Parameter static.managementserver.username <y0000000000xx>.cfg It configures the TR-069 ACS server user name used to authenticate the phone.
  • Page 65 Network Configurations Default Blank Web UI Settings > TR069 > Connection Request Password Parameter static.managementserver.periodic_inform_enable <y0000000000xx>.cfg Description It enables or disables the phone to periodically report its configuration information to the ACS server. 0-Disabled Permitted Values 1-Enabled Default Web UI Settings >...

  • Page 66: Phone Provisioning

    You can use boot files, configuration files, and resource files to configure phone features and apply feature settings to phones. You can create or edit these files using a text editor such as Notepad++. You can ask the distributor or Yealink FAE for template files. You can also obtain the template files online: http://sup- port.yealink.com/documentFront/forwardToDocumentFrontDisplayPage.

  • Page 67: Mac-Oriented Boot File

    The [$MODEL] can be added to specify settings for specific phone models. $MODEL represents the phone model name. [$MODEL] The valid phone model names are VP59, T58 and CP960. Multiple phone models are separated by commas. For example, [T58, CP960]. Enable or disable the overwrite mode.

  • Page 68: Customizing A Boot File

    “”. Multiple phone model names are separated by commas. [T58,VP59]include:config <configure/sip.cfg > [CP960]include:config “http://10.2.5.206/configure/account.cfg” ## file sip.cfg only applies to VP59 and T58A phones, file account.cfg only applies to CP960 phones 5. Specify the overwrite mode and exclude mode. For example: overwrite_mode = 1 static.specific_model.excluded_mode = 1...

  • Page 69: Mac-Oriented Cfg File

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Phone Model Common CFG file VP59 y000000000091.cfg T58A y000000000058.cfg CP960 y000000000073.cfg MAC-Oriented CFG File MAC-Oriented CFG file, which is named after the MAC address of the IP phone. For example, if the MAC address of an IP phone is 00156574B150, the name of MAC-Oriented CFG file is 00156574b150.cfg (lowercase).

  • Page 70: Configuration File Attributes

    Topic Supported Resource Files Supported Resource Files Yealink supplies some template of resource files for you, so you can directly edit the files as required. The following table lists the resource files Yealink supplies: Reference in Sec- Template File...

  • Page 71: Files Download Process

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Reference in Sec- Template File File Name Description tion 1.English.js tomization Customize replace rules for the dial Replace Rule File Replace Rule Template DialPlan.xml plan. Customization Customize dial now rules for the dial Dial Now File Cus- Dial Now Template DialNow.xml...

  • Page 72: Provisioning Methods

    The parameters in the newly downloaded configuration files will override the same parameters in files downloaded earlier. Provisioning Methods Yealink provides two ways to provision your phones: Manual Provisioning: provisioning via the local phone user interface or web user interface. Central Provisioning: provisioning through configuration files stored in a central provisioning server.

  • Page 73: Web User Interface

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Note : The provisioning priority mechanism takes effect only if “static.auto_provision.custom.protect” is set to 1. For more Keeping User’s Personalized Settings Configuration information on this parameter, refer to Static parameters have no priority. They take effect no matter what method (web user interface or phone user inter- face or configuration files) you are using for provisioning.

  • Page 74: Quick Login Configuration

    Web Server Type Configuration Yealink phones support both HTTP and HTTPS protocols for accessing the web user interface. You can configure the web server type. Web server type determines the access protocol of the web user interface. If you disable to access the web user interface using the HTTP/HTTPS protocol, both you and the user cannot access the web user interface.
  • Page 75 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Description It enables or disables to access the web user interface of the phone over a non-secure tunnel (HTTP). Permitted 0-Disabled 1-Enabled Values Default Web UI Network > Advanced > Web Server > HTTP Phone UI Settings >...

  • Page 76: Navigating The Web User Interface

    Phone Provisioning Navigating the Web User Interface When you log into the web user interface successfully, the device status is displayed on the first page of the web user interface. You can click the navigation bar to customize or click Logout to log out of the web user interface. The following figure is an example when you navigate to Settings >...

  • Page 77: Auto Provisioning Settings Configuration

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Yealink phones can obtain the provisioning server address during startup. Then the phones first download boot files and configuration files from the provisioning server and then resolve and update the configurations written in configuration files. This entire process is called auto provisioning. For more information on auto provisioning, refer Yealink SIP IP Phones Auto Provisioning Guide.
  • Page 78 Phone Provisioning Web UI Settings > Auto Provision > Attempt Expired Time(s) Parameter static.network.attempt_expired_time <y0000000000xx>.cfg It configures the timeout (in seconds) to transfer a file for HTTP/HTTPS connection. Description Note: It has a lower priority than the value defined by the parameter “static.auto_provision.attempt_ expired_time”.
  • Page 79 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Default Web UI Settings > Auto Provision > Power On Parameter static.auto_provision.repeat.enable <y0000000000xx>.cfg Description It triggers the repeatedly feature to on or off. 0-Off Permitted Values 1-On Default Web UI Settings > Auto Provision > Repeatedly Parameter static.auto_provision.repeat.minutes...
  • Page 80 Phone Provisioning If it is set to other values (for example, 60), the phone performs auto provisioning only when it has been inactivated for 60 minutes (1 hour) between the starting time and ending time. Note: The phone may perform auto provisioning when you are using the phone during office hour. It works only if “static.auto_provision.weekly.enable”...
  • Page 81 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones 0-Off 1-On, the phone performs auto provisioning at random between a starting time configured by the para- Permitted meter "static.auto_provision.flexible.begin_time" and an ending time configured by the parameter "stat- Values ic.auto_provision.flexible.end_time" on a random day within the period configured by the parameter "static.auto_provision.flexible.interval".
  • Page 82 Phone Provisioning figuration changes) during auto provisioning. Note: If the phone performs auto provisioning when receiving a SIP NOTIFY message which contains the header “Event: check-sync”, the phone will display the prompt message no matter whether the con- figuration is updated. 0-Disabled Permitted Values...

  • Page 83: User-Triggered Provisioning Settings Configuration

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Note: For each different DNS server, it works only if “static.auto_provision.dns_resolv_nosys" is set to 1 (Enabled). Permitted Integer from 1 to 60 Values Default If you change this parameter, the phone will reboot to make the change take effect.

  • Page 84: Pin Code Provisioning Settings Configuration

    You can enable the users to trigger phones to perform provisioning by dialing a PIN code. For more information on PIN code provisioning, refer to Yealink SIP IP Phones Auto Provisioning Guide. The following table lists the parameters you can use to configure settings for PIN code provisioning.

  • Page 85: Setting Up A Provisioning Server

    Supported Provisioning Protocols Supported Provisioning Server Discovery Methods Configuring a Provisioning Server Supported Provisioning Protocols Yealink phones support several transport protocols for provisioning: Trivial File Transfer Protocol (TFTP) File Transfer Protocol (FTP) Hyper Text Transfer Protocol – Secure (HTTPS) File Transfer Protocol – Secure (FTPS) Note : There are two types of FTP methods—active and passive.

  • Page 86: Supported Provisioning Server Discovery Methods

    Phone Provisioning It enables or disables the phone's MAC address to be included in the User-Agent header of Description HTTP/HTTPS request via auto provisioning. Permitted 0-Disabled 1-Enabled Values Default If you change this parameter, the phone will reboot to make the change take effect. Supported Provisioning Server Discovery Methods After the phone has established network settings, it must discover a provisioning server to obtain software updates and configuration settings.

  • Page 87: Pnp Provision Configuration

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Permitted Integer from 1 to 2147483646 Values Default Parameter static.zero_touch.network_fail_delay_times <y0000000000xx>.cfg It configures the duration time (in milliseconds) of every reconnection when zero touch module fails to Description obtain network parameters. Permitted Integer from 1000 to 2147483646...

  • Page 88: Static Provision Configuration

    Note: The configured characters must be in accordance with the actual directory name of the pro- visioning server. Permitted String within 32 characters Values For VP59 phones: VP59. Default For T58A phones: T58. For CP960 phones: CP960. Static Provision Configuration To use the static provision method, you need to obtain the provisioning server address first when configuring a pro- visioning server.

  • Page 89: Configuring A Provisioning Server

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Note : A URL should contain forward slashes instead of backslashes and should not contain spaces. Escape characters are not supported. If a user name and password are not specified as part of the provisioning server address, the User Name and Pass- word of the provisioning server configured on the phone will be used.

  • Page 90: Keeping User's Personalized Settings After Auto Provisioning

    Phone Provisioning Keeping User’s Personalized Settings after Auto Provisioning Generally, you deploy phones in batch and timely maintain company phones via auto provisioning, yet some users would like to keep the personalized settings (for example, ring tones, wallpaper or DSS keys) after auto pro- visioning.

  • Page 91: Auto Provisioning Flowchart For Keep User's Personalized Configuration Settings

    Default Auto Provisioning Flowchart for Keep User’s Personalized Configuration Settings The following shows an auto provisioning flowchart for Yealink phones when a user wishes to keep the user’s per- sonalized configuration settings. Example: Keeping User’s Personalized Settings This section shows you how to keep the personalized settings.

  • Page 92: Clearing User's Personalized Configuration Settings

    Phone Provisioning static.auto_provision.custom.protect =1 After provisioning, if the users make changes via the phone user interface or web user interface, the MAC-local.cfg file with non-static personal settings generates locally. Scenario: Keeping user’s personalized settings when upgrading the firmware If you set “ static.auto_provision.custom.sync =1 ”, then the phones attempt to upload the MAC-local.cfg file to the pro- visioning server each time the file updates.
  • Page 93 The phone-specific configuration file Linekey.cfg only applies to T58A and VP59 phones. The only difference is that T58A and VP59 phones will download both the two files since the exclude mode is disabled by default. The other phones will only download the CustomSettings.cfg file.

  • Page 94: Security Features

    You can also customize the access permission for the configurations on the web user interface and phone user interface. Yealink phones support the access levels of admin, var, and user. When logging into the web user interface or access advanced settings on the phone, as an administrator, you need an administrator password to access various menu options.

  • Page 95: User Access Level Configuration

    Note: You cannot change the user password via the phone user interface. User Access Level Configuration For more information, refer to Yealink SIP IP Phones Configuration Guide for User Access Level. The following table lists the parameters you can use to configure the user access level.

  • Page 96: Auto Logout Time

    Phone Lock Configuration Operation Behaviors on Lock Phone For VP59/T58A, all keys and screen are locked except the HEADSET key, Volume key, digit keys, # key, * key, and Speakerphone key. For CP960, when the phone is locked, mute touch keys and touch screen (except ) are locked.

  • Page 97: Transport Layer Security (Tls)

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Parameter phone_setting.phone_lock.enable <y0000000000xx>.cfg Description It enables or disables the phone lock feature. Permitted 0-Disabled 1-Enabled Values Default Web UI Features > Phone Lock > Phone Lock Enable Phone UI Settings > Advanced Settings (default password: admin) > Phone Lock > Lock Enable Parameter phone_setting.phone_lock.unlock_pin...

  • Page 98: Supported Cipher Suites

    Security Features Yealink phones support TLS version 1.0, 1.1 and 1.2. When TLS is enabled for an account, the SIP message of this account will be encrypted, and a lock icon appears on the LCD screen after the successful TLS negotiation.

  • Page 99: Supported Trusted And Server Certificates

    The format of the server certificate files must be *.pem and *.cer and the maximum file size is 5MB. A unique server certificate: It is unique to an IP phone (based on the MAC address) and issued by the Yealink Certificate Authority (CA).
  • Page 100 Security Features Thawte Primary Root CA Thawte Primary Root CA - G2 Thawte Primary Root CA - G3 Thawte Server CA VeriSign Class 1 Public Primary Certification Authority VeriSign Class 1 Public Primary Certification Authority - G2 VeriSign Class 1 Public Primary Certification Authority - G3 VeriSign Class 2 Public Primary Certification Authority - G2 VeriSign Class 2 Public Primary Certification Authority - G3 VeriSign Class 3 Public Primary Certification Authority...
  • Page 101 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Thawte SSL CA StartCom Certification Authority StartCom Certification Authority G2 Starfield Services Root Certificate Authority - G2 RapidSSL CA Go Daddy Root Certificate Authority - G2 Cybertrust Global Root SectigoSSLCA Sectigo RSA Domain Validation Secure Server CA...
  • Page 102 Security Features Chambers of Commerce Root - 2008 China Internet Network Information Center EV Certificates Root CNNIC ROOT Sectigo Certification Authority Sectigo ECC Certification Authority ComSign Secured CA DST ACES CA X6 D-TRUST Root Class 3 CA 2 2009 D-TRUST Root Class 3 CA 2 EV 2009 EBG Elektronik Sertifika Hizmet Sağlayıcısı...

  • Page 103: Tls Configuration

    Note : Yealink endeavors to maintain a built-in list of most common used CA Certificates. Due to memory constraints, we can- not ensure a complete set of certificates. If you are using a certificate from a commercial Certificate Authority not in the list above, you can send a request to your local distributor.
  • Page 104 0-TLS 1.0, TLS 1.1 and TLS 1.2 Permitted 1-TLS 1.1 and TLS 1.2 Values 2-TLS 1.2 Default Supported All phones except VP59 Devices Parameter static.security.trust_certificates <y0000000000xx>.cfg Description It enables or disables the phone to only trust the server certificates in the Trusted Certificates list. 0-Disabled Permitted 1-Enabled, the phone will authenticate the server certificate based on the trusted certificates list.
  • Page 105 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Permitted 0-Disabled 1-Enabled Values Default Web UI Security > Trusted Certificates > Common Name Validation Parameter static.security.dev_cert <y0000000000xx>.cfg Description It configures the type of device certificates for the phone to send for TLS authentication.

  • Page 106: Secure Real-Time Transport Protocol (Srtp)

    “static.security.dev_cert” and “static.phone_setting.reserve_certs_config.enable” will not be reset. Default X is the account ID. For VP59/T58A, X=1-16; for CP960, X=1. Y is the server ID. Y=1-2. If you change this parameter, the phone will reboot to make the change take effect.

  • Page 107: Srtp Configuration

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones m=audio 11780 RTP/SAVP 0 101 a=rtpmap:0 PCMU/8000 a=rtpmap:101 telephone-event/8000 a=crypto:1 AES_CM_128_HMAC_SHA1_80 inline:NGY4OGViMDYzZjQzYTNiOTNkOWRiYzRlMjM0Yzcz a=sendrecv a=ptime:20 a=fmtp:101 0-15 When SRTP is enabled on both phones, RTP streams will be encrypted, and a lock icon appears on the LCD screen of each IP phone after a successful negotiation.

  • Page 108: Encrypting And Decrypting Files

    Default X is the account ID. For VP59/T58A, X=1-16; for CP960, X=1. Encrypting and Decrypting Files Yealink phones support downloading encrypted files from the server and encrypting files before/when uploading them to the server. You can encrypt the following files: Configuration files: MAC-Oriented CFG file (<MAC>.cfg), Common CFG file (y0000000000xx.cfg), MAC-local...

  • Page 109: Encryption And Decryption Configuration

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones You can configure the contact files to be automatically encrypted using 16-character/32 characters symmetric keys (configured by “static.auto_provision.aes_key.mac”) when uploading to the server (by setting “static.auto_pro- vision.encryption.directory=1”). The encrypted contact files have the same file names as before. The encrypted con- tact files can be downloaded from the server and decrypted using 16-character/32 characters symmetric keys during auto provisioning.
  • Page 110 Security Features Default Blank Web UI Settings > Auto Provision > Common AES Key Phone UI Settings > Advanced Settings (default password: admin) > Set AES Key > Common AES Parameter static.auto_provision.aes_key.mac <y0000000000xx>.cfg It configures the plaintext AES key for encrypting/decrypting the MAC-Oriented files (<MAC>.cfg, <MAC>-local.cfg and <MAC>-contact.xml).
  • Page 111 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones parameter “static.auto_provision.aes_key.mac”. Default Parameter static.auto_provision.encryption.call_log <y0000000000xx>.cfg Description It enables or disables the phone to encrypt <MAC>-calllog.xml file using the plaintext AES key. 0-Disabled, the call log file will be uploaded unencrypted and will replace the one (encrypted or unen- crypted) stored on the server if you have configured to back up the call log to the server by the para- meter “static.auto_provision.local_calllog.backup.enable”.

  • Page 112: Incoming Network Signaling Validation

    If you change this parameter, the phone will reboot to make the change take effect. Incoming Network Signaling Validation Yealink phones support the following three optional levels of security for validating incoming network signaling: Source IP address validation: ensure the request is received from an IP address of a server belonging to the set of target SIP servers.

  • Page 113: Usb Port Lock

    Note: For T58A phones, this parameter only applies to the rear USB port; for VP59 phones, this para- Description meter only applies to the side USB port. So if you want to disable all USB ports for the VP59/T58A phones, you need to set "static.usb.power.enable" and "static.camera.function.enable" to 0 (Disabled).

  • Page 114: Firmware Upgrade

    You can download the latest firmware online: http://sup- port.yealink.com/documentFront/forwardToDocumentFrontDisplayPage. The following table lists the associated and latest firmware name for each device model (X is replaced by the actual firmware version). IP Phone Model Firmware Name Example VP59 91.x.x.x.rom 91.283.0.30.rom T58A 58.x.x.x.rom 58.84.0.10.rom CP960 73.x.x.x.rom 73.84.0.10.rom...

  • Page 115: Using Handsets With Vp59/T58A Phones

    VP59/T58A phone, a DECT USB dongle DD10K and at least a handset. The supported handsets include W52H, W56H, W53H, CP930W and DD phone. The VP59/T58A phone acts as a base station and Handset 1. Users can register up to other four handsets to one phone. It allows users to manage calls when they are away from their desk.

  • Page 116: Handset Keypad Light

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones -1-Do not modify the configuration. Permitted 0-Disabled, the backlight will be turned off after the handset is idle for about 10 seconds. Values 1-Enabled, the backlight will be turned off after the handset is idle for about 30 minutes.

  • Page 117: Handset Wallpaper

    Using Handsets with VP59/T58A Phones Handset Wallpaper Wallpaper is an image used as the background for the handset idle screen. Users can select an image from hand- set’s built-in background. Topic Handset Wallpaper Configuration Handset Wallpaper Configuration The following table lists the parameter you can use to configure the handset wallpaper.

  • Page 118: Handset Name

    After the handset is registered to the phone, you can assign one or more outgoing lines or incoming lines for the handset. For VP59, the phone acts as the Handset 1 (VP59 Phone); For T58A, the phone acts as the Handset 1 (T58 Phone).

  • Page 119: Number Assignment Configuration

    4-Line 4 5-Line 5 Multiple line IDs are separated by commas. The incoming line for VP59 Phone/T58 Phone is line 1-line5; The incoming line for handset 2 is line 2. Default The incoming line for handset 3 is line 3.

  • Page 120: End Call On Hook

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Web UI Account > Number Assignment > Outgoing lines Parameter handset.X.dial_out_default_line <y0000000000xx>.cfg Description It configures the default line to place outgoing calls for a specific handset. Permitted Integer from 1 to 5 Values Default...

  • Page 121: Advisory Tones Configuration

    Using Handsets with VP59/T58A Phones Low Battery: plays when battery capacity is low and the handset requires being charged. For CP930W, you can only configure it by navigating to Menu > Settings > Basic Settings > Sound > Advisory Tones > Low Battery.

  • Page 122: Base Pin

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Supported W53H, W56H, CP930W Devices W56H/W53H: OK > Settings > Audio > Advisory Tones > Low Battery Handset UI CP930W: Menu > Settings > Basic Settings > Sound > Low Battery Base PIN To avoid unauthorized registration or access to some features on the handset, you should keep the base PIN secret.

  • Page 123: Dect Intercom

    Using Handsets with VP59/T58A Phones Note: It works only if “base.double_pin_code.enable” is set to 1 (Enabled). Permitted Integer from 0000 to 9999 Values Default 0000 DECT Intercom Intercom is a useful feature in an office environment to quickly connect with the operator or the secretary. Users can make internal intercom calls and external intercom calls on the handset.

  • Page 124: Shared Directory Configuration

    Directory > Dect Directory > Import Contacts > Import to (Shared Directory) > Select .xml file form Shared Contact File Customization You can customize the shared contacts using local contact template. You can ask the distributor or Yealink FAE for local contact template. You can also obtain the template online: http://support.yealink.com/documentFront/forwardToDocumentFrontDisplayPage. Topics...

  • Page 125: Customizing Shared Contact File

    4. Save the changes and place this file to the provisioning server. Satellite Mode Yealink desk phone can be bound with a handset. The handset can share the line and contacts with the phone. The call can be shifted between the phone and handset.

  • Page 126: Satellite Mode Configuration

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones When a call is made from 1001 to 1002, both the phone and the handset ring. Users can answer the call either on the phone or handset. When using satellite mode, note the following: The incoming and outgoing lines originally assigned to the handset are disabled.

  • Page 127: Example: Configuring The Satellite Mode Feature

    Using Handsets with VP59/T58A Phones Web UI Status > Handset > Satellite Mode > Select Handset Phone UI DECT Settings > Satellite Mode > Select handset Parameter features.ms.X.mode <y0000000000xx>.cfg It configures the satellite mode for the phone. Description Note: It works only if “features.ms.X.slave_handset_number” is configured correctly.

  • Page 128: Repeater Settings Parameters

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones features.ms.1.slave_handset_number = 2 features.ms.1.mode = 0 After provisioning, users cannot switch the active call between the phone and handset. Only the device which is dur- ing the call can initiate a new call. If users not in a call try to initiate a call on the phone/handset, the phone/handset screen will prompt "Path Busy".
  • Page 129 Using Handsets with VP59/T58A Phones Default Supported W52H Devices Handset UI OK > Settings > Display > Notification Light > Missed Call Parameter custom.handset.voice_mail_notify_light.enable <y0000000000xx>.cfg It enables or disables the message key LED to flash when the handset receives a voice mail.
  • Page 130 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones 6-Spanish 7-Turkish 8-Czech 9-Swedish 10-Hebrew 11-Russian Default Supported W52H, W53H, W56H, CP930W Devices W52H/W53H/W56H: OK > Settings > Language Handset UI CP930W: Menu > Settings > Basic Settings > Language Parameter custom.handset.auto_answer.enable <y0000000000xx>.cfg It enables or disables a user to answer incoming calls by lifting the handset from the charger cradle without pressing the off-hook key.
  • Page 131 Using Handsets with VP59/T58A Phones Parameter custom.handset.date_format <y0000000000xx>.cfg Description It configures the date format for all registered handsets. 0-WWW MMM DD 1-DD-MMM-YY 2-YYYY-MM-DD 3-DD/MM/YYYY 4-MM/DD/YY 5-DD MMM YYYY Permitted Values 6-WWW DD MMM Use the following mapping: “WWW” represents the abbreviation of the week;...

  • Page 132: Custom Handset Related Configurations

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones vision.custom.handset.protect" is set to 1 (Enabled), the personalized handset settings will not be over- ridden. Default Supported All handsets except DD phones Devices Parameter static.auto_provision.custom.handset.protect <y0000000000xx>.cfg It enables or disables the handsets to keep user personalized settings after handset reboot or regis- tration.

  • Page 133: Handset Firmware Upgrade Configuration

    Using Handsets with VP59/T58A Phones Parameter Related Topic custom.handset.low_battery_tone.enable custom.handset.confirmation_tone.enable Advisory Tones Configuration custom.handset.keypad_tone.enable custom.handset.keypad_light.enable Handset Keypad Light Configuration custom.handset.backlight_in_charger.enable Handset Backlight Configuration custom.handset.backlight_out_of_charger.enable custom.handset.screen_saver.enable Handset Screen Saver Configuration custom.handset.auto_intercom DECT Intercom Configuration custom.handset.language Handset Settings Parameters Handset Firmware Upgrade Configuration The following table lists the parameters you can use to upgrade handset firmware.
  • Page 134 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones 0-Disabled Permitted Values 1-Enabled, the handset will pop up the message “Handset has a new firmware, update now?”. Default Supported All handsets except DD phones Devices Parameter over_the_air.handset_trigger <y0000000000xx>.cfg It enables or disables to upgrade the handset firmware compulsively when the handset is registered to a phone or turned on successfully.

  • Page 135: Using Cp960 Star Connection Feature

    Using CP960 Star Connection Feature Using CP960 Star Connection Feature You can deploy up to four CP960 conference phones in a star layout in a large meeting room, one as the master phone and others as the slave phones. The master phone keeps all features, while the slave phones only sync some key features of the master phone, such as DND and call mute.

  • Page 136: Cp960 Star Connection Feature Configuration

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones firmware version. If you upgrade firmware via auto provisioning, both the master phone and slave phones will be upgraded. Related Topic CP960 Star Connection Feature Configuration CP960 Star Connection Feature Configuration The following table lists the parameters you can use to configure CP960 star connection feature.

  • Page 137: Example: Configuring Cp960 Star Connection Feature

    Using CP960 Star Connection Feature If you change this parameter, the phone will reboot to make the change take effect. Related Topic Example: Configuring CP960 Star Connection Feature Example: Configuring CP960 Star Connection Feature Scenario Conditions The MAC address of phone A is 805EC0092F33. The MAC address of phone B is 805EC0092F4B.

  • Page 138: Audio Features

    It configures that after you enter a specific number on the dialing screen, the phone will replay the dial tone. Example: Description features.redial_tone = 123 The phone will continue to play the dial tone after entering “123” on the dialing screen. Permitted Integer within 6 digits Values Default Blank Supported T58A, VP59 Devices...
  • Page 139 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Web UI Features > Audio > Redial Tone Parameter account.X.dial_tone <MAC>.cfg Description It configures the dial tone for the phone. 0-Default (depend on the country tone by “voice.tone.country”) Permitted 1-440/250,0/250 Values 2-1000/250,0/250 Default Supported...

  • Page 140: Ring Tones

    Custom Ringtone Limit The ring tone format must meet the following: Phone Model Format Single File Size VP59/T58A/CP960 .wav <=8MB Note : The ring tone file must be in PCMU/PCMA audio format, mono channel, 8K sample rate, and 16-bit resolution.

  • Page 141: Distinctive Ring Tones

    : If the caller already exists in the local directory, the ring tone assigned to the caller should be preferentially played. Topics Supported Alert-Info Headers Format Distinctive Ring Tones Configuration Supported Alert-Info Headers Format Yealink phones support Alert-Info headers in four formats: Bellcore-drN, ringtone-N (or MyMelodyN), <URL > and info=info text;x-line-id=0.

  • Page 142: Alert-Info: Bellcore-Drn

    Audio Features Note : If the Alert-Info header contains multiple types of keywords, the phone will process the keywords in the following order: AutoAnswer > URL > info text/Bellcore-drN/ringtone-N (ringtone-RingN) > MyMelodyN (MyMelodyRingN). Topics Alert-Info: Bellcore-drN Alert-Info: ringtone-N/Alert-Info: ringtone-RingN.wav (or Alert-Info: MyMelodyN/Alert-Info: MyMelodyRingN.wav) Alert-Info: <URL >...

  • Page 143: Mymelodyringn.wav)

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Pattern Minimum Duration Nominal Duration Maximum Duration Bellcore Tone Pattern Cadence (ms) (ms) (ms) Ringing Long 1025 Silent Bellcore-dr2 Ringing Long 1025 Silent 3475 4000 4400 Ringing Short Silent Ringing Short Bellcore-dr3 Silent Ringing Long...

  • Page 144: Alert-Info:

    Audio Features Alert-Info: <http://10.1.0.31 > ;x-line-id=0;info=MyMelody2 The following table identifies the corresponding local ring tone: Value of N Ring Tone Ring1.wav Ring1.wav Ring2.wav Ring2.wav Ring3.wav Ring3.wav Ring4.wav Ring4.wav Ring5.wav Ring5.wav Ring6.wav Ring6.wav Ring7.wav Ring7.wav Ring8.wav Ring8.wav Silent.wav Silent.wav Splash.wav Splash.wav N<1 or N >...

  • Page 145: Distinctive Ring Tones Configuration

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Auto Answer If the INVITE request contains the following type of strings, the phone will answer incoming calls automatically without playing the ring tone: Alert-Info: Auto Answer Alert-Info: info = alert-autoanswer Alert-Info: answer-after = 0 (or Alert-Info: Answer-After = 0)

  • Page 146: Ringer Device

    Settings > Ring > Internal Ringer X > File Web UI X is the account ID. For VP59/T58A, X=1-16; for CP960, X=1. X is the ring tone ID. X=1-10. Ringer Device You can use either or both the speaker and the headset as the ringer devices. You can configure which ringer device to be used when receiving an incoming call.

  • Page 147: Ringer Volume Configuration

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Ringer Volume Configuration You can configure the ringer volume as a fixed level, so the user cannot adjust the ringer volume on the phone. This feature is used to avoid missing calls when the user turns down the ringer volume.
  • Page 148 Audio Features Values Default Supported All phones except CP960 Devices Web UI Features > Audio > Handset Send Volume (-50~50) Parameter voice.handset.autoreset_spk_vol <y0000000000xx>.cfg Description It configures the handset's volume level during a call. 0-The handset volume at the end of a call persists between calls. Permitted 1 to 15-The handset volume does not persist between calls, and resets to this specified level each Values...

  • Page 149: Tones

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Permitted Integer from -50 to 50 Values Default Supported All phones except CP960 Devices Parameter voice.handset.tia4965.enable <y0000000000xx>.cfg It enables or disables the handset's volume level to be reset to level 11 after the call if the volume level for the current call exceeds the standards.

  • Page 150: Tones Configuration

    Audio Features China Czech Denmark Finland France Germany Great Britain Greece Hungary Lithuania India Italy Japan Mexico New Zealand Netherlands Norway Portugal Spain Switzerland Sweden Russia United States Chile Czech ETSI Configured tones can be heard on the phones in the following conditions. Condition Description Dial...
  • Page 151 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Parameter voice.tone.country <y0000000000xx>.cfg Description It configures the country tone for the phones. Custom, Australia, Austria, Brazil, Belgium, Chile, China, Czech, Czech ETSI, Denmark, Finland, Permitted France, Germany, Great Britain, Greece, Hungary, Lithuania, India, Italy, Japan, Mexico, New Zea-...
  • Page 152 Audio Features Permitted String Values Default 350+440/3000 Web UI Settings > Tones > Secondary Dial Parameter voice.tone.ring <y0000000000xx>.cfg It customizes the ringback tone. The value format is Freq/Duration. For more information on the value format, refer to the parameter “voice.tone.dial”. Description Note: It works only if “voice.tone.country”...
  • Page 153 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Permitted any code that the server can return Values Default Blank Parameter voice.tone.callwaiting <y0000000000xx>.cfg It customizes the call waiting tone. The value format is Freq/Duration. For more information on the value format, refer to the parameter Description “voice.tone.dial”.

  • Page 154: Audio Codecs

    Audio Features Default Blank Web UI Settings > Tones > Stutter Parameter voice.tone.autoanswer <y0000000000xx>.cfg It customizes the warning tone for the auto answer. The value format is Freq/Duration. For more information on the value format, refer to the parameter “voice.tone.dial”. Description Note: It works only if “voice.tone.country”...

  • Page 155: Audio Codecs Configuration

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Codec Algorithm Reference Bit Rate Sample Rate Packetization Time G729 G.729 RFC 3551 8 Kbps 8 Ksps 20ms G726-16 G.726 RFC 3551 16 Kbps 8 Ksps 20ms G726-24 G.726 RFC 3551 24 Kbps 8 Ksps...
  • Page 156 Audio Features Parameter account.X.codec.<payload_type>.enable <MAC>.cfg It enables or disables the specified audio codec. The name (payload_type) of the audio codec: g722_1c_48kpbs-G.722.1c (48kb/s) g722_1c_32kpbs-G.722.1c (32kb/s) g722_1c_24kpbs-G.722.1c (24kb/s) g722_1_24kpbs-G.722.1 (24kb/s) g722-G722 pcmu-PCMU pcma-PCMA g729-G729 g726_16-G726-16 Description g726_24-G726-24 g726_32-G726-32 g726_40-G726-40 g723_53-G723_53 g723_63-G723_63 opus-Opus ilbc_15_2kpbs-iLBC_15_2kbps ilbc_13_33kpbs-iLBC_13_33kbps Example:...
  • Page 157 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones When the audio codec is G726-32, the default value is 0; When the audio codec is G726-40, the default value is 0; When the audio codec is G723_53, the default value is 0; When the audio codec is G723_63, the default value is 0;...
  • Page 158 Account > Codec > Opus Sample Rate Parameter voice.g726.aal2.enable <y0000000000xx>.cfg Description It enables or disables the phone to use the AAL2-G726-16, 24, 32 and 40 MIME type. Permitted 0-Disabled 1-Enabled Values Default X is the account ID. For VP59/T58A, X=1-16; for CP960, X=1.

  • Page 159: Packetization Time (Ptime)

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Packetization Time (PTime) PTime is a measurement of the duration (in milliseconds) that how long the audio data in each RTP packet is sent to the destination, and defines how much the network bandwidth is used for the RTP stream transfer. Before estab- lishing a conversation, codec and ptime are negotiated through SIP signaling.

  • Page 160: Early Media

    Web UI Account > Advanced > PTime (ms) X is the account ID. For VP59/T58A, X=1-16; for CP960, X=1. Early Media The early media refers to the media (for example, audio and video) played to the caller before a SIP call is actually established.

  • Page 161: Headset Prior

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Description It enables or disables the phone to handle the received second 183 message as the 180 message. 0-Disabled Permitted 1-Enabled, the phone will play the early media first and play the local ringback tone when receiving Values the second 183 message.

  • Page 162: Dual Headset Configuration

    Smart Noise Filtering Acoustic Echo Cancellation (AEC) Yealink phones employ advanced AEC for hands-free operation. You can configure the AEC feature to remove the echo of the local loudspeaker from the local microphone without removing the near-end speech. AEC is not normally required for calls via the handset. In some cases, where echo is experienced by the remote party, AEC may be used to reduce/avoid echo when you use the handset.

  • Page 163: Aec Configuration

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones AEC Configuration The following table lists the parameter you can use to configure AEC. Parameter voice.echo_cancellation <y0000000000xx>.cfg Description It enables or disables the AEC (Acoustic Echo Canceller) feature. Permitted 0-Disabled Values 1-Enabled Default Web UI Settings >...

  • Page 164: Comfort Noise Generation (Cng)

    Jitter Buffer Yealink phones support two types of jitter buffers: fixed and adaptive. A fixed jitter buffer adds the fixed delay to voice packets. You can configure the delay time for the static jitter buffer on the phones. An adaptive jitter buffer is capable of adapting the changes in the network's delay.
  • Page 165 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones It configures the minimum delay time (in milliseconds) of the jitter buffer in the wired network. Description Note: It works only if “voice.jib.adaptive” is set to 1 (Adaptive). The value of this parameter should be less than or equal to that of “voice.jib.normal”.

  • Page 166: Smart Noise Block

    Audio Features Default Parameter voice.jib.wifi.normal <y0000000000xx>.cfg It configures the normal delay time (in milliseconds) of the jitter buffer in the wireless network. Description Note: It works only if “voice.jib.wifi.adaptive” is set to 0 (Fixed). The value of this parameter should be greater than or equal to that of “voice.jib.wifi.min”...

  • Page 167: Smart Noise Filtering

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Off soft key during the call to disable it. Default Supported All phones except CP960 Devices Web UI Settings > Voice > Acoustic Shield > Acoustic Shield Mode Parameter features.acoustic_shield.level <y0000000000xx>.cfg It configures the noise suppression level for handsets and headsets.

  • Page 168: Dtmf Keypad

    Audio Features Suppress DTMF Display Transfer via DTMF Local DTMF Tone DTMF Keypad The DTMF keypad is laid out in a 4×4 matrix, with each row representing a low frequency, and each column rep- resenting a high frequency. Pressing a digit key (such as '1') will generate a sinusoidal tone for each of two fre- quencies (697 and 1209 hertz (Hz)).
  • Page 169 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Default Web UI Account > Advanced > DTMF Type Parameter account.X.dtmf.dtmf_payload <MAC>.cfg It configures the value of DTMF payload. Description Note: It works only if “account.X.dtmf.type” is set to 1 (RFC2833) or 3 (RFC2833 + SIP INFO).

  • Page 170: Suppress Dtmf Display

    Integer from 0 to 300 Values Default X is the account ID. For VP59/T58A, X=1-16; for CP960, X=1. If you change this parameter, the phone will reboot to make the change take effect. Suppress DTMF Display Suppress DTMF display allows the phones to suppress the display of DTMF digits during an active call. DTMF digits are displayed as “*”...

  • Page 171: Transfer Via Dtmf Configuration

    These metrics can be sent between the phones in RTCP-XR packets. These metrics can also be sent in SIP PUBLISH messages to a central voice quality report collector. Yealink phones support two mechanisms for voice quality monitoring: RTCP-XR and VQ-RTCPXR.

  • Page 172: Rtcp-Xr

    Audio Features VQ-RTCPXR RTCP-XR The RTCP-XR mechanism, compliant with RFC 3611-RTP Control Extended Reports (RTCP XR), provides the met- rics contained in RTCP-XR packets for monitoring the quality of calls. These metrics include network packet loss, delay metrics, analog metrics, and voice quality metrics. Topic RTCP-XR Configuration RTCP-XR Configuration...

  • Page 173: Voice Quality Reports

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Voice Quality Reports Three types of quality reports can be enabled: Session: Generated at the end of a call. Interval: Generated during a call at a configurable period. Alert: Generated when the call quality degrades below a configurable threshold.
  • Page 174 Audio Features Values Default Blank Web UI Settings > Voice Monitoring > Warning Threshold for Moslq Parameter phone_setting.vq_rtcpxr_moslq_threshold_critical <y0000000000xx>.cfg It configures the threshold value of listening MOS score (MOS-LQ) multiplied by 10. The threshold value of MOS-LQ causes the phone to send a critical alert quality report to the central report collector. For example, a configured value of 28 corresponds to the MOS score 2.8.

  • Page 175: Vq-Rtcpxr Display

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones VQ-RTCPXR Display You can check the voice quality data of the last call via the web user interface or phone user interface. You can also specify the options of the RTP status to be displayed on the phone user interface. Options of the RTP status dis- played on the web user interface cannot be specified.
  • Page 176 Audio Features Web UI Settings > Voice Monitoring > Report Options on Phone > Current Time Parameter phone_setting.vq_rtcpxr_display_local_call_id.enable <y0000000000xx>.cfg It enables or disables the phone to display Local User on the phone screen. Description Note: It works only if “phone_setting.vq_rtcpxr.states_show_on_gui.enable” is set to 1 (Enabled). Permitted 0-Disabled 1-Enabled...
  • Page 177 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Note: It works only if “phone_setting.vq_rtcpxr.states_show_on_gui.enable” is set to 1 (Enabled). Permitted 0-Disabled 1-Enabled Values Default Web UI Settings > Voice Monitoring > Report Options on Phone > Jitter Buffer Max Parameter phone_setting.vq_rtcpxr_display_packets_lost.enable <y0000000000xx>.cfg It enables or disables the phone to display Packets lost on the phone screen.

  • Page 178: Central Report Collector

    It is helpful for users not to be disturbed by the tone. Yealink phones support the following three methods to enable the silent mode feature: Turn on the silent mode via the phone user interface at the path: Settings > Basic Settings > Sound.

  • Page 179: Silent Mode Configuration

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Topic Silent Mode Configuration Silent Mode Configuration The following table lists the parameter you can use to configure silent mode. Parameter phone_setting.permit_silent_mode.enable <y0000000000xx>.cfg Description It enables or disables the user to have the permission to use the silent mode feature.

  • Page 180: Phone Customization

    Language for Web Display Customization Supported Languages You can ask the distributor or Yealink FAE for language packs. You can also obtain the language packs online: http://support.yealink.com/documentFront/forwardToDocumentFrontDisplayPage. The following table lists available languages and associated language packs supported by the phone user inter-...

  • Page 181: Language Display Configuration

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Phone User Interface Web User Interface Language Language Pack Language Language Pack Note Language Pack English 000.GUI.English.lang English 1.English.js 1.English_note.xml Chinese Simplified 001.GUI.Chinese_S.lang Chinese Simplified 2.Chinese_S.js 2.Chinese_S_note.xml Chinese Tra- Chinese Traditional 002.GUI.Chinese_T.lang 3.Chinese_T.js 3.Chinese_T_note.xml...

  • Page 182: Language For Phone Display Customization

    Phone Customization Language for Phone Display Customization You can customize the translation of the existing language on the phone user interface. Languages available for selection depend on language packs currently loaded to the IP phone. You can also add new languages (not included in the available language list) available for phone display by loading language packs to the IP phone.

  • Page 183: Example: Setting A Custom Language For Phone Display

    You can also customize the translation of the note lan- guage pack. The note information is displayed in the question mark "?" of the web user interface. You can ask the distributor or Yealink FAE for language packs. You can also obtain the language packs online: http://support.yealink.com/documentFront/forwardToDocumentFrontDisplayPage.

  • Page 184: Customizing A Language Pack For Note Display

    Phone Customization Modify the characters within the double quotation marks on the right of the colon. Do not modify the translation item on the left of the colon. The following shows a portion of the language pack “1.English.js” for the web user interface: Save the language pack and place it to the provisioning server.

  • Page 185: Custom Language For Web And Note Display Configuration

    Wallpaper is a picture used as the background of the phone. The phone comes with a default picture. You can change it to a built-in picture or custom wallpaper from personal pictures. The wallpaper is applicable to the VP59/T58A/CP960 phones and expansion module EXP50 (connected to the T58A phones).

  • Page 186: Wallpaper Customization

    Phone Customization For VP59/T58A phones, you can also set a custom picture stored in local or USB flash drive (if connected) as the wallpaper. Note : The wallpaper will display on the entire screen. Note that the line key labels, time and date, icons, and Android keys will display over the wallpaper.

  • Page 187: Deleting A Custom Picture

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Description It configures the access URL of the custom wallpaper picture. Permitted URL within 511 characters Values Default Blank Web UI Settings > Preference > Upload Wallpaper > Custom Wallpaper > Upload Wallpaper Deleting a Custom Picture You can delete the uploaded custom pictures for a specific IP phone via the web user interface at the path: Settings >...

  • Page 188: Backlight

    Phone Customization 1800-30min Default Phone UI Settings > Basic Settings > Display > Screen Saver > Screensaver Waiting Time Parameter screensaver.type <y0000000000xx>.cfg Description It configures the type of screen saver to display. 0-Clock 1-Colours Permitted Values 2-Photo Frame 3-Photo Table Default Phone UI Settings >...

  • Page 189: Backlight And Time Configuration

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Phone Model (and the connected Configuration Options expansion module) VP59 Backlight Time CP960 Backlight and Time Configuration The following table lists the parameters you can use to configure screen backlight and time. Parameter phone_setting.active_backlight_level <y0000000000xx>.cfg...

  • Page 190: Page Tips

    (more than six). For VP59/T58A phones, if page tips feature is enabled, the breathing light will appear at the top/bottom of the DSS key field when the status of a particular feature (for example, BLF) assigned to the line key on the non-current page changes.

  • Page 191: Phone Page Tips Configuration

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones The following table shows how the breathing light and page icon to indicate statuses: Phone Models Breathing Light Description (Drag up to view the desired feature key) VP59/T58A • There is a call parked to the line on the non-current page.

  • Page 192: Expansion Module Page Tips

    On expansion module EXP50, the page tips feature allows the page switch key LED to indicate that BLF monitored user receives an incoming call on the non-current page. It is not applicable to VP59/CP960 phones. Topics Expansion Module Page Tips Indicator...

  • Page 193: Time And Date

    Time and Date Yealink phones maintain a local clock. You can choose to get the time and date from SNTP (Simple Network Time Protocol) time server to have the most accurate time and set DST (Daylight Saving Time) to make better use of day- light and to conserve energy, or you can set the time and date manually.
  • Page 194 Phone Customization Time Zone Time Zone Name Time Zone Time Zone Name Belize Turkey(Ankara) Canada-Manitoba(Winnipeg) Ukraine(Kyiv, Odessa) Chile(Easter Islands) East Africa Time Guadalajara Iraq(Baghdad) Monterrey Russia(Moscow) Mexico(Mexico City,Acapulco) St.Petersburg Saskatchewan Kuwait,Riyadh United States-Central Time Nairobi Bahamas(Nassau) Minsk Bogota,Lima Volgograd (RTZ 2) Canada(Montreal,Ottawa,Quebec) +3:30 Iran(Teheran)
  • Page 195 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Time Zone Time Zone Name Time Zone Time Zone Name Brasilia Kyrgyzstan(Bishkek) Cayenne,Fortaleza Kazakhstan(Astana, Almaty) Montevideo Russia(Novosibirsk,Omsk) Salvador Bangladesh(Dhaka) Brazil(DST) +6:30 Myanmar(Naypyitaw) -2:30 Newfoundland and Labrador +6:30 Yangon (Rangoon) Brazil(no DST) Russia(Krasnoyarsk) Mid-Atlantic Thailand(Bangkok)

  • Page 196: Ntp Settings

    Phone Customization Time Zone Time Zone Name Time Zone Time Zone Name Chad +10:30 Australia(Lord Howe Islands) Copenhagen New Caledonia(Noumea) West Central Africa Chokurdakh (RTZ 10) Poland(Warsaw) Russia(Srednekolymsk Time) Spain(Madrid) +11:30 Norfolk Island Croatia(Zagreb) New Zealand(Wellington,Auckland) Czech Republic(Prague) Fiji Islands Denmark(Kopenhagen) Russia(Kamchatka Time) France(Paris)
  • Page 197 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones It enables or disables the phone to update time with the offset time offered by the DHCP server. Description Note: It is only available to offset from Greenwich Mean Time GMT 0. Permitted 0-Disabled...

  • Page 198: Dst Settings

    Phone Customization It configures the time zone name. Description Note: It works only if “local_time.summer_time” is set to 2 (Automatic) and the parameter “local_time.- time_zone” should be configured in advance. String within 32 characters Permitted The available time zone names depend on the time zone configured by the parameter “local_time.- Values time_zone”.

  • Page 199: Customizing Auto Dst File

    Integer from -300 to 300 Customizing Auto DST File Before customizing, you need to obtain the AutoDST file. You can ask the distributor or Yealink FAE for DST tem- plate. You can also obtain the DST template online: http://sup- port.yealink.com/documentFront/forwardToDocumentFrontDisplayPage.
  • Page 200 Phone Customization 0-Disabled Permitted 1-Enabled Values 2-Automatic Default Web UI Settings > Time&Date > Daylight Saving Time Phone UI Settings > Basic Settings > Time&Date > General > Type (SNTP Settings) > Daylight Saving Parameter local_time.dst_time_type <y0000000000xx>.cfg It configures the Daylight Saving Time (DST) type. Description Note: It works only if “local_time.summer_time”...

  • Page 201: Time And Date Manually Configuration

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Month/Week of Month/Day of Week/Hour of Day, Offset Days Forward-DST by Week, use the following mapping: Month: 1=January, 2=February,…, 12=December Week of Month: 1=the first week in a month,…, 5=the last week in a month Day of Week: 1=Monday, 2=Tuesday,…, 7=Sunday...

  • Page 202: Time And Date Format Configuration

    Phone Customization Time and Date Format Configuration You can customize the time and date by choosing between a variety of time and date formats, including options to date format with the day, month, or year, and time format in 12 hours or 24 hours, or you can also custom the date format as required.

  • Page 203: Date Customization Rule

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Y = year, M = month, D = day, W = day of week “Y”/”YY” represents a two-digit year, more than two “Y” letters (for example, YYYY) represent a four- digit year; “M”/“MM” represents a two-digit month, “MMM” represents the abbreviation of the month, three or more than three “M”...

  • Page 204: Idle Clock Display Configuration

    Phone Customization Topic Idle Clock Display Configuration Idle Clock Display Configuration The following table lists the parameter you can use to configure the idle clock display. Parameter phone_setting.idle_clock_display.enable <y0000000000xx>.cfg Description It enables or disables the phone to display the idle clock. Permitted 0-Disabled Values...
  • Page 205 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones 2-Adaptive, display the customized contact avatar if it exists; otherwise, do not display Default Web UI Settings > Call Display > Contact Photo Display Mode Parameter account.X.picture_info_enable <MAC>.cfg It enables or disables the phone to download the picture from the URL contained in the Call-Info header of the INVITE message.

  • Page 206: Display Method On Dialing

    1-Enabled Values Default X is the account ID. For VP59/T58A, X=1-16; for CP960, X=1. If you change this parameter, the phone will reboot to make the change take effect. Display Method on Dialing When the phone is on the pre-dialing or dialing screen, the account information will be displayed on the phone...

  • Page 207: Display Method On Dialing Configuration

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Yealink phones support three display methods: Label, Display Name, and User Name. You can customize the account information to be displayed on the IP phone as required. Topic Display Method on Dialing Configuration Display Method on Dialing Configuration The following table lists the parameters you can use to configure the display method on dialing.

  • Page 208: Softkey Layout

    Phone Customization Default Supported T58A, VP59 Devices Web UI Features > General Information > Key As Send Phone UI Settings > Features > Key As Send > Key As Send Parameter features.send_pound_key <y0000000000xx>.cfg It configures the behavior when the user presses the # key twice on the dialing screen.

  • Page 209: Softkey Layout File Elements And Attributes

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones You can ask the distributor or Yealink FAE for softkey layout template. You can also obtain the softkey layout tem- plate online: http://support.yealink.com/documentFront/forwardToDocumentFrontDisplayPage. Topics Softkey Layout File Elements and Attributes Customizing Softkey Layout File Softkey Layout File Elements and Attributes The following table lists the elements and attributes you need to understand in the softkey layout file.

  • Page 210: Softkey Layout Configuration

    Description It enables or disables the custom soft keys layout feature. Permitted 0-Disabled 1-Enabled Values Default Supported T58A, VP59 Devices Web UI Settings > Softkey Layout > Custom SoftKey Parameter phone_setting.custom_softkey.apply_to_states <y0000000000xx>.cfg It configures the desired call state to apply the custom softkey layout.
  • Page 211 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Default Blank Supported All phones except CP960 Devices Parameter features.custom_softkey_dynamic.enable <y0000000000xx>.cfg It enables or disables the phone to display the soft keys relevant to the features (call center, cent- ralized call recording, and executive-assistant).

  • Page 212: Example: Setting The Soft Keys Layout In Talking State

    Phone Customization Default Blank Supported T58A, VP59 Devices Parameter custom_softkey_talking.url <y0000000000xx>.cfg It configures the access URL of the custom softkey layout file in the Talking state. Description Note: It works only if “phone_setting.custom_softkey_enable” is set to 1 (Enabled). Permitted URL within 511 characters...

  • Page 213: Notification Popups

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Values Default Blank Parameter gui_input_method.delete <y0000000000xx>.cfg It deletes the specified or all custom keypad input method files of the phone user interface. Delete all custom keypad input method files: Description gui_input_method.delete = http://localhost/all Delete a custom keypad input method file (for example, custom_ime.txt) for the phone: gui_input_method.delete = http://localhost/custom_ime.txt...

  • Page 214: Notification Popups Configuration

    Permitted 0-Disabled 1-Enabled Values Default Web UI Features > Notification Popups > Display Forward Call Popup Power/Mute LED Indicator Power LED indicator indicates power status and phone status of VP59/T58A. The mute LED indicator indicates phone status for CP960.

  • Page 215: Power/Mute Led Indicator Configuration

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones You can configure the power LED indicator behavior for VP59/T58A in the following scenarios: The IP phone receives an incoming call The IP phone receives a voice mail A call is muted A call is placed on hold or is held...
  • Page 216 Parameter <y0000000000xx>.cfg enable It enables or disables the power LED indicator (for VP59/T58A)/mute LED indicator (for CP960) to flash when a call is placed on hold or is held. Description Note: For CP960, it works only if the phone is not in the mute state.

  • Page 217: Bluetooth

    IP phone, the PC and connected mobile phone. For VP59/T58A phones, you can also connect the other Bluetooth devices (for example, Bluetooth headset) with your phone. And you can transfer files via Bluetooth, sharing images/videos with other Bluetooth devices.

  • Page 218: Handset/Headset/Speakerphone Mode

    If you change this parameter, the phone will reboot to make the change take effect. Handset/Headset/Speakerphone Mode The VP59/T58A phones support three ways to place/answer a call: using the handset, using the headset or using the speakerphone. It is not applicable to CP960 phones.

  • Page 219: Handset/Headset/Speakerphone Mode Configuration

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Handset/Headset/Speakerphone Mode Configuration Handset/Headset/Speakerphone Mode Configuration The following table lists the parameters you can use to configure handset/headset/speakerphone mode. Parameter features.speaker_mode.enable <y0000000000xx>.cfg Description It enables or disables the phone’s speakerphone mode. Permitted 0-Disabled 1-Enabled...

  • Page 220: Dss Keys

    Line Keys Ext Keys Shortcut Keys Keys CP960 T58A VP59 Note : The programmable key takes effect only if the phone is idle. The ext key takes effect only if the expansion module is connected to the phone. Supported Dsskey Types The supported Dsskey function types vary by line keys, programmable keys, ext keys and shortcut keys.

  • Page 221: Shortcut Key/Programmable Key Icons Limit

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones DSS Key Types DSS Key Types DSS Key Types Conference Switch Account Down Group Pickup (Line key/Ext key) (Programmable key) Paging(Multicast Retrieve Park Forward Paging) (Line key/Ext key) (Line key/Ext key) Transfer Record Directory...

  • Page 222: Line Keys

    Phone Customization Line Keys Line keys provide one-touch feature (for example, one-touch park). This allows you to quickly access features and to view the monitored status when the line keys are assigned with particular features (for example, BLF). Topics Line Keys Configuration Example: Set a Park/Retrieve Key for FAC Call Park Mode Example: Set a Park/Retrieve Key for Transfer Call Park Mode Example: Setting a Line Key as Directed Pickup Key...
  • Page 223 Parameter linekey.X.line <y0000000000xx>.cfg Description It configures the desired line to apply the line key feature. VP59: 1-16 (if linekey.X.type = 310, 1-4 stand for Handset 2-Handset 5) T58A: 0, 1-16 (if linekey.X.type = 310, 1-4 stand for Handset 2-Handset 5) Permitted...
  • Page 224 Phone Customization The valid URL format is: http(s) ://<IP address of the IP intercom>/api/switch/ctrl?switch=<switch identifier, typically 1 to 4>&ac- tion=trigger or http(s)://username:password@<IP address of the IP inter- com>/api/switch/ctrl?switch=<switch identifier, typically 1 to 4>&action=trigger. For video monitoring feature: It configures the video access URL of IP intercom camera. The valid URL format is: http(s)://<IP address of the IP intercom>/mjpg/video.mjpg or http(s)://user- name:password@<IP address of the IP intercom>/mjpg/video.mjpg.

  • Page 225: Example: Set A Park/Retrieve Key For Fac Call Park Mode

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Web UI Dsskey > Line Key > Line KeyX > Extension Phone UI Settings > Features > Dsskey > Line Key X > Extension Parameter linekey.X.xml_phonebook <y0000000000xx>.cfg It specifies a specific group/phone book when multiple groups/phone books are configured on the phone.

  • Page 226: Example: Set A Park/Retrieve Key For Transfer Call Park Mode

    Phone Customization linekey.3.label =Retrieve Bill After provisioning, you can easily tap the Park key (line key 1) to park a call to a specific extension (4603) during a call, and tap the Retrieve key (line key 3) to retrieve the parked call from the specific extension (4603) when the phone is idle.

  • Page 227: Example: Setting A Line Key As Group Pickup Key

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones linekey.1.line =1 linekey.1.value= 4603 linekey.1.label=Bill After provisioning, you can easily tap the DPickup key (line key 1) to pick up an incoming call to a specific phone (4603). Note : The DPickup invokes the directed pickup code by default. Therefore, the phone dials out *974603 to pick up a call. If the directed code is not set, you can assign code and extension to “linekey.X.value”, for example, “*974603”.

  • Page 228: Example: Setting A Line Key As Open Door Key

    Phone Customization linekey.1.value = 224.5.6.20:10008 linekey.1.label = Sales linekey.1.extension = 2 After provisioning, you can tap the line key 1 to send announcements quickly to the Sales group. Example: Setting a Line Key as Open Door Key The following example shows the configuration for an open door key. Example linekey.1.type = 304 linekey.1.value = http://192.168.1.1/api/switch/ctrl?switch=1&action=trigger...

  • Page 229: Supported Programmable Keys

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones For VP59/T58A: Topics Supported Programmable Keys Programmable Keys Configuration Supported Programmable Keys The following tables list programmable keys for each phone model. Programmable Key IDs VP59/T58A CP960 SoftKey1 SoftKey1 SoftKey2 SoftKey2 SoftKey3 SoftKey3...

  • Page 230: Programmable Keys Configuration

    Phone Customization Programmable Key IDs VP59/T58A CP960 SoftKey4 HOLD MUTE TRAN Redial Message Programmable Keys Configuration The following table lists the parameters you can use to configure programmable keys. Parameter programablekey.type_range.custom <y0000000000xx>.cfg It configures the list for available programmable key types when configuring programmable keys.
  • Page 231 Note: The permitted values are configurable by “programablekey.type_range.custom”. The CP960 phones only support the following types: N/A (0), XML Browser (27), Dial (308), Directory (29) and Bluetooth (309). The VP59/T58A phones do not support the following types: Dial (308) and Bluetooth (309).
  • Page 232 Phone Customization Description It configures the value for some programmable key features. Permitted String within 99 characters Values Default Blank Web UI Dsskey > Programmable Key > Value programablekey.X.label Parameter <y0000000000xx>.cfg (X=1-4) It configures the label displayed on the phone screen for a specific programmable key. Description This is an optional configuration.

  • Page 233: Shortcut Keys

    All phones except CP960 Devices Web UI Dsskey > Programmable Key > Line X is the programmable key ID. For VP59/T58A: X = 1-4, 12-14, 17-18; for CP960: X = 1-3. Related Topic Shortcut Key/Programmable Key Icons Customization Configuration Shortcut Keys You can add up to six-specific shortcut keys on a new idle screen.

  • Page 234: Ext Keys

    Phone Customization 308-Dial 309-Bluetooth Default Supported CP960 Devices Web UI Dsskey > Shortcut Key > Type Parameter shortcutkey.X.label <y0000000000xx>.cfg It configures the label displayed on the LCD screen for a specific shortcut key. Description This is an optional configuration. Permitted String within 99 characters Values Default...
  • Page 235 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones To remove a function type, specify ext key type IDs which start with the symbol “-”. For example, “-14, 5, 2” means to remove “Intercom”, “DND”, “Forward” types from the ext key types list. These ext key types are not available when you configure ext keys.
  • Page 236 Phone Customization Description It configures the desired line to apply the ext key feature. 0, 1-16 Permitted Note: The permitted value 0 is configurable only when "features.fwd_mode" is set to 1 (Custom) and Values "expansion_module.X.key.Y.type" is set to 2 (Forward). Default Supported T58A...

  • Page 237: Dsskey Lock Configuration

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones For speed dial feature: It configures the key sequence you want to send via DTMF. For open door/video monitoring feature: It configures the number or IP address of the IP intercom that this key will apply to.

  • Page 238: Shortcut Key/Programmable Key Icons Customization

    Phone Customization Parameter custom.features.dsskey_unlock_password <y0000000000xx>.cfg It configures the password for unlocking the phone's dsskeys. Description If it is set to a value, the phone prompts users to enter the password when using the corresponding dsskey configured by "custom.features.dsskey_lock_type". Permitted String within 32 characters Values Default Blank (no prompt for entering the unlock password)

  • Page 239: Example: Customizing An Icon For A Specific Shortcut Key

    Default Blank X is the shortcut key ID. X = 1-6. X is the programmable key ID. For VP59/T58A: X = 1-4, 12-14, 17-18; for CP960: X = 1-3. Related Topics Shortcut Key/Programmable Key Icons Limit Preparing the Tar Formatted File Example: Customizing an Icon for a Specific Shortcut Key The following example shows the configuration for customizing an icon for the second shortcut key.

  • Page 240: Example: Customizing An Icon For A Specific Programmable Key

    Phone Customization Related Topics Shortcut Keys Configuration Shortcut Key/Programmable Key Icons Customization Configuration Preparing the Tar Formatted File Example: Customizing an Icon for a Specific Programmable Key The following example shows the configuration for customizing an icon for the second programmable key. For CP960: Prepare the custom key icon "icon_directory.png", compress it into a tar file "icon_custom.tar", and then place the tar file to the provisioning server "http://192.168.10.25".

  • Page 241: Dsskey Hide

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones For VP59/T58A: Prepare the custom key icon "icon_settings.png", compress it into a tar file "icon_menu.tar", and then place the tar file to the provisioning server "http://192.168.10.25". Example: dsskey.icon.url = http://192.168.10.25/icon_menu.tar programablekey.2.type = 30 programablekey.2.icon = icon_settings.png After auto provisioning, the second programmable key is assigned the feature to access the menu, and the key icon is customized.

  • Page 242: Dsskey Hide Configuration

    The rules for configuring EDK for DSS keys are different. Before using EDK, you are advised to become familiar with the macro language. It is not applicable to CP960 phones. For more information on Enhanced DSS Keys, refer to Using Enhanced DSS Keys on Yealink IP Phones. Topics Guidelines for Configuring Enhanced DSS Keys...

  • Page 243: Macro Action Strings

    $S<softkey ID>$ Example: $Sanswer$ means pressing the Answer soft key. Yealink phones support customizing soft keys. When the phone invokes a cus- tom soft key, the prefix “#” must be added. Example: If the custom softkey label is IVR1, the custom softkey ID is custom_ macro, then $S#custom_macro$ means pressing the IVR1 soft key.
  • Page 244 Volume Up key when the phone is idle. The functionality of performing this action is the same as that of pressing the desired hard key. Supported key names include: LineKeyX (for VP59/T58A, X=1-27). SoftKeyX (X ranges from 1 to 4) VolDown VolUp...
  • Page 245 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Macro Action Description acters. If &N is included, the input mode is numeric&symbolic. If &N is not included, the onscreen keyboard is displayed, you can manually change the input mode. If &M is included, the inputs are masked by the dot characters "...

  • Page 246: Edk Configuration

    By default, the EDK feature is disabled. Yealink phones can display the menu item ID by long pressing the Volume Up key. It is especially useful for those users who need to view the menu item ID when configuring EDK macros.

  • Page 247: Edk List Configuration

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones again for three seconds to exit. It works only if “features.enhanced_dss_keys.enable” is set to 1 (Enabled). Permitted 0-Disabled Values 1-Enabled Default Supported All phones except CP960 Devices EDK List Configuration Using the Enhanced DSS Keys (EDK) List parameters to define a macro is useful when defining more than one soft key or DSS key.

  • Page 248: Edk User Input Prompt Configuration

    Phone Customization Default Blank Supported All phones except CP960 Devices X is the macro ID. X=1-255. EDK User Input Prompt Configuration The EDK user input prompt parameters must be used if interactivity with the user is implemented as part of any macro.

  • Page 249: Edk Soft Keys Configuration

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Devices Parameter edk.edkprompt.X.userfeedback <y0000000000xx>.cfg It configures the user input feedback method for user input prompt X. Description Note: It works only if “features.enhanced_dss_keys.enable” and “edk.edkprompt.X.enable” are set to 1 (Enabled). visible-the entered text is visible.
  • Page 250 Phone Customization It enables or disables the custom soft key X. Description Note: It works only if “features.enhanced_dss_keys.enable” is set to 1 (Enabled). Permitted 0-Disabled 1-Enabled Values Default Supported All phones except CP960 Devices Parameter softkey.X.label <y0000000000xx>.cfg It configures the text displayed on the soft key label. Description Note: It works only if “features.enhanced_dss_keys.enable”...
  • Page 251 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones It configures the softkey id for custom soft key X. Example: Description softkey.1.softkey_id = custom_macro1 Note: It works only if “features.enhanced_dss_keys.enable” and “softkey.X.enable” are set to 1 (Enabled). Permitted String Values Default Blank Supported...
  • Page 252 Phone Customization Default Supported All phones except CP960 Devices Parameter softkey.X.use.on_talk <y0000000000xx>.cfg It enables or disables the custom soft key X to be displayed in the talking state. Description Note: It works only if “features.enhanced_dss_keys.enable” and “softkey.X.enable” are set to 1 (Enabled).
  • Page 253 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Permitted 0-Disabled 1-Enabled Values Default Supported All phones except CP960 Devices Parameter softkey.X.use.held <y0000000000xx>.cfg It enables or disables the custom soft key X to be displayed in the held state. Description Note: It works only if “features.enhanced_dss_keys.enable” and “softkey.X.enable” are set to 1 (Enabled).

  • Page 254: Example: Using Edk Macro Strings As The Contact Number

    Phone Customization Example: Using EDK Macro Strings as the Contact Number When you add a contact number in the local directory, LDAP, Remote phone book or XML phone book, you can use the EDK macro strings. Use one of the following formats when adding a contact number: Add an exclamation mark (!) prefix to the macro name, and then enclose them in parenthesis.
  • Page 255 Note : For VP59/T58A phones, if you disable the power saving feature, the phone will automatically enter power-saving mode to protect the screen when the phone is inactive for 72 hours. Image persistence may be caused on LCD if power saving is dis-...
  • Page 256 Phone Customization Parameter features.power_saving.user_input_ext.idle_timeout <y0000000000xx>.cfg It configures the minimum time (in minutes) to wait in the idle state - after using the phone - before the Description phone enters the power-saving mode. Permitted Integer from 1 to 30 Values Default Web UI Settings >...

  • Page 257: Search Source List In Dialing

    Search Source File Customization Search Source List Configuration Search Source File Customization You can ask the distributor or Yealink FAE for super search template. You can also obtain the super search tem- plate online: http://support.yealink.com/documentFront/forwardToDocumentFrontDisplayPage. Topics Search Source File Attributes...

  • Page 258: Customizing Search Source File

    1 to 5 (for CP960 phones) 1 to 7 (for T58A phones) priority The priority of the search results. 1 to 6 (for VP59 phones) 1 is the highest priority. Enable or disable the phone to search the desired directory 0: Disabled enable list.
  • Page 259 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Default Web UI Directory > Settings > Search Source List In Dialing Parameter search_in_dialing.local_directory.priority <y0000000000xx>.cfg Description It configures the search priority of the local directory. Permitted Integer greater than or equal to 0 Values...

  • Page 260: Recent Call Display In Dialing

    Phone Customization the pre-dialing/dialing screen. Permitted 0-Disabled 1-Enabled Values Default Web UI Directory > Settings > Search Source List In Dialing Parameter search_in_dialing.ldap.priority <y0000000000xx>.cfg Description It configures the search priority of the LDAP. Permitted Integer greater than or equal to 0 Values Default Web UI...

  • Page 261: Icon Customization

    Icon Customization You can upload custom DSS keys icons and menu icons to the phone. Contact Yealink FAE to obtain the Icon Tem- plates Pack. Make sure that the name, size, and format of new icons are the same as the built-in ones.

  • Page 262: Door Phone Parameters

    Monitoring: check the camera video at any time. For more information, refer to Using Door Phone Feature on Yealink Smart Media Phones. In addition to the IP phone, IP intercom should be configured. For more information on how to configure the IP inter- com, refer to the documentation from the manufacturer.
  • Page 263 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Values Default Blank Supported All phones except CP960 Devices Web UI Features > Door Phone > Phone Number Parameter features.doorphone.X.unlock_pin <y0000000000xx>.cfg It configures the unlock PIN of the IP intercom. Example: features.doorphone.1.unlock_pin=8888* Description When tapping the Open Door soft key after answering the call, the phone will send the DTMF sequence “8888*”...
  • Page 264 Phone Customization Values 1-Enabled Default Supported All phones except CP960 Devices Web UI Features > Door Phone > Send Video in Call Parameter features.doorphone.X.video.stream.httpurl <y0000000000xx>.cfg It configures the video access URL of IP intercom camera. The valid URL format is: http(s)://<IP address of the IP intercom > /mjpg/video.mjpg or http(s)://user- name:password@<IP address of the IP intercom >...

  • Page 265: Android Keys Display

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Devices Web UI Features > Door Phone > Auto Preview Parameter features.doorphone.X.autopreview_record.enable <y0000000000xx>.cfg It enables or disables the phone to record the preview video automatically when receiving a visitor’s incoming call. Description Note: It works only if “features.doorphone.X.autopreview.enable” is set to 1 (Enabled). It is only applic- able to 2N IP intercom.

  • Page 266: Android Keys Display Configuration

    Phone Customization It is only applicable to VP59/T58A phones. Topic Android Keys Display Configuration Android Keys Display Configuration The following table lists the parameter you can use to configure whether to display the Android keys or not. Parameter features.system_function_bar.hide <y0000000000xx>.cfg Description It enables or disables to hide the Android keys from the phone screen.

  • Page 267: Warnings Display

    1-Enabled Default Browser Home Page When launching the Browser on the phone, the default home page is the Yealink website. You can set the web page that you visit the most frequently as the home page. Topic Browser Home Page Configuration Browser Home Page Configuration The following table lists the parameter you can use to configure the browser home page.

  • Page 268: Out Of Service

    Phone Customization Out of Service When the network of the phone is disconnected and the warning message appears on the screen, the phone will play an alert tone. Topic Out of Service Configuration Out of Service Configuration The following table lists the parameter you can use to configure out of service. Parameter features.out_of_service_alert.enable <y0000000000xx>.cfg It enables or disables the phone to play an alert tone when out of service caused by network abnor-...
  • Page 269 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Parameter phone_setting.usb.pc_mode.audio_union <y0000000000xx>.cfg It configures whether the volume is adjusted synchronously on both PC and CP in PC mode. Description Note: It works only if "phone_setting.usb.pc_mode" is set to 1 (Enabled). It works only for the audio volume on CP, not media volume.

  • Page 270: Account Settings

    Multiple Line Keys per Account Account Registration Registering an account makes it easier for the phones to receive an incoming call or dial an outgoing call. Yealink phone supports registering multiple accounts on a phone (CP960 phones only support registering one SIP account);...
  • Page 271 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Default Blank Web UI Account > Register > Label Phone UI Settings > Advanced Settings (default password: admin) > Accounts > Label Parameter account.X.display_name <MAC>.cfg Description It configures the display name of the account.
  • Page 272 Account Settings Default Blank Web UI Account > Register > SIP Server Y > Server Host Phone UI Settings > Advanced Settings (default password: admin) > Accounts > SIP ServerY [1][2] Parameter account.X.sip_server.Y.port <MAC>.cfg It configures the port of SIP server. Description If it is set to 0 when UDP is used ("account.X.sip_server.Y.transport_type"...

  • Page 273: Pstn Account Configuration

    Default Web UI Account > Advanced > SIP Registration Retry Timer (0~1800s) X is the account ID. For VP59/T58A, X=1-16; for CP960, X=1. Y is the server ID. Y=1-2. PSTN Account Configuration The following table lists the parameters you can use to configure PSTN.

  • Page 274: Registration Settings Configuration

    Account Settings 1-Enabled, the phone can automatically answer an incoming call. Default Web UI PSTN Account > Basic > Auto Answer Phone UI Settings > Features > Auto Answer > PSTNX > Auto Answer Parameter pstn.account.X.auto_answer_mute_enable <MAC>.cfg It enables or disables the auto answer mute feature for PSTN account X. Description Note: It works only if the values of parameters “pstn.account.X.auto_answer”...
  • Page 275 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Web UI Account > Advanced > Send user=phone Parameter account.X.register_mac <MAC>.cfg Description It enables or disables the phone to add MAC address to the SIP header of the REGISTER message. Permitted 0-Disabled 1-Enabled Values...

  • Page 276: Outbound Proxy In Dialog

    Values 1-Enabled Default X is the account ID. For VP59/T58A, X=1-16; for CP960, X=1. If you change this parameter, the phone will reboot to make the change take effect. Outbound Proxy in Dialog An outbound proxy server can receive all initiating request messages and route them to the designated destination.

  • Page 277: Outbound Proxy In Dialog Configuration

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones device will be sent to the outbound proxy server as a mandatory requirement. Note : To use this feature, make sure the outbound server has been correctly configured on the device. For more information...

  • Page 278: Behaviors When Working Server Connection Fails

    Yealink devices support Failover and Fallback server redundancy types. In some cases, you can deploy a com- bination of the two server redundancy types. For more information on server redundancy, refer to...

  • Page 279: Registration Method Of The Failover/Fallback Mode

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones If TCP is used, then the signaling fails if the connection or the send fails. If UDP is used, then the signaling fails if ICMP is detected or if the signal times out. If the signaling has been...

  • Page 280: Failover Server Redundancy Configuration

    Settings > Advanced Setting (default password: admin) > Accounts > AccountX > Proxy Fallback Inter- Phone UI X is the account ID. For VP59/T58A, X=1-16; for CP960, X=1. Failover Server Redundancy Configuration The following table lists the parameters you can use to configure failover server redundancy.
  • Page 281 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Default [1][2] Parameter account.X.sip_server.Y.invite_retry_counts <MAC>.cfg It configures the number of retries attempted before sending requests to the next available server Description when encountering a failover. Permitted Integer from 1 to 10 Values Default [1][2] Parameter account.X.sip_server.Y.failback_mode...
  • Page 282 Account Settings phone assumes that the primary and secondary outbound proxy servers share registration inform- ation. So the phone will directly send the requests to the secondary outbound proxy server. Values 1-Enabled, the phone will register to the secondary outbound proxy server first, and then send the requests to it.

  • Page 283: Sip Server Name Resolution

    (for example, BLF, SCA). Default -1, the phone will invoke “account.X.sip_server.Y.failback_subscribe.enable” to take effect. X is the account ID. For VP59/T58A, X=1-16; for CP960, X=1. Y is the server ID. Y=1-2. SIP Server Name Resolution...

  • Page 284: Static Dns Cache

    Integer from 0 to 65535 Values Default X is the account ID. For VP59/T58A, X=1-16; for CP960, X=1. Y is the server ID. Y=1-2. If you change this parameter, the phone will reboot to make the change take effect. Static DNS Cache Failover redundancy can only be utilized when the configured domain name of the server is resolved to multiple IP addresses.

  • Page 285: Behave With A Configured Dns Server

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Behave with a Configured DNS Server When the phone is configured with a DNS server, it will behave as follows to resolve the domain name of the server: The phone performs a DNS query to resolve the domain name from the DNS server.
  • Page 286 Account Settings NAPTR record with lower preference is more preferred. Permitted Integer from 0 to 65535 Values Default Parameter dns_cache_naptr.X.replace <y0000000000xx>.cfg Description It configures a domain name to be used for the next SRV query in NAPTR record X. Permitted Domain name Values Default...
  • Page 287 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Description It configures the domain name of the target host for an A query in SRV record X. Permitted Domain name Values Default Blank Parameter dns_cache_srv.X.weight <y0000000000xx>.cfg It configures the weight of the target host in SRV record X.

  • Page 288: Logon Wizard

    0-Disabled 1-Enabled Values Default X is the account ID. For VP59/T58A, X=1-16; for CP960, X=1. X is the record ID. X=1-12. If you change this parameter, the phone will reboot to make the change take effect. Logon Wizard Logon wizard allows the phones to provide the logon wizard during the first startup. It works only if there is no registered account on the IP phone.

  • Page 289: Multiple Line Keys Per Account

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones tup when there is no registered account. Note: It works only if “phone_setting.logon_wizard” is set to 1 (Enabled). Permitted 0-Disabled 1-Enabled Values Default Parameter hotdesking.startup_password_enable <y0000000000xx>.cfg It enables or disables the phone to provide an input field of password on the logon wizard after startup when there is no registered account.

  • Page 290: Multiple Line Keys Per Account Configuration

    Account Settings Multiple Line Keys per Account Configuration The following table lists the parameters you can use to configure multiple line keys per account. Parameter features.auto_linekeys.enable <y0000000000xx>.cfg It enables or disables to assign multiple line keys to associate with a specific account. Description Note: The number of the line keys is determined by “account.X.number_of_linekey”.

  • Page 291: Auto Line Labels Rule Configuration

    Default Blank X is the account ID. For VP59/T58A, X=1-16; for CP960, X=1. Auto Line Labels Rule Configuration When assigning multiple line keys per account, these automatically assigned line keys use its Account Label (set by “account.X.label”) as default label to display on the screen.

  • Page 292: Default Account

    Values Default {L}_{1} X is the account ID. For VP59/T58A, X=1-16; for CP960, X=1. Default Account If there are multiple accounts registered on the phone, the phone will use the default account to dial out by default. The following table lists the parameters you can use to configure the default account.

  • Page 293: Directory

    1000 contacts and 48 groups. Contacts and groups can be added either one by one or in batch using a local contact file. Yealink phones support both *.xml and *.csv format contact files, but you can only customize the *.xml format contact file.

  • Page 294: Local Contact File Customization

    8. Click the OK button. A photo.tar file is generated in the directory C:\Program Files\photo. Local Contact File Customization You can ask the distributor or Yealink FAE for local contact template. You can also obtain the local contact template online: http://support.yealink.com/documentFront/forwardToDocumentFrontDisplayPage. Topics...

  • Page 295: Xml Conversion Table

    Directory Customizing Local Contact File XML Conversion Table XML provides escape facilities for including characters which are problematic to include directly. For example, the characters "<" and "&" are key syntax markers and may never appear in the content. XML has five predefined entit- ies.

  • Page 296: Customizing Local Contact File

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Elements Attributes Description Specify a registered line for this contact for calling. Valid Values: -1~15; -1 stands for Auto (the first registered line); line 0~15 stand for line1~line16. Note: It is not applicable to CP960 phones.

  • Page 297: Local Contact Files And Resource Upload

    Directory <contact display_name="Tom" office_number="2020" mobile_number="2021" other_number="2112" line="2" ring="Ring1.wav" group_id_name="Friend" default_photo=" Resource:icon_family_b.png" auto_divert = “2023” / > 5. Save the changes and place this file to the provisioning server. Local Contact Files and Resource Upload You can upload local contact files to add multiple contacts at a time or upload the contact resource, such as contact avatar.

  • Page 298: Example: Adding Contacts Using A Contact File

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones local_contact.icon_image.url = tftp://192.168.10.25/Photo.jpg Permitted URL within 511 characters Values Default Blank Parameter local_contact.image.url <y0000000000xx>.cfg It configures the access URL of a TAR contact avatar file. The format of the contact avatar must be *.png, *.jpg, *.bmp, *.jpeg.

  • Page 299: Local Contacts Backup

    Local Contacts Backup Yealink phones support storing all local contacts to a contact file named <MAC>-contact.xml. You can back up this file to the server, avoiding data loss. Once the contacts update, the phone will automatically upload this file to the provisioning server or a specific server.

  • Page 300: Favorite Contacts

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones 0-PUT Permitted Values 1-POST Default Favorite Contacts You can enable the user to mark local contacts as favorites. The favorite contacts are stored in the Favorites dir- ectory and the phone will automatically assign Speed Dial keys for these favorite contacts.

  • Page 301: Google Contacts

    Directory Google Contacts Yealink IP phone supports Google contacts feature. After enabling Google contacts on the phone, users can get Google contacts from their Google accounts. To use this feature, you need to install the GMS core package, and then the user should add Google accounts on the phone.

  • Page 302: Gms Services List

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Description It uninstalls the GMS service. Permitted Software package name or APK file name or Application name Values Default Blank Supported All phones except CP960 Devices Parameter google_contact_server.enable <y0000000000xx>.cfg It enables or disables the Google contacts.

  • Page 303: Example: Configuring The Google Contacts Feature

    This section shows an example for you about how to configure Google contacts feature on T58A for users. Procedure 1. Ask the distributor or Yealink FAE for the GMS core package (open_gapps-arm-5.1-pico-20170709.zip). 2. Place the GMS core package on the provisioning server “192.168.10.25”.

  • Page 304: Ldap Attributes

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Securely Storing the LDAP Credentials LDAP Configuration LDAP Attributes The following table lists the most common attributes used to configure the LDAP lookup on the phones. Abbreviation Name Description givenName First name commonName LDAP attribute is made up from given name joined to surname.
  • Page 305 Directory the entered character(s). Default Parameter ldap.name_filter <y0000000000xx>.cfg It configures the search criteria for LDAP contact names lookup. The “*” symbol in the filter stands for any character. The “%” symbol in the filter stands for the name entered by the user. Example: ldap.name_filter = (|(cn=%)(sn=%)) When the cn or sn of the LDAP contact matches the entered name, the record will be displayed on the...
  • Page 306 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones used by default). 2-LDAPs—The TLS/SSL connection between the LDAP server and the IP phone (port 636 is used by default). Default Web UI Directory > LDAP > LDAP TLS Mode Parameter ldap.host <y0000000000xx>.cfg Description It configures the IP address or domain name of the LDAP server.
  • Page 307 Directory This parameter can be left blank in case the server allows anonymous to log into. Otherwise, you will need to provide the password to log into the LDAP server. Permitted String within 99 characters Values Default Blank Web UI Directory >...
  • Page 308 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones phoneNumber > mobile). Results: user0005 2598 user0006 3598 user0007 4598 user0008 18954125624 Web UI Directory > LDAP > LDAP Number Attributes Parameter ldap.display_name <y0000000000xx>.cfg It configures the display name of the contact record displayed on the phone screen.
  • Page 309 Directory Description It enables or disables the phone to sort the search results in alphabetical order or numerical order. Permitted 0-Disabled Values 1-Enabled Default Web UI Directory > LDAP > LDAP Sorting Results Parameter ldap.incoming_call_special_search.enable <y0000000000xx>.cfg It enables or disables the phone to search the telephone numbers starting with ”+” symbol and “00” from the LDAP server if the incoming phone number starts with”+”...

  • Page 310: Remote Phone Book

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Permitted String Values Default Blank Parameter ldap.display_extra_attr <y0000000000xx>.cfg It configures the extra attributes list of each record to be displayed on the phone. The attribute must start with a “%” symbol. Multiple attributes are separated by spaces.

  • Page 311: Remote Phone Book File Customization

    You can add multiple contacts at a time and/or share contacts between the phones using the supplied template files (Menu.xml and Department.xml). You can ask the distributor or Yealink FAE for remote phone book template. You can also obtain the remote phone book template online: http://support.yealink.com/documentFront/forwardToDocumentFrontDisplayPage.

  • Page 312: Remote Phone Book Configuration

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones For example, <DirectoryEntry > <Name > Lily </Name > <Telephone label="Mobile Number" > 12345654626</Telephone > </DirectoryEntry > <DirectoryEntry > <Name > Jim</Name > <Telephone label="Office Number" > 654321</Telephone > <Telephone label="Mobile Number" > 54321665462</Telephone >...
  • Page 313 Directory Web UI Directory > Remote Phone Book > Display Name Parameter remote_phonebook.data.X.username <y0000000000xx>.cfg Description It configures the user name used to access the remote phone book X. Permitted String Values Default Blank Parameter remote_phonebook.data.X.password <y0000000000xx>.cfg Description It configures the password used to access the remote phone book X. Permitted String Values...

  • Page 314: Example: Configuring A Remote Phone Book

    Directory List File Customization Directory List Configuration Example: Configuring a Directory List Directory List File Customization You can ask the distributor or Yealink FAE for directory template. You can also obtain the directory template online: http://support.yealink.com/documentFront/forwardToDocumentFrontDisplayPage. Topics Directory List File Attributes...

  • Page 315: Customizing Directory List File

    BroadWorks envir- Mobile Contacts (not applicable to CP960 phones) onment. Blacklist Google Contact (not applicable to VP59/CP960 phones) Presence List (not applicable to VP59 phones) 1 to 7 (for CP960) 1 to 10 (for T58A) priority The display priority of the directory list.
  • Page 316 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones 0-Disabled Permitted 1-Enabled Values Default Parameter directory_setting.local_directory.priority <y0000000000xx>.cfg Description It configures the display priority of the local directory. Permitted Integer greater than or equal to 0 Values Default Parameter directory_setting.history.enable <y0000000000xx>.cfg Description It enables or disables the users to access the history by tapping the directory icon.

  • Page 317: Example: Configuring A Directory List

    Directory Description It configures the display priority of the LDAP. Permitted Integer greater than or equal to 0 Values Default Example: Configuring a Directory List The following example shows the configuration for the directory list. Customize the directory list file, and then place this file to the provisioning server “http://192.168.10.25”. Example static.directory_setting.url = http://192.168.10.25 /favorite_setting.xml After provisioning, you can tap the directory icon to access the desired contact list quickly.

  • Page 318: Number Matching Settings

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Number Matching Settings You can configure the pattern to match the contact numbers with the caller's phone number. Topics Number Matching Settings Configuration Example: Matching Contacts with the Caller's Phone Number Using the Regular Expression Number Matching Settings Configuration The following table lists the parameters you can use to configure number matching settings.

  • Page 319: Example: Matching Contacts With The Caller's Phone Number Using The Regular Expression

    Directory Example: Matching Contacts with the Caller's Phone Number Using the Regular Expression The following example shows the configuration for matching contacts with the caller's phone number using the reg- ular expression. Example: phone_setting.reverse_lookup.contact_list.replace.pattern = 0 phone_setting.reverse_lookup.contact_list.replace.with = phone_setting.reverse_lookup.incoming_call.replace.pattern = +49 phone_setting.reverse_lookup.incoming_call.replace.with = After provisioning, the contact number "01781296"...

  • Page 320: Call Log

    Call Log Call Log Yealink phones record and maintain phone events to a call log, also known as a call list. Call log consists of four lists: Missed Calls, Placed Calls, Received Calls, and Forwarded Calls. Each call log list supports up to 100 entries.
  • Page 321 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Default Web UI Features > General Information > Save Call Log Phone UI Settings > Features > History Record > History Record Parameter account.X.missed_calllog <MAC>.cfg It enables or disables the phone to record missed calls for account X.
  • Page 322 Call Logs Backup Yealink phones support storing all call logs to a call log file named <MAC>-calllog.xml. You can back up this file to the server, avoiding data loss. Once the call logs update, the phone will automatically upload this file to the pro- visioning server or a specific server.
  • Page 323 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones downloads the call logs in the “<MAC>-calllog.xml” according to its MAC address from the specific path during auto provisioning. Default Parameter static.auto_provision.local_calllog.backup.path <y0000000000xx>.cfg It configures a path or URL for the phone to upload/download the <MAC>-calllog.xml file.

  • Page 324: Call Features

    You can use the regular expression to define the dial plan. Yealink phones support four patterns: Replace rule: is an alternative string that replaces the numbers entered by the user. Yealink phones support up to 100 replace rules.

  • Page 325: Basic Regular Expression Syntax For Four Patterns

    The replace rule file helps create multiple replace rules. At most 100 replace rules can be added to the IP phone. You can ask the distributor or Yealink FAE for the replace rule file template. You can also obtain the replace rule file template online: http://support.yealink.com/documentFront/forwardToDocumentFrontDisplayPage.

  • Page 326: Customizing The Replace Rule File

    The dial now file helps create multiple dial now rules. At most 100 dial now rules can be added to the IP phone. You can ask the distributor or Yealink FAE for dial now file template. You can also obtain the dial now file template online: http://support.yealink.com/documentFront/forwardToDocumentFrontDisplayPage.

  • Page 327: Customizing The Dial Now File

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Customizing the Dial Now File 1. Open the dial now file. 2. To add a dial-now rule, add <Data DialNowRule="" LineID="" / > to the file. Each starts on a new line. 3. Specify the values within double quotes.

  • Page 328: Dial Now Configuration

    The digit 0 stands for all lines. If it is left blank, the dial-now rule will apply to all lines on the phone. Description Note: Multiple line IDs are separated by commas. It works only if “dialplan.digitmap.enable” and “account.X.dialplan.digitmap.enable” are set to 0 (Disabled). 0 to 16 (for VP59/T58A) Permitted Values 0, 1 (for CP960)

  • Page 329: Area Code Configuration

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Default Web UI Features > General Information > Time Out for Dial Now Rule Parameter dialplan_dialnow.url <y0000000000xx>.cfg It configures the access URL of the dial now template file. For customizing dial now template file, refer to Dial Now File Customization.

  • Page 330: Block Out Configuration

    IP phone. Description Note: Multiple line IDs are separated by commas. It works only if “dialplan.digitmap.enable” and “account.X.dialplan.digitmap.enable” are set to 0 (Disabled). 0 to 16 (for VP59/T58A) Permitted Values 0, 1 (for CP960)

  • Page 331: Example: Adding Replace Rules Using A Replace Rule File

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Values 0, 1 (for CP960) Default Blank Web UI Settings > Dial Plan > Block Out > Account X is from 1 to 10. Example: Adding Replace Rules Using a Replace Rule File The following example shows the configuration for adding replace rules.

  • Page 332: Digit Map For All Lines Configuration

    Call Features “x.T” would match an arbitrary number. “[x*#+].T” would match an arbitrary character. Note: If the string ends with a dot (for example, 123.), a match will occur immediately after inputting the characters before the dot (e., 123) since the dot allows for zero occurrences of the preceding construct. Therefore, we recommend that you add a letter “T”...
  • Page 333 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones dialplan.digitmap.string = <[2-9]x:86>3.T|0x.!|1xxx Note: The string must be compatible with the digit map feature of MGCP described in 2.1.5 of RFC 3435. It works only if “dialplan.digitmap.enable” or “account.X.dialplan.digitmap.enable” is set to 1 (Enabled). The value configured by the parameter “account.X.dialplan.digitmap.string” takes pre- cedence over that configured by this parameter.
  • Page 334 Call Features Distribution configuration (configure a string of positive integers separated by “|” for each string of the digit map in the corresponding position) If there are more digit maps than timeout values, the last timeout is applied to the extra digit map. If there are more timeout values than digit maps, the extra timeout values are ignored.
  • Page 335 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Note: It works only if “dialplan.digitmap.enable” or “account.X.dialplan.digitmap.enable” is set to 1 (Enabled). The value configured by the parameter “account.X.dialplan.digitmap.apply_to.directory_ dial” takes precedence over that configured by this parameter. Permitted 0-Disabled Values 1-Enabled Default Parameter dialplan.digitmap.apply_to.history_dial...

  • Page 336: Digit Map For A Specific Line Configuration

    Call Features Digit Map for a Specific Line Configuration The following table lists the parameters you can use to configure the digit map for a specific line. Parameter account.X.dialplan.digitmap.enable <MAC>.cfg It enables or disables the digit map feature for a specific account. Description Note: The value configured by the parameter “account.X.dialplan.digitmap.enable”...
  • Page 337 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Default Blank Parameter account.X.dialplan.digitmap.interdigit_short_timer <MAC>.cfg It configures the timeout interval (in seconds) for any string of digit map. The phone will wait this many seconds before matching the entered digits to the dial plan and placing the call.
  • Page 338 Call Features Permitted 0-Disabled Values 1-Enabled Default Blank Parameter account.X.dialplan.digitmap.apply_to.on_hook_dial <MAC>.cfg It enables or disables the entered number to match the predefined string of the digit map after press- ing a send key on the pre-dialing screen or pressing the DSS key (for example, speed dial, BLF or pre- fix DSS key).

  • Page 339: Emergency Dialplan And Enhanced 911

    1-Enabled Default Blank X is the account ID. For VP59/T58A, X=1-16; for CP960, X=1. Emergency Dialplan and Enhanced 911 You can dial the emergency telephone number (emergency services number) at any time when the IP phone is powered on and has been connected to the network. It is available even if your phone keypad is locked or no SIP account is registered.
  • Page 340 GENBAND-Ribbon E911 feature is enabled, the location ID will be added to the INVITE and REGISTER SIP messages. Default ELIN Parameter dialplan.emergency.asserted_id.sip_account <y0000000000xx>.cfg Description It configures the account to be used to retrieve E911 location information. T58A/VP59: Integer from 1 to 16; Permitted Values CP960: 1. Default Parameter dialplan.emergency.custom_asserted_id <y0000000000xx>.cfg It configures the custom outbound identity when placing an emergency call.
  • Page 341 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Default 5060 Parameter dialplan.emergency.server.X.transport_type <y0000000000xx>.cfg It configures the transport protocol the phones use to communicate with the emergency server X. Description Note: It works only if “dialplan.emergency.enable” is set to 1 (Enabled) and “dial- plan.emergency.asserted_id_source”...
  • Page 342 It configures the custom element value to be sent in a location request message. Example: dialplan.emergency.held.request_element.1.value = 001565B38ECB Description dialplan.emergency.held.request_element.2.value = 6f2f2d50-c385-4b72-b84a-ce0ca3a77cb7 dialplan.emergency.held.request_element.3.value = 8611@pbx.yealink.com Note: It works only if “dialplan.emergency.enable” is set to 1 (Enabled) and “dial- plan.emergency.asserted_id_source” is set to HELD. Permitted String...

  • Page 343: Hotline Configuration

    If you lift the handset, press the Speakerphone key or the line key, and do nothing for a specified time interval, the phone will automatically dial out the hotline number. Yealink phones only support one hotline number.

  • Page 344: Off Hook Hot Line Dialing

    Call Features If it is set to 0 (0s), the phone will immediately dial out the preset hotline number when you lift the handset, press the Speakerphone key or tap the line key. If it is set to a value greater than 0, the phone will wait the designated seconds before dialing out the preset hotline number when you lift the handset, press the Speakerphone key or tap the line key.

  • Page 345: Live Dialpad

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Default Blank X is the account ID. For VP59/T58A, X=1-16; for CP960, X=1. Live Dialpad Live Dialpad allows the phones to automatically dial out the entered phone number without tapping the send key after a designated period of time.

  • Page 346: Recall Configuration

    Call Features Default Web UI Features > General Information > Auto Redial Phone UI Settings > Features > Auto Redial > Auto Redial Parameter auto_redial.interval <y0000000000xx>.cfg It configures the interval (in seconds) for the phone to wait between redials. Description The phone redials the last dialed number at regular intervals untill the callee answers the call.

  • Page 347: Speed Dial

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Speed Dial Speed dial allows you to speed up dialing the contacts on the phone’s idle screen using dedicated DSS keys. Topic Speed Dial Key Configuration Speed Dial Key Configuration You can configure line key or programmable key as Speed Dial key (not applicable to CP960 phones).

  • Page 348: Call Timeout

    Call Features Permitted String within 32 characters Values Default Blank Web UI Features > General Information > PswPrefix Parameter features.password_dial.length <y0000000000xx>.cfg It configures how many digits to be displayed as asterisks. Example: features.password_dial.length = 3 Description If you set the prefix to 12 and the length to 3, when you want to dial the number 123456, the entered number is displayed as 12***6 on the phone screen.

  • Page 349: Anonymous Call Configuration

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Anonymous Call Configuration The following table lists the parameters you can use to configure the anonymous call. Parameter account.X.anonymous_call <MAC>.cfg Description It triggers the anonymous call feature to on or off. 0-Off Permitted 1-On, the phone will block its identity from showing to the callee when placing a call. The callee’s Values phone screen presents “Anonymous”...

  • Page 350: Call Number Filter

    Phone UI Settings > Features > Anonymous > Line X > Off Code X is the account ID. For VP59/T58A, X=1-16; for CP960, X=1. Call Number Filter Call number filter feature allows IP phone to filter designated characters automatically when dialing.

  • Page 351: Ip Address Call Configuration

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones IP Address Call Configuration The following table lists the parameter you can use to configure IP address call. Parameter features.direct_ip_call_enable <y0000000000xx>.cfg It enables or disables to allow IP address call. Description Note: If you want to receive an IP address call, make sure “sip.trust_ctrl” is set to 0 (Disabled).

  • Page 352: Off Hook Answering Configuration

    Supported All phones except CP960 Devices Auto Answer Yealink phones support answering a SIP call or an IP address call automatically. Auto answer is configurable on a per-line basis, while IP address call is not. Topic Auto Answer Configuration Auto Answer Configuration The following table lists the parameters you can use to configure the auto answer.
  • Page 353 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Web UI Account > Basic > Auto Answer Mute Phone UI Settings > Features > Auto Answer > Account 1 > Auto Answer (On) > Auto Answer Mute Parameter features.ip_call.auto_answer.enable <y0000000000xx>.cfg It enables or disables the auto answer feature for IP call.

  • Page 354: Anonymous Call Rejection

    Values and then the other party cannot hear you. Default X is the account ID. For VP59/T58A, X=1-16; for CP960, X=1. Anonymous Call Rejection Anonymous call rejection allows IP phone to automatically reject incoming calls from callers whose identity has been deliberately concealed.
  • Page 355 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Web UI Account > Basic > Local Anonymous Rejection Phone UI Settings > Features > Anonymous > Line X > Anonymous Rejection Parameter features.anonymous_response_code <y0000000000xx>.cfg It configures the code the phone responds with to the server when it receives an anonymous call.

  • Page 356: Call Waiting

    You can enable call waiting feature and set the phone to play a warning tone to avoid missing important calls dur- ing a call. Yealink phones also support call waiting on code and off code to activate and deactivate server-side call waiting feature. They may vary on different servers.

  • Page 357: Do Not Disturb (Dnd)

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Default Blank Web UI Features > General Information > Call Waiting On Code Phone UI Settings > Features > Call Waiting > On Code Parameter call_waiting.off_code <y0000000000xx>.cfg It configures the call waiting off code.
  • Page 358 Call Features Note: It works only if “features.dnd.allow” is set to 1 (Enabled). 0-Phone, DND feature is effective for the phone system. Permitted Values 1-Custom, you can configure the DND feature for each or all accounts. Default Supported All phones except CP960 Devices Web UI Features >...

  • Page 359: Dnd Feature Configuration

    <y0000000000xx>.cfg It triggers the DND feature to on or off. Note: For VP59, it works only if “features.dnd_mode” is set to 0 (Phone). For other phones, it works Description only if “features.dnd.allow” is set to 1 (Enabled) and “features.dnd_mode” is set to 0 (Phone)(except...

  • Page 360: Dnd In Custom Mode Configuration

    DND feature on the phone. Description Note: For VP59, it works only if “features.dnd_mode” is set to 0 (Phone). For other phones, it works only if “features.dnd.allow” is set to 1 (Enabled) and “features.dnd_mode” is set to 0 (Phone)(except CP960 phones).

  • Page 361: Dnd Synchronization For Server-Side Configuration

    The phone will send the DND on code to the server when you activate the DND feature on the phone. Description Note: For VP59, it works only if “features.dnd_mode” is set to 1 (Custom). For other phones, it works only if “features.dnd.allow” is set to 1 (Enabled) and “features.fwd_mode” is set to 1 (Custom).
  • Page 362 1 (Enabled). 0-Disabled, DND is performed on the server side only. Permitted Values 1-Enabled, DND is performed on both the server side and locally. Default Blank X is the account ID. For VP59/T58A, X=1-16; for CP960, X=1.

  • Page 363: Multiple Call Appearances

    It means that you can have up to two concurrent calls per line key associated with account 1. Note: The value configured by this parameter takes precedence over that configured by the parameter “phone_setting.call_appearance.calls_per_linekey”. Permitted Integer from 0 to 24 Values Default Blank X is the account ID. For VP59/T58A, X=1-16; for CP960, X=1.

  • Page 364: Call Hold

    Call Features Call Hold Call hold provides a service of placing an active call on hold. It enables you to pause activity on an active call so that you can use the phone for another task, for example, to place or receive another call. When a call is placed on hold, the phones send an INVITE request with HOLD SDP to request remote parties to stop sending media and to inform them that they are being held.
  • Page 365 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones If it is set to 30 (30s), the phone will wait 30 seconds to play the initial call hold tone after you place a call on hold. Note: It works only if “features.play_hold_tone.enable” is set to 1 (Enabled).

  • Page 366: Music On Hold (Moh) Configuration

    X is the account ID. For VP59/T58A, X=1-16; for CP960, X=1. Call Mute You can mute the microphone of the active audio device (handset, headset or speakerphone) on Yealink phones during an active call or when the phone is on the pre-dialing/dialing/calling/ringing screen. The call is automatically muted when setting up successfully.

  • Page 367: Keep Mute

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Parameter features.allow_mute <y0000000000xx>.cfg Description It enables or disables the allow mute feature for the IP phone. 0-Disabled Permitted 1-Enabled, you are allowed to mute an active call or activate the mute feature on the pre-dial- Values ing/dialing/calling/ringing screen.

  • Page 368: Mute Alert Tone

    Call Features Mute Alert Tone You can configure the phone to play an audible tone if the mute status of the phone is changed. This allows you to know if your phone is in the mute or un-mute state. In addition, you can set a periodic reminder which plays the aud- ible tone periodically when the phone is in the mute state.
  • Page 369 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Enable or disable forward emergency feature and specify forward authorized numbers. These numbers will not be forwarded when the call forward feature is enabled. The incoming call will not be logged in the Forwarded Calls list.

  • Page 370: Call Forward Feature Configuration

    Custom: Call forward feature can be configured for a specific line or multiple lines. Note: Forward mode is set by the parameter “features.fwd_mode”. Yealink phones also support call forward on code and off code to activate and deactivate server-side call forward feature. They may vary on different servers.
  • Page 371 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Parameter forward.always.enable <y0000000000xx>.cfg It triggers the always forward feature to on or off on a phone basis. Description Note: It works only if “features.fwd.allow” is set to 1 (Enabled) and “features.fwd_mode” is set to 0 (Phone) (except CP960 phones).
  • Page 372 Call Features Web UI Features > Forward&DND > Forward > Always Forward > Off Code Phone UI Settings > Features > Call Forward > Always Forward > Off Code Parameter forward.busy.enable <y0000000000xx>.cfg It triggers the busy forward feature to on or off on a phone basis. Description Note: It works only if “features.fwd.allow”...
  • Page 373 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Values Default Blank Web UI Features > Forward&DND > Forward > Busy Forward > Off Code Phone UI Settings > Features > Call Forward > Busy Forward > Off Code Parameter forward.no_answer.enable <y0000000000xx>.cfg It triggers the no answer forward feature to on or off on a phone basis.

  • Page 374: Call Forward In Custom Mode Configuration

    Call Features Note: It works only if “forward.no_answer.enable” or “account.X.timeout_fwd.enable” is set to 1 (Enabled). Permitted String within 512 characters Values Default 0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20 (1 is not applicable to BroadSoft users) Parameter phone_setting.ring_duration <y0000000000xx>.cfg It configures the interval (in seconds) of the ring for the no answer forward feature. Description Note: It works only if “forward.no_answer.enable”...
  • Page 375 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones 0-Off Permitted 1-On, incoming calls to the account X are forwarded to the destination number (configured by the para- Values meter “account.X.always_fwd.target”) immediately. Default Supported All phones except CP960 Devices Web UI Features > Forward&DND > Forward > AccountX > Always Forward > On/Off Phone UI Settings >...
  • Page 376 Call Features Default Blank Supported All phones except CP960 Devices Web UI Features > Forward&DND > Forward > AccountX > Always Forward > Off Code Phone UI Settings > Features > Call Forward > AccountX > Always Forward > Off Code Parameter account.X.busy_fwd.enable <MAC>.cfg Description It triggers the busy forward feature to on or off.
  • Page 377 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Parameter account.X.busy_fwd.off_code <MAC>.cfg It configures the busy forward off code to deactivate the server-side busy forward feature. The phone will send the busy forward off code to the server when you deactivate the busy forward fea- ture on the phone.

  • Page 378: Call Forward Synchronization For Server-Side Configuration

    Phone UI Settings > Features > Call Forward > AccountX > No Answer Forward > Off Code X is the account ID. For VP59/T58A, X=1-16. Call Forward Synchronization for Server-side Configuration Call forward synchronization feature provides the capability to synchronize the status of the call forward features...
  • Page 379 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones If the call forward is activated in phone mode, the forward status changing locally will be synchronized to all registered accounts on the server; but if the forward status of the specific account is changed on the server, the for- ward status locally will be changed.

  • Page 380: Call Transfer

    1-Enabled, call forward is performed on both server side and locally. Default Blank X is the account ID. For VP59/T58A, X=1-16; for CP960, X=1. Call Transfer Call transfer enables the phones to transfer an existing call to a third party. For example, if party A is in an active call with party B, party A can transfer this call to party C (the third party).
  • Page 381 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones It enables or disables the Refer-To header to use the information of the Contact header in the second Description 200 OK message when attended transfer. Permitted 0-Disabled Values 1-Enabled Default features.transfer_keep_session2_after_failed.en- Parameter <y0000000000xx>.cfg able...

  • Page 382: Transfer Mode For Dsskey Configuration

    X is the account ID. For VP59/T58A, X=1-16; for CP960, X=1. Local Conference Configuration The local conference requires a host phone to process the audio of all parties. Yealink phones support up to 5 parties (10 parties for T58A/VP59 phones) (including yourself) in a local conference call.

  • Page 383: Network Conference Configuration

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Note : Codecs that can support 10-party conference: G722, G723, G726, G729, PCMA, PCMU, and iLBC; the Opus codec can only support 5-party conference. The following table lists the parameters you can use to configure the local conference.

  • Page 384: Call Recording

    For VP59/T58A phones, if you connect the USB flash drive to the IP phone, the recorded files will be saved accord- ing to the priority: USB flash drive > Internal SD card. For CP960 phones, if you connect the USB flash drive to the IP phone, you can choose to save the recorded files to the Internal SD card or USB flash drive.

  • Page 385: Recording Upload

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones It enables or disables the USB automatic recording feature. Description Note: It works only if “features.usb_call_recording.enable” is set to 1 (Enabled). 0-Disabled Permitted Values 1-Enabled Default Recording Upload You can configure the phones to upload the local recording files to a third-party server.

  • Page 386: Multicast Paging

    Multicast Paging Group Configuration Yealink phones support up to 31 groups for paging. You can assign multicast IP address with a channel for each group, and specify a label to each group to identify the phones in the group, such as All, Sales, or HR.

  • Page 387: Multicast Listening Group Configuration

    Multicast Listening Group Configuration Yealink phones support up to 31 groups for listening. You can assign multicast IP address with a channel for each group, and specify a label to each group to identify the phones in the group, such as All, Sales, or HR.

  • Page 388: Multicast Paging Settings

    1 to 25-the phone can receive an RTP stream of the pre-configured multicast address on the channel Values 1 to 25 respectively from Yealink or Polycom phones. 26 to 30-the phone can receive the RTP stream of the pre-configured multicast address on the chan- nel 26 to 30 respectively from Yealink phones.
  • Page 389 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Parameter multicast.codec <y0000000000xx>.cfg Description It configures the codec for multicast paging. Permitted PCMU, PCMA, G729, G722 Values Default G722 Web UI Features > General Information > Multicast Codec Parameter multicast.receive_priority.enable <y0000000000xx>.cfg It enables or disables the phone to handle the incoming multicast paging calls when there is an active Description multicast paging call on the phone.
  • Page 390 Call Features 31-31 If it is not set to 0 (Disabled), the phone will receive the incoming multicast paging call with a higher or same priority than this value and ignore that with a lower priority than this value when DND is activ- ated in phone mode.

  • Page 391: Video Features

    Video Features Video Features The VP59/T58A phones support transmission and reception of high quality video images. To transmit video on T58A phones, you need to connect a USB camera CAM50 to the phone in advance. The video is compatible with RFC 3984 - RTP Payload Format for H.264 Video,...
  • Page 392 Note: It works only if "video.enable" is set to 1 (Video first) or 2 (Optional). There is no near-site video image on the VP59/T58A phones if USB camera is not connected. 1-Focus Big: One video image displays in a large size, the other video image along the right side of Permitted the screen displays in small size.

  • Page 393: Video Codecs

    Codecs and priorities of these codecs are configurable on a per-line basis. The attribute “rtpmap” is used to define a mapping from RTP payload codes to a codec, clock rate and other encoding parameters. The following table lists the video codecs supported by VP59/T58A phone model:...

  • Page 394: Video Codecs Configuration

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Name MIME Type Bit Rate Frame Rate Frame Size H.264 BP H264/90000 90 kbps to Tx: CIF, 360P, W448P, 720P 2048 kbps H.264 HP H264/90000 Rx: Conventional Size Below 720P 5 fps to 30 fps...
  • Page 395 Note: The name of video codec in this parameter should be the correct one as listed in the above example, otherwise the corresponding configuration will not take effect. Permitted Integer from 0 to 3 (0 to 4 for VP59 phones) Values When the audio codec is H264HP, the default value is 1;...

  • Page 396: Advanced Features

    Call Pickup You can use call pickup to answer someone else’s incoming call on your phone. The Yealink phones support Directed Call Pickup and Group Call Pickup: Directed Call Pickup: allows you to pick up incoming calls to a specific phone.

  • Page 397: Group Call Pickup

    Web UI Account > Advanced > Directed Call Pickup Code X is the account ID. For VP59/T58A, X=1-16; for CP960, X=1. Group Call Pickup Group call pickup is used for picking up incoming calls within a predefined group. When any phone within a pre- defined group of phones receives an incoming call, you can pick up that call easily on the phone.

  • Page 398: Group Call Pickup Configuration

    Web UI Account > Advanced > Group Call Pickup Code X is the account ID. For VP59/T58A, X=1-16; for CP960, X=1. Dialog Info Call Pickup While some SIP servers implement directed call pickup using a directed call pickup code, others also support imple- ment this feature through SIP signals.
  • Page 399 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Example of the dialog-info carried in NOTIFY message: <?xml version="1.0"? > <dialog-info xmlns="urn:ietf:params:xml:ns:dialog-info" version="6" state="partial" entity- y="sip:1011@10.2.1.48:5060" > <dialog id=" 65603" call-id=" 0_1756536024@10.10.20.34" local-tag=" 3408640225" remote-tag- g=" 3779921438" direction=" recipient" > <state > early</state>...

  • Page 400: Dialog Info Call Pickup Configuration

    Callee does not answer Callee actively rejects the incoming call before answering Yealink phones support call completion using the SUBSCRIBE/NOTIFY method, which is specified in draft-poetzl- sipping-call-completion-00, to subscribe to the busy party and receive notifications of their status changes.
  • Page 401 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Example of a NOTIFY message (The subscription (SUBSCRIBE message) of the dialog event “Call Completion” is confirmed by the busy party): NOTIFY sip:10111@10.10.20.32:5060 SIP/2.0 Via: SIP/2.0/UDP 10.10.20.31:5060;branch=z9hG4bK1830418099 From: <sip:1000@10.2.1.48:5060>;tag=1032948194 To: "10111" <sip:10111@10.2.1.48:5060>;tag=722495580 Call-ID: 0_160090766@10.10.20.32 CSeq: 2 NOTIFY Contact: <sip:1000@10.10.20.31:5060>...

  • Page 402: Call Completion Configuration

    Via: SIP/2.0/UDP 10.10.20.31:5060;branch=z9hG4bK3431394016 From: <sip:1000@10.2.1.48:5060>;tag=1558968605 To: "10111" <sip:10111@10.2.1.48:5060>;tag=140677866 Call-ID: 0_2584152566@10.10.20.32 CSeq: 5 NOTIFY Contact: <sip:1000@10.10.20.31:5060> Content-Type: application/dialog-info+xml Max-Forwards: 70 User-Agent: Yealink T58 58.83.0.15 Subscription-State: active;expires=48 Event: dialog Content-Length: 217 <?xml version="1.0"?> <dialog-info xmlns="urn:ietf:params:xml:ns:dialog-info" version="4" state="partial" entity- y="sip:1000@10.2.1.48:5060"> <dialog id="65644"> <state>terminated</state>...

  • Page 403: Call Park And Retrieve

    Call park allows users to park a call on a special extension and then retrieve it from another phone (for example, a phone in another office or conference room). The VP59/T58A phones support the call park feature under the following modes: FAC mode: parks the call to the local extension or the desired extension through dialing the park code.

  • Page 404: Example: Setting Call Park And Retrieve In Fac Mode

    Advanced Features Parameter features.call_park.park_retrieve_code <y0000000000xx>.cfg It configures the park retrieve code for FAC call park mode or configures retrieve parking lot for Trans- Description fer call park mode. Permitted String within 256 characters Values Default Blank Web UI Features > Pick up & Park > Park Retrieve Code Parameter features.call_park.direct_send.enable <y0000000000xx>.cfg It enables or disables the phone to dial out the call park code/park retrieve code directly when press-...

  • Page 405: Example: Setting Call Park And Retrieve In Transfer Mode

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones features.call_park.enable = 1 features.call_park.park_code = *68 features.call_park.park_retrieve_code = *88 After provisioning, the call park mode is set to FAC. A Park soft key will display on the phone during an active call, and a Retrieve soft key will display on the Dialing screen. You can tap the Park soft key to park a call or tap the Retrieve soft key to retrieve a parked call.

  • Page 406: Acd Configuration

    Note: It works only if “account.X.acd.enable” is set to 1 (Enabled). Permitted 0-Disabled 1-Enabled Values Default Supported All phones except VP59 Devices Parameter account.X.acd.unavailable_reason_enable <MAC>.cfg It enables or disables the unavailable/away reason code feature. Description Note: It works only if “account.X.acd.available" is set to 1 (Enabled).

  • Page 407: Example: Setting Acd

    Web UI Features > ACD > ACD > ACD Auto Available Timer (0~120s) X is the account ID. For VP59/T58A, X=1-16; for CP960, X=1. Example: Setting ACD The following example shows the configuration for ACD. It is not applicable to CP960 phones.

  • Page 408: Blf Key Configuration

    Advanced Features Configure a line key as BLF key to monitor a specific remote line Configure BLF List to monitor a list of specific remote lines The BLF feature enables the following functions to the users: Monitor the status of line on their phone Display caller ID information Answer incoming calls to the monitored line (called directed call pickup) Park and retrieve calls to the monitored line...
  • Page 409 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Default Blank Web UI Account > Advanced > BLF List URI Parameter account.X.blf_list_code <MAC>.cfg Description It configures the feature access code that initiates a directed call pickup for account X. Permitted String within 32 characters...

  • Page 410: State Indicator Of Remote Line

    1-Enabled Values Default X is the account ID. For VP59/T58A, X=1-16; for CP960, X=1. If you change this parameter, the phone will reboot to make the change take effect. State Indicator of Remote Line The state indicator of the monitored line on BLF/BLF List key varies by phone models.

  • Page 411: Blf/Blf List Subscription

    A call is parked to the monitored line. The monitored line fails to register or does not exist. BLF/BLF List Subscription Yealink phones support BLF using a SUBSCRIBE/NOTIFY mechanism as specified in 3265. BLF Subscription When you configure the IP phone to monitor a specific line, the phone sends a SUBSCRIBE request with Request- URI containing the monitor line URI to the server, and then receives a NOTIFY request.

  • Page 412: Blf/Blf List Subscription Configuration

    Advanced Features </resource> </list> Topic BLF/BLF List Subscription Configuration BLF/BLF List Subscription Configuration The following table lists the parameters you can use to configure BLF/BLF List subscription. Parameter account.X.blf.subscribe_period <MAC>.cfg Description It configures the period (in seconds) of the BLF subscription. Permitted Integer from 30 to 2147483647 Values...

  • Page 413: Visual And Audio Alert For Monitor Lines

    Parameters linekey.X.value/expansion_module.X.key.Y.value X is the account ID. For VP59/T58A, X=1-16; for CP960, X=1. Visual and Audio Alert for Monitor Lines Visual and Audio Alert feature allows the phone to display the caller ID and play an audio alert when a BLF line receives an incoming call.

  • Page 414: Visual And Audio Alert For Blf Lines Configuration

    Advanced Features Visual and Audio Alert for BLF Lines Configuration The following table lists the parameters you can use to configure a visual and audio alert for BLF lines. Parameter features.pickup.blf_visual_enable <y0000000000xx > .cfg It enables or disables the phone to display a visual alert when the monitored user receives an incom- Description ing call.
  • Page 415 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones features.pickup.blf_audio.list = any or leave it blank The IP phone plays an audio alert when any monitored user receives an incoming call. features.pickup.blf_audio.list = 4604,4605 The IP phone plays an audio alert when monitored user 4604 or 4605 receives an incoming call.

  • Page 416: Example: Configuring Visual And Audio Alert For Monitor Lines

    Advanced Features Example: Configuring Visual and Audio Alert for Monitor Lines The following example shows the configuration for visual and audio for a monitor line. Scenario Conditions Related Topic linekey.1.pickup_value = *97 Line Keys Configuration account.1.direct_pickup_code = *97 Directed Call Pickup features.pickup.direct_pickup_code = *97 linekey.1.type = 16 linekey.1.line = 1...
  • Page 417 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones LED Status Description Slowly-flashing red (1s) The call is parked against the monitored user’s phone number. The monitored user does not exist. Expansion Module Key LED (configured as a BLF key or a BLF List key and BLF LED Mode is set to 1)

  • Page 418: Blf Led Mode Configuration

    Advanced Features LED Status Description Solid green The monitored user is talking. Slowly-flashing green (1s) The monitored user does not exist. The monitored user is idle. BLF LED Mode Configuration The following table lists the parameters you can use to configure BLF LED Mode. Parameter features.blf_led_mode <y0000000000xx>.cfg Description It configures the BLF LED mode.

  • Page 419: Blf Key Led/Icon And Behavior For Idle State Configuration

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Related Topic Macro Action Strings BLF Key LED/Icon and Behavior for Idle State Configuration The following table lists the parameters you can use to configure BLF key LED/icon and Behavior for the idle state (the monitored user is idle).

  • Page 420: Blf Key Led/Icon And Behavior For Call-In State Configuration

    Advanced Features Values Default Blank BLF Key LED/Icon and Behavior for Call-in State Configuration The following table lists the parameters you can use to configure BLF key LED/icon and Behavior for the call-in state (the monitored user is ringing). Parameter blf.enhanced.callin.enable <y0000000000xx>.cfg Description It enables or disables the custom configuration when the monitored user is ringing.

  • Page 421: Blf Key Led/Icon And Behavior For Call-Out State Configuration

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Note: It works only if “blf.enhanced.callin.enable” is set to 1 (Enabled). Permitted String Values Default Blank BLF Key LED/Icon and Behavior for Call-out State Configuration The following table lists the parameters you can use to configure BLF key LED/icon and Behavior for the call-out state (the monitored user is calling out).

  • Page 422: Blf Key Led/Icon And Behavior For Talking State Configuration

    Advanced Features It configures the behavior when pressing the BLF/BLF list DSS key if the monitor is idle and monitored user is calling out. Description Note: It works only if “blf.enhanced.callout.enable” is set to 1 (Enabled). Permitted String Values Default Blank BLF Key LED/Icon and Behavior for Talking State Configuration The following table lists the parameters you can use to configure BLF key LED/icon and Behavior for talking state...

  • Page 423: Blf Key Led/Icon And Behavior For Parked-Against State Configuration

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Parameter blf.enhanced.talking.idle.action <y0000000000xx>.cfg It configures the behavior when pressing the BLF/BLF list DSS key if the monitor is idle and monitored user is talking. Description Note: It works only if “blf.enhanced.talking.enable” is set to 1 (Enabled).

  • Page 424: Blf Key Led/Icon And Behavior For Hold State Configuration

    Advanced Features blf.enhanced.parked.talking.action = newcall Note: It works only if “blf.enhanced.parked.enable” is set to 1 (Enabled). Permitted String Values Default Blank Parameter blf.enhanced.parked.idle.action <y0000000000xx>.cfg It configures the behavior when pressing the BLF/BLF list DSS key if the monitor is idle and a call is parked against the monitored phone.

  • Page 425: Blf Key For Intercom Configuration

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Description It enables or disables the custom configuration when DND is activated on the monitored phone. 0-Disabled Permitted Values 1-Enabled, the phone will display the custom BLF/BLF List DSS key LED status/icon colors. Default...

  • Page 426: Shared Line

    Shared Line Yealink phones support Shared Call Appearance (SCA) to share a line. Shared call appearances enable more than one phone to share the same line or registration. The methods you use vary with the SIP server you are using.

  • Page 427: Sca Configuration

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Configure a private hold soft key or Private Hold key and provide users the ability to hold a call privately. Configure a call pull code, which allows users to retrieve an existing call from another shared phone that is in an active or public hold status.

  • Page 428: Intercom

    1-Enabled, users can also view the call details by long pressing the SCA line key. Default X is the account ID. For VP59/T58A, X=1-16; for CP960, X=1. Intercom Intercom is a useful feature in an office environment to quickly connect with the operator or the secretary. You can press the intercom key to place a call to a contact that is answered automatically on the contact's phone as long as the contact is not in an active call.

  • Page 429: State Monitor For Intercom Contact

    Permitted 0-Disabled 1-Enabled Values Default Outgoing Intercom Configuration Yealink phones support two methods for initialing intercom calls. The following table lists the parameters you can use to configure outgoing intercom. Parameter features.intercom.mode <y0000000000xx>.cfg Description It configures the intercom mode. Permitted...

  • Page 430: Incoming Intercom Configuration

    Values Default Blank X is the account ID. For VP59/T58A, X=1-16; for CP960, X=1. Incoming Intercom Configuration The IP phone can process incoming calls differently depending on settings. The following table lists the parameters you can use to configure incoming intercom.
  • Page 431 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Web UI Features > Intercom > Intercom Audio Mute (Intercom Mute for CP960) Phone UI Settings > Features > Intercom > Intercom Audio Mute (Intercom Mute for CP960) Parameter features.intercom.video.mute <y0000000000xx>.cfg Description It enables or disables the phone to turn off the video when the video intercom call is answered.

  • Page 432: Csta Control

    String within 256 characters Values Default Blank X is the account ID. For VP59/T58A, X=1-16; for CP960, X=1. CSTA Control User Agent Computer Supported Telecommunications Applications (uaCSTA) is explained in detail in Using CSTA for SIP Phone User Agents (uaCSTA)

  • Page 433: Predefined Events List

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones You can specify a URL that triggers a GET request when a specified event occurs. Action URL can only be triggered by the predefined events (for example, Open DND). The valid URL format is: http(s)://<server- IPAddress>/help.xml? .
  • Page 434 Advanced Features Event Description When the IP phone enables the busy forward. Note: When the forward mode is Phone, the phone sends the action URL for all accounts; Open Busy Forward when the forward mode is Custom, the phone only sends the action URL for the cor- responding account.

  • Page 435: Variable Values List

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Event Description Autop Finish When the IP phone completes auto provisioning via power on. Open Call Waiting When the IP phone enables the call waiting. Close Call Waiting When the IP phone disables the call waiting.

  • Page 436: Action Url Configuration

    Advanced Features Variable Value Description $ehs_number The number of connected EHS. $udisk_number The number of connected USB flash drives. $usbheadset_number The number of connected USB headset devices. $wifi_number The number of connected Wi-Fi dongles. $bluetooth_number The number of connected Bluetooth dongles. $vpn_ip The phone IP address assigned by the VPN server.
  • Page 437 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Parameter action_url.unregistered <y0000000000xx>.cfg It configures the action URL the phone sends after an account is unregistered. Description Example: action_url.unregistered = http://192.168.0.20/help.xml?IP=$ip Permitted URL within 511 characters Values Default Blank Web UI Features > Action URL > Unregistered Parameter action_url.register_failed...
  • Page 438 Advanced Features action_url.incoming_call = http://192.168.0.20/help.xml?IP=$ip Permitted URL within 511 characters Values Default Blank Web UI Features > Action URL > Incoming Call Parameter action_url.outgoing_call <y0000000000xx>.cfg It configures the action URL the phone sends when placing a call. Description Example: action_url.outgoing_call = http://192.168.0.20/help.xml?IP=$ip Permitted URL within 511 characters Values...
  • Page 439 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones It configures the action URL the phone sends when the always forward feature is activated. Description Example: action_url.always_fwd_on = http://192.168.0.20/help.xml?IP=$ip Permitted URL within 511 characters Values Default Blank Web UI Features > Action URL > Always Forward On Parameter action_url.always_fwd_off...
  • Page 440 Advanced Features Web UI Features > Action URL > No Answer Forward On Parameter action_url.no_answer_fwd_off <y0000000000xx>.cfg It configures the action URL the phone sends when the no answer forward feature is deactivated. Description Example: action_url.no_answer_fwd_off = http://192.168.0.20/help.xml?IP=$ip Permitted URL within 511 characters Values Default Blank...
  • Page 441 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Default Blank Web UI Features > Action URL > Hold Parameter action_url.unhold <y0000000000xx>.cfg It configures the action URL the phone sends when resuming a hold call. Description Example: action_url.unhold = http://192.168.0.20/help.xml?IP=$ip Permitted URL within 511 characters...
  • Page 442 Advanced Features Default Blank Web UI Features > Action URL > UnMute Parameter action_url.missed_call <y0000000000xx>.cfg It configures the action URL the phone sends when missing a call. Description Example: action_url.missed_call = http://192.168.0.20/help.xml?IP=$ip Permitted URL within 511 characters Values Default Blank Web UI Features >...
  • Page 443 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones action_url.ip_change = http://192.168.0.20/help.xml?IP=$ip Permitted URL within 511 characters Values Default Blank Web UI Features > Action URL > IP Changed Parameter action_url.forward_incoming_call <y0000000000xx>.cfg It configures the action URL the phone sends when forwarding an incoming call.
  • Page 444 Advanced Features It configures the action URL the phone sends when failing to transfer a call. Description Example: action_url.transfer_failed = http://192.168.0.20/help.xml?IP=$ip Permitted URL within 511 characters Values Default Blank Web UI Features > Action URL > Transfer Failed Parameter action_url.setup_autop_finish <y0000000000xx>.cfg It configures the action URL the phone sends when completing auto provisioning via power on.
  • Page 445 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Devices Web UI Features > Action URL > Headset Parameter action_url.handfree <y0000000000xx>.cfg It configures the action URL the phone sends when pressing the Speakerphone key. Description Example: action_url.handfree = http://192.168.0.20/help.xml?IP=$ip Permitted URL within 511 characters...

  • Page 446: Action Uri

    Features > Action URL > VPN IP Action URI Yealink phones can perform the specified action by receiving and handling an HTTP or HTTPS GET request or accept a SIP NOTIFY message with the “Event: ACTION-URI” header from a SIP proxy server.

  • Page 447: Variable Values List

    Variable Values List Yealink phones also support a combination of the variable values in the URI, but the order of the variable value is determined by the operation of the phone. The valid URI format is: http(s)://<phoneIPAddress>/servlet?key=variable value[;variable value]. Variable values are separated by a semicolon from each other.
  • Page 448 Advanced Features Variable Value Phone Action Tap Settings > Status. SPEAKER Press the Speakerphone key. (not applicable to CP960 phones) F_TRANSFER Transfer a call to another party. VOLUME_UP Increase the volume. VOLUME_DOWN Decrease volume. MUTE Mute a call. F_HOLD/HOLD Place an active call on hold. F_CONFERENCE Tap the Conference soft key (not applicable to CP960 phones).
  • Page 449 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Variable Value Phone Action Reset Reset a phone. ATrans=xxx Perform a semi-attended/attended transfer to xxx. Join any two call parties together on the phone using the call-id. After the call is set up, the two parties disconnect with the phone.
  • Page 450 (n is the times of 6, for example, 24). It is only applicable to no answer forward feature. AlwaysFwdOn/BusyFwdOn/NoAn- Note: For Yealink phones, it works only if “features.fwd.allow” is set swFwdOn=xxx=n to 1 (Enabled) and call forward mode is Phone, the always/busy/no answer forward feature will apply to all the accounts on the phone.

  • Page 451: Action Uri Configuration

    Note : Yealink phones also support capturing the screen display using the old URI “http://<- phoneIPAddress>/servlet?command=screenshot”. Before capturing the phone’s current screen, ensure that the IP address of the computer is included in the trusted IP address for Action URI on the phone.

  • Page 452: Example: Placing A Call Via Web User Interface

    Else, the browser will display an image of the phone’s current screen directly. You can save the image to your local system. Note : Frequent capture may affect phone performance. Yealink recommends you to capture the phone screen display within a minimum interval of 4 seconds. Example: Placing a Call via Web User Interface Procedure 1.

  • Page 453: Mwi For Voice Mail Configuration

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones You can configure a message waiting indicator (MWI) to inform users how many messages are waiting in their mail- box without calling the mailbox. Yealink phones support both audio and visual MWI alert when receiving new voice messages.
  • Page 454 1-Enabled, the phone will subscribe to the value of the Voice Mail dsskey from the server. When there Values are unread voice messages, the dsskey LED indicator flashes or the dsskey icon indicates the num- ber of unread messages. Default phone_setting.mail_power_led_flash_enable Related Parameters features.voice_mail_popup.enable X is the account ID. For VP59/T58A, X=1-16; for CP960, X=1.

  • Page 455: Xml Browser

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones XML Browser XML browser simply means that the phone screen display can be managed by external applications. The XML browser feature allows users to develop and deploy custom services which meet user’s functional requirements on the server.
  • Page 456 Advanced Features Values Default 1000 Parameter features.xml_browser.loading_tip.delay <y0000000000xx>.cfg It configures the time (in milliseconds) to wait for the phone to display the loading tip. If the phone doesn’t finish loading an XML page within the specified time, the tip, “Loading, please wait”...

  • Page 457: Hot Desking

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Values Default Blank Hot Desking A primary motivation for hot desking is cost reduction. Hot desking is regularly used in places where not all employ- ees are in the office at the same time, or not in the office for a long time, which means actual personal offices would often be vacant, consuming valuable space and resources.
  • Page 458 Advanced Features Parameter hotdesking.dsskey_password_enable <y0000000000xx>.cfg It enables or disables the phone to provide an input field of password on the hot desking login wizard Description when tapping the Hot Desking DSS key. 0-Disabled Permitted Values 1-Enabled Default Parameter hotdesking.dsskey_sip_server_enable <y0000000000xx>.cfg It enables or disables the phone to provide an input field of SIP server on the hot desking login wizard Description when tapping the Hot Desking DSS key.

  • Page 459: General Features

    Media Loopback Line Identification Presentation Yealink phones can derive calling and connected line identification from SIP headers and display the name asso- ciated with the telephone number on the LCD screen. Calling Line Identification Presentation (CLIP): It allows the phones to display the caller identity, derived from a SIP header contained in the INVITE message when receiving an incoming call.
  • Page 460 <y0000000000xx>.cfg It configures the priority order for the sources of caller identity information. Note: Yealink phones can derive caller identity from the following SIP headers: From, P-Asserted-Iden- Description tity (PAI), P-Preferred-Identity and Remote-Party-ID (RPID). It works only if “account.X.cid_source” is set to 6 (PREFERENCE).

  • Page 461: Return Code For Refused Call

    Values 1-Enabled Default X is the account ID. For VP59/T58A, X=1-16; for CP960, X=1. Return Code for Refused Call You can define the return code and reason of the SIP response message for the refused call. The caller’s phone LCD screen displays the reason according to the received return code. Available return codes and reasons are:...

  • Page 462: Return Code For Unanswered Call Configuration

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Return Code for Unanswered Call Configuration Return Code for Unanswered Call Configuration The following table lists the parameters you can use to configure the return code for the refused call. Parameter features.no_answer_code <y0000000000xx>.cfg It configures a return code and reason of SIP response messages when the phone does not answer Description an incoming call.

  • Page 463: Accept Sip Trust Server Only

    General Features Call Pull Permitted 0-Disabled Values 1-Enabled Default Web UI Features > General Information > Hide Feature Access Codes Accept SIP Trust Server Only Accept SIP trust server only enables the phones to only accept the SIP message from your SIP server and outbound proxy server.

  • Page 464: 100 Reliable Retransmission Configuration

    Default Web UI Account > Advanced > Retransmission X is the account ID. For VP59/T58A, X=1-16; for CP960, X=1. SIP Session Timer SIP session timers T1, T2 and T4 are SIP transaction layer timers defined in 3261. These session timers are configurable on the phones.

  • Page 465: Session Timer

    UAC performs the refresh. Example of UPDATE message (UAC mode): UPDATE sip:1058@10.10.20.34:5060 SIP/2.0 Via: SIP/2.0/UDP 10.10.20.32:5060;branch=z9hG4bK2104991394 From: "10111" <sip:10111@10.2.1.48:5060 > ;tag=2170397024 To: <sip:1058@10.2.1.48:5060 > ;tag=200382096 Call-ID: 4_1556494084@10.10.20.32 CSeq: 2 UPDATE Contact: <sip:10111@10.10.20.32:5060 > Max-Forwards: 70 User-Agent: Yealink T58 58.83.0.15 Session-Expires: 90;refresher=uac...

  • Page 466: Session Timer Configuration

    Web UI Account > Advanced > Session Refresher X is the account ID. For VP59/T58A, X=1-16; for CP960, X=1. Reboot in Talking Reboot in talking feature allows the phones to reboot during an active call when it receives a reboot Notify mes- sage.

  • Page 467: Reserve # In User Name

    Contact: <sip:1010%23@10.3.20.6:5060> Content-Type: application/sdp Allow: INVITE, INFO, PRACK, ACK, BYE, CANCEL, OPTIONS, NOTIFY, REGISTER, SUBSCRIBE, REFER, PUBLISH, UPDATE, MESSAGE Max-Forwards: 70 User-Agent: Yealink T58 58.83.0.15 Allow-Events: talk,hold,conference,refer,check-sync Content-Length: 300 Topic Reserve # in User Name Configuration Reserve # in User Name Configuration The following table lists the parameter you can use to configure the reserve # in user name.

  • Page 468: Busy Tone Delay

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Busy Tone Delay The busy tone is an audible signal to indicate that the call is released by the other party. You can define the amount of time that the busy tone lasts. Topic...

  • Page 469: Media Loopback

    General Features Default Blank Media Loopback The SIP RTP media loopback can be used to make test calls to verify the media path between the phone and server. RTP packets are looped back toward the source device. In a voice loopback call, an echo is heard at the device ori- ginating the call.
  • Page 470 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones 3-encapsulated & directed, the loopback mirror loops back the incoming RTP packets using either the encapsulated RTP payload format or the direct loopback RTP payload format. Default Parameter sip.pkt_loopback_encapsulated_payload <y0000000000xx>.cfg It configures the value of dynamic payload for encapsulated RTP.

  • Page 471: Configuration Parameters

    Configuration Parameters Configuration Parameters This section provides a description and permitted values of some settings. Topics BroadSoft Parameters Start2Start ACD Parameters Ethernet Interface MTU Parameters SIP Settings Parameters Call Settings Parameters APP Settings Configuration BroadSoft Parameters This section shows the parameters you can use to configure the phone with BroadSoft server. For more information on BSFT, refer to Yealink_IP_Phone_Features_Integrated_with_BroadSoft_UC-One_User_ Guide...

  • Page 472: Broadsoft Uc

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Default If you change this parameter, the phone will reboot to make the change take effect. Broadsoft UC Parameter bw.xmpp.enable <y0000000000xx>.cfg It enables or disables the UC feature. Description Note: It works only if “bw.enable" is set to 1 (Enabled).
  • Page 473 Configuration Parameters Values 1-Enabled Default Supported All phones except CP960 Devices Parameter bw.xmpp.change_presence.enable <y0000000000xx>.cfg It enables or disables the phone to change the user’s current presence state locally. Description Note: It works only if “bw.xmpp.enable" is set to 1 (Enabled). Permitted 0-Disabled 1-Enabled...
  • Page 474 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones If only one type is configured, the configured type will have the highest priority. For example, “blf_list” means the IP phone preferentially display the BLF List keys, and remaining keys’ display order is: UC Favorite keys >...

  • Page 475: Broadsoft Xsi

    Configuration Parameters Permitted 0-Disabled Values 1-Enabled Default Supported All phones except CP960 Devices Parameter directory_setting.bw_uc_buddies.priority <y0000000000xx>.cfg Description It configures the display priority of the BroadSoft Buddies directory. Permitted Integer greater than or equal to 0 Values Default Supported All phones except CP960 Devices If you change this parameter, the phone will reboot to make the change take effect.
  • Page 476 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones http-HTTP Permitted Values https-HTTPS Default http Web UI Applications > Broadsoft XSI > XSI Account > XSI Server Type Parameter account.X.xsi.port <MAC>.cfg It configures the port of the Xtended Services Platform server. Description Note: It works only if “bw.xsi.enable" is set to 1 (Enabled).

  • Page 477: Broadsoft Acd

    Permitted 123, abc, ABC or 2aB Values Default X is the account ID. For VP59/T58A, X=1-16; for CP960, X=1. If you change this parameter, the phone will reboot to make the change take effect. Broadsoft ACD Parameter account.X.acd.initial_state <MAC>.cfg Description It configures the initial status after logging in to ACD.
  • Page 478 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Values 1-Enabled Default Supported All phones except VP59 Devices Parameter bw.virtual_user.1.enable <MAC>.cfg It enables or disables the virtual account for the call center. Description Note: It works only if “bw.xsi.enable” is set to 1 (Enabled).

  • Page 479: Broadsoft Centralized Call Recording

    BroadWorks. Permitted String within 99 characters Values Default Blank X is the account ID. For VP59/T58A, X=1-16. Y is the code ID. Y=1-100. Broadsoft Centralized Call Recording Parameter account.X.call_recording.enable <MAC>.cfg Description It enables or disables the centralized call recording feature.

  • Page 480: Broadsoft Security Classification

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Default X is the account ID. For VP59/T58A, X=1-16; for CP960, X=1. Broadsoft Security Classification Parameter account.X.security_classification.enable <MAC>.cfg Description It enables or disables security classification feature. Permitted 0-Disabled Values 1-Enabled Default X is the account ID. For VP59/T58A, X=1-16; for CP960, X=1.

  • Page 481: Broadsoft Flexible Seating

    Permitted 0-Disabled 1-Enabled Values Default X is the account ID. For VP59/T58A, X=1-16. Broadsoft Flexible Seating Parameter account.X.flexible_seating.enable <MAC>.cfg It enables or disables the flexible seating feature. Description Note: For the host, it works only if “account.X.hoteling.enable” and “account.X.acd.enable” are set to 0 (Disabled).

  • Page 482: Broadsoft Call Decline

    0-Disabled Permitted Values 1-Enabled Default X is the account ID. For VP59/T58A, X=1-16; for CP960, X=1. Related Topic Securely Storing the LDAP Credentials Broadsoft Call Decline Parameter account.X.features.call_decline.enable <MAC>.cfg Description It enables or disables call decline feature.

  • Page 483: Broadsoft Network Directory

    Configuration Parameters Broadsoft Network Directory Parameter bw.xsi.directory.enable <y0000000000xx>.cfg It enables or disables the network directory feature. Description Note: It works only if “bw.xsi.enable" is set to 1 (Enabled). Permitted 0-Disabled Values 1-Enabled Default Parameter bw_phonebook.group_enable <y0000000000xx>.cfg It enables or disables the phone to display the group directory. Description Note: It works only if "bw.xsi.directory.enable"...
  • Page 484 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Values 1-Enabled Default Web UI Applications > Broadsoft XSI > Network Directory > Enterprise Common Parameter bw_phonebook.enterprise_common_displayname <y0000000000xx>.cfg It configures the display name on the phone screen for the enterprise common directory. Description Note: It works only if "bw.xsi.directory.enable" and "bw_phonebook.enterprise_common_enable" are set to 1 (Enabled).
  • Page 485 1-Enabled, you are allowed to select a specific account to access the BroadSoft Call Log and view the call log entry Default Supported T58A, VP59 Devices Parameter directory.update_time_interval <y0000000000xx>.cfg It configures the interval (in minutes) for the phone to update the data of the BroadSoft directory from the BroadSoft server.
  • Page 486 It enables or disables the phone to directly enter the Network Calls screen when tapping (for Description VP59/T58A)/History (for CP960) on the idle screen. Note: It works only if "bw.xsi.call_log.enable" is set to 1 (Enabled). 0-Disabled, the phone will enter Local Calls screen when tapping...

  • Page 487: Broadsoft Visual Voice Mail

    Configuration Parameters Values Default Parameter directory_setting.bw_directory.enable <y0000000000xx>.cfg It enables or disables the users to access the BroadSoft directory by tapping the directory icon ( Description for VP59/T58A, for CP960). Permitted 0-Disabled 1-Enabled Values Default Parameter directory_setting.bw_directory.priority <y0000000000xx>.cfg Description It configures the display priority of the BroadSoft directory.

  • Page 488: Broadsoft Sca

    0-Disabled, the phone will send a notify message to the server to release the connection. 1-Enabled Values Default X is the account ID. For VP59/T58A, X=1-16; for CP960, X=1. Broadsoft Call Park Parameter features.call_park.park_mode <y0000000000xx>.cfg Description It configures the call park mode.
  • Page 489 Configuration Parameters Default Web UI Features > Pickup & Park > Group Call Park Parameter features.call_park.park_ring <y0000000000xx > .cfg It enables or disables the phone to play a warning tone when a call is parked against its line. Description Note: It works only if “features.call_park.park_visual_notify_enable” is set to 1 (Enabled). 0-Disabled Permitted Values...

  • Page 490: Broadsoft Emergency Call

    1-Enabled, the phone sends the subscription package to the server with the header "Event:x-broad- Values works-callpark" Default X is the account ID. For VP59/T58A, X=1-16; for CP960, X=1. Broadsoft Emergency Call Parameter bw.emergency_calling.enable <y0000000000xx>.cfg Description It enables or disables the BroadWorks Emergency Calling feature.

  • Page 491: Alcatel-Lucent Barge In Parameters

    <MAC>.cfg It configures the URL the phone sends when the ACD agent changes the status to away (you press the Away soft key on the phone). For example : account.1.acd.away_url= http://portal-dev.star2star.com:8181/yealink/reason_code_respon- se?reason_code=#REASONCODE&agent_extension=ext_843 85&agent_location= starbox_628&a- Description gent_phone=94&customer_id=435s #REASONCODE will be automatically replaced with the away code you entered when the URL is sent to the server.
  • Page 492 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Note: It applies to the Alcatel-Lucent CTS only. Permitted String within 32 characters Values Default Blank The feature access code is *32. A (your phone) monitors party B (number: 8866), party B and party C is during the call.

  • Page 493: Ethernet Interface Mtu Parameters

    Configuration Parameters blf.listen_barge_in_code = *32 features.blf.show_callinfo.enable = 1 During the call of the monitored line, long press the BLF key and you press the Listen BargeIn soft key, then the phone calls *328866 to barge in the call. You are automatically muted, so you can hear all call participants, but no one can hear you.
  • Page 494 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Parameter account.X.invite_with_rpid_header.enable <MAC>.cfg It enables or disables the phone to add the Remote-Party-ID (RPID) header in the initial INVITE mes- Description sage. Permitted 0-Disabled 1-Enabled Values Default Parameter sip.unreg_with_socket_close <y0000000000xx>.cfg It enables or disables the phone to close the socket immediately when the user deregisters the cor- Description responding account(s).
  • Page 495 Configuration Parameters Parameter sip.tcp_port_random_mode <y0000000000xx>.cfg Description It configures the listening port mode. 0-random source port (non 506x), fixed ports (506x) carried in the Contact, Via header. Permitted Values 1-random source port (non 506x) and other ports (non 506x) carried in the Contact, Via header. Default Parameter sip.listen_mode <y0000000000xx>.cfg...

  • Page 496: Call Settings Parameters

    0-Disabled Permitted Values 1-Enabled Default X is the account ID. For VP59/T58A, X=1-16; for CP960, X=1. If you change this parameter, the phone will reboot to make the change take effect. Call Settings Parameters Parameter phone_setting.show_code403 <y0000000000xx>.cfg It configures the display message on the phone screen when receiving a 403 message.

  • Page 497: App Settings Configuration

    Configuration Parameters Description It enables or disables the phone to end the call if the network is unavailable during the call. 0-Disabled Permitted Values 1-Enabled, the phone will end the call and go to the Idle screen after 5 seconds. Default Parameter features.station_name.value <y0000000000xx>.cfg...
  • Page 498 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones app.uninstall = com.google.android.music Permitted Software package name or APK file name or Application name Values Default Blank Supported All phones except CP960 Devices Parameter app.autorun <y0000000000xx>.cfg It specifies the application to automatically run after the phone starts up.

  • Page 499: Unify Parameters

    Configuration Parameters Unify Parameters Parameter unify.enable <y0000000000xx>.cfg Description It enables or disables the Unify features. 0-Disabled Permitted Values 1-Enabled Default Case Scen- Identify the Notify messages sent by the Unify server and synchronize the FWD / DND feature with ario server.

  • Page 500: Troubleshooting Methods

    Troubleshooting Methods Troubleshooting Methods Yealink phones provide feedback in a variety of forms such as log files, packets, status indicators and so on, which can help you more easily find the system problem and fix it. Topics Log Files Resetting Phone and Configuration...

  • Page 501: Local Logging Configuration

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Viewing the Log Files Local Logging Configuration The following table lists the parameters you can use to configure local logging. Parameter static.local_log.enable <y0000000000xx>.cfg It enables or disables the phone to record log locally. Description Note: We recommend that you do not disable this feature.
  • Page 502 Troubleshooting Methods (2) If “static.auto_provision.local_log.backup.enable” is set to 0 (Disabled), the phone will erase half of the logs from the oldest log information on the phone. Example: static.local_log.max_file_size = 1024 Permitted Integer from 2048 to 20480 Values Default 20480 Web UI Settings >...

  • Page 503: Exporting The Log Files To A Local Pc

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Default Blank Parameter static.auto_provision.local_log.backup.append <y0000000000xx>.cfg It configures whether the uploaded local log files overwrite the existing files or are appended to the Description existing files. 0-Overwrite Permitted Values 1-Append (not applicable to TFTP Server) Default Parameter static.auto_provision.local_log.backup.append.limit_mode...

  • Page 504: Viewing The Log Files

    Troubleshooting Methods 1. From the web user interface, navigate to Settings > Configuration. 2. In the Enable Local Log field, select Enabled or ON. 3. In the USB Auto Exporting Syslog field, select Enabled or ON. 4. Select the desired value from the Local Log Level drop-down menu. The default local log level is “3”.

  • Page 505: Syslog Logging

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones The <MAC>.log file reports the logs with a configured severity level and the higher. For example, if you have con- figured the severity level of the log to be reported to the <MAC>.log file to 4, then the log with a severity level of 0 to 4 will all be reported.
  • Page 506 Troubleshooting Methods Web UI Settings > Configuration > Syslog > Syslog Transport Type Parameter static.syslog.level <y0000000000xx>.cfg It configures the lowest level of syslog information that displays in the syslog. When you choose a log level, it includes all events of an equal or higher severity level and excludes Description events of a lower severity level.

  • Page 507: Viewing The Syslog Messages On Your Syslog Server

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones 18-Local Use 2 (Local2) 19-Local Use 3 (Local3) 20-Local Use 4 (Local4) 21-Local Use 5 (Local5) 22-Local Use 6 (Local6) 23-Local Use 7 (Local7) Note: Note 1 - Various operating systems have been found to utilize Facilities 4, 10, 13 and 14 for security/authorization, audit, and alert messages which seem to be similar.

  • Page 508: Reset To Factory Configuration

    Troubleshooting Methods Reset local settings: All configurations saved in the <MAC>-local.cfg file on the phone will be reset. Changes associated with non-static settings made via the web user interface and phone user interface are saved in the <MAC>-local.cfg file. Reset non-static settings: All non-static parameters will be reset. After resetting the non-static settings, the phone will perform auto provisioning immediately.

  • Page 509: Resetting The Ip Phone To Default Factory Settings

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Resetting the IP phone to Default Factory Settings Procedure 1. Click Settings > Upgrade. 2. Click Reset to Factory in the Reset to Factory field. The web user interface prompts the message “Do you want to reset to factory?”.

  • Page 510: Packets Capture

    Ethernet Software Capturing Configuration Capturing the Packets via Web User Interface For Yealink phones, you can export the packets file to the local system and analyze it. Yealink devices support the following two modes for capturing the packets: Normal: Export the packets file after stopping capturing.

  • Page 511: Capturing The Packets In Normal Way

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Note: The steps may differ for different web browsers. Capturing the Packets in Normal Way Procedure 1. From the web user interface, navigate to Settings > Configuration. 2. Select Normal from the Pcap Type drop-down menu.

  • Page 512: Watch Dog Configuration

    Troubleshooting Methods Watch Dog Configuration The following table lists the parameter you can use to configure watch dog. Parameter static.watch_dog.enable <y0000000000xx>.cfg Description It enables or disables the Watch Dog feature. 0-Disabled Permitted Values 1-Enabled, the phone will reboot automatically when the system crashed. Default Web UI Settings >...

  • Page 513: Analyzing Configuration Files

    We recommend that you edit the exported CFG file instead of the BIN file to change the phone’s current settings. The config.bin file is an encrypted file. For more information on config.bin file, contact your Yealink reseller. Topics...

  • Page 514: Exporting Cfg Configuration Files From Phone

    Troubleshooting Methods Exporting CFG Configuration Files from Phone You can export the phone’s configuration file to local and make changes to the phone’s current feature settings. You can apply these changes to any phone by importing the configuration files via the web user interface. You can export five types of CFG configuration files to the local system: <MAC>-local.cfg: It contains changes associated with non-static parameters made via the phone user interface and web user interface.

  • Page 515: Importing Bin Files From The Phone

    Account status (registration status of SIP accounts). Storage status (only applicable to VP59/T58A). Dongle status (mode, hardware version, APP version, rom version, RFPI, area; only applicable when DECT USB dongle DD10K is connected to the VP59/T58A). Wi-Fi status Topic Viewing Device Status Viewing Device Status You can view device status via the phone user interface by navigating to Settings >...

  • Page 516: Phone Reboot

    Troubleshooting Methods For example, “http://192.168.0.10” for IPv4 or “http://[2005:1:1:1:215:65ff:fe64:6e0a]” for IPv6. 3. Enter the user name (admin) and password (admin) in the login page. 4. Click Login to log in. The device status is displayed on the first page of the web user interface. Phone Reboot You can reboot the IP phone remotely or locally.

  • Page 517: Rebooting The Device Via Web User Interface

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Rebooting the Device via Web User Interface You can reboot your IP phone via the web user interface. Procedure 1. Click Settings > Upgrade. 2. Click Reboot. The device begins rebooting. Any reboot of the device may take a few minutes.

  • Page 518: Troubleshooting Solutions

    Troubleshooting Solutions Troubleshooting Solutions This section describes solutions to common issues that may occur while using the device. Upon encountering a case not listed in this section, contact your Yealink reseller for further support. Topics IP Address Issues Time and Date Issues...

  • Page 519: Time And Date Issues

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Yealink phones support using FTP, TFTP, HTTP, and HTTPS protocols to download configuration files or resource files. You can use one of these protocols for provisioning. When provisioning your IP phone obtaining an IPv6 address, the provisioning server should support IPv6 and the format of the access URL of the provisioning server can be “tftp://[IPv6 address or domain name]”.

  • Page 520: There Is No Sound When The Other Party Picks Up The Call

    The phone cannot connect to Bluetooth devices all the time Try to delete the registration information of the Bluetooth device on both IP phone and Bluetooth device, and then pair and connect it again. Contact Yealink field application engineer and your Bluetooth device manufacturer for more information.

  • Page 521: The Bluetooth Headset Affects Ip Phone's Voice Quality

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones The Bluetooth headset affects IP phone’s voice quality You may not experience the best voice quality if you use a Bluetooth headset while the 2.4 GHz band is enabled or while you are in an environment with many other Bluetooth devices. This possible loss in voice quality is due to inherent limitations with Bluetooth technology.

  • Page 522: The Ip Phone Does Not Update The Configurations

    Ensure that you have configured the syslog server address correctly via the web user interface on your IP phone. Reboot the phone. The configurations require a reboot to take effect. Protocols and Ports Issues What communication protocols and ports do Yealink IP phones sup- port? Destination...

  • Page 523: Password Issues

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones Destination Source Destination Destination Description of des- Source IP Source Port Port (Listen- Protocol Device Device tination port ing port) by des- used for AA com- of AA tination munication. device. IP address DHCP protocol port, it is...

  • Page 524: The Web Screen Displays "Default Password Is In Use. Please Change

    Troubleshooting Solutions The web screen displays " Default password is in use. Please change!" The web screen prompts "Default password is in use. Please change!" message when the default password is in use. Click the warning message to change the password. Power and Startup Issues Both PoE cable and power adapter is connected to the phone The phones use the PoE preferentially.

  • Page 525: The Difference Between Rfc 2543 Hold Enabled And Disabled

    Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones The difference between RFC 2543 Hold enabled and disabled Capturing packets after you enable the RFC 2543 Hold feature. SDP media direction attributes (such as a=se- endonly) per RFC 2543 is used in the INVITE message when placing a call on hold.

  • Page 526: Appendix

    Appendix Appendix RFC and Internet Draft Support The following RFC’s and Internet drafts are supported: RFC 1321—The MD5 Message-Digest Algorithm RFC 1889—RTP Media control RFC 2112—Multipart MIME RFC 2327—SDP: Session Description Protocol RFC 2387—The MIME Multipart/Related Content-type RFC 2543—SIP: Session Initiation Protocol RFC 2617—Http Authentication: Basic and Digest access authentication RFC 2782—A DNS RR for specifying the location of services (DNS SRV) RFC 2806—URLs for Telephone Calls...
  • Page 527 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones RFC 3665—Session Initiation Protocol (SIP) Basic Call Flow Examples RFC 3666—SIP Public Switched Telephone Network (PSTN) Call Flows. RFC 3680—SIP Event Package for Registrations RFC 3702—Authentication, Authorization, and Accounting Requirements for the SIP RFC 3711—The Secure Real-time Transport Protocol (SRTP) RFC 3725—Best Current Practices for Third Party Call Control (3pcc) in the Session Initiation Protocol (SIP)

  • Page 528: Reading Icons

    RFC number. Reading Icons Icons associated with different features may appear on the touch screen. The following table provides a description for each icon on the phones. VP59/T58A CP960 Description Wired network is unavailable Wired network is unreachable...
  • Page 529 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones VP59/T58A CP960 Description No Answer Forward Call Hold (video) Call Hold (audio-only) Call Mute Keep Mute Call is encrypted (video) Call is encrypted (audio-only) Silent mode Phone Lock Received Calls Placed Calls Missed Calls...
  • Page 530 Appendix VP59/T58A CP960 Description Wi-Fi mode is on Wi-Fi connection is unreachable The default local caller photo and local contact icon The default mobile caller photo and mobile contacts icon DSS Key Line key type is Line (line is seized)
  • Page 531 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones VP59/T58A CP960 Description Line key type is Call Park/XML Park (call park ringing state) Park failed Line key type is Intercom (intercom idle state) Line key type is Intercom (intercom ringing state) Line key type is Intercom (intercom callout state)
  • Page 532 Appendix VP59/T58A CP960 Description Line key type is Zero Touch Line key type is URL Line key type is DECT Intercom The ACD state is available The ACD state is unavailable The ACD state is wrap up Log out of the ACD system...
  • Page 533 Administrator’s Guide for VP59/SIP-T58A/CP960 IP Phones VP59/T58A CP960 Description The slave phone is disconnected with the master phone. The star connection group is set up, but there are no slave phones in the star connection group. The number of the slave phones connected successfully is less than the maximum number of slave phones in a star connection group.

This manual is also suitable for:

T58aCp960

Table of Contents

Save PDF