background image

Summary of Contents for One Talk CP960

Page 1: ......

Page 2: ... a provisioning server If you are a novice this guide is helpful for you l Using features integrated with Broadsoft UC One refer to the following two guides to have a better knowledge of BroadSoft features IP Phones Deployment Guide for BroadSoft UC One Environments describes how to configure BroadSoft fea tures on the BroadWorks web portal and phones IP Phone Features Integrated with BroadSoft UC...

Page 3: ...guration l Call Park and Retrieve Configuration l Call Transfer Configuration l LDAP Configuration l SCA Configuration l Incoming Intercom Configuration l VPN Configuration l Internet Port and PC Port Configuration l Warnings Display l BroadSoft Settings l Wi Fi Configuration l Ethernet Interface MTU Parameters l Call Display Configuration l Network Conference Configuration l Handset Headset Speak...

Page 4: ...up 21 Network Configurations 22 IPv4 and IPv6 Wired Network Settings 22 Wired Network IP Addressing Mode Configuration 22 IPv4 Wired Network Configuration 23 IPv6 Wired Network Configuration 25 DHCP Option for IPv4 27 Supported DHCP Option for IPv4 27 DHCP Option 66 Option 43 and Custom Option 28 DHCP Option 42 and Option 2 28 DHCP Option 12 28 DHCP Option 12 Hostname Configuration 28 DHCP Option ...

Page 5: ...ration 50 Internet Port and PC Port 51 Supported Transmission Methods 52 Internet Port and PC Port Configuration 52 VPN 53 OpenVPN Related Files 53 VPN Configuration 54 Example Using VPN based on L2TP Prototol 55 Exporting the OpenVPN Configuration File from the Phone 55 Importing the OpenVPN Configuration File to Phone 56 Quality of Service QoS 56 Voice Video and SIP QoS Configuration 56 802 1x A...

Page 6: ...s 82 Provisioning Protocols Configuration 82 Supported Provisioning Server Discovery Methods 83 Zero Touch Provision Configuration 83 PnP Provision Configuration 84 DHCP Provision Configuration 84 Static Provision Configuration 85 Configuring a Provisioning Server 86 Keeping User s Personalized Settings after Auto Provisioning 87 Keeping User s Personalized Settings Configuration 87 Auto Provision...

Page 7: ...1 Firmware for Each Phone Model 111 Firmware Upgrade Configuration 111 Using Handsets with VP59 T58A Phones 112 Handset Backlight 112 Handset Backlight Configuration 112 Handset Keypad Light 113 Handset Keypad Light Configuration 113 Handset Wallpaper 114 Handset Wallpaper Configuration 114 Handset Screen Saver 114 Handset Screen Saver Configuration 114 Handset Name 115 Handset Name Configuration ...

Page 8: ...7 Distinctive Ring Tones 138 Supported Alert Info Headers Format 138 Alert Info Bellcore drN 139 Alert Info ringtone N Alert Info ringtone RingN wav or Alert Info MyMelodyN Alert Info MyMelodyRingN wav 140 Alert Info URL 141 Alert Info info info text x line id 0 141 Distinctive Ring Tones Configuration 142 Ringer Device 143 Ringer Device Configuration 143 Audio Volume 143 Ringer Volume Configurati...

Page 9: ...Smart Noise Filtering Configuration 164 DTMF 164 DTMF Keypad 165 Transmitting DTMF Digit 165 Transmitting DTMF Digit Configuration 165 Suppress DTMF Display 167 Suppress DTMF Display Configuration 167 Transfer via DTMF 167 Transfer via DTMF Configuration 168 Local DTMF Tone 168 Local DTMF Tone Configuration 168 Voice Quality Monitoring VQM 168 RTCP XR 169 RTCP XR Configuration 169 VQ RTCPXR 169 Vo...

Page 10: ...184 Screen Saver 184 Screensaver Configuration 184 Backlight 185 Supported Backlight Options 185 Backlight and Time Configuration 186 Label Length for Line Key Display 186 Label Length Display Configuration 186 Page Tips 187 Phone Page Tips 187 Phone Page Tips Indicator 187 Phone Page Tips Configuration 188 Expansion Module Page Tips 189 Expansion Module Page Tips Indicator 189 Expansion Module Pa...

Page 11: ...ortcut Key Programmable Key Icons Limit 218 Line Keys 219 Line Keys Configuration 219 Example Set a Park Retrieve Key for FAC Call Park Mode 222 Example Set a Park Retrieve Key for Transfer Call Park Mode 223 Example Setting a Line Key as Directed Pickup Key 223 Example Setting a Line Key as Group Pickup Key 224 Example Setting a Line Key as BLF List Key 224 Example Setting a Line Key as Private H...

Page 12: ...tion 255 Recent Call Display in Dialing 257 Recent Call in Dialing Configuration 257 Icon Customization 258 Custom Icons Configuration 258 Door Phone 258 Door Phone Parameters 259 Android Keys Display 262 Android Keys Display Configuration 263 Status Bar and Control Notification Center Display 263 Status Bar and Control Notification Center Display Configuration 263 Warnings Display 264 Warnings Di...

Page 13: ...r Formatted File 290 Local Contact File Customization 291 XML Conversion Table 292 Local Contact File Elements and Attributes 292 Customizing Local Contact File 293 Local Contact Files and Resource Upload 294 Example Adding Contacts Using a Contact File 295 Local Contacts Backup 296 Favorite Contacts 297 Favorites Configuration 297 Google Contacts 298 Registering Android ID on VP59 Phones 298 Goog...

Page 14: ...tion 322 Replace Rule File Attributes 322 Customizing the Replace Rule File 323 Dial Now File Customization 323 Dial Now File Attributes 323 Customizing the Dial Now File 324 Replace Rule Configuration 324 Dial Now Configuration 325 Area Code Configuration 326 Block Out Configuration 327 Example Adding Replace Rules Using a Replace Rule File 328 Dial Plan Defined by Digit Map New Dial Plan Mechani...

Page 15: ...ting 353 Call Waiting Configuration 353 Do Not Disturb DND 354 DND Settings Configuration 354 DND Feature Configuration 356 DND in Phone Mode Configuration 356 DND in Custom Mode Configuration 357 DND Synchronization for Server side Configuration 358 Multiple Call Appearances 360 Multiple Call Appearances Configuration 360 Call Hold 361 Call Hold Configuration 361 Music on Hold MoH Configuration 3...

Page 16: ...decs 390 Video Codecs Configuration 391 Advanced Features 393 Call Pickup 393 Directed Call Pickup 393 Directed Call Pickup Configuration 393 Group Call Pickup 394 Group Call Pickup Configuration 395 Dialog Info Call Pickup 395 Dialog Info Call Pickup Configuration 397 Call Completion 397 Call Completion Configuration 399 Example Using Call Completion 399 Call Park and Retrieve 400 Call Park and R...

Page 17: ...n and Behavior for Hold State Configuration 421 BLF Key LED Icon and Behavior for DND State Configuration 421 BLF Key for Intercom Configuration 422 Call Information Display Configuration 422 Shared Line 423 State Indicator of Shared Line 423 Shared Call Appearance SCA Configuration 423 SCA Configuration 424 Intercom 425 Intercom Key Configuration 425 State Monitor for Intercom Contact 426 State I...

Page 18: ...mission Configuration 461 SIP Session Timer 461 SIP Session Timer Configuration 461 Session Timer 462 Session Timer Configuration 463 Reboot in Talking 463 Reboot in Talking Configuration 463 Reserve in User Name 464 Reserve in User Name Configuration 464 Busy Tone Delay 465 Busy Tone Delay Configuration 465 CFG File Version Information 465 CFG File Version Information Configuration 465 Media Loop...

Page 19: ...ssages on Your Syslog Server 504 Resetting Phone and Configuration 504 Reset to Factory Configuration 505 Resetting the IP phone to Default Factory Settings 506 Resetting the IP phone to Custom Factory Settings 506 Custom Factory Configuration 506 Deleting the Custom Factory Settings Files 506 Packets Capture 507 Capturing the Packets via Web User Interface 507 Capturing the Packets in Enhanced Wa...

Page 20: ...ng a call 516 There is no sound when the other party picks up the call 517 Play the local ringback tone instead of media when placing a long distance number without plus 0 517 Camera and Video Issues 517 The video quality is bad 517 You cannot preview local video when the phone is idle 517 There is some dazzle light on the images when previewing the local video 517 Wi Fi and Bluetooth Issues 517 T...

Page 21: ... and Startup Issues 521 Both PoE cable and power adapter is connected to the phone 521 The power LED indicator has no lights 521 The Phone screen is black 521 Other Issues 521 The difference among user name register name and display name 521 On code and off code 521 The difference between RFC 2543 Hold enabled and disabled 522 Appendix 523 RFC and Internet Draft Support 523 Reading Icons 525 ...

Page 22: ...Notepad to create and edit boot files configuration files and resource files Yealink IP Phones in a Network Most Yealink phones are connected physically through a Category 5E CAT5E cable to a 10 100 1000Mbps Eth ernet LAN and send and receive all data using the same packet based technology Some phones support the wire less network Since the IP phone is a data terminal digitized audio being just an...

Page 23: ...rical supply the device begins its ini tialization process Topics Loading the ROM File Configuring the VLAN Querying the DHCP Dynamic Host Configuration Protocol Server Contacting the Provisioning Server Updating Firmware Downloading the Resource Files Loading the ROM File The ROM file resides in the flash memory of the device The device comes from the factory with a ROM file pre loaded During ini...

Page 24: ... does not obtain configurations from the provisioning server it will use the configurations stored in the flash memory Updating Firmware If you define the access URL of firmware in the configuration file the device will download the firmware from the pro visioning server If the MD5 value of the downloaded firmware file differs from that stored in the flash memory the device will perform a firmware...

Page 25: ...HCP where possible to elim inate repetitive manual data entry You can also configure IPv4 or IPv6 network settings manually Note Yealink devices comply with the DHCPv4 specifications documented in RFC 2131 and DHCPv6 specifications doc umented in RFC 3315 Topics Wired Network IP Addressing Mode Configuration IPv4 Wired Network Configuration IPv6 Wired Network Configuration Wired Network IP Address...

Page 26: ...arameter the phone will reboot to make the change take effect IPv4 Wired Network Configuration The following table lists the parameters you can use to configure IPv4 wired network Parameter static network internet_port type 1 y0000000000xx cfg Description It configures the Internet port type for IPv4 wired network Note It works only if static network ip_address_mode is set to 0 IPv4 or 2 IPv4 IPv6...

Page 27: ...feature to on or off for the wired network Note It works only if static network internet_port type is set to 0 DHCP Permitted Values 0 Off the phone will use the IPv4 DNS obtained from DHCP 1 On the phone will use manually configured static IPv4 DNS Default 0 Web UI Network Basic IPv4 Config Static DNS Phone UI Settings Advanced Settings default password admin Network WAN Port IPv4 Type DHCP Stati...

Page 28: ...Pv6 on the phone the server can specify the IP phone to obtain the IPv6 address and other network settings either from SLAAC or from DHCPv6 if the SLAAC server is not working the phone will try to obtain the IPv6 address and other network settings via DHCPv6 The following table lists the parameters you can use to configure IPv6 wired network Parameter static network ipv6_internet_port type 1 y0000...

Page 29: ...rk ipv6_static_dns_enable 1 y0000000000xx cfg Description It triggers the static IPv6 DNS feature to on or off for the wired network Note It works only if static network ipv6_internet_port type is set to 0 DHCP Permitted Values 0 Off the phone will use the IPv6 DNS obtained from DHCP 1 On the phone will use manually configured static IPv6 DNS Default 0 Web UI Network Basic IPv6 Config Static IPv6 ...

Page 30: ...settings via SLAAC Stateless Address Autoconfiguration Note It works only if static network ipv6_internet_port type is set to 0 DHCP Permitted Values 0 Disabled 1 Enabled Default 1 Web UI Network Advanced ICMPv6 Status Active 1 If you change this parameter the phone will reboot to make the change take effect DHCP Option for IPv4 The phone can obtain IPv4 related parameters in an IPv4 network via t...

Page 31: ... detecting option 43 during startup Note If you fail to configure the DHCP options for discovering the provisioning server on the DHCP server enable the phone to automatically discover the provisioning server address One possibility is that connecting to the secondary DHCP server that responds to DHCP INFORM queries with a requested provisioning server address For more information refer to RFC 392...

Page 32: ...dress 1 The value obtained from DHCP option 120 is used as outbound proxy server IP address can resolve up to two domain names or IPv4 addresses If account X outbound_proxy_enable 1 and the primary outbound proxy server is configured the address from DHCP option 120 is used as sec ondary one if the primary outbound proxy server is not configured the address from DHCP option 120 is used as the prim...

Page 33: ...escription DNS Server 23 Specify a list of DNS servers available to the client DNS Domain Search List 24 Specify a domain search list to a client SNTP Server 31 Specify a list of Simple Network Time Protocol SNTP servers available to the client Information Refresh Time 32 Specify an upper bound for how long a client should wait before refreshing inform ation retrieved from DHCPv6 Boot File URL 59 ...

Page 34: ...bles or disables the LLDP feature Permitted Values 0 Disabled 1 Enabled the phone attempts to determine its VLAN ID through LLDP Default 1 Web UI Network Advanced LLDP Active Phone UI Settings Advanced Settings default password admin Network LLDP LLDP Status Parameter static network lldp packet_interval 1 y0000000000xx cfg Description It configures the interval in seconds that how often the phone ...

Page 35: ... You can configure VLAN for the Internet port and PC port manually Before configuring VLAN on the phones you need to obtain the VLAN ID from your network administrator For CP960 phones you can only configure VLAN for the Internet port manually because they only have an Internet port The following table lists the parameters you can use to configure VLAN manually Parameter static network vlan intern...

Page 36: ... UI Network Advanced VLAN PC Port Active Phone UI Settings Advanced Settings default password admin Network VLAN PC Port VLAN Status Parameter static network vlan pc_port_vid 1 y0000000000xx cfg Description It configures the VLAN ID for the PC port Note It works only if static network pc_port enable is set to 1 Auto Negotiation and stat ic network vlan pc_port_enable is set to 1 Enabled Permitted ...

Page 37: ... the DHCP option from which the phone will obtain the VLAN settings Multiple DHCP options at most five are separated by commas Permitted Values Integer from 1 to 255 Default 132 Web UI Network Advanced VLAN DHCP VLAN Option 1 255 Phone UI Settings Advanced Settings default password admin Network VLAN DHCP VLAN Option 1 If you change this parameter the phone will reboot to make the change take effe...

Page 38: ...Values 0 If Wi Fi mode is activated the wired network is unavailable Wi Fi mode must be deactivated if you want to use the wired network 1 Use wireless network preferentially 2 Use wired network preferentially Default 2 Parameter static network redundancy failback timeout 1 y0000000000xx cfg Description It configures the time to wait minutes for the phone to switch to the preferentially used netwo...

Page 39: ...ity_mode 2 y0000000000xx cfg Description It configures the security mode of a specific wireless network Note It works only if static wifi enable is set to 1 Enabled If it is set to 802 1x EAP the CA cer tificate can be uploaded by the parameter static network 802_1x root_cert_url the user certificate can be uploaded by the parameter static network 802_1x client_cert_url Permitted Values NONE WEP W...

Page 40: ...Blank Web UI Network Wi Fi Add Anonymous Identity Parameter static wifi X eap_password 2 y0000000000xx cfg Description It configures the EAP authentication password of a specific wireless network Note It works only if static wifi enable is set to 1 Enabled and static wifi X security_mode is set to 802 1x EAP Permitted Values String within 64 characters Default Blank Web UI Network Wi Fi Add Passwo...

Page 41: ...6 Phone UI Settings Advanced Settings default password admin Network Wi Fi Port IP Mode Preference 1 If you change this parameter the phone will reboot to make the change take effect IPv4 Wireless Network Configuration The following table lists the parameters you can use to configure IPv4 wireless network Parameter static network wifi internet_port type 1 y0000000000xx cfg Description It configure...

Page 42: ... IPv4 or 2 IPv4 IPv6 and static network wifi internet_port type is set to 2 Static IP Permitted Values IPv4 Address Default Blank Web UI Network Basic IPv4 Config Configuration Type Static IP Default Gateway Phone UI Settings Advanced Settings default password admin Network Wi Fi Port IPv4 Type Static IP Gateway Parameter static network wifi static_dns_enable 1 y0000000000xx cfg Description It tri...

Page 43: ...e phone will reboot to make the change take effect IPv6 Wireless Network Configuration If you configure the network settings on the phone for an IPv6 network you can set up an IP address for the phone by using SLAAC ICMPv6 DHCPv6 or by manually entering an IP address Ensure that your network environment supports IPv6 Contact your ISP for more information When you enable both SLAAC and DHCPv6 on th...

Page 44: ...t gateway for the wireless network 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 Values IPv6 Address Default Blank Web UI Network Wi Fi IPv6 Config Configuration Type Static IP Default Gateway Phone UI Settings Advanced Settings default password admin Network Wi Fi Port IPv6 ...

Page 45: ...UI Settings Advanced Settings default password admin Network Wi Fi Port IPv6 Type Static IP Sec DNS In DHCP environment Settings Advanced Settings default password admin Network Wi Fi Port IPv6 Type DHCP Static DNS Enabled Sec DNS Parameter static network wifi ipv6_icmp_v6 enable 1 y0000000000xx cfg Description It enables or disables the phone to obtain IPv6 wireless network settings via SLAAC Sta...

Page 46: ...UI Settings Basic Settings AP Configure AP Name Parameter static wifiap security_mode y0000000000xx cfg Description It configures the security mode of the wireless AP Permitted Values None WPA2 PSK Default WPA2 PSK Supported Devices All phones except CP960 Web UI Network Wireless AP Security Mode Phone UI Settings Basic Settings AP Configure AP Security Mode Parameter static wifiap password y00000...

Page 47: ...el Phone UI Settings Basic Settings AP Configure AP Channel Parameter static wifiap dhcpd mode y0000000000xx cfg Description It configures the generation type of wireless AP address Permitted Values 0 Auto the phone generates the wireless AP address automatically 1 Manual if automatically generated network segment conflicts with the one you use you can change the network segment manually Default 0...

Page 48: ...t min_rtpport 1 y0000000000xx cfg Description It configures the minimum local RTP port Permitted Values Integer from 1024 to 65535 Default 11780 Supported Devices CP960 Web UI Network Advanced Local RTP Port Min RTP Port 1024 65535 Parameter static network port max_rtpport 1 y0000000000xx cfg Description It configures the maximum local RTP port Permitted Values Integer from 1024 to 65535 Default 1...

Page 49: ...ription It enables or disables the NAT traversal for a specific account Note If it is set to 1 STUN it works only if static sip nat_stun enable is set to 1 Enabled if it is set to 2 Manual NAT it works only if static network static_nat enable is set to 1 Enabled Permitted Values 0 Disabled 1 STUN 2 Manual NAT Default 0 Web UI Account Register NAT Phone UI Settings Advanced Settings default passwor...

Page 50: ...tings default password admin Network NAT STUN Server Parameter static sip nat_stun port y0000000000xx cfg Description It configures the port of the STUN server Note It works only if static sip nat_stun enable is set to 1 Enabled Permitted Values Integer from 1024 to 65535 Default 3478 Web UI Network NAT STUN STUN Port 1024 65535 Phone UI Settings Advanced Settings default password admin Network NA...

Page 51: ...ring Default Blank Web UI Network NAT TURN User Name Username Parameter static sip nat_turn password 2 y0000000000xx cfg Description It configures the password to authenticate to the TURN server Note It works only if static sip nat_turn enable is set to 1 Enabled Permitted Values String Default Blank Web UI Network NAT TURN Password 1 X is the account ID For VP59 T58A X 1 16 for CP960 X 1 2 If you...

Page 52: ...r in the Via header Permitted Values 0 Disabled 1 Enabled the INVITE Contact header uses the port in the rport parameter but does not use the source IP address in the received parameter in the Via header of server s response 2 Enable Direct Process the INVITE Contact header uses the port in the rport parameter and uses the source IP address in the received parameter in the Via header of server s r...

Page 53: ...bers Reserved Ports Configuration Guidelines for Determining the Range of Port Numbers To minimize the number of UDP and TCP ports that are available for communication you can restrict the ports range 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 Video 4 UDP por...

Page 54: ...fg Description It configures the minimum TCP port Permitted Values Integer from 1024 to 65535 Default 50000 Supported Devices All phones except CP960 Web UI Network Advanced Reserve Port TCP Port Scope 1024 65535 Parameter sip max_tcp_port 1 y0000000000xx cfg Description It configures the maximum TCP port Permitted Values Integer from 1024 to 65535 Default 50249 Supported Devices All phones except...

Page 55: ...t 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 transmit in 1000Mbps if the phone is connected to the switch supports Gigabit Ethernet We recom mend that you do not change this parameter Permitted Values 0 Auto Negotiation 1 Full Duplex 10Mbps 2 Full Duplex 100Mbps 3 Half Duplex 10Mbps 4 ...

Page 56: ...C not the wireless network 1 The phone can share both the wired network and wireless network with the connected PC Default 0 Supported Devices All phones except CP960 Case Scen ario When the phone is connected to the wireless network the office s PC can obtain the network through the phone s PC port 1 If you change this parameter the phone will reboot to make the change take effect VPN Yealink pho...

Page 57: ...OpenVPN Note It works only if static network vpn mode is set to 1 OpenVPN Permitted Values URL within 511 characters Default Blank Web UI Network Advanced VPN OpenVPN Upload VPN Config Parameter static network openvpn_file url 1 y0000000000xx cfg Description It configures the URL for uploading the OpenVPN configuration file vpn cnf Note It works only if static network vpn mode is set to 1 OpenVPN ...

Page 58: ... set to 0 L2TP Permitted Values String within 512 characters Default Blank Web UI Network Advanced VPN Layer 2 Tunneling Protocol L2TP Authentication Password 1 If you change this parameter the phone will reboot to make the change take effect Example Using VPN based on L2TP Prototol Before you begin You have set up the L2TP VPN server Procedure 1 Set the following parameters in the configuration f...

Page 59: ...gh quality voice transmission when the voice packets are configured to a higher DSCP value Video QoS To ensure acceptable visual quality for video video packets emanated from the phones should be configured with a high transmission priority It is not applicable to CP960 phones SIP QoS The SIP protocol is used for creating modifying and terminating two party or multi party sessions To ensure good v...

Page 60: ...d QoS SIP QoS 0 63 Parameter static wifi 802_11e enable 1 y0000000000xx cfg Description It enables or disables the WMM Wi Fi MultiMedia feature Note WMM is an 802 11 quality of service QoS implementation based on a subset of the draft 802 11e standard supplement Permitted Values 0 Disabled 1 Enabled Default 1 1 If you change this parameter the phone will reboot to make the change take effect 802 1...

Page 61: ...AST Permitted Values 0 Unauthenticated Provisioning EAP In Band provisioning is enabled by server unauthenticated PAC Protected Access Credential provisioning using the anonymous Diffie Hellman key exchange 1 Authenticated Provisioning EAP In Band provisioning is enabled by server authenticated PAC pro visioning using certificate based server authentication Default 0 Web UI Network Advanced 802 1x...

Page 62: ...4 5 6 or 7 If the authentication method is EAP FAST you also need to set static network 802_1x eap_fast_provision_mode to 1 Authenticated Provisioning Permitted Values URL within 511 characters Default Blank Web UI Network Advanced 802 1x CA Certificates Parameter static network 802_1x client_cert_url y0000000000xx cfg Description It configures the URL for uploading the 802 1x client certificate T...

Page 63: ...ccessible on a particular CPE GetParameterAttributes This method is used to read the attributes associated with one or more CPE parameters SetParameterAttributes This method is used to modify attributes associated with one or more CPE parameters Reboot This method causes the CPE to reboot Download This method is used to cause the CPE to download a specified file from the designated loc ation File ...

Page 64: ...tion is required Permitted Values String within 64 characters Default Blank Web UI Settings TR069 ACS Password Parameter static managementserver url y0000000000xx cfg Description It configures the access URL of the TR 069 ACS server Note The phones also support obtaining the URL of the ACS by detecting DHCP option 43 Permitted Values URL within 511 characters Default Blank Web UI Settings TR069 AC...

Page 65: ...Permitted Values 0 Disabled 1 Enabled Default 1 Web UI Settings TR069 Enable Periodic Inform Parameter static managementserver periodic_inform_interval y0000000000xx cfg Description It configures the interval in seconds at which the phone reports its configuration to the ACS server Note It works only if static managementserver periodic_inform_enable is set to 1 Enabled Permitted Values Integer fro...

Page 66: ...es Files Download Process Boot Files Yealink phones support boot files The boot files maximize the flexibility to allow you to customize features and set tings for multiple phones With the boot file you can specify which configuration files should be downloaded It is effective for you to provision the phones in different deployment scenarios l For all phones l For a group of phones l For specific ...

Page 67: ...ecific CFG file MODEL The MODEL can be added to specify settings for specific phone models MODEL represents the phone model name The valid phone model names are VP59 T58 and CP960 Multiple phone models are separated by commas For example T58 CP960 overwrite_mode Enable or disable the overwrite mode 1 Enabled If the value of a parameter in configuration files is left blank or if a non static parame...

Page 68: ... place it on the provisioning server Related Topic Boot File Attributes Configuration Files Yealink supports two configuration template files Common CFG file and MAC Oriented CFG file These configuration files contain two kinds of parameters l Static The parameters start with a prefix static for example static auto_provision custom protect l Non static The parameters do not start with a prefix sta...

Page 69: ...ttings by delet ing a parameter or leaving the value of a parameter blank in the MAC local CFG file on the server Note that if there is no MAC local CFG file found on the server the MAC local CFG file on the phone will not be cleared Note The non static changes that you made before enabling the provisioning priority mechanism are not saved in the gen erated MAC local file but the previous settings...

Page 70: ...rations and those model unspe cified configurations Tip The line beginning with is considered to be a comment You can use to make any comment on the boot file Resource Files Resource files are optional but if the particular feature is being employed these files are required You need to place resource files on the provisioning server The phones request the resource files in addition to the con figu...

Page 71: ...out for different call states Softkey Layout File Customization Directory Template favorite_setting xml Customize the directory list Directory List File Customization Super Search Template super_search xml Customize the search source list Search Source File Customization Local Contact File contact xml Add or modify multiple local contacts Local Contact File Customization Remote Phone Book Template...

Page 72: ...ontain all of the phone settings avail able with the centralized method You can use the web user interface method in conjunction with a central provisioning method and phone user interface method We recommend using centralized provisioning as your primary provisioning method when provisioning multiple phones Topics Provisioning Methods Priority Web User Interface Phone User Interface Central Provi...

Page 73: ... interface are limited Therefore you can use the web user interface in conjunction with a central provisioning method and phone user interface When configuring the phones via the web user interface you require a user name and password for access For a user the default user name and password are user case sensitive For an administrator the default user name and password are admin case sensitive Not...

Page 74: ...lt 0 Parameter wui secure_domain_list y0000000000xx cfg Description It configures the valid domain name to access the web user interface of the phone Multiple domain names are separated by semicolons Example wui secure_domain_list test abc com You are only allowed to use test abc com or IP address to access the web user interface of the phone Note To use a domain name to access the web user interf...

Page 75: ...les to access the web user interface of the phone over a secure tunnel HTTPS Permitted Values 0 Disabled 1 Enabled Default 1 Web UI Network Advanced Web Server HTTPS Phone UI Settings Advanced Settings default password admin Network Web Server HTTPS Status Parameter static network port https 1 y0000000000xx cfg Description It configures the port used to access the web user interface of the phone o...

Page 76: ...word default admin You can configure the phones via the phone user interface on a per phone basis Note When you manually configure a phone via the phone user interface the changes associated with non static parameters you make will be stored in the MAC local CFG file For more information on MAC local CFG file refer to MAC local CFG File Related Topic User and Administrator Identification Central P...

Page 77: ...a history of phone events call log files and con tact files to the provisioning server You can also configure a directory for each of these three files respectively Topics Auto Provisioning Settings Configuration User Triggered Provisioning Settings Configuration Auto Provisioning Settings Configuration The following table lists the parameters you can use to configure settings for auto provisionin...

Page 78: ...ble 1 y0000000000xx cfg Description It enables or disables the phone to reboot after auto provisioning even if there is no specific con figuration requiring a reboot Note It works only for the current auto provisioning process If you want the phone to reboot after every auto provisioning process the parameter must be always contained in the configuration file and set to 1 If the phone reboots repe...

Page 79: ...ovision weekly_upgrade_interval y0000000000xx cfg Description It configures the time interval in weeks for the phone to perform auto provisioning If it is set to 0 the phone performs auto provisioning at the specific day s configured by the parameter static auto_provision weekly dayofweek every week If it is set to other values for example 3 the phone performs auto provisioning at a random day bet...

Page 80: ...lue for example 3 it means the phone performs auto provisioning by randomly selecting a day from Sunday and Monday every three weeks Note It works only if static auto_provision weekly enable is set to 1 On Permitted Values 0 1 2 3 4 5 6 or a combination of these digits 0 Sunday 1 Monday 2 Tuesday 3 Wednesday 4 Thursday 5 Friday 6 Saturday Default 0123456 Web UI Settings Auto Provision Day of Week ...

Page 81: ...isioning at random Note It works only if static auto_provision flexible enable is set to 1 On Permitted Values Time from 00 00 to 23 59 Default 02 00 Web UI Settings Auto Provision Flexible Time Parameter static auto_provision flexible end_time y0000000000xx cfg Description It configures the ending time of the day for the phone to perform auto provisioning at random If it is left blank or set to a...

Page 82: ...s the timeout in seconds after which the authentication pop up box for auto provisioning disappears Permitted Values 0 The authentication pop up box does not disappear from the phone screen automatically Integer from 10 to 86400 The authentication pop up box automatically disappears from the phone screen after the designated time Default 7200 Parameter static auto_provision dns_resolv_nosys y00000...

Page 83: ...utoprovision X code 1 2 y0000000000xx cfg Description It configures the activation code to trigger auto provisioning Example static autoprovision 1 code 123 static autoprovision 2 code static autoprovision 3 code 123 Permitted Values Numbers or a combination of numbers and Default Blank Parameter static autoprovision X url 1 2 y0000000000xx cfg Description It configures the access URL of the provi...

Page 84: ...rom the detailed information you can do the following l Check whether settings you make using a higher priority provisioning method override settings made using a lower priority provisioning method l Reset a configuration to factory setting l See the default value of the desired configuration The table lists each parameter in the detailed information Parameter Description Description Description o...

Page 85: ... Protocol FTP l Hyper Text Transfer Protocol Secure HTTPS l File Transfer Protocol Secure FTPS Note There are two types of FTP methods active and passive The phones are not compatible with active FTP You can specify the transport protocol in the provisioning server address for example http xxxxxxx If not spe cified the TFTP protocol is used Topic Provisioning Protocols Configuration Provisioning P...

Page 86: ...sponse may contain option 66 for IPv4 or the custom option if configured that contains the provisioning server address l Static You can manually configure the server address via the phone user interface or web user interface Topics Zero Touch Provision Configuration PnP Provision Configuration DHCP Provision Configuration Static Provision Configuration Zero Touch Provision Configuration The follow...

Page 87: ...the phone broadcasts SIP SUBSCRIBE messages to obtain a provisioning server URL where the phone can request the configuration from during startup Default 1 Web UI Settings Auto Provision PNP Active Parameter static auto_provision pnp_check_url enable y0000000000xx cfg Description It enables or disables the phone to match the received provisioning URL with the last one from where the phone successf...

Page 88: ...ptions are separated by commas Note It works only if static auto_provision dhcp_option enable is set to 1 On Permitted Values Integer from 135 to 65535 except 143 Default Blank Web UI Settings Auto Provision IPv6 Custom Option Phone UI Settings Advanced Settings default password admin Auto Provision IPv6 Custom Option Parameter static auto_provision url_wildcard pn y0000000000xx cfg Description It...

Page 89: ...o_provision server password y0000000000xx cfg Description It configures the password for provisioning server access Permitted Values String within 32 characters Default Blank Web UI Settings Auto Provision Password Configuring a Provisioning Server The provisioning server can be set up on the local LAN or anywhere on the Internet Use the following procedure as a recommendation if this is your firs...

Page 90: ...led Permitted Values 0 Disabled 1 Enabled MAC local cfg file generates and personalized non static settings configured via the web or phone user interface will be kept after auto provisioning Default 0 Parameter static auto_provision custom sync y0000000000xx cfg Description It enables or disables the phone to upload the MAC local cfg file to the server each time the file updates and to download t...

Page 91: ...r 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 Parameters Settings ...

Page 92: ...provisioning server and then update settings in MAC local cfg file to the IP phone system As a result the personalized configuration settings of the phone are retrieved after the factory reset Clearing User s Personalized Configuration Settings When the IP phone is given to a new user but many personalized configurations settings of the last user are saved on the phone or when the end user encount...

Page 93: ...65b09d886 boot include config tftp 10 2 5 193 Linekey cfg include config tftp 10 2 5 193 001565b09d886 cfg 5 Place the boot files to the home directory of the provisioning server For example D TFTP Provision 6 Reboot the phones to trigger auto provisioning For the phone with MAC 001565b09d886 it will download the 001565b09d886 boot file and then download Linekey cfg and 001565b09d886 cfg files ref...

Page 94: ...er options The default username and password for the user is user For security reasons you should change the default user or administrator password as soon as possible Since advanced menu options are strictly used by the administrator users can configure them only if they have admin istrator privileges Topics User and Administrator Identification Configuration User Access Level Configuration User ...

Page 95: ...efault Blank Web UI Security Password Phone UI Settings Advanced Settings default password admin Set Password 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 Parame...

Page 96: ...se Once the IP phone is locked anyone must enter the password to unlock it You can lock the phone in two ways l Long press the pound key when the IP phone is idle not applicable to CP960 phones l Tap the phone lock key if configured when the IP phone is idle You can set a waiting time after which the phone is locked automatically If the waiting time is set to 0 the phone will not be automatically ...

Page 97: ...ked only by long pressing the pound key or pressing the phone lock DSS key Note It works only if phone_setting phone_lock enable is set to 1 Enabled Permitted Values Integer from 0 to 3600 Default 0 Web UI Features Phone Lock Auto Lock 0 3600s Phone UI Settings Advanced Settings default password admin Phone Lock Auto Lock Parameter phone_setting emergency number y0000000000xx cfg Description It co...

Page 98: ...ace using the lower version browser If you still cannot access the phone s web user interface when using Internet Explorer try to enable TLS 1 1 and disable TLS 1 2 or use other web browsers Refer to the web resources for more information Topics Supported Cipher Suites Supported Trusted and Server Certificates TLS Configuration Supported Cipher Suites A cipher suite is a named combination of authe...

Page 99: ... Certificate Authority CA Only if no unique certificate exists the phone may send a generic certificate for authentication The IP phone can authenticate the server certificate based on the trusted certificates list The trusted certificates list and the server certificates list contain the default and custom certificates You can specify the type of certificates the IP phone accepts default certific...

Page 100: ...RG Root X1 Let s Encrypt Authority X1 Let s Encrypt Authority X2 Let s Encrypt Authority X3 and Let s Encrypt Authority X4 certificates are signed by the root certificate ISRG Root X1 l Baltimore CyberTrust Root l DST Root CA X3 l Verizon Public SureServer CA G14 SHA2 l AddTrust External CA Root l Go Daddy Class 2 Certification Authority l Class 2 Primary CA l Cybertrust Public SureServer SV CA l ...

Page 101: ...rtificate Services l AC Raíz Certicámara S A l ACCVRAIZ1 l ACEDICOM Root l Actalis Authentication Root CA l AddTrust Class 1 CA Root l AddTrust Public CA Root l AddTrust Qualified CA Root l AffirmTrust Commercial l AffirmTrust Networking l AffirmTrust Premium l AffirmTrust Premium ECC l America Online Root Certification Authority 1 l America Online Root Certification Authority 2 l ApplicationCA l ...

Page 102: ...sign Root l Global Chambersign Root 2008 l GlobalSign Root CA R3 l Government Root Certification Authority l GTE CyberTrust Global Root l Hellenic Academic and Research Institutions RootCA 2011 l Hongkong Post Root CA 1 l IGC A l Izenpe com l Juur SK l KISA RootCA 1 l KISA RootCA 3 l Microsec e Szigno Root CA l Microsec e Szigno Root CA 2009 l NetLock Arany Class Gold Főtanúsítvány l NetLock Expre...

Page 103: ...l ValiCert Class 2 Policy Validation Authority l ValiCert Class 3 Policy Validation Authority l Visa eCommerce Root l Wells Fargo Root Certificate Authority l WellsSecure Public Root Certificate Authority l XRamp Global Certification Authority l USERTrust RSA Certification Authority l Starfield Secure Certificate Authority G2 l HydrantID SSL ICA G2 Note Yealink endeavors to maintain a built in lis...

Page 104: ...59 Parameter static security trust_certificates 3 y0000000000xx cfg Description It enables or disables the phone to only trust the server certificates in the Trusted Certificates list Permitted Values 0 Disabled 1 Enabled the phone will authenticate the server certificate based on the trusted certificates list Only when the authentication succeeds will the phone trust the server Default 1 Web UI S...

Page 105: ...lank Web UI Security Trusted Certificates Upload Trusted Certificate File Parameter static trusted_certificates delete y0000000000xx cfg Description It deletes all uploaded trusted certificates Permitted Values http localhost all Default Blank Parameter static server_certificates url y0000000000xx cfg Description It configures the access URL of the certificate the phone sends for authentication No...

Page 106: ...neously When this feature is enabled on both phones the type of encryption to use for the session is negotiated between the phones This negotiation process is compliant with RFC 4568 When you place a call on the enabled SRTP phone the phone sends an INVITE message with the RTP RTCP encryption algorithm to the destination phone As described in RFC 3711 RTP RTCP streams may be encrypted using an AES...

Page 107: ...gures whether to use audio video encryption service Permitted Values 0 Disabled 1 Optional the phone will negotiate with the other phone what type of encryption to use for the ses sion 2 Compulsory the phone must use SRTP during a call Default 0 Web UI Account Advanced RTP Encryption SRTP Parameter account X srtp unencrypted_rtp enable 1 MAC cfg Description It enables or disables the phone s capab...

Page 108: ...crypt for Linux platform The encryption tools support two encryption modes RSA Mode and Compatibility Mode For more information on the encryption tools refer to Yealink Configuration Encryption Tool User Guide Configuration Files Encryption and Decryption Encrypted configuration files can be downloaded from the provisioning server to protect against unauthorized access and tampering of sensitive i...

Page 109: ...example sip cfg account cfg MAC local cfg or MAC contact xml file from the server during auto provisioning and then resolve these files and update settings onto the phone system Default 0 Parameter static auto_provision aes_key_in_file y0000000000xx cfg Description It configures how the phone decrypts files Permitted Values 0 The phone will decrypt the encrypted configuration files using plaintext...

Page 110: ...cription It configures the plaintext AES key for decrypting the Common CFG file If it is configured it has a higher priority than the value configured by the parameter static auto_pro vision aes_key com Permitted Values 16 32 characters Default Blank Parameter static autoprovision X mac_aes 1 2 y0000000000xx cfg Description It configures the plaintext AES key for decrypting the MAC Oriented CFG fi...

Page 111: ...place the one encrypted or unencrypted stored on the server if you have configured to back up the MAC local CFG file to the server by the parameter static auto_provision custom sync 1 Enabled the MAC local CFG file will be uploaded encrypted and will replace the one encrypted or unencrypted stored on the server if you have configured to back up the MAC local CFG file to the server by the parameter...

Page 112: ...g table lists the parameters you can use to configure the incoming network signaling validation Parameter sip request_validation source list y0000000000xx cfg Description It configures the name of the request method for which source IP address validation will be applied Example sip request_validation source list INVITE NOTIFY Permitted Values INVITE ACK BYE REGISTER CANCEL OPTIONS INFO MESSAGE SUB...

Page 113: ... y0000000000xx cfg Description It enables or disables the USB port Note For T58A phones this parameter only applies to the rear USB port for VP59 phones this para 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 Permitted Values 0 Disabled the phone does n...

Page 114: ...ayPage 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 Firmware Upgrade Configuration Before upgrading firmware you need to know the following l Do not close and refresh the bro...

Page 115: ...ion Handset Backlight The handset supports different backlight status and you can configure it For W53H W56H the backlight in charger or out of charger can be configured independently You can enable the backlight to be on for about 30 minutes when the handset is charged and then you can check the charging state during this period You can also enable the backlight to be on for about 30 minutes when...

Page 116: ... is idle for about 10 seconds 1 Enabled the backlight will be turned off after the handset is idle for about 30 minutes Default 1 Supported Devices W53H W56H Handset UI OK Settings Display Display Backlight Out Of Charger Handset Keypad Light You can enable the handset keypad light to light up the keypad when any key is pressed This helps you dis tinguish keys from each other in a dark environment...

Page 117: ...3H W56H Handset UI OK Settings Display Wallpaper Handset Screen Saver The screen saver of the handset is designed to protect your LCD screen You can enable the screen saver to pro tect the LCD screen an analog clock will be activated and appear on the LCD screen after the handset is idle for approximately 10 seconds It is only applicable to W56H W53H handsets Topic Handset Screen Saver Configurati...

Page 118: ... 2 The handset name for handset 3 is Handset 3 The handset name for handset 4 is Handset 4 The handset name for handset 5 is Handset 5 Web UI Status Handset Handset Name Handset X 1 Phone UI DECT Settings Handsets Handset X 1 Handset UI W53H W56H OK Settings Handset Name DD Phone CP930W Menu Settings Basic Settings Phone Name 1 X is the handset ID X 2 5 Number Assignment After the handset is regis...

Page 119: ... incoming line for handset 2 is line 2 The incoming line for handset 3 is line 3 The incoming line for handset 4 is line 4 The incoming line for handset 5 is line 5 Web UI Account Number Assignment Incoming lines Handset UI W53H W56H OK Settings Telephony Incoming Lines Default PIN 0000 HandsetX 1 DD Phone Menu Settings Advanced Settings default password 0000 Incoming Lines Parameter handset X dia...

Page 120: ...enables or disables to end a call when placing the handset into the charger cradle Permitted Values 0 Never 1 Always Default 1 Supported Devices W53H W56H Web UI Features General Information End Call On Hook Advisory Tones Advisory tones are the acoustic signals of your handset which inform you of different actions and states It is not applicable to DD phones You can configure the following adviso...

Page 121: ...nes Keypad Tone CP930W Menu Settings Basic Settings Sound Advisory Tones Parameter custom handset confirmation_tone enable y0000000000xx cfg Description It enables or disables the handset to play a tone when a user saves settings or places the handset in the charger cradle Note It will take effect on all handsets that are registered on the same phone It works only if stat ic auto_provision handset...

Page 122: ...efault 0000 Web UI Security Base PIN Base Unit PIN Handset UI W53H W56H OK Settings System Settings Change Base PIN DD Phone Menu Settings Advanced Settings default password 0000 Change Password CP930W Menu Settings Advanced Settings default PIN 0000 Change PIN Phone UI Dect Settings Change Base PIN Parameter base double_pin_code enable y0000000000xx cfg Description It enables or disables double P...

Page 123: ...to intercom feature is disabled Users need to answer incoming internal intercom calls manu ally 1 On Beep Off the phone handset answers an incoming internal intercom call automatically without a warning tone 2 On Beep On the phone handset answers an incoming internal intercom call automatically and plays a warning tone It works when the silence mode is off Default 1 Handset UI OK Settings Telephon...

Page 124: ...directory_setting shared_contact enable is set to 1 Enabled Permitted Values URL within 511 characters Default Blank Supported Devices All handsets except DD phones Web UI 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...

Page 125: ...number other_number line 1 ring Auto default_photo Default default_contact_image png selected_photo 0 group_id_name All Contacts to the file Each starts on a new line 3 Specify the values within double quotes For example contact display_name Lily office_number 1020 mobile_number 1021 other_number 1112 contact display_name Tom office_number 2020 mobile_number 2021 other_number 2112 4 Save the chang...

Page 126: ... configure a mode for whether to continue the conversation on the handset when the phone goes off hook or to send a busy signal to one of the paired phones while the device is not in a call but tries to initiate a call prohibited on that device Topics Satellite Mode Configuration Example Configuring the Satellite Mode Feature Satellite Mode Configuration The following table lists the parameters yo...

Page 127: ...sers not in a call try to ini tiate a call on the phone handset the phone handset will prompt Path Busy 1 Take over call when the handset is during the call users can retrieve the call after off hook on the phone When the phone is during the call users can push the call to the handset Default 1 Web UI Status Handset Satellite Mode Mode Phone UI DECT Settings Satellite Mode Select mode 1 X is the h...

Page 128: ...mitted Values 0 Off 1 RT10 RT20 2 RT30 Default 0 Phone UI DECT Settings Repeater Mode Repeater Mode 1 If you change this parameter the phone will reboot to make the change take effect Handset Settings Parameters Parameter custom handset eco_mode enable y0000000000xx cfg Description It enables or disables the eco mode to greatly reduce the transmission power and signal output when the phone is in t...

Page 129: ...rmitted Values 1 Do not modify the configuration 0 Disabled 1 Enabled Default 1 Supported Devices W52H Handset UI OK Settings Display Notification Light Voice Mail Parameter custom handset language y0000000000xx cfg Description It configures the language used on the DECT handset user interface Note It will take effect on all handsets that are registered on the same phone It works only if stat ic a...

Page 130: ... to 1 Enabled Permitted Values 1 Do not modify the configuration 0 Disabled 1 Enabled Default 1 Supported Devices W53H W56H Handset UI OK Settings Telephony Auto Answer Parameter custom handset time_format y0000000000xx cfg Description It configures the time format for all registered handsets Note It works only if static auto_provision handset_configured enable is set to 1 Enabled Permitted Values...

Page 131: ...les the HAC Hearing Aid Compatibility handset settings Permitted Values 0 Disabled 1 Enabled Default 0 Supported Devices All handsets except DD phones Parameter static auto_provision handset_configured enable y0000000000xx cfg Description It enables or disables the handsets to keep user personalized settings after auto provisioning Note It is only applicable to the custom handset related configura...

Page 132: ...nes Parameter handset X contact_list url 2 y0000000000xx cfg Description It configures the access URL of the contact file xml for a specific handset Example handset 2 contact_list url http 192 168 10 25 contact xml Permitted Values URL within 511 characters Default Blank Web UI Directory Dect Directory Import Contacts Import to Handset X Select xml file form 1 X is the handset ID X 1 to 5 2 X is t...

Page 133: ... parameter over_the_air url is lower than over_the_air url w56h over_the_air url w53h over_the_air url w52h Permitted Values URL within 511 characters Default Blank Web UI Settings Upgrade Select and update handset firmware Parameter over_the_air url w56h y0000000000xx cfg Description It configures the access URL of the W56H handset firmware file Note The priority of parameter over_the_air url w56...

Page 134: ...cept DD phones Parameter over_the_air base_trigger y0000000000xx cfg Description It enables or disables to upgrade the handset firmware compulsively when the phone detects a new handset firmware from the provisioning server Permitted Values 0 Disabled if over_the_air handset_tip is set to 1 Enabled it will pop up a tip on the handset to notify the user to confirm upgrading the firmware or not If o...

Page 135: ...r Connection Feature CP960 Star Connection Feature Configuration Example Configuring CP960 Star Connection Feature Guidelines for Configuring Star Connection Feature The following instructions you need to know when configuring star connection feature for CP960 l Ensure all the phones are deployed in the same subnet l Ensure all the phones are running the same firmware versions l You can only deplo...

Page 136: ... the MAC address of a slave phone on the master phone After configured the phone with this MAC address is authorized to connect with the master phone Example features cp_star_connection slave 1 mac 805EC0092F4B Note that the MAC address is case insensitive and the following format of the MAC address is invalid 80 5E C0 09 2F 4B Note It works only if features cp_star_connection master enable is set...

Page 137: ... phones are in the same subnet and are running the same firmware versions You want phone A to act as a master phone and phone B phone C and phone D act as the slave phones The following example shows configuration for the phones Example For Phone A master phone features cp_star_connection master enable 1 features cp_star_connection slave 1 mac 805EC0092F4B features cp_star_connection slave 2 mac 8...

Page 138: ...warning tone or select specialized tone sets vary from country to country for your IP phone l Send tone allow the IP phone to play a key tone when you tap the send key It works only if the key tone is enabled l Dial tone allow the IP phone to play a specific dial tone for a specified time l Key tone allow the IP phone to play a key tone when you press or tap any key Topic Alert Tone Configuration ...

Page 139: ...Description It enables or disables the phone to play a warning tone when it receives a new voice mail Note It works only if account X display_mwi enable is set to 1 Enabled Permitted Values 0 Disabled 1 Enabled Default 1 Web UI Features General Information Voice Mail Tone Parameter features send_key_tone y0000000000xx cfg Description It enables or disables the phone to play a key tone when a user ...

Page 140: ...ingtone Parameter phone_setting ring_type y0000000000xx cfg Description It configures a ring tone for the phone Permitted Values Ring1 wav Ring2 wav Ring3 wav Ring4 wav Ring5 wav Ring6 wav Ring7 wav Ring8 wav Silent wav Splash wav or custom ring tone name for example Customring wav Default Ring1 wav Web UI Settings Preference Upload Ringtone System Ring Phone UI Settings Basic Settings Sound Ring ...

Page 141: ... configures the ring tone when the phone fails to transfer a call and display Transfer failed on the screen Permitted Values Ring1 wav Ring2 wav Ring3 wav Ring4 wav Ring5 wav Ring6 wav Ring7 wav Ring8 wav Silent wav or Splash wav Default Ring1 wav 1 X is the account ID For VP59 T58A X 1 16 for CP960 X 1 Distinctive Ring Tones The feature of distinctive ring tones allows certain incoming calls to t...

Page 142: ...e Value of N Ring Tone features alert_info_tone 1 Ring Tone features alert_info_tone 0 1 Bellcore dr1 Ring1 wav 2 Bellcore dr2 Ring2 wav 3 Bellcore dr3 Ring3 wav 4 Bellcore dr4 Ring4 wav 5 Bellcore dr5 Ring5 wav 6 Ring6 wav 7 Ring7 wav 8 Ring8 wav 9 Silent wav 10 Splash wav N 1 or N 10 Ring1 wav Examples Alert Info http 127 0 0 1 Bellcore dr1 Alert Info test Bellcore dr1 Alert Info Bellcore dr1 Al...

Page 143: ...00 550 Note If the user is waiting for a call Bellcore dr5 is a ring splash tone that reminds the user that the DND or Always Call Forward feature is enabled on the server side Alert Info ringtone N Alert Info ringtone RingN wav or Alert Info MyMelodyN Alert Info MyMelodyRingN wav When the Alter Info header contains the keyword ringtone N ringtone RingN or MyMolodyN MyMelodyRingN the phone will pl...

Page 144: ...er interface is Enabled or play the preconfigured local ring tone in about 10 seconds if account X alert_info_url_enable is set to 0 or if the IP phone fails to download the remote ring tone Example Alert Info http 192 168 0 12 8080 Custom wav Alert Info info info text x line id 0 When the Alert Info header contains an info text the phone will map the text with the Internal Ringer Text pre configu...

Page 145: ...tained in the Alert Info header Permitted Values 0 Disabled 1 Enabled Default 1 Web UI Account Advanced Distinctive Ring Tones Parameter features alert_info_tone y0000000000xx cfg Description It enables and disables the phone to map the keywords in the Alert Info header to the specified Bellcore ring tones Permitted Values 0 Disabled 1 Enabled Default 0 Parameter distinctive_ring_tones alert_info ...

Page 146: ...d be connected to the IP phone and the headset mode also should be activated in advance You can press the HEADSET key to activate the headset mode You can press the HEADSET key to activate the headset mode For more information refer to the Yealink phone specific user guide It is not applicable to CP960 phones Topic Ringer Device Configuration Ringer Device Configuration The following table lists t...

Page 147: ...es Integer from 0 to 15 Default 0 Sending Volume Configuration You can configure the sending volume of currently engaged audio devices handset speakerphone or headset when the phone is in use The following table lists the parameters you can use to configure the sending volume Parameter voice handfree_send 1 y0000000000xx cfg Description It configures the sending volume of the speaker Note We recom...

Page 148: ...ality bad Permitted Values Integer from 50 to 50 Default 0 Supported Devices All phones except CP960 Web UI Features Audio Headset Send Volume 50 50 Parameter voice headset autoreset_spk_vol y0000000000xx cfg Description It configures the headset s volume level during a call Permitted Values 0 The headset volume at the end of a call persists between calls 1 to 15 The headset volume does not persis...

Page 149: ...cription It enables or disables the headset s volume level to be reset to level 11 after the call if the volume level for the current call exceeds the standards Note The value configured by the parameter voice headset autoreset_spk_vol takes precedence over that configured by this parameter Permitted Values 0 Disabled 1 Enabled if the headset s volume level for the current call is adjusted to leve...

Page 150: ... to the digit map For more information on digit map refer to Dial Plan Defined by Digit Map New Dial Plan Mechanism Ring Back Ring back tone Busy When the callee is busy Congestion When the network is congested Call Wait ing Call waiting tone For more information on call waiting refer to Call Waiting Dial Recall When receiving a callback Info When receiving a special message Stutter When receiving...

Page 151: ...200 0 1000 200 300 500 200 500 800 1500 1000 If you want the IP phone to play tones once add an exclamation mark before tones for example 250 200 0 1000 200 300 500 200 500 800 1500 1000 Note It works only if voice tone country is set to Custom Permitted Values String Default Blank Supported Devices All phones except CP960 Web UI Settings Tones Dial Parameter features partition_tone 1 y0000000000x...

Page 152: ...e tone dial Note It works only if voice tone country is set to Custom If you want to disable this warning tone set it to 0 Permitted Values String Default Blank Web UI Settings Tones Busy Parameter voice tone congestion y0000000000xx cfg Description It customizes the tone when the network is congested The value format is Freq Duration For more information on the value format refer to the parameter...

Page 153: ... If you want to disable this warning tone set it to 0 Permitted Values String Default Blank Web UI Settings Tones Dial Recall Parameter voice tone info y0000000000xx cfg Description It customizes the info tone The phone will play the info tone with the special information for example the number you are calling is not in service The value format is Freq Duration For more information on the value fo...

Page 154: ...ber of bits while retaining the quality This can effectively reduce the frame size and the bandwidth required for audio transmission The audio codec that the phone uses to establish a call should be supported by the SIP server When placing a call the phone will offer the enabled audio codec list to the server and then use the audio codec negotiated with the called party according to the priority T...

Page 155: ...er than the bit rate due to pack etization overhead For example a two way G 722 audio call at 64 Kbps consumes about 135 Kbps of network bandwidth The Opus codec supports various audio bandwidths defined as follows Abbreviation Audio Bandwidth Sample Rate Effective NB narrowband 4 kHz 8 kHz MB medium band 6 kHz 12 kHz WB wideband 8 kHz 16 kHz SWB super wideband 12 kHz 24 kHz FB fullband 20 kHz 48 ...

Page 156: ...o codec in this parameter should be the correct one as listed in the above example otherwise the corresponding configuration will not take effect Permitted Values 0 Disabled 1 Enabled Default Default When the audio codec is G 722 1c 48kb s the default value is 1 When the audio codec is G 722 1c 32kb s the default value is 1 When the audio codec is G 722 1c 24kb s the default value is 1 When the au...

Page 157: ...ty of the enabled audio codec The name 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 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 account ...

Page 158: ...he 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 When the audio codec is Opus the default value is 0 When the audio codec is iLBC_15_2kbps the default value is 0 When the audio codec is iLBC_13_33kpbs the default value is 0 Web UI Account Codec Audio Codec Parameter account X codec opus para 1 MAC cfg Description It...

Page 159: ...lt ptime is 20ms You can also disable the ptime negotiation Topics Supported PTime of Audio Codec PTime Configuration Supported PTime of Audio Codec The following table summarizes the valid values of ptime for each audio codec Codec Packetization Time Minimum Packetization Time Maximum G 722 1c 48kb s 20ms 60ms G 722 1c 32kb s 20ms 60ms G 722 1c 24kb s 20ms 60ms G 722 1 24kb s 20ms 60ms G722 10ms ...

Page 160: ...setting early_media rtp_sniffer timeout 1 y0000000000xx cfg Description It configures the time to wait for the phone to play the local ringback tone when the early media cannot be played Permitted Values 1 Do not play the local ringback tone 0 Play the local ringback tone immediately 1 100 Wait for a specified time to play the local ringback tone Default 1 Parameter phone_setting is_deal180 y00000...

Page 161: ...oming and outgoing calls Note It works only if features headset_mode enable is set to 1 Enabled Permitted Values 0 Disabled the headset mode will be deactivated after the call if you switch the headset mode to speakerphone handset mode 1 Enabled the headset mode will not be deactivated after the call even if you switch the headset mode to speakerphone handset mode Default 0 Supported Devices All p...

Page 162: ...io quality in your network Yealink phones support the acoustic clarity technology Acoustic Echo Cancellation AEC Background Noise Suppression BNS Automatic Gain Control AGC Voice Activity Detection VAD Comfort Noise Generation CNG and jitter buffer Topics Acoustic Echo Cancellation AEC Noise Suppression Background Noise Suppression BNS Automatic Gain Control AGC Voice Activity Detection VAD Comfor...

Page 163: ...you can use to configure noise suppression Parameter voice tns enable y0000000000xx cfg Description It enables or disables the Noise Suppression feature Permitted Values 0 Disabled 1 Enabled Default 1 Web UI Settings Voice Noise Proof Noise Suppression Automatic Gain Control AGC Automatic Gain Control AGC is applicable to the hands free operation and is used to keep audio output at nearly a consta...

Page 164: ...ion 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 The range of the delay time for the dynamic jitter buffer added to packets can be also c...

Page 165: ...rks only if voice jib adaptive is set to 0 Fixed The value of this parameter should be greater than or equal to that of voice jib min and less than or equal to that of voice jib max Permitted Values Integer from 0 to 400 Default 120 Web UI Settings Voice Jitter Buffer Normal Parameter voice jib wifi adaptive y0000000000xx cfg Description It configures the type of jitter buffer in the wireless netw...

Page 166: ...Noise Block feature Note It works only if voice tns enable is set to 1 Enabled Permitted Values 0 Disabled 1 Enabled Default 0 Web UI Settings Voice Noise Proof Smart Noise Block Acoustic Shield The acoustic shield feature is designed for background noise suppression when you are using the phone handset or a connected headset It is particularly used in the open office environment such as the call ...

Page 167: ...o on Topic Smart Noise Filtering Configuration Smart Noise Filtering Configuration The following table lists the parameter you can use to configure smart noise filtering Parameter features noise_filtering_rev enable y0000000000xx cfg Description It enables or disables the phone to block out the slight noise from the far end when there is no speech in a call Note After smart noise filtering is enab...

Page 168: ...t is set to 1 the packet contains the end of the DTMF event You can configure the sending times of the end RTP Event packet l INBAND DTMF digits are transmitted in the voice band It uses the same codec as your voice and is audible to conversation partners l SIP INFO DTMF digits are transmitted by SIP INFO messages DTMF digits are transmitted by the SIP INFO messages when the voice stream is establ...

Page 169: ...00xx cfg Description It configures the repetition times for the phone to send the end RTP Event packet during an active call Permitted Values 1 2 or 3 Default 3 Web UI Features General Information DTMF Repetition Parameter features dtmf duration 2 y0000000000xx cfg Description It configures the duration time in milliseconds for each digit when a sequence of DTMF tones is played out automatically N...

Page 170: ...y Configuration The following table lists the parameters you can use to configure the suppress DTMF display Parameter features dtmf hide y0000000000xx cfg Description It enables or disables the phone to suppress the display of DTMF digits during an active call Permitted Values 0 Disabled 1 Enabled the DTMF digits are displayed as asterisks Default 0 Web UI Features General Information Suppress DTM...

Page 171: ...ne allows the phones to play a local DTMF tone during an active call If this feature is enabled you can hear the DTMF tone when pressing the IP phone s keypad during a call Topic Local DTMF Tone Configuration Local DTMF Tone Configuration The following table lists the parameter you can use to configure the local DTMF tone Parameter features play_local_dtmf_tone_enable y0000000000xx cfg Description...

Page 172: ... the phone to send RTCP packets Permitted Values 0 Disabled 1 Enabled Default 1 Parameter voice rtcp_cname 1 y0000000000xx cfg Description It configures the cname of the RTCP packets Permitted Values String Default Blank 1 If you change this parameter the phone will reboot to make the change take effect VQ RTCPXR The VQ RTCPXR mechanism compliant with RFC 6035 sends the service quality metric repo...

Page 173: ...lt 0 Web UI Settings Voice Monitoring VQ RTCP XR Interval Report Parameter phone_setting vq_rtcpxr_interval_period y0000000000xx cfg Description It configures the interval in seconds for the phone to send an interval quality report to the central report collector periodically throughout a call Note It works only if phone_setting vq_rtcpxr interval_report enable is set to 1 Enabled Permitted Values...

Page 174: ...00 when the value of one way delay computed by the phone is greater than or equal to 500 the phone will send a warning alert quality report to the central report collector when the value of one way delay computed by the phone is less than 500 the phone will not send a warning alert quality report to the central report collector If it is set to blank warning alerts are not generated due to one way ...

Page 175: ...nitoring Display Report Options on Web Parameter phone_setting vq_rtcpxr states_show_on_gui enable y0000000000xx cfg Description It enables or disables the voice quality data of the last call or current call to be displayed on the phone screen You can view the voice quality data of the last call on the phone at the path Settings Status RTP Status You can view the voice quality data of the current ...

Page 176: ...to display Local Codec on the phone screen Note It works only if phone_setting vq_rtcpxr states_show_on_gui enable is set to 1 Enabled Permitted Values 0 Disabled 1 Enabled Default 1 Web UI Settings Voice Monitoring Report Options on Phone Local Codec Parameter phone_setting vq_rtcpxr_display_remote_codec enable y0000000000xx cfg Description It enables or disables the phone to display Remote Codec...

Page 177: ...es 0 Disabled 1 Enabled Default 0 Web UI Settings Voice Monitoring Report Options on Phone SymmOneWayDelay Parameter phone_setting vq_rtcpxr_display_round_trip_delay enable y0000000000xx cfg Description It enables or disables the phone to display RoundTripDelay on the phone screen Note It works only if phone_setting vq_rtcpxr states_show_on_gui enable is set to 1 Enabled Permitted Values 0 Disable...

Page 178: ... accepts voice quality reports contained in SIP PUBLISH messages Permitted Values IPv4 Address Default Blank Web UI Account Advanced VQ RTCP XR Collector Address Parameter account X vq_rtcpxr collector_server_port 1 MAC cfg Description It configures the port of the central report collector that accepts voice quality reports contained in SIP PUBLISH messages Permitted Values Integer from 0 to 65535...

Page 179: ...nt_mode enable y0000000000xx cfg Description It enables or disables the user to have the permission to use the silent mode feature Permitted Values 0 Disabled the Silent Mode item will disappear from the phone user interface at the path Settings Basic Settings Sound Users can neither enable the silent mode feature from the control center or via the phone user interface nor adjust the ringer volume...

Page 180: ...one Android Keys Display Status Bar and Control Notification Center Display Warnings Display Browser Home Page Out of Service PC Mode Language Yealink phones support multiple languages Languages used on the phone user interface and web user interface can be specified respectively as required Topics Supported Languages Language Display Configuration Language for Phone Display Customization Language...

Page 181: ... Czech 12 Czechlang js 12 Czechlang_ note xml Hebrew 015 GUI Hebrew lang Arabic 13 Arabic js 13 Arabic_note xml Arabic 016 GUI Arabic lang Language Display Configuration The default language displayed on the phone user interface is English If your web browser displays a language not supported by the IP phone the web user interface will display English by default You can specify the lan guages for ...

Page 182: ...guage pack for the phone user interface the language pack must be formatted as X GUI name lang X starts from 017 name is replaced with the language name If the language name is the same as the existing one the existing language pack will be overridden by the newly uploaded one We recommend that the filename of the new language pack should not be the same as the existing one Note To modify the tran...

Page 183: ...English_17 lang You can also find a new language selection English_17 and English_18 on the IP phone user interface Settings Basic Settings Language Language for Web Display Customization You can customize the translation of the existing language on the web user interface You can modify translation of an existing language or add a new language for web display You can also customize the translation...

Page 184: ...e note language pack must be formatted as X name_note xml X starts from 14 name is replaced with the language name If the note language name is the same as the exist ing one the new uploaded note language pack will override the existing one We recommend that the filename of the new note language pack should not be the same as the existing one Procedure Open the desired note language template pack ...

Page 185: ...he web user interface Permitted Values URL within 511 characters For example http localhost X name_note xml X starts from 14 name is replaced with the language name Default Blank Parameter wui_lang delete y0000000000xx cfg Description It deletes the specified or all custom web language packs and note language packs of the web user interface Permitted Values http localhost all or http localhost Y n...

Page 186: ...dule of the phone Permitted Values Default exp50 jpg 01 exp50 jpg 02 exp50 jpg 03 exp50 jpg 04 exp50 jpg 05 exp50 jpg 06 exp50 jpg 07 exp50 jpg 08 exp50 jpg 09 exp50 jpg or 10 exp50 jpg or custom wallpaper name for example wallpaper jpg Default Default exp50 jpg Supported Devices T58A Web UI Settings Preference Upload Wallpaper System Expansion Wallpaper Phone UI Settings Basic Settings Display EX...

Page 187: ...d url http 192 168 10 25 wallpaper jpg phone_setting backgrounds wallpaper jpg After provisioning the phone idle screen wallpaper changes to custom picture wallpaper jpg Screen Saver The screen saver will automatically start when the IP phone is idle for the preset waiting time You can stop the screen saver at any time by pressing any key or touching the screen When your phone is idle again for a ...

Page 188: ...tness automatically changes when the phone is idle for a specified time You can change the screen backlight brightness and time in the following settings Active Level The brightness level of the LCD screen when the phone is active Digits 1 10 represent different brightness levels 10 is the brightest level Backlight Time The delay time to change the brightness of the LCD screen when the phone is in...

Page 189: ...one UI Settings Basic Settings Display Backlight Backlight Active Level Parameter phone_setting backlight_time y0000000000xx cfg Description It configures the delay time in seconds to change the intensity of the LCD screen when the phone is inactive Permitted Values 0 Always On 15 15s 30 30s 60 1min 120 2min 300 5min 600 10min 1800 30min Default 0 Web UI Settings Preference Backlight Time seconds ...

Page 190: ...on Module Page Tips Phone Page Tips Page tips feature allows users to enable the breathing light or page icon to indicate statuses It is mainly used in the scenario of configuring multiple line keys 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 assigne...

Page 191: ...t page The call of the line is placed on hold on the non current page The BLF monitored user receives an incoming call on the non current page Drag down to view the desired feature key CP960 Tap corresponding page icon to view the desired feature key Phone Page Tips Configuration The following table lists the parameter you can use to configure phone page tips Parameter phone_setting page_tip y0000...

Page 192: ...ip blf_call_in enable y0000000000xx cfg Description It enables or disables the page switch key LED on the EXP50 expansion module to indicate when BLF monitored user receives an incoming call on the non current pages Permitted Values 0 Disabled 1 Enabled Default 1 Supported Devices T58A Parameter expansion_module page_tip blf_call_in led y0000000000xx cfg Description It configures the page switch k...

Page 193: ...time zone location Time Zone Time Zone Name Time Zone Time Zone Name 12 Eniwetok Kwajalein 2 Estonia Tallinn 11 Midway Island 2 Finland Helsinki 10 United States Hawaii Aleutian 2 Gaza Strip Gaza 10 United States Alaska Aleutian 2 Greece Athens 9 30 French Polynesia 2 Harare 9 United States Alaska Time 2 Israel Tel Aviv 8 Canada Vancouver Whitehorse 2 Jordan Amman 8 Mexico Tijuana Mexicali 2 Latvi...

Page 194: ...aijan Baku 5 Peru 4 Georgia Tbilisi 5 Quito 4 Russia Samara 5 United States Eastern Time 4 Abu Dhabi Muscat 4 30 Venezuela Caracas 4 Izhevsk Samara RTZ 3 4 Canada Halifax Saint John 4 Port Louis 4 Atlantic Time Canada 4 30 Afghanistan Kabul 4 San Juan 5 Kazakhstan Aktau 4 Manaus Cuiaba 5 Kazakhstan Aqtobe 4 Georgetown 5 Ekaterinburg RTZ 4 4 Chile Santiago 5 Karachi 4 Paraguay Asuncion 5 Tashkent 4...

Page 195: ...8 Singapore Singapore 0 Western Europe Time 8 Hong Kong Urumqi 0 Monrovia 8 Taipei 0 Reykjavik 8 Kuala Lumpur 0 Casablanca 8 Australia Perth 0 Denmark Faroe Islands Torshavn 8 Russia Irkutsk Ulan Ude 0 Ireland Dublin 8 Ulaanbaatar 0 Edinburgh 8 45 Eucla 0 Portugal Lisboa Porto Funchal 9 Korea Seoul 0 Spain Canary Islands Las Palmas 9 Japan Tokyo 0 United Kingdom London 9 Russia Yakutsk Chita 0 Lis...

Page 196: ...1 Luxembourg Luxembourg 13 Samoa 1 Macedonia Skopje 13 30 Chatham Islands 1 Netherlands Amsterdam 14 Kiribati 1 Namibia Windhoek NTP Settings You can set an NTP time server for the desired area as required The NTP time server address can be offered by the DHCP server or configured manually Topic NTP Configuration NTP Configuration The following table lists the parameters you can use to configure t...

Page 197: ...domain name of the secondary NTP server If the primary NTP server is not configured by the parameter local_time ntp_server1 or cannot be accessed the phone will request the time and date from the secondary NTP server Permitted Values String within 99 characters Default pool ntp org Web UI Settings Time Date Secondary Server Phone UI Settings Basic Settings Time Date General Type SNTP Settings NTP ...

Page 198: ...If the DST is set to Automatic the phone obtains the DST configuration from the AutoDST file You can customize the AutoDST file if required The AutoDST file allows you to add or modify time zone and DST settings for your area each year Topics Auto DST File Attributes Customizing Auto DST File DST Configuration Auto DST File Attributes The following table lists the description of each attribute in ...

Page 199: ... a new time zone add DST szTime szZone iType szStart szEnd szOffset between DSTData and DSTData 3 Specify the DST attribute values within double quotes For example Add a new time zone 6 Paradise with daylight saving time 30 minutes DST szTime 6 szZone Paradise iType 1 szStart 3 5 7 2 szEnd 10 5 7 3 szOffset 30 Modify the DST settings for the existing time zone 5 Pakistan Islamabad and add DST sett...

Page 200: ... mapping Month 1 January 2 February 12 December Day 1 the first day in a month 31 the last day in a month Hour 0 0am 1 1am 23 11pm 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 Hour of Day 0 0am 1...

Page 201: ...ttings Time Date Offset minutes Parameter auto_dst url y0000000000xx cfg Description It configures the access URL of the DST file AutoDST xml Note It works only if local_time summer_time is set to 2 Automatic Permitted Values URL within 511 characters Default Blank Time and Date Manually Configuration You can set the time and date manually when the phones cannot obtain the time and date from the N...

Page 202: ...ime Format Parameter local_time date_format y0000000000xx cfg Description It configures the date format Note The value configured by the parameter lcl datetime date format takes precedence over that configured by this parameter Permitted Values 0 WWW MMM DD 1 DD MMM YY 2 YYYY MM DD 3 DD MM YYYY 4 MM DD YY 5 DD MMM YYYY 6 WWW DD MMM 20 Custom format configured by lcl datetime date format for exampl...

Page 203: ... date format via the web phone user interface Date Customization Rule You need to know the following rules when customizing date formats Format Description Y YY It represents a two digit year For example 16 17 18 Y is used more than twice for example YYY YYYY It represents a four digit year For example 2016 2017 2018 M MM It represents a two digit month For example 01 02 12 MMM It represents the a...

Page 204: ...nformation If the contact exists in the phone directory the phone displays the saved contact name and number If not it will use the Calling Line Identification Presentation CLIP or Connected Line Identification Presentation COLP to display the contact s iden tity Topic Call Display Configuration Call Display Configuration The following table lists the parameters you can use to configure the call d...

Page 205: ...io Get the picture from call info and display it on the phone as the wallpaper while receiving dialing a call or during a call Configure the call info Call Info http 192 168 0 1 wallpaper jpg purpose wallpaper Set the following account 1 picture_info_enable 1 Parameter phone_setting called_party_info_display enable y0000000000xx cfg Description It enables or disables the phone to display the local...

Page 206: ... 1 MAC cfg Description It enables or disables the phone to update the display of call ID according to the ACK message Permitted Values 0 Disabled 1 Enabled Default 0 Parameter account X refresh_remote_id enable 1 MAC cfg Description It enables or disables the phone to update the identity of the caller according to the request message from the remote party Permitted Values 0 Disabled 1 Enabled Defa...

Page 207: ...n the pre dialing or dialing screen Permitted Values 1 Label configured by the parameter account X label 2 Display Name configured by the parameter account X display_name 3 User Name configured by the parameter account X user_name Default 3 Supported Devices T58A VP59 Web UI Features General Information Display Method on Dialing Key As Send Key as send allows you to assign the pound key or asteris...

Page 208: ...ze the soft keys at the bottom of the phone screen for best meet users require ments In addition to specifying which soft keys to display you can determine their display order The configurations for softkey layout are based on call states It is not applicable to CP960 phones The following shows the soft keys displaying on the phone in the CallIn state Note You can configure the EDK soft keys in di...

Page 209: ...isabled soft key list The phone screen will not display the disabled soft keys Enable Enable Specify the enabled soft key list The phone screen will display the enabled soft keys Default Default Specify the default soft key list The phone screen displays these soft keys by default Key Type Specify the soft key type Customizing Softkey Layout File 1 Open the template file 2 For each soft key that y...

Page 210: ...xample phone_setting custom_softkey apply_to_states DialingEmpty DialTransEmpty It means that DialingEmpty and DialTransEmpty call states will use the custom softkey layout To configure the call states not to apply the custom softkey layout Example phone_setting custom_softkey apply_to_states DialingEmpty DialTransEmpty It means that DialingEmpty and DialTransEmpty call states will not use the cus...

Page 211: ...et to 1 Enabled Permitted Values URL within 511 characters Default Blank Supported Devices T58A VP59 Parameter custom_softkey_call_in url y0000000000xx cfg Description It configures the access URL of the custom softkey layout file in the CallIn state Note It works only if phone_setting custom_softkey_enable is set to 1 Enabled Permitted Values URL within 511 characters Default Blank Supported Devi...

Page 212: ... in the dialing screen Topic Input Method Configuration Input Method Configuration The following table lists the parameters you can use to configure the input method Parameter gui_input_method url y0000000000xx cfg Description It configures the access URL of the custom keypad input method file for the phone user interface Example gui_input_method url http 192 168 10 25 custom_ime txt During the au...

Page 213: ...ethod in the dialing screen Permitted Values 0 2aB 1 123 2 abc 3 ABC Default 1 Parameter directory search_default_input_method y0000000000xx cfg Description It configures the default input method when the user searches for contacts in the Local Directory LDAP Remote Phone Book Blacklist or Network Directory Permitted Values Abc 2aB 123 abc or ABC Default Abc Parameter default_input_method xml_brow...

Page 214: ...UI Features Notification Popups Display Voice Mail Popup Parameter features missed_call_popup enable y0000000000xx cfg Description It enables or disables the phone to pop up the message when it misses a call Note It works only if account X missed_calllog is set to 1 Enabled Permitted Values 0 Disabled 1 Enabled Default 1 Web UI Features Notification Popups Display Missed Call Popup Parameter featu...

Page 215: ...meter phone_setting ring_power_led_flash_enable y0000000000xx cfg Description It enables or disables the power LED indicator to flash when the phone receives an incoming call Permitted Values 0 Disabled power LED indicator does not flash 1 Enabled power LED indicator fast flashes 0 3s red Default 1 Supported Devices All phones except CP960 Web UI Features Power LED Ringing Power Light Flash Parame...

Page 216: ...te state Permitted Values 0 Disabled power LED indicator mute LED indicator does not flash 1 Enabled power LED indicator mute LED indicator fast flashes 0 5s red Default 0 Web UI Features Power LED Hold Held Power Light Flash not for CP960 Parameter phone_setting talk_and_dial_power_led_enable y0000000000xx cfg Description It enables or disables the power LED indicator to be turned on when the pho...

Page 217: ...for example Bluetooth headset with your phone And you can transfer files via Bluetooth sharing images videos with other Bluetooth devices Topic Bluetooth Configuration Bluetooth Configuration You can activate or deactivate the Bluetooth mode and personalize the Bluetooth device name for the IP phone The pre configured Bluetooth device name will display in scanning list of other devices It is helpf...

Page 218: ...n on the connected Bluetooth enabled mobile phone 1 Enabled you need to enable the Media audio feature manually after the Bluetooth enabled mobile phone is paired and connected Enable the Media audio feature via the phone user interface at the path Bluetooth Bluetooth On Media audio 2 Enabled the phone automatically acts as the Bluetooth enabled mobile phone player after you pair and connect the B...

Page 219: ... listening mode by pressing the Speakerphone key when you first answer the call using the handset Note The audio is sent only through the handset So you are able to speak and listen through the handset but you can only listen through the speaker Permitted Values 0 Disabled 1 Enabled Default 1 Supported Devices All phones except CP960 Parameter features headset_mode enable y0000000000xx cfg Descrip...

Page 220: ...ortcut Keys is only applicable to CP960 phones Topics Supported DSS Keys Supported Dsskey Types Shortcut Key Programmable Key Icons Limit Line Keys Programmable Keys Shortcut Keys Ext Keys Dsskey Lock Configuration Shortcut Key Programmable Key Icons Customization Dsskey Hide Supported DSS Keys The following table lists the number of DSS keys you can configure for each phone model Phone Model Line...

Page 221: ...le_contact_server enable 1 10 Call Park Line key Ext key 33 Status Programmable key 105 XML Park Line key Ext key 11 DTMF Line key Ext key 34 Hot Desking 304 Open Door 12 Voice Mail Line key Ext key 35 URL Record Line key Ext key 305 Video Monitoring 13 Speed Dial SpeedDial 38 LDAP only appear when ldap en able 1 306 Custom 14 Intercom 39 BLF List 308 Dial Programmable key Shortcut key 15 Line Lin...

Page 222: ... or without a symbol For example 2 15 16 7 4 or 2 15 16 7 4 means only N A Forward Line BLF Recall Hold types are available when you configure line keys To remove a function type specify line key type IDs which start with the symbol For example 14 5 2 means to remove Intercom DND Forward types from the line key types list These line key types are not available when you configure line keys Note Mul...

Page 223: ...y Line KeyX Type Phone UI Menu Features DSS Keys Line Key X Type Parameter linekey X line 1 y0000000000xx cfg Description It configures the desired line to apply the line key feature Permitted Values 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 CP960 1 Note The permitted value 0 is configurable only when featu...

Page 224: ...fg Description It configures the label displayed on the phone screen This is an optional configuration Permitted Values String within 99 characters Default Blank Web UI Dsskey Line Key Line KeyX Label Phone UI Settings Features Dsskey Line Key X Label Parameter linekey X extension 1 y0000000000xx cfg Description For multicast paging It configures the channel of the multicast paging group For the B...

Page 225: ...e is set to 22 or 45 Permitted Values Integer from 0 to 48 Default 0 Web UI Dsskey Line Key Line KeyX Line Parameter features flash_url_dsskey_led enable y0000000000xx cfg Description It enables or disables the LED indicator of the URL DSS key The LED indicator behavior depends on the response message from the server when you press the URL DSS key on the phone Permitted Values 0 Disabled 1 Enabled...

Page 226: ... Bill Set a Retrieve key linekey 3 type 56 linekey 3 line 1 linekey 3 value 11 linekey 3 label Retrieve Bill After provisioning you can easily tap the Park key line key 1 to park a call to the specific shared parking lot 01 during a call and tap the Retrieve key line key 3 to retrieve the parked call from the shared parking lot 01 using the retrieve code 11 You can only perform call park feature o...

Page 227: ...Park key will invoke the group pickup code set by features pickup group_pickup_code or account X group_pickup_code Example Setting a Line Key as BLF List Key The following example shows the configuration for a BLF List key Scenario Conditions Related Topic phone_setting auto_blf_list_enable 0 BLF List Configuration Example linekey 1 type 39 linekey 1 line 1 After provisioning a BLF List key displa...

Page 228: ...Line Key as Video Monitoring Key The following example shows the configuration for an open door key Example linekey 1 type 305 linekey 1 value http 192 168 1 1 mjpg video mjpg linekey 1 label Door Phone2 linekey 1 extension 1048 After provision you can tap the line key 1 to check the camera video at any time Programmable Keys You can customize programmable keys on the phone to enable users to acce...

Page 229: ...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 1 SoftKey1 SoftKey1 2 SoftKey2 SoftKey2 3 SoftKey3 SoftKey3 ...

Page 230: ...mmable key types are not available when you configure programmable keys Note Multiple programmable key type IDs are separated by commas N A type is always kept Permitted Values Blank or 0 all valid function types are available Dsskey type IDs For supported Dsskey types and IDs refer to Supported Dsskey Types Default Blank Supported Devices All phones except CP960 Parameter programablekey X type 1 ...

Page 231: ... Forward X 17 default 0 NA X 18 default 0 NA Web UI Dsskey Programmable Key Type Parameter programablekey X history_type 1 y0000000000xx cfg Description It configures the history type of programmable key Permitted Values 0 Local History 1 Network CallLog only appear when bw enable 1 and bw xsi call_log enable 1 Default 0 Web UI Dsskey Programmable Key Line Parameter programablekey X line 1 y000000...

Page 232: ...he key sequence you want to send via DTMF Note It is only applicable when programablekey X type is set to 13 14 or 24 Permitted Values For multicast paging 0 to 31 For intercom feature String within 256 characters For speed dial feature String Default 0 Supported Devices All phones except CP960 Web UI Dsskey Programmable Key Extension Parameter programablekey X xml_phonebook 1 y0000000000xx cfg De...

Page 233: ...Shortcut Keys You can add up to six specific shortcut keys on a new idle screen Users can use these functions from the phone screen directly for example XML Browser It is only applicable to CP960 phones Topic Shortcut Keys Configuration Shortcut Keys Configuration The following table lists the parameters you can use to configure the shortcut keys Parameter shortcutkey X type 1 y0000000000xx cfg De...

Page 234: ... String within 99 characters Default Blank Supported Devices CP960 Web UI Dsskey Shortcut Key Value 1 X is the shortcut key ID X 1 6 Related Topic Shortcut Key Programmable Key Icons Customization Configuration Ext Keys The ext keys take effect only if the expansion module is connected to the IP phone It is only applicable to T58A phones Topic Ext Keys Configuration Ext Keys Configuration The foll...

Page 235: ...0 N A 1 Conference 2 Forward 3 Transfer 4 Hold 5 DND 7 Recall 8 SMS 9 Direct Pickup 10 Call Park 11 DTMF 12 Voice Mail 13 Speed Dial 14 Intercom 15 Line 16 BLF 17 URL 18 Group Listening 20 Private Hold 22 XML Group 23 Group Pickup 24 Multicast Paging Paging 25 Record 27 XML Browser 34 Hot Desking 35 URL Record 38 LDAP only appears when ldap enable 1 39 BLF List 40 Prefix 41 Zero Touch 42 ACD 45 Lo...

Page 236: ... 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 Permitted Values String within 99 characters Default Blank Supported Devices T58A Web UI Dsskey Ext Key ...

Page 237: ...oth Remote Phone Book 1 Sell and Remote Phone Book 2 Market are configured on the phone you can configure programablekey X xml_phonebook 0 to specify the Remote Phone Book 1 Sell for the specific ext key The user can press this line key to access the Remote Phone Book 1 Sell Note It is only applicable when expansion_module X key Y type is set to 22 or 45 Permitted Values Integer from 0 to 48 Defau...

Page 238: ...o configure the shortcut key programmable key icons Parameter dsskey icon url y0000000000xx cfg Description It configures the access URL of a TAR icon file for shortcut key programmable key The format of the icon must be png The icon file should be compressed into a TAR file in advance and then place it to the provisioning server Example dsskey icon url tftp 192 168 10 25 icon_directory tar Note W...

Page 239: ...X is the shortcut key ID X 1 6 2 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 The shortcut key is only applicable to CP960 p...

Page 240: ...ng 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 Example dsskey icon url http 192 168 10 25 icon_custom tar programablekey 2 icon icon_directory png After auto provisioning the second...

Page 241: ...e 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 Related Topics Programmable Keys Configuration Shortcut Key Programmable Key Icons Customization Configuration Preparing the Tar Formatted File Dsskey Hide Yo...

Page 242: ...need more than one keypress with the default configuration l Removing certain default DSS keys for the functions that may be redundant or never used l One touch connecting to the contact s extension number without entering DTMF manually 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 ...

Page 243: ...The embedded action type Multiple actions can be defined Supported action types include l invite l dtmf l refer l intercom Example 338 Tdtmf defines sending the 338 by the type of DTMF Note We recommend that you always define this field If not the supplied digits are dialed using INVITE M macro The embedded macro The macro string must begin with a letter If the macro name is not defined the execut...

Page 244: ... this command on any screen Example KDialPadPound means pressing the pound key Note If a key for example Redial key is not found but the function is avail able the phone will perform the corresponding action If a key is not found and the function is unavailable the execution of the action string will be ignored I menu item ID The action is to position and enter the desired menu item Each menu item...

Page 245: ...L label This is the label for the entire operation The value can be any string including the null string in this case no label displays This label is used if no label is configured for a custom DSS key or soft key otherwise this one is ignored Make this the first entry in the action string Example LEDK2 1234 Tinvite defines calling out the number 1234 and using the label EDK2 for a Custom Key LED ...

Page 246: ...DK 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 It is not applicable to CP960 phones The following graphic shows an example for displaying the menu item ID after accessing a submenu of T58A phones The following table lists the parameters you ca...

Page 247: ...Parameter edk edklist X mname 1 y0000000000xx cfg Description It configures the unique identifier used by the soft key or DSS key configuration to reference the enhanced DSS keys entry for macro X It cannot start with a digit This parameter must have a value it cannot be left blank Example edk edklist 2 mname macro2 Note If there are two or more same macros the soft key or DSS key will invoke the ...

Page 248: ...k edkprompt X label 1 y0000000000xx cfg Description It configures the text string used as a label of the user input prompt X If it is left blank Default is displayed Example edk edkprompt 1 label Enter Password Note It works only if features enhanced_dss_keys enable and edk edkprompt X enable are set to 1 Enabled Permitted Values String Default Default Supported Devices All phones except CP960 Par...

Page 249: ...mize the soft keys as need This feature is typically used to access frequently used functions or to cre ate menu shortcuts to frequently used phone settings Custom soft keys can be added in the following phone states l Idle There are no active calls on the phone l Alerting or ringing There is an incoming call on the phone l Connecting There is an outgoing call on the phone Moreover the call is con...

Page 250: ...enhanced_dss_keys enable and softkey X enable are set to 1 Enabled Permitted Values Integer from 0 to 10 If it is set to 0 the soft key X is located in the first available position from the left Default 0 Supported Devices All phones except CP960 Parameter softkey X action 1 y0000000000xx cfg Description It configures the action or function for custom soft key X This value uses the same macro acti...

Page 251: ...scription It enables or disables the custom soft key X to be displayed in the alerting ringing state Note It works only if features enhanced_dss_keys enable and softkey X enable are set to 1 Enabled Permitted Values 0 Disabled 1 Enabled Default 0 Supported Devices All phones except CP960 Parameter softkey X use connecting 1 y0000000000xx cfg Description It enables or disables the custom soft key X...

Page 252: ...cept CP960 Parameter softkey X use ring_back 1 y0000000000xx cfg Description It enables or disables the custom soft key X to be displayed in the ring back state Note It works only if features enhanced_dss_keys enable and softkey X enable are set to 1 Enabled Permitted Values 0 Disabled 1 Enabled Default 0 Supported Devices All phones except CP960 Parameter softkey X use transfer_ring_back 1 y00000...

Page 253: ...ed_dss_keys enable and softkey X enable are set to 1 Enabled Permitted Values 0 Disabled 1 Enabled Default 0 Supported Devices All phones except CP960 Parameter softkey X use dialtone 1 y0000000000xx cfg Description It enables or disables the custom soft key X to be displayed in the dial tone no numbers entered state Note It works only if features enhanced_dss_keys enable and softkey X enable are ...

Page 254: ...he backlight and screen also applicable to EXP50 expansion module con nected to the T58A phones to conserve energy The IP phone and EXP50 if connected enter power saving mode after the phone has been idle for a certain period of time And the IP phone and EXP50 if connected will exit power saving mode if a phone EXP50 event occurs for example the phone receives an incoming call or a new message or ...

Page 255: ... even if the office hour arrives the next day 1 Enabled the phone automatically identifies the office hour and exits power saving mode once the office hour arrives the next day Default 1 Parameter features power_saving enable y0000000000xx cfg Description It enables or disables the power saving feature Permitted Values 0 Disabled the phone automatically enters the power saving mode to protect the ...

Page 256: ...Values Integer from 0 to 23 Integer from 0 to 23 Default 7 19 for Monday Tuesday Wednesday Thursday Friday 7 7 for Saturday Sunday Web UI Settings Power Saving Monday Tuesday Wednesday Thursday Friday Saturday Sunday Parameter features power_saving power_led_flash on_time y0000000000xx cfg Description It configures the period of time in milliseconds when the power LED indicator is on in the power ...

Page 257: ... xml Topics 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 Customizing Search Source File Search Source File Attrib...

Page 258: ... in the corresponding field For example enable the local directory search disable the call log search and specify a priority item id_name local_directory_search display_name Local Contacts priority 1 enable 1 item id_name calllog_search display_name History priority 2 enable 0 3 Save the change and place this file to the provisioning server Search Source List Configuration The following table list...

Page 259: ...0xx cfg Description It configures the search priority of the call history list Permitted Values Integer greater than or equal to 0 Default 2 Web UI Directory Settings Search Source List In Dialing Parameter search_in_dialing remote_phone_book enable y0000000000xx cfg Description It enables or disables the phone to automatically search entries from the remote phone book and dis play results on the ...

Page 260: ... placed calls list when the phone is on the dialing screen lifts the hand set presses the Speakerphone key or taps the desired line key You can select to place a call from the placed calls list The following shows the recent calls displayed on T58A phones Topic Recent Call in Dialing Configuration Recent Call in Dialing Configuration The following table lists the parameter you can use to configure...

Page 261: ...g icon url 1 y0000000000xx cfg Description It configures the access URL of the tar file for custom application icons Permitted Values URL within 511 characters Default Blank Parameter phone_setting icon delete 1 y0000000000xx cfg Description It deletes all custom application icons Permitted Values http localhost all Default Blank 1 If you change this parameter the phone will reboot to make the cha...

Page 262: ...how many IP intercoms are supported by the phone Permitted Values Integer from 0 to 99 Default 99 Supported Devices All phones except CP960 Web UI Features Door Phone Door Phone List Parameter features doorphone X device_model 1 y0000000000xx cfg Description It configures the device type of the IP intercom Permitted Values 0 Custom 1 2N 3 Baudisch Default 0 Supported Devices All phones except CP96...

Page 263: ...ription It enables or disables the phone to enter full screen display automatically after answering the visitor s call Note It works only if video enable is not set to 0 Disabled Permitted Values 0 Disabled 1 Enabled Default 0 Supported Devices All phones except CP960 Web UI Features Door Phone Full Screen in Call Parameter features doorphone X send_audio 1 y0000000000xx cfg Description It enables...

Page 264: ...meter features doorphone X videopreview enable 1 y0000000000xx cfg Description It enables or disables the video preview when receiving a visitor s incoming call Note It works only if account X auto_answer is set to 0 Disabled and video enable is not set to 0 Disabled Permitted Values 0 Disabled 1 Enabled when features doorphone X autopreview enable is set to 0 Disabled users can tap Pre view to ch...

Page 265: ...corder Parameter features doorphone X httpapi username 1 y0000000000xx cfg Description It configures the user name for HTTP API authentication Note It is required only when the IP intercom needs the HTTP API authentication Permitted Values String within 99 characters Default Blank Supported Devices All phones except CP960 Web UI Features Door Phone User Name Parameter features doorphone X httpapi ...

Page 266: ...ion Center Display The status bar is used to display the phone s default account some feature status icons and time The control center or notification center allows users to access common features or view important notifications quickly You can disable the phone to display the status bar and control notification center It is only applicable to VP59 T58A phones Topic Status Bar and Control Notifica...

Page 267: ...ble lists the parameter you can use to configure the warnings display Parameter phone_setting warnings_display mode y0000000000xx cfg Description It enables or disables the phone to display warnings Permitted Values 0 Disabled 1 Enabled Default 1 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 f...

Page 268: ...in seconds to wait before the phone plays an alert tone after the network is abnormal Note It works only if features out_of_service_alert enable is set to 1 Enabled Permitted Values Integer from 0 to 3600 Default 60 PC Mode When the CP960 is connected to a PC via USB users can switch between the hybrid UC conference and the idle screen and can synchronize the volume with the PC Topic PC Mode Confi...

Page 269: ...p the Volume key on any screen to adjust the call volume media volume or hybrid UC con ference volume and the ringer volume Default 0 Supported Devices CP960 Parameter phone_setting usb pc_mode default_conference y0000000000xx cfg Description It configures whether to invite a new party to the hybrid UC conference after you tap Dial on the idle screen in PC mode Note It works only if phone_setting ...

Page 270: ...on or phone number Topics Supported Accounts Accounts Registration Configuration Registration Settings Configuration Supported Accounts The number of registered accounts must meet the following Phone Model Accounts VP59 T58A 16 2 PSTN account CP960 1 2 PSTN account Accounts Registration Configuration The following table lists the parameters you can use to register accounts Parameter account X enab...

Page 271: ...unt Register Register Name Phone UI Settings Advanced Settings default password admin Accounts Register Name Parameter account X user_name 1 MAC cfg Description It configures the user name of the account Permitted Values String within 99 characters Default Blank Web UI Account Register Username Phone UI Settings Advanced Settings default password admin Accounts User Name Parameter account X passwo...

Page 272: ...ounts Outbound Status Parameter account X outbound_proxy Y address 1 2 MAC cfg Description It configures the IP address or domain name of the outbound proxy server Note It works only if account X outbound_proxy_enable is set to 1 Enabled Permitted Values String within 256 characters Default Blank Web UI Account Register Outbound Proxy Server Y Phone UI Settings Advanced Settings default password a...

Page 273: ... Settings Advanced Settings default password admin Accounts PSTNX Label Parameter pstn account X missed_calllog 1 MAC cfg Description It enables or disables the phone to indicate and record missed calls for PSTN account X Note It works only if features save_call_history is set to 1 Enabled The prompt message is dis played only if features missed_call_popup enable is set to 1 Enabled Permitted Valu...

Page 274: ...cfg Description It configures a ring tone for PSTN account X Example pstn account 1 ring_type Ring3 wav It means PSTN account 1 will use the Ring3 wav as the ring tone pstn account 1 ring_type Common It means PSTN account 1 will use the ring tone same as the IP phone configured by the parameter phone_setting ring_type Permitted Values Common Ring1 wav Ring2 wav Ring3 wav Ring4 wav Ring5 wav Ring6 ...

Page 275: ...act_take_line_param 1 MAC cfg Description It enables or disables the phone to carry the line parameter in the Contact header of the Register mes sage Permitted Values 0 Disabled 1 Enabled Default 0 Parameter account X unregister_on_reboot 1 MAC cfg Description It enables or disables the phone to unregister first before re registering account X after a reboot Permitted Values 0 Disabled 1 Enabled D...

Page 276: ...inning of the overlap period For example if expires 120 configured by the para meter account X sip_server Y expires and overlap 30 the phone will re register after 90 seconds 120 30 Permitted Values Positive integer and 1 Default 1 Parameter account X subscribe_expires_overlap 1 MAC cfg Description It configures the renewal time in seconds away from the subscription lease Permitted Values Positive...

Page 277: ...dancy are possible In some cases a combination of the two may be deployed l Failover In this mode the full phone system functionality is preserved by having a second equivalent capability call server take over from the one that has gone down off line This mode of operation should be done using the DNS mechanism from the primary to the secondary server Therefore if you want to use this mode the ser...

Page 278: ... two server redundancy types For more information on server redundancy refer to Server Redund ancy on Yealink IP Phones Topics Behaviors When Working Server Connection Fails Registration Method of the Failover Fallback Mode Fallback Server Redundancy Configuration Failover Server Redundancy Configuration Behaviors When Working Server Connection Fails For Outgoing Call When you initiate a call the ...

Page 279: ...o SIP servers only one server works at the same time If it fails a fallback server can take over the basic calling capability but without some advanced features for example shared lines and MWI offered by the working server l Successive registration The IP phone only registers to one server at a time The IP phone first registers to the working server In a failure situation the phone registers to t...

Page 280: ...isables the phone only to send requests to the servers with different IP addresses when encountering a failover Permitted Values 0 Disabled 1 Enabled Default 1 Parameter account X sip_server Y expires 1 2 MAC cfg Description It configures the registration expiration time in seconds of SIP server Y for a specific account Permitted Values Integer from 30 to 2147483647 Default 3600 Web UI Account Reg...

Page 281: ...e primary server Default 0 Parameter account X sip_server Y failback_timeout 1 2 MAC cfg Description It configures the timeout in seconds for the phone to retry to send requests to the primary server after failing over to the current working server If you set the parameter to 0 the phone will not send requests to the primary server until a failover event occurs with the current working server If y...

Page 282: ...proxy server when encountering a failover Permitted Values Integer from 1 to 10 Default 1 the phone will invoke account X sip_server Y invite_retry_counts to take effect Parameter account X outbound_proxy Y failback_mode 1 2 MAC cfg Description It configures the failback mode for the phone to retry the primary outbound proxy server in failover Note DNSTTL Registration and duration mode can only be...

Page 283: ...fect 1 X is the account ID For VP59 T58A X 1 16 for CP960 X 1 2 Y is the server ID Y 1 2 SIP Server Name Resolution If a domain name is configured for a server the IP address es associated with that domain name will be resolved through DNS as specified by RFC 3263 The DNS query involves NAPTR SRV and A queries which allows the IP phone to adapt to various deployment environments The IP phone perfo...

Page 284: ...imes 3 y0000000000xx cfg Description It configures the retry times when the DNS server does not respond Permitted Values Integer from 0 to 65535 Default 2 1 X is the account ID For VP59 T58A X 1 16 for CP960 X 1 2 Y is the server ID Y 1 2 3 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...

Page 285: ... the parameters you can use to configure static DNS cache Parameter account X dns_cache_type 1 MAC cfg Description It configures whether the phone uses the DNS cache for domain name resolution of the SIP server and caches the additional DNS records Permitted Values 0 Perform real time DNS query rather than using DNS cache 1 Use DNS cache but do not record the additional records 2 Use DNS cache and...

Page 286: ..._naptr X ttl 2 y0000000000xx cfg Description It configures the time interval in seconds that NAPTR record X may be cached before the record should be consulted again Permitted Values Integer from 30 to 2147483647 Default 300 Parameter dns_cache_srv X name 2 y0000000000xx cfg Description It configures the domain name in SRV record X Permitted Values Domain name Default Blank Parameter dns_cache_srv...

Page 287: ...647 Default 300 Parameter dns_cache_a X name 2 y0000000000xx cfg Description It configures the domain name in A record X Permitted Values Domain name Default Blank Parameter dns_cache_a X ip 2 y0000000000xx cfg Description It configures the IP address that the domain name in A record X maps to Permitted Values IP address Default Blank Parameter dns_cache_a X ttl 2 y0000000000xx cfg Description It ...

Page 288: ...the phones to provide the logon wizard during the first startup It works only if there is no registered account on the IP phone Topic Logon Wizard Configuration Logon Wizard Configuration The following table lists the parameters you can use to configure the logon wizard Parameter phone_setting logon_wizard y0000000000xx cfg Description It enables or disables the phone to provide the logon wizard a...

Page 289: ... Parameter hotdesking startup_outbound_enable y0000000000xx cfg Description It enables or disables the phone to provide an input field of the outbound server on the logon wizard after startup when there is no registered account Note It works only if phone_setting logon_wizard is set to 1 Enabled Permitted Values 0 Disabled 1 Enabled Default 0 Parameter phone_setting logon_wizard_forever_wait y0000...

Page 290: ...ing call to a new line key the new line key is not seized If all line keys are seized the current line key will be used Note The number of the line keys is determined by account X number_of_linekey The value con figured by the parameter account X phone_setting call_appearance transfer_via_new_linekey takes precedence over that configured by this parameter Permitted Values 0 Disabled the phone will...

Page 291: ... the current line key when pressing the Conf Con ference soft key 1 Enabled the phone will place a new call by automatically selecting a new line key the cor responding line key is not seized when pressing the Conf Conference soft key If all line keys are seized the current line key will be used Default Blank 1 X is the account ID For VP59 T58A X 1 16 for CP960 X 1 Auto Line Labels Rule Configurat...

Page 292: ...ollowing table lists the parameters you can use to configure the default account Parameter static features default_account y0000000000xx cfg Description It configures the default account 1 Account 1 2 Account 2 3 Account 3 16 Account 16 Permitted Values Integer from 1 to 16 Default 1 Parameter features show_default_account y0000000000xx cfg Description It enables or disables the phone to display t...

Page 293: ... contact file Yealink phones support both xml and csv format contact files but you can only customize the xml format contact file Topics Preparing the Tar Formatted File Local Contact File Customization Local Contact Files and Resource Upload Example Adding Contacts Using a Contact File Preparing the Tar Formatted File This section provides you on how to package the tar file using 7 Zip Note You c...

Page 294: ... 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 XML Conversion Table Local Contact File Elements and Attributes ...

Page 295: ...tes Description group display_name Specify the group name For example All Contacts or Blacklist ring Specify a ringtone for the group System ring tone Auto Silent wav Splash wav RingN wav integer N ranges from 1 to 8 Custom ring tone Name wav the custom ring tone should be uploaded in advance Contact display_name Specify the contact name For example Jim Some characters for example are key syntax m...

Page 296: ...hoto Built in avatar Resource avatar name and icon name Custom avatar Config custom avatar name and icon name auto_divert Specify a destination number for diverted calls Related Topics Example Using EDK Macro Strings as the Contact Number XML Conversion Table Customizing Local Contact File 1 Open the local contact file 2 To add a group add group display_name ring to the file Each starts on a new l...

Page 297: ...e contact file contact xml downloaded from the provisioning server do not take effect Permitted Values URL within 511 characters Default Blank Web UI Directory Local Directory Import Parameter local_contact data delete y0000000000xx cfg Description It deletes all local contacts Example local_contact data delete http localhost all Permitted Values String Default Blank Parameter local_contact photo ...

Page 298: ...ontacts should be compressed as a TAR file in advance Example local_contact data_photo_tar url tftp 192 168 10 25 Contact tar Permitted Values URL within 511 characters Default Blank Parameter local_contact icon url y0000000000xx cfg Description It configures the access URL of a TAR contact icon file The format of the contact icon must be png jpg bmp The contact icon file should be compressed as a...

Page 299: ... affect the downloading of the contact avatar icon files Permitted Values 0 Disabled the phone will not upload the contact file MAC contact xml to the server so the IP phone downloads the contacts in the contact xml from the access URL configured by the parameter local_contact data url or local_contact data_photo_tar url during auto provisioning 1 Enabled the phone uploads the contact file MAC con...

Page 300: ...mode y0000000000xx cfg Description It configures which screen to enter by long pressing the line key or ext key Note It works only if local_contact favorite enable is set to 1 Enabled Permitted Values 0 Enter the line key ext key configuration screen 1 Enter the Add Contact screen Default 0 Parameter phone_setting favorite_sequence_type y0000000000xx cfg Description It configures the order of Spee...

Page 301: ...MS core on the phone Example pm gms_install_url http 192 168 10 25 open_gapps arm64 7 1 pico 20190529 zip Once provisioning Play Store application is added on the second idle screen after phone reboot 4 Access the web user interface of the phone navigate to Settings GMS 5 Click Register to jump to the page of Google Android device registration https www google com android uncertified 6 Copy the An...

Page 302: ... Note It works only if google_contact_server enable is set to 1 Enabled Permitted Values 0 All downloaded Google contacts will be displayed on the phone 1 Only the Google contacts whose number fields are not empty will be displayed on the phone Default 1 Supported Devices All phones except CP960 1 If you change this parameter the phone will reboot to make the change take effect GMS Services List Y...

Page 303: ...dle screen after phone reboot 4 Disable some GMS services on the phone Example Multiple GMS servicess are separated by slashs app unavailable com google android onetimeinitializer com google android configupdater 5 Add a Google account via the phone user interface Settings APP Accounts Add account Google 6 Enable Google Contacts feature on the phone google_contact_server enable 1 After provisionin...

Page 304: ...o the guest profile next time he she can access the LDAP directory directly instead of entering the LDAP user credentials again The IP phone can store up to 100 LDAP user credentials If the number of user credentials reaches 100 the user who has the longest inactivity period is removed from the phone when any additional user is added The LDAP user credentials persist after the phone reboots Relate...

Page 305: ...000000xx cfg Description It configures the search criteria for LDAP contact numbers lookup The symbol in the filter stands for any number The symbol in the filter stands for the number entered by the user Example ldap number_filter telephoneNumber mobile ipPhone When the number of the telephoneNumber mobile or ipPhone of the contact record matches the search criteria the record will be displayed o...

Page 306: ...iption It configures the LDAP search base which corresponds to the location of the LDAP phonebook from which the LDAP search request begins The search base narrows the search scope and decreases directory search time Example ldap base dc yealink dc cn Permitted Values String within 99 characters Default Blank Web UI Directory LDAP LDAP Base Parameter ldap user y0000000000xx cfg Description It conf...

Page 307: ...onfigure multiple name attributes separated by spaces Example ldap name_attr cn sn This requires the cn and sn attributes set for each contact record on the LDAP server Permitted Values String within 99 characters Default Blank Web UI Directory LDAP LDAP Name Attributes Parameter ldap numb_attr y0000000000xx cfg Description It configures the number attributes of each record to be returned by the L...

Page 308: ...ldap version y0000000000xx cfg Description It configures the LDAP protocol version supported by the IP phone The version must be the same as the version assigned on the LDAP server Permitted Values 2 or 3 Default 3 Web UI Directory LDAP Protocol Parameter ldap call_in_lookup y0000000000xx cfg Description It enables or disables the phone to perform an LDAP search when receiving an incoming call Per...

Page 309: ...oneNumber mobile for searching the telephone numbers starting with symbol Permitted Values 0 Disabled 1 Enabled Default 0 Parameter ldap numb_display_mode y0000000000xx cfg Description It configures the display mode of the attribute name for the LDAP contact number Note It works only if ldap enable is set to 1 Enabled Permitted Values 0 NumberN N is an increasing number for example Number1 Number2...

Page 310: ...e server Multiple attribute names are separated by spaces Example ldap custom_extra_attr_name Comment title Language lang The phone screen displays Comment title of the contact record and Language lang of the contact record Note It works only if ldap enable is set to 1 Enabled Permitted Values String Default Blank Parameter ldap anonymous_bind_operation enable y0000000000xx cfg Description It enab...

Page 311: ...artment xml The Menu xml file defines the group department of a remote phone book The Department xml file defines contact lists for a department group which is nested in Menu xml file The following table lists the elements you can use to add groups or contacts in the remote phone book file We recommend that you do not edit these elements Template Element Valid Values Department xml DirectoryEntry ...

Page 312: ... files URLs and specify them in the Menu xml file For example MenuItem Name Market Name URL http 192 168 0 1 99 Market xml URL MenuItem SoftKeyItem Name 1 Name URL http 192 168 0 1 99 Propaganda xml URL SoftKeyItem 5 Save Menu xml file and place it to the provisioning server Remote Phone Book Configuration The following table lists the parameters you can use to configure the remote phone book Para...

Page 313: ...to perform a remote phone book search for an incoming or outgoing call and display the matched results on the phone screen Permitted Values 0 Disabled 1 Enabled Default 0 Web UI Directory Remote Phone Book Incoming Outgoing Call Lookup Parameter features remote_phonebook flash_time y0000000000xx cfg Description It configures how often to refresh the local cache of the remote phone book If it is se...

Page 314: ... Directory Remote Phone Book and Blacklist by default You can add the desired lists to directory list using a directory list file favorite_setting xml Topics 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...

Page 315: ...ess Directory Dir on the phone Customizing Directory List File 1 Open the directory list XML file 2 To configure each directory list edit the values within double quotes in the corresponding field For example enable the local directory disable the history and specify a priority item id_name localdirectory display_name Local Directory priority 1 enable 1 dev common item id_name history display_name...

Page 316: ...gures the display priority of the call log list Permitted Values Integer greater than or equal to 0 Default 2 Parameter directory_setting remote_phone_book enable y0000000000xx cfg Description It enables or disables the users to access the remote phone book by tapping the directory icon Permitted Values 0 Disabled 1 Enabled Default 0 Parameter directory_setting remote_phone_book priority y00000000...

Page 317: ... Parameter directory search_type y0000000000xx cfg Description It configures the search type when searching the contact in Local Directory Remote Phone Book Net work Directory or Blacklist Permitted Values 0 Approximate string matching the phone will search the contact numbers or names contain the entered character s 1 Prefix matching the phone will search the contact numbers or names start with t...

Page 318: ... replace with y0000000000xx cfg Description It configures the string used to replace the certain matched one of the contact number Permitted Values String within 512 characters Default Blank Related Parameters phone_setting reverse_lookup contact_list replace pattern Parameter phone_setting reverse_lookup incoming_call re place pattern y0000000000xx cfg Description It configures the matching patte...

Page 319: ...se_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 will be replaced with 1781296 When receiving the incoming call from 491781296 491781296 will be replaced with 1781296 Then the phone screen...

Page 320: ...l to X For example Forward to 1048 means you forward an incoming call to 1048 l Busy The outgoing call is rejected l Transfer to X Transfer a call to X For example Transfer to 1048 means you transfer a call to 1048 l X Answer a transferred forwarded call from remote party X your call is transferred forwarded to X For example 1048 means you answer a transferred forwarded call from remote party 1048...

Page 321: ... Number Parameter features calllog_detailed_information y0000000000xx cfg Description It enables or disables the phone to indicate what happened to the call in the call log lists It is applicable to the following scenarios l Reject an incoming call l Forward an incoming call l The outgoing call is rejected l Transfer a call l Answer a transferred forwarded call from the remote party your call is t...

Page 322: ... 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 If a call log file exists on the server it will be overridden The phone will request to download the MAC calllog xml file acco...

Page 323: ...auto provisioning the phone downloads the call log file MAC calllog xml from the spe cified path http 192 168 1 20 calllog Note It works only if static auto_provision local_calllog backup enable is set to 1 Enabled Permitted Values String Default Blank Parameter static auto_provision local_calllog write_delay terminated y0000000000xx cfg Description It configures the delay time in seconds for the ...

Page 324: ... by the user Yealink phones support up to 100 replace rules l Dial now is a string used to match numbers entered by the user When entered numbers match the predefined dial now rule the phone will automatically dial out the numbers without pressing the send key Yealink phones support up to 100 dial now rules l Area code are also known as Numbering Plan Areas NPAs They usually indicate geographical ...

Page 325: ...hes any of a set of characters Example 91 5 7 1234 would match 9151234 9161234 9171234 The parenthesis can be used to group together patterns for instance to logically combine two or more patterns Example 1 9 2 7 3 would match 923 153 673 and so on The followed by the sequence number of a parenthesis means the characters placed in the par enthesis The sequence number stands for the corresponding p...

Page 326: ...d place this file to the provisioning server Dial Now File Customization 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 Topics Dial Now Fil...

Page 327: ...lan replace replace X 1 y0000000000xx cfg Description It configures the alternate number to replace the entered number The entered number is configured by dialplan replace prefix X Note It works only if dialplan digitmap enable and account X dialplan digitmap enable are set to 0 Disabled Permitted Values String within 32 characters Default Blank Web UI Settings Dial Plan Replace Rule Replace Param...

Page 328: ...characters Default Blank Web UI Settings Dial Plan Dial Now Rule Parameter dialplan dialnow line_id X 1 y0000000000xx cfg Description It configures the desired line to apply the dial now rule The digit 0 stands for all lines If it is left blank the dial now rule will apply to all lines on the phone Note Multiple line IDs are separated by commas It works only if dialplan digitmap enable and account...

Page 329: ...alplan dialnow rule X dialplan digitmap string account X dialplan digitmap string 1 X is from 1 to 100 Area Code Configuration The following table lists the parameters you can use to configure the area code Parameter dialplan area_code code y0000000000xx cfg Description It configures the area code to be added before the entered numbers when dialing out Note The length of the entered number must be...

Page 330: ... for CP960 Default Blank Web UI Settings Dial Plan Area Code Account Block Out Configuration The following table lists the parameters you can use to configure the block out Parameter dialplan block_out number X 1 y0000000000xx cfg Description It configures the block out numbers Example dialplan block_out number 1 4321 When you dial the number 4321 on your phone the dialing will fail and the phone ...

Page 331: ...er is dialed out Topics Basic Regular Expression Syntax for Digit Map Digit Map for All Lines Configuration Digit Map for a Specific Line Configuration Basic Regular Expression Syntax for Digit Map You need to know the following basic regular expression syntax when creating a new dial plan T The timer letter T indicates a timer expiry If T is used alone for example 123T the default timeout value o...

Page 332: ... 2351 2352 2353 and so on The number starting with 235 will be blocked to dial out The comma can be used as a separator to generate a secondary dial tone Example 9 55 xx after entering digit 9 secondary dial tone plays and you can complete the remaining two digit number Note The secondary dial tone can be customized For more information refer to Tones A The letter A indicates the account that is a...

Page 333: ... enter 15 it also matches part of two digit maps the phone tries to wait 10 seconds and then dials out 15 if no numbers entered When you enter 153 it also matches part of two digit maps the phone tries to wait 10 seconds But after waiting for 5 seconds it completely matches the first digit map and then immediately dials out 153 Note It works only if dialplan digitmap enable or account X dialplan d...

Page 334: ...y or automatically dial out the entered number after a certain period of time configured by the parameter dial plan digitmap interdigit_long_timer Default 0 Parameter dialplan digitmap active on_hook_dialing y0000000000xx cfg Description It enables or disables the entered numbers to match the predefined string of the digit map in real time It is only applicable to the on hook dialing Note It works...

Page 335: ...plan digitmap enable is set to 1 Enabled The value configured by the parameter account X dialplan digitmap apply_to forward takes precedence over that configured by this parameter Permitted Values 0 Disabled 1 Enabled the incoming calls will be forwarded to the desired destination number according to the string of the digit map Default 1 Parameter dialplan digitmap apply_to press_send y0000000000x...

Page 336: ...ong_timer 1 MAC cfg Description It configures the time in seconds to wait before dialing an entered number if it matches part of any string of the digit map for the account X If it is set to 0 the phone will not dial the entered number if only a partial match exists The value of this parameter should be greater than that configured by the parameter accoun t X dialplan digitmap interdigit_short_tim...

Page 337: ... 2 9 11T 4 is applied to the 2 9 x 86 3 T digit map 5 is applied to 2T digit map 3 is applied to 1xxT digit map 6 is applied to 0x digit map 2 is applied to the 2 9 11T digit map the last digit 1 is ignored Default 3 Parameter account X dialplan digitmap no_match_action 1 MAC cfg Description It configures the behavior when an impossible digit map match occurs Note It works only if account X dialpl...

Page 338: ...ap apply_to directory_dial Permitted Values 0 Disabled 1 Enabled Default Blank Parameter account X dialplan digitmap apply_to history_dial 1 MAC cfg Description It enables or disables the digit map to be applied to the numbers received calls or missed calls dialed from call log lists Note It works only if account X dialplan digitmap enable is set to 1 Enabled The value configured by the parameter ...

Page 339: ...s could not get through because of the server failure If the phone is not locked it checks against the regular dial plan If the phone is locked it checks against the emer gency dial plan Enhanced 911 E911 Enhanced 911 is a location technology that enables the called party to identify the geographical location of the calling party For example if a caller makes an emergency call to E911 the feature ...

Page 340: ...r and SIP server for example abc com is included in the P Asserted Identity PAI header for example sip 1234567890 abc com SIP URI for example sip 1234567890123 abc com The full URI is included in the P Asserted Iden tity PAI header and the address will be replaced by the emergency server for example sip 1234567890123 emergency com TEL URI for example tel 16045558000 The full URI is included in the...

Page 341: ...servers to be used first Multiple values are separated by commas The servers to be used in the order listed left to right The IP phone tries to make emergency calls using the emergency server with higher priority and then with lower priority The IP phone tries to send the INVITE request to each emergency server three times Note If the account information has been configured no matter whether the a...

Page 342: ... emergency held request_element 1 name mac dialplan emergency held request_element 2 name companyID dialplan emergency held request_element 3 name nai 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 Values String Default Blank Parameter dialplan emergency held request_element X value 2 y0000000000xx cfg Descrip...

Page 343: ...es only support one hotline number Note If you do not specify a line the phone uses the first available line to dial out the hotline number by default This feature works only if the Off Hook Hot Line Dialing feature is disabled For more information refer to Off Hook Hot Line Dialing Topic Hotline Configuration Hotline Configuration The following table lists the parameters you can use to configure ...

Page 344: ...ons may vary from different servers It is also applicable to the IP call and intercom call Note Off hook hot line dialing feature limits the call out permission of this account and disables the hotline feature For example when the phone goes off hook using the account with this feature enabled the configured hotline number will not be dialed out automatically Topic Off Hook Hot Line Dialing Config...

Page 345: ...e_setting inter_digit_time y0000000000xx cfg Description It configures the delay time in seconds for the phone to automatically dial out the entered phone number without tapping a send key Note It works only if phone_setting predial_autodial is set to 1 Enabled and dial plan digitmap enable is set to 0 Disabled Permitted Values Integer from 1 to 14 Default 4 Web UI Settings Preference Inter Digit ...

Page 346: ...nswers the call Permitted Values Integer from 1 to 300 Default 10 Web UI Features General Information Auto Redial Times 1 300 Phone UI Settings Features Auto Redial Redial Times Parameter features redial_via_local_sip_server enable y0000000000xx cfg Description It configures the phone to redial via local SIP server or remote SIP server Permitted Values 0 Remote SIP Server 1 Local SIP Server Defaul...

Page 347: ...le Keys Configuration Password Dial Password dial feature allows the callee number to be partly displayed on the IP phone when placing a call The hid den digits are displayed as asterisks on the phone screen The number in the placed call list is also partly displayed on the IP phone This feature is especially useful for users who often place important and confidential calls Topic Password Dial Con...

Page 348: ... Call Timeout Configuration The following table lists the parameter you can use to configure call timeout Parameter phone_setting ringback_timeout y0000000000xx cfg Description It configures the duration time in seconds in the ringback state If it is set to 180 the phone will cancel the dialing if the call is not answered after 180 seconds Permitted Values Integer from 1 to 3600 Default 180 Anonym...

Page 349: ...efault 0 Web UI Account Basic Send Anonymous Code Phone UI Settings Features Anonymous Line X Send Anony Code Parameter account X anonymous_call server_base_only 1 MAC cfg Description It enables or disables the phone to perform the anonymous call feature on server side only Note You need to configure parameters account X anonymous_call_oncode and accoun t X anonymous_call_offcode to activate and d...

Page 350: ...ic Call Number Filter Configuration Call Number Filter Configuration The following table lists the parameter you can use to configure call number filter Parameter features call_num_filter y0000000000xx cfg Description It configures the characters the phone filters when dialing If the dialed number contains configured characters the phone will automatically filter these char acters when dialing Exa...

Page 351: ...es an incoming call in the idle state the screen prompts the incoming call information l To ignore the call and initial a new call pick up the handset press the Speakerphone key or HEADSET key press keypad or other line keys l To answer the incoming call press the corresponding line key the Answer soft key or the OK key When the phone receives an incoming call in the call state the screen does not...

Page 352: ...er Configuration Auto Answer Configuration The following table lists the parameters you can use to configure the auto answer Parameter account X auto_answer 1 MAC cfg Description It enables or disables auto answer a SIP call Note The phone cannot automatically answer the incoming call during a call or while dialing even if the auto answer is enabled Permitted Values 0 Disabled 1 Enabled the phone ...

Page 353: ...is an incoming call arrived when the phone is in a call or dialing the phone will automatically answer after you end the current call or cancel the dialing 1 Enabled The phone can only automatically answer the incoming call arrived when the phone is idle If there is an incoming call arrived when the phone is in a call or dialing you have to manually pick up the incoming call Default 1 Parameter fe...

Page 354: ...ng call is automatically answered and then the other party cannot hear you Default 0 1 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 Anonymous call rejection can be performed locally or on the server When performing anonymous ...

Page 355: ...tings Features Anonymous Line X On Code Parameter account X send_anonymous_rejection_code 1 MAC cfg Description It configures the IP phone to send anonymous call rejection on off code to activate deactivate the server side anonymous call rejection feature for account X Permitted Values 0 Off Code the phone will send anonymous rejection off code to the server when you deactivate the anonymous call ...

Page 356: ...ription It enables or disables the call waiting feature Permitted Values 0 Disabled a new incoming call is automatically rejected by the phone with a busy message during a call 1 Enabled the phone screen will present a new incoming call during a call Default 1 Web UI Features General Information Call Waiting Phone UI Settings Features Call Waiting Call Waiting Parameter call_waiting tone y00000000...

Page 357: ...uration DND Settings Configuration You can change the following DND settings l Enable or disable the DND feature If disabled the users have no permission to configure DND on their phone l Choose a DND mode You can configure DND for all lines or specific lines l Enable or disable DND emergency feature and specify DND authorized numbers These numbers will not be DND when the DND feature is enabled T...

Page 358: ...DND feature is enabled Note The authorized numbers are configured by the parameter features dnd emergency_author ized_number It works only if features dnd allow is set to 1 Enabled Permitted Values 0 Disabled 1 Enabled Default 0 Web UI Features Forward DND DND DND Emergency Parameter features dnd emergency_authorized_number y0000000000xx cfg Description It configures the authorized numbers the pho...

Page 359: ...e idle screen to deactivate DND Default 1 Supported Devices CP960 DND Feature Configuration After you choose a DND mode you can configure the DND feature for all lines or a specific line It depends on the DND mode except CP960 l Phone default DND feature is effective for all lines l Custom DND feature can be configured for a specific line or multiple lines Note DND mode is set by the parameter fea...

Page 360: ...o deactivate the server side DND feature The phone will send the DND off code to the server when you deactivate the DND feature on the phone 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 Permitted Values String within 32 characters Default Blank ...

Page 361: ...s 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 Permitted Values String within 32 characters Default Blank Supported Devices All phones except CP960 Web UI Features Forward DND DND AccountX Off Code Phone UI Settings Features DND AccountX Off Code 1 X is the account ID For VP59 T58A X 1 16 for CP960 X 1 DND Synchro...

Page 362: ...nt X feature_key_sync enable is set to 1 Enabled Permitted Values 0 Disabled 1 Enabled server based DND is enabled Server and local phone DND are synchronized Default Blank Parameter features dnd feature_key_sync local_processing enable y0000000000xx cfg Description It enables or disables the local DND when DND feature synchronization is enabled Note It works only if features feature_key_sync enab...

Page 363: ...s_per_linekey y0000000000xx cfg Description It configures the maximum number of concurrent calls per line key for all registered lines If it is set to 0 there is no limit for the number of concurrent calls Example phone_setting call_appearance calls_per_linekey 2 It means that you can have up to two concurrent calls per line key on the IP phone Note The value configured by the parameter account X ...

Page 364: ...u can use to configure call hold Parameter sip rfc2543_hold y0000000000xx cfg Description It enables or disables the phone to use RFC 2543 c 0 0 0 0 outgoing hold signaling Permitted Values 0 Disabled SDP media direction attributes such as a sendonly per RFC 3264 is used when placing a call on hold 1 Enabled SDP media connection address c 0 0 0 0 per RFC 2543 is used when placing a call on hold De...

Page 365: ... phone to play the call held tone when a call is held by the other party Permitted Values 0 Disabled 1 Enabled Default 0 Web UI Features General Information Play Held Tone Parameter features play_held_tone delay y0000000000xx cfg Description It configures the time in seconds to wait for the phone to play the initial call held tone If it is set to 30 30s the phone will wait 30 seconds to play the i...

Page 366: ...ank Web UI Account Advanced Music Server URI Parameter account X music_on_hold_type 1 MAC cfg Description It configures the way to process Music On Hold when placing an active call on hold Permitted Values 0 Calling the Music On Hold server before holding the call 1 Calling the Music On Hold server after holding the call Default 0 1 X is the account ID For VP59 T58A X 1 16 for CP960 X 1 Call Mute ...

Page 367: ...on microphone only by tapping the mute button on the expansion micro phone Note It is not available when using CP960 star connection feature Default 0 Supported Devices CP960 Phone UI Settings Wireless Microphone Synchronous mode Standalone mode Keep Mute Keep mute also known as persistent mute allows you to keep the mute state persisting across calls In a call center or meet room if incoming call...

Page 368: ...n seconds for playing an audible tone when the phone is in the mute state during the call Permitted Values Integer from 3 to 3600 Default 5 Supported Devices CP960 Call Forward You can forward calls from any line on your phone to a contact There are two ways of forwarding your calls l Forward calls in special situations such as when the phone is busy or there is no answer or forwarding all incomin...

Page 369: ...ature is effective on a phone basis 1 Custom you can configure call forward feature on a per line basis Default 0 Supported Devices All phones except CP960 Web UI Features Forward DND Forward Mode Parameter features forward emergency enable y0000000000xx cfg Description It enables or disables the phone to receive the call from authorized numbers when the call forward fea ture is activated Note It ...

Page 370: ... when an incoming call is for warded to the IP phone Permitted Values 0 Disabled 1 Enabled the server can use the Diversion field with a SIP header to inform the phone of a call s his tory Default 1 Web UI Features General Information Diversion History Info Call Forward Feature Configuration After you choose a call forward mode you can configure call forward feature for all lines or specific lines...

Page 371: ...ttings Features Call Forward Always Forward Forward To Parameter forward always on_code y0000000000xx cfg Description It configures the always forward on code to activate the server side always forward feature The phone will send the always forward on code and the pre configured destination number con figured by the parameter forward always target to the server when you activate always forward fea...

Page 372: ...eatures Forward DND Forward Busy Forward Target Phone UI Settings Features Call Forward Busy Forward Forward To Parameter forward busy on_code y0000000000xx cfg Description It configures the busy forward on code to activate the server side busy forward feature The phone will send the busy forward on code and the pre configured destination number configured by the parameter forward busy target to t...

Page 373: ...s only if features fwd allow is set to 1 Enabled and features fwd_mode is set to 0 Phone except CP960 phones Permitted Values String within 32 characters Default Blank Web UI Features Forward DND Forward No Answer Forward Target Phone UI Settings Features Call Forward No Answer Forward Forward To Parameter forward no_answer timeout y0000000000xx cfg Description It configures ring times N to wait b...

Page 374: ...to 1 Enabled and features fwd_mode is set to 0 Phone except CP960 phones Permitted Values String within 32 characters Default Blank Web UI Features Forward DND Forward No Answer Forward On Code Phone UI Settings Features Call Forward No Answer Forward On Code Parameter forward no_answer off_code y0000000000xx cfg Description It configures the no answer forward off code to deactivate the server sid...

Page 375: ...always_fwd on_code 1 MAC cfg Description It configures the always forward on code to activate the server side always forward feature The phone will send the always forward on code and the pre configured destination number con figured by the parameter account X always_fwd target to the server when you activate always for ward feature on the phone Note It works only if features fwd allow is set to 1...

Page 376: ... only if features fwd allow is set to 1 Enabled and features fwd_mode is set to 1 Custom Permitted Values String within 32 characters Default Blank Supported Devices All phones except CP960 Web UI Features Forward DND Forward AccountX Busy Forward Target Phone UI Settings Features Call Forward AccountX Busy Forward Forward To Parameter account X busy_fwd on_code 1 MAC cfg Description It configures...

Page 377: ...forwarded to the destination number configured by the para meter account X timeout_fwd target after a period of ring time Default 0 Supported Devices All phones except CP960 Web UI Features Forward DND Forward AccountX No Answer Forward On Off Phone UI Settings Features Call Forward AccountX No Answer Forward No Answer Forward Parameter account X timeout_fwd target 1 MAC cfg Description It configu...

Page 378: ...k Supported Devices All phones except CP960 Web UI Features Forward DND Forward AccountX No Answer Forward On Code Phone UI Settings Features Call Forward AccountX No Answer Forward On Code Parameter account X timeout_fwd off_code 1 MAC cfg Description It configures the no answer forward off code to deactivate the server side no answer forward feature The phone will send the no answer forward off ...

Page 379: ...s forward feature_key_sync enable y0000000000xx cfg Description It enables or disables the forward feature synchronization Note It works only if features feature_key_sync enable is set to 1 Enabled Permitted Values 0 Disabled 1 Enabled server based call forward is enabled Server and local phone call forward are syn chronized Default 1 Parameter account X forward feature_key_sync enable 1 MAC cfg D...

Page 380: ...FER method without Replaces in the Refer To header l Semi attended Transfer Transfer a call after hearing the ringback tone The semi attended transfer is imple mented by a REFER method with Replaces in the Refer To header The semi attended transfer is applicable to that when users do not want to consult with the third party after hear ing the ringback tone and the third party has not answered the ...

Page 381: ...abled Default 1 Supported Devices T58A VP59 Web UI Features Transfer Blind Transfer On Hook Parameter transfer on_hook_trans_enable y0000000000xx cfg Description It enables or disables the phone to complete the semi attended attended transfer through on hook besides tapping the key Note Semi attended transfer means transferring a call after hearing the ringback tone Attended trans fer means transf...

Page 382: ...pplicable to phones Default 2 Web UI Features Transfer Transfer Mode via Dsskey Conference The Yealink phones support local conference and network conference Topics Conference Type Configuration Local Conference Configuration Network Conference Configuration Conference Type Configuration You can specify which type of conference to establish The following table lists the parameter you can use to se...

Page 383: ...needs to tap the Conference soft key again to set up a conference after the second party answers the call 1 Enabled the second party joins a conference with the first party after answering the call both phones play a warning tone Default 0 Supported Devices All phones except CP960 Parameter transfer tran_others_after_conf_enable y0000000000xx cfg Description It enables or disables the phone to tra...

Page 384: ...connected USB flash drive 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 Note Yealink phones support USB flash drive in FAT32 or ...

Page 385: ...g_upload server address y0000000000xx cfg Description It configures the server address the call recording files are uploaded to Note It works only if features recording_upload enable is set to 1 Enabled Permitted Values URL within 511 characters Default Blank Parameter features recording_upload server username y0000000000xx cfg Description It configures the authentication user name of the server f...

Page 386: ...o 25 We recommend that you specify these channels when broad casting with Polycom phones which have 25 channels you can listen to l 26 to 30 Broadcasts are sent to channel 26 to 30 The phones can only send and receives broadcasts to from the listened channels Other channels broadcasts will be ignored automatically by the IP phone Topics Multicast Paging Group Configuration Multicast Listening Grou...

Page 387: ... channel can receive the RTP stream Default 0 Web UI Directory Multicast IP Paging List Paging Address Channel Phone UI Settings Features Paging List Option Edit Channel 1 X ranges from 1 to 31 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 t...

Page 388: ...rity of the paging group from which the phone can receive a paging call when there is a voice call a normal phone call rather than a multicast paging call in progress You can specify a priority that the incoming paging calls with higher or equal priority are automatically answered and the lower ones are ignored If it is disabled all incoming paging calls will be automatically ignored Paging Priori...

Page 389: ...meter multicast receive_priority priority y0000000000xx cfg Description It configures the priority of the voice call a normal phone call rather than a multicast paging call in progress 1 is the highest priority 31 is the lowest priority Permitted Values 0 Disabled all incoming multicast paging calls will be automatically ignored when a voice call is in progress 1 1 2 2 3 3 31 31 If it is set to ot...

Page 390: ...meter multicast receive enhance_volume y0000000000xx cfg Description It enables or disables the volume enhancement feature when receiving the multicast paging calls Note It works only if multicast listen_address X volume is not set to 0 If the value the parameter mul ticast listen_address X volume is set to 1 15 and the value of this parameter is set to 1 Enabled the receiving volume will be 16 30...

Page 391: ... settings Parameter static camera function enable 1 y0000000000xx cfg Description It enables or disables the USB camera feature Permitted Values 0 Disabled the top USB port is disabled and the near site video image will not be transmitted in out going and incoming calls 1 Enabled Default 1 Supported Devices All phones except CP960 Parameter camera status_bar_icon enable y0000000000xx cfg Descripti...

Page 392: ...ht side of the screen displays in small size 2 Focus Full Screen One video image displays in full size the other video images are hidden Default 1 Supported Devices All phones except CP960 Web UI Features General Information Default Layout Parameter features full_screen_in_call_enable y0000000000xx cfg Description It enables or disables the phone to enter the full screen automatically when a video...

Page 393: ...coding a digital data stream or signal by implementing an algorithm The object of the algorithm is to represent the high fidelity video signal with minimum number of bits while retaining the quality This can effectively reduce the frame size and the bandwidth required for video transmission The video codec that the phone uses to establish a call should be supported by the SIP server When placing a...

Page 394: ...e of video codec MAC cfg Description It enables or disables the specified video codec for account X The name of video codec h264 H264 h264hp H264HP vp8 VP8 h263 H263 Example account 1 video h264 enable 1 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 Values 0 Disabled 1...

Page 395: ...onfiguration will not take effect Permitted Values Integer from 0 to 3 0 to 4 for VP59 phones Default When the audio codec is H264HP the default value is 1 When the audio codec is H264 the default value is 2 When the audio codec is VP8 the default value is 3 When the audio codec is H263 the default value is 4 Supported Devices All phones except CP960 Web UI Account Codec Video Codec ...

Page 396: ...call pickup is used for picking up an incoming call on a specific extension You can answer a call that rings on a specific phone If there are multiple incoming calls on the phone at the same time you can only pick up the first incoming call You can choose to implement directed call pickup using a directed call pick code or using SIP signaling Topic Directed Call Pickup Configuration Directed Call ...

Page 397: ...within 32 characters Default Blank Web UI Features Pick up Park Directed Call Pickup Code Parameter account X direct_pickup_code 1 MAC cfg Description It configures the directed call pickup code Note The code configured by this parameter takes precedence over that configured by fea tures pickup direct_pickup_code Permitted Values String within 32 characters Default Blank Web UI Account Advanced Di...

Page 398: ...Values String within 32 characters Default Blank Web UI Features Pick up Park Group Call Pickup Code Parameter account X group_pickup_code 1 MAC cfg Description It configures the group pickup code Note The code configured by this parameter takes precedence over that configured by fea tures pickup group_pickup_code Permitted Values String within 32 characters Default Blank Web UI Account Advanced G...

Page 399: ...ip 1058 10 2 1 48 5060 remote dialog dialog info Example of the Replaces carried in INVITE message Via SIP 2 0 UDP 10 10 20 18 5060 branch z9hG4bK2026058891 From 1010 sip 1010 10 2 1 48 5060 tag 826048502 To sip 1058 10 2 1 48 5060 Call ID 0_572446084 10 10 20 18 CSeq 1 INVITE Contact sip 1010 10 10 20 18 5060 Content Type application sdp Allow INVITE INFO PRACK ACK BYE CANCEL OPTIONS NOTIFY REGIS...

Page 400: ... to monitor the busy party and establish a call after the busy party becomes available to receive a call Two factors commonly prevent a call from connecting successfully l Callee does not answer l 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 subscr...

Page 401: ... T58 58 83 0 15 Subscription State active expires 60 Event dialog Content Length 584 xml version 1 0 dialog info xmlns urn ietf params xml ns dialog info version 1 state full entity sip 1000 10 2 1 48 5060 dialog id 65626 call id 0_3138198645 10 10 20 31 local tag 2331766736 remote tag 1786911541 dir ection initiator state confirmed state local identity sip 1000 10 2 1 48 5060 identity target uri ...

Page 402: ...s xml ns dialog info version 4 state partial entity y sip 1000 10 2 1 48 5060 dialog id 65644 state terminated state dialog dialog info Topics Call Completion Configuration Example Using Call Completion Call Completion Configuration The following table lists the parameters you can use to configure the call completion feature Parameter features call_completion_enable y0000000000xx cfg Description I...

Page 403: ...r park retrieve code from which the call can be retrieved after parking successfully Topics Call Park and Retrieve Configuration Example Setting Call Park and Retrieve in FAC Mode Example Setting Call Park and Retrieve in Transfer Mode Call Park and Retrieve Configuration The following table lists the parameters you can use to configure the call park and retrieve Parameter features call_park park_...

Page 404: ...eve the call parked from the specific extension 1 Enabled Default 1 Parameter features call_park line_restriction enable y0000000000xx cfg Description It enables or disables the phone to park a call using the specific line of the Call Park key Note It works only if features call_park park_mode is set to 2 Transfer Permitted Values 0 Disabled the call is parked by the current line which is in call ...

Page 405: ...tap the Retrieve soft key to retrieve the parked call from the shared parking lot 01 using the retrieve code 11 Tip You can set a line key as a Park key or a Retrieve key specify a shared parking lot you want to park a call to for Park key and specify a retrieve lot you want to retrieve a parked call from for Retrieve key For more information refer to Line Keys Automatic Call Distribution ACD ACD ...

Page 406: ...figures the period in seconds of ACD subscription Note It works only if account X acd enable is set to 1 Enabled Permitted Values Integer from 120 to 3600 Default 3600 Web UI Account Advanced ACD Subscribe Period 120 3600s Parameter features homescreen_softkey acd enable y0000000000xx cfg Description It enables or disables the phone to display the ACD softkeys such as Login or Logout on the idle s...

Page 407: ...Auto Available Timer 0 120s 1 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 Example Set an ACD for account 1 account 1 acd enable 1 account 1 acd available 1 account 1 subscribe_acd_expires 3000 acd enable 1 acd auto_available_timer 60 features homescreen_softkey acd enable 1 Set...

Page 408: ...ED Status and Behavior Configuration BLF Key for Intercom Configuration Call Information Display Configuration BLF Key Configuration You can configure a BLF key for a specific line The following shows the configuration of a BLF key for Bill linekey X type 16 linekey X line 1 linekey X value 1001 linekey X label Bill Related Topic Line Keys Configuration BLF List Configuration You can configure a B...

Page 409: ... 32 characters Default Blank Web UI Account Advanced BLF List Call Parked Code Parameter account X blf_list_call_parked_list 1 MAC cfg Description It configures the serial numbers of the monitored users in the BLF list where you can park the active call for account X Multiple serial numbers are separated by commas Example account 1 blf_list_call_parked_list When you leave it blank you cannot park ...

Page 410: ...To assign Ext Key make sure the expansion module has been connected to the phone in advance Permitted Values 0 linekey exp1 key expN key 1 exp1 key expN key linekey 2 linekey page1 page1 from exp1 key to expN key page2 from exp1 key to expN key linekey from page2 to page3 3 page1 from exp1 key to expN key page2 from exp1 key to expN key linekey Note N is the number of your connected expansion modu...

Page 411: ...le shows a NOTIFY message for a BLF line 012 xml version 1 0 dialog info xmlns urn ietf params xml ns dialog info version 1 state full entity y sip 012 10 20 10 42 5060 dialog id 0000 state terminated state dialog dialog info BLF List Subscription When you configure the IP phone to monitor a list of specific remote lines the phone sends a SUBSCRIBE request with Request URI containing the BLF List ...

Page 412: ..._dialog_blf_enable 1 MAC cfg Description It enables or disables the phone to handle NOTIFY messages out of the BLF dialog Permitted Values 0 Disabled 1 Enabled Default 0 Web UI Account Advanced Out Dialog BLF Parameter account X blf match_host enable 1 MAC cfg Description It enables or disables host match feature for BLF BLF list feature Permitted Values 0 Disabled 1 Enabled the phone can only rec...

Page 413: ...arios features blf_extension mode 0 The phone supports configuring BLF when SIP user is different from the number of the extension For example Set the SIP user user part of the SIP URI to be juhaszandrea serverIPaddress and the cor responding number of extension is 3060 serverIPaddress on the server Set the BLF key on the phone linekey 1 type 16 linekey 1 value juhaszandrea linekey 1 extension 306...

Page 414: ...l features pickup blf_visual list 4604 4605 The phone displays a visual alert when monitored user 4604 or 4605 receives an incoming call features pickup blf_visual list List1 The phone displays a visual alert when any user in the List 1 receives an incoming call ListX stands for the BLF list of account X configured by the parameter account X blf blf_list_uri Note It works only if features pickup b...

Page 415: ...d line rings Note It works only if features pickup blf_audio_enable is set to 1 Enabled Permitted Values Ring1 wav Ring2 wav Ring3 wav Ring4 wav Ring5 wav Ring6 wav Ring7 wav Ring8 wav Silent wav Splash wav or custom ring tone name for example Config Customring wav Default Splash wav Supported Devices All phones except CP960 Phone UI Settings Basic Settings Sound BLF Ring Tones Parameter features ...

Page 416: ...curs on the phone l The phone plays a specific alert tone l The icon flashes l The caller ID appears on the phone screen LED Mode for BLF BLF List Key BLF LED Mode provides five kinds of definition for the BLF BLF List key LED status BLF LED mode is only applic able to the expansion module EXP50 connected to T58A phones Topics Supported BLF LED Modes BLF LED Mode Configuration Supported BLF LED Mo...

Page 417: ...flashing red 200ms The monitored user receives an incoming call Solid red The monitored user is dialing The monitored user is talking The monitored user s conversation is placed on hold This LED status requires server sup port Slowly flashing red 1s The call is parked against the monitored user s phone number Off The monitored user is idle The monitored user does not exist Expansion Module Key LED...

Page 418: ...Icon and Behavior for Call in State Configuration BLF Key LED Icon and Behavior for Call out State Configuration BLF Key LED Icon and Behavior for Talking State Configuration BLF Key LED Icon and Behavior for Parked Against State Configuration BLF Key LED Icon and Behavior for Hold State Configuration BLF Key LED Icon and Behavior for DND State Configuration Supported BLF BLF List Key Behaviors Th...

Page 419: ...e blf enhanced idle led LEDg1000o The BLF BLF List DSS key field displays a green icon for 1000ms and then turns to white Note It works only if blf enhanced idle enable is set to 1 Enabled Permitted Values String Default Blank Parameter blf enhanced idle callin action y0000000000xx cfg Description It configures the behavior when pressing the BLF BLF list DSS key if the monitor is ringing and mon i...

Page 420: ...d DSS key Example blf enhanced callin led LEDg1000o The BLF BLF List DSS key field displays a green icon for 1000ms and then turns to white Note It works only if blf enhanced callin enable is set to 1 Enabled Permitted Values String Default Blank Parameter blf enhanced callin callin action y0000000000xx cfg Description It configures the behavior when pressing the BLF BLF list DSS key if the monito...

Page 421: ...tatus icon colors when the monitored user is call ing out This value uses the same macro action string syntax as an Enhanced DSS key Example blf enhanced callout led LEDg1000o The BLF BLF List DSS key field displays a green icon for 1000ms and then turns to white Note It works only if blf enhanced callout enable is set to 1 Enabled Permitted Values String Default Blank Parameter blf enhanced callo...

Page 422: ...ed y0000000000xx cfg Description It configures the custom BLF BLF List DSS key LED status icon colors when the monitored user is talk ing This value uses the same macro action string syntax as an Enhanced DSS key Example blf enhanced talking led LEDg1000o The BLF BLF List DSS key field displays a green icon for 1000ms and then turns to white Note It works only if blf enhanced talking enable is set...

Page 423: ...BLF List DSS key Default 0 Parameter blf enhanced parked led y0000000000xx cfg Description It configures the custom BLF BLF List DSS key LED status icon colors when a call is parked against the monitored phone This value uses the same macro action string syntax as an Enhanced DSS key Example blf enhanced parked led LEDg1000o The BLF BLF List DSS key field displays a green icon for 1000ms and then ...

Page 424: ...he monitored phone is placed on hold Parameter blf enhanced hold enable y0000000000xx cfg Description It enables or disables the custom configuration when the call on the monitored phone is placed on hold Permitted Values 0 Disabled 1 Enabled the phone will display the custom BLF BLF List DSS key LED status icon colors Default 0 Parameter blf enhanced hold led y0000000000xx cfg Description It conf...

Page 425: ...to initiate an intercom call The following table lists the parameter you can use to configure BLF key for Intercom Parameter features blf intercom_mode enable y0000000000xx cfg Description It enables or disables the phone to initiate an outgoing intercom call with a monitored user when pressing the BLF key Note To use this feature you also need to configure the intercom mode configured by the para...

Page 426: ...idle Monitoring SCA Phone The shared line is seized Flashing The shared line receives an incoming call Flashing The shared line is dialing The shared line is busy or is in a call The call on the shared line is placed on public hold Local SCA Phone Othe Phone The call on the shared line is placed on private hold The call on the shared line is barged in by the other shared line user In a multi party...

Page 427: ...d_line_callpull_code 1 MAC cfg Description It configures the call pull feature access code to retrieve an existing call from another shared phone that is in an active or public hold status Note It works only if account X shared_line is set to 1 Shared Call Appearance Permitted Values String within 99 characters Default Blank Web UI Account Advanced Call Pull Feature Access Code Parameter features ...

Page 428: ... Configuration Intercom Key Configuration You can configure an Intercom key to provide users the ability to initiate intercom calls directly to the specified con tact The following shows configuration for an Intercom key Line Key Configuration Programmable Key Configuration linekey X type 14 linekey X line 1 linekey X value 4603 linekey X label Bill programablekey X type 14 programablekey X line 1...

Page 429: ...ming call The monitored user is dialing The monitored user is talking The monitored user does not exist State Monitor for Intercom Contact Configuration The following table lists the parameters you can use to configure state monitor for intercom contact Parameter features intercom led enable y0000000000xx cfg Description It enables or disables the phone to display different intercom key icons when...

Page 430: ...efault Blank 1 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 Parameter features intercom allow y0000000000xx cfg Description It enables or disables the phone to answer an incoming intercom call Permitt...

Page 431: ...arning tone when answering an intercom call Note It works only if features intercom allow is set to 1 Enabled Permitted Values 0 Disabled 1 Enabled Default 1 Web UI Features Intercom Intercom Tone Phone UI Settings Features Intercom Intercom Tone Parameter features intercom barge y0000000000xx cfg Description It enables or disables the phone to answer an incoming intercom call while there is alrea...

Page 432: ...STA Control User Agent Computer Supported Telecommunications Applications uaCSTA is explained in detail in Using CSTA for SIP Phone User Agents uaCSTA and Services for Computer Supported Telecommunications Applications Phase III The uaCSTA feature on the phone may be used for remote control of the phone from computer applications such as PC softphone You can use the application to control the phon...

Page 433: ...ogs out of the registered account Register Failed When the IP phone fails to register an account Off Hook When the IP phone is off hook On Hook When the IP phone is on hook Incoming Call When the IP phone receives an incoming call Outgoing Call When the IP phone places a call Established When the IP phone establishes a call Terminated When the IP phone terminates a call Open DND When the IP phone ...

Page 434: ...s the action URL for all accounts when the forward mode is Custom the phone only sends the action URL for the cor responding account Transfer Call When the IP phone transfers a call Blind Transfer When the IP phone performs the blind transfer Attended Transfer When the IP phone performs the semi attended attended transfer Hold When the IP phone places a call on hold UnHold When the IP phone resume...

Page 435: ...ive_url The SIP URI of the current account when the IP phone places a call receives an incoming call or establishes a call active_user The user part of the SIP URI for the current account when the IP phone places a call receives an incoming call or establishes a call active_host The host part of the SIP URI for the current account when the IP phone places a call receives an incoming call or establ...

Page 436: ...erface Note It works only if static auto_provision custom protect is set to 1 Enabled The valid URI is http serverIPAddress filename variable name variable value Example http 10 82 21 10 Upload Cfg cfg_local Action URL Configuration The following table lists the parameters you can use to configure the action URL Parameter action_url setup_completed y0000000000xx cfg Description It configures the a...

Page 437: ...ers Default Blank Web UI Features Action URL Register Failed Parameter action_url off_hook y0000000000xx cfg Description It configures the action URL the phone sends when off hook Example action_url off_hook http 192 168 0 20 help xml IP ip Permitted Values URL within 511 characters Default Blank Supported Devices T58A VP59 Web UI Features Action URL Off Hook Parameter action_url on_hook y00000000...

Page 438: ...ng a call Example action_url call_established http 192 168 0 20 help xml IP ip Permitted Values URL within 511 characters Default Blank Web UI Features Action URL Established Parameter action_url dnd_on y0000000000xx cfg Description It configures the action URL the phone sends when DND feature is activated Example action_url dnd_on http 192 168 0 20 help xml IP ip Permitted Values URL within 511 c...

Page 439: ...n y0000000000xx cfg Description It configures the action URL the phone sends when the busy forward feature is activated Example action_url busy_fwd_on http 192 168 0 20 help xml IP ip Permitted Values URL within 511 characters Default Blank Web UI Features Action URL Busy Forward On Parameter action_url busy_fwd_off y0000000000xx cfg Description It configures the action URL the phone sends when th...

Page 440: ...fer Call Parameter action_url blind_transfer_call y0000000000xx cfg Description It configures the action URL the phone sends when performing a blind transfer Example action_url blind_transfer_call http 192 168 0 20 help xml IP ip Permitted Values URL within 511 characters Default Blank Web UI Features Action URL Blind Transfer Parameter action_url attended_transfer_call y0000000000xx cfg Descripti...

Page 441: ... URL within 511 characters Default Blank Parameter action_url unheld y0000000000xx cfg Description It configures the action URL the phone sends when a held call is resumed Example action_url unheld http 192 168 0 20 help xml IP ip Permitted Values URL within 511 characters Default Blank Parameter action_url mute y0000000000xx cfg Description It configures the action URL the phone sends when muting...

Page 442: ...s Action URL Terminated Parameter action_url busy_to_idle y0000000000xx cfg Description It configures the action URL the phone sends when changing the state of the IP phone from busy to idle Example action_url busy_to_idle http 192 168 0 20 help xml IP ip Permitted Values URL within 511 characters Default Blank Web UI Features Action URL Busy to Idle Parameter action_url idle_to_busy y0000000000xx...

Page 443: ...xample action_url reject_incoming_call http 192 168 0 20 help xml IP ip Permitted Values URL within 511 characters Default Blank Web UI Features Action URL Reject Incoming Call Parameter action_url answer_new_incoming_call y0000000000xx cfg Description It configures the action URL the phone sends when answering a new incoming call Example action_url answer_new_incoming_call http 192 168 0 20 help ...

Page 444: ...iption It configures the action URL the phone sends when the call waiting feature is enabled Example action_url call_waiting_on http 192 168 0 20 help xml IP ip Permitted Values URL within 511 characters Default Blank Web UI Features Action URL Call Waiting On Parameter action_url call_waiting_off y0000000000xx cfg Description It configures the action URL the phone sends when the call waiting feat...

Page 445: ...hin 511 characters Default Blank Web UI Features Action URL Cancel Call Out Parameter action_url remote_busy y0000000000xx cfg Description It configures the action URL the phone sends when the outgoing call is rejected Example action_url remote_busy http 192 168 0 20 help xml IP ip Permitted Values URL within 511 characters Default Blank Web UI Features Action URL Remote Busy Parameter action_url ...

Page 446: ...handling an HTTP or HTTPS GET request When receiving a GET request the phone will perform the specified action and respond with a 200 OK message A GET request may contain a variable named as key and a variable value which are separated by The valid URI format is http s phoneIPAddress servlet key variable value For example http 10 3 20 10 ser vlet key OK Note Yealink phones are compatible with othe...

Page 447: ...FY sip 3583 10 2 40 10 5062 SIP 2 0 Via SIP 2 0 UDP 10 2 40 27 5063 branch z9hG4bK4163876675 From sip 3586 10 2 1 48 tag 2900480538 To 3583 sip 3583 10 2 1 48 tag 490600926 Call ID 2923387519 10 2 40 10 CSeq 4 NOTIFY Contact sip 3586 10 2 40 27 5063 Max Forwards 70 User Agent Yealink T58 58 83 0 15 Event ACTION URI Content Type message sipfrag Content Length 6 Message Body key OK Variable Values L...

Page 448: ...Return idle screen directly MSG Press the MESSAGE key not applicable to CP960 phones HEADSET Press the HEADSET key not applicable to CP960 phones RD Redial the last dialed number not applicable to CP960 phones Reboot Reboot the phone AutoP Perform auto provisioning DNDOn Activate the DND feature Note It works only if features dnd allow is set to 1 Enabled DNDOff Deactivate the DND feature Note It ...

Page 449: ...m a blind transfer to xxx phonecfg get accounts x dnd x fw x Get firmware version registration DND or forward configuration information The valid value of x is 0 or 1 0 means you do not need to get con figuration information 1 means you want to get configuration inform ation Note The valid URI is http s phoneIPAddress ser vlet phonecfg get accounts x dnd x fw x Example http 10 3 20 10 servlet phon...

Page 450: ...s it works only if features fwd allow is set 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 Example http 10 10 20 10 servlet key NoAnswFwdOff CALLEND CallEnd End a call ASW CANCEL HOLD UNHOLD xxx Answer end hold unhold a call xxx refers to the call id of the active call Example http 10 10 20 10 servlet key ASW 33093...

Page 451: ... enable is set to 1 Enabled Permitted Values IP address Blank the phone will reject any HTTP GET request any the phone will accept and handle HTTP GET requests from any IP address Default Blank Web UI Features Remote Control Action URI Allow IP List Example Capturing the Current Screen of the Phone You can capture the screen display of the IP phone using the action URI The phones can handle an HTT...

Page 452: ... 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 Navigate to Directory Phone Call Info 2 Select the desired account from the Outgoing Identity drop down menu 3 Enter the callee s number in the Dial Number field 4 Click Dial to dial out the number...

Page 453: ...ccount X subscribe_mwi 1 MAC cfg Description It enables or disables the phone to subscribe to the message waiting indicator Permitted Values 0 Disabled the server automatically sends a message summary NOTIFY in a new dialog each time the MWI status changes This requires server support 1 Enabled the phone will send a SUBSCRIBE message to the server for message summary updates Default 0 Web UI Accou...

Page 454: ...ert to indicate that you have an unread voice mail message Permitted Values 0 Disabled 1 Enabled Default 1 Web UI Account Advanced Voice Mail Display Parameter features voice_mail_alert enable y0000000000xx cfg Description It enables or disables the phone to pop up the message when receiving the same amount of new voicemails Permitted Values 0 Disabled 1 Enabled Default 0 Parameter features voice_...

Page 455: ... HTTP POST messages from any server IP address or domain name Multiple addresses are separated by commas for example 10 1 4 3 10 1 4 23 Support asterisk wildcard each asterisk represents a field of the IP address 10 10 represents 10 10 0 0 to 10 10 255 255 Default Blank Web UI Features Remote Control Push XML Server IP Address Parameter push_xml block_in_calling y0000000000xx cfg Description It en...

Page 456: ...y0000000000xx cfg Description It configures the authentication password for the XML request Permitted Values String within 15 characters Default Blank Parameter push_xml username y0000000000xx cfg Description It configures the user name for the phone to authenticate with the push XML server Leave it blank if no authentication is required Permitted Values String Default Blank Web UI Features Remote...

Page 457: ...34 linekey X label Hot Desking programablekey X type 34 After provisioning a Hot Desking key is available on the phone You can tap the Hot Desking key to clear pre regis tration configurations of all accounts and register their own account on line 1 Related Topic Line Keys Configuration Programmable Keys Configuration Hot Desking Configuration You can specify available configurations for registrat...

Page 458: ...y_sip_server_enable y0000000000xx cfg Description It enables or disables the phone to provide an input field of SIP server on the hot desking login wizard when tapping the Hot Desking DSS key Permitted Values 0 Disabled 1 Enabled Default 0 Parameter hotdesking dsskey_outbound_enable y0000000000xx cfg Description It enables or disables the phone to provide an input field of the outbound server on t...

Page 459: ...ader Connected Line Identification Presentation COLP It allows the phones to display the identity of the connected party specified for outgoing calls The phones can display the Dialed Digits or the identity in a SIP header Remote Party ID P Asserted Identity or contact received or the identity in the From header carried in the UPDATE mes sage sent by the callee as described in RFC 4916 Connected l...

Page 460: ...bled the phone does not process the PPI header 1 Enabled the phone presents the caller identity from the PPI header Default 0 Parameter sip cid_source preference y0000000000xx cfg Description 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 tity PAI P Preferred Identity...

Page 461: ... Configuration The following table lists the parameters you can use to configure the return code for the refused call Parameter features normal_refuse_code y0000000000xx cfg Description It configures a return code and reason of SIP response messages when the phone rejects an incom ing call A specific reason is displayed on the caller s phone screen Permitted Values 404 Not Found 480 Temporarily Un...

Page 462: ...Codes feature enables the IP phone to display the feature name instead of the dialed feature access code automatically For example the dialed call park code will be replaced by the identifier Call Park when you park an active call The hide feature access codes feature is applicable to the following features l Voice Mail l Pick up l Group Pick up l Barge In l Retrieve l Call Park l Call Pull Topic ...

Page 463: ...IP call Default 0 Web UI Features General Information Accept SIP Trust Server Only 100 Reliable Retransmission As described in RFC 3262 the 100rel tag is for the reliability of provisional responses When presented in a Sup ported header it indicates that the phone can send or receive reliable provisional responses When presented in a Require header in a reliable provisional response it indicates t...

Page 464: ...und Trip Time RTT of transactions between a SIP client and SIP server Timer T2 Timer T2 represents the maximum retransmitting time of any SIP request message The re transmitting and doub ling of T1 will continue until the retransmitting time reaches the T2 value Example The user registers a SIP account for the IP phone and then set the value of Timer T1 Timer T2 respectively Timer T1 0 5 Timer T2 ...

Page 465: ...pport two refresher modes UAC and UAS Whether the endpoint functions as a UAC or a UAS depends on the UA that initiates the SIP request If the ini tiator is configured as UAC the other client or the SIP server will function as a UAS If the initiator is configured as UAS the other client or the SIP server will function as a UAC The session expiration is negotiated via the Session Expires header in ...

Page 466: ...sed For example if it is set to 1800 1800s the phone will refresh the session during a call every 900 seconds Note It works only if account X session_timer enable is set to 1 Enabled Permitted Values Integer from 90 to 7200 Default 1800 Web UI Account Advanced Session Expires 90 7200s Parameter account X session_timer refresher 1 MAC cfg Description It configures who refreshes the SIP session duri...

Page 467: ... Via SIP 2 0 UDP 10 3 20 6 5060 branch z9hG4bK1867789050 From 1010 sip 1010 23 10 2 1 48 5060 tag 1945988802 To sip 2 10 2 1 48 5060 Call ID 0_2336101648 10 3 20 6 CSeq 1 INVITE 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 ...

Page 468: ...formation via phone web user interface With this feature you can easily know which version of the CFG configuration file the IP phone is configured Topic CFG File Version Information Configuration CFG File Version Information Configuration The following table lists the parameters you can use to configure CFG file version information Parameter static auto_provision config_version com y0000000000xx ...

Page 469: ...e packet received by loopback mirror is re encoded based on the SDP nego tiation The re encoded content is returned to the loopback source as an RTP packet with payload type corresponding to the re encoding format 2 rtp pkt loopback the RTP payload is re encapsulated and the RTP packets are looped back with a new payload type and format This type of loopback applies to the encapsulated and direct ...

Page 470: ...y if sip pkt_loopback_mode is set to 1 encapsulated packet loopback Permitted Values Integer greater than 98 Default 112 Parameter sip pkt_loopback_directed_payload y0000000000xx cfg Description It configures the value of dynamic payload for the direct loopback RTP Note It works only if sip pkt_loopback_mode is set to 2 directed packet loopback Permitted Values Integer greater than 98 Default 113 ...

Page 471: ...e y0000000000xx cfg Description It configures the icon display mode when the corresponding BSFT feature is enabled on the phone Note It works only if bw enable and bw xsi enable are set to 1 Enabled Permitted Values 0 The phone does not display the corresponding icon This is the old user experience 1 Enabled the phone displays the corresponding icon when it requests the server to enable the cor re...

Page 472: ...erName Parameter features uc_password y0000000000xx cfg Description It configures the password for UC authentication Note It works only if bw xmpp enable is set to 1 Enabled Permitted Values String within 32 characters Default Blank Supported Devices All phones except CP960 Web UI Applications Broadsoft XMPP XMPP Account XMPP Password Parameter bw xmpp presence_icon mode y0000000000xx cfg Descript...

Page 473: ...vices All phones except CP960 Web UI Features General Information Enable Auto Favorite Parameter phone_setting uc_favorite_sequence_type y0000000000xx cfg Description It configures the order of UC Favorite keys to be assigned automatically Note It works only if phone_setting dsskey_directory_auto enable is set to 1 Enabled To assign Ext Key make sure the expansion module has been connected to the ...

Page 474: ... number of BroadCloud Buddy If it is set to other values for example 4 the entered number less than 4 digits would not match with the BroadCloud contact Example If there is a BroadCloud Buddy name Sunmy with the phone number 785656 and the parameter features uc_dir match_tail_number is set to 4 5656 85656 or 785656 would match Sunmy 785656 656 56 or 6 would not match Sunmy 785656 Permitted Values ...

Page 475: ...lications Broadsoft XSI XSI Account User ID Parameter account X xsi password 1 MAC cfg Description It configures the password for XSI authentication Note It works only if sip authentication_for_xsi is set to 0 User Login Credentials for XSI Authentic ation and bw xsi enable is set to 1 Enabled Permitted Values String within 99 characters Default Blank Web UI Applications Broadsoft XSI XSI Account ...

Page 476: ...bled the following features are unavailable on the phone BroadWorks Anywhere Remote Office Line ID Blocking Anonymous Call Rejection Simultaneous Ring Personal BroadSoft Directory BroadSoft Call Log Call Park Feature via XSI Mode Call Waiting Feature via XSI Mode Voice Messaging Video Voice Messaging Centralized Call Recording Executive and Assistant BroadWorks Mobility Group Night Forwarding Sile...

Page 477: ...o ACD Permitted Values 1 Available 2 Unavailable Default 1 Supported Devices T58A VP59 Parameter account X reason_code Y 1 2 MAC cfg Description It configures the unavailable code which must match one of the codes configured on the BroadWorks platform Permitted Values Integer from 1 to 2147483647 Default Blank Supported Devices T58A VP59 Parameter account X reason_code_name Y 1 2 MAC cfg Descripti...

Page 478: ...rks only if bw virtual_user 1 enable is set to 1 Enabled Permitted Values 0 Disabled 1 Enabled Default 0 Parameter bw virtual_user 1 xsi user MAC cfg Description It configures the user ID of virtual account for XSI access authentication Note It works only if bw xsi enable is set to 1 Enabled Permitted Values String within 99 characters Default Blank Parameter bw virtual_user 1 xsi password MAC cfg...

Page 479: ...g Description It configures the disposition code which must match one of the codes configured on BroadWorks Permitted Values Integer from 1 to 2147483647 Default Blank Parameter account X bw_disp_code_name Y 1 2 MAC cfg Description It configures the disposition code name which must match one of the names configured on BroadWorks Permitted Values String within 99 characters Default Blank 1 X is the...

Page 480: ...guest profile on the host phone Default 0 Parameter account X hoteling user_id 1 MAC cfg Description It configures the user ID used to log into the guest profile Permitted Values String within 99 characters Default Blank Parameter account X hoteling password 1 MAC cfg Description It configures the password used to log into the guest profile Permitted Values String within 99 characters Default Blan...

Page 481: ...nable 1 MAC cfg Description It enables or disables the phone to save login credentials automatically when logging into the guest profile Permitted Values 0 Disabled 1 Enabled Default 0 1 X is the account ID For VP59 T58A X 1 16 Broadsoft Flexible Seating Parameter account X flexible_seating enable 1 MAC cfg Description It enables or disables the flexible seating feature Note For the host it works ...

Page 482: ...e seating feature Note It works only if bw enable and account X flexible_seating enable are set to 1 Enabled If you disable this feature after enabling it all the saved user credentials are cleared Permitted Values 0 Disabled 1 Enabled Default 0 1 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 fe...

Page 483: ...mitted Values 0 Disabled 1 Enabled Default 1 Web UI Applications Broadsoft XSI Network Directory Personal Parameter bw_phonebook group_common_enable y0000000000xx cfg Description It enables or disables the phone to display the group common directory Note It works only if bw xsi directory enable is set to 1 Enabled Permitted Values 0 Disabled 1 Enabled Default 1 Web UI Applications Broadsoft XSI Ne...

Page 484: ...e Custom Directory Parameter bw_phonebook group_displayname y0000000000xx cfg Description It configures the display name on the phone screen for the group directory Note It works only if bw xsi directory enable and bw_phonebook group_enable are set to 1 Enabled Permitted Values String within 99 characters Default Group Web UI Applications Broadsoft XSI Network Directory Group Parameter bw_phoneboo...

Page 485: ... call_log enable is set to 1 Enabled Permitted Values 0 Disabled you will directly access the BroadSoft Call Log for the first account by default and you can only view the BroadSoft call log entry for the first account 1 Enabled you are allowed to select a specific account to access the BroadSoft Call Log and view the call log entry Default 0 Supported Devices T58A VP59 Parameter directory update_...

Page 486: ...scription It configures the call ID first name and last name display method when the phone receives an incom ing call places an outgoing call or is during an active call Permitted Values 0 First name Last name 1 Last name First name Default 0 Parameter bw calllog_and_dir y0000000000xx cfg Description It enables or disables the phone to directly enter the Network Calls screen when tapping for VP59 ...

Page 487: ... only if bw xsi enable is set to 1 Enabled Permitted Values 0 Disabled 1 Enabled Default 0 Supported Devices T58A VP59 Parameter bw voice_mail visual display_videomail enable y0000000000xx cfg Description It enables or disables the phone to display the video mails in the voice mail list Note It works only if bw xsi enable and bw voice_mail visual enable are set to 1 Enabled Permitted Values 0 Disa...

Page 488: ...Enabled Default 1 Parameter features auto_release_bla_line y0000000000xx cfg Description It enables or disables the server to release the connection by sending a notify message to phone when the SCA call is ended Permitted Values 0 Disabled the phone will send a notify message to the server to release the connection 1 Enabled Default 0 1 X is the account ID For VP59 T58A X 1 16 for CP960 X 1 Broad...

Page 489: ...ked against the monitored line Permitted Values 0 Disabled 1 Enabled Default 1 Web UI Features Pickup Park Audio Alert for BLF Parked Call Monitor Parameter features parked_call_monitor blf_visual_enable y0000000000xx cfg Description It enables or disables the phone to display a visual alert when a call is parked against the monitored line Permitted Values 0 Disabled 1 Enabled Default 0 Web UI Fea...

Page 490: ...ed the phone supports network hold and operator ring back for emergency calls Default 0 BroadSoft Call Waiting Sync Parameter call_waiting mode y0000000000xx cfg Description It configures the call waiting mode Note If it is set to 1 XSI it works only if bw xsi enable is set to 1 Enabled Permitted Values 0 Local 1 XSI the status of the call waiting feature between the IP phone and the BroadWorks se...

Page 491: ... ext_843 85 agent_location starbox_628 a 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 Note It works only if account X sip_server_type is set to 12 Star2Star and accoun t X acd unavailable_reason_enable is set to 1 Enabled Permitted Values String Default Blank Parameter account X acd available_url 1 MAC cf...

Page 492: ...to the Alcatel Lucent CTS only Permitted Values String within 32 characters Default Blank Case Scen ario The feature access code is 32 A your phone monitors party B number 8866 party B and party C is during the call Set the following blf whisper_barge_in_code 32 features blf show_callinfo enable 1 During the call of the monitored line long press the BLF key and press the Whisper BargeIn soft key t...

Page 493: ...et_fragment enable y0000000000xx cfg Description It enables or disables the fragmented packet sending Permitted Values 0 Disabled 1 Enabled Default 1 1 If you change this parameter the phone will reboot to make the change take effect SIP Settings Parameters Parameter account X compact_header_enable 1 MAC cfg Description It enables or disables the phone to support compact SIP header Permitted Value...

Page 494: ...outbound_proxy_enable to 1 Default 0 Parameter sip escape_characters enable y0000000000xx cfg Description It enables or disables the phone to convert ASCII code into corresponding symbol Permitted Values 0 Disabled 1 Enabled Default 1 Case Scen ario Target characters 5F escape character plus the ASCII characters 5F 1 If you want to convert the ASCII code set the following sip escape_characters ena...

Page 495: ...ddglobalprefix y0000000000xx cfg Description It enables or disables the phone to add a global prefix to the E 164 user parts in SIP URI Permitted Values 0 Disabled 1 Enabled the phone will automatically add a prefix to the number in the E 164 format when you dial using the SIP URI for example 862512345000 sip com Default 0 Parameter sip send_keepalive_by_socket y0000000000xx cfg Description It ena...

Page 496: ...to make the change take effect Call Settings Parameters Parameter phone_setting show_code403 y0000000000xx cfg Description It configures the display message on the phone screen when receiving a 403 message If it is left blank the phone will display the value sent from the server when receiving the 403 mes sage Permitted Values String within 99 characters Default Blank Parameter phone_setting incom...

Page 497: ...top left corner of the LCD screen Permitted Values 0 Disabled 1 Enabled Default 1 Parameter phone_setting incoming_call reject enable y0000000000xx cfg Description It enables or disables the user to manually reject an incoming call on the phone Permitted Values 0 Disabled the Reject soft key disappears from the incoming call screen pressing X Mute key tap the on hook key or using action URI to rej...

Page 498: ...ions services are separated by slashs Example app unavailable com google android onetimeinitializer com google android configupdater Permitted Values Software package name or APK file name or Application name Default Blank Parameter features hide_world_clock enable y0000000000xx cfg Description It enables or disables to hide the world clock Permitted Values 0 Disabled 1 Enabled the world clock ico...

Page 499: ...ter unify enable y0000000000xx cfg Description It enables or disables the Unify features Permitted Values 0 Disabled 1 Enabled Default 0 Case Scen ario Identify the Notify messages sent by the Unify server and synchronize the FWD DND feature with server ...

Page 500: ...eproduce the issue 4 Click Stop in the Export All Diagnostic Files field to stop the capture The system log level will be reset to 3 5 Click Export to open the file download window and then save the diagnostic file to your local system A diagnostic file named MAC DiagnoseInfo tar is successfully exported to your local system Note After exporting the diagnostic files you can create a ticket to desc...

Page 501: ...to 1 Enabled Permitted Values 0 Disabled 1 Enabled Default 0 Web UI Settings Configuration USB Auto Exporting Syslog Parameter static local_log level y0000000000xx cfg Description It configures the lowest level of local log information to be rendered to the MAC log file When you choose a log level it includes all events of an equal or higher severity level and excludes events of a lower severity l...

Page 502: ...meter stat ic auto_provision local_log backup upload_period Default 0 Parameter static auto_provision local_log backup upload_period y0000000000xx cfg Description It configures the period in seconds of the local log files uploads to the provisioning server or a spe cific server Note It works only if static auto_provision local_log backup enable is set to 1 Enabled Permitted Values Integer from 30 ...

Page 503: ...og files can be stored on the provisioning server or a specific server Permitted Values Integer from 200 to 65535 Default 1024 Parameter static auto_provision local_log backup bootlog upload_wait_time y0000000000xx cfg Description It configures the waiting time in seconds before the phone uploads the boot log file to the pro visioning server or a specific server after startup Permitted Values Inte...

Page 504: ...x Log File Size field 5 Click Confirm to accept the change 6 Reproduce the issue The log files are uploaded to your USB flash drive Viewing the Log Files You can verify whether you got the correct log through the following key fields l 0 emerg l 1 alert l 2 crit l 3 error l 4 warning l 5 notice l 6 info The default local log level is 3 The following figure shows a portion of a boot log file for ex...

Page 505: ...o configure syslog logging Parameter static syslog enable y0000000000xx cfg Description It enables or disables the phone to upload log messages to the syslog server in real time Permitted Values 0 Disabled 1 Enabled Default 0 Web UI Settings Configuration Syslog Enable Syslog Parameter static syslog server y0000000000xx cfg Description It configures the IP address or domain name of the syslog serv...

Page 506: ...ons 4 Warning warning conditions 5 Warning normal but significant condition 6 Informational informational messages Default 3 Web UI Settings Configuration Syslog Syslog Level Parameter static syslog facility y0000000000xx cfg Description It configures the facility that generates the log messages Note For more information refer to RFC 3164 Permitted Values 0 Kernel Messages 1 User level Messages 2 ...

Page 507: ...ted to the sys log server Permitted Values 0 Disabled 1 Enabled Default 0 Web UI Settings Configuration Syslog Syslog Prepend MAC Viewing the Syslog Messages on Your Syslog Server You can view the syslog file in the desired folder on the syslog server The location of the folder may differ from the syslog server For more information refer to the network resources The following figure shows a portio...

Page 508: ...advance Note The Reset local settings Reset non static settings Reset static settings Reset userdata local config option on the web user interface appears only if static auto_provision custom protect is set to 1 Topics Reset to Factory Configuration Resetting the IP phone to Default Factory Settings Resetting the IP phone to Custom Factory Settings Deleting the Custom Factory Settings Files Reset ...

Page 509: ...IP phone to custom factory settings Topic Custom Factory Configuration Custom Factory Configuration The following table lists the parameters you can use to configure a custom factory Parameter static features custom_factory_config enable y0000000000xx cfg Description It enables or disables the Custom Factory Configuration feature Permitted Values 0 Disabled 1 Enabled Import Factory Configuration i...

Page 510: ...erface 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 l Normal Export the packets file after stopping capturing l Enhanced Export the packets file while capturing Topics Capturing the Packets in Enhan...

Page 511: ...the phone can span data packets received from the Internet port to the PC port It is not applicable to CP960 phones Topic Span to PC Port Configuration Span to PC Port Configuration The following table lists the parameter you can use to configure span to PC port Parameter static network span_to_pc_port 1 y0000000000xx cfg Description It enables or disables the phone to span data packets received f...

Page 512: ...onfiguration Ping and Traceroute Diagnostics Procedure 1 From the web user interface click Network Diagnostics 2 Select Ping or Traceroute from the Command drop down menu 3 Enter an IP address or a URL for example 10 200 108 48 in the IP Address field 4 Click Start to start a ping You can also diagnose network via the phone user interface at the path Settings Features Diagnostics Net work Ping or ...

Page 513: ...is set to 1 Enabled Permitted Values Integer from 2 to 3600 Default 60 Parameter static features network_unavailable_test period y0000000000xx cfg Description It specifies a period of time in seconds to detect the network status when the network is unreachable Note It works only if static features network_test enable is set to 1 Enabled Permitted Values Integer from 2 to 3600 Default 30 Analyzing ...

Page 514: ...rovision custom protect is set to 1 Enabled Procedure 1 Navigate to Settings Configuration CFG Configuration 2 In the Export CFG Configuration File block click Export to open the file download window and then save the file to your local system Importing CFG Configuration Files to Phone You can import the configuration files from local to the phones via the web user interface The configuration file...

Page 515: ...nge take effect Device Status Available information on device status includes l General information IPv4 address or IPv6 address phone MAC address Machine ID Wi Fi MAC address firm ware version and warning l Network status IPv4 status or IPv6 status IP mode phone MAC address and Wi Fi MAC address and VLAN ID l Phone status product name hardware version firmware version product ID Firmware ID phone...

Page 516: ...rue the phone will reboot immediately The NOTIFY message is formed as shown NOTIFY sip user dsthost SIP 2 0 To sip user dsthost From sip sipsak srchost CSeq 10 NOTIFY Call ID 1234 srchost Event check sync reboot true Topic Notify Reboot Configuration Notify Reboot Configuration The following table lists the parameter you can use to configure notify reboot Parameter sip notify_reboot_enable y000000...

Page 517: ...960 IP Phones 514 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: ...ly l Ensure that your network switch or hub is operational l Ensure that the Wi Fi feature is disabled If your phone connects to the wireless network l If the network is secure ensure the entered password is correct l Ensure your gateway router enables the wireless network feature Solving the IP conflict problem Do one of the following l Reset another available IP address for the IP phone l Check ...

Page 519: ... PoE powered ensure that you are using a PoE compliant switch or hub The phone displays No Service The touch screen prompts No Service message when there is no available SIP account on the IP phone Do one of the following l Ensure that an account is actively registered on the phone at the path Settings Status Accounts l Ensure that the SIP account parameters have been configured correctly Phone Bo...

Page 520: ...Media Camera and Video Issues The video quality is bad l Ensure that the display device is with the suitable resolution l Check whether the packet has been lost l Ensure that camera settings are configured correctly such as brightness and white balance l Avoid high intensity indoor light or direct sunlight on the camera You cannot preview local video when the phone is idle If the camera is properl...

Page 521: ... phone and the wireless router is too far Firmware and Upgrading Issues Fail to upgrade the phone firmware Do one of the following l Ensure that the target firmware is not the same as the current firmware l Ensure that the target firmware is applicable to the IP phone model l Ensure that the current or the target firmware is not protected l Ensure that the power is on and the network is available ...

Page 522: ...boot 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 Source Device Source IP Source Port Destination Device Destination IP Destination Port Listen ing port Protocol Description of des tination port IP phones IP address of IP phones 2 65535 IP phone or voice gate way IP address of IP phone o...

Page 523: ... phones IP address of IP phones 1024 65535 PNP Server IP address of PNP server Default value 224 0 1 75 5059 UDP TCP Protocol port it is used to obtain the URL of updat ing file from PNP server Multipaging Multipaging 65000 65001 PC IP address of PC Determined by the des tination device IP phones IP address of IP phones 1 65535 TCP HTTP port default value 80 1 65535 TCP HTTP port default value 443...

Page 524: ... server User name identifies the account while register name matched with a password is for authentication purposes The display name is the caller ID that will be displayed on the callee s phone touch screen Server configurations may override the local ones On code and off code They are codes that the IP phone sends to the server when a certain action takes place On code is used to activate a feat...

Page 525: ...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 Capturing packets after you disable the RFC 2543 Hold feature SDP media connection address c 0 0 0 0 per RFC 3264 is used in the INVITE message when placing a call on hold ...

Page 526: ...ol SDP l RFC 3310 HTTP Digest Authentication Using Authentication and Key Agreement AKA l RFC 3311 The Session Initiation Protocol SIP UPDATE Method l RFC 3312 Integration of Resource Management and SIP l RFC 3313 Private SIP Extensions for Media Authorization l RFC 3323 A Privacy Mechanism for the Session Initiation Protocol SIP l RFC 3324 Requirements for Network Asserted Identity l RFC 3325 SIP...

Page 527: ... 4244 An Extension to the SIP for Request History Information l RFC 4317 Session Description Protocol SDP Offer Answer Examples l RFC 4353 A Framework for Conferencing with the SIP l RFC 4458 SIP URIs for Applications such as Voicemail and Interactive Voice Response IVR l RFC 4475 Session Initiation Protocol SIP Torture l RFC 4485 Guidelines for Authors of Extensions to the SIP l RFC 4504 SIP Tele...

Page 528: ...tiation Protocol Package for Voice Quality Reporting Event l draft ietf sip connect reuse 06 txt Connection Reuse in the Session Initiation Protocol SIP l draft ietf bliss shared appearances 15 txt Shared Appearances of a Session Initiation Protocol SIP Address of Record AOR To find the applicable Request for Comments RFC document go to http www ietf org rfc html and enter the RFC number Reading I...

Page 529: ...o Call is encrypted audio only Silent mode Phone Lock Received Calls Placed Calls Missed Calls Forwarded Calls Recording box is full A call cannot be recorded Recording starts successfully Recording cannot be started Recording cannot be stopped VPN is enabled Bluetooth mode is on Bluetooth headset is both paired and connected Bluetooth enabled mobile phone is both paired and connected ...

Page 530: ...mobile phone con nection failed Flashing Flashing Line key type is Mobile Account Bluetooth enabled mobile phone is con necting Line key type is BLF BLF List BLF BLF list idle state Line key type is BLF BLF List BLF BLF list ringing state Line key type is BLF BLF List BLF hold state Line key type is BLF BLF List BLF BLF list callout state Line key type is BLF BLF List BLF BLF list failed state Lin...

Page 531: ... Intercom intercom talking state Line key type is Intercom intercom failed state Line key type is DTMF Prefix Line key type is Local Group XML Group LDAP Line key type is XML Browser Line key type is Conference Line key type is Forward Line key type is Transfer Line key type is Hold Line key type is DND Line key type is Recall Line key type is Record URL Record Line key type is Record URL Record r...

Page 532: ...p Log out of the ACD system The shared line bridged line is idle Flashing Flashing The shared line receives ring back tone Flashing Flashing The shared line receives an incoming call The shared line is in conversation The shared line conversation is placed on public hold USB flash drive is detected High Definition Voice Screenshot captured Downloading file Uploading file Upcoming alarm Unread emai...

Page 533: ...ve phones in the star connection group n The number of the slave phones connected successfully is less than the maximum number of slave phones in a star connection group n indic ates the number of connected slave phones n All the slave phones in the star connection group are connected suc cessfully n indicates the number of connected slave phones Phone Warning Sharing Content Wireless Access Point...

Reviews: