Page 2
(3) Limitation of Liability Yealink and/or its respective suppliers are not responsible for the suitability of the information contained in this document for any reason. The information is provided “as is”, and Yealink does not provide any...
Page 3
The EULA for this product is available on the Yealink Support page for the product.
Page 4
GNU GPL INFORMATION Yealink IP phone firmware contains third-party software under the GNU General Public License (GPL). Yealink uses software under the specific terms of the GPL. Please refer to the GPL for the exact terms and conditions of the license.
Provision the phone with features and settings. Troubleshoot, update and maintain phones. The information detailed in this guide is applicable to the following Yealink devices running firmware version 83 or higher: T5 series IP phones, including T54S and T52S. ...
For more information on configuring and administering other Yealink products not included in this guide, refer to product support page at Yealink Technical Support. To access the latest Release Notes or other guides for Yealink IP phones, refer to the Document Download page for your phone at Yealink Technical Support.
Page 7
Introduction Convention Description Indicate that you need to select an item from a menu. For example, -> Settings->Basic Settings indicates that you need to select Basic Settings from the Settings menu.
Page 8
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones...
Typographic and Writing Conventions ..........................ii Table of Contents ................v Getting Started ................1 Requirements ....................................1 Yealink IP Phones in a Network ............................1 Initialization Process Overview ............................. 2 Loading the ROM File ..............................3 Configuring the VLAN ..............................3 Querying the DHCP (Dynamic Host Configuration Protocol) Server ............
Table of Contents Example: Deploying Phones from the Provisioning Server ................... 89 Firmware Upgrade ............... 91 Firmware for Each Phone Model ............................91 Firmware Upgrade Configuration ............................ 92 Phone Customization..............93 Language ....................................94 Supported Languages..............................94 Language Display Configuration ..........................95 Language Customization ............................
Page 12
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Time and Date ..................................123 Time Zone ..................................124 NTP Settings .................................. 127 DST Settings ................................... 130 Time and Date Manually Configuration ......................134 Time and Date Format Configuration ......................... 135 Date Customization Rule ............................
Page 13
Table of Contents Macro Action Strings ..............................184 EDK Configuration ............................... 188 EDK List Configuration ............................... 189 EDK Prompt Configuration ............................190 EDK Soft Keys Configuration ..........................192 Example: Configuring EDK List for a Line Key ....................197 Power Saving ..................................197 Power Saving Configuration ...........................
Page 14
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Call Log Configuration ................................ 240 Call Logs Backup ................................... 241 Directory ..................245 Local Directory ..................................245 Contact Avatars and Icons Picture Limit ......................245 Preparing the Tar Formatted File .......................... 246 Local Contact File Customization ..........................
Page 16
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Network Conference Configuration ........................349 USB Recording ..................................350 USB Recording Configuration ..........................350 Multicast Paging ..................................351 Multicast Paging Group Configuration ......................351 Multicast Listening Group Configuration ......................353 Multicast Paging Settings............................354 Audio Features ................
Page 17
Table of Contents Jitter Buffer ..................................389 DTMF ......................................392 DTMF Keypad ................................392 Transmitting DTMF Digit ............................393 Suppress DTMF Display ............................395 Transfer via DTMF ................................ 396 Local DTMF Tone ................................. 397 Voice Quality Monitoring (VQM) ............................ 397 RTCP-XR ...................................
Page 18
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Call Park and Retrieve ................................. 441 Call Park and Retrieve Configuration ........................442 Example: Setting Call Park and Retrieve in FAC Mode ................443 Example: Setting Call Park and Retrieve in Transfer Mode ................ 444 Automatic Call Distribution (ACD) ..........................
Page 19
Table of Contents XML Browser Configuration ............................ 508 Hot Desking ..................................... 510 Hot Desking Key Configuration ..........................511 Hot Desking Configuration ............................511 General Features ................ 513 Line Identification Presentation ............................513 CLIP and COLP Configuration..........................514 Return Code for Refused Call............................515 Return Code for Refused Call Configuration ....................
Page 20
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Broadsoft Network Directory ..........................540 Broadsoft Visual Voice Mail ............................. 546 Broadsoft SCA ................................546 Broadsoft Call Park ..............................548 Broadsoft Emergency Call ............................549 Call Waiting Sync ................................. 549 Start2Start ACD Parameters ............................. 550 Ethernet Interface MTU Parameter ..........................
Since the IP phone is a data terminal, digitized audio being just another type of data from its perspective, the phone is capable of vastly more than traditional business phones. Moreover, Yealink IP phones run the same protocols as your office personal computer, which means that you can develop many innovative...
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones There are many ways to set up a phone network using Yealink IP phones. The following shows an example of a network setup: Initialization Process Overview The initialization process of the IP phone is responsible for network connectivity and operation of the IP phone in your local network.
Getting Started Updating Firmware Downloading the Resource Files Loading the ROM File The ROM file resides in the flash memory of the IP phone. The IP phone comes from the factory with a ROM file preloaded. During initialization, the IP phone runs a bootstrap loader that loads and executes the ROM file.
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Updating Firmware If you define the access URL of firmware in the configuration file, the IP phone will download firmware from the provisioning server. If the MD5 value of the downloaded firmware file differs from that stored in the flash memory, the IP phone will perform a firmware update.
Phone Network Phone Network Yealink IP phones operate on an Ethernet local area network (LAN) or wireless network. You can configure the local area network to accommodate a number of network designs, which varies by organization and Yealink IP phones.
If you change this parameter, the IP phone will reboot to make the change take effect. X is the account ID. For T54S/T48S/T48G/T46S/T46G/T29G, X=1-16; for T52S/T42G/T42S, X=1-12; for T41P/T41S/T27P/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2; for T19(P) E2, X=1.
Page 28
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones T54S/T52S/T48S/T48G/T46S/T46G/T29G: Menu->Advanced (default password: admin)->Network->WAN Port->IPv4->Static IP->IP Address Phone UI T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2: Menu->Settings->Advanced Settings (default password: admin)->Network->WAN Port->IPv4->Static IPv4 Client->IP Address static.network.internet_port.mask Parameter <y0000000000xx>.cfg It configures the IPv4 subnet mask.
Page 29
Permitted Values 1-On, the IP phone will use manually configured static IPv4 DNS. Default Network->Basic->IPv4 Config->Static DNS Web UI T54S/T52S/T48S/T48G/T46S/T46G/T29G: Menu->Advanced (default password: admin) ->Network->WAN Port->IPv4->Type(DHCP)->Static DNS Phone UI T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2: Menu->Settings->Advanced Settings (default password: admin) ->Network->WAN Port->IPv4->DHCP IPv4 Client->Static DNS static.network.primary_dns...
Phone Network Parameters DHCP Option Description Specify the offset of the client's subnet in seconds Time Offset from Coordinated Universal Time (UTC). Specify a list of IP addresses for routers on the Router client’s subnet. Time Server Specify a list of time servers available to the client. Domain Name Specify a list of domain name servers available to Server...
DHCP Option 42, Option 2 and Option 100 Yealink IP phones support using the NTP server address offered by DHCP. DHCP option 42 is used to specify a list of NTP servers available to the client by IP address. NTP servers should be listed in order of preference.
Phone Network For T52S IP phones: SIP-T52S. For T48G IP phones: SIP-T48G. For T48S IP phones: SIP-T48S. For T46G IP phones: SIP-T46G. For T46S IP phones: SIP-T46S. For T42G IP phones: SIP-T42G. For T42S IP phones: SIP-T42S. For T41P IP phones: SIP-T41P. For T41S IP phones: SIP-T41S.
DHCP option 60 is used to identify the vendor and functionality of a DHCP client. You can set the format for option 60. Note The default vendor class ID is “yealink”. Topic DHCP Option 60 Configuration DHCP Option 60 Configuration The following table lists the parameter you can use to configure DHCP option 60.
Topics Supported DHCP Option for IPv6 DHCP Option 59 and Custom Option Supported DHCP Option for IPv6 The following table lists common DHCP options for IPv6 supported by Yealink IP phones. Parameters DHCP Option Description Specify a list of DNS servers available to the DNS Server client.
In addition to manual configuration, the IP phone also supports automatic discovery of VLAN via LLDP, CDP or DHCP. The assignment takes effect in this order: assignment via LLDP/CDP, manual configuration, then assignment via DHCP. For more information on VLAN, refer to VLAN Feature on Yealink IP Phones. Topics LLDP Configuration...
Permitted Integer from 1 to 3600 Values Default Network->Advanced->LLDP->Packet Interval (1~3600s) Web UI T54S/T52S/T48S/T48G/T46S/T46G/T29G: Menu->Advanced (default password: admin) ->Network->LLDP->Packet Interval Phone UI T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2: Menu->Settings->Advanced Settings (default password: admin) ->Network->LLDP->Packet Interval If you change this parameter, the IP phone will reboot to make the change take effect.
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones T54S/T52S/T48S/T48G/T46S/T46G/T29G: Menu->Advanced (default password: admin) ->Network->CDP->CDP Status Phone UI T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2: Menu->Settings->Advanced Settings (default password: admin) ->Network->CDP->CDP Status static.network.cdp.packet_interval Parameter <y0000000000xx>.cfg It configures the interval (in seconds) at which the IP phone sends the CDP (Cisco Discovery Protocol) request.
Page 43
Note: It works only if “static.network.vlan.internet_port_enable” is set to 1 (Enabled). Permitted Integer from 1 to 4094 Values Default Network->Advanced->VLAN->WAN Port->VID (1-4094) Web UI T54S/T52S/T48S/T48G/T46S/T46G/T29G: Menu->Advanced (default password: admin) ->Network->VLAN->WAN Port->VID Number Phone UI T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2: Menu->Settings->Advanced Settings (default password: admin) ->Network->VLAN->WAN Port->VID Number static.network.vlan.internet_port_priority...
Page 44
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Default Network->Advanced->VLAN->PC Port->Active Web UI T54S/T52S/T48S/T48G/T46S/T46G/T29G: Menu-> Advanced (default password: admin) ->Network->VLAN->PC Port->VLAN Status Phone UI T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2: Menu->Settings->Advanced Settings (default password: admin) ->Network->VLAN->PC Port->VLAN Status static.network.vlan.pc_port_vid <y0000000000xx>.cfg Parameter It configures the VLAN ID for the PC port.
If you change this parameter, the IP phone will reboot to make the change take effect. DHCP VLAN Yealink IP phones support VLAN discovery via DHCP. When the VLAN discovery method is set to DHCP, the IP phone will examine DHCP option for a valid VLAN ID. The predefined option 132 is used to supply the VLAN ID by default.
Wi-Fi feature enables you to connect the phones to the organization’s wireless network. The wireless network is more convenient and cost-effective than wired network. Wi-Fi feature is only applicable to T54S/T52S/T48S/T48G/T46S/T46G/T42S/T41S/T29G/T27G IP phones. When the Wi-Fi feature is enabled, the IP phone will automatically scan the available wireless networks.
Page 47
Default static.wifi.enable Parameter <y0000000000xx>.cfg It activates or deactivates the Wi-Fi mode. Note: It is only applicable to Description T54S/T52S/T48S/T48G/T46S/T46G/T42S/T41S/T29G/T27G IP phones. It works only if “static.wifi.function.enable” is set to 1 (Enabled). 0-Disabled Permitted Values 1-Enabled Default...
Page 48
It configures the profile name of the wireless network X for the IP phone. Description Note: It works only if “static.wifi.enable” is set to 1 (Enabled). It is only applicable to T54S/T52S/T48S/T48G/T46S/T46G/T42S/T41S/T29G/T27G IP phones. Permitted String within 32 characters Values...
Page 49
It configures the priority for the wireless network X for the IP phone. 5 is the highest priority, 1 is the lowest priority. Description Note: It works only if “static.wifi.enable” is set to 1 (Enabled). It is only applicable to T54S/T52S/T48S/T48G/T46S/T46G/T42S/T41S/T29G/T27G IP phones. Permitted Integer from 1 to 5 Values Default Network->Wi-Fi->Change Priority...
Page 50
It configures the password of the wireless network X. Note: It works only if “static.wifi.enable” is set to 1 (Enabled) and Description “static.wifi.X.security_mode” is set to WEP, WPA-PSK or WPA2-PSK. It is only applicable to T54S/T52S/T48S/T48G/T46S/T46G/T42S/T41S/T29G/T27G IP phones. Permitted String within 64 characters Values...
Page 51
It configures the EAP authentication mode of the wireless network X. Note: It works only if “static.wifi.enable” is set to 1 (Enabled) and Description “static.wifi.X.security_mode” is set to WPA-EAP or WPA2-EAP. It is only applicable to T54S/T52S/T48S/T48G/T46S/T46G/T42S/T41S/T29G/T27G IP phones. Permitted TTLS, PEAP or TLS Values...
Page 52
It configures the EAP authentication password of the wireless network X. Note: It works only if “static.wifi.enable” is set to 1 (Enabled) and Description “static.wifi.X.security_mode” is set to WPA-EAP or WPA2-EAP. It is only applicable to T54S/T52S/T48S/T48G/T46S/T46G/T42S/T41S/T29G/T27G IP phones. Permitted String within 64 characters Values...
Phone Network Real-Time Transport Protocol (RTP) Ports You can specify the IP phone’s RTP port range. Since the IP phone supports conferencing and multiple RTP streams, it can use several ports concurrently. The UDP port used for RTP streams is traditionally an even-numbered port.
IP connections traversing NAT gateways, typically required for client-to-client networking applications, especially for VoIP deployments. Yealink IP phones support three NAT traversal techniques: manual NAT, STUN and ICE. If you enable manual NAT and STUN, the IP phone will use the manually-configured external IP address for NAT traversal.
Page 55
Phone Network Account->Register->NAT Web UI T54S/T52S/T48S/T48G/T46S/T46G/T29G: Menu->Advanced (default password: admin)->Accounts->Account X->NAT Status T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2: Phone UI Menu->Settings->Advanced Settings (default password: admin)->Accounts->AccountX->NAT Status Note: Manual NAT cannot be configured via phone user interface. static.network.static_nat.enable Parameter <y0000000000xx>.cfg It enables or disables the manual NAT feature on the IP phone.
Page 56
Note: It works only if “static.sip.nat_stun.enable” is set to 1 (Enabled). Permitted IP Address or Domain Name Values Blank Default Network->NAT->STUN->STUN Server Web UI T54S/T52S/T48S/T48G/T46S/T46G/T29G: Menu->Advanced (default password: admin) ->Network->NAT->STUN Server Phone UI T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2: Menu->Settings->Advanced Settings (default password: admin) ->Network->NAT->STUN Server static.sip.nat_stun.port <y0000000000xx>.cfg Parameter It configures the port of the STUN (Simple Traversal of UDP over NATs) server.
Page 57
Phone Network 1-Enabled Default Network->NAT->ICE->Active Web UI static.sip.nat_turn.enable <y0000000000xx>.cfg Parameter It enables or disables the TURN (Traversal Using Relays around NAT) feature on the IP Description phone. 0-Disabled Permitted Values 1-Enabled Default Network->NAT->TURN->Active Web UI static.sip.nat_turn.server Parameter <y0000000000xx>.cfg It configures the IP address or the domain name of the TURN (Traversal Using Relays around NAT) server.
If you change this parameter, the IP phone will reboot to make the change take effect. Keep Alive Configuration Yealink IP phones can send keep-alive packets to the NAT device for keeping the communication port open. The following table lists the parameters you can use to configure keep alive.
Default Account->Advanced->Keep Alive Interval(Seconds) Web UI X is the account ID. For T54S/T48S/T48G/T46S/T46G/T29G, X=1-16; for T52S/T42G/T42S, X=1-12; for T41P/T41S/T27P/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2; for T19(P) E2, X=1. Rport Configuration Yealink IP phones support rport described in 3581.
Default Settings->SIP->TLS SIP Port Web UI Internet Port and PC Port Yealink IP phones support two Ethernet ports: Internet port and PC port. You can enable or disable the PC port on the IP phones. Topics Supported Transmission Methods Internet Port and PC Port Configuration...
Page 61
Parameter <y0000000000xx>.cfg It configures the transmission method of the Internet port. Note: For T54S/T52S/T48S/T48G/T46S/T46G/T42G/T42S/T40G/T29G/T27G/T23G IP Description phones, you can set the transmission speed to 1000Mbps/Auto Negotiation to transmit in 1000Mbps if the IP phone is connected to the switch supports Gigabit Ethernet.
If you change this parameter, the IP phone will reboot to make the change take effect. Yealink IP phones use OpenVPN to achieve VPN feature. To prevent disclosure of private information, tunnel endpoints must authenticate each other before secure VPN tunnel is established. After you configure VPN feature on the IP phone, the IP phone will act as a VPN client and uses the certificates to authenticate with the VPN server.
It enables or disables the OpenVPN feature on the IP phone. Description 0-Disabled Permitted Values 1-Enabled Default Network->Advanced->VPN->Active Web UI T54S/T52S/T48S/T48G/T46S/T46G/T29G: Menu->Advanced (default password: admin) ->Network->VPN->VPN Active Phone UI T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2: Menu->Settings->Advanced Settings (default password: admin) ->Network->VPN->VPN Active static.openvpn.url Parameter <y0000000000xx>.cfg It configures the access URL of the *.tar file for OpenVPN.
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Voice QoS In order to make VoIP transmissions intelligible to receivers, voice packets should not be dropped, excessively delayed, or made to suffer varying delay. DiffServ model can guarantee high-quality voice transmission when the voice packets are configured to a higher DSCP value.
Phone Network 802.1x Authentication Yealink IP phones support the following protocols for 802.1X authentication: EAP-MD5 EAP-TLS (requires Device and CA certificates, requires no password) EAP-PEAP/MSCHAPv2 (requires CA certificates) EAP-TTLS/EAP-MSCHAPv2 (requires CA certificates) EAP-PEAP/GTC (requires CA certificates) ...
Page 66
It configures the anonymous identity (user name) for 802.1X authentication. It is used for constructing a secure tunnel for 802.1X authentication. Description Example: static.network.802_1x.anonymous_identity = user@yealink.com Note: It works only if “static.network.802_1x.mode” is set to 2, 3, 4, 5, 6 or 7. Permitted String within 512 characters...
Page 67
Note: It works only if “static.network.802_1x.mode” is set to 1, 3, 4, 5, 6 or 7. Permitted String within 32 characters Values Blank Default Network->Advanced->802.1x->MD5 Password Web UI T54S/T52S/T48S/T48G/T46S/T46G/T29G: Menu->Advanced (default password: admin) ->Network->802.1x->MD5 Password Phone UI T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2: Menu->Settings->Advanced Settings (default password: admin) ->Network->802.1x->MD5 Password static.network.802_1x.root_cert_url Parameter <y0000000000xx>.cfg...
(HTTP and HTTPS) for communication between CPE and ACS (Auto Configuration Servers). The HTTP(S) messages contain XML-RPC methods defined in the standard for configuration and management of the CPE. For more information on TR-069, refer to Yealink TR-069 Technote. Topics Supported RPC Methods...
Phone Network RPC Method Description This method is used to read the attributes associated with GetParameterAttributes one or more CPE parameters. This method is used to modify attributes associated with SetParameterAttributes one or more CPE parameters. Reboot This method causes the CPE to reboot. This method is used to cause the CPE to download a specified file from the designated location.
Page 70
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Default Settings->TR069->Enable TR069 Web UI static.managementserver.username Parameter <y0000000000xx>.cfg It configures the user name for the IP phone to authenticate with the ACS (Auto Configuration Servers). Leave it blank if no authentication is required. Description Example: static.managementserver.username = tr69...
Page 71
Phone Network Example: static.managementserver.connection_request_username = accuser Permitted String within 128 characters Values Blank Default Settings->TR069->Connection Request Username Web UI static.managementserver.connection_request_password Parameter <y0000000000xx>.cfg It configures the password for the IP phone to authenticate the incoming connection requests. Description Example: static.managementserver.connection_request_password = acspwd Permitted String within 64 characters Values...
Page 72
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones...
You can use boot files, configuration files and resource files to configure phone features and apply feature settings to phones. You can create or edit these files using a text editor such as UltraEdit. You can ask the distributor or Yealink FAE for template files. You can also obtain the template files online: http://support.yealink.com/documentFront/forwardToDocumentFrontDisplayPage.
Page 74
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones can use the default boot template file “y000000000000.boot” to create MAC-Oriented boot file by making a copy and renaming it. Note You can select whether to use the boot file or not according to your deployment scenario. If you do not Configuration Files want to use the boot file, please go to Topics...
Page 75
The [$MODEL] can be added to specify settings for specific phone models. $MODEL represents the phone model name. The valid phone model names are: T54S, T52S, T48S, T48G, T46S, T46G, [$MODEL] T42S, T42G, T41P, T41S, T40P, T40G, T29G, T27P, T27G, T23P, T23G, T21P E2, T21 E2, T19P E2 and T19 E2.
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: Static: The parameters start with a prefix “static.”, for example, static.auto_provision.custom.protect. ...
Page 77
Phone Provisioning You can deploy and maintain a mass of Yealink IP phones automatically through configuration files stored in a provisioning server. Note For protecting against unauthorized access, you can encrypt configuration files. For more information on encrypting configuration files, refer to Encrypting and Decrypting Files.
Page 78
MAC CFG File Yealink supports two MAC CFG file: MAC-Oriented file and MAC-local CFG file, which are both named after the MAC address of the IP phone. For example, if the MAC address of an IP phone is 00156574B150, the name of MAC-Oriented CFG file is 00156574b150.cfg (lowercase), and the name of MAC-local CFG...
Page 79
Phone Provisioning Topics MAC-local CFG File Configuration Clearing MAC-local CFG File MAC-local CFG File Configuration By default, the MAC-local.cfg file is stored on the IP phone. You can configure the phone to upload this file to the provisioning server each time the file updates. The following table lists the parameters you can use to generate and upload the MAC-local CFG file.
Page 80
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Blank Default static.auto_provision.custom.upload_method Parameter <y0000000000xx>.cfg It configures the way the IP phone uploads the <MAC>-local.cfg file, <MAC>-calllog.xml file or <MAC>-contact.xml file to the provisioning server (for Description HTTP/HTTPS server only). 0-PUT Permitted Values 1-POST...
Page 81
The [$MODEL] can be added in front of configuration parameter to specify the value for specific phone models. $MODEL represents the phone model. The valid phone model names are: T54S, T52S, T48S, T48G, T46S, T46G, [$MODEL] T42S, T42G, T41P, T41S, T40P, T40G, T29G, T27P, T27G, T23P, T23G, T21P E2, T21 E2, T19P E2 and T19 E2.
Topic Supported Resource Files Supported Resource Files Yealink supplies some template of resource files for you, so you can directly edit the files as required. The following table lists the resource files Yealink supplies: Template File File Name...
For the phone running firmware version 83 or later, “specific_model.excluded_mode” determines which configuration files referenced in the boot file to be downloaded. Provisioning Methods Yealink provides two ways to provision your phones: Manual Provisioning: provisioning via the local phone user interface or web user interface. ...
Phone Provisioning Manual Provisioning Central Provisioning Provisioning Methods Priority There is a priority for configuration among the provisioning methods - settings you make using a higher priority provisioning method override settings made using a lower priority provisioning method. The precedence order for configuration parameter changes is as follows (highest to lowest): Note provisioning priority mechanism takes effect only if “static.auto_provision.custom.protect”...
Page 86
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones file containing phone’s current settings to your computer to make changes. Because features and configurations vary by phone models and firmware versions, options available on each page of the web user interface can vary as well. Note that the features configured via web user interface are limited.
Page 87
Status web page after accessing the web user interface. It is helpful to quickly log into the web user interface without entering the username and password in the login page. Yealink IP phones support domain name customization. You can use a custom domain name to access the web user interface.
Page 88
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Web Server Type Configuration Yealink IP phones support both HTTP and HTTPS protocols for accessing the web user interface. You can configure the web server type. Web server type determines access protocol of the web user interface. If you disable to access web user interface using the HTTP/HTTPS protocol, both you and the user cannot access the web user interface.
Page 89
Phone Provisioning Values 1-Enabled Default Network->Advanced->Web Server->HTTPS Web UI T54S/T52S/T48S/T48G/T46S/T46G/T29G: Menu->Advanced (default password: admin) ->Network->Web Server->HTTPS Status Phone UI T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2: Menu->Settings->Advanced Settings (default password: admin) ->Network->Web Server->HTTPS Status static.network.port.https Parameter <y0000000000xx>.cfg It configures the HTTPS port for the user to access the web user interface of the IP Description phone using the HTTPS protocol.
Page 90
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Importing CFG Configuration Files to Phone You can import the configuration files from local to the IP phones via the web user interface. The configuration files contain the changes for phone features, and these changes will take effect after importing.
Phone Provisioning Exporting CFG Configuration Files from Phone You can export the phone’s configuration file to local and make changes to the phone’s current feature settings. You can apply these changes to any phone by importing the configuration files via the web user interface.
Page 92
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones centralized provisioning method: Yealink IP phones can obtain the provisioning server address during startup. Then IP phones first download boot files and configuration files from the provisioning server, and then resolve and update the configurations written in configuration files.
Page 93
Phone Provisioning Permitted Integer from 1 to 300 Values Default Settings->Auto Provision->Attempt Expired Time(s) Web UI static.network.attempt_expired_time Parameter <y0000000000xx>.cfg It configures the timeout interval (in seconds) to transfer a file for HTTP/HTTPS connection. Description Note: It has a lower priority than the value defined by the parameter “static.auto_provision.attempt_expired_time”.
Page 94
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones contained in the configuration file and set to 1. If the IP phone reboots repeatedly after it is set to 1, you can try to set “static.auto_provision.power_on" to 0 (Off). 0-Disabled Permitted Values 1-Enabled...
Page 95
Phone Provisioning Settings->Auto Provision->Interval(Minutes) Web UI static.auto_provision.weekly.enable <y0000000000xx>.cfg Parameter It triggers the weekly feature to on or off. Description 0-Off Permitted Values 1-On, the IP phone will perform an auto provisioning process weekly. Default Settings->Auto Provision->Weekly Web UI static.auto_provision.weekly_upgrade_interval Parameter <y0000000000xx>.cfg It configures the time interval (in weeks) for the IP phone to perform auto provisioning.
Page 96
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Settings->Auto Provision->Inactivity Time Expire(0~120min) Web UI static.auto_provision.weekly.dayofweek <y0000000000xx>.cfg Parameter It configures the days of the week for the IP phone to perform auto provisioning weekly. Example: static.auto_provision.weekly.dayofweek = 01 If “static.auto_provision.weekly_upgrade_interval” is set to 0, it means the IP phone will Description perform auto provisioning every Sunday and Monday.
Page 97
Phone Provisioning with every reboot. 0-Off 1-On, the IP phone will perform auto provisioning at random between a starting time Permitted configured by the parameter "static.auto_provision.flexible.begin_time" and an ending Values time configured by the parameter "static.auto_provision.flexible.end_time" on a random day within the period configured by the parameter "static.auto_provision.flexible.interval".
Page 98
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones provisioning at the starting time. If it is set to a specific value greater than starting time configured by the parameter “static.auto_provision.weekly.begin_time”, the IP phone will perform auto provisioning at random between the starting time and ending time. If it is set to a specific value less than starting time configured by the parameter “static.auto_provision.weekly.begin_time”, the IP phone will perform auto provisioning at random between the starting time on that day and ending time in the next day.
Page 99
Phone Provisioning Permitted String within 64 characters Values Blank Default [1][2] static.autoprovision.X.code Parameter <y0000000000xx>.cfg It configures the activation code to trigger auto provisioning. The activation code can be numeric characters, special characters # * or a combination of them. Example: Description static.autoprovision.1.code = 123 static.autoprovision.2.code = **...
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones using download libraries mechanism. Note: It is only applicable to T41P/T42G IP phones. 0-Disabled, the IP phone resolves the access URL of the provisioning server using Permitted system mechanism. Values 1-Enabled Default static.auto_provision.dns_resolv_nretry Parameter...
Phone Provisioning Supported Provisioning Protocols Yealink IP phones support several transport protocols for provisioning: Trivial File Transfer Protocol (TFTP) File Transfer Protocol (FTP) Hyper Text Transfer Protocol – Secure (HTTPS) File Transfer Protocol – Secure (FTPS) ...
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Supported Provisioning Server Discovery Methods After the phone has established network settings, it must discover a provisioning server to obtain software updates and configuration settings. The IP phone supports the following methods to discover the provisioning server address: Zero Touch: Zero Touch feature guides you to configure network settings and the provisioning ...
Page 103
Phone Provisioning Values Default Settings->Auto Provision->Wait Time(1~100s) Web UI static.zero_touch.network_fail_wait_times <y0000000000xx>.cfg Parameter It configures the reconnection times when zero touch module fails to obtain network Description parameters. Permitted Integer from 1 to 2147483646 Values Default static.zero_touch.network_fail_delay_times Parameter <y0000000000xx>.cfg It configures the duration time (in milliseconds) of every reconnection when zero Description touch module fails to obtain network parameters.
Page 104
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones DHCP Provision Configuration You can select to use IPv4 or IPv6 custom DHCP option according to your network environment. The IPv4 or IPv6 custom DHCP option must be in accordance with the one defined in the DHCP server. The following table lists the parameters you can use to configure DHCP provision.
Page 105
Phone Provisioning Permitted String within 32 characters Values For T54S IP phones: T54S. For T52S IP phones: T52S. For T48G IP phones: T48G. For T48S IP phones: T48S. For T46G IP phones: T46G. For T46S IP phones: T46S. For T42G IP phones: T42G.
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Permitted URL within 511 characters Values Blank Default Settings->Auto Provision->Server URL Web UI static.auto_provision.server.username <y0000000000xx>.cfg Parameter It configures the user name for provisioning server access. Description Permitted String within 32 characters Values Blank Default...
Phone Provisioning Keeping User’s Personalized Settings after Auto Provisioning Generally, you deploy phones in batch and timely maintain company phones via auto provisioning, yet some users would like to keep the personalized settings (for example, ring tones, wallpaper or DSS keys) after auto provisioning.
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Auto Provisioning Flowchart for Keep User’s Personalized Configuration Settings The following shows auto provisioning flowchart for Yealink IP phones when a user wishes to keep user’s personalized configuration settings.
Phone Provisioning Example: Deploying Phones from the Provisioning Server After setting up your provisioning server(s), you can deploy your phone devices. The following example shows you how to use the boot and configuration files to deploy phones from the provisioning server. Procedure Create per-phone boot file and common boot file.
Page 110
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones 001565b09d886.boot For the phone with MAC 001565b09d886, it will download the file, and then Linekey.cfg 001565b09d886.cfg 001565b09d886.boot download files referenced in the file in sequence from the provisioning server. For the IP phones except MAC-specific phone, they will request to download the y000000000000.boot Linekey.cfg file, and then request to download the referenced files.
You can download the latest firmware online: http://support.yealink.com/documentFront/forwardToDocumentFrontDisplayPage. The following table lists the associated and latest firmware name for each IP phone model (X is replaced by the actual firmware version). IP Phone Model Firmware Name Example T54S/T52S 70.x.x.x.rom 70.83.0.10.rom (T5S firmware unified) T48S/T46S/T42S/T41S 66.x.x.x.rom 66.83.0.10.rom...
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones IP Phone Model Firmware Name Example T27G 69.x.x.x.rom 69.83.0.10.rom T23P/G 44.x.x.x.rom 44.83.0.10.rom T21(P) E2 52.x.x.x.rom 52.83.0.10.rom T19(P) E2 53.x.x.x.rom 53.83.0.10.rom Firmware Upgrade Configuration Before upgrading firmware, you need to know the following: Do not close and refresh the browser when the IP phone is upgrading firmware via web user ...
Phone Customization Phone Customization You can make the IP phone more personalized by customizing various settings. Topics Language Contrast Wallpaper Transparency Screen Saver Backlight Label Length for Line Key Display Label Alignment for Line/Ext Key Display Linekey Length in Short Page Switch Key Page Tips Time and Date...
Example: Setting a Custom Language for Phone Supported Languages You can ask the distributor or Yealink FAE for language packs. You can also obtain the language packs online: http://support.yealink.com/documentFront/forwardToDocumentFrontDisplayPage. The following table lists available languages and associated language packs supported by the phone user interface and the web user interface.
The following table lists the parameters you can use to configure language display. static.lang.gui Parameter <y0000000000xx>.cfg It configures the language used on the phone user interface. Description T54S/T52S/T48S/T46S/T42S/T41S/T40G/T29G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2: English, Chinese_S, Chinese_T, French_CA, French, German, Italian, Polish, Portuguese, Permitted Portuguese_LA, Spanish, Spanish_LA, Turkish, Russian or the custom language name. Values...
Language Customization You can customize the translation of the existing language on the phone user interface or web user interface. You can ask the distributor or Yealink FAE for language packs. You can also obtain the language packs online: http://support.yealink.com/documentFront/forwardToDocumentFrontDisplayPage. Note The new added language must be supported by the font library on the IP phone.
Page 117
Phone Customization Procedure Open the desired language template file (for example, 000.GUI.English.lang). Modify the characters within the double quotation marks on the right of the equal sign. Do not modify the item on the left of equal sign. The following shows a portion of the language pack “000.GUI.English.lang” for the phone user interface: Save the language pack and place it to the provisioning server.
Page 118
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Blank Default Language for Web Display Customization You can modify translation of an existing language or adding a new language for web display. You can also customize the translation of the note language pack. The note information is displayed in the icon of the web user interface.
Page 119
Phone Customization The following shows a portion of the language pack “1.English.js” for the web user interface: Save the language pack and place it to the provisioning server. Customizing a Language Pack for Note Display When you add a new language pack for the note, the note language pack must be formatted as “X.name_note.xml”...
Page 120
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones The following shows a portion of the note language pack “1.English_note.xml” for the web user interface: Save the note language pack and place it to the provisioning server. Custom Language for Web and Note Display Configuration If you want to add a new language (for example, Wuilan) to IP phones, prepare the language file named as “12.Wuilan.js”...
Phone Customization wui_lang.delete Parameter <y0000000000xx>.cfg It deletes the specified or all custom web language packs and note language packs of Description the web user interface. Permitted Y.name.js http://localhost/all or http://localhost/ Values Blank Default Example: Setting a Custom Language for Phone Display The following example shows configuration for uploading custom language files “015.GUI.English_15.lang”...
Wallpaper is a picture used as the background of the IP phone. The IP phone comes with a default picture. You can change it to a built-in picture or custom wallpaper from personal pictures. The wallpaper is only applicable to T54S/T52S/T48S/T48G/T46S/T46G/T29G IP phones and expansion module EXP50 (connected to the T54S/T52S IP phones).
Page 123
The following show wallpaper set on T48S/G IP phones: Note On T54S/T52S/T46S/T46G/T29G IP phones, the line and soft key labels display over the wallpaper picture. The following table lists the parameters you can use to change the wallpaper. phone_setting.backgrounds Parameter <y0000000000xx>.cfg...
The following table lists the parameter you can use to upload a custom picture. wallpaper_upload.url Parameters <y0000000000xx>.cfg It configures the access URL of the custom wallpaper picture. Description Note: It is only applicable to T54S/T52S/T48S/T48G/T46S/T46G/T29G IP phones. URL within 511 characters Permitted...
“wallpaper.jpg” Transparency The T54S/T52S/T48S/T48G IP phones display line keys and status bar transparently. If you use a custom picture with a color or complex background, it may affect the user’s experience. You can choose an appropriate transparency for DSS key labels and status bar on the idle screen as required.
IP phone. Description Note: It is also applicable when the DSS key list is unfolded on the T48S/T48G IP phone. It is only applicable to T54S/T52S/T48S/T48G IP phones. 0%, the DSS key labels and status bar are non-transparent. Permitted...
You can customize the screen saver file to configure the IP phone whether to display custom information (for example, notifications or company logo) on the screen saver. For T54S/T52S/T48S/T48G/T46S/T46G/T29G IP phones, the custom infomation is displayed on the built-in picture or custom pictures (if uploaded).
Page 128
The vertical distance between different lines. Specify which line to insert the image (configured by the Image element). For T48S/G IP phones: Integer from 0 to 11 YealinkIPPhoneCu For T54S/T52S/T46S/T46G/T29G IP phones: stomScreenSaver InsertImageLineNum Integer from 0 to 8 Note: It is only applicable to T54S/T52S/T48S/T48G/T46S/T46G/T29G IP phones.
Phone Customization Elements Attributes Description T54S/T52S/T46S/T46G/T29G/T27P/T27G IP phones support displaying up to 8 lines of contents; T42S/T42G/T41P/T41S/T23P/T23G/T21(P) E2/T19(P) E2 IP phones support displaying up to 4 lines of contents. Color is only applicable to T54S/T52S/T48S/T48G/T46S/T46G/T29G IP phones. Specify the display image source between...
It enables or disables the IP phone to display the clock and icons when the screen saver starts. Description Note: It works only if “screensaver.type” is set to 0 (System) or 1 (Custom). It is only applicable to T54S/T52S/T48S/T48G/T46S/T46G/T29G IP phones. Permitted 0-Disabled Values...
Page 131
It configures the type of screen saver to display. Description Note: It is only applicable to T54S/T52S/T48S/T48G/T46S/T46G/T29G IP phones. 0-System, the LCD screen will display the built-in picture. 1-Custom, the LCD screen will display the custom screen saver images (configured by the parameter “screensaver.upload_url ”).
Page 132
Example: Delete all custom screen saver images: screensaver.delete = http://localhost/all Description Delete a custom screen saver image (for example, Screencapture.jpg): gui_lang.delete = http://localhost/Screencapture.jpg Note: It is only applicable to T54S/T52S/T48S/T48G/T46S/T46G/T29G IP phones. Permitted http://localhost/all or http://localhost/name.(jpg/png/bmp) Values Blank Default screensaver.xml_browser.url <y0000000000xx>.cfg...
Default Adding a Screensaver Picture from a USB Flash Drive The T54S/T52S/T48S/T48G/T46S/T46G/T29G IP phone enables you to add a screensaver picture from a USB flash drive on their IP phones. You can navigate to Menu->USB->Browse Photo, preview pictures, and then set a desired picture as screensaver. After you set a picture in USB flash drive as screensaver, the picture is added to the Screensaver list.
The following table lists the parameters you can use to configure screen backlight brightness and time. phone_setting.active_backlight_level Parameter <y0000000000xx>.cfg It configures the intensity of the LCD screen when the phone is active. Description Note: It is applicable to the T54S/T52S/T48S/T48G/T46S/T46G/T29G/T27P/T27G IP phone. If expansion module is connected, the backlight on expansion module...
Page 135
(in seconds) to change the intensity of the LCD screen when the IP phone is inactive. Description Note: It is not applicable to T19(P) E2 IP phones. 0-Always On 1-Always Off (not applicable to T54S/T52S/T48S/T48G/T46S/T46G/T29G IP phones) 15-15s 30-30s Permitted 60-1min...
T54S/T48S/T48G/T46S/T46G/T29G IP phones. When label length feature is set to Default: When label length feature is set to Extended: For T54S/T46S/T46G/T29G IP phones, the display length of the line key label is extended and the characters are displayed in one line.
Parameter <y0000000000xx>.cfg It configures the label length displayed on the idle LCD screen for the line key. Description Note: It is only applicable to T54S/T48S/T48G/T46S/T46G/T29G IP phones. 0-Default Permitted 1-Extended Values 2-Mid Range (only applicable to T54S/T46S/T46G/T29G IP phones) Default Dsskey->Line Key->Label Length...
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones This feature is only applicable to T52S/T54S/T46S/T46G/T29G IP phones and expansion module EXP50 (connected to the T54S/T52S IP phones). The following figures show the line key label alignment on T46S/G IP phones:...
Phone Customization Topics Linekey Length Shorten Rules Linekey Length in Short Configuration Linekey Length Shorten Rules If you configure the phone to display 2 characters, the display will match the rules below: Label Short Label Description “Short Label” has higher priority than Configured “Label”.
If you want to configure line keys on pages 2 or 3 from the idle screen quickly, you can configure the line key in the right bottom to be a page switch key. It is only applicable to T54S/T52S/T46S/T46G/T42S/T42G/T41P/T41S/T29G/T27P/T27G IP phones. Topic...
Parameter <y0000000000xx>.cfg It enables or disables the page icon and page switch key LED to indicate different status of line keys on the non-current page. Description Note: It is only applicable to T54S/T52S/T46S/T46G/T42S/T42G/T41S/T41P/T29G/T27P/T27G IP phones. 0-Disabled Permitted Values 1-Enabled Default Dsskey->Line Key->Enable Page Tips...
Time and Date Yealink IP phones maintain a local clock. You can choose to get the time and date from SNTP (Simple Network Time Protocol) time server to have the most accurate time and set DST (Daylight Saving Time) to make better use of daylight and to conserve energy, or you can set the time and date manually.
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones DST Settings Time and Date Manually Configuration Time and Date Format Configuration Date Customization Rule Time Zone The following table lists the values you can use to set the time zone location. Time Time Time Zone Name...
Page 145
Phone Customization Time Time Time Zone Name Time Zone Name Zone Zone Belize East Africa Time Canada-Manitoba(Winnipeg) Iraq(Baghdad) Chile(Easter Islands) Russia(Moscow) Guadalajara St.Petersburg Monterrey Kuwait,Riyadh Mexico(Mexico City,Acapulco) Nairobi Saskatchewan Minsk United States-Central Time Volgograd (RTZ 2) Bogota,Lima +3:30 Iran(Teheran) Quito Armenia(Yerevan) Peru Azerbaijan(Baku)
Page 146
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Time Time Time Zone Name Time Zone Name Zone Zone Argentina(Buenos Aires) +5:45 Nepal(Katmandu) Brazil(no DST) Kazakhstan(Astana, Almaty) Brasilia Russia(Novosibirsk,Omsk) Cayenne,Fortaleza Bangladesh(Dhaka) Montevideo +6:30 Myanmar(Naypyitaw) Salvador +6:30 Yangon (Rangoon) Brazil(DST) Russia(Krasnoyarsk) -2:30 Newfoundland and Labrador Thailand(Bangkok)
Phone Customization Time Time Time Zone Name Time Zone Name Zone Zone Belgrade Guam,Port Moresby Bratislava Solomon Islands Ljubljana +10:30 Australia(Lord Howe Islands) Chad New Caledonia(Noumea) Copenhagen Chokurdakh (RTZ 10) West Central Africa Russia(Srednekolymsk Time) Poland(Warsaw) +11:30 Norfolk Island Spain(Madrid) New Zealand(Wellington,Auckland) Croatia(Zagreb) Fiji Islands...
Page 148
Note: It is only available to offset from Greenwich Mean Time GMT 0. 0-Disabled Permitted Values 1-Enabled Default Settings->Time & Date->DHCP Time Web UI T54S/T52S/T48S/T48G/T46S/T46G/T29G: Menu->Basic->Time & Date->DHCP Time Phone UI T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2: For Gray-Screen: Menu->Settings->Basic Settings->Time & Date->DHCP Time local_time.ntp_server1 Parameter <y0000000000xx>.cfg It configures the IP address or the domain name of the NTP server 1.
Page 149
NTP server 2. Permitted IP address or domain name Values pool.ntp.org Default Settings->Time & Date->Secondary Server Web UI T54S/T52S/T48S/T48G/T46S/T46G/T29G: Menu->Basic->Time & Date->General->SNTP Settings->NTP Server2 Phone UI T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2: Menu->Settings->Basic Settings->Time & Date->SNTP Settings->NTP Server2 local_time.interval Parameter <y0000000000xx>.cfg...
Auto DST File Attributes Customizing Auto DST File Auto DST File Customization Before customizing, you need to obtain the AutoDST file. You can ask the distributor or Yealink FAE for DST template. You can also obtain the DST template online: http://support.yealink.com/documentFront/forwardToDocumentFrontDisplayPage.
Page 151
Phone Customization Attributes Type Values Description the same) DST time type (This item is needed if optional 0: DST by Date iType you want to configure 1: DST by Week DST.) Month/Day/Hour (for iType=0) Month: 1~12 Day: 1~31 Hour: 0 (midnight)~23 Month/Week of Month/Day of Week/Hour of Day (for optional...
Page 153
Phone Customization It configures the Daylight Saving Time (DST) type. Description Note: It works only if the value of the parameter “local_time.summer_time” is set to 1 (Enabled). 0-DST by Date Permitted Values 1-DST by Week Default Settings->Time & Date->Fixed Type Web UI local_time.start_time Parameter...
It enables or disables the IP phone to obtain time and date from manual settings. Description 0-Disabled (obtain time and date from NTP server) Permitted Values 1-Enabled (obtain time and date from manual settings) Default Settings->Time & Date->Manual Time Web UI T54S/T52S/T48S/T48G/T46S/T46G/T29G: Menu->Basic->Time & Date->General->Manual Settings Phone UI T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2:...
1-Hour 24, the time will be displayed in 24-hour format (for example, 2:00 PM displays Values as 14:00). Default Settings->Time & Date->Time Format Web UI T54S/T52S/T48S/T48G/T46S/T46G/T29G: Menu->Basic->Time & Date->Time & Date Format->Time Format Phone UI T42S/T42G/T41S/T41P/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2: Menu->Settings->Basic Settings->Time & Date->Time & Date Format->Time Format local_time.date_format Parameters <y0000000000xx>.cfg...
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Default Settings->Time & Date->Date Format Web UI T54S/T52S/T48S/T48G/T46S/T46G/T29G: Menu->Basic->Time & Date->Time & Date Format->Date Format Phone UI T42S/T42G/T41S/T41P/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2: Menu->Settings->Basic Settings->Time & Date->Time & Date Format->Date Format lcl.datetime.date.format <y0000000000xx>.cfg Parameters It configures the display format of date.
The following table lists the parameter you can use to configure the idle clock display. phone_setting.idle_clock_display.enable <y0000000000xx>.cfg Parameter It enables or disables the IP phone to display the idle clock. Description Note: It is only applicable to T54S IP phones. 0-Disabled Permitted Values 1-Enabled Default Menu->Basic->Display->Idle Clock->Idle Clock Display...
Before uploading your custom logo to IP phones, ensure your logo file is correctly formatted. Customizing a Logo Picture Yealink IP phones only support the *.dob format logo picture. Yealink provides PictureExDemo tool to convert *.bmp format to *.dob format. You can ask the distributor or Yealink FAE for the PictureExDemo tool. Procedure...
It configures the logo shown on the LCD screen. Description Note: It is not applicable to T54S/T52S/T48S/T48G/T46S/T46G/T29G IP phones. 0-Off, the IP phone is not allowed to display a logo. 1-System Logo, the LCD screen will display the system logo.
It configures the access URL of the custom logo file. Note: It works only if the value of the parameter “phone_setting.lcd_logo.mode” is set Description to 2 (Custom Logo). It is not applicable to T54S/T52S/T48S/T48G/T46S/T46G/T29G IP phones. Permitted URL within 511 characters...
It configures whether to display contact avatar when it receives an incoming call, dials an outgoing call or engages in a call. Description Note: It is only applicable to T54S/T52S/T48S/T48G/T46S/T46G/T29G IP phones. 0-Never, do not display contact avatar no matter whether the contact avatar exists or Permitted 1-Always, display the customized contact avatar if it exists;...
Page 162
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Default phone_setting.called_party_info_display.enable <y0000000000xx>.cfg Parameter It enables or disables the IP phone to display the identity of the callee when it receives an incoming call. Description Note: The information display method is configured by the parameter “phone_setting.call_info_display_method”.
When the IP phone is on the pre-dialing or dialing screen, the account information will be displayed on the LCD screen. Yealink IP phones support three display methods: Label, Display Name and User Name. You can customize the account information to be displayed on the IP phone as required.
1-# key, the pound key is used as the send key. Values 2-* key, the asterisk key is used as the send key. Default Features->General Information->Key As Send Web UI T54S/T52S/T48S/T48G/T46S/T46G/T29G: Menu->Features->Others->General->Key As Send Phone UI T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2: Menu->Features->Key As Send features.send_pound_key <y0000000000xx>.cfg...
Phone Customization phone will dial out “##”. Default Features->General Information->Send Pound Key Web UI Softkey Layout Softkey layout is used to customize the soft keys at the bottom of the LCD screen for best meet users’ requirements. 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.
Page 166
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Call States Default Soft Keys Optional Soft Keys Forward Switch Silence Decline Reject Empty Empty Connecting Empty Empty End Call Connecting Transfer SemiAttendTrans Empty Empty (Transfer Empty Switch Connecting) End Call Empty Send Dialing...
Page 167
Phone Customization Call States Default Soft Keys Optional Soft Keys applicable to Send History T48S/G IP Delete Directories phones) Cancel Directories DialTransEmpty Empty (not applicable to T48S/G IP Empty History phones) Cancel Empty Empty Empty RingBack (Ring Back) Empty Switch End Call RingBack Transfer...
Page 168
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Call States Default Soft Keys Optional Soft Keys End Call Park GPark RTP Status Security Split Empty Hold Conferenced Switch Manager (not applicable to T48G/S IP phones) Mute End Call Split Empty Resume Switch...
Softkey Layout File Customization You can also configure the softkey layout using the softkey layout templates for different call states. You can ask the distributor or Yealink FAE for softkey layout template. You can also obtain the softkey layout template online: http://support.yealink.com/documentFront/forwardToDocumentFrontDisplayPage.
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones The following shows a portion of the softkey layout file “CallFailed.xml”: For each soft key that you want to disabled, just move the string from the enabled soft key list to disabled soft key list.
Page 171
Phone Customization Default Settings->Softkey Layout->Custom SoftKey Web UI phone_setting.custom_softkey.apply_to_states Parameter <y0000000000xx>.cfg It configures the desired call state to apply the custom softkey layout. To configure the call states 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 use the custom softkey layout.
Page 172
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones During auto provisioning, the IP phone connects to the provisioning server “192.168.1.20”, and downloads the CallFailed.xml file from the “XMLfiles” directory. Note: It works only if “phone_setting.custom_softkey_enable” is set to 1 (Enabled). Permitted URL within 511 characters Values...
Phone Customization not applicable to T48G/T48S IP phones. Permitted URL within 511 characters Values Blank Default custom_softkey_ring_back.url Parameter <y0000000000xx>.cfg It configures the access URL of the custom file for the soft key presented on the LCD screen in the RingBack state. Example: custom_softkey_ring_back.url = http://192.168.1.20/XMLfiles/RingBack.xml Description...
- Hebrew to your IP phone in advance. The changes in the “Hebrew_ime.txt” file becomes effective when the language is set to Hebrew. You can ask the distributor or Yealink FAE for keypad input method file. You can also obtain the keypad input method file online: http://support.yealink.com/documentFront/forwardToDocumentFrontDisplayPage.
Phone Customization Save the keypad input method file and place it to the provisioning server. Caution Do not rename the input method file. If you just want to customize the input method for a certain language, the filename must be formatted as “language name_ime.txt” (for example, German_ime.txt). Input Method Configuration The following table lists the parameters you can use to configure input method.
Page 176
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Blank Default gui_input_method.delete <y0000000000xx>.cfg Parameter It deletes the specified or all custom keypad input method files of the phone user interface. Delete all custom keypad input method files: Description gui_input_method.delete = http://localhost/all Delete a custom keypad input method file (for example, ime.txt) for the phone: gui_input_method.delete = http://localhost/ime.txt Permitted...
Phone Customization Values Default default_input_method.xml_browser_input_screen Parameter <y0000000000xx>.cfg It configures the default input method when the type for input box is set to “string” Description in the InputScreen object. Permitted Abc, 2aB, 123, abc or ABC Values Default phone_setting.virtual_keyboard.enable <y0000000000xx>.cfg Parameter It enables or disables the IP phone to use onscreen keyboard.
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Notification Popups Configuration The following table lists the parameters you can use to configure notification popups. features.voice_mail_popup.enable <y0000000000xx>.cfg Parameter It enables or disables the IP phone to pop up the message when it receives a new voice mail.
The following table lists the parameters you can use to configure power LED indicator. phone_setting.common_power_led_enable <y0000000000xx>.cfg Parameter It enables or disables the power LED indicator to be turned on. Description T54S/T52S/T48S/T48G/T46S/T46G/T42G/T42S/T41P/T41S/T40P/T40G/T29G/T2 7P/T27G/T23P/T23G/T21(P) E2 IP phones: Permitted 0-Disabled (power LED indicator is off) Values 1-Enabled (power LED indicator glows red)
Page 180
Parameter It enables or disables the power LED indicator to flash when the IP phone receives an Description incoming call. T54S/T52S/T48S/T48G/T46S/T46G/T42G/T42S/T41P/T41S/T40P/T40G/T29G/T2 7P/T27G/T23P/T23G/T21(P) E2 IP phones: 0-Disabled (power LED indicator does not flash) Permitted 1-Enabled (power LED indicator fast flashes (300ms) red)
Page 181
Parameter It enables or disables the power LED indicator to flash when a call is placed on hold or Description is held. T54S/T52S/T48S/T48G/T46S/T46G/T42G/T42S/T41P/T41S/T40P/T40G/T29G/T2 7P/T27G/T23P/T23G/T21(P) E2 IP phones: 0-Disabled (power LED indicator does not flash) Permitted 1-Enabled ( power LED indicator fast flashes (500ms) red)
Web UI Bluetooth Yealink IP phones support Bluetooth. You can pair and connect a Bluetooth headset or Bluetooth-Enabled mobile phone with the IP phone. After connecting the Bluetooth-Enabled mobile phone, you can choose to synchronize the mobile contacts to the IP phone. It is only applicable to T54S/T52S/T48S/T48G/T46S/T46G/T42S/T41S/T29G/T27G IP phones.
Page 183
Default features.bluetooth_enable Parameter <y0000000000xx>.cfg It triggers the Bluetooth mode to on or off. Note: It is only applicable to Description T54S/T52S/T48S/T48G/T46S/T46G/T42S/T41S/T29G/T27G IP phones. It works only if “static.bluetooth.function.enable” is set to 1 (Enabled). 0-Off Permitted Values 1-On Default Features->Bluetooth->Bluetooth Active...
If you change this parameter, the IP phone will reboot to make the change take effect. Handset/Headset/Speakerphone Mode Yealink IP phones support three ways to place/answer a call: using the handset, using the headset or using the speakerphone. You can disable the infrequently used audio device as required.
DSS keys. This section explains how to set these keys. Line key is not applicable to T19(P) E2 IP phones, ext key is only applicable to expansion modules connected to T54S/T52S/T48S/T48G/T46S/T46G/T29G/T27P/T27G IP phones. Note If the phone is downgraded to an earlier firmware from firmware version 83, the DSS key configuration will be reset after downgrading.
Phone Customization DSS Key Types DSS Key Types DSS Key Types (Line key/Ext key) (Programmable key) (Programmable key) DTMF New SMS Retrieve Park (Line key/Ext key) (Programmable key) (Line key/Ext key) Voice Mail Status Directory (Line key/Ext key) (Programmable key) Speed Dial Hot Desking Paging List...
Page 188
73-Custom Key (only available when 12-Voice Mail 35-URL Record “features.enhanced_dss_keys.enable=1”) 13-Speed Dial 77-Mobile Account (only applicable to 14-Intercom T52S/T54S IP phones when the Bluetooth-Enabled mobile phone is connected) Note: The permitted values are configurable by “linekey.type_range.custom”. T54S/T48S/T48G/T46S/T46G/T29G: X= 1-16; T52S/T42S/T42G: X = 1-12;...
Page 189
3, 4, 5, 6, 7, 8, 9, 11, 17, 18, 20, 22, 24, 25, 27, 34, 35, 38, 39, 40, 41, 42, 45, 50, 61, 66 or 73”. It is not applicable to T19(P) E2 IP phones. T54S/T48S/T48G/T46S/T46G/T29G: 1-16; T52S/T42S/T42G: 1-12;...
Page 190
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Menu->Features->DSS Keys->Line Key X->Label Phone UI linekey.X.shortlabel <y0000000000xx>.cfg Parameter It configures the short label displayed on the LCD screen. Description Note: It is only applicable to T52S IP phones. Permitted String within 99 characters Values Blank Default...
Page 191
1-Enabled, it prevents user from using line keys. Default [1] ] X is the line key ID. For T48G/T48S, X=1-29; for T54S/T46G/T46S/T29G, X=1-27; for T52S/T27P/T27G, X=1-21; for T42G/T42S/T41P/T41S, X=1-15; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2. Example: Setting a Line Key as Park/Retrieve Key...
Page 192
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones linekey.1.type = 10 linekey.1.value = 4603 linekey.1.label = Bill ######Set a Retrieve key#### linekey.3.type = 56 linekey.3.line = 1 linekey.3.value = 4603 linekey.3.label = Retrieve Bill After provisioning, you can easily press the Park key (line key 1) to park a call to a specific extension (4603) during a call, and press the Retrieve key (line key 3) to retrieve the parked call from the specific extension (4603) when the phone is idle.
Page 193
Phone Customization specific line (line 1). features.call_park.line_restriction.enable If the “ ” is set to 0 (Disabled), the IP phone will park/retrieve the call to the server on the current line in use. Note In Transfer call park mode, if you press the Park key when the phone is idle, the Park key will invoke the call park code.
Page 194
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones inekey.X.value If the “ ” is not assigned with a group pickup code, the Park key will invoke the group pickup features.pickup.group_pickup_code account.X.group_pickup_code code set by “ ” or ” ”. Example: Setting a Line Key as Forward Key When the phone receives an incoming call, you can press a Forward key to forward the incoming call to the preset number.
Phone Customization all calls to Bill (4603), you can press the line key 1 to deactivate always forward, or press line key 2 to switch the forward target and forward all calls to Tom (4605). Example: Setting a Line Key as BLF List key The following example shows configuration for a BLF List key.
Page 196
For T23P/T23G/T21(P) E2 IP phones, Cancel key can be configured only when “ ” is set to 0 (Disabled). For T54S/T52S/T48S/T48G/T46S/T46G/T42G/T42S/T41P/T41S/T40P/T40G/T29G/T27P/T27G/T19(P) E2 IP phones, Mute key can be configured only when “features.keep_mute.enable” is set to 0 (Disabled). The following table lists the parameters you can use to configure programmable keys.
Page 197
Phone Customization programablekey.type_range.custom Parameter <y0000000000xx>.cfg It configures the list for available programmable key types when configuring programmable keys. To assign function types, specify programmable key type IDs which start with 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”...
Page 198
Web UI programablekey.X.line Parameter <y0000000000xx>.cfg It configures the desired line to apply the programmable key feature. Description Note: It is not applicable to T19(P) E2 IP phones. T48G/T48S/T54S/T46G/T46S/T29G: 1-16; T52S/T42S/T42G: 1-12; Permitted T41S/T41P/T27P/T27G: 1-6; Values T40P/T40G/T23P/T23G: 1-3 T21(P) E2: 1-2 Default Dsskey>Programmable Key->Line...
Page 199
Values Default Dsskey->Programmable Key->Line Web UI [1]] X is the programmable key ID. For T54S/T48S/T48G/T46S/T46G, X=1-10, 12-14, 17-18; for T52S/T42G/T42S/T41P/T41S/T40P/T40G, X=1-10, 13, 17-18; for T29G/T27P/T27G, X=1-14, 17-18; for T23P/T23G/T21(P) E2, X=1-10, 14, 17-18; for T19(P) E2, X=1-9, 13, 14, 17-18.
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Ext Keys The ext keys take effect only if the expansion module is connected to the IP phone. It is only applicable to T54S/T52S/T48S/T48G/T46S/T46G/T29G/T27P/T27G IP phones. Topic Ext Keys Configuration Ext Keys Configuration The following table lists the parameters you can use to configure ext keys.
Page 201
Y=2-20, 22-40, default: 0 – NA, only for T29G/T27P/T27G Dsskey->Ext Key->Type Web UI expansion_module.X.key.Y.line Parameter <y0000000000xx>.cfg It configures the desired line to apply the ext key feature. Description Note: It is only applicable to T54S/T52S/T48S/T48G/T46S/T46G/T29G/T27P/T27G IP phones. T48G/T48S/T54S/T46G/T46S/T29G: 1-16; T52S/T42S/T42G: 1-12; Permitted T41S/T41P/T27P/T27G: 1-6; Values T40P/T40G/T23P/T23G: 1-3;...
Page 202
Parameter <y0000000000xx>.cfg It configures the label displayed on the LCD screen for a specific programmable key. This is an optional configuration. Description Note: It is only applicable to T54S/T52S/T48S/T48G/T46S/T46G/T29G/T27P/T27G IP phones. Permitted String within 99 characters Values Blank Default Dsskey->Ext Key->Label...
Web UI [1]] X is the expansion module ID, Y is the EXT key ID. For T54S/T52S, X=1-3, Y=1-60; for T48S/T48G/T46S/T46G, X=1-6, Y=1-40; for T29G/T27P/T27G, X=1-6, Y=1-20, 22-40. Enhanced DSS Keys Enhanced DSS Keys (EDK) enables users to customize the functions of a phone’s DSS keys. You can use EDK to assign frequently-used function to DSS keys or to create menu shortcuts to frequently-used phone settings as need.
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Macro Action Strings Before using EDK, you must be familiar with macro language shown in this section. The following table shows the basic macro action string syntax when creating EDK macros: Macro Action Description The digits to be sent.
Page 205
The softkey ID is case-insensitive. Example: $Sanswer$ means pressing the Answer soft key. Yealink IP phones support customizing soft keys. When invoking a custom soft key, the prefix “#” must be added. Example: If the custom softkey label is IVR1, the custom softkey id is custom_macro, then $S#custom_macro$ means pressing the IVR1 soft key.
Page 206
For T48S/T48G/T46S/T46G/T29G: X ranges from 1 to 40, Y ranges from 1 to 6; For T54S/T52S: X ranges from 1 to 60, Y ranges from 1 to 3; @Y can be omitted if there is only one expansion module connected to the phone.)
Page 207
Phone Customization Macro Action Description edk.id_mode.enable “ ” to 1 (Enabled) and then long press the Volume Up key when the phone is idle. The user input prompt string. Enable to prompt the pop-up box, specify the label for the input box, specify the maximum input characters, specify the character type for the input box, and specify whether to mask the input by the “*”.
By default, the EDK feature is disabled. Yealink IP phones support displaying the softkey ID or menu item ID by long pressing the Volume Up key. It is especially useful for those users who need to view the softkey ID or menu item ID when configuring EDK macros.
Phone Customization The following table lists the parameters you can use to configure EDK. features.enhanced_dss_keys.enable Parameter <y0000000000xx>.cfg It enables or disables the Enhanced DSS Keys (EDK) feature. Description 0-Disabled Permitted Values 1-Enabled Default edk.id_mode.enable Parameter <y0000000000xx>.cfg It enables or disables to view the softkey or menu item ID by long pressing the Volume Up key for three seconds on any screen.
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Default edk.edklist.X.mname <y0000000000xx>.cfg Parameter 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: Description edk.edklist.2.mname = macro2...
Page 211
Phone Customization Values 1-Enabled Default edk.edkprompt.X.label Parameter <y0000000000xx>.cfg It configures the prompt text to be displayed on the Enhanced DSS Keys (EDK) prompt X screen. If it is left blank, no prompt displays. Example: Description edk.edkprompt.1.label = Enter Password Note: It works only if the values of the parameters “features.enhanced_dss_keys.enable”...
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones visible-the entered text is visible. Permitted masked-the entered text displays as asterisk characters (*). It can be used to mask Values password fields. visible Default prompt X is the ID. X=1-10. EDK Soft Keys Configuration You can customize the soft keys as need.
Page 213
Phone Customization Default softkey.X.label <y0000000000xx>.cfg Parameter It configures the text displayed on the soft key label. Example: Description softkey.1.label = IVR1 Note: It works only if the values of the parameters “features.enhanced_dss_keys.enable” and “softkey.X.enable” are set to 1 (Enabled). Permitted String Values Blank...
Page 214
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Blank Default softkey.X.softkey_id <y0000000000xx>.cfg Parameter It configures the softkey id for custom soft key X. Example: Description softkey.1.softkey_id = custom_macro1 Note: It works only if the values of the parameters “features.enhanced_dss_keys.enable” and “softkey.X.enable” are set to 1 (Enabled). Permitted String Values...
Page 215
Phone Customization state. Note: It works only if the values of the parameters “features.enhanced_dss_keys.enable” and “softkey.X.enable” are set to 1 (Enabled). 0-Disabled Permitted Values 1-Enabled Default softkey.X.use.on_talk Parameter <y0000000000xx>.cfg It enables or disables the custom soft key X to be displayed in the talk state. Description Note: It works only if the values of the parameters “features.enhanced_dss_keys.enable”...
Page 216
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Default softkey.X.use.hold <y0000000000xx>.cfg Parameter It enables or disables the custom soft key X to be displayed in the hold state. Description Note: It works only if the values of the parameters “features.enhanced_dss_keys.enable”...
T54S/T52S/T48S/T48G/T46S/T46G/T29G IP phones and EXP50 expansion module (connected to the T54S/T52S IP 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...
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Topic Power Saving Configuration Power Saving Configuration You can enable or disable power saving, and set different idle timeout for office hours and off hours. Office Hour: specify the start time and end time of the day’s office hour. You can change the office ...
Page 219
Phone Customization backlight and screen, and the black-and-white screen phones will only turn off the backlight. Image persistence may be caused on LCD. 1-Enabled Default Settings->Power Saving->Power Saving Web UI features.power_saving.office_hour.idle_timeout Parameter <y0000000000xx>.cfg It configures the time (in minutes) to wait in the idle state before IP phone enter power-saving mode during the office hours.
Page 220
If it is set to 0 and “features.power_saving.power_led_flash.off_time” is not set to 0, the Description power LED indicator will be off when the IP phone enters the power-saving mode. Note: It is only applicable to T54S/T52S/T48S/T48G/T46S/T46G/T29G IP phones. Permitted 0, Integer from 100 to 10000...
Values 3000 Default USB Port Lock You can lock the USB port on T54S/T52S/T48S/T48G/T46S/T46G/T42S/T41S/T29G/T27G IP phones. The following features are not available when you disable the USB port: Adding a Wallpaper from a USB Flash Drive Adding a Screensaver Picture from a USB Flash Drive ...
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 template online: http://support.yealink.com/documentFront/forwardToDocumentFrontDisplayPage. Topics Search Source File Attributes...
1: Enabled. T19 T21 T23 T40 T27 T27G T29 T41 T42 T42S T41S T46 The applicable phone models of T46S T48 T48S T54S T52; the directory list. T29 T46 T46S T48 T48S T52 Note: Do not edit this field. T54S Customizing Search Source File Open the search source file.
Page 224
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones super_search.url Parameter <y0000000000xx>.cfg It configures the access URL of the super search template file. Example: Description super_search.url = http://192.168.1.20/super_search.xml During auto provisioning, the IP phone connects to the provisioning server “192.168.1.20”, and downloads the super search template file “super_search.xml”. Permitted URL within 511 characters Values...
Phone Customization It enables or disables the IP phone to automatically search entries from the remote Description phone book, and display results on the pre-dialing/dialing screen. 0-Disabled Permitted Values 1-Enabled Default search_in_dialing.remote_phone_book.priority Parameter <y0000000000xx>.cfg It configures the search priority of the remote phone book. Description Permitted Integer greater than or equal to 0...
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Topic Recent Call in Dialing Configuration Recent Call in Dialing Configuration The following table lists the parameter you can use to configure the recent call display in dialing. super_search.recent_call Parameter <y0000000000xx>.cfg It enables or disables Recent Call in Dialing feature.
Account Settings Account Settings This chapter shows you how to register accounts and configure account settings on Yealink IP phones. Topics Account Registration Outbound Proxy in Dialog Server Redundancy SIP Server Name Resolution Static DNS Cache Logon Wizard Multiple Line Keys per Account...
It enables or disables the user to use a specific account. Description 0-Disabled, the account is not available for the user. Permitted Values 1-Enabled Default Account->Register->Line Active Web UI T54S/T52S/T48S/T48G/T46S/T46G/T29G: Menu->Advanced (default password: admin)->Accounts->Account X->Activation Phone UI T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2: Menu->Settings->Advanced Settings (default password: admin)->Accounts->Activation account.X.label Parameter <MAC>.cfg It configures the label to be displayed on the LCD screen .
Page 229
It configures the user name for register authentication . Description Permitted String within 99 characters Values Blank Default Account->Register->Register Name Web UI T54S/T52S/T48S/T48G/T46S/T46G/T29G: Menu->Advanced (default password: admin)->Accounts->Account X->Register Name Phone UI T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2: Menu->Settings->Advanced Settings (default password: admin)->Accounts->Register Name account.X.user_name <MAC>.cfg Parameter It configures the register user name.
Page 230
Example: account.1.sip_server.1.address = 10.2.1.48 Permitted String within 256 characters Values Blank Default Account->Register->SIP Server Y->Server Host Web UI T54S/T52S/T48S/T48G/T46S/T46G/T29G: Menu->Advanced (default password: admin)->Accounts->Account X->SIP ServerY Phone UI T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2: Menu->Settings->Advanced Settings (default password: admin)->Accounts->SIP ServerY account.X.sip_server.Y.port <MAC>.cfg Parameter It configures the port of SIP server Y.
Page 231
1 (Enabled). Permitted IP address or domain name Values Blank Default Account->Register->Outbound Proxy Server Y Web UI T54S/T52S/T48S/T48G/T46S/T46G/T29G: Menu->Advanced (default password: admin)->Accounts->Account X->Outbound ProxyY Phone UI T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2: Menu->Settings->Advanced Settings (default password: admin)->Accounts->Outbound ProxyY account.X.outbound_proxy.Y.port <MAC>.cfg...
Integer greater than or equal to 0 Values Default X is the account ID. For T54S/T48S/T48G/T46S/T46G/T29G, X=1-16; for T52S/T42G/T42S, X=1-12; for T41P/T41S/T27P/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2; for T19(P) E2, X=1. Registration Settings Configuration The following table lists the parameters you can use to change the registration settings.
Page 233
Account Settings 0-Disabled Permitted Values 1-Enabled Default Account->Advanced->Send user=phone Web UI account.X.register_mac Parameter <MAC>.cfg It enables or disables the IP phone to add MAC address to the SIP header of the Description REGISTER message. 0-Disabled Permitted Values 1-Enabled Default Account->Advanced->SIP Send MAC Web UI account.X.register_line Parameter...
Page 234
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones It configures the type of the SIP server. Description 0-Default 2-BroadSoft (It works only if “bw.enable" is set to 1(Enabled)) Permitted 8-Genesys Values 10-Genesys Advanced 12-Star2Star Default Account->Advanced->SIP Server Type Web UI account.X.gruu.enable Parameter <MAC>.cfg...
Values Default X is the account ID. For T54S/T48S/T48G/T46S/T46G/T29G, X=1-16; for T52S/T42G/T42S, X=1-12; for T41P/T41S/T27P/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2; for T19(P) E2, X=1. If you change this parameter, the IP phone will reboot to make the change take effect.
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones It enables or disables the IP phone to send all SIP requests to the outbound proxy server mandatorily in a dialog. Description Note: It works only if “account.X.outbound_proxy_enable” is set to 1 (Enabled). 0-Disabled, only the new SIP request messages from the IP phone will be sent to the outbound proxy server in a dialog.
192.168.1.15. A fallback server offers less functionality than the working server. Yealink IP phones support Failover and Fallback server redundancy types. In some cases, you can deploy a combination of the two server redundancy types. For more information on server redundancy, refer to Server Redundancy on Yealink IP Phones.
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones When you initiate a call, the IP phone will go through the following steps to connect the call: Sends the INVITE request to the primary server. If the primary server does not respond correctly to the INVITE (that is, the primary server responds to the INVITE with 503 message or the request for responding with 100 Trying message times out (64*T1 seconds, defined in 3261)), then tries to make the call using the secondary server.
Page 239
Note: It is only applicable to outbound proxy servers. Permitted Integer from 0 to 65535 Values 3600 Default Account->Register->Proxy Fallback Interval Web UI T54S/T52S/T48S/T48G/T46S/T46G/T29G: Menu->Advanced (default password: admin)->Accounts->Account X->Proxy Fallback Interval Phone UI T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2: Menu->Settings->Advanced Settings->Accounts->Proxy Fallback Interval account.X.redundancy_with_reg_fail.enable Parameter <MAC>.cfg...
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Default X is the account ID. For T54S/T48S/T48G/T46S/T46G/T29G, X=1-16; for T52S/T42G/T42S, X=1-12; for T41P/T41S/T27P/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2; for T19(P) E2, X=1. Y is the server ID. Y=1-2.
Page 241
Account Settings account.1.sip_server.1.retry_counts= 3 The IP phone moves to the next available server after three failed attempts. Permitted Integer from 0 to 20 Values Default Account->Register->SIP Server Y->Server Retry Counts Web UI account.X.sip_server.Y.only_signal_with_registered Parameter <MAC>.cfg [1][2] It enables or disables the IP phone to only send requests to the registered server when encountering a failover.
Page 242
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones account.X.sip_server.Y.failback_timeout Parameter [1][2] <MAC>.cfg It configures the timeout (in seconds) for the IP 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 IP phone will not send requests to the primary server Description until a failover event occurs with the current working server.
Page 243
Account Settings attempts. Permitted Integer from 0 to 20 Values -1, the IP phone will invoke “account.X.sip_server.Y.retry_counts” to take effect. Default account.X.outbound_proxy.Y.only_signal_with_registered Parameter [1][2] <MAC>.cfg It enables or disables the IP phone to only send requests to the registered outbound proxy server when encountering a failover.
Page 244
Note: It works only if “account.X.outbound_proxy_enable” is set to 1 (Enabled). 0-Disabled Permitted Values 1-Enabled Default X is the account ID. For T54S/T48S/T48G/T46S/T46G/T29G, X=1-16; for T52S/T42G/T42S, X=1-12; for T41P/T41S/T27P/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2; for T19(P) E2, X=1. Y is the server ID. Y=1-2.
Account Settings 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 3263. The DNS query involves NAPTR, SRV and A queries, which allows the IP phone to adapt to various deployment environments.
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Values 1-TCP Default static.network.dns.query_timeout Parameter <y0000000000xx>.cfg It configures the interval (in seconds) at which the phone retries to resolve a domain Description name when the DNS server does not respond. Permitted 0 to 65535 Values Default...
Values 1-Use static DNS cache preferentially Default dns_cache_naptr.X.name <y0000000000xx>.cfg Parameter It configures the domain name to which NAPTR record X refers. Description Example: dns_cache_naptr.1.name = yealink.pbx.com Permitted Domain name Values Blank Default dns_cache_naptr.X.order Parameter <y0000000000xx>.cfg It configures the order of NAPTR record X.
Page 248
Integer from 0 to 65535 Values Default dns_cache_naptr.X.replace Parameter <y0000000000xx>.cfg It configures a domain name to be used for the next SRV query in NAPTR record X. Description Example: dns_cache_naptr.1.replace = _sip._tcp.yealink.pbx.com Permitted Domain name Values Blank Default dns_cache_naptr.X.service Parameter <y0000000000xx>.cfg It configures the transport protocol available for the SIP server in NAPTR record X.
Page 249
Account Settings dns_cache_srv.X.name Parameter <y0000000000xx>.cfg It configures the domain name in SRV record X. Description Example: dns_cache_srv.1.name = _sip._tcp.yealink.pbx.com Permitted Domain name Values Blank Default dns_cache_srv.X.port Parameter <y0000000000xx>.cfg It configures the port to be used in SRV record X. Description Example: dns_cache_srv.1.port = 5060...
Page 250
Integer from 30 to 2147483647 Values Default dns_cache_a.X.name Parameter <y0000000000xx>.cfg It configures the domain name in A record X. Description Example: dns_cache_a.1.name = yealink.pbx.com Permitted Domain name Values Blank Default dns_cache_a.X.ip Parameter <y0000000000xx>.cfg It configures the IP address that the domain name in A record X maps to.
Values 1-Enabled Default X is the account ID. For T54S/T48S/T48G/T46S/T46G/T29G, X=1-16; for T52S/T42G/T42S, X=1-12; for T41P/T41S/T27P/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2; for T19(P) E2, X=1. X is the record ID. X=1-12. If you change this parameter, the IP phone will reboot to make the change take effect.
Page 252
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones It enables or disables the IP phone to provide the logon wizard after startup when Description there is no registered account. 0-Disabled Permitted Values 1-Enabled Default Features->General Information->Logon Wizard Web UI hotdesking.startup_register_name_enable Parameter <y0000000000xx>.cfg...
Account Settings Default hotdesking.startup_outbound_enable <y0000000000xx>.cfg Parameter It enables or disables the IP phone to provide input field of outbound server on the logon wizard after startup when there is no registered account. Description Note: It works only if “phone_setting.logon_wizard” is set to 1 (Enabled). 0-Disabled Permitted Values...
Page 254
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Note: The number of the line keys is determined by “account.X.number_of_linekey”. It is not applicable to T19(P) E2 IP phones. 0-Disabled Permitted Values 1-Enabled Default Features->General Information->Auto Linekeys Web UI account.X.number_of_linekey Parameter <MAC>.cfg It configures the number of line keys to be assigned with a specific account from the...
If all line keys are seized, the current line key will be used. Blank Default X is the account ID. For T54S/T48S/T48G/T46S/T46G/T29G, X=1-16; for T52S/T42G/T42S, X=1-12; for T41P/T41S/T27P/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2. Auto Line Labels Rule Configuration When assigning multiple line keys per account, these automatically assigned line keys use its Account account.X.label...
Values {L}_{1} Default X is the account ID. For T54S/T48S/T48G/T46S/T46G/T29G, X=1-16; for T52S/T42G/T42S, X=1-12; for T41P/T41S/T27P/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2. Default Account If there are multiple accounts registered on the phone, the phone will use the default account to dial out by default.
Page 257
1-Account 1 2-Account 2 3-Account 3 … 16-Account 16 Description For T54S/T48S/T48G/T46S/T46G/T29G, accounts 1-16. For T52S/T42G/T42S, accounts 1-12. For T41P/T41S/T27P/T27G, accounts 1-6. For T40P/T40G/T23P/T23G, accounts 1-3. For T21(P) E2, accounts 1-2. Note: It is not applicable to T19(P) E2 IP phones.
Page 258
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones...
Call Log Call Log Yealink IP phones record and maintain phone events to a call log, also known as a call list. Call log consists of four lists: Missed Calls, Placed Calls, Received Calls, and Forwarded Calls. Each call log list supports up to 100 entries.
0-Disabled, the IP phone cannot log the placed calls, received calls, missed calls and Permitted the forwarded calls in the call lists. Values 1-Enabled Default Features->General Information->Save Call Log Web UI T54S/T52S/T48S/T48G/T46S/T46G/T29G: Menu->Features->Others->General->History Record Phone UI T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2: Menu->Features->History Setting->History Record account.X.missed_calllog Parameter <MAC>.cfg It enables or disables the IP phone to record missed calls.
Call Logs Backup Yealink IP 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 IP phone will automatically upload this file to the provisioning server or a specific server.
Page 262
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones address from the server during auto provisioning. The call log file is named after the MAC address of the IP phone. For example, if the MAC address of an IP phone is 00156574B150, the name of the call log file is 00156574b150-calllog.xml (lowercase). MAC address, a unique 12-digit serial number is assigned to each phone.
Page 263
Call Log <MAC>-calllog.xml file each time the call logs update. Note: It works only if “static.auto_provision.local_calllog.backup.enable” is set to 1 (Enabled) Permitted Integer from 10 to 600 Values Default static.auto_provision.custom.upload_method <y0000000000xx>.cfg Parameter It configures the way the IP phone uploads the <MAC>-local.cfg file, <MAC>-calllog.xml file or <MAC>-contact.xml file to the provisioning server (for Description HTTP/HTTPS server only).
Page 264
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones...
1000 contacts and 48 groups. Contacts and groups can be added either one by one, or in batch using a local contact file. Yealink IP phones support both *.xml and *.csv format contact files, but you can only customize the *.xml format contact file.
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones The contact avatar format must meet the following: Single Phone Model Format Resolution File Size T48S/T46S <=110*110 <=5MB .jpg/.png/.bmp/.jpeg T54S/T52S T48G/T46G/T29G <=110*110 <=5MB The contact icon format must meet the following: Phone Format Resolution Model T48S/G .jpg/.png/.bmp/.jpeg <=41*41...
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.
Page 268
-1 stands for Auto (the first registered line); 0~15 stand for line1~line16. Contact line vary by phone models: T54S/T48S/T48G/T46S/T46G/T29G: 0~15; T52S/T42S/T42G: 0~11; T41P/T41S/T27P/T27G: 0~5; T40P/T40G/T23P/T23G: 0~2; T21(P) E2: 0~1 Note: This is not applicable to T19(P) E2 IP phones. Specify a ringtone for this contact.
Resource: Custom avatar: default_photo custom avatar name Config: Note: It is only applicable to T54S/T52S/T48S/T48G/T46S/T46G/T29G IP phones. Specify a destination number for diverted calls. auto_divert Customizing Local Contact File Open the local contact file. <group display_name="" ring=""/> To add a group, add to the file.
Page 270
The format of the contact avatar must be *.png, *.jpg, *.bmp, *.jpeg. The contact avatar file should be uploaded to the provisioning server in advance. Description Example: local_contact.photo.url = tftp://192.168.10.25/Photo.jpg Note: It is not applicable to T54S/T52S/T48S/T48G/T46S/T46G/T29G IP phones. Permitted URL within 511 characters Values Blank Default local_contact.icon_image.url...
Page 271
The contact avatar file should be compressed as a TAR file in advance and then place it to the provisioning server. Description Example: local_contact.image.url = tftp://192.168.10.25/photo.tar Note: It is not applicable to T54S/T52S/T48S/T48G/T46S/T46G/T29G IP phones. Permitted URL within 511 characters Values Blank Default local_contact.data_photo_tar.url...
“<MAC>-contact.xml” from the backup path from the server and display the downloaded contacts in the local directory list. The contacts in the local contact file “contact.xml” downloaded from the provisioning server do not take effect. Local Contacts Backup Yealink IP phones support storing all local contacts to a contact file named <MAC>-contact.xml. You can...
Page 273
Directory back up this file to the server, avoiding data loss. Once the contacts update, the IP phone will automatically upload this file to the provisioning server or a specific server. If a contact file exists on the server, this file will be overridden. The IP phone will request to download the <MAC>-contact.xml file according to its MAC address from the server during auto provisioning.
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Permitted String Values Blank Default static.auto_provision.custom.upload_method Parameter <y0000000000xx>.cfg It configures the way the IP phone uploads the <MAC>-local.cfg file, <MAC>-calllog.xml file or <MAC>-contact.xml file to the provisioning server (for Description HTTP/HTTPS server only). 0-PUT Permitted Values...
Note: It works only if “local_contact.favorite.enable” is set to 1 (Enabled). To assign Ext Description key, make sure the expansion module has been connected to the phone in advance. It is only applicable to T54S/T52S/T48S/T48G/T46S/T46G/T29G/T27P/T27G IP phones. 0 - linekey->exp1 key->…->expN key 1 - exp1 key->…->expN key->linekey 2 - linekey page1->page1 from exp1 to expN->page2 from exp1 to...
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Open LDAP Directory Server Microsoft Active Directory Application Mode (ADAM) For more information on LDAP, refer to LDAP Directory on Yealink IP Phones. Topics LDAP Attributes LDAP Configuration LDAP Attributes The following table lists the most common attributes used to configure the LDAP lookup on IP phones.
Page 277
Directory 0-Prefix matching, the IP phone will search the LDAP contact numbers or names start with the entered character(s). Permitted Values 1-Approximate string matching, the IP phone will search the LDAP contact numbers or names contain the entered character(s). Default ldap.name_filter <y0000000000xx>.cfg Parameter...
Page 278
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Values Blank Default Directory->LDAP->LDAP Number Filter Web UI ldap.tls_mode <y0000000000xx>.cfg Parameter It configures the connection mode between the LDAP server and the IP phone. Description 0-LDAP—Unencrypted connection between LDAP server and the IP phone (port 389 is used by default).
Page 279
Directory ldap.base = dc=yealink,dc=cn Permitted String within 99 characters Values Blank Default Directory->LDAP->Base Web UI ldap.user Parameter <y0000000000xx>.cfg It configures the user name used to login the LDAP server. This parameter can be left blank in case the server allows anonymity to login.
Page 280
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Directory->LDAP->Max Hits (1~32000) Web UI ldap.name_attr <y0000000000xx>.cfg Parameter It configures the name attributes of each record to be returned by the LDAP server. It compresses the search results. You can configure multiple name attributes separated by spaces.
Page 281
Directory ldap.version Parameter <y0000000000xx>.cfg It configures the LDAP protocol version supported by the IP phone. The version must Description be the same as the version assigned on the LDAP server. Permitted 2 or 3 Values Default Directory->LDAP->Protocol Web UI ldap.call_in_lookup Parameter <y0000000000xx>.cfg It enables or disables the IP phone to perform an LDAP search when receiving an...
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones If the phone receives an incoming call from the phone number 0044123456789, it will search 0044123456789 from the LDAP sever first, if no result found, it will search +44123456789 from the server again. The phone will display all the search results. Note: It works only if “ldap.call_in_lookup”...
You can add multiple contacts at a time and/or share contacts between IP phones using the supplied template files (Menu.xml and Department.xml). You can ask the distributor or Yealink FAE for remote phone book template. You can also obtain the remote phone book template online: http://support.yealink.com/documentFront/forwardToDocumentFrontDisplayPage.
Page 284
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Template Element Valid Values and</Telephone> Add a contact department/group file: <MenuItem> Specify the department/group Department <Name> </Name> name between <Name> and Department URI <URL> </URL> </Name>; </MenuItem> Specify the department/group access URL between <URL> and</URL>...
Directory <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> 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 remote phone book. remote_phonebook.data.X.url <y0000000000xx>.cfg Parameter It configures the access URL of the remote phone book. Example: remote_phonebook.data.1.url = http://192.168.1.20/phonebook.xml Description...
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones remote_phonebook.display_name = Friends “Friends” will be displayed on the LCD screen at the path Menu->Directory. If it is left blank, "Remote Phone Book" will be the display name. Permitted String within 99 characters Values Blank Default...
Directory List File Customization Directory List Configuration Example: Configuring a Directory List Directory List File Customization You can ask the distributor or Yealink FAE for directory template. You can also obtain the directory template online: http://support.yealink.com/documentFront/forwardToDocumentFrontDisplayPage. Topics Directory List File Attributes...
Page 288
Common represents that the desired T19 T21 T23 T40 T27 T27G directory list is applicable to all T29 T41 T42 T42S T41S T46 IP phone models. T46S T48 T48S T52 T54S Note: Do not edit this field.
Directory Customizing Directory List File Open the directory list XML file. 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"/>...
Page 290
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones It enables or disables the users to access the call log list by pressing the Directory/Dir Description soft key. 0-Disabled Permitted Values 1-Enabled Default directory_setting.history.priority Parameter <y0000000000xx>.cfg It configures the display priority of the call log list. Description Permitted Integer greater than or equal to 0...
Directory Example: Configuring a Directory List The following example shows configuration for directory list. http://192.168.10.25 Customize the directory list file, and then place this file to the provisioning server “ ”. Example static.directory_setting.url = http://192.168.10.25/favorite_setting.xml After provisioning, you can press the Directory/Dir soft key to access the desired contact list quickly. Directory Search Settings You can configure how the phones search contacts and whether to highlight the matched keywords for contact searching.
Page 292
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones phone_setting.search.highlight_keywords.enable Parameter <y0000000000xx>.cfg It enables or disables the IP phone to highlight the matched characters in the search Description results. Note: It is only applicable to T54S/T52S/T48S/T48G/T46S/T46G/T29G IP phones. 0-Disabled Permitted Values 1-Enabled Default...
Call Features Call Features This chapter shows you how to configure call feature on Yealink IP phones. Topics Dial Plan Emergency Dialplan and Enhanced 911 Hotline Off Hook Hot Line Dialing Live Dialpad Auto Redial ReCall Configuration Speed Dial Password Dial...
Dial Plan Defined by Digit Map Dial Plan Defined by Four Patterns Yealink IP phones support four patterns: Replace rule: is an alternative string that replaces the numbers entered by the user. Yealink IP phones support up to 100 replace rules.
Page 295
Call Features Replace Rule Configuration Dial Now Configuration Area Code Configuration Block Out Configuration Example: Adding Replace Rules Using a Replace Rule File Basic Regular Expression Syntax for Four Patterns You need to know the following basic regular expression syntax when creating old dial plan: Regular Description expression...
Page 296
The replace rule file helps create multiple replace rules. At most 100 replace rules can be added to the IP phone. It is not applicable to T19(P) E2 IP phones. You can ask the distributor or Yealink FAE for replace rule file template. You can also obtain the replace rule file template online: http://support.yealink.com/documentFront/forwardToDocumentFrontDisplayPage.
Page 297
The dial now file helps create multiple dial now rules. At most 100 dial now rules can be added to the IP phone. It is not applicable to T19(P) E2 IP phones. You can ask the distributor or Yealink FAE for dial now file template. You can also obtain the dial now file template online: http://support.yealink.com/documentFront/forwardToDocumentFrontDisplayPage.
Page 298
Note: Multiple line IDs are separated by commas. It works only if the values of the parameters “dialplan.digitmap.enable” and “account.X.dialplan.digitmap.enable” are set to 0 (Disabled). It is not applicable to T19(P) E2 IP phones. 0 to 16 (for T54S/T48S/T48G/T46S/T46G/T29G) 0 to 12 (for T52S/T42G/T42S) Permitted...
Page 299
Note: Multiple line IDs are separated by commas. It works only if the values of the parameters “dialplan.digitmap.enable” and “account.X.dialplan.digitmap.enable” are set to 0 (Disabled). It is not applicable to T19(P) E2 IP phones. 0 to 16 (for T54S/T48S/T48G/T46S/T46G/T29G) Permitted 0 to 12 (for T52S/T42G/T42S)
Page 300
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones 0 to 3 (for T40P/T40G/T23P/T23G) 0 to 2 (for T21(P) E2) Blank Default Settings->Dial Plan->Dial Now->Account Web UI phone_setting.dialnow_delay Parameter <y0000000000xx>.cfg It configures the delay time (in seconds) for the dial now rule. When entered numbers match the predefined dial now rule, the IP phone will automatically dial out the entered number after the designated delay time.
Page 301
Note: Multiple line IDs are separated by commas. It works only if the values of the parameters “dialplan.digitmap.enable” and “account.X.dialplan.digitmap.enable” are set to 0 (Disabled). It is not applicable to T19(P) E2 IP phones. 0 to 16 (for T54S/T48S/T48G/T46S/T46G/T29G) 0 to 12 (for T52S/T42G/T42S) Permitted...
Page 302
Note: Multiple line IDs are separated by commas. It works only if the values of the parameters “dialplan.digitmap.enable” and “account.X.dialplan.digitmap.enable” are set to 0 (Disabled). It is not applicable to T19(P) E2 IP phones. 0 to 16 (for T54S/T48S/T48G/T46S/T46G/T29G) 0 to 12 (for T52S/T42G/T42S) Permitted...
Call Features Example dialplan_replace_rule.url = http://192.168.10.25/DialPlan.xml After provisioning, the rules defined in this file are added to the IP phone, and you can use the replace rules on the phone. Dial Plan Defined by Digit Map Digit maps, described in 3435, are defined by a single string or a list of strings.
Page 304
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones “123.T” would match “123”, “1233”, “12333”, “123333”, and so on. “x.T” would match an arbitrary number. “[x*#+].T” would match an arbitrary character. Note: If the string ends with a dot (for example, 123.), a match will occur immediately after inputting the characters before the dot (e., 123) since the dot allows for zero occurrences of the preceding construct.
Page 305
Call Features Digit Map for All Lines Configuration The following table lists the parameters you can use to configure digit map for all lines. dialplan.digitmap.enable <y0000000000xx>.cfg Parameter It enables or disables the digit map feature for the IP phone. Description Note: The value configured by the parameter “account.X.dialplan.digitmap.enable”...
Page 306
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones 10 seconds and then dials out 15 if no numbers entered; When you enter 153, it also matches part of two digit maps, the IP 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.
Page 307
Call Features It configures the behavior when an impossible digit map match occurs. Note: It works only if “dialplan.digitmap.enable” or Description “account.X.dialplan.digitmap.enable” is set to 1 (Enabled). The value configured by the parameter “account.X.dialplan.digitmap.no_match_action” takes precedence over that configured by this parameter. 0-prevent users from entering a number and immediately dial out the entered numbers 1-the dialing will fail and the LCD screen will prompt “Forbidden Number”...
Page 308
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones “account.X.dialplan.digitmap.enable” is set to 1 (Enabled). The value configured by the parameter “account.X.dialplan.digitmap.apply_to.directory_dial” takes precedence over that configured by this parameter. 0-Disabled Permitted Values 1-Enabled Default dialplan.digitmap.apply_to.history_dial <y0000000000xx>.cfg Parameter It enables or disables the digit map to be applied to the numbers (received calls or missed calls) dialed from call log lists.
Page 309
Call Features Values 1-Enabled Default dialplan.digitmap.apply_to.prefix_key Parameter <y0000000000xx>.cfg It enables or disables the phone to apply the predefined string of the digit map after pressing a Prefix key. Description Note: It works only if “dialplan.digitmap.enable” or “account.X.dialplan.digitmap.enable” is set to 1 (Enabled). 0-Disabled Permitted Values...
Page 310
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones takes precedence over that configured by the parameter “dialplan.digitmap.string”. Permitted String within 2048 characters Values Blank Default account.X.dialplan.digitmap.interdigit_long_timer Parameter <MAC>.cfg 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.
Page 311
Call Features Single configuration (configure a specific value for the timer letter “T” for all strings with “T” of the digit map) Example: account.1.dialplan.digitmap.interdigit_short_timer = 5 If “dialplan.digitmap.string” is set to <[2-9]x:86>3.T|0T, the IP phone will wait 5 seconds before matching the entered digits to this dial plan and placing the call. Distribution configuration (configure a string of positive integers separated by “|”...
Page 312
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones configured by the parameter “dialplan.digitmap.active.on_hook_dialing”. 0-Disabled Permitted Values 1-Enabled Blank Default account.X.dialplan.digitmap.apply_to.on_hook_dial Parameter <MAC>.cfg It enables or disables the entered number to match the predefined string of the digit map after pressing a send key on the pre-dialing screen or pressing the DSS key (for example, speed dial, BLF or prefix DSS key).
1-Enabled Blank Default X is the account ID. For T54S/T48S/T48G/T46S/T46G/T29G, X=1-16; for T52S/T42G/T42S, X=1-12; for T41P/T41S/T27P/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2; for T19(P) E2, X=1. Emergency Dialplan and Enhanced 911 You can dial the emergency telephone number (emergency services number) at any time when the IP phone is powered on and has been connected to the network.
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones 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 emergency 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.
Page 315
Parameter <y0000000000xx>.cfg It configures the account to be used to retrieve E911 location information. Description T54S/T48S/T48G/T46S/T46G/T29G: Integer from 1 to 16; T52S/T42S/T42G: Integer from 1 to 12; T41P/T41S/T27P/T27G: Integer from 1 to 6; Permitted Values T40P/T40G/T23P/T23G: Integer from 1 to 3;...
Page 316
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones It configures the port of emergency server X to be used for routing calls. Description Note: It works only if “dialplan.emergency.enable” is set to 1 (Enabled) and “dialplan.emergency.asserted_id_source” is not set to HELD. Permitted Integer from 1 to 65535 Values...
Page 317
Call Features “dialplan.emergency.asserted_id_source” is not set to HELD. Permitted a combination of digits 1, 2 and 3 Values 1, 2, 3 Default dialplan.emergency.held.server_url Parameter <y0000000000xx>.cfg It configures the Location Information Server URL for the IP phone to send HELD location request. Description Note: It works only if “dialplan.emergency.enable”...
Default is from 1 to 3. is from 1 to 255. X is the account ID. For T54S/T48S/T48G/T46S/T46G/T29G, X=1-16; for T52S/T42G/T42S, X=1-12; for T41P/T41S/T27P/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2; for T19(P) E2, X=1. Hotline Hotline, sometimes referred to as hot dialing, is a point-to-point communication link in which a call is automatically directed to the preset hotline number.
Note: Line key is not applicable to T19(P) E2 IP phones. Permitted String within 32 characters Values Blank Default Features->General Information->Hotline Number Web UI T54S/T52S/T48S/T48G/T46S/T46G/T29G: Menu->Features->Others->Hot Line->Hotline Number Phone UI T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2: Menu->Features->Hot Line->Hotline Number features.hotline_delay Parameter <y0000000000xx>.cfg It configures the waiting time (in seconds) for the IP phone to automatically dial out the preset hotline number.
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Values Default Features->General Information->Hotline Delay(0~10s) Web UI T54S/T52S/T48S/T48G/T46S/T46G/T29G: Menu->Features->Others->Hot Line->Hotline Delay Phone UI T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2: Menu->Features->Hot Line->Hotline Delay Off Hook Hot Line Dialing For security reasons, IP phones support off hook hot line dialing feature, which allows the phone to first dial out the pre-configured number when you lift the handset, press the Speakerphone key or desired line key, dial out a call using the account with this feature enabled.
Values Blank Default X is the account ID. For T54S/T48S/T48G/T46S/T46G/T29G, X=1-16; for T52S/T42G/T42S, X=1-12; for T41P/T41S/T27P/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2; for T19(P) E2, X=1. Live Dialpad Live Dialpad allows IP phones automatically dial out the entered phone number without pressing the send key after a designated period of time.
0-Disabled Permitted Values 1-Enabled Default Features->General Information->Auto Redial Web UI T54S/T52S/T48S/T48G/T46S/T46G/T29G: Menu->Features->Others->Auto Redial->Auto Redial Phone UI T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2: Menu->Features->Auto Redial->Auto Redial auto_redial.interval Parameter <y0000000000xx>.cfg It configures the interval (in seconds) for the IP phone to wait between redials.
Call Features T54S/T52S/T48S/T48G/T46S/T46G/T29G: Menu->Features->Others->Auto Redial->Redial Interval Phone UI T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2: Menu->Features->Auto Redial->Redial Interval auto_redial.times Parameter <y0000000000xx>.cfg It configures the auto redial times when the callee is temporarily unavailable. Description The IP phone tries to redial the callee as many times as configured till the callee answers the call.
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Programmable Keys Configuration Speed Dial Speed dial allows you to speed up dialing the contacts on the phone’s idle screen using dedicated DSS keys. Topic Speed Dial Key Configuration Speed Dial Key Configuration There are two ways to configure a Speed Dial key: Manually, configure a line key or programmable key as Speed Dial key.
Call Features The hidden digits are displayed as asterisks on the LCD screen. The number in placed call list is also partly displayed on the IP phone. This feature is especially useful for users who often places important and confidential calls. Topic Password Dial Configuration Password Dial Configuration...
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Blank Default Features->General Information->PswLength Web UI Call Timeout Call timeout defines a specific period of time after which the IP phone will cancel the dialing if the call is not answered. Topic Call Timeout Configuration Call Timeout Configuration...
The callee’s phone LCD screen presents “Anonymous” instead of the caller’s identity. Default Account->Basic->Anonymous ( “account.X.anonymous_call.server_base_only” must Web UI not be left blank) T54S/T52S/T48S/T48G/T46S/T46G/T29G: Menu->Features->Anonymous->Line X->Anonymous ( “account.X.anonymous_call.server_base_only” must not be left blank) Phone UI T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2: Menu->Features->Anonymous Call->Anonymous (“account.X.anonymous_call.server_base_only”...
Page 328
None ( “account.X.anonymous_call.server_base_only” must not be left blank) Web UI None ( “account.X.anonymous_call.server_base_only” must not be left blank) Phone UI X is the account ID. For T54S/T48S/T48G/T46S/T46G/T29G, X=1-16; for T52S/T42G/T42S, X=1-12; for T41P/T41S/T27P/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2; for T19(P) E2, X=1.
Call Features Call Number Filter Call number filter feature allows IP phone to filter designated characters automatically when dialing. Topic Call Number Filter Configuration Call Number Filter Configuration The following table lists the parameter you can use to configure call number filter. features.call_num_filter Parameter <y0000000000xx>.cfg...
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones It enables or disables to allow IP address call. Description Note: If you want to receive an IP address call, make sure “sip.trust_ctrl” is set to 0 (Disabled). 0-Disabled Permitted Values 1-Enabled Default Features->General Information->Allow IP Call...
Default Auto Answer Yealink IP phones support answer a SIP call or an IP address call automatically. Auto answer is configurable on a per-line basis, while IP address call is not. By default, the IP phones will not automatically answer the incoming call during a call or while dialing...
0-Disabled Permitted Values 1-Enabled, the IP phone can automatically answer an incoming call. Default Account->Basic->Auto Answer Web UI T54S/T52S/T48S/T48G/T46S/T46G/T29G: Menu->Features->Auto Answer->Line X->Auto Answer Phone UI T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2: Menu->Features->Auto Answer->Status features.ip_call.auto_answer.enable Parameter <y0000000000xx>.cfg It enables or disables the auto answer feature for IP call.
Page 333
Call Features the IP phone will automatically answer after you end the current call or cancel the Values dialing. 1-Enabled. The IP phone can only automatically answer the incoming call arrived when the phone is idle. If there is an incoming call arrived when the IP phone is in a call or dialing, you have to manually pick up the incoming call.
Values automatically answered, and then the other party cannot hear you. Default X is the account ID. For T54S/T48S/T48G/T46S/T46G/T29G, X=1-16; for T52S/T42G/T42S, X=1-12; for T41P/T41S/T27P/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2; for T19(P) E2, X=1. Anonymous Call Rejection Anonymous call rejection allows IP phone to automatically reject incoming calls from callers whose identity has been deliberately concealed.
Page 335
1-On Code, the IP phone will send anonymous rejection on code to the server when you activate the anonymous call rejection feature. Default Account->Basic->Send Anonymous Rejection Code Web UI T54S/T52S/T48S/T48G/T46S/T46G/T29G: Menu->Features->Anonymous->Line X->Send Rejection Code Phone UI T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2: Menu->Features->Anonymous Call->Send Rejection Code account.X.anonymous_reject_offcode...
You can enable call waiting feature and set the phone to play a warning tone to avoid missing important calls during a call. Yealink IP phones also support call waiting on code and off code to activate and deactivate server-side call waiting feature. They may vary on different servers.
Page 337
Values Blank Default Features->General Information->Call Waiting Off Code Web UI Menu->Features->Call Waiting->Off Code Phone UI X is the account ID. For T54S/T48S/T48G/T46S/T46G/T29G, X=1-16; for T52S/T42G/T42S, X=1-12; for T41P/T41S/T27P/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2; for T19(P) E2, X=1.
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Do Not Disturb (DND) DND feature enables the phone to reject all incoming calls automatically when you do not want to be interrupted. You can choose to implement DND locally on the phone or on the server-side. Usually, you can activate DND when the phone is idle.
Page 339
Call Features features.dnd_mode Parameter <y0000000000xx>.cfg It configures the DND mode for the IP phone. Description Note: It works only if “features.dnd.allow” is set to 1 (Enabled). It is not applicable to T19(P) E2 IP phones. 0-Phone, DND feature is effective for the phone system. Permitted Values 1-Custom, you can configure DND feature for each or all accounts.
DND mode is set by the parameter “ ”. Yealink IP phones also support DND on code and off code to activate and deactivate server-side DND feature. They may vary on different servers. Topics DND in Phone Mode Configuration...
Page 341
Call Features DND in Custom Mode Configuration DND in Phone Mode Configuration The following table lists the parameters you can use to configure DND in Phone mode. features.dnd.enable Parameter <y0000000000xx>.cfg It triggers the DND feature to on or off. Description Note: It works only if “features.dnd.allow”...
Page 342
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Values Blank Default Features->Forward&DND->DND->Off Code Web UI Menu->Features->DND->Off Code Phone UI DND in Custom Mode Configuration The following table lists the parameters you can use to configure DND in Custom mode. account.X.dnd.enable Parameter <MAC>.cfg...
Web UI Menu->Features->DND->AccountX->Off Code Phone UI X is the account ID. For T54S/T48S/T48G/T46S/T46G/T29G, X=1-16; for T52S/T42G/T42S, X=1-12; for T41P/T41S/T27P/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2. DND Synchronization for Server-side Configuration DND synchronization feature provides the capability to synchronize the status of the DND features between the IP phone and the server.
1-Enabled, DND is performed on both server side and locally. Blank Default X is the account ID. For T54S/T48S/T48G/T46S/T46G/T29G, X=1-16; for T52S/T42G/T42S, X=1-12; for T41P/T41S/T27P/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2. Multiple Call Appearances You can enable each registered line to support multiple concurrent calls. For example, you can place one call on hold, switch to another call on the same registered line, and have both calls displayed.
Values Blank Default X is the account ID. For T54S/T48S/T48G/T46S/T46G/T29G, X=1-16; for T52S/T42G/T42S, X=1-12; for T41P/T41S/T27P/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2. Call Hold Call hold provides a service of placing an active call on hold. It enables you to pause activity on an active call so that you can use the phone for another task, for example, to place or receive another call.
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones inactive (for example, a=sendonly). The other is 2543, which sets the “c” (connection addresses for the media streams) in the SDP to zero (for example, c=0.0.0.0). When you place an active call on hold or the call is held by remote parry, a call hold tone or held tone alerts you after a specific period of time that a call is still on hold or is still held by remote party.
Page 347
Call Features Default Features->General Information->Play Hold Tone Web UI features.play_hold_tone.delay Parameter <y0000000000xx>.cfg It configures the time (in seconds) to wait for the IP phone to play the initial call hold tone. If it is set to 30 (30s), the IP phone will wait 30 seconds to play the initial call hold tone Description after you place a call on hold.
Values 2-Display the Hold and Swap soft keys. Default X is the account ID. For T54S/T48S/T48G/T46S/T46G/T29G, X=1-16; for T52S/T42G/T42S, X=1-12; for T41P/T41S/T27P/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2. Music on Hold (MoH) Configuration When a call is placed on hold, the IP phone will send an INVITE message to the specified MoH server account according to the SIP URI.
T41P/T41S/T27P/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2; for T19(P) E2, X=1. Call Mute You can mute the microphone of the active audio device (handset, headset or speakerphone) on Yealink IP phones during an active call or when the phone is on the pre-dialing/dialing/calling/ringing screen.
1-Enabled, you are allowed to mute an active call, or activate the mute feature on the Values pre-dialing/dialing/calling/ringing screen. (Mute the microphone on the calling screen is only applicable to the T54S/T52S/T48S/T48G/T46S/T46G/T29G IP phones). Default Features->General Information->Allow Mute Web UI Keep Mute Keep mute, also known as persistent mute, allows you to keep the mute state persisting across call.
Call Features T54S/T52S/T48S/T48G/T46S/T46G/T42G/T42S/T41P/T41S/T40P/T40G/T29G/T27P/T27 G/T19(P) E2 IP phones. It works only if “features.allow_mute” is set to 1 (Enabled). 0-The mute feature is automatically deactivated when the active call ends. Permitted 1-The mute state is kept until you change the mute state manually or the phone Values restarts.
Page 352
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones 0-Disabled, call forward feature is not available to the users. Permitted Values 1-Enabled Default features.fwd_mode Parameter <y0000000000xx>.cfg It configures the call forward mode. Description Note: It is not applicable to T19(P) E2 IP phones. It works only if “feautes.fwd.allow” is set to 1 (Enabled).
Call Features Note: For Yealink IP phones, it works only if “features.fwd.allow” is set to 1 (Enabled). 0-Disabled Permitted Values 1-Enabled Default Features->General Information->Fwd International Web UI T54S/T52S/T48S/T48G/T46S/T46G/T29G: Menu->Advanced (default password: admin)->FWD International->FWD International Phone UI T42S/T42G/T41S/T41P/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2: Menu->Settings->Advanced Settings (default password: admin) ->FWD International->FWD International...
Page 354
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Yealink IP phones also support call forward on code and off code to activate and deactivate server-side call forward feature. They may vary on different servers. You can set a DSS key as a Forward key, and specify a contact you want to forward the incoming calls to for this key.
Page 355
Call Features The IP phone will send the always forward on code and the pre-configured destination number (configured by the parameter “forward.always.target”) to the server when you activate always forward feature on a phone basis. Note: It works only if “features.fwd.allow” and “forward.always.enable” are set to 1 and value of the parameter “features.fwd_mode”...
Page 356
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones It configures the destination number of the busy forward on a phone basis. Note: It works only if “features.fwd.allow” and “forward.busy.enable” are set to 1 and Description value of the parameter “features.fwd_mode” is set to 0 (Phone) (except T19(P) E2 IP phones).
Page 357
Call Features Menu->Features->Call Forward->Busy Forward->Off Code Phone UI forward.no_answer.enable Parameter <y0000000000xx>.cfg It triggers the no answer forward feature to on or off on a phone basis. Note: It works only if “features.fwd.allow” is set to 1 (Enabled) and value of the Description parameter “features.fwd_mode”...
Page 358
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones It configures the permitted values of the ring times (N) to wait before forwarding incoming calls. Example: Description features.forward.no_answer.show_ring_times = 0,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19 Note: It works only if “forward.no_answer.enable” or “account.X.timeout_fwd.enable” is set to 1 (Enabled). Permitted String within 512 characters Values...
Page 359
Call Features Note: It works only if “features.fwd.allow” and “forward.no_answer.enable” are set to 1 and value of the parameter “features.fwd_mode” is set to 0 (Phone) (except T19(P) E2 IP phones). Permitted String within 32 characters Values Blank Default Features->Forward&DND->Forward->No Answer Forward->Off Code Web UI Menu->Features->Call Forward->No Answer Forward->Off Code Phone UI...
Page 360
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones feature. The IP phone will send the always forward on code and the pre-configured destination number (configured by the parameter “account.X.always_fwd.target”) to the server when you activate always forward feature on the IP phone. Note: It works only if “features.fwd.allow”...
Page 361
Call Features It configures the destination number of the busy forward. Note: It works only if “features.fwd.allow” is set to 1 (Enabled) and value of the Description parameter “features.fwd_mode” is set to 1 (Custom). It is not applicable to T19(P) E2 IP phones.
Page 362
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Menu->Features->Call Forward->AccountX->Busy Forward->Off Code Phone UI account.X.timeout_fwd.enable <MAC>.cfg Parameter It triggers no answer forward feature to on or off. Note: It works only if “features.fwd.allow” is set to 1 (Enabled) and value of the Description parameter “features.fwd_mode”...
Web UI Menu->Features->Call Forward->AccountX->No Answer Forward->Off Code Phone UI X is the account ID. For T54S/T48S/T48G/T46S/T46G/T29G, X=1-16; for T52S/T42G/T42S, X=1-12; for T41P/T41S/T27P/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2. Call Forward Synchronization for Server-side Configuration Call forward synchronization feature provides the capability to synchronize the status of the call forward...
Page 364
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones If the call forward is activated in phone mode, the forward status changing locally will be synchronized to all registered accounts on server; but if the forward status of specific account is changed on server, the forward status locally will be changed.
1-Enabled, DND is performed on both server side and locally. Blank Default X is the account ID. For T54S/T48S/T48G/T46S/T46G/T29G, X=1-16; for T52S/T42G/T42S, X=1-12; for T41P/T41S/T27P/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2. Call Transfer Call transfer enables IP phones to transfer an existing call to a third party. For example, if party A is in an active call with party B, party A can transfer this call to party C (the third party).
Page 366
It enables or disables the users to transfer the current call to another existing call when there are multiple calls. Description Note: It is not applicable to T54S/T52S/T48S/T48G/T46S/T46G/T29G IP phones. 0-Disabled Permitted 1-Enabled, when the users press the Trans/Transfer soft key or TRAN/TRANSFER key, Values they can choose to transfer the current call to a new call or another existing call.
You can configure the transfer mode for the IP phone when transferring the current call via a specified DSS key. Yealink IP phones support three transfer modes: New Call, Blind Transfer and Attended Transfer. The transfer mode is applicable to the following DSS keys: Speed Dial key ...
T41P/T41S/T27P/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2; for T19(P) E2, X=1. Local Conference Configuration Local conference requires a host phone to process the audio of all parties. Yealink IP phones support up to 3 parties (including yourself) in a local conference call.
Call Features when pressing the Conf/Conference soft key, CONF key or conference DSS key Values during multiple calls. 1-Enabled Default features.local_conf.combine_with_one_press.enable Parameter <y0000000000xx>.cfg It enables or disables the IP phone to set up a three-way conference directly after the second party answers the call. Description Note: The CONF key is only applicable to T29G/T27P/T27G IP phones.
Default Account->Advanced->Conference URI Web UI X is the account ID. For T54S/T48S/T48G/T46S/T46G/T29G, X=1-16; for T52S/T42G/T42S, X=1-12; for T41P/T41S/T27P/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2; for T19(P) E2, X=1. USB Recording USB recording enables you to record audio calls to a USB flash drive connected to the IP phone. USB recording is only applicable to T54S/T52S/T48S/T48G/T46S/T46G/T42S/T41S/T29G/T27G IP phones.
Yealink IP phones support the following 31 channels: 0: Broadcasts are sent to channel 0. Note that the Yealink IP phones running firmware version 80 or earlier can be regarded as listening to channel 0. It is the default channel.
Page 372
= 3 multicast.paging_address.2.channel = 5 0-all the Yealink IP phones running firmware version 80 or earlier or Yealink IP phones listens to channel 0 or third-party available devices (for example, Cisco IP phones) in the paging group can receive the RTP stream.
Multicast Listening Group Configuration Yealink IP phones support up to 31 groups for listening. You can assign multicast IP address with channel for each group, and specify a label to each group to identify the phones in the group, such as All, Sales, or The following table lists the parameters you can use to configure multicast listening group.
1 to 25-the IP phone can receive an RTP stream of the pre-configured multicast Values address on the channel 1 to 25 respectively from Yealink or Polycom IP phones. 26 to 30-the IP phone can receive the RTP stream of the pre-configured multicast address on the channel 26 to 30 respectively from Yealink IP phones.
Page 375
Call Features call when DND is activated. 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 the incoming paging calls will be ignored when DND is activated in phone mode. Topic Multicast Paging Settings Multicast Paging Settings Configuration...
Page 376
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones 31-31 If it is set to other values, the IP phone will receive the incoming multicast paging call with a higher or equal priority and ignore the one with a lower priority when a voice call is in progress.
Page 377
Call Features Default multicast.receive.enhance_volume Parameter <y0000000000xx>.cfg It enables or disables the volume enhancement feature when receiving the multicast paging calls. Description Note: It works only if “multicast.listen_address.X.volume" is not set to 0. If the value the parameter "multicast.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 378
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones...
Audio Features Audio Features This chapter describes the audio sound quality features and options you can configure for the IP phone. Topics Alert Tone Ring Tones Distinctive Ring Tones Ringer Device Audio Volume Tones Audio Codecs Packetization Time (PTime) Early Media Headset Prior Dual Headset Acoustic Clarity Technology...
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Alert Tone Configuration The following table lists the parameters you can use to configure the alert tone. features.redial_tone <y0000000000xx>.cfg Parameter It configures that after you entering a specific number on the dialing screen, the IP phone will replay the dial tone.
Permitted Values 1-Enabled Default Features->Audio->Key Tone Web UI T54S/T52S/T48S/T48G/T46S/T46G/T29G: Menu->Basic->Sound->Key Tone Phone UI T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2: Menu->Settings->Basic Settings->Sound->Key Tone Ring Tones Ring tones are used to play for incoming calls. You can select a built-in systemdefault ring tone or a custom ring tone for the phone system or specific line registration.
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Custom Ringtone Limit The ring tone format must meet the following: Phone Model Format Single File Size Note T54S/T52S/T48S/T46S/T42S/T41 2MB of space should be .wav <=8MB S/T27G reserved for the phone 2.4MB of space should T48G/T46G/T29G .wav...
Page 383
Permitted Ring7.wav, Ring8.wav, Silent.wav, Splash.wav or custom ring tone name (for example, Values Customring.wav) Common Default Account->Basic->Ring Type Web UI T54S/T52S/T48S/T48G/T46S/T46G/T29G: Menu->Basic->Sound->Ring Tones->AccountX Phone UI T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2: Menu->Settings->Basic Settings->Sound->Ring Tones->AccountX ringtone.url Parameter <y0000000000xx>.cfg It configures the access URL of the custom ring tone file.
Values Ring1.wav Default X is the account ID. For T54S/T48S/T48G/T46S/T46G/T29G, X=1-16; for T52S/T42G/T42S, X=1-12; for T41P/T41S/T27P/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2; for T19(P) E2, X=1. Distinctive Ring Tones Distinctive ring tones allows certain incoming calls to trigger IP phones to play distinctive ring tones. The IP phone inspects the INVITE request for an "Alert-Info"...
Page 385
Audio Features MyMelodyRingN.wav) Alert-Info: <URL> Alert-Info: info=info text;x-line-id=0 Alert-Info: Bellcore-drN When the Alter-Info header contains the keyword “Bellcore-drN”, the IP phone will play the desired ring tone. The following table identifies the corresponding ring tone: Ring Tone Ring Tone Value of N (features.alert_info_tone = 1) (features.alert_info_tone = 0) Bellcore-dr1...
Page 386
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Minimum Nominal Maximum Bellcore Pattern Pattern Cadence Duration Duration Duration Tone (ms) (ms) (ms) Ringing 1800 2000 2200 2s On Bellcore-dr1( standard) Silent 3600 4000 4400 4s Off Ringing Long 1025 Silent...
Page 387
Audio Features Alert-Info: ringtone-2;x-line-id=1 Alert-Info: <http://10.1.0.31>;info=ringtone-2 Alert-Info: <http://127.0.0.1/ringtone-2> Alert-Info: MyMelody2 Alert-Info: MyMelodyRing2.wav Alert-Info: MyMelody2;x-line-id=1 Alert-Info: <http://10.1.0.31>;x-line-id=0;info=MyMelody2 The following table identifies the corresponding local ring tone: Value of N Ring Tone Ring1.wav Ring2.wav Ring3.wav Ring4.wav Ring5.wav Ring6.wav Ring7.wav Ring8.wav Silent.wav Splash.wav N<1 or N>10 Ring1.wav Alert-Info: <URL>...
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Alert-Info: info=info text;x-line-id=0 When the Alert-Info header contains an info text, the IP phone will map the text with the Internal Ringer distinctive_ring_tones.alert_info.X.text Text preconfigured (or “ ” is configured) on the IP phone, and then play the ring tone associated with the Internal Ringer Text (the ring tone can be configured by the distinctive_ring_tones.alert_info.X.ringer parameter “...
Page 389
(for example, Customring.wav) Default Settings->Ring->Internal Ringer File Web UI X is the account ID. For T54S/T48S/T48G/T46S/T46G/T29G, X=1-16; for T52S/T42G/T42S, X=1-12; for T41P/T41S/T27P/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2; for T19(P) E2, X=1. X is the ring tone ID. X=1-10.
USB headset) should be connected to the IP phone and the headset mode also should be activated in advance. The USB headset is only applicable to T41S/T42S/T46S/T48S/T52S/T54S IP phones. You can press the HEADSET key to activate the headset mode. For more information, refer to the...
Audio Features Ringer Volume Configuration You can configure the ringer volume as a fixed level, so the user cannot adjust the ringer volume on the phone. This feature is used to avoid missing calls when the user turns down the ringer volume. The following table lists the parameters you can use to configure ringer volume.
Page 392
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones may render the voice quality bad. Permitted Integer from -50 to 50 Values Default Features->Audio->Handset Send Volume (-50~50) Web UI voice.handset.autoreset_spk_vol Parameter <y0000000000xx>.cfg It configures the handset's volume level during a call. Description 0-The handset volume at the end of a call persists between calls.
Audio Features Tones When receiving a message, the IP phone will play a warning tone. You can customize tones or select specialized tone sets (vary from country to country) to indicate different conditions of the IP phone. Topics Supported Tones Tones Configuration Supported Tones The default tones used on IP phones are the US tone sets.
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Switzerland Sweden Russia United States Chile Czech ETSI Configured tones can be heard on IP phones in the following conditions. Condition Description Dial When in the dialing interface When adding a comma “,”...
Page 395
For T40P/T40G/T23P/T23G/T21(P) E2/T19(P) E2: A tone is comprised of at most two different frequencies. Description T54S/T52S/T48S/T48G/T46S/T46G/T42G/T42S/T41P/T41S/T29G/T27P/T27G: A tone is comprised of at most four different frequencies. Duration: the duration (in milliseconds) of the dial tone, ranges from 0 to 30000ms.
Page 396
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Default voice.tone.secondary_dial <y0000000000xx>.cfg Parameter It customizes the secondary dial tone. The value format is Freq/Duration. For more information on the value format, refer to the parameter “voice.tone.dial”. Description Note: It works only if “voice.tone.country” is set to Custom. If you want to disable this warning tone, set it to 0.
Page 397
Audio Features 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 String Values Blank Default Settings->Tones->Congestion Web UI voice.tone.callwaiting Parameter <y0000000000xx>.cfg It customizes the call waiting tone. The value format is Freq/Duration.
Page 398
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Blank Default Settings->Tones->Info Web UI voice.tone.stutter Parameter <y0000000000xx>.cfg It customizes the tone when the IP phone receives a voice mail. The value format is Freq/Duration. For more information on the value format, refer to the parameter “voice.tone.dial”.
Audio Features Audio Codecs CODEC is an abbreviation of COmpress-DECompress, capable of coding or decoding a digital data stream or signal by implementing an algorithm. The object of the algorithm is to represent the high-fidelity audio signal with minimum number of bits while retaining the quality. This can effectively reduce the frame size and the bandwidth required for audio transmission.
Page 400
The T40P/T40G/T23P/T23G/T21(P) E2/T19(P) E2 IP phones support using WB for Opus encoding; and using NB, MB, WB, SWB and FB for Opus decoding. The T54S/T52S/T48S/T46S/T42S/T41S/T27G IP phones support using WB (default) or NB for Opus encoding; and using NB, MB, WB, SWB and FB for Opus decoding.
Audio Codecs Configuration Yealink IP phones running firmware version 81 or later support a new configuration behavior for the audio codecs. It is more effective for you to provision different IP phone modules. The configuration parameters are different for the new configuration behavior and the older one. For...
Page 402
When audio codec is iLBC_13_33kpbs, the default value is 0; Account->Codec->Audio Codec Web UI account.X.codec.opus.para <MAC>.cfg Parameter It configures the sample rate of the Opus audio codec. Description Note: It is only applicable to T54S/T52S/T48S/T46S/T42S/T41S/T27G IP phones. opus-wb-Opus-WB (16KHz) Permitted opus-nb-Opus-NB (8KHz) Values opus-wb Default Account->Codec->Opus Sample Rate Web UI voice.g726.aal2.enable...
Values 1-Enabled Default X is the account ID. For T54S/T48S/T48G/T46S/T46G/T29G, X=1-16; for T52S/T42G/T42S, X=1-12; for T41P/T41S/T27P/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2; for T19(P) E2, X=1. Packetization Time (PTime) PTime is a measurement of the duration (in milliseconds) of the audio data in each RTP packet sent to the destination, and defines how much network bandwidth is used for the RTP stream transfer.
Default Account->Advanced->PTime(ms) Web UI X is the account ID. For T54S/T48S/T48G/T46S/T46G/T29G, X=1-16; for T52S/T42G/T42S, X=1-12; for T41P/T41S/T27P/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2; for T19(P) E2, X=1. Early Media Early media refers to the media (for example, audio and video) played to the caller before a SIP call is actually established.
Audio Features the local ringback tone upon a subsequent 180 message received. Topic Early Media Configuration Early Media Configuration The following table lists the parameter you can use to configure the early media. Parameter <y0000000000xx>.cfg phone_setting.early_media.rtp_sniffer.timeout It configures the time to wait for the IP phone to play the local ringback tone when the Description early media cannot be played.
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones phone. This feature is especially useful for permanent or full-time headset users. Note It is not applicable to the Bluetooth headset and USB headset. Topic Headset Prior Configuration Headset Prior Configuration The following table lists the parameters you can use to configure headset prior.
Web UI Acoustic Clarity Technology To optimize the audio quality of your network, Yealink IP 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.
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones remote party, AEC may be used to reduce/avoid echo when the you use the handset. Note Utilizing acoustic echo cancellation will introduce a small increase of delay into audio path which might cause a lower voice quality.
Jitter Buffer Yealink IP 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 IP phones. An adaptive jitter buffer is capable of adapting the changes in the network's delay.
Page 410
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Topic Jitter Buffer Configuration Jitter Buffer Configuration You can configure the mode of jitter buffer and the delay time for jitter buffer in the wired network or wireless network. The following table lists the parameters you can use to configure the jitter buffer. voice.jib.adaptive Parameter <y0000000000xx>.cfg...
Page 411
Default Settings->Voice->JITTER BUFFER->Normal Web UI voice.jib.wifi.adaptive Parameter <y0000000000xx>.cfg It configures the type of jitter buffer in the wireless network. Description Note: It is only applicable to T54S/T52S/T48S/T48G/T46S/T46G/T42S/T41S/T29G/T27G IP phones. 0-Fixed Permitted Values 1-Adaptive Default voice.jib.wifi.min Parameter <y0000000000xx>.cfg It configures the minimum delay time (in milliseconds) of jitter buffer in the wireless network.
(configured by the parameter “voice.jib.wifi.max”). The value of this parameter should be greater than “voice.jib.wifi.min” and less than “voice.jib.wifi.min”. It is only applicable to T54S/T52S/T48S/T48G/T46S/T46G/T42S/T41S/T29G/T27G IP phones. Permitted Integer from 0 to 500...
Audio Features 1209 Hz 1336 Hz 1477 Hz 1633 Hz 941 Hz Note The IP phones will not send DTMF sequence when the call is placed on hold or is held. Transmitting DTMF Digit Three methods of transmitting DTMF digits on SIP calls: RFC 2833 -- DTMF digits are transmitted by RTP Events compliant with RFC 2833.
Page 414
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones It configures the value of DTMF payload. Description Note: It works only if “account.X.dtmf.type” is set to 1 (RFC2833) or 3 (RFC2833 + SIP INFO). Permitted Integer from 96 to 127 Values Default Account->Advanced->DTMF Payload Type(96~127)
Values Default X is the account ID. For T54S/T48S/T48G/T46S/T46G/T29G, X=1-16; for T52S/T42G/T42S, X=1-12; for T41P/T41S/T27P/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2; for T19(P) E2, X=1. If you change this parameter, the IP phone will reboot to make the change take effect.
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Note: It works only if “features.dtmf.hide” is set to 1 (Enabled). 0-Disabled Permitted Values 1-Enabled Default Features->General Information->Suppress DTMF Display Delay Web UI Transfer via DTMF Call transfer is implemented via DTMF on some servers. The IP phone sends specified DTMF digits to the server for transferring calls to third parties.
These metrics can be sent between the phones in RTCP-XR packets. These metrics can also be sent in SIP PUBLISH messages to a central voice quality report collector. Yealink IP phones support two mechanisms for voice quality monitoring: RTCP-XR and VQ-RTCPXR.
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Topic RTCP-XR Configuration RTCP-XR Configuration The following table lists the parameters you can use to configure the RTCP-XR. voice.rtcp_xr.enable Parameter <y0000000000xx>.cfg It enables or disables the IP phone to send RTCP-XR packets. Description 0-Disabled Permitted...
Page 419
Audio Features Service Quality Reports VQ-RTCPXR Display Central Report Collector Service Quality Reports Three types of quality reports can be enabled: Session: Generated at the end of a call. Interval: Generated during a call at a configurable period. Alert: Generated when the call quality degrades below a configurable threshold.
Page 420
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Permitted Integer from 5 to 20 Values Default Settings->Voice Monitoring->Period for Interval Report Web UI phone_setting.vq_rtcpxr_moslq_threshold_warning Parameter <y0000000000xx>.cfg It configures the threshold value of listening MOS score (MOS-LQ) multiplied by 10. The threshold value of MOS-LQ causes the phone to send a warning alert quality report to the central report collector.
Page 421
Audio Features 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.
Page 422
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones VQ-RTCPXR Display Configuration The following table lists the parameters you can use to configure VQ-RTCPXR display. phone_setting.vq_rtcpxr.states_show_on_web.enable <y0000000000xx>.cfg Parameter It enables or disables the voice quality data of the last call to be displayed on web Description interface at path Status->RTP Status.
Page 423
Audio Features Default Settings->Voice Monitoring->Report options on phone->Current Time Web UI phone_setting.vq_rtcpxr_display_local_call_id.enable Parameter <y0000000000xx>.cfg It enables or disables the phone to display Local User on the LCD screen. Description Note: It works only if “phone_setting.vq_rtcpxr.states_show_on_gui.enable” is set to 1 (Enabled). 0-Disabled Permitted Values...
Page 424
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Settings->Voice Monitoring->Report options on phone->Remote Codec Web UI phone_setting.vq_rtcpxr_display_jitter.enable Parameter <y0000000000xx>.cfg It enables or disables the phone to display Jitter on the LCD screen. Description Note: It works only if “phone_setting.vq_rtcpxr.states_show_on_gui.enable” is set to 1 (Enabled).
Page 425
Audio Features phone_setting.vq_rtcpxr_display_round_trip_delay.enable Parameter <y0000000000xx>.cfg It enables or disables the phone to display RoundTripDelay on the LCD screen. Description Note: It works only if “phone_setting.vq_rtcpxr.states_show_on_gui.enable” is set to 1 (Enabled). 0-Disabled Permitted Values 1-Enabled Default Settings->Voice Monitoring->Report options on phone->RoundTripDelay Web UI phone_setting.vq_rtcpxr_display_moslq.enable <y0000000000xx>.cfg...
Page 426
Permitted Integer from 1 to 65535 Values 5060 Default Account->Advanced->VQ RTCP-XR Collector Port Web UI X is the account ID. For T54S/T48S/T48G/T46S/T46G/T29G, X=1-16; for T52S/T42G/T42S, X=1-12; for T41P/T41S/T27P/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2; for T19(P) E2, X=1.
By default, some menu options are protected by privilege levels: user and administrator, each with its own password. You can also customize the access permission for configurations on the web user interface and phone/handset user interface. Yealink IP phones support access levels of admin, var and user.
Note: You cannot change the user password via 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.
You can lock the IP phone to prevent it from unauthorized use. Once the IP phone is locked, anyone must enter the password to unlock it. Yealink IP phones offer three types for phone lock: Lock the Menu soft key: it prevents unauthorized users from accessing the menu, changing the ...
Security Features Operation Behaviors on Lock Phone The following table lists the operation behavior when configuring the type of phone lock: All Keys Function Keys Menu key Allowable Behavior: You are allowed to press the desired Line Key (key type is Line) or the Speakerphone key to enter The Menu the dialing screen.
It enables or disables the phone lock feature. Description 0-Disabled Permitted Values 1-Enabled Default Features->Phone Lock->Phone Lock Enable Web UI T54S/T52S/T48S/T48G/T46S/T46G/T29G: Menu->Basic->Phone Lock->Lock Enable Phone UI T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2: Menu->Settings->Basic Settings->Phone Lock->Lock Enable phone_setting.phone_lock.lock_key_type Parameter <y0000000000xx>.cfg It configures the type of phone lock.
Page 433
Note: It works only if “phone_setting.phone_lock.enable” is set to 1(Enabled). Permitted Integer from 0 to 3600 Values Default Features->Phone Lock->Phone Lock Time Out (0~3600s) Web UI T54S/T52S/T48S/T48G/T46S/T46G/T29G: Menu->Basic->Phone Lock->Auto Lock Phone UI T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2: Menu->Settings->Basic Settings->Phone Lock->Auto Lock phone_setting.emergency.number <y0000000000xx>.cfg Parameter It configures emergency numbers.
HTTPS URL for provisioning in a way that is designed to prevent eavesdropping and tampering. Yealink IP phones support TLS version 1.0, 1.1 and 1.2. When TLS is enabled for an account, the SIP message of this account will be encrypted, and a lock icon appears on the LCD screen after the successful TLS negotiation.
A unique server certificate: It is unique to an IP phone (based on the MAC address) and issued by the Yealink Certificate Authority (CA). A generic server certificate: It is issued by the Yealink Certificate Authority (CA). Only if no unique certificate exists, the IP phone may send a generic certificate for authentication.
Page 436
However, this feature is configurable by the parameter “phone_setting.reserve_certs_config.enable” using the configuration file. Topic Supported Trusted Certificates Supported Trusted Certificates Yealink IP phones trust the following CAs by default: DigiCert High Assurance EV Root CA Deutsche Telekom Root CA 2 ...
Page 437
Security Features VeriSign Class 3 Public Primary Certification Authority - G3 VeriSign Class 3 Public Primary Certification Authority - G4 VeriSign Class 3 Public Primary Certification Authority - G5 VeriSign Class 4 Public Primary Certification Authority - G2 ...
Note Yealink endeavors to maintain a built-in list of most common used CA Certificates. Due to memory constraints, we cannot ensure a complete set of certificates. If you are using a certificate from a commercial Certificate Authority not in the list above, you can send a request to your local distributor. At this point, you can upload your particular CA certificate into your phone.
Page 439
Security Features Default Account->Register->SIP Server Y->Transport Web UI static.security.default_ssl_method Parameter <y0000000000xx>.cfg It configures the TLS version the IP phone uses to authenticate with the server. Description 0-TLS 1.0 only 3-SSL V23 (automatic negotiation with server. The phone starts with TLS1.2 for Permitted negotiation.) Values...
Page 440
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Security->Trusted Certificates->Common Name Validation Web UI static.security.dev_cert Parameter <y0000000000xx>.cfg It configures the type of the device certificates for the IP phone to send for TLS Description authentication. 0-Default Certificates Permitted Values 1-Custom Certificates Default Security->Server Certificates->Device Certificates...
“phone_setting.reserve_certs_config.enable” will not be reset. Default X is the account ID. For T54S/T48S/T48G/T46S/T46G/T29G, X=1-16; for T52S/T42G/T42S, X=1-12; for T41P/T41S/T27P/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2; for T19(P) E2, X=1. If you change this parameter, the IP phone will reboot to make the change take effect.
Page 442
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Example of the RTP encryption algorithm carried in the SDP of the INVITE message: m=audio 11780 RTP/SAVP 0 8 18 9 101 a=crypto:1 AES_CM_128_HMAC_SHA1_80 inline:NzFlNTUwZDk2OGVlOTc3YzNkYTkwZWVkMTM1YWFj a=crypto:2 AES_CM_128_HMAC_SHA1_32 inline:NzkyM2FjNzQ2ZDgxYjg0MzQwMGVmMGUxMzdmNWFm a=crypto:3 F8_128_HMAC_SHA1_80 inline:NDliMWIzZGE1ZTAwZjA5ZGFhNjQ5YmEANTMzYzA0 a=rtpmap:0 PCMU/8000 a=rtpmap:8 PCMA/8000 a=rtpmap:18 G729/8000...
Security Features SRTP Configuration The following table lists the parameters you can use to configure the SRTP. account.X.srtp_encryption <MAC>.cfg Parameter It configures whether to use voice encryption service. Description 0-Disabled 1-Optional, the IP phone will negotiate with the other IP phone what type of Permitted encryption to use for the session.
T41P/T41S/T27P/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2; for T19(P) E2, X=1. Encrypting and Decrypting Files Yealink IP phones support downloading encrypted files from the server and encrypting files before/when uploading them to the server. You can encrypt the following files: Configuration files: MAC-Oriented CFG file (<MAC>.cfg), Common CFG file (y0000000000xx.cfg),...
Security Features Configuration Files Encryption Tools Yealink provides three configuration files encryption tools: Config_Encrypt_Tool.exe (via graphical tool for Windows platform) Config_Encrypt.exe (via DOS command line for Windows platform) yealinkencrypt (for Linux platform) The encryption tools encrypt plaintext configuration files (for example, account.cfg, <y0000000000xx>.cfg, <MAC>.cfg) (one by one or in batch) using 16-character symmetric keys (the...
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones static.auto_provision.aes_key_16.mac symmetric keys during auto provisioning. If the parameter “ ” is left blank, the value of the parameter “ static.auto_provision.aes_key_16.com ” will be used. If the downloaded contact files is encrypted, the IP phone will try to decrypt <MAC>-contact.xml file using the plaintext AES key.
Page 447
MAC-Oriented file using the AES key configured by the parameter “static.auto_provision.aes_key_16.com”. Permitted 16 characters Values Blank Default Settings->Auto Provision->Common AES Key Web UI T54S/T52S/T48S/T48G/T46S/T46G/T29G: Menu->Advanced (default password: admin) ->Auto Provision->Common AES Key Phone UI T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2: Menu->Settings->Advanced Settings (default password: admin) ->Auto Provision->Common AES Key static.auto_provision.aes_key_16.mac Parameter <y0000000000xx>.cfg It configures the plaintext AES key for encrypting/decrypting the MAC-Oriented files (<MAC>.cfg, <MAC>-local.cfg and <MAC>-contact.xml).
Page 448
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones [1][2] static.autoprovision.X.com_aes Parameter <y0000000000xx>.cfg It configures the plaintext AES key for decrypting the Common CFG file. Description If it is configured, it has a higher priority than the value configured by the parameter “static.auto_provision.aes_key_16.com”.
Example: Encrypting Configuration Files The following example describes how to use “Config_Encrypt_Tool.exe” to encrypt the account.cfg file. For more information on the other two encryption tools, refer to Yealink Configuration Encryption Tool User Guide. The way the IP phone processes other configuration files is the same to that of the account.cfg file.
Page 450
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones When you start the application tool, a file folder named “Encrypted” is created automatically in the directory where the application tool is located. Click Browse to locate configuration file(s) (for example, account.cfg) from your local system in the Select File(s) field.
Aeskey.txt file storing plaintext AES key(s). Incoming Signaling Validation Yealink IP phones support the following three optional levels of security for validating incoming network signaling: Source IP address validation: ensure the request is received from an IP address of a server ...
Page 452
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Blank Default sip.request_validation.digest.list Parameter <y0000000000xx>.cfg It configures the name of the request method for which digest authentication will be applied. It is used to challenge requests with digest authentication that use the local Description credentials for the associated registered account.
You can use call pickup to answer someone else’s incoming call on your phone. The Yealink IP phones support Directed Call Pickup and Group Call Pickup: Directed Call Pickup: allows you to pick up incoming calls to a specific phone.
Page 454
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Topics Directed Call Pickup Configuration Dialog Info Call Pickup Directed Call Pickup Configuration You can enable directed call pickup, the LCD screen will display a DPickup soft key when picking up the handset, pressing the Speakerphone key or pressing the line key (You may need to press the More soft key to see the DPickup soft key).
Page 455
Default Account->Advanced->Directed Call Pickup Code Web UI X is the account ID. For T54S/T48S/T48G/T46S/T46G/T29G, X=1-16; for T52S/T42G/T42S, X=1-12; for T41P/T41S/T27P/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2; for T19(P) E2, X=1. Dialog Info Call Pickup While some SIP servers implement directed call pickup using a directed call pickup code, others also support implement this feature through SIP signals.
Advanced Features Default Account->Advanced->Dialog Info Call Pickup Web UI Group Call Pickup Group call pickup is used for picking up incoming calls within a pre-defined group. When any phone within a predefined group of phones receives an incoming call, you can pick up that call easily on the phone.
Callee actively rejects the incoming call before answering Yealink IP phones support call completion using the SUBSCRIBE/NOTIFY method, which is specified in draft-poetzl-sipping-call-completion-00, to subscribe to the busy party and receive notifications of their status changes. The caller subscribes for update notifications of the dialog event from the busy party. Example of a SUBSCRIBE message: SUBSCRIBE sip:1000@10.10.20.34:5060 SIP/2.0...
Page 459
Call-ID: 4_2103527761@10.10.20.32 CSeq: 2 SUBSCRIBE Contact: <sip:10111@10.10.20.32:5060> Accept: application/dialog-info+xml Max-Forwards: 70 User-Agent: Yealink SIP-T46G 28.82.0.20 Expires: 60 Event: dialog Content-Length: 0 Example of a NOTIFY message (The subscription (SUBSCRIBE message) of the dialog event “Call Completion” is confirmed by the busy party): NOTIFY sip:10111@10.10.20.32:5060 SIP/2.0...
Permitted Values 1-Enabled, the caller is notified when the callee becomes available to receive a call. Default Features->General Information->Call Completion Web UI T54S/T52S/T48S/T48G/T46S/T46G/T29G: Menu->Features->Others->Call Completion->Call Completion Phone UI T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2: Menu->Features->Call Completion->Call Completion Example: Using Call Completion The following example shows configuration for call completion.
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones 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 call park and retrieve. features.call_park.park_mode Parameter <y0000000000xx>.cfg...
Advanced Features Blank Default Features->Pick up & Park->Park Retrieve Code Web UI features.call_park.direct_send.enable Parameter <y0000000000xx>.cfg It enables or disables the IP phone to dial out the call park code/park retrieve code directly when pressing the Park/Retrieve soft key. It is only applicable to FAC call park mode.
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones You can set a line key as a Park key or a Retrieve key, specify an extension you want to park a call to for Park parked extension key and specify a you want to retrieve a parked call from for Retrieve key.
Advanced Features ACD Key Configuration You can configure a line key as ACD key to log into the ACD system. The ACD key on the IP phone indicates the ACD state. ACD key is not available on T19(P) E2 IP phones. The following shows configuration for an ACD key.
Page 466
Note: It works only if “account.X.acd.enable” and “acd.auto_available” are set to 1 (Enabled). Permitted Integer from 0 to 120 Values Default Features->ACD->ACD->ACD Auto Available Timer (0~120s) Web UI X is the account ID. For T54S/T48S/T48G/T46S/T46G/T29G, X=1-16; for T52S/T42G/T42S, X=1-12; for...
The Busy Lamp Field (BLF) feature enables the IP phone to monitor specific remote lines for state changes on the phone. It is not available on the T19(P) E2 IP phone. Yealink IP phones support two methods of BLF configuration: Configure a line key as BLF key to monitor a specific remote line ...
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Topics BLF Key Configuration BLF List Configuration State Indicator of Remote Line BLF/BLF List Subscription Visual and Audio Alert for Monitor Lines LED Mode for BLF/BLF List Key BLF/BLF List Key LED Status and Behavior Configuration BLF Key for Intercom Configuration BLF Key Configuration You can configure a BLF key for a specific line.
Page 469
Advanced Features Values Blank Default Account->Advanced->BLF List URI Web UI account.X.blf_list_code Parameter <MAC>.cfg It configures the feature access code for directed call pickup. Example: Description account.1.blf_list_code = *97 Note: It is not applicable to T19(P) E2 IP phones. Permitted String within 32 characters Values Blank Default...
Page 470
1-Enabled Default X is the account ID. For T54S/T48S/T48G/T46S/T46G/T29G, X=1-16; for T52S/T42G/T42S, X=1-12; for T41P/T41S/T27P/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2; for T19(P) E2, X=1. If you change this parameter, the IP phone will reboot to make the change take effect.
BLF/BLF List Subscription Yealink IP phones support BLF using a SUBSCRIBE/NOTIFY mechanism as specified in 3265. BLF Subscription When you configure the IP phone to monitor a specific line, the IP phone sends a SUBSCRIBE request with Request-URI containing the monitor line URI to the server, and then receives a NOTIFY request.
Page 472
The NOTIFY message contains XML body with status of each monitor line. The following example shows a NOTIFY message for a BLF List, the BLF List contains 4605 and 4607: <?xml version="1.0" <?xml version="1.0"?> <list xmlns="urn:ietf:params:xml:ns:rlmi" xmlns="urn:ietf:params:xml:ns:rlmi" version="0" fullState="true"> <resource uri="sip:4605@pbx.yealink.com"> <name>4605 Yealink</name> <instance id="JQZxud2qeo" state="active" cid="8y35ri@broadworks"/> </resource> <resource uri="sip:4605@pbx.yealink.com">...
Page 473
0-Disabled Permitted 1-Enabled, the IP phone will generate a random value. The final renewal time is equal Values to the original renewal time plus the random value. Default X is the account ID. For T54S/T48S/T48G/T46S/T46G/T29G, X=1-16; for T52S/T42G/T42S, X=1-12; for...
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones T41P/T41S/T27P/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2. Visual and Audio Alert for Monitor Lines Visual and Audio Alert feature allows the phone to display the caller ID and play an audio alert when a BLF line receives an incoming call.
Page 475
Permitted Ring8.wav, Silent.wav, Splash.wav or custom ring tone name (for example, Values Config:Customring.wav). Splash.wav Default Features->Pickup & Park->Ring Type for BLF Pickup Web UI T54S/T52S/T48S/T48G/T46S/T46G/T29G: Menu->Basic->Sound->BLF Ring Type Phone UI T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2: Menu->Settings->Basic Settings->Sound->BLF Ring Type features.pickup_display.method <y0000000000xx>.cfg Parameter It configures the display method of the call party information on the visual prompt.
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Directed Call Pickup account.1.direct_pickup_code = *97 features.pickup.direct_pickup_code = *97 linekey.1.type = 16 linekey.1.line = 1 BLF Key Configuration linekey.1.value = 1001 linekey.1.label = Bill Example features.pickup.blf_visual_enable = 1 features.pickup.blf_audio_enable = 1 When the monitored line receives an incoming call, the LCD screen shows an incoming call to the monitored line (from 1008 to 1001), the following occurs on the phone: The phone plays a specific alert tone.
Page 477
Advanced Features BLF LED Mode Configuration Supported BLF LED Modes The following table lists the LED statuses of the BLF/BLF list key when BLF LED Mode is set to 0, 1, 2, 3 or 4 respectively. The default value of BLF LED mode is 0. Line key/Expansion Module Key LED (configured as a BLF key or a BLF List key and BLF LED Mode is set to 0) LED Status...
Page 478
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones LED Status Description The monitored user is dialing. The monitored user is talking. Solid red The monitored user’s conversation is placed on hold (This LED status requires server support). The call is parked against the monitored user’s phone Slow-flashing red (1s) number.
Advanced Features DSS key LED status. Note: It is not applicable to T19(P) E2 IP phones. For the Genband server, you can set the value of this parameter to 4. Permitted 0,1,2,3,4 Values Default Features->General Information->BLF LED Mode Web UI BLF/BLF List Key LED Status and Behavior Configuration You can customize the BLF LED status (or the color of BLF icon for T48S/T48G IP phones) and BLF/BLF List key behavior using the EDK macros if required.
Page 480
This value uses the same macro action string syntax as an Enhanced DSS key. Example: blf.enhanced.idle.led = $LEDg1000o$ Description T54S/T52S/T46G/T46S/T42G/T42S/T41P/T41S/T40P/T40G/T29G/T27P/T27G/T23P/T23 G/T21(P) E2 IP phones, the BLF/BLF list DSS key LED glows green for 1000ms and then goes out. For T48G/T48S IP phones, the BLF/BLF List DSS key field displays a green icon for 1000ms and then turns to white.
Page 481
Advanced Features Values Blank Default blf.enhanced.idle.talking.action Parameter <y0000000000xx>.cfg It configures the behavior when pressing the BLF/BLF list DSS key if the monitor is talking and monitored user is idle. This value uses the same macro action string syntax as an Enhanced DSS key. Description Example: blf.enhanced.idle.talking.action = newcall...
Page 482
This value uses the same macro action string syntax as an Enhanced DSS key. Example: blf.enhanced.callin.led = $LEDg1000o$ Description T54S/T52S/T46G/T46S/T42G/T42S/T41P/T41S/T40P/T40G/T29G/T27P/T27G/T23P/T23 G/T21(P) E2 IP phones, the BLF/BLF List DSS key LED glows green for 1000ms and then goes out. For T48G/T48S IP phones, the BLF/BLF List DSS key field displays a green icon for 1000ms and then turns to white.
Page 483
This value uses the same macro action string syntax as an Enhanced DSS key. Example: blf.enhanced.callout.led = $LEDg1000o$ Description T54S/T52S/T46G/T46S/T42G/T42S/T41P/T41S/T40P/T40G/T29G/T27P/T27G/T23P/T23 G/T21(P) E2 IP phones, the BLF/BLF list DSS key LED glows green for 1000ms and then goes out. For T48G/T48S IP phones, the BLF/BLF List DSS key field displays a green icon for...
Page 484
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones 1000ms and then turns to white. Note: It works only if “blf.enhanced.callout.enable” is set to 1 (Enabled). It is not applicable to T19(P) E2 IP phones. Permitted String Values Blank Default blf.enhanced.callout.callin.action <y0000000000xx>.cfg Parameter...
Page 485
This value uses the same macro action string syntax as an Enhanced DSS key. Example: blf.enhanced.talking.led = $LEDg1000o$ Description T54S/T52S/T46G/T46S/T42G/T42S/T41P/T41S/T40P/T40G/T29G/T27P/T27G/T23P/T23 G/T21(P) E2 IP phones, the BLF/BLF list DSS key LED glows green for 1000ms and then goes out. For T48G/T48S IP phones, the BLF/BLF List DSS key field displays a green icon for 1000ms and then turns to white.
Page 486
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones blf.enhanced.talking.callin.action = newcall Note: It works only if “blf.enhanced.talking.enable” is set to 1 (Enabled). It is not applicable to T19(P) E2 IP phones. Permitted String Values Blank Default blf.enhanced.talking.talking.action <y0000000000xx>.cfg Parameter It configures the behavior when pressing the BLF/BLF list DSS key if the monitor and monitored user are talking.
Page 487
This value uses the same macro action string syntax as an Enhanced DSS key. Example: blf.enhanced.parked.led = $LEDg1000o$ Description T54S/T52S/T46G/T46S/T42G/T42S/T41P/T41S/T40P/T40G/T29G/T27P/T27G/T23P/T23 G/T21(P) E2 IP phones, the BLF/BLF list DSS key LED glows green for 1000ms and then goes out. For T48G/T48S IP phones, the BLF/BLF List DSS key field displays a green icon for 1000ms and then turns to white.
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones This value uses the same macro action string syntax as an Enhanced DSS key. Example: blf.enhanced.parked.talking.action = newcall Note: It works only if “blf.enhanced.parked.enable” is set to 1 (Enabled). It is not applicable to T19(P) E2 IP phones.
Advanced Features Shared Line Yealink IP phones support Shared Call Appearance (SCA) and Bridged Line Appearance (BLA) to share a line. Shared call appearances and bridged line appearances are similar signaling methods that enable more than one phone to share the same line or registration. The methods you use vary with the SIP server you are using.
In SCA scenario, an incoming call can be presented to multiple phones simultaneously. Any IP phone can be used to originate or receive calls on the shared line. Yealink IP phones support SCA using a SUBSCRIBE/NOTIFY mechanism as specified in 3265. The events used are: “call-info”...
Page 491
Advanced Features Topic SCA Configuration SCA Configuration The following table lists the parameters you can use to configure SCA. account.X.shared_line Parameter <MAC>.cfg It configures the registration line type. Description 0-Disabled Permitted 1-Shared Call Appearance Values 3-Draft BLA Default Account->Advanced->Shared Line Web UI account.X.line_seize.expires Parameter...
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Default X is the account ID. For T54S/T48S/T48G/T46S/T46G/T29G, X=1-16; for T52S/T42G/T42S, X=1-12; for T41P/T41S/T27P/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2; for T19(P) E2, X=1. Bridge Lines Appearance (BLA) BLA allows users to share a SIP line on two or more IP phones. Users can monitor the specific extension (BLA number) for status changes on each IP phone.
Default Account->Advanced->BLA Subscription Period Web UI X is the account ID. For T54S/T48S/T48G/T46S/T46G/T29G, X=1-16; for T52S/T42G/T42S, X=1-12; for T41P/T41S/T27P/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2; for T19(P) E2, X=1. Intercom Intercom is a useful feature in an office environment to quickly connect with the operator or the secretary.
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones State Monitor for Intercom Contact Outgoing Intercom Configuration Incoming Intercom Configuration Intercom Key Configuration You can configure an Intercom key to provide users the ability to initiate intercom calls directly to the specified contact.
Note: It is not applicable to T19(P) E2 IP phones. 0-Disabled Permitted Values 1-Enabled Default Outgoing Intercom Configuration Yealink IP phones support two methods for initialing intercom calls. The following table lists the parameters you can use to configure outgoing intercom.
Values Blank Default X is the account ID. For T54S/T48S/T48G/T46S/T46G/T29G, X=1-16; for T52S/T42G/T42S, X=1-12; for T41P/T41S/T27P/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2; for T19(P) E2, X=1. Incoming Intercom Configuration The IP phone can process incoming calls differently depending on settings.
Page 497
Advanced Features Default Features->Intercom->Intercom Allow Web UI Menu->Features->Intercom->Intercom Allow Phone UI features.intercom.mute <y0000000000xx>.cfg Parameter It enables or disables the IP phone to mute the microphone when answering an intercom call. Description Note: It works only if “features.intercom.allow” and "features.allow_mute" are set to 1 (Enabled).
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Menu->Features->Intercom->Intercom Barge Phone UI features.intercom.barge_in_dialing.enable Parameter <y0000000000xx>.cfg It enables or disables the intercom call to answer an incoming intercom call while dialing. Description Note: It works only if “features.intercom.barge” is set to 0 (Disabled). 0-Disabled, the IP phone handles the intercom call like a normal incoming call.
Advanced Features CSTA Control Configuration The following table lists the parameter you can use to configure CSTA control. features.csta_control.enable Parameter <y0000000000xx>.cfg It enables or disables the uaCSTA (User Agent Computer Supported Telecommunications Applications) feature on the IP phone. Description Note: It is not applicable to T19(P) E2 IP phones. 0-Disabled Permitted Values...
Page 500
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Event Description Registered When the IP phone successfully registers an account. Unregistered When the IP phone logs off the registered account. Register Failed When the IP phone fails to register an account. Off Hook When the IP phone is off hook.
Advanced Features Event Description Busy To Idle When the state of phone changes from busy to idle. Reject Incoming Call When the IP phone rejects an incoming call. Answer New-In Call When the IP phone answers a new call. Transfer Failed When the IP phone fails to transfer a call.
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Variable Value Description The host part of the SIP URI for the current account when $active_host the IP phone places a call, receives an incoming call or establishes a call. The SIP URI of the caller when the IP phone places a call. $local The SIP URI of the callee when the IP phone receives an incoming call.
Page 503
Advanced Features value. Valid variable values are: $mac $model $firmware $active_url $active_user $active_host $local $remote $display_local $display_remote $call_id Example: action_url.setup_completed = http://192.168.0.20/help.xml?IP=$ip URL within 511 characters Permitted The value format is: http(s)://IP address of server/help.xml?variable name=variable Values value. For Pre-defined events, refer to Pre-defined Events List.
Page 504
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones action_url.unregistered = http://192.168.0.20/help.xml?IP=$ip URL within 511 characters Permitted The value format is: http(s)://IP address of server/help.xml?variable name=variable Values value. For Pre-defined events, refer to Pre-defined Events List. For variable value, refer Variable Values List.
Page 505
Advanced Features Blank Default Features->Action URL->On Hook Web UI action_url.incoming_call Parameter <y0000000000xx>.cfg It configures the action URL the IP phone sends when receiving an incoming call. Description Example: action_url.incoming_call = http://192.168.0.20/help.xml?IP=$ip URL within 511 characters Permitted The value format is: http(s)://IP address of server/help.xml?variable name=variable Values value.
Page 506
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Example: action_url.dnd_on = http://192.168.0.20/help.xml?IP=$ip URL within 511 characters Permitted The value format is: http(s)://IP address of server/help.xml?variable name=variable Values value. For Pre-defined events, refer to Pre-defined Events List. For variable value, refer Variable Values List.
Page 507
Advanced Features The value format is: http(s)://IP address of server/help.xml?variable name=variable Values value. For Pre-defined events, refer to Pre-defined Events List. For variable value, refer Variable Values List. Blank Default Features->Action URL->Close Always Forward Web UI action_url.busy_fwd_on Parameter <y0000000000xx>.cfg It configures the action URL the IP phone sends when busy forward feature is activated.
Page 508
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Variable Values List. Blank Default Features->Action URL->Open NoAnswer Forward Web UI action_url.no_answer_fwd_off Parameter <y0000000000xx>.cfg It configures the action URL the IP phone sends when no answer forward feature is deactivated. Description Example: action_url.no_answer_fwd_off = http://192.168.0.20/help.xml?IP=$ip URL within 511 characters...
Page 509
Advanced Features action_url.attended_transfer_call Parameter <y0000000000xx>.cfg It configures the action URL the IP phone sends when performing an attended/semi-attended transfer. Description Example: action_url.attended_transfer_call = http://192.168.0.20/help.xml?IP=$ip URL within 511 characters Permitted The value format is: http(s)://IP address of server/help.xml?variable name=variable Values value. For Pre-defined events, refer to Pre-defined Events List.
Page 510
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones action_url.held = http://192.168.0.20/help.xml?IP=$ip URL within 511 characters Permitted The value format is: http(s)://IP address of server/help.xml?variable name=variable Values value. For Pre-defined events, refer to Pre-defined Events List. For variable value, refer Variable Values List.
Page 511
Advanced Features action_url.missed_call Parameter <y0000000000xx>.cfg It configures the action URL the IP phone sends when missing a call. Description Example: action_url.missed_call = http://192.168.0.20/help.xml?IP=$ip URL within 511 characters Permitted The value format is: http(s)://IP address of server/help.xml?variable name=variable Values value. For Pre-defined events, refer to Pre-defined Events List.
Page 512
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Example: action_url.idle_to_busy = http://192.168.0.20/help.xml?IP=$ip URL within 511 characters Permitted The value format is: http(s)://IP address of server/help.xml?variable name=variable Values value. For Pre-defined events, refer to Pre-defined Events List. For variable value, refer Variable Values List.
Page 513
Advanced Features value. For Pre-defined events, refer to Pre-defined Events List. For variable value, refer Variable Values List. Blank Default Features->Action URL->Reject Incoming Call Web UI action_url.answer_new_incoming_call Parameter <y0000000000xx>.cfg It configures the action URL the IP phone sends when answering a new incoming call. Description Example: action_url.answer_new_incoming_call = http://192.168.0.20/help.xml?IP=$ip...
Page 514
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones action_url.setup_autop_finish Parameter <y0000000000xx>.cfg It configures the action URL the IP phone sends when completing auto provisioning via power on. Description Example: action_url.setup_autop_finish = http://192.168.0.20/help.xml?IP=$ip URL within 511 characters Permitted The value format is: http(s)://IP address of server/help.xml?variable name=variable Values value.
Page 515
Advanced Features action_url.headset = http://192.168.0.20/help.xml?IP=$ip URL within 511 characters Permitted The value format is: http(s)://IP address of server/help.xml?variable name=variable Values value. For Pre-defined events, refer to Pre-defined Events List. For variable value, refer Variable Values List. Blank Default Features->Action URL->Headset Web UI action_url.handfree Parameter...
Features->Action URL->Call Remote Canceled Web UI Action URI Yealink IP phones can perform the specified action by receiving and handling an HTTP or HTTPS GET request or accept a SIP NOTIFY message with the “Event: ACTION-URI” header from a SIP proxy server. Topics...
Else, the browser will display an image of the phone’s current screen directly. You can save the image to your local system. Note Frequent capture may affect the phone performance. Yealink recommend you to capture the phone screen display within a minimum interval of 4 seconds. Example: Placing a Call via Web User Interface...
IP phone, or configure the IP phone to receive and handle the URI from any IP address. Supported SIP Notify Message In addition, Yealink IP phones can perform the specified action immediately by accepting a SIP NOTIFY message with the “Event: ACTION-URI” header from a SIP proxy server. The message body of the SIP NOTIFY message may contain variable named as “key”...
Advanced Features Variable Values List Yealink IP phones also support a combination of the variable values in the URI, but the order of the variable value is determined by the operation of the phone. The valid URI format is: http(s)://<phoneIPAddress>/servlet?key=variable value[;variable value] .
Page 520
Reboot the phone. AutoP Perform auto provisioning. Activate the DND feature. DNDOn Note: For Yealink IP phones, it works only if “features.dnd.allow” is set to 1 (Enabled). Deactivate the DND feature. DNDOff Note: For Yealink IP phones, it works only if “features.dnd.allow”...
Page 521
(seconds) before forwarding incoming calls (n is the times of 6, for example, 24). It is only applicable to no answer forward feature. AlwaysFwdOn/BusyFwdOn/NoAnswF Note: For Yealink IP phones, it works only if features.fwd.allow wdOn=xxx=n “ ” is set to 1 (Enabled) and...
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Variable Value Phone Action Deactivate the always/busy/no answer forward feature for the IP phone. Note: For Yealink IP phones, it works only if features.fwd.allow “ ” is set to 1 (Enabled) and call forward mode is Phone, the...
(which is saved as a JPG file and named with the phone model and the capture time) to the local system. Note Yealink IP phones also support capturing the screen display using the old URI http://<phoneIPAddress>/servlet?command=screenshot “...
Else, the browser will display an image of the phone’s current screen directly. You can save the image to your local system. Note Frequent capture may affect the phone performance. Yealink recommend you to capture the phone screen display within a minimum interval of 4 seconds. Example: Placing a Call via Web User Interface Procedure Navigate to Directory->Phone Call Info.
Yealink IP phones support voice mail. You can configure a message waiting indicator (MWI) to inform users that how many messages are waiting in their mailbox without calling the mailbox. Yealink IP phones support both audio and visual MWI alert when receiving new voice messages.
Page 526
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones The following table lists the parameters you can use to configure MWI for voice mail. account.X.subscribe_mwi Parameter <MAC>.cfg It enables or disables the IP phone to subscribe the message waiting indicator. Description 0-Disabled, the server automatically sends a message-summary NOTIFY in a new dialog each time the MWI status changes.
T41P/T41S/T27P/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2; for T19(P) E2, X=1. Short Message Service (SMS) Yealink IP phones support short message service (SMS). It allows users to send and receive text message on support server. By default, SMS is enabled. You can use SMS at the path: Menu->Message->Text Message. You can...
Google search, news service, and so on. To use the XML browser feature, you must configure an XML key in advance. Yealink IP Phones XML Browser Developer's Guide For more information on XML browser, refer to Topic...
Page 529
Advanced Features Features->Remote Control->Push XML Server IP Address Web UI push_xml.block_in_calling <y0000000000xx>.cfg Parameter It enables or disables the IP phone to block XML applications during a call. Description 0-Disabled Permitted Values 1-Enabled Default Features->Remote Control->Block XML in Calling Web UI push_xml.sip_notify Parameter <y0000000000xx>.cfg...
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones features.xml_browser.pwd Parameter <y0000000000xx>.cfg It configures the authentication password for XML request. Description Permitted String within 15 characters Values Blank Default push_xml.username Parameter <y0000000000xx>.cfg It configures the user name for the IP phone to authenticate with the push XML server. Description String Permitted...
Advanced Features Hot Desking Key Configuration Hot Desking Configuration Hot Desking Key Configuration The following shows configuration for a Hot Desking key. Line Key Configuration Programmable Key Configuration linekey.X.type = 34 programablekey.X.type = 34 linekey.X.label = Hot Desking After provisioning, a Hot Desking key is available on the phone. You can press the Hot Desking key to clear pre-registration configurations of all accounts and register their own account on line 1.
Page 532
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones desking login wizard when pressing the Hot Desking DSS key. 0-Disabled Permitted Values 1-Enabled, the original password information will be cleared. Default hotdesking.dsskey_sip_server_enable <y0000000000xx>.cfg Parameter It enables or disables the IP phone to provide input field of SIP server on the hot Description desking login wizard when pressing the Hot Desking DSS key.
Calling Line Identification Presentation (CLIP): It allows IP phones to display the caller identity, derived from a SIP header contained in the INVITE message when receiving an incoming call. Yealink IP phones can derive caller identity from three types of SIP header: From, P-Asserted-Identity (PAI) and Remote-Party-ID (RPID).
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Identification Presentation on Yealink IP Phones. Topic CLIP and COLP Configuration CLIP and COLP Configuration The following table lists the parameters you can use to configure the CLIP and COLP. account.X.cid_source Parameter <MAC>.cfg...
It configures the priority order for the sources of caller identity information. The headers can be in any order. Description Note: Yealink IP phones can derive caller identity from the following SIP headers: From, P-Asserted-Identity (PAI), P-Preferred-Identity and Remote-Party-ID (RPID). It works only if “account.X.cid_source” is set to 6 (PREFERENCE).
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones It configures the maximum number of concurrent calls per line key for all registered Description lines. 404-Not Found 480-Temporarily Unavailable Permitted 486-Busy Here, the caller’s phone LCD screen will display the message “Busy Here” Values when the callee rejects the incoming call.
General Features Group Pick up Barge In Retrieve Call Park Group Park Call Pull 0-Disabled Permitted Values 1-Enabled Default Features->General Information->Hide Feature Access Codes Web UI Accept SIP Trust Server Only Accept SIP trust server only enables the IP phones to only accept the SIP message from your SIP server and outbound proxy server.
The following table lists the parameter you can use to configure the 100 reliable retransmission. account.X.100rel_enable Parameter <MAC>.cfg It enables or disables the 100 reliable retransmission feature. Description 0-Disabled Permitted Values 1-Enabled Default Account->Advanced->Retransmission Web UI X is the account ID. For T54S/T48S/T48G/T46S/T46G/T29G, X=1-16; for T52S/T42G/T42S, X=1-12; for...
General Features T41P/T41S/T27P/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2; for T19(P) E2, X=1. SIP Session Timer SIP session timers T1, T2 and T4 are SIP transaction layer timers defined in 3261. These session timers are configurable on IP phones. Timer T1 Timer T1 is an estimate of the Round Trip Time (RTT) of transactions between a SIP client and SIP server.
“refresher=uac” included in the UPDATE message means that the UAC performs the refresh. Example of UPDATE message (UAC mode): UPDATE sip:1058@10.10.20.34:5060 SIP/2.0 Via: SIP/2.0/UDP 10.10.20.32:5060;branch=z9hG4bK2104991394 From: "10111" <sip:10111@10.2.1.48:5060>;tag=2170397024 To: <sip:1058@10.2.1.48:5060>;tag=200382096 Call-ID: 4_1556494084@10.10.20.32 CSeq: 2 UPDATE Contact: <sip:10111@10.10.20.32:5060> Max-Forwards: 70 User-Agent: Yealink SIP-T46G 28.82.0.20...
General Features Session-Expires: 90;refresher=uac Supported: timer Content-Length: 0 Topic Session Timer Configuration Session Timer Configuration The following table lists the parameters you can use to configure session timer. account.X.session_timer.enable Parameter <MAC>.cfg It enables or disables the session timer. Description 0-Disabled Permitted 1-Enabled, the IP phone will send periodic UPDATE requests to refresh the session Values...
Default Account->Advanced->Session Refresher Web UI X is the account ID. For T54S/T48S/T48G/T46S/T46G/T29G, X=1-16; for T52S/T42G/T42S, X=1-12; for T41P/T41S/T27P/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2; for T19(P) E2, X=1. Reboot in Talking Reboot in talking feature allows IP phones to reboot during an active call when it receives a reboot request by action URI.
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 SIP-T46G 28.82.0.20 Allow-Events: talk,hold,conference,refer,check-sync Content-Length: Topic Reserve # in User Name Configuration Reserve # in User Name Configuration The following table lists the parameter you can use to configure reserve # in user name.
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones Busy Tone Delay Configuration The following table lists the parameter you can use to configure busy tone delay. features.busy_tone_delay Parameter <y0000000000xx>.cfg It configures the duration time (in seconds) to play the busy tone when the call is Description released by other party.
General Features and server. RTP packets are looped back toward the source device. In a voice loopback call, an echo is heard at the device originating the call. For more information on media loopback, refer to 6849. Topic Media Loopback Configuration Media Loopback Configuration The following table lists the parameters you can use to configure media loopback.
Page 546
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones (rtp-pkt-loopback). 1-encapsulated packet loopback, the entire incoming RTP packet is encapsulated as payload within an outer RTP packet. The loopback source can generate statistics for one-way path performance up to the RTP level for each direction of travel. 2-directed packet loopback, the loopback mirror copies the payload of the incoming Permitted RTP packet into a new RTP packet.
If you change this parameter, the IP phone will reboot to make the change take effect. Broadsoft UC bw.xmpp.enable Parameter <y0000000000xx>.cfg It enables or disables the UC feature. Description Note: It works only if “bw.enable" is set to 1 (Enabled). It is only applicable to T54S/T52S/T48S/T48G/T46S/T46G/T29G IP phones. Permitted 0-Disabled Values...
Page 548
Applications->Broadsoft XMPPI->XMPP Account->XMPP Password (if Web UI bw.xmpp.enable =1) bw.xmpp.presence_icon.mode Parameter <y0000000000xx>.cfg It enables or disables to display presence icon in new style. Description Note: It is only applicable to T54S/T52S/T48S/T48G/T46S/T46G/T29G IP phones. 0-Disabled Permitted Values 1-Enabled Default bw.xmpp.change_presence.force_manual.enable Parameter <y0000000000xx>.cfg...
Page 549
Note: It works only if “phone_setting.dsskey_directory_auto.enable” is set to 1 Description (Enabled). To assign Ext Key, make sure the expansion module has been connected to the phone in advance. It is only applicable to T54S/T52S/T48S/T48G/T46S/T46G/T29G IP phones. 0-linekey->exp1 key->expN key 1-exp1 key ->expN key ->linekey...
Page 550
“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)”. Note: It is only applicable to T54S/T52S/T48S/T48G/T46S/T46G/T29G IP phones. Permitted Integer greater than or equal to 0...
Troubleshooting Note: It is only applicable to T54S/T52S/T48S/T48G/T46S/T46G/T29G IP phones. Permitted Integer greater than or equal to 0 Values Default directory_setting.bw_uc_buddies.enable Parameter <y0000000000xx>.cfg It enables or disables the users to access the BroadSoft Buddies directory by pressing the Directory/Dir soft key.
Page 552
Troubleshooting Note: It works only if “sip.authentication_for_xsi” is set to 0 (User Login Credentials for XSI Authentication) and “bw.xsi.enable" is set to 1 (Enabled). Permitted String within 99 characters Values Blank Default Applications->Broadsoft XSI->XSI Account->Password (if bw.enable =1) Web UI account.X.xsi.host Parameter <MAC>.cfg...
Page 553
Values Default X is the account ID. For T54S/T48S/T48G/T46S/T46G/T29G, X=1-16; for T52S/T42G/T42S, X=1-12; for T41P/T41S/T27P/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2; for T19(P) E2, X=1. If you change this parameter, the IP phone will reboot to make the change take effect.
Troubleshooting Broadsoft ACD account.X.acd.initial_state Parameter <MAC>.cfg It configures the initial agent state. Description 1-Available Permitted Values 2-Unavailable Default [1][2] account.X.reason_code.Y Parameter <MAC>.cfg It configures the unavailable/away code which must match one of the codes Description configured on BroadWorks/Star2Star platform. Permitted Integer from 1 to 2147483647 Values Blank...
Page 555
Troubleshooting Permitted Integer from 1 to 2147483647 Values Blank Default [1][2] account.X.supervisor_info_code_name.Y Parameter <MAC>.cfg It configures the supervisor name. Description Permitted String within 99 characters Values Blank Default account.X.call_center.call_info_enable <MAC>.cfg Parameter It enables or disables the call center call information feature. Description 0-Disabled Permitted...
1-Enabled Default X is the account ID. For T54S/T48S/T48G/T46S/T46G/T29G, X=1-16; for T52S/T42G/T42S, X=1-12; for T41P/T41S/T27P/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2; for T19(P) E2, X=1. Y is the code ID. For all IP phones, Y=1-100. The value Y must be continuous.
Description 0-XSI Permitted Values 1-SIP Default X is the account ID. For T54S/T48S/T48G/T46S/T46G/T29G, X=1-16; for T52S/T42G/T42S, X=1-12; for T41P/T41S/T27P/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2; for T19(P) E2, X=1. Broadsoft Security Classification account.X.security_classification.enable Parameter <MAC>.cfg It enables or disables security classification feature.
Page 558
Values 1-Enabled Default X is the account ID. For T54S/T48S/T48G/T46S/T46G/T29G, X=1-16; for T52S/T42G/T42S, X=1-12; for T41P/T41S/T27P/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2; for T19(P) E2, X=1. Flexible seating feature may also need to configure this parameter, refer to...
Values 1-Enabled Default X is the account ID. For T54S/T48S/T48G/T46S/T46G/T29G, X=1-16; for T52S/T42G/T42S, X=1-12; for T41P/T41S/T27P/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2; for T19(P) E2, X=1. Hoteling feature may also need to configure this parameter, refer to Broadsoft Hoteling...
Description 0-Disabled Permitted Values 1-Enabled Default X is the account ID. For T54S/T48S/T48G/T46S/T46G/T29G, X=1-16; for T52S/T42G/T42S, X=1-12; for T41P/T41S/T27P/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2; for T19(P) E2, X=1. Broadsoft Network Directory bw.xsi.directory.enable Parameter <y0000000000xx>.cfg It enables or disables the network directory feature for the IP phone.
Page 561
Troubleshooting bw_phonebook.personal_enable Parameter <y0000000000xx>.cfg It enables or disables the IP phone to display the personal directory. Description Note: It works only if the values of the parameters "bw.xsi.enable" and "bw.xsi.directory.enable" are set to 1 (Enabled) and XSI is configured for account 1. 0-Disabled Permitted Values...
Page 562
Troubleshooting bw_phonebook.enterprise_common_displayname Parameter <y0000000000xx>.cfg It configures the display name on the LCD screen for the enterprise common directory. Note: It works only if the values of the parameters "bw.xsi.enable", Description "bw.xsi.directory.enable" and "bw_phonebook.enterprise_common_enable" are set to 1 (Enabled) and XSI is configured for account 1. Permitted String within 99 characters Values...
Page 563
Troubleshooting Default bw_phonebook.custom <y0000000000xx>.cfg Parameter It enables or disables the custom directory feature. Description Note: It works only if the values of the parameters "bw.xsi.enable" and "bw.xsi.directory.enable" are set to 1 (Enabled) and XSI is configured for account 1. 0-Disabled Permitted Values 1-Enabled...
Page 564
Troubleshooting Personal Default Applications->Broadsoft XSI->Network Directory->Personal (if bw.enable =1) Web UI directory.update_time_interval Parameter <y0000000000xx>.cfg It configures the interval (in minutes) for the IP phone to update the data of the BroadSoft directory from the BroadSoft server. Description Note: It works only if “bw.xsi.directory.enable” and “bw.xsi.directory.update.enable” are set to 1 (Enabled).
Page 565
Troubleshooting bw.calllog_and_dir Parameter <y0000000000xx>.cfg It enables or disables the IP phone to directly enter the Network Calls screen when pressing the History soft key. Description Note: It works only if the values of the parameters "bw.xsi.enable" and "bw.xsi.call_log.enable" are set to 1 (Enabled) and XSI is configured for account 1. 0-Disabled, the IP phone will enter Local Calls screen when pressing the History soft Permitted key.
Troubleshooting Broadsoft Visual Voice Mail bw.voice_mail.visual.enable Parameter <y0000000000xx>.cfg It enables or disables the visual voice mail feature for the IP phone. Description Note: It works only if “bw.xsi.enable" is set to 1 (Enabled) and XSI is configured for account 1. 0-Disabled Permitted Values...
Page 567
It is not applicable to T19(P) E2 IP phones. Permitted Integer from 0 to 2147483647 Values Default X is the account ID. For T54S/T48S/T48G/T46S/T46G/T29G, X=1-16; for T52S/T42G/T42S, X=1-12; for T41P/T41S/T27P/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2; for T19(P) E2, X=1.
Troubleshooting Broadsoft Call Park features.call_park.group_enable Parameter <y0000000000xx>.cfg It enables or disables the IP phone to display the GPark soft key during a call. Description Note: If it is set to 1 (Enabled), the Retrieve soft key will also be displayed on the dialing screen.
If you change this parameter, the IP phone will reboot to make the change take effect. X is the account ID. For T54S/T48S/T48G/T46S/T46G/T29G, X=1-16; for T52S/T42G/T42S, X=1-12; for T41P/T41S/T27P/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2; for T19(P) E2, X=1.
It configures the URL the phone sends when the ACD agent changes the status to away (you press the Away soft key on the phone). For example : account.1.acd.away_url= Description http://portal-dev.star2star.com:8181/yealink/reason_code_response?reason_code=#R EASONCODE&agent_extension=ext_843 85&agent_location= starbox_628&agent_phone=94&customer_id=435s #REASONCODE will be automatically replaced with the away code you entered when...
Note: It works only if “account.X.sip_server_type” is set to 12 (Star2Star). Permitted String Values Blank Default X is the account ID. For T54S/T48S/T48G/T46S/T46G/T29G, X=1-16; for T52S/T42G/T42S, X=1-12; for T41P/T41S/T27P/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2; for T19(P) E2, X=1. Ethernet Interface MTU Parameter static.network.mtu_value Parameter <y0000000000xx>.cfg It configures the MTU (Maximum Transmission Unit) of network interface card.
Page 572
Troubleshooting example. Default value of User-Agent: Yealink SIP-T27G 69.83.0.10 If it is set to Myphone, the User-Agent appears as below: Yealink SIP-T27G 69.83.0.10 Myphone Permitted String within 128 characters Values Blank Default account.X.call_id_mode Parameter <MAC>.cfg It configures the constitution of call ID.
Page 573
Troubleshooting Default sip.unreg_with_socket_close <y0000000000xx>.cfg Parameter It enables or disables the IP phone to close the socket immediately when the user Description deregisters the corresponding account(s). 0-Disabled Permitted Values 1-Enabled Default account.X.check_cseq.enable <MAC>.cfg Parameter It enables or disables the IP phone to check if the CSeq sequence number in the Description request is lower than that in previous request on the same dialog.
Page 574
Troubleshooting 0-random source port (non 506x), fixed ports (506x) carried in the Contact, Via header. Permitted 1-random source port (non 506x) and other ports (non 506x) carried in the Contact, Values Via header Default sip.listen_mode Parameter <y0000000000xx>.cfg It configures the listening mode. Description 0-according to the transport protocol 1-listening TCP and UDP...
Troubleshooting Values 1-Enabled Default sip.reliable_protocol.timerae.enable Parameter <y0000000000xx>.cfg It enables or disables the timer for ict and nict when TCP protocol is used. Description Note: This parameter can be used for fast failover purpose when TCP connection fails. 0-Disabled Permitted Values 1-Enabled Default sip.mac_in_ua...
Page 576
Troubleshooting arrives when the user selects a contact from directory/call log lists to transfer a call/to set up a conference with/to place a new call. Default phone_setting.end_call_net_disconnect.enable Parameter <y0000000000xx>.cfg It enables or disables the IP phone to end the call if network is unavailable during the Description call.
Log Files Yealink IP phone can log events into two different log files: boot log and system log. You can choose to generate the log files locally or sent to syslog server in real time, and use these log files to generate informational, analytic and troubleshoot phones.
Page 578
Troubleshooting Local Syslog Server Description It reports the logs with a configured severity level and the higher. For example, if you have sys.log <MAC>-sys.log configured the severity level of the log to be reported to the this file to 4, then the log with a severity level of 0 to 4 will all be reported.
Page 579
(2) If “static.auto_provision.local_log.backup.enable” is set to 0 (Disabled), the IP phone will erase half of the logs from the oldest log information on the phone. Example: static.local_log.max_file_size = 1024 For T54S/T52S/T48S/T48G/T46S/T46G/T42G/T42S/T41P/T41S/T29G/T27P/T27G IP phones: Permitted Integer from 1024 to 2048 Values...
Page 580
Troubleshooting Settings->Configuration->Max Log File Size (256-1024KB) static.auto_provision.local_log.backup.enable Parameter <y0000000000xx>.cfg It enables or disables the IP phone to upload the local log files (<MAC>-boot.log and <MAC>-sys.log) to the provisioning server or a specific server. Description Note: The upload path is configured by the parameter “static.auto_provision.local_log.backup.path”.
Page 581
Troubleshooting static.auto_provision.local_log.backup.path = tftp://10.3.6.133/upload/ Note: It works only if “static.auto_provision.local_log.backup.enable” is set to 1 (Enabled). Permitted URL within 1024 characters Values Blank Default static.auto_provision.local_log.backup.append <y0000000000xx>.cfg Parameter It configures whether the uploaded local log files (<MAC>-boot.log and Description <MAC>-sys.log) overwrite the existing files or are appended to the existing files. 0-Overwrite Permitted Values...
Page 582
Troubleshooting Default Exporting the Log Files to a Local PC From the web user interface, navigate to Settings->Configuration. Select Enabled from the pull-down list of Enable Local Log. Select 6 from the pull-down list of Local Log Level. The default local log level is “3”. Enter the limit size of the log files in the Max Log File Size field.
Page 583
Troubleshooting The boot.log file reports the logs with all severity levels. The following figure shows a portion of a sys log file (for example, 00156574b150-sys.log): Syslog Logging You can also configure the IP phone to send syslog messages to a syslog server in real time. You can specify syslog details such as IP address or host name, server type, facility, and the severity level of events you want to log.
Page 584
Troubleshooting It enables or disables the IP phone to upload log messages to the syslog server in real Description time. 0-Disabled Permitted Values 1-Enabled Default Settings->Configuration->Enable Syslog Feature Web UI static.syslog.server Parameter <y0000000000xx>.cfg It configures the IP address or domain name of the syslog server when exporting log to the syslog server.
Page 585
Troubleshooting When you choose a log level, it includes all events of an equal or higher severity level and excludes events of a lower severity level. The logging level you choose determines the lowest severity of events to log. 0-Emergency: system is unusable 1-Alert: action must be taken immediately 2-Critical: critical conditions Permitted...
Troubleshooting 21-local use 5 (local5) 22-local use 6 (local6) 23-local use 7 (local7) Default Settings->Configuration->Syslog Facility Web UI static.syslog.prepend_mac_address.enable Parameter <y0000000000xx>.cfg It enables or disables the IP phone to prepend the MAC address to the log messages Description exported to the syslog server. 0-Disabled Permitted Values...
Page 587
Troubleshooting reset. Changes associated with non-static settings made via web user interface and phone user interface are saved in the <MAC>-local.cfg file. Reset non-static settings: All non-static parameters will be reset. After resetting the non-static settings, the IP phone will perform auto provisioning immediately. Reset static settings: All static parameters will be reset.
Page 588
Troubleshooting Default Resetting the IP phone to Default Factory Settings Procedure Click Settings->Upgrade. Click Reset to Factory in the Reset to Factory field. The web user interface prompts the message “Do you want to reset to factory?”. Click OK to confirm the resetting. The IP phone will be reset to factory sucessfully after startup.
Ethernet Software Capturing Configuration Capturing the Packets via Web User Interface For Yealink IP phones, you can export the packets file to the local system and analyze it. Yealink IP phones support the following two modes for capturing the packets: Normal: Export the packets file after stopping capturing.
Page 590
Troubleshooting Topics Capturing the Packets in Normal Way Capturing the Packets in Enhanced Way Capturing the Packets in Normal Way Procedure From the web user interface, navigate to Settings->Configuration. Select Normal from the pull-down list of Pcap Type. Click Start in the Pcap Feature field to start capturing signal traffic. Reproduce the issue to get stack traces.
Troubleshooting Ethernet Software Capturing Configuration You can choose to capture the packets using the Ethernet software in two ways: Receiving data packets from the HUB: Connect the Internet port of the IP phone and the PC to the same HUB, and then use Sniffer, Ethereal or Wireshark software to capture the signal traffic. Receiving data packets from PC port: Connect the Internet port of the IP phone to the Internet and ...
Troubleshooting phone status and provides the ability to get stack traces from the last time the IP phone failed. If Watch Dog feature is enabled, the IP phone will automatically reboot when it detects a fatal failure. This feature can be configured using the configuration files or via web user interface. Topic Watch Dog Configuration Watch Dog Configuration...
We recommend you to edit the exported CFG file instead of the BIN file to change the phone’s current settings. The config.bin file is an encrypted file. For more information on config.bin file, contact your Yealink reseller. Topics Exporting BIN Files from the Phone...
If you change this parameter, the IP phone will reboot to make the change take effect. Exporting All the Diagnostic Files Yealink IP phones support three types of diagnostic files (including Pcap trace, log files (boot.log and sys.log) and BIN configuration files) to help analyze your problem. You can export these files at a time and troubleshoot if necessary.
Troubleshooting Phone Status Available information on phone status includes: General information (IPv4 address or IPv6 address, phone MAC address, Wi-Fi dongle MAC address and firmware version). Network status (IPv4 status or IPv6 status, IP mode, phone MAC address and Wi-Fi dongle MAC ...
Page 596
Troubleshooting Rebooting the IP Phone via Web User Interface Rebooting the IP Phone Remotely You can reboot the IP phones remotely using a SIP NOTIFY message with “Event: check-sync” header. Whether the IP phone reboots or not depends on the value of the parameter “sip.notify_reboot_enable”. If the value is set to 1, or the value is set to 0 and the header of the SIP NOTIFY message contains an additional string “reboot=true”, the IP phone will reboot immediately.
The phone begins rebooting. Any reboot of the phone may take a few minutes. Troubleshooting Solutions This section describes solutions to common issues that may occur while using the IP phone. Upon encountering a case not listed in this section, contact your Yealink reseller for further support. Topics IP Address Issues...
Scenario 2: Yealink IP phones support using FTP, TFTP, HTTP and HTTPS protocols to download configuration files or resource files. You can use one of these protocols for provisioning. When provisioning your IP phone obtaining an IPv6 address, the provisioning server should support IPv6 tftp://[IPv6 address or domain and the format of the access URL of the provisioning server can be “...
Troubleshooting Display Issues The phone LCD screen blank Do one of the following: Ensure that the IP phone is properly plugged into a functional AC outlet. Ensure that the IP phone is plugged into a socket controlled by a switch that is on. ...
The phone cannot connect to Bluetooth devices all the time Try to delete the registration information of the Bluetooth device on both IP phone and Bluetooth device, and then pair and connect it again. Contact Yealink field application engineer and your Bluetooth device manufacturer for more information.
Press the OK/√ key when the IP phone is idle to check the firmware version. For example: 28.82.0.20. Item Description Firmware ID. The firmware ID for each IP phone model is: 70: T54S/T52S 35: T48G 28: T46G ...
Troubleshooting Item Description 52: T21(P) E2 53: T19(P) E2 Firmware generation. Note: The larger it is, the newer the firmware generation is. A fixed number. Firmware version. Note: With the same firmware generation, the larger it is, the newer the firmware version is. The IP phone does not update the configurations Do one of the following: Ensure that the configuration is set correctly.
If the power LED indicator is on, the keypad is usable but the LCD screen is black, please reboot your IP phone. The IP phone always display the Yealink logo If your IP phone does not boot, check if the provisioning server is accessible on the network and a valid software firmware and valid configuration files are available.
Troubleshooting Other Issues The difference among user name, register name and display name Both user name and register name are defined by the server. User name identifies the account, while register name matched with a password is for authentication purposes. Display name is the caller ID that will be displayed on the callee’s phone LCD screen.
Page 605
Troubleshooting The difference between Shared Call Appearance (SCA) and Bridge Lines Appearance (BLA) SCA and BLA are similar signaling methods that enable more than one phone to share a SIP line. The method you use varies with the SIP server you are using. In the configuration files, the relevant configuration parameters of SCA and BLA are different.
Appendix Appendix RFC and Internet Draft Support The following RFC’s and Internet drafts are supported: RFC 1321—The MD5 Message-Digest Algorithm RFC 1889—RTP Media control RFC 2112—Multipart MIME RFC 2327—SDP: Session Description Protocol RFC 2387—The MIME Multipart/Related Content-type ...
Page 607
Appendix RFC 3262—Reliability of Provisional Responses in the Session Initiation Protocol (SIP) RFC 3263—Session Initiation Protocol (SIP): Locating SIP Servers RFC 3264—An Offer/Answer Model with the Session Description Protocol (SDP) RFC 3265—Session Initiation Protocol (SIP) - Specific Event Notification ...
Page 608
Appendix RFC 3489—STUN - Simple Traversal of User Datagram Protocol (UDP) Through Network Address Translators (NATs) RFC 3515—The Session Initiation Protocol (SIP) Refer Method RFC 3550—RTP: Transport Protocol for Real-Time Applications RFC 3555—MIME Type Registration of RTP Payload Formats ...
Page 609
Appendix RFC 3960—Early Media and Ringing Tone Generation in SIP RFC 3966—The tel URI for telephone number RFC 3968—IANA Registry for SIP Header Field RFC 3969—IANA Registry for SIP URI RFC 4028—Session Timers in the Session Initiation Protocol (SIP) ...
Page 610
Appendix RFC 4730—Event Package for KPML RFC 5009—P-Early-Media Header RFC 5079—Rejecting Anonymous Requests in SIP RFC 5359—Session Initiation Protocol Service Examples RFC 5589—Session Initiation Protocol (SIP) Call Control – Transfer RFC 5630—The Use of the SIPS URI Scheme in SIP ...
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 Icons T23P/T23 T54S/ T42S/ T42G/ T40P T19(P) T48S T48G...
Page 612
Appendix T23P/T23 T54S/ T42S/ T42G/ T40P T19(P) T48S T48G T46S T46G T29G T27G T27P Description G/T21(P) T52S T41S T41P Headset mode Voice Mail Text Message Auto Answer Do Not Disturb Call Forward Call Hold Call Mute Keep Mute...
Page 614
Appendix T23P/T23 T54S/ T42S/ T42G/ T40P T19(P) T48S T48G T46S T46G T29G T27G T27P Description G/T21(P) T52S T41S T41P Recording box is full (DSSKey recording) A call cannot be recorded (DSSKey recording) Recording starts successfully (DSSKey recording) Recording cannot be...
Page 615
Appendix T23P/T23 T54S/ T42S/ T42G/ T40P T19(P) T48S T48G T46S T46G T29G T27G T27P Description G/T21(P) T52S T41S T41P Bluetooth headset is both paired and connected Bluetooth-Enabled mobile phone is both paired and connected Wi-Fi connection is successful Wi-Fi connection...
Page 616
Appendix T23P/T23 T54S/ T42S/ T42G/ T40P T19(P) T48S T48G T46S T46G T29G T27G T27P Description G/T21(P) T52S T41S T41P Line key type is Speed Dial Line key type is BLF/BLF List (BLF/BLF list idle state) Line key type is BLF/BLF List (BLF/BLF...
Page 617
Appendix T23P/T23 T54S/ T42S/ T42G/ T40P T19(P) T48S T48G T46S T46G T29G T27G T27P Description G/T21(P) T52S T41S T41P Line key type is BLF List (BLF list call park state) Line key type is Voice Mail Line key type is...
Page 618
Appendix T23P/T23 T54S/ T42S/ T42G/ T40P T19(P) T48S T48G T46S T46G T29G T27G T27P Description G/T21(P) T52S T41S T41P Line key type is Retrieve Park Line key type is Intercom (intercom idle state) Line key type is Intercom (intercom ringing state)
Page 619
Appendix T23P/T23 T54S/ T42S/ T42G/ T40P T19(P) T48S T48G T46S T46G T29G T27G T27P Description G/T21(P) T52S T41S T41P Line key type is Local Group/XML Group/LDAP Line key type is XML Browser Line key type is Conference Line key type is...
Page 620
Appendix T23P/T23 T54S/ T42S/ T42G/ T40P T19(P) T48S T48G T46S T46G T29G T27G T27P Description G/T21(P) T52S T41S T41P Line key type is Record/URL Record Line key type is Record/URL Record (recording starts successfully) Line key type is Multicast Paging/Group...
Page 621
Appendix T23P/T23 T54S/ T42S/ T42G/ T40P T19(P) T48S T48G T46S T46G T29G T27G T27P Description G/T21(P) T52S T41S T41P Line key type is Phone Lock Line key type is Directory Line key type is Custom Key The ACD state is...
Page 622
Appendix T23P/T23 T54S/ T42S/ T42G/ T40P T19(P) T48S T48G T46S T46G T29G T27G T27P Description G/T21(P) T52S T41S T41P (Flashing) (Flashing) tone The shared line receives an incoming (Flashing) call (Flashing) The shared line is in conversation The shared line...
Need help?
Do you have a question about the T54S and is the answer not in the manual?
Questions and answers