Page 2: Before You Begin
For more information on configuring and administering other Yealink products not included in this guide, refer to the product support page at Yealink Technical Support. To access the latest Release Notes or other guides for Yealink devices, refer to the Document Download page for your phone at Yealink Technical Support.
Page 3: Changes For Release V85, Guide Version V85.1
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Changes for Release V85, Guide Version V85.1 The following sections are new for this version: Out of Service PIN Code Provisioning Settings Configuration Smart Noise Filtering Unify Parameters Example: Using VPN based on L2TP Prototol Exporting the OpenVPN Configuration File from the Phone Importing the OpenVPN Configuration File to Phone Dsskey Page Reset Configuration...
Page 4: Table Of Contents
Summary of Changes Changes for Release V85, Guide Version V85.1 Table of Contents Getting Started Requirements Yealink IP Phones in a Network Initialization Process Overview Loading the ROM File Configuring the VLAN Querying the DHCP (Dynamic Host Configuration Protocol) Server...
Page 5 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Wi-Fi Wi-Fi Configuration Wireless Network IP Addressing Mode Configuration IPv4 Wireless Network Configuration IPv6 Wireless Network Configuration Real-Time Transport Protocol (RTP) Ports RTP Ports Configuration Network Address Translation (NAT) NAT Traversal Configuration Keep Alive Configuration Rport Configuration SIP Port and TLS Port Configuration...
Page 6 Table of Contents Files Download Process Provisioning Methods Provisioning Methods Priority Web User Interface Accessing the Web User Interface Quick Login Configuration Web Server Type Configuration Navigating the Web User Interface Phone User Interface Central Provisioning Auto Provisioning Settings Configuration User-Triggered Provisioning Settings Configuration PIN Code Provisioning Settings Configuration Viewing Configurations Configured via Different Provisioning Methods...
Page 7 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones SRTP Configuration Encrypting and Decrypting Files Configuration Files Encryption Tools Configuration Files Encryption and Decryption Contact Files Encryption and Decryption Encryption and Decryption Configuration Incoming Network Signaling Validation Incoming Network Signaling Validation Configuration USB Port Lock USB Port Lock Configuration Firmware Upgrade...
Page 8 Table of Contents Custom Handset Related Configurations Handset Firmware Upgrade Configuration Audio Features Alert Tone Alert Tone Configuration Touch Tone Touch Tone Configuration Ring Tones Custom Ringtone Limit Ringtone Configuration Distinctive Ring Tones Supported Alert-Info Headers Format Alert-Info: Bellcore-drN Alert-Info: ringtone-N/Alert-Info: ringtone-RingN.wav (or Alert-Info: MyMelodyN/Alert-Info: MyMelodyRingN.wav) Alert-Info: <URL >...
Page 9 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Voice Activity Detection (VAD) VAD Configuration Comfort Noise Generation (CNG) CNG Configuration Jitter Buffer Jitter Buffer Configuration Smart Noise Block Smart Noise Block Configuration Acoustic Shield Acoustic Shield Configuration Smart Noise Filtering Smart Noise Filtering Configuration DTMF DTMF Keypad...
Page 10 Table of Contents Contrast Contrast Configuration Wallpaper Wallpaper Configuration Wallpaper Customization Custom Wallpaper Picture Limit Custom Wallpaper Configuration Deleting a Custom Picture Adding a Wallpaper from a USB Flash Drive Example: Setting a Custom Picture as Wallpaper Transparency Transparency Configuration Screen Saver Screensaver Display Customization Screensaver File Elements and Attributes...
Page 11 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Time and Date Format Configuration Date Customization Rule Idle Clock Display Idle Clock Display Configuration Logo Customization Custom Logo Picture Limit Customizing a Logo Picture Custom Logo Configuration Example: Setting a Custom Logo Display Call Display Call Display Configuration Display Method on Dialing...
Page 12 Table of Contents Line Keys Line Keys Configuration Example: Set a Park/Retrieve Key for FAC Call Park Mode Example: Set a Park/Retrieve Key for Transfer Call Park Mode Example: Setting a Line Key as Directed Pickup Key Example: Setting a Line Key as Group Pickup Key Example: Setting a Line Key as Forward Key Example: Setting a Line Key as BLF List Key Example: Setting a Line Key as Private Hold Key...
Page 13 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones SIP Accounts Registration Configuration PSTN Account Configuration Registration Settings Configuration Outbound Proxy in Dialog Outbound Proxy in Dialog Configuration Server Redundancy Behaviors When Working Server Connection Fails Registration Method of the Failover/Fallback Mode Fallback Server Redundancy Configuration Failover Server Redundancy Configuration SIP Server Name Resolution...
Page 14 Table of Contents Customizing Remote Phone Book File Remote Phone Book Configuration Example: Configuring a Remote Phone Book Directory List for Directory/Dir Soft Key Directory List File Customization Directory List File Attributes Customizing Directory List File Directory List Configuration Example: Configuring a Directory List Directory Search Settings Directory Search Settings Configuration Number Matching Settings...
Page 15 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Auto Redial Auto Redial Configuration Recall Configuration Speed Dial Speed Dial Key Configuration Password Dial Password Dial Configuration Call Timeout Call Timeout Configuration Anonymous Call Anonymous Call Configuration Call Number Filter Call Number Filter Configuration IP Address Call IP Address Call Configuration...
Page 16 Table of Contents Call Forward in Phone Mode Configuration Call Forward in Custom Mode Configuration Call Forward Synchronization for Server-side Configuration Call Transfer Call Transfer Configuration Transfer Mode for Dsskey Configuration Conference Conference Type Configuration Local Conference Configuration Network Conference Configuration USB Recording USB Recording Configuration Multicast Paging...
Page 17 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Example: Configuring Visual and Audio Alert for Monitor Lines LED Mode for BLF/BLF List Key Supported BLF LED Modes BLF LED Mode Configuration BLF/BLF List Key LED Status and Behavior Configuration Supported BLF/BLF List Key Behaviors BLF Key LED/Icon and Behavior for Idle State Configuration BLF Key LED/Icon and Behavior for Call-in State Configuration...
Page 18 Table of Contents XML Browser XML Browser Configuration Hot Desking Hot Desking Key Configuration Hot Desking Configuration General Features Line Identification Presentation CLIP and COLP Configuration Return Code for Refused Call Return Code for Refused Call Configuration Return Code for Unanswered Call Return Code for Unanswered Call Configuration Hide Feature Access Codes Hide Feature Access Codes Configuration...
Page 19 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Broadsoft Call Decline Broadsoft Network Directory Broadsoft Visual Voice Mail Broadsoft SCA Broadsoft Call Park Broadsoft Emergency Call BroadSoft Call Waiting Sync Start2Start ACD Parameters Alcatel-Lucent Barge in Parameters Ethernet Interface MTU Parameters SIP Settings Parameters Call Settings Parameters Unify Parameters...
Page 20 Fail to export the system log to a provisioning server (FTP/TFTP server) Fail to export the system log to a syslog server Protocols and Ports Issues What communication protocols and ports do Yealink IP phones support? Password Issues Restore the administrator password...
Page 21 Both PoE cable and power adapter is connected to the phone The power LED indicator has no lights The Phone screen is black The IP phone always displays the Yealink logo Other Issues The difference among user name, register name, and display name...
Page 22 Table of Contents...
Page 23: Getting Started
There are many ways to set up a phone network using Yealink phones. The following shows an example of a net- work setup:...
Page 24: Initialization Process Overview
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Initialization Process Overview The initialization process of the device is responsible for network connectivity and operation of the device in your local network. Once you connect your device to the network and to an electrical supply, the device begins its ini- tialization process.
Page 25: Configuring The Vlan
Getting Started Configuring the VLAN If you connect the device to a switch, the switch notifies the device of the VLAN information defined on the switch (if using LLDP or CDP). The device can then proceed with the DHCP request for its network settings (if using DHCP). Querying the DHCP (Dynamic Host Configuration Protocol) Server The device is capable of querying a DHCP server.
Page 26: Network Configurations
Host Configuration Protocol (DHCPv4 or DHCPv6) server. We recommend using DHCP where possible to elim- inate repetitive manual data entry. You can also configure IPv4 or IPv6 network settings manually. Note RFC 2131 : Yealink devices comply with the DHCPv4 specifications documented in , and DHCPv6 specifications doc- RFC 3315 umented in Topics...
Page 27: Ipv4 Wired Network Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Parameter static.network.preference <y0000000000xx>.cfg It specifies IPv4 or IPv6 as the preferred wired network in a Dual-Stack mode. Description Note: It works only if “static.network.ip_address_mode” is set to 2 (IPv4 & IPv6). 0-IPv6 Permitted Values...
Page 28 Network Configurations Menu > Settings > Advanced Settings (default password: admin) > Network > WAN Port > IPv4 Parameter static.network.internet_port.ip <y0000000000xx>.cfg It configures the IPv4 address for the wired network. Description Note: It works only if “static.network.ip_address_mode” is set to 0 (IPv4) or 2 (IPv4 & IPv6), and "stat- ic.network.internet_port.type"...
Page 29 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Other Phones: Network > Basic > IPv4 Config > Static IP Address > Default Gateway Color Screen Phones: Menu > Advanced (default password: admin) > Network > WAN Port > IPv4 > Static IP > Default Gate- Phone UI Black-and-white Screen Phones: Menu >...
Page 30: Ipv6 Wired Network Configuration
Network Configurations Menu > Settings > Advanced Settings (default password: admin) > Network > WAN Port > IPv4 > DHCP IPv4 Client > Static DNS (Enabled) > Pri.DNS Parameter static.network.secondary_dns <y0000000000xx>.cfg It configures the secondary IPv4 DNS server for the wired network. Description Note: It works only if “static.network.ip_address_mode”...
Page 31 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Other Phones: Network > Basic > IPv6 Config Color Screen Phones: Menu > Advanced (default password: admin) > Network > WAN Port > IPv6 Phone UI Black-and-white Screen Phones: Menu > Settings > Advanced Settings (default password: admin) > Network > WAN Port > IPv6 Parameter static.network.ipv6_internet_port.ip <y0000000000xx>.cfg It configures the IPv6 address for the wired network.
Page 32 Network Configurations Note: It works only if “static.network.ip_address_mode” is set to 1 (IPv6) or 2 (IPv4 & IPv6), and "stat- ic.network.ipv6_internet_port.type" is set to 1 (Static IP). Permitted IPv6 Address Values Default Blank T57W/T54W/T53W/T53/T48U/T46U/T43U/T42U: Network > Basic > IPv6 Config > Configuration Type (Static IP) > Default Gateway Web UI Other Phones: Network >...
Page 33 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones In DHCP environment: Menu > Advanced (default password: admin) > Network > WAN Port > IPv6 > DHCP > Static DNS (Enabled) > Primary DNS Black-and-white Screen Phones: Menu > Settings > Advanced Settings (default password: admin) > Network > WAN Port > IPv6 > Static IPv6 Client >...
Page 34: Dhcp Option For Ipv4
DHCP Option 42, Option 2 and Option 100 DHCP Option 12 DHCP Option 120 DHCP Option 60 Supported DHCP Option for IPv4 The following table lists common DHCP options for IPv4 supported by Yealink phones. DHCP Parameters Description Option Subnet Mask Specify the client’s subnet mask.
Page 35: Dhcp Option 42, Option 2 And Option 100
DHCP Option 42, Option 2 and Option 100 Yealink phones support using the NTP server address offered by DHCP. DHCP option 42 is used to specify a list of NTP servers available to the client by IP address. NTP servers should be listed in order of preference.
Page 36: Dhcp Option 120
Network Configurations For T41P phones: SIP-T41P. For T41S phones: SIP-T41S. For T40P phones: SIP-T40P. For T40G phones: SIP-T40G. For T29G phones: SIP-T29G. For T27G phones: SIP-T27G. For T23P phones: SIP-T23P. For T23G phones: SIP-T23G. For T21(P) E2 phones: SIP-T21P_E2. For T19(P) E2 phones: SIP-T19P_E2. For CP920 phones: SIP-CP920.
Page 37: Dhcp Option 60 Configuration
The phone can obtain IPv6-related parameters in an IPv6 network via DHCP option. Topics Supported DHCP Option for IPv6 DHCP Option 59 and Custom Option Supported DHCP Option for IPv6 The following table lists common DHCP options for IPv6 supported by Yealink phones. DHCP Parameters Description Option DNS Server Specify a list of DNS servers available to the client.
Page 38: Vlan
In addition to manual configuration, the phone also supports the automatic discovery of VLAN via LLDP, CDP or DHCP. The assignment takes effect in this order: assignment via LLDP/CDP, manual configuration, then assign- ment via DHCP. For more information on VLAN, refer to VLAN Feature on Yealink IP Phones. Topics LLDP Configuration...
Page 39: Cdp Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Web UI Network > Advanced > LLDP > Packet Interval (1~3600s) Color Screen Phones: Menu > Advanced (default password: admin) > Network > LLDP > Packet Interval Phone UI Black-and-white Screen Phones: Menu >...
Page 40: Manual Vlan Configuration
Network Configurations Manual VLAN Configuration You can configure VLAN for the Internet port and PC port manually. Before configuring VLAN on the phones, you need to obtain the VLAN ID from your network administrator. For CP920 phones, you can only configure VLAN for the Internet port manually, because they only have an Internet port.
Page 41 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Black-and-white Screen Phones: Menu > Settings > Advanced Settings (default password: admin) > Network > VLAN > WAN Port > Pri- ority Parameter static.network.vlan.pc_port_enable <y0000000000xx>.cfg It enables or disables the VLAN for the PC port. Description Note: It works only if “static.network.pc_port.enable”...
Page 42: Dhcp Vlan Configuration
Network Configurations Web UI Network > Advanced > VLAN > PC Port > Priority Color Screen Phones: Menu > Advanced (default password: admin) > Network > VLAN > PC Port > Priority Phone UI Black-and-white Screen Phones: Menu > Settings > Advanced Settings (default password: admin) > Network > VLAN > PC Port > Pri- ority If you change this parameter, the phone will reboot to make the change take effect.
Page 43: Wi-Fi
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones It enables or disables the phone to obtain VLAN ID using lower preference of VLAN assignment method, or to close the VLAN feature when the phone cannot obtain VLAN ID. Description The priority of each method is LLDP/CDP >...
Page 44 Network Configurations Parameter static.network.redundancy.failback.timeout <y0000000000xx>.cfg It configures the time to wait (minutes) for the phone to switch to the preferentially used network. Description Note: It works only if “static.network.redundancy.mode” is set to 1 or 2. Integer from 0 to 1440 0-The phone will not switch as long as the current network is available.
Page 45 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Parameter static.wifi.X.priority <y0000000000xx>.cfg It configures the priority for a specific wireless network. 5 is the highest priority, 1 is the lowest priority. Description Note: It works only if “static.wifi.enable” is set to 1 (Enabled). Permitted Integer from 1 to 5 Values...
Page 46 Network Configurations Web UI Network > Wi-Fi > Add > Password Color Screen Phones: Menu > Basic > Wi-Fi > Wi-Fi (On) > Known Network (press Add) > Password Menu > Basic > Wi-Fi > Wi-Fi (On) > Known Network > Option > Edit > Password Phone UI Black-and-white Screen Phones: Menu >...
Page 47 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Default Blank Supported T57W, T54W, T53W, T53, T48U, T46U, T43U, T42U, T48S, T46S, T42S, T41S, T27G and CP920 Devices Web UI Network > Wi-Fi > Add > Anonymous Identity Color Screen Phones: Menu >...
Page 48: Wireless Network Ip Addressing Mode Configuration
Network Configurations Wireless Network IP Addressing Mode Configuration The following table lists the parameters you can use to configure IP addressing mode for the wireless network. Parameter static.network.wifi.ip_address_mode <y0000000000xx>.cfg Description It configures the IP addressing mode for the wireless network. 0-IPv4 Permitted 1-IPv6...
Page 49 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Default Supported T57W, T54W, T53W, T53, T48U, T48S, T46U, T46S, T43U, T42U, T42S, T41S, T27G, CP920 Devices T57W/T54W/T53W/T53/T48U/T46U/T43U/T42U: Network > Wi-Fi > IPv4 Config > Configuration Type Web UI Other Phones: Network >...
Page 50 Network Configurations Network > Wi-Fi > IPv4 Config > Static IP Address > Subnet Mask Color Screen Phones: Menu > Advanced (default password: admin) > Network > Wi-Fi Port > IPv4 > Static IP > Subnet Mask Phone UI Black-and-white Screen Phones: Menu >...
Page 51 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones It configures the primary IPv4 DNS server for the wireless network. Note: It works only if “static.network.wifi.ip_address_mode” is set to 0 (IPv4) or 2 (IPv4 & IPv6). In Description DHCP environment, you also need to make sure “static.network.wifi.static_dns_enable" is set to 1 (On).
Page 52: Ipv6 Wireless Network Configuration
Network Configurations Black-and-white Screen Phones: Menu > Settings > Advanced Settings (default password: admin) > Network > Wi-Fi Port > IPv4 > Static IPv4 Client > Sec.DNS In DHCP environment: Menu > Settings > Advanced Settings (default password: admin) > Network > Wi-Fi Port > IPv4 > DHCP IPv4 Client >...
Page 53 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Network > Wi-Fi > IPv6 Config > Configuration Type (Static IP) > IP Address Other Phones: Network > Wi-Fi > IPv6 Config > Static IP Address > IP Address Color Screen Phones: Menu >...
Page 54 Network Configurations Black-and-white Screen Phones: Menu > Settings > Advanced Settings (default password: admin) > Network > Wi-Fi Port > IPv6 > Static IPv6 Client > Default Gateway Parameter static.network.wifi.ipv6_static_dns_enable <y0000000000xx>.cfg It triggers the static IPv6 DNS feature to on or off for the wireless network. Description Note: It works only if “static.network.wifi.ipv6_internet_port.type”...
Page 55: Real-Time Transport Protocol (Rtp) Ports
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones DHCP IPv6 Client > Static DNS(Enabled) > Pri.DNS Parameter static.network.wifi.ipv6_secondary_dns <y0000000000xx>.cfg It configures the secondary IPv6 DNS server for the wireless network. Note: It works only if “static.network.wifi.ip_address_mode" is set to 1 (IPv6) or 2 (IPv4 & IPv6). In Description DHCP environment, you also need to make sure “static.network.wifi.ipv6_static_dns_enable"...
Page 56: Rtp Ports Configuration
Network Configurations The UDP port used for RTP streams is traditionally an even-numbered port. If the port 11780 is used to send and receive RTP for the first voice session, additional calls would then use ports 11782, 11784, 11786, and so on. The phone is compatible with RFC 1889 - RTP: A Transport Protocol for Real-Time Applications - and the updated...
Page 57 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Yealink phones support three NAT traversal techniques: manual NAT, STUN and ICE. If you enable manual NAT and STUN, the phone will use the manually-configured external IP address for NAT traversal. The TURN protocol is used as part of the ICE approach to NAT traversal.
Page 58 Network Configurations Web UI Network > NAT > STUN > Active Color Screen Phones: Menu > Advanced (default password: admin) > Network > NAT > NAT Status Phone UI Black-and-white Screen Phones: Menu > Settings > Advanced Settings (default password: admin) > Network > NAT > NAT Status Parameter static.sip.nat_stun.server <y0000000000xx>.cfg It configures the IP address or domain name of the STUN server.
Page 59: Keep Alive Configuration
If you change this parameter, the phone will reboot to make the change take effect. Keep Alive Configuration Yealink phones can send keep-alive packets to the NAT device for keeping the communication port open. The following table lists the parameters you can use to configure keep alive.
Page 60: Rport Configuration
Network Configurations Parameter account.X.nat.udp_update_enable <MAC>.cfg Description It sets the type of keep-alive packets sent by phone. 0-Disabled 1-Default (the phone sends the corresponding packets according to the transport protocol) Permitted Values 2-Options (the phone sends SIP OPTIONS packets to the server) 3-Notify (the phone sends SIP NOTIFY packets to the server) Default Web UI...
Page 61: Internet Port And Pc Port
Settings > SIP > TLS SIP Port Internet Port and PC Port Yealink phones support two Ethernet ports: Internet port and PC port. You can enable or disable the PC port on the phones. The CP920 phones have Internet port only.
Page 62 Network Configurations Default Sup- ported All phones except CP920 Devices Web UI Network > PC Port > PC Port Active Para- static.network.internet_port.speed_duplex <y0000000000xx>.cfg meter It configures the network speed over Ethernet of the Internet port. Note: For Descrip- T57W/T54W/T53W/T53/T48U/T48S/T48G/T46U/T46S/T46G/T43U/T42U/T42G/T42S/T40G/T29G/T27G/- tion T23G/CP920 phones, you can set the transmission speed to 1000Mbps/Auto Negotiation to transmit in 1000Mbps if the phone is connected to the switch supports Gigabit Ethernet.
Page 63: Vpn
The VPN-related files include certificates (ca.crt and client.crt), key (client.key) and the configuration file (vpn.cnf) of the VPN client. The following table lists the name of the OpenVPN certificates and key in the configuration file (vpn.cnf) for Yealink phones:...
Page 64: Vpn Configuration
Network Configurations VPN Files Description client.crt Client certificate client.key Private key of the client VPN Configuration The following table lists the parameters you can use to configure the VPN. Parameter static.network.vpn_enable <y0000000000xx>.cfg Description It enables or disables the VPN feature. 0-Disabled Permitted Values...
Page 65: Example: Using Vpn Based On L2Tp Prototol
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Devices Web UI Network > Advanced > VPN > Mode Parameter static.network.l2tp_server.address <y0000000000xx>.cfg It configures the L2TP server address. Description Note: It works only if "static.network.vpn.mode" is set to 0 (L2TP). Permitted String within 512 characters Values...
Page 66: Exporting The Openvpn Configuration File From The Phone
Network Configurations static.network.l2tp_server.username = vpnuser static.network.l2tp_server.password = 0123456 2. After provisioning, connect the phone to the VPN environment. Exporting the OpenVPN Configuration File from the Phone You can export the OpenVPN configuration file via web user interface. Procedure 1. From the web user interface, click Network > Advanced > VPN. 2.
Page 67: 802.1X Authentication
Network > Advanced > Voice QoS > SIP QoS (0~63) If you change this parameter, the phone will reboot to make the change take effect. 802.1x Authentication Yealink phones support the following protocols for 802.1x authentication: EAP-MD5 EAP-TLS (requires Device and CA certificates, requires no password)
Page 68 Network Configurations 2-EAP-TLS 3-EAP-PEAP/MSCHAPv2 (EAP-MSCHAPv2) 4-EAP-TTLS/EAP-MSCHAPv2 5-EAP-PEAP/GTC 6-EAP-TTLS/EAP-GTC 7-EAP-FAST Default Web UI Network > Advanced > 802.1x > 802.1x Mode Color Screen Phones: Menu > Advanced (default password: admin) > Network > 802.1x > 802.1x Mode Phone UI Black-and-white Screen Phones: Menu >...
Page 69 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Menu > Settings > Advanced Settings (default password: admin) > Network > 802.1x > Identity Parameter static.network.802_1x.md5_password <y0000000000xx>.cfg It configures the password for 802.1x authentication. Description Note: It is required for all methods except EAP-TLS. Permitted String within 32 characters Values...
Page 70: Tr-069 Device Management
TR-069 uses common transport mechanisms (HTTP and HTTPS) for communication between CPE and ACS (Auto Configuration Servers). The HTTP(S) messages contain XML-RPC methods defined in the standard for configuration and management of the CPE. For more information on TR-069, refer to Yealink TR-069 Technote. Topics Supported RPC Methods...
Page 71 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Parameter static.managementserver.enable <y0000000000xx>.cfg Description It enables or disables the TR-069 feature. 0-Disabled Permitted Values 1-Enabled Default Web UI Settings > TR069 > Enable TR069 Parameter static.managementserver.username <y0000000000xx>.cfg It configures the TR-069 ACS server user name used to authenticate the phone. Description Leave it blank if no authentication is required.
Page 72 Network Configurations Web UI Settings > TR069 > Connection Request Password Parameter static.managementserver.periodic_inform_enable <y0000000000xx>.cfg Description It enables or disables the phone to periodically report its configuration information to the ACS server. 0-Disabled Permitted Values 1-Enabled Default Web UI Settings > TR069 > Enable Periodic Inform Parameter static.managementserver.periodic_inform_interval <y0000000000xx>.cfg It configures the interval (in seconds) at which the phone reports its configuration to the ACS server.
Page 73: Phone Provisioning
You can use boot files, configuration files, and resource files to configure phone features and apply feature settings to phones. You can create or edit these files using a text editor such as Notepad++. You can ask the distributor or Yealink FAE for template files. You can also obtain the template files online: http://sup- port.yealink.com/documentFront/forwardToDocumentFrontDisplayPage.
Page 74: Mac-Oriented Boot File
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones MAC-Oriented Boot File MAC-Oriented boot file, named <MAC>.boot. It will only be effective for a specific IP phone. In this way, you have high permission to control each phone by making changes on a per-phone basis. You can create a MAC-Oriented boot file for each phone by making a copy and renaming the boot template file (y000000000000.boot).
Page 75: Customizing A Boot File
Static: The parameters start with a prefix “static.”, for example, static.auto_provision.custom.protect. Non-static: The parameters do not start with a prefix “static.”, for example, local_time.date_format. You can deploy and maintain a mass of Yealink phones automatically through configuration files stored in a pro- visioning server.
Page 76: Common Cfg File
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Common CFG File Common CFG file, named <y0000000000xx>.cfg, contains parameters that affect the basic operation of the IP phone, such as language and volume. It will be effective for all phones in the same model. The common CFG file has a fixed name for each phone model.
Page 77: Mac-Local Cfg File
Phone Provisioning MAC-local CFG File MAC-local CFG file, which is named after the MAC address of the IP phone. For example, if the MAC address of an IP phone is 00156574B150, the name of the MAC-local CFG file is 00156574b150-local.cfg (lowercase). It contains changes associated with a non-static parameter that you make via the web user interface or phone user interface (for example, changes for time and date formats, ring tones, and DSS keys).
Page 78: Resource Files
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...
Page 79: Files Download Process
Phone Provisioning Template File File Name Description Reference in Section keyboard_lang.xml board Input Input Method File Cus- keyboard_ime_*.xml method. Method File tomization keyboard_layout_*.xml Replace Rule Replace Rule File DialPlan.xml Customize replace rules for the dial plan. Template Customization Dial Now Tem- Dial Now File Cus- DialNow.xml Customize dial now rules for the dial plan.
Page 80: Provisioning Methods
Provisioning Methods Yealink provides two ways to provision your phones: Manual Provisioning: provisioning via the local phone user interface or web user interface. Central Provisioning: provisioning through configuration files stored in a central provisioning server.
Page 81: Provisioning Methods Priority
Phone Provisioning Provisioning Methods Priority There is a priority for configuration among the provisioning methods - settings you make using a higher priority pro- visioning method override settings made using a lower priority provisioning method. The precedence order for configuration parameter changes is as follows (highest to lowest): Note : The provisioning priority mechanism takes effect only if “static.auto_provision.custom.protect”...
Page 82: Quick Login Configuration
The request URI for other phones: https://username:password@phoneIPAddress Example: https://admin:admin@192.168.0.10 Yealink phones support domain name customization. You can use a custom domain name to access the web user interface. Note : Accessing the web user interface by request URI may be restricted by the web explorer (for example, Internet Explorer).
Page 83: Web Server Type Configuration
Web Server Type Configuration Yealink phones support both HTTP and HTTPS protocols for accessing the web user interface. You can configure the web server type. Web server type determines the access protocol of the web user interface. If you disable to access the web user interface using the HTTP/HTTPS protocol, both you and the user cannot access the web user interface.
Page 84: Navigating The Web User Interface
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Menu > Advanced (default password: admin) > Network > Web Server > HTTPS Status Black-and-white Screen Phones: Menu > Settings > Advanced Settings (default password: admin) > Network > Web Server > HTTPS Status Parameter static.network.port.https <y0000000000xx>.cfg...
Page 85: Phone User Interface
Phone Provisioning Phone User Interface The phone user interface makes configurations available to users and administrators; but the Advanced/Advanced Settings option is only available to administrators and requires an administrator password (default: admin). You can configure the phones via the phone user interface on a per-phone basis. Note : When you manually configure a phone via the phone user interface, the changes associated with non-static parameters MAC-local CFG...
Page 86: Auto Provisioning Settings Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Yealink phones can obtain the provisioning server address during startup. Then the phones first download boot files and configuration files from the provisioning server and then resolve and update the configurations written in configuration files.
Page 87 Phone Provisioning Note: It has a lower priority than the value defined by the parameter “static.auto_provision.attempt_ expired_time”. Permitted Integer from 1 to 20 Values Default Parameter static.auto_provision.attempt_before_failed <y0000000000xx>.cfg It configures the maximum number of attempts to transfer a file before the transfer fails during auto pro- Description visioning.
Page 88 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Parameter static.auto_provision.repeat.enable <y0000000000xx>.cfg Description It triggers the repeatedly feature to on or off. 0-Off Permitted Values 1-On Default Web UI Settings > Auto Provision > Repeatedly Parameter static.auto_provision.repeat.minutes <y0000000000xx>.cfg It configures the interval (in minutes) for the phone to perform auto provisioning repeatedly. Description Note: It works only if “static.auto_provision.repeat.enable”...
Page 89 Phone Provisioning Note: The phone may perform auto provisioning when you are using the phone during office hour. It works only if “static.auto_provision.weekly.enable” is set to 1 (On). Permitted Integer from 0 to 120 Values Default Web UI Settings > Auto Provision > Inactivity Time Expire(0~120min) Parameter static.auto_provision.weekly.dayofweek <y0000000000xx>.cfg It configures the days of the week for the phone to perform auto provisioning weekly.
Page 90 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones 1-On, the phone performs auto provisioning at random between a starting time configured by the para- meter "static.auto_provision.flexible.begin_time" and an ending time configured by the parameter "stat- ic.auto_provision.flexible.end_time" on a random day within the period configured by the parameter "static.auto_provision.flexible.interval".
Page 91 Phone Provisioning Note: If the phone performs auto provisioning when receiving a SIP NOTIFY message which contains the header “Event: check-sync”, the phone will display the prompt message no matter whether the con- figuration is updated. 0-Disabled Permitted Values 1-Enabled Default Parameter static.auto_provision.connect.keep_alive <y0000000000xx>.cfg...
Page 92: User-Triggered Provisioning Settings Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones If you change this parameter, the phone will reboot to make the change take effect. User-Triggered Provisioning Settings Configuration You can enable the users to trigger phones to perform provisioning by dialing an activation code. This method works only if there is no registered account on the phone.
Page 93: Pin Code Provisioning Settings Configuration
You can enable the users to trigger phones to perform provisioning by dialing a PIN code. For more information on PIN code provisioning, refer to Yealink SIP IP Phones Auto Provisioning Guide. The following table lists the parameters you can use to configure settings for PIN code provisioning.
Page 94: Setting Up A Provisioning Server
Supported Provisioning Protocols Supported Provisioning Server Discovery Methods Configuring a Provisioning Server Supported Provisioning Protocols Yealink phones support several transport protocols for provisioning: Trivial File Transfer Protocol (TFTP) File Transfer Protocol (FTP) Hyper Text Transfer Protocol – Secure (HTTPS) File Transfer Protocol – Secure (FTPS) Note : There are two types of FTP methods—active and passive.
Page 95: Supported Provisioning Server Discovery Methods
Phone Provisioning If you change this parameter, the phone will reboot to make the change take effect. Supported Provisioning Server Discovery Methods After the phone has established network settings, it must discover a provisioning server to obtain software updates and configuration settings. 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 server address via the phone user interface after startup.
Page 96: Pnp Provision Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Permitted Integer from 1000 to 2147483646 Values Default 1000 Parameter static.features.hide_zero_touch_url.enable <y0000000000xx>.cfg Description It enables or disables the phone to hide the provisioning URL item on the Zero Touch screen. Permitted 0-Disabled Values 1-Enabled...
Page 97 Phone Provisioning Black-and-white Screen Phones: Menu > Settings > Advanced Settings (default password: admin) > Auto Provision > DHCP Active static.auto_provision.dhcp_option.list_user_ Parameter <y0000000000xx>.cfg options It configures the IPv4 custom DHCP option for requesting provisioning server address. Multiple options are separated by commas. Description Note: It works only if “static.auto_provision.dhcp_option.enable”...
Page 98: Static Provision Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones For T48G phones: T48G. For T48S phones: T48S. For T46U phones: T46U. For T46G phones: T46G. For T46S phones: T46S. For T43U phones: T43U. For T42G phones: T42G. For T42S phones: T42S. For T42U phones: T42U.
Page 99: Configuring A Provisioning Server
Phone Provisioning Parameter static.auto_provision.server.username <y0000000000xx>.cfg Description It configures the user name for provisioning server access. Permitted String within 32 characters Values Default Blank Web UI Settings > Auto Provision > Username Parameter static.auto_provision.server.password <y0000000000xx>.cfg Description It configures the password for provisioning server access. Permitted String within 32 characters Values...
Page 100: Auto Provisioning Flowchart For Keep User's Personalized Configuration Settings
(for HTTP/HTTPS server only). 0-PUT Permitted Values 1-POST Default Auto Provisioning Flowchart for Keep User’s Personalized Configuration Settings The following shows an auto provisioning flowchart for Yealink phones when a user wishes to keep the user’s per- sonalized configuration settings.
Page 101: Example: Keeping User's Personalized Settings
Phone Provisioning Example: Keeping User’s Personalized Settings This section shows you how to keep the personalized settings. Parameters Settings: static.auto_provision.custom.protect =1 After provisioning, if the users make changes via the phone user interface or web user interface, the MAC-local.cfg file with non-static personal settings generates locally. Scenario: Keeping user’s personalized settings when upgrading the firmware If you set “...
Page 102: Clearing User's Personalized Configuration Settings
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones local.cfg file from the provisioning server, and then update settings in MAC-local.cfg file to the IP phone system. The personalized settings locally are overridden by the MAC-local.cfg file from the provisioning server. If you set “...
Page 103 Phone Provisioning [T42S]features.dnd.enable = 0 linekey.2.type=13 Custom configuration file: linekey.2.line=1 Linekey.cfg linekey.2.value = 4603 linekey.2.label=Bill account.1.enable = 1 account.1.label = Bill account.1.display_name = 1023 MAC-Oriented configuration files: account.1.auth_name = 1023 001565b09d886.cfg account.1.user_name = 1023 account.1.password = 1023 account.1.sip_server.1.address = 10.2.1.199 account.1.sip_server.1.port = 5060 3.
Page 104 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones...
Page 105: Security Features
You can also customize the access permission for the configurations on the web user interface and phone user interface. Yealink phones support the access levels of admin, var, and user. When logging into the web user interface or access advanced settings on the phone, as an administrator, you need an administrator password to access various menu options.
Page 106: User Access Level Configuration
Note: You cannot change the user password via the phone user interface. User Access Level Configuration For more information, refer to Yealink SIP IP Phones Configuration Guide for User Access Level. The following table lists the parameters you can use to configure the user access level.
Page 107: Auto Logout Time
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 phones offer three types for phone lock: Lock the Menu soft key: it prevents unauthorized users from accessing the menu, changing the personal set- tings for your phone.
Page 108: Operation Behaviors On Lock Phone
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Operation Behaviors on Lock Phone The following table lists the operation behavior when configuring the type of phone lock: Function All Keys Menu key Keys Allowable Behavior: You are allowed to press the desired Line Key (key type is Line) or the Speakerphone/off-hook key to enter the dialing screen.
Page 109 Security Features Default Web UI Features > Phone Lock > Phone Lock Enable Color Screen Phones: Menu > Basic > Phone Lock > Lock Enable Phone UI Black-and-white Screen Phones: Menu > Settings > Basic Settings > Phone Lock > Lock Enable Parameter phone_setting.phone_lock.lock_key_type <y0000000000xx>.cfg It configures the type of phone lock.
Page 110: Transport Layer Security (Tls)
Yealink phones support TLS version 1.0, 1.1 and 1.2. When TLS is enabled for an account, the SIP message of this account will be encrypted, and a lock icon appears on the LCD screen after the successful TLS negotiation.
Page 111: Supported Trusted And Server Certificates
The format of the server certificate files must be *.pem and *.cer and the maximum file size is 5MB. A unique server certificate: It is unique to an IP phone (based on the MAC address) and issued by the Yealink Certificate Authority (CA).
Page 112: Supported Trusted Certificates
“static.phone_setting.reserve_certs_config.enable” using the con- figuration file. Topic Supported Trusted Certificates Supported Trusted Certificates Yealink phones trust the following CAs by default: DigiCert High Assurance EV Root CA Deutsche Telekom Root CA 2 Equifax Secure Certificate Authority Equifax Secure eBusiness CA-1...
Page 113 Cybertrust Global Root SectigoSSLCA Sectigo RSA Domain Validation Secure Server CA Sectigo RSA Certification Authority AmazonRootCA4 AmazonRootCA3 AmazonRootCA2 AmazonRootCA1 Yealink Root CA Yealink Equipment Issuing CA SIP Core QuoVadis Root CA 2 QuoVadis Root Certification Authority USERTrust RSA Certification Authority...
Page 114: Tls Configuration
Note : Yealink endeavors to maintain a built-in list of most common used CA Certificates. Due to memory constraints, we can- not ensure a complete set of certificates. If you are using a certificate from a commercial Certificate Authority not in the list above, you can send a request to your local distributor.
Page 115 Security Features Default Web UI Security > Trusted Certificates > Only Accept Trusted Certificates Parameter static.security.ca_cert <y0000000000xx>.cfg It configures the type of certificates in the Trusted Certificates list for the phone to authenticate for TLS Description connection. 0-Default Certificates Permitted 1-Custom Certificates Values 2-All Certificates...
Page 116: Secure Real-Time Transport Protocol (Srtp)
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Default Blank Parameter static.server_certificates.url <y0000000000xx>.cfg It configures the access URL of the certificate the phone sends for authentication. Description Note: The certificate you want to upload must be in *.pem or *.cer format. Permitted URL within 511 characters Values...
Page 117: Srtp Configuration
Security Features When you place a call on the enabled SRTP phone, the phone sends an INVITE message with the RTP/RTCP encryption algorithm to the destination phone. As described in 3711, RTP/RTCP streams may be encrypted using an AES (Advanced Encryption Standard) algorithm. 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 >...
Page 118 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Description It configures whether to use audio encryption service. 0-Disabled Permitted 1-Optional, the phone will negotiate with the other phone what type of encryption to use for the ses- Values sion. 2-Compulsory, the phone must use SRTP during a call.
Page 119: Encrypting And Decrypting Files
T53W/T53/T43U/T42G/T42U/T42S, X=1-12; for T41P/T41S/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21 (P) E2, X=1-2; for T19(P) E2/CP920, X=1. Encrypting and Decrypting Files Yealink phones support downloading encrypted files from the server and encrypting files before/when uploading them to the server. You can encrypt the following files: Configuration files: MAC-Oriented CFG file (<MAC>.cfg), Common CFG file (y0000000000xx.cfg), MAC-local...
Page 120: Encryption And Decryption Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones during auto provisioning. If the parameter static.auto_provision.aes_key.mac” is left blank, “static.auto_pro- vision.aes_key.com” will be used. If the downloaded contact files are encrypted, the phone will try to decrypt <MAC>-contact.xml file using the plain- text AES key.
Page 121 Security Features Menu > Advanced (default password: admin) > Auto Provision > Common AES Black-and-white Screen Phones: Menu > Settings > Advanced Settings (default password: admin) > Auto Provision > Common AES Parameter static.auto_provision.aes_key.mac <y0000000000xx>.cfg It configures the plaintext AES key for encrypting/decrypting the MAC-Oriented files (<MAC>.cfg, <MAC>-local.cfg and <MAC>-contact.xml).
Page 122 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones meter “static.auto_provision.local_contact.backup.enable”. 1-Enabled, the contact file will be uploaded encrypted and will replace the one (encrypted or unen- crypted) stored on the server if you have configured to back up the contacts to the server by the para- meter “static.auto_provision.local_contact.backup.enable”.
Page 123: Incoming Network Signaling Validation
If you change this parameter, the phone will reboot to make the change take effect. Incoming Network Signaling Validation Yealink phones support the following three optional levels of security for validating incoming network signaling: Source IP address validation: ensure the request is received from an IP address of a server belonging to the set of target SIP servers.
Page 124: Usb Port Lock
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones authentication. Permitted A valid string Values Default YealinkSPIP Parameter sip.request_validation.event <y0000000000xx>.cfg It configures which events specified within the Event header of SUBSCRIBE or NOTIFY request should be validated. Description If it is left blank, all events will be validated. Permitted A valid string Values...
Page 125 Security Features Supported T57W, T54W, T53W, T53, T48U, T48S, T46U, T46S, T43U, T42U, CP920 Devices If you change this parameter, the phone will reboot to make the change take effect.
Page 126: Firmware Upgrade
Firmware Upgrade Configuration Firmware for Each Phone Model You can download the latest firmware online: http://sup- port.yealink.com/documentFront/forwardToDocumentFrontDisplayPage. The following table lists the associated and latest firmware name for each device model (X is replaced by the actual firmware version). IP Phone Model...
Page 127 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Firmware Upgrade Configuration Before upgrading firmware, you need to know the following: Do not close and refresh the browser when the device is upgrading firmware via the web user interface. Do not unplug the network cables and power cables when the device is upgrading firmware. The following table lists the parameters you can use to upgrade firmware.
Page 128: Using Handsets With T57W/T54W/T53W/T53 Phones
Note that you can still use the phone features as usual on the corded-cordless phone. Note : To use this feature, you should set "static.usb.power.enable" to 1 (Enabled). When satellite mode is disabled, Yealink recommends using forward and DND features in custom mode. Topics Handset Backlight...
Page 129: Handset Keypad Light
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones -1-Do not modify the configuration. Permitted 0-Disabled, the backlight will be turned off after the handset is idle for about 10 seconds. Values 1-Enabled, the backlight will be turned off after the handset is idle for about 30 minutes. Default Supported W53H, W56H...
Page 130: Handset Wallpaper
Using Handsets with T57W/T54W/T53W/T53 Phones Handset Wallpaper Wallpaper is an image used as the background for the handset idle screen. Users can select an image from hand- set’s built-in background. Topic Handset Wallpaper Configuration Handset Wallpaper Configuration The following table lists the parameter you can use to configure the handset wallpaper. Parameter custom.handset.wallpaper <y0000000000xx>.cfg It configures the wallpaper displayed on the handset LCD screen.
Page 131: Handset Name
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Default Supported W53H, W56H Devices Handset UI OK > Settings > Display > Screen Saver Handset Name The handset will be assigned a name by default if successfully registered to the phone. You can personalize the handset name.
Page 132: Number Assignment Configuration
Using Handsets with T57W/T54W/T53W/T53 Phones The handset can only receive incoming calls via the assigned incoming line(s). You can assign incoming lines to all handsets that are registered to the same phone. Note : You can only assign one outgoing line and one incoming line for the CP930W. And make sure that the outgoing line and the incoming line are the same line.
Page 133: End Call On Hook
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones The outgoing line for handset 4 is line 4. The outgoing line for handset 5 is line 5. Web UI Account > Number Assignment > Outgoing lines Parameter handset.X.dial_out_default_line <y0000000000xx>.cfg Description It configures the default line to place outgoing calls for a specific handset. Permitted Integer from 1 to 5 Values...
Page 134: Advisory Tones Configuration
Using Handsets with T57W/T54W/T53W/T53 Phones Confirmation: plays when you save settings or place the handset in the charger cradle. For CP930W, you can only configure it by navigating to Menu > Settings > Basic Settings > Sound > Advisory Tones > Confirmation. Low Battery: plays when battery capacity is low and the handset requires being charged.
Page 135: Base Pin
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Default Supported W53H, W56H, CP930W Devices W56H/W53H: OK > Settings > Audio > Advisory Tones > Low Battery Handset UI CP930W: Menu > Settings > Basic Settings > Sound > Low Battery Base PIN To avoid unauthorized registration or access to some features on the handset, you should keep the base PIN secret.
Page 136: Dect Intercom
Using Handsets with T57W/T54W/T53W/T53 Phones use the PIN configured by "base.pin_code" to access some features. Default Parameter base.pin_code_for_register <y0000000000xx>.cfg It configures the PIN for registering or de-registering a handset. Description Note: It works only if “base.double_pin_code.enable” is set to 1 (Enabled). Permitted Integer from 0000 to 9999 Values...
Page 137: Shared Directory
Directory > Dect Directory > Import Contacts > Import to (Shared Directory) > Select .xml file form Shared Contact File Customization You can customize the shared contacts using local contact template. You can ask the distributor or Yealink FAE for local contact template. You can also obtain the template online: http://support.yealink.com/documentFront/forwardToDocumentFrontDisplayPage. Topics...
Page 138: Shared Contact File Elements And Attributes
4. Save the changes and place this file to the provisioning server. Satellite Mode Yealink desk phone can be bound with a handset. The handset can share the line and contacts with the phone. The call can be shifted between the phone and handset.
Page 139: Satellite Mode Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones When a call is made from 1001 to 1002, both the phone and the handset ring. Users can answer the call either on the phone or handset. When using satellite mode, note the following: The incoming and outgoing lines originally assigned to the handset are disabled.
Page 140: Example: Configuring The Satellite Mode Feature
Using Handsets with T57W/T54W/T53W/T53 Phones Web UI Status > Handset > Satellite Mode > Select Handset T57W/T54W: Menu > DECT Settings > Satellite Mode > Select handset Phone UI T53W/T53: Menu > Settings > DECT Settings > Satellite Mode > Select handset Parameter features.ms.X.mode <y0000000000xx>.cfg It configures the satellite mode for the phone.
Page 141: Repeater Settings Parameters
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Group 1: features.ms.1.slave_handset_number = 2 features.ms.1.mode = 0 After provisioning, users cannot switch the active call between the phone and handset. Only the device which is dur- ing the call can initiate a new call. If users not in a call try to initiate a call on the phone/handset, the phone/handset screen will prompt "Path Busy".
Page 142: Handset Settings Parameters
Using Handsets with T57W/T54W/T53W/T53 Phones If you change this parameter, the phone will reboot to make the change take effect. Handset Settings Parameters Parameter custom.handset.eco_mode.enable <y0000000000xx>.cfg It enables or disables the eco mode to greatly reduce the transmission power and signal output when Description the phone is in the talk mode.
Page 143 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones 0-Disabled Values 1-Enabled Default Supported W52H Devices Handset UI OK > Settings > Display > Notification Light > Voice Mail Parameter custom.handset.language <y0000000000xx>.cfg It configures the language used on the DECT handset user interface. Description Note: It will take effect on all handsets that are registered on the same phone.
Page 144 Using Handsets with T57W/T54W/T53W/T53 Phones W52H/W53H/W56H: OK > Settings > Language Handset UI CP930W: Menu > Settings > Basic Settings > Language Parameter custom.handset.auto_answer.enable <y0000000000xx>.cfg It enables or disables a user to answer incoming calls by lifting the handset from the charger cradle without pressing the off-hook key.
Page 145 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Use the following mapping: “WWW” represents the abbreviation of the week; “DD” represents a two-digit day; “MMM” represents the first three letters of the month; “YYYY” represents a four-digit year, and “YY” represents a two-digit year. Default Web UI Settings >...
Page 146: Custom Handset Related Configurations
Using Handsets with T57W/T54W/T53W/T53 Phones Default Supported All handsets except DD phones Devices Parameter handset.X.contact_list.url <y0000000000xx>.cfg It configures the access URL of the contact file (*.xml) for a specific handset. Description Example: handset.2.contact_list.url= http://192.168.10.25/contact.xml Permitted URL within 511 characters Values Default Blank Web UI...
Page 147: Handset Firmware Upgrade Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Handset Firmware Upgrade Configuration The following table lists the parameters you can use to upgrade handset firmware. Parameter over_the_air.url <y0000000000xx>.cfg It configures the access URL of the handset firmware file. Description Note: The priority of parameter “over_the_air.url”...
Page 148 Using Handsets with T57W/T54W/T53W/T53 Phones Default Supported All handsets except DD phones Devices Parameter over_the_air.base_trigger <y0000000000xx>.cfg It enables or disables to upgrade the handset firmware compulsively when the phone detects a new Description handset firmware from the provisioning server. 0-Disabled, if “over_the_air.handset_tip” is set to 1 (Enabled), it will pop up a tip on the handset to notify the user to confirm upgrading the firmware or not.
Page 149: Audio Features
Audio Features Audio Features This chapter describes the audio sound quality features and options you can configure for the IP phone. Topics Alert Tone Touch Tone Ring Tones Distinctive Ring Tones Ringer Device Audio Volume Tones Audio Codecs Packetization Time (PTime) Early Media Headset Prior Dual Headset...
Page 150 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Parameter account.X.dial_tone <MAC>.cfg Description It configures the dial tone for the phone. 0-Default (depend on the country tone by “voice.tone.country”) Permitted 1-440/250,0/250 Values 2-1000/250,0/250 Default Parameter features.call.dialtone_time_out <y0000000000xx>.cfg It configures the duration time (in seconds) that a dial tone plays before a call is dropped. Description If it is set to 0, the call is not dropped.
Page 151: Touch Tone
Audio Features Touch Tone If you enable touch tone and tap the keys (except the off-hook key), the phone will produce a sound when it is not on the dialing/pre-dialing screen and not in a call. It is only applicable to CP920 phones. Topic Touch Tone Configuration Touch Tone Configuration...
Page 152: Ringtone Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Ringtone Configuration The following table lists the parameters you can use to configure ringtone. Parameter phone_setting.ring_type <y0000000000xx>.cfg Description It configures a ring tone for the phone. Permitted Ring1.wav, Ring2.wav, Ring3.wav, Ring4.wav, Ring5.wav, Ring6.wav, Ring7.wav, Ring8.wav, Values Silent.wav, Splash.wav or custom ring tone name (for example, Customring.wav) Default...
Page 153 Audio Features pstn.account.1.ring_type = Common It means PSTN account 1 will use the ring tone selected for the IP phone configured by the parameter “phone_setting.ring_type”. Permitted Common, Ring1.wav, Ring2.wav, Ring3.wav, Ring4.wav, Ring5.wav, Ring6.wav, Ring7.wav, Values Ring8.wav, Silent.wav, Splash.wav or custom ring tone name (for example, Customring.wav) Default Common Supported...
Page 154: Distinctive Ring Tones
Supported Alert-Info Headers Format Distinctive Ring Tones Configuration Supported Alert-Info Headers Format Yealink phones support Alert-Info headers in four formats: Bellcore-drN, ringtone-N (or MyMelodyN), <URL > and info=info text;x-line-id=0. Note : If the Alert-Info header contains multiple types of keywords, the phone will process the keywords in the following order: AutoAnswer >...
Page 155: Mymelodyringn.wav)
Audio Features Examples: Alert-Info: http://127.0.0.1/Bellcore-dr1 Alert-Info: test/Bellcore-dr1 Alert-Info: Bellcore-dr1 Alert-Info: Bellcore-dr1;x-line-id=1 Alert-Info: <http://10.1.0.31 > ;info=Bellcore-dr1 The following table identifies the different Bellcore ring tone patterns and cadences (These ring tones are designed for the BroadWorks server). Pattern Minimum Duration Nominal Duration Maximum Duration Bellcore Tone Pattern Cadence...
Page 156: Alert-Info:
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones about 10 seconds if “N” is greater than 10 or less than 1. Examples: Alert-Info: ringtone-2 Alert-Info: ringtone-Ring2.wav 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 >...

Page 157: Alert-Info: Info=Info Text;X-Line-Id=0
Audio Features Example: Alert-Info: http://192.168.0.12:8080/Custom.wav Alert-Info: info=info text;x-line-id=0 When the Alert-Info header contains an info text, the phone will map the text with the Internal Ringer Text pre- configured (or “distinctive_ring_tones.alert_info.X.text” 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 parameter “distinctive_ring_ tones.alert_info.X.ringer”).
Page 158: Ringer Device
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 T57W/T54W/T53W/T53/T48U/T48S/T46U/T46S/T43U/T42S/T42U/T41S phones. You can press the HEADSET key to activate the headset mode. For more information, refer to the Yealink phone- specific user guide. It is not applicable to CP920 phones.
Page 159: Ringer Device Configuration
Audio Features Topic Ringer Device Configuration Ringer Device Configuration The following table lists the parameters you can use to configure the ringer device. Parameter features.ringer_device.is_use_headset <y0000000000xx>.cfg It configures the ringer device for the phone. Description Note: To use speaker, make sure “features.speaker_mode.enable” is set to 1 (Enabled). To use the headset, make sure “features.headset_mode.enable”...
Page 160: Sending Volume Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Sending Volume Configuration You can configure the sending volume of currently engaged audio devices (handset, speakerphone or headset) when the phone is in use. The following table lists the parameters you can use to configure the sending volume. Parameter voice.handfree_send <y0000000000xx>.cfg It configures the sending volume of the speaker.
Page 161 Audio Features Permitted Integer from -50 to 50 Values Default Supported All phones except CP920 Devices Web UI Features > Audio > Headset Send Volume (-50~50) Parameter voice.headset.autoreset_spk_vol <y0000000000xx>.cfg Description It configures the headset's volume level during a call. 0-The headset volume at the end of a call persists between calls. Permitted 1 to 15-The headset volume does not persist between calls, and resets to this specified level each Values...
Page 162: Tones
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones If you change this parameter, the phone will reboot to make the change take effect. Tones When receiving a message, the 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.
Page 163: Tones Configuration
Audio Features Condition Description Ring Back Ring-back tone Busy When the callee is busy Congestion When the network is congested Call Wait- Call waiting tone (For more information on call waiting, refer to Call Waiting) Dial Recall When receiving a callback Info When receiving a special message Stutter...
Page 164 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones !250/200,0/1000, 200+300/500,200+500+800+1500/1000). Note: It works only if “voice.tone.country” is set to Custom. Permitted String Values Default Blank Web UI Settings > Tones > Dial Parameter features.partition_tone <y0000000000xx>.cfg It enables or disables the phone to play the different dial tones when there is no active account. Description Note: It works only if “voice.tone.dial”...
Page 165 Audio Features Default Blank Web UI Settings > Tones > Busy Parameter voice.tone.congestion <y0000000000xx>.cfg It customizes the tone when the network is congested. The value format is Freq/Duration. For more information on the value format, refer to the parameter “voice.tone.dial”. Description Note: It works only if “voice.tone.country”...
Page 166 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Web UI Settings > Tones > Dial Recall Parameter voice.tone.info <y0000000000xx>.cfg It customizes the info tone. The phone will play the info tone with the special information, for example, the number you are calling is not in service. The value format is Freq/Duration.
Page 167 Audio Features Default Blank Web UI Settings > Tones > Auto Answer Parameter voice.tone.stutterdial <y0000000000xx>.cfg It customizes the dial tone when DND or call forward is activated or the phone has a new voice mes- sage. The value format is Freq/Duration. For more information on the value format, refer to the parameter “voice.tone.dial”.
Page 168: Audio Codecs
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Values 1-Enabled Default Supported T57W, T54W, T53W, T53 Devices Audio Codecs CODEC is an abbreviation of COmpress-DECompress, capable of coding or decoding a digital data stream or sig- nal by implementing an algorithm. The object of the algorithm is to represent the high-fidelity audio signal with a minimum number of bits while retaining the quality.
Page 169 Audio Features Codec Algorithm Reference Bit Rate Sample Rate Packetization Time iLBC_15_2kbps iLBC RFC 3952 15.2 Kbps 8 Ksps 20ms iLBC_13_33kbps iLBC RFC 3952 13.33 Kbps 8 Ksps 30ms 8-12 Kbps 8 Ksps 16-20 Kbps 12 Ksps opus opus RFC 6716 28-40 Kbps 16 Ksps 20ms...
Page 170: Audio Codecs Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Default Audio Phone Model Supported Audio Codecs Codecs G.722.1c (48kb/s), G.722.1c (48kb/s), G.722.1c (32kb/s), G.722.1c (32kb/s), G.722.1c (24kb/s), G.722.1 (24kb/s), G722, G.722.1c (24kb/s), CP920 PCMU, PCMA, G729, G726-40, G726-32, G.722.1 (24kb/s), G726-24, G726-16, G723_53, G723_63, G722, PCMU, PCMA, Opus, iLBC_15_2kpbs, iLBC_13_33kpbs...
Page 171 Audio Features When the audio codec is G.722.1c (24kb/s), the default value is 1; When the audio codec is G.722.1 (24kb/s), the default value is 1; When the audio codec is G722, the default value is 1; When the audio codec is PCMU, the default value is 1; When the audio codec is PCMA, the default value is 1;...
Page 172 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones ilbc_15_2kpbs-iLBC_15_2kbps ilbc_13_33kpbs-iLBC_13_33kbps Example: account.1.codec.g722.priority = 1 Note: The priority of the codec in the disable codec list is not specified, and numerical value 1 is defined as the highest priority in the enable codec list. The name of the audio codec in this parameter should be the correct one as listed in the above example, otherwise, the corresponding configuration will not take effect.
Page 173: Packetization Time (Ptime)
Audio Features Web UI Account > Codec > Opus Sample Rate Parameter voice.g726.aal2.enable <y0000000000xx>.cfg Description It enables or disables the phone to use the AAL2-G726-16, 24, 32 and 40 MIME type. Permitted 0-Disabled Values 1-Enabled Default X is the account ID. For T57W/T54W/T48U/T48S/T48G/T46U/T46S/T46G/T29G, X=1-16; for T53W/T53/T43U/T42G/T42U/T42S, X=1-12;...
Page 174: Ptime Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Codec Packetization Time (Minimum) Packetization Time (Maximum) opus 10ms 20ms iLBC_15_2kpbs 20ms, 40ms, 60ms iLBC_13_33kpbs 30ms, 60ms PTime Configuration The following table lists the parameter you can use to configure the PTime. Parameter account.X.ptime <MAC>.cfg Description It configures the ptime (in milliseconds) for the codec.
Page 175: Headset Prior
Audio Features It configures the time to wait for the phone to play the local ringback tone when the early media cannot Description be played. -1-Do not play the local ringback tone Permitted 0-Play the local ringback tone immediately Values 1-100-Wait for a specified time to play the local ringback tone Default Parameter phone_setting.is_deal180...
Page 176: Dual Headset
Features > General Information > Dual Headset Acoustic Clarity Technology To optimize the audio quality in your network, Yealink phones support the acoustic clarity technology: Acoustic Echo Cancellation (AEC), Background Noise Suppression (BNS), Automatic Gain Control (AGC), Voice Activity Detection (VAD), Comfort Noise Generation (CNG) and jitter buffer.
Page 177: Acoustic Echo Cancellation (Aec)
Smart Noise Filtering Acoustic Echo Cancellation (AEC) Yealink phones employ advanced AEC for hands-free operation. You can configure the AEC feature to remove the echo of the local loudspeaker from the local microphone without removing the near-end speech. AEC is not normally required for calls via the handset. In some cases, where echo is experienced by the remote party, AEC may be used to reduce/avoid echo when you use the handset.
Page 178: Background Noise Suppression (Bns)
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Default Supported CP920 Devices Web UI Settings > Voice > Noise Proof > Noise Suppression Background Noise Suppression (BNS) Background noise suppression (BNS) is designed primarily for hands-free operation and reduces background noise to enhance communication in noisy environments.
Page 179: Jitter Buffer
Jitter Buffer Yealink phones support two types of jitter buffers: fixed and adaptive. A fixed jitter buffer adds the fixed delay to voice packets. You can configure the delay time for the static jitter buffer on the phones. An adaptive jitter buffer is capable of adapting the changes in the network's delay.
Page 180: Smart Noise Block
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Permitted Integer from 0 to 400 Values Default Web UI Settings > Voice > Jitter Buffer > Normal Parameter voice.jib.wifi.adaptive <y0000000000xx>.cfg Description It configures the type of jitter buffer in the wireless network. 0-Fixed Permitted Values...
Page 181: Smart Noise Block Configuration
Audio Features Topic Smart Noise Block Configuration Smart Noise Block Configuration The following table lists the parameter you can use to configure smart noise block. Parameter voice.ans_nb.enable <y0000000000xx>.cfg It enables or disables the Smart Noise Block feature. Description Note: It works only if “voice.tns.enable” is set to 1 (Enabled). 0-Disabled Permitted Values...
Page 182: Smart Noise Filtering
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones are using the phone handset or a headset. Permitted Integer from 1 to 3 Values Default Supported T57W, T54W, T53W, T53, T48U, T46U, T43U, T42U Devices Smart Noise Filtering The phones can block out the slight noise from the far party when there is no speech in a call, and at the same time filter out the common transient noise (door closing, table knocking, and so on).
Page 183: Transmitting Dtmf Digit
Audio Features 1209 Hz 1336 Hz 1477 Hz 1633 Hz 697 Hz 770 Hz 852 Hz 941 Hz Note : The phones will not send the 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 184 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Web UI Account > Advanced > DTMF Payload Type(96~127) Parameter account.X.dtmf.info_type <MAC>.cfg It configures the DTMF info type. Description Note: It works only if “account.X.dtmf.type” is set to 2 (SIP INFO) or 3 (RFC2833 + SIP INFO). 1-DTMF-Relay Permitted 2-DTMF...
Page 185: Suppress Dtmf Display
Audio Features X is the account ID. For T57W/T54W/T48U/T48S/T48G/T46U/T46S/T46G/T29G, X=1-16; for T53W/T53/T43U/T42G/T42U/T42S, X=1-12; for T41P/T41S/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21 (P) E2, X=1-2; for T19(P) E2/CP920, X=1. If you change this parameter, the phone will reboot to make the change take effect. Suppress DTMF Display Suppress DTMF display allows the phones to suppress the display of DTMF digits during an active call.
Page 186: Local Dtmf Tone
These metrics can be sent between the phones in RTCP-XR packets. These metrics can also be sent in SIP PUBLISH messages to a central voice quality report collector. Yealink phones support two mechanisms for voice quality monitoring: RTCP-XR and VQ-RTCPXR.
Page 187: Rtcp-Xr Configuration
Audio Features RTCP-XR Configuration The following table lists the parameters you can use to configure the RTCP-XR. Parameter voice.rtcp_xr.enable <y0000000000xx>.cfg Description It enables or disables the phone to send RTCP-XR packets. Permitted 0-Disabled Values 1-Enabled Default Web UI Settings > Voice Monitoring > Voice RTCP-XR Report Parameter voice.rtcp.enable <y0000000000xx>.cfg Description It enables or disables the phone to send RTCP packets.
Page 188: Voice Quality Reports Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Voice Quality Reports Configuration The following table lists the parameters you can use to configure the service quality reports. Parameter phone_setting.vq_rtcpxr.session_report.enable <y0000000000xx>.cfg It enables or disables the phone to send a session quality report to the central report collector at the Description end of each call.
Page 189: Vq-Rtcpxr Display
Audio Features the central report collector. When the MOS-LQ value computed by the phone is greater than 2.8, the phone will not send a critical alert quality report to the central report collector. If it is set to blank, critical alerts are not generated due to MOS-LQ. Permitted Integer from 15 to 40 Values...
Page 190: Vq-Rtcpxr Display Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones VQ-RTCPXR Display Configuration The following table lists the parameters you can use to configure VQ-RTCPXR display. Parameter phone_setting.vq_rtcpxr.states_show_on_web.enable <y0000000000xx>.cfg It enables or disables the voice quality data of the last call to be displayed on the web interface at Description the path Status >...
Page 191 Audio Features Parameter phone_setting.vq_rtcpxr_display_remote_call_id.enable <y0000000000xx>.cfg It enables or disables the phone to display Remote User on the phone screen. Description Note: It works only if “phone_setting.vq_rtcpxr.states_show_on_gui.enable” is set to 1 (Enabled). Permitted 0-Disabled 1-Enabled Values Default Web UI Settings > Voice Monitoring > Report Options on Phone > Remote User Parameter phone_setting.vq_rtcpxr_display_local_codec.enable <y0000000000xx>.cfg...
Page 192: Central Report Collector
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Values 1-Enabled Default Web UI Settings > Voice Monitoring > Report Options on Phone > Packets Lost phone_setting.vq_rtcpxr_display_symm_oneway_delay.en- Parameter <y0000000000xx>.cfg able It enables or disables the phone to display SymmOneWayDelay on the phone screen. Description Note: It works only if “phone_setting.vq_rtcpxr.states_show_on_gui.enable”...
Page 193: Central Report Collector Configuration
Audio Features Central Report Collector Configuration The following table lists the parameters you can use to configure the central report collector. Parameter account.X.vq_rtcpxr.collector_name <MAC>.cfg It configures the hostname of the central report collector that accepts voice quality reports contained in Description SIP PUBLISH messages.
Page 194: Phone Customization
Language for Web Display Customization Supported Languages You can ask the distributor or Yealink FAE for language packs. You can also obtain the language packs online: http://support.yealink.com/documentFront/forwardToDocumentFrontDisplayPage. The following table lists available languages and associated language packs supported by the phone user inter-...
Page 195: Language Display Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Phone User Interface Web User Interface Language Language Pack Language Language Pack Note Language Pack English 000.GUI.English.lang English 1.English.js 1.English_note.xml Chinese Simplified 001.GUI.Chinese_S.lang Chinese Simplified 2.Chinese_S.js 2.Chinese_S_note.xml Chinese Tra- Chinese Traditional 002.GUI.Chinese_T.lang 3.Chinese_T.js 3.Chinese_T_note.xml ditional...
Page 196: Language For Phone Display Customization
Phone Customization English, Chinese_S, Chinese_T, French_CA, French, German, Italian, Polish, Portuguese, Por- tuguese_LA, Spanish, Spanish_LA, Turkish, Russian or the custom language name. Other Phones: English, Chinese_S, Chinese_T, French_CA, French, German, Italian, Polish, Portuguese, Por- tuguese_LA, Spanish, Spanish_LA, Turkish, Russian, Czech, Arabic, Hebrew, or the custom lan- guage name.
Page 197: Custom Language For Phone Display Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Save the language pack and place it to the provisioning server. Custom Language for Phone Display Configuration The following table lists the parameters you can use to configure a custom language for the phone display. Parameter gui_lang.url <y0000000000xx>.cfg It configures the access URL of the custom LCD language pack for the phone user interface.
Page 198: Language For Web Display Customization
You can also customize the translation of the note lan- guage pack. The note information is displayed in the question mark "?" of the web user interface. You can ask the distributor or Yealink FAE for language packs. You can also obtain the language packs online: http://support.yealink.com/documentFront/forwardToDocumentFrontDisplayPage.
Page 199: Customizing A Language Pack For Note Display
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones 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” (X starts from 14, “name” is replaced with the language name). If the note language name is the same as the exist- ing one, the new uploaded note language pack will override the existing one.
Page 200: Contrast
Phone Customization X starts from 14, “name” is replaced with the language name Default Blank Parameter wui_lang.delete <y0000000000xx>.cfg It deletes the specified or all custom web language packs and note language packs of the web user Description interface. http://localhost/all or http://localhost/Y.name.js Permitted Values Y starts from 014, “name”...
Page 201: Wallpaper
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Wallpaper Wallpaper is a picture used as the background of the phone. The phone comes with a default picture. You can change it to a built-in picture or custom wallpaper from personal pictures. The wallpaper is only applicable to color screen phones and expansion module EXP50 (connected to the T57W/T54W/T53W/T53 phones)/expansion module EXP43 (connected to the T48U/T46U/T43U phones).
Page 202: Wallpaper Customization
Phone Customization Settings > Preference > Upload Wallpaper > System Wallpaper Other Phones: Settings > Preference > Wallpaper Phone UI Menu > Basic > Display > Wallpaper Parameter expansion_module.backgrounds <y0000000000xx>.cfg Description It configures the wallpaper displayed on the connected EXP50 expansion module of the phone. T57W/T54W/T53W/T53: Default-exp50.jpg, 01-exp50.jpg, 02-exp50.jpg, 03-exp50.jpg, 04-exp50.jpg, 05-exp50.jpg, 06- exp50.jpg, 07-exp50.jpg, 08-exp50.jpg, 09-exp50.jpg or 10-exp50.jpg or custom wallpaper name (for...
Page 203: Custom Wallpaper Picture Limit
EXP wallpaper. After you set a picture in USB flash drive as the idle screen/Dsskey screen or EXP wallpaper, the picture is added to the Wallpaper list. Note: Yealink phones support USB flash drive in FAT32 or NTFS format. Related Topic...
Page 204: Example: Setting A Custom Picture As Wallpaper
Phone Customization Custom Wallpaper Picture Limit Example: Setting a Custom Picture as Wallpaper The following example shows the configuration for uploading custom picture named “wallpaper.jpg” and set it as idle screen wallpaper. The custom picture is placed on the provisioning server “192.168.10.25”. Example wallpaper_upload.url = http://192.168.10.25/wallpaper.jpg phone_setting.backgrounds = wallpaper.jpg...
Page 205: Screen Saver
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Screen Saver The screen saver will automatically start when the IP phone is idle for the preset waiting time. You can stop the screen saver at any time by pressing any key or touching the screen. When your phone is idle again for a preset waiting time, the screen saver starts again.
Page 206: Screensaver File Elements And Attributes
Phone Customization Customizing the Screen Saver File Screensaver File Elements and Attributes The following table lists the elements and attributes you can use to add custom information in the screensaver file. We recommend that you do not edit these elements and attributes. Elements Attributes Description...
Page 207: Custom Screensaver Picture Limit
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Custom Screensaver Picture Limit Either the smaller or the larger picture will be scaled proportionally to fit the screen. The screensaver picture format must meet the following: Single File Phone Model Format Resolution Note...
Page 208 Phone Customization Default Supported All color screen phones Devices Settings > Preference > Screensaver Display Clock (not configurable when the Screensaver Type is Web UI set to Server XML) Menu > Basic > Display > Screensaver > Display Clock (not configurable when the Screensaver Type Phone UI is set to Server XML) Parameter screensaver.type...
Page 209 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Delete all custom screen saver images: screensaver.delete = http://localhost/all Delete a custom screen saver image (for example, Screencapture.jpg): screensaver.delete = http://localhost/Screencapture.jpg Permitted http://localhost/all or http://localhost/name.(jpg/png/bmp/jpeg) Values Default Blank Supported All color screen phones Devices Parameter screensaver.xml_browser.url <y0000000000xx>.cfg...
Page 210: Adding A Screensaver Picture From A Usb Flash Drive
After you set a picture in USB flash drive as a screensaver, the pic- ture is added to the Screensaver list. Note: Yealink phones support USB flash drive in FAT32 or NTFS format. Related Topic...
Page 211: Supported Backlight Options
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Supported Backlight Options The following table lists available configuration options to configure the backlight of phone models/expansion mod- ules: Phone Model (and the connected Configuration Options expansion module) T57W(EXP50) T54W(EXP50) T48U(EXP43) Inactive Level (not applicable to EXP50/EXP43) T48S/G(EXP40) Active Level...
Page 212: Label Length For Line Key Display
Phone Customization Black-and-white Screen Phones: Menu > Settings > Basic Settings > Display > Backlight > Active Level Parameter phone_setting.inactive_backlight_level <y0000000000xx>.cfg It configures the intensity of the LCD screen when the phone is inactive. Description Note: If expansion module EXP20 or EXP40 is connected, the backlight on the expansion module automatically changes to match this setting.
Page 213: Label Length Display Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones When label length feature is set to Extended: For T54W/T46U/T46S/T46G/T29G phones, the display length of the line key label is extended and the characters are displayed in one line. For T57W/T48U/T48S/T48G phones, the characters are displayed in two lines. When label length feature is set to Mid Range (not applicable to T57W/T48U/T48S/T48G phones): Topic Label Length Display Configuration...
Page 214: Label Alignment For Line/Ext Key Display
Phone Customization 2-Mid-Range (only applicable to T54W/T46U/T46S/T46G/T29G phones) Default Supported All color screen phones Devices Web UI Dsskey > Line Key > Label Length Parameter features.shorten_linekey_label.enable <y0000000000xx>.cfg It enables or disables the phone to display the length of the line key label with 9 digits. Description Note: It works only if “features.config_dsskey_length”...
Page 215: Page Switch Key
Page Tips Page tips feature allows the page switch key to indicate different key status on the non-current page. It is mainly used when multi-page line keys are configured. Yealink T54W/T53W/T53/T46U/T46S/T46G/T43U/T42U/T42S/T42G/T41P/T41S/T29G/T27G phones and expansion module EXP50/EXP43 support page switch key. Topics...
Page 216: Phone Page Tips Configuration
Phone Customization The following table lists the status of page icons and page switch key LED displayed on the phones: Phone Models LED Status Icons Description Fast-flashing: the BLF monitored user Fast-flashing receives an incoming call on the non-cur- rent page. T54W/T46U/T46S/T46G/T29G Solid: there is a parked call to the line on Solid red...
Page 217: Expansion Module Page Tips Indicator
Time and Date Yealink phones maintain a local clock. You can choose to get the time and date from SNTP (Simple Network Time Protocol) time server to have the most accurate time and set DST (Daylight Saving Time) to make better use of day- light and to conserve energy, or you can set the time and date manually.
Page 218: Time Zone
Phone Customization 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 Zone Time Zone Name Time Zone Time Zone Name Eniwetok,Kwajalein Estonia(Tallinn)
Page 219 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Time Zone Time Zone Name Time Zone Time Zone Name Saskatchewan Kuwait,Riyadh United States-Central Time Nairobi Bahamas(Nassau) Minsk Bogota,Lima Volgograd (RTZ 2) Canada(Montreal,Ottawa,Quebec) +3:30 Iran(Teheran) Cuba(Havana) Armenia(Yerevan) Indiana (East) Azerbaijan(Baku) Peru Georgia(Tbilisi) Quito Russia(Samara)
Page 220 Phone Customization Time Zone Time Zone Name Time Zone Time Zone Name Brazil(no DST) Russia(Krasnoyarsk) Mid-Atlantic Thailand(Bangkok) Portugal(Azores) Vietnam(Hanoi) Cape Verde Islands Jakarta China(Beijing) Greenland Singapore(Singapore) Western Europe Time Hong Kong,Urumqi Monrovia Taipei Reykjavik Kuala Lumpur Casablanca Australia(Perth) Denmark-Faroe Islands(Torshavn) Russia(Irkutsk, Ulan-Ude) Ireland(Dublin) Ulaanbaatar...
Page 221: Ntp Settings
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Time Zone Time Zone Name Time Zone Time Zone Name Czech Republic(Prague) Fiji Islands Denmark(Kopenhagen) Russia(Kamchatka Time) France(Paris) Anadyr Germany(Berlin) Petropavlovsk-Kamchatsky (RTZ 11) Hungary(Budapest) Marshall Islands Italy(Rome) +12:45 New Zealand(Chatham Islands) Switzerland(Bern) Nuku'alofa Sweden(Stockholm)
Page 222 Phone Customization Black-and-white Screen Phones: Menu > Settings > Basic Settings > Time&Date > DHCP Time Parameter local_time.ntp_server1 <y0000000000xx>.cfg Description It configures the IP address or the domain name of the primary NTP server. Permitted String within 99 characters Values Default cn.pool.ntp.org Web UI...
Page 223: Dst Settings
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Black-and-white Screen Phones: Menu > Settings > Basic Settings > Time&Date > SNTP Settings > Time Zone Parameter local_time.time_zone_name <y0000000000xx>.cfg It configures the time zone name. Description Note: It works only if “local_time.summer_time” is set to 2 (Automatic) and the parameter “local_time.- time_zone”...
Page 224: Customizing Auto Dst File
Integer from -300 to 300 Customizing Auto DST File Before customizing, you need to obtain the AutoDST file. You can ask the distributor or Yealink FAE for DST tem- plate. You can also obtain the DST template online: http://sup- port.yealink.com/documentFront/forwardToDocumentFrontDisplayPage.
Page 225: Dst Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones DST Configuration The following table lists the parameters you can use to configure DST. Parameter local_time.summer_time <y0000000000xx>.cfg Description It configures the Daylight Saving Time (DST) feature. 0-Disabled Permitted 1-Enabled Values 2-Automatic Default Web UI Settings >...
Page 226: Time And Date Manually Configuration
Phone Customization Web UI Settings > Time&Date > Start Date Parameter local_time.end_time <y0000000000xx>.cfg It configures the end time of the Daylight Saving Time (DST). Description Note: It works only if “local_time.summer_time” is set to 1 (Enabled). Month/Day/Hour-DST by Date, use the following mapping: Month: 1=January, 2=February,…, 12=December Day: 1=the first day in a month,…, 31= the last day in a month Hour: 0=0am, 1=1am,…, 23=11pm...
Page 227: Time And Date Format Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones 0-Disabled, the phone obtains time and date from the NTP server. Permitted Values 1-Enabled Default Web UI Settings > Time&Date > Manual Time Color Screen Phones: Menu > Basic > Time & Date > General > Manual Settings Phone UI Black-and-white Screen Phones: Menu >...
Page 228: Date Customization Rule
Phone Customization Use the following mapping: “WWW” represents the abbreviation of the week; “DD” represents a two-digit day; “MMM” represents the first three letters of the month; “YYYY” represents a four-digit year, and “YY” represents a two-digit year. Default Web UI Settings >...
Page 229: Idle Clock Display
Since a logo is a visual entity signifying an organization or company, you can upload a custom logo shown on the LCD screen. The logo screen and the idle screen display alternately. The following shows a system logo (Yealink logo) displayed on T27G:...
Page 230: Custom Logo Picture Limit
: Before uploading your custom logo to phones, ensure your logo file is correctly formatted. Customizing a Logo Picture Yealink 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.
Page 231: Custom Logo Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones 3. Click the Convert button. Then you can find the DOB logo files in the adv directory. Custom Logo Configuration The following table lists the parameters you can use to configure the custom logo. Parameter phone_setting.lcd_logo.mode <y0000000000xx>.cfg Description It configures the logo shown on the LCD screen.
Page 232: Example: Setting A Custom Logo Display
Phone Customization Permitted URL within 511 characters Values Default Blank Supported All black-and-white screen phones Devices Web UI Features > General Information > Upload Logo Parameter phone_setting.lcd_logo.show_time <y0000000000xx>.cfg It configures the time (in seconds) the logo is displayed. If it is set to 0, after loading the logo, if there is no wake-up operation, it will not exit the logo display Description page.
Page 233: Call Display Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones You can configure what contact information presents and how to display the contact information. If the contact exists in the phone directory, the phone displays the saved contact name and number. If not, it will use the Calling Line Identification Presentation (CLIP) or Connected Line Identification Presentation (COLP) to display the contact’s iden- tity.
Page 234 Phone Customization Call-Info: <Image URL>;purpose=wallpaper Call-Info: <Image URL>;purpose=icon Note: If the phone receives both the call info information of "purpose = wallpaper" (wallpaper) and "purpose = icon" (avatar) at the same time, only the wallpaper is displayed, the avatar is not displayed. Permitted 0-Disabled Values...
Page 235: Display Method On Dialing
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Note: This parameter also affects the history records display. 0-Names matched to the entries in the following phone directories are displayed preferentially, the pri- ority is as follows: Local Directory > Remote Phone Book > Broadsoft Network Directory > BroadCloud Permitted Buddies >...
Page 236: Display Method On Dialing Configuration
Phone Customization Yealink phones support three display methods: Label, Display Name, and User Name. You can customize the account information to be displayed on the IP phone as required. Topic Display Method on Dialing Configuration Display Method on Dialing Configuration The following table lists the parameters you can use to configure the display method on dialing.
Page 237: Softkey Layout
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 tem- plate online: http://support.yealink.com/documentFront/forwardToDocumentFrontDisplayPage.
Page 238: Softkey Layout File Elements And Attributes
Phone Customization Softkey Layout File Elements and Attributes The following table lists the elements and attributes you need to understand in the softkey layout file. We recom- mend that you do not edit these elements and attributes. Elements & Attributes Description <Disable >...
Page 239: Softkey Layout Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones 4. Save the change and place this file to the provisioning server. Softkey Layout Configuration The following table lists the parameters you can use to configure the softkey layout. Parameter phone_setting.custom_softkey_enable <y0000000000xx>.cfg Description It enables or disables the custom soft keys layout feature.
Page 240 Phone Customization Default Blank Parameter features.custom_softkey_dynamic.enable <y0000000000xx>.cfg It enables or disables the phone to display the soft keys relevant to the features (call center, cent- ralized call recording, and executive-assistant). Description Note: It works only if “phone_setting.custom_softkey_enable” is set to 1 (Enabled). 0-Disabled Permitted 1-Enabled, the functional soft keys display on the phone screen if the corresponding feature is avail-...
Page 241: Example: Setting The Soft Keys Layout In Talking State
Hebrew. 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.
Page 242: Customizing The Keypad Input Method File
Yealink provides three types of input method files for onscreen keyboard customization. You can configure them as required. You can ask the distributor or Yealink FAE for onscreen keyboard input method files. You can also obtain the onscreen keyboard input method files online: http://sup- port.yealink.com/documentFront/forwardToDocumentFrontDisplayPage.
Page 243: Description Of The Onscreen Keyboard Input Method Files
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Description of the Onscreen Keyboard Input Method Files Before you customize the onscreen keyboard input method files, take a few moments to familiarize yourself with their formats and descriptions. File Name File Type Template File Description...
Page 244: Ime File Elements And Attributes
Phone Customization 3. Save the change and place this file to the provisioning server. Ime File Elements and Attributes The following table lists the elements and attributes you need to understand in the Ime file. We recommend that you do not edit these elements and attributes. Elements Attributes Description...
Page 245: Customizing An Ime File
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Function Key Usage right Position the cursor. Position the cursor. down Position the cursor. hide Hide the onscreen keyboard. Switch between the uppercase input mode and the lowercase input shift mode. lang Change the language of the keyboard.
Page 246: Customizing A Layout File
Phone Customization The value of attributes in a line element is the default value of the corresponding attribute in the key element. For example, if you have not configured the width attribute in the key element, the key will automatically use the value of width attribute configured in line element as the width.
Page 247 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones ish_LA, Turkish and Russian. Permitted URL within 511 characters Values Default Blank Parameter gui_input_method.delete <y0000000000xx>.cfg It deletes the specified or all custom keypad input method files of the phone user interface. Delete all custom keypad input method files: Description gui_input_method.delete = http://localhost/all...
Page 248: Example: Configuring The French Onscreen Keyboard Input Method
Phone Customization Default Parameter phone_setting.virtual_keyboard.enable <y0000000000xx>.cfg Description It enables or disables the phone to use the onscreen keyboard. Permitted 0-Disabled Values 1-Enabled Default Supported T57W, T48U, T48S, T48G Devices Parameter gui_onscreen_keyboard.url <y0000000000xx>.cfg Description It configures the access URL of the custom onscreen keyboard input method file. Permitted URL within 511 characters Values...
Page 249: Notification Popups
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones When using multiple keyboards, you can tap to change the language of the keyboard. Notification Popups Notification popups feature allows the IP phone to pop up the message when it misses a call, forwards an incoming call to another party, receives a new voice mail or a new text message.
Page 250: Power Led Indicator
Phone Customization Default Web UI Features > Notification Popups > Display Forward Call Popup Parameter features.text_message_popup.enable <y0000000000xx>.cfg It enables or disables the phone to pop up the message when it receives a new text message. Description Note: It works only if “features.text_message.enable” is set to 1. Permitted 0-Disabled 1-Enabled...
Page 251 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Description It enables or disables the power LED indicator to flash when the phone receives an incoming call. 0-Disabled (power LED indicator does not flash) 1-Enabled (power LED indicator fast flashes (0.3s) red) Permitted For T19(P) E2 phones: Values...
Page 252 Phone Customization Web UI Features > Power LED > Mute Power Light Flash phone_setting.hold_and_held_power_led_flash_ Parameter <y0000000000xx>.cfg enable Description It enables or disables the power LED indicator to flash when a call is placed on hold or is held. 0-Disabled (power LED indicator does not flash) 1-Enabled ( power LED indicator fast flashes (0.5s) red) Permitted For T19(P) E2 phones:...
Page 253: Bluetooth
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones It enables or disables the power LED indicator to flash when the phone performs an auto pro- Description visioning. 0-Disabled, auto provisioning does not change the LED status (that is, the original LED status will be Permitted kept).
Page 254 Note: It works only if “features.bluetooth_enable” is set to 1 (On). Permitted String within 64 characters Values Default Yealink $DEV Supported T57W, T54W, T53W, T53, T48U, T48S, T48G, T46U, T46S, T46G, T43U, T42U, T42S, T41S, T29G, Devices T27G, CP920 Color Screen Phones: Menu >...
Page 255: Handset/Headset/Speakerphone Mode
If you change this parameter, the phone will reboot to make the change take effect. Handset/Headset/Speakerphone Mode Yealink phones support three ways to place/answer a call: using the handset, using the headset or using the speak- erphone. You can disable the infrequently used audio device as required.
Page 256: Dss Keys
Phone Customization Devices Parameter features.headset_mode.enable <y0000000000xx>.cfg Description It enables or disables the phone’s headset mode. Permitted 0-Disabled Values 1-Enabled Default Supported All phones except CP920 Devices Parameter features.headset.group_listen_in_talking_enable <y0000000000xx>.cfg It enables or disables the phone to enter into the group listening mode by pressing the Speakerphone key when you first answer the call using the headset.
Page 257: Supported Dss Keys
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Supported DSS Keys The following table lists the number of DSS keys you can configure for each phone model: Phone Model Line Keys Programmable Keys Ext Keys T57W T54W T53W/T53/T43U T48U T48G/T48S T46U T46S/T46G...
Page 258: Line Keys
Phone Customization DSS Key Types DSS Key Types DSS Key Types Menu Google Contacts (only appear when (Programmable key) “google_contact_server.enable = 1”) Pickup(Pick up/ Direct Status XML Park Pickup) (Programmable key) (Line key/Ext key) Call Park Extend Hot Desking (Line key/Ext key) (Line key/Programmable key) DTMF URL Record...
Page 259 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones types are not available when you configure line keys. Note: Multiple line key type IDs are separated by commas. “N/A” type is always kept. Permitted Blank or 0 (all valid function types are available); line key type IDs. For supported line key types and IDs, refer to Supported Dsskey Types.
Page 260 Phone Customization Devices Web UI Dsskey > Line Key > Line KeyX > Type Phone UI Menu > Features > DSS Keys > Line Key X > Type Parameter linekey.X.line <y0000000000xx>.cfg Descrip- It configures the desired line to apply the line key feature. tion T57W/T54W/T48U/T48S/T48G/T46U/T46S/T46G/T29G: 0, 1-16;...
Page 261 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Phone UI Menu > Features > DSS Keys > Line Key X > Label Parameter linekey.X.extension <y0000000000xx>.cfg For multicast paging: It configures the channel of the multicast paging group. Descrip- For the BLF/BLF list/intercom feature: tion It configures the pickup code.
Page 262: Example: Set A Park/Retrieve Key For Fac Call Park Mode
Phone Customization Parameter features.block_linekey_in_menu.enable <y0000000000xx>.cfg Descrip- It enables or disables the phone to prevent the user from using line keys when browsing the menu. tion 0-Disabled Permitted Values 1-Enabled, it prevents the user from using line keys. Default Supported All phones except T57W, T48U, T48S, T48G, T19(P) E2 and CP920 Devices X is the line key ID.
Page 263: Example: Setting A Line Key As Directed Pickup Key
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones ######Set a Park key###### linekey.1.type = 10 linekey.1.value =*01 linekey.1.line = 1 linekey.1.label =Bill ######Set a Retrieve key#### linekey.3.type = 56 linekey.3.line = 1 linekey.3.value =*11 linekey.3.label =Retrieve Bill After provisioning, you can easily press the Park key (line key 1) to park a call to the specific shared parking lot (*01) during a call, and press the Retrieve key (line key 3) to retrieve the parked call from the shared parking lot (*01) using the retrieve code (*11).
Page 264: Example: Setting A Line Key As Forward Key
Phone Customization linekey.1.label =Sell After provisioning, you can easily press the Group Pickup key (line key 1) to pick up an incoming call to any phone within a predefined group of phones. Note : If the “linekey.X.value” is not assigned with a group pickup code, the Park key will invoke the group pickup code set by “features.pickup.group_pickup_code”...
Page 265: Example: Setting A Line Key As Blf List Key
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Example: Setting a Line Key as BLF List Key The following example shows the configuration for a BLF List key. Scenario Conditions Related Topic phone_setting.auto_blf_list_enable = 0 BLF List Configuration Example linekey.1.type = 39 linekey.1.line =1 After provisioning, a BLF List key displays on line key 1.
Page 266: Programmable Keys Configuration
Phone Customization T53W/T53/T43U/ T42G/T42S/T42- T54W/T48U/T48G/ Pro- T19(P) T23P/T23G/T2- T29G/T27- grammable CP920 T57W T48S/T46U/T46S/T46- 1(P) E2 Key IDs T41P/T41S /T40P/T40G SoftKey- SoftKey1 SoftKey1 SoftKey1 SoftKey1 SoftKey1 SoftKey1 SoftKey- SoftKey2 SoftKey2 SoftKey2 SoftKey2 SoftKey2 SoftKey2 SoftKey- SoftKey3 SoftKey3 SoftKey3 SoftKey3 SoftKey3 SoftKey3 SoftKey- SoftKey4 SoftKey4...
Page 267 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Blank or 0 (all valid function types are available); Permitted Dsskey type IDs. Values For supported Dsskey types and IDs, refer to Supported Dsskey Types. Default Blank Parameter programablekey.X.type <y0000000000xx>.cfg Description It configures a key feature for a specific programmable key. 43-Local Directory (Local Phonebook) 45-Local Group 0-N/A...
Page 268 Phone Customization Default Web UI Dsskey > Programmable Key > Line Parameter programablekey.X.line <y0000000000xx>.cfg Description It configures the desired line to apply the programmable key feature. T57W/T54W/T48U/T48S/T48G/T46U/T46S/T46G/T29G: 0, 1-16; T53W/T53/T43U/T42U/T42S/T42G: 0, 1-12; T41P/T41S/T27G: 0, 1-6; T40P/T40G/T23P/T23G: 0, 1-3; T21(P) E2: 0, 1-2; CP920: 1, 101, 102.
Page 269: Ext Keys
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Web UI Dsskey > Programmable Key > Label <y0000000000xx>.cfg Parameter programablekey.X.extension For multicast paging: It configures the channel of the multicast paging group. Description For intercom feature: It configures the pickup code. Note: It is only applicable when “programablekey.X.type”...
Page 270 Phone Customization To assign function types, specify ext 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” types are available when you configure ext keys. To remove a function type, specify ext key type IDs which start with the symbol “-”.
Page 271 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Y=1 or 21, default: 37 – Switch, only for T29G/T27G Y=2-20, 22-40, default: 0 – NA, only for T29G/T27G Supported T57W, T54W, T53W, T53, T48U, T48S, T48G, T46U, T46S, T46G, T43U, T29G, T27G Devices Web UI Dsskey >...
Page 272: Dsskey Lock Configuration
Phone Customization Note: It is only applicable when “expansion_module.X.key.Y.type” is set to 14, 16, 24 or 39. For multicast paging: 0 to 31 Permitted Values For the BLF/BLF list/intercom feature: String within 256 characters Default Supported T57W, T54W, T53W, T53, T48U, T48S, T48G, T46U, T46S, T46G, T43U, T29G, T27G Devices Web UI Dsskey >...
Page 273: Dsskey Page Reset Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Values Default Blank (no prompt for entering the unlock password) Supported All phones except T48G, T46G, T42G, T41P and T29G Devices Dsskey Page Reset Configuration The following table lists the parameter you can use to configure reset dsskey page. features.dsskey_page_reset.call_estab- Parameter <y0000000000xx>.cfg...
Page 274: Guidelines For Configuring Enhanced Dss Keys
The rules for configuring EDK for DSS keys are different. Before using EDK, you are advised to become familiar with the macro language. For more information on Enhanced DSS Keys, refer to Using Enhanced DSS Keys on Yealink IP Phones. Topics...
Page 275 Example: $Sanswer$ means pressing the Answer soft key. $S<softkey ID>$ Yealink phones support customizing soft keys. When the phone invokes a cus- tom soft key, the prefix “#” must be added. Example: If the custom softkey label is IVR1, the custom softkey ID is custom_ macro, then $S#custom_macro$ means pressing the IVR1 soft key.
Page 276 Phone Customization Macro Action Description DialPadPound DialPadStar Headset Mute Message Hold Redial Transfer Speaker Conference (only applicable to T29G/T27G) ExtX@Y (X stands for the serial number of expansion module key, Y stands for the serial number of expansion module; For T48S/T48G/T46S/T46G/T29G: X ranges from 1 to 40, Y ranges from 1 to 6;...
Page 277 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Macro Action Description Example: $PPassword&C3&N&M$ means prompting a Password pop-up box, the maximum number of input characters is 3, the input type is Number, and the input is masked by the asterisk characters “*” (dot for T57W/T48U/T48S/T48G).
Page 278: Edk Configuration
By default, the EDK feature is disabled. Yealink phones can display the softkey ID or menu item ID by long pressing the Volume Up key. It is especially use- ful for those users who need to view the softkey ID or menu item ID when configuring EDK macros.
Page 279: Edk User Input Prompt Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Parameter edk.edklist.X.enable <y0000000000xx>.cfg It enables or disables Enhanced DSS Keys (EDK) macro X. Description Note: It works only if “features.enhanced_dss_keys.enable” is set to 1 (Enabled). Permitted 0-Disabled 1-Enabled Values Default Parameter edk.edklist.X.mname <y0000000000xx>.cfg It configures the unique identifier used by the soft key or DSS key configuration to reference the enhanced DSS keys entry for macro X.
Page 280 Phone Customization Parameter edk.edkprompt.X.label <y0000000000xx>.cfg It configures the text string used as a label of the user input prompt X. If it is left blank, Default is displayed. Example: Description edk.edkprompt.1.label = Enter Password Note: It works only if “features.enhanced_dss_keys.enable” and “edk.edkprompt.X.enable” are set to 1 (Enabled).
Page 281: Edk Soft Keys Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones EDK Soft Keys Configuration You can customize the soft keys as need. This feature is typically used to access frequently-used functions or to cre- ate menu shortcuts to frequently-used phone settings. Custom soft keys can be added in the following phone states: Idle - There are no active calls on the phone.
Page 282 Phone Customization Default Parameter softkey.X.action <y0000000000xx>.cfg It configures the action or function for custom soft key X. This value uses the same macro action string syntax as an Enhanced DSS key. You can also invoke the EDK macro that was already defined. The macro name follows the character “!”.
Page 283 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones (Enabled). Permitted 0-Disabled 1-Enabled Values Default Parameter softkey.X.use.transfer_connecting <y0000000000xx>.cfg It enables or disables the custom soft key X to be displayed in the transfer connecting state. Description Note: It works only if “features.enhanced_dss_keys.enable” and “softkey.X.enable” are set to 1 (Enabled).
Page 284: Example: Configuring Edk List For A Line Key
Phone Customization Note: It works only if “features.enhanced_dss_keys.enable” and “softkey.X.enable” are set to 1 (Enabled). Permitted 0-Disabled Values 1-Enabled Default Parameter softkey.X.use.held <y0000000000xx>.cfg It enables or disables the custom soft key X to be displayed in the held state. Description Note: It works only if “features.enhanced_dss_keys.enable”...
Page 285: Example: Using Edk Macro Strings As The Contact Number
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones edk.edklist.1.action = 1013$Tinvite$$Cwc$$Cp10$$Penter number&C4&N$$Tdtmf$$Cp3$$Chu$ linekey.1.type = 73 linekey.1.value = !IVR1 linekey.1.label = Custom After provisioning, the line key 1 will invoke the macro “IVR1”. You can press the line key 1 to execute the action “1013$Tinvite$$Cwc$$Cp10$$Penter number&C4&N$$Tdtmf$$Cp3$$Chu$”.
Page 286: Power Saving Configuration
Phone Customization Power Saving Configuration You can enable or disable power saving, and set the 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 hours to avoid affecting your work.
Page 287 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Supported All phones except T19(P) E2 Devices Web UI Settings > Power Saving > Office Hour Idle TimeOut Parameter features.power_saving.off_hour.idle_timeout <y0000000000xx>.cfg It configures the time (in minutes) to wait in the idle state before phone enters power-saving mode dur- Description ing the non-office hours.
Page 288: Search Source List In Dialing
Search Source File Customization Search Source List Configuration Search Source File Customization You can ask the distributor or Yealink FAE for super search template. You can also obtain the super search tem- plate online: http://support.yealink.com/documentFront/forwardToDocumentFrontDisplayPage. Topics Search Source File Attributes...
Page 289: Search Source File Attributes
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Search Source File Attributes The following table lists the attributes you can use to add source lists to the super search file: Attributes Valid Values Description local_directory_search calllog_search remote_directory_search ldap_search BroadSoft_directory_search The directory list (For example, “local_directory_search”...
Page 290: Customizing Search Source File
Phone Customization Attributes Valid Values Description T29 T46 T46S T48 T48S T42S T41S T27G CP920 T54W T53W T53 T57W T48U T46U T43U T42U Customizing Search Source File 1. Open the search source file. 2. To configure each directory list, edit the values within double quotes in the corresponding field. For example, enable the local directory search, disable the call log search and specify a priority.
Page 291 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Web UI Directory > Settings > Search Source List In Dialing Parameter search_in_dialing.history.priority <y0000000000xx>.cfg Description It configures the search priority of the call history list. Permitted Integer greater than or equal to 0 Values Default Web UI...
Page 292: Recent Call Display In Dialing
Icon Customization You can upload custom DSS keys icons and menu icons to the phone. Contact Yealink FAE to obtain the Icon Tem- plates Pack. Make sure that the name, size, and format of new icons are the same as the built-in ones.
Page 293: Warnings Display
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Supported T57W, T54W, T48U, T48S, T46U, T46S Devices Parameter phone_setting.icon.delete <y0000000000xx>.cfg Description It deletes all custom icons. Permitted http://localhost/all Values Default Blank Supported T57W, T54W, T48U, T48S, T46U, T46S Devices If you change this parameter, the phone will reboot to make the change take effect. Warnings Display When one of the following situations occurs: The default password is being used...
Page 294 Phone Customization Parameter features.out_of_service_alert.enable <y0000000000xx>.cfg It enables or disables the phone to play an alert tone when out of service caused by network abnor- mality. Description Note: You can customize the alert tone by the parameter "voice.tone.congestion". 0-Disabled Permitted Values 1-Enabled Default Supported...
Page 295: Account Settings
Multiple Line Keys per Account Account Registration Registering an account makes it easier for the phones to receive an incoming call or dial an outgoing call. Yealink phone supports registering multiple accounts on a phone (T19(P) E2 phones only support registering one SIP account;...
Page 296 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Default Web UI Account > Register > Line Active Color Screen Phones: Menu > Advanced (default password: admin) > Accounts > Account X > Activation Phone UI Black-and-white Screen Phones: Menu > Settings > Advanced Settings (default password: admin) > Accounts > Activation Parameter account.X.label <MAC>.cfg Description It configures the display label of the account.
Page 297 Account Settings Description It configures the user name of the account. Permitted String within 99 characters Values Default Blank Web UI Account > Register > Username Color Screen Phones: Menu > Advanced (default password: admin) > Accounts > Account X > User Name Phone UI Black-and-white Screen Phones: Menu >...
Page 298 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Description It enables or disables the phone to send requests to the outbound proxy server. Permitted 0-Disabled 1-Enabled Values Default Web UI Account > Register > Enable Outbound Proxy Server Color Screen Phones: Menu >...
Page 299: Pstn Account Configuration
Account Settings Note: It is used in conjunction with the parameter "account.X.reg_failed_retry_max_time" to determine how long to wait. The algorithm is defined in RFC 5626. We recommend that you set this value to an integer between 10 to 120 if needed. If the values of this parameter and the parameter "accoun- t.X.reg_failed_retry_max_time"...
Page 300: Registration Settings Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Web UI Account > Register > Label Phone UI Menu > Settings > Advanced Settings (default password: admin) > Accounts > Label X is the PSTN account ID. X= 1 to 2. Registration Settings Configuration The following table lists the parameters you can use to change the registration settings.
Page 301 Account Settings Description It enables or disables the phone to unregister first before re-registering account X after a reboot. Permitted 0-Disabled Values 1-Enabled Default Web UI Account > Advanced > Unregister When Reboot Parameter account.X.sip_server_type <MAC>.cfg Description It configures the type of SIP server. 0-Default 2-BroadSoft (It works only if “bw.enable"...
Page 302: Outbound Proxy In Dialog
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Description It enables or disables the phone to disable the account whose username is empty. Permitted 0-Disabled Values 1-Enabled Default Parameter account.X.register_expires_overlap <MAC>.cfg Description It configures the renewal time (in seconds) away from the registration lease. Permitted Positive integer and -1 Values...
Page 303: Server Redundancy
(a working server and a fallback server) are configured for per line registration. Working Server: Server 1 is configured with the domain name of the working server. For example yealink.p- bx.com. DNS mechanism is used such that the working server is resolved to multiple servers with different IP addresses for failover purpose.
Page 304: Behaviors When Working Server Connection Fails
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Yealink devices support Failover and Fallback server redundancy types. In some cases, you can deploy a com- bination of the two server redundancy types. For more information on server redundancy, refer to...
Page 305: Failover Server Redundancy Configuration
Account Settings Values 1-Successive registration Default Parameter account.X.fallback.timeout <MAC>.cfg It configures the time interval (in seconds) for the phone to detect whether the working server is avail- able by sending the registration request after the fallback server takes over call control. Description Note: It is not applicable to outbound proxy servers.
Page 306 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Default Parameter sip.skip_redundant_failover_addr <y0000000000xx>.cfg It enables or disables the phone only to send requests to the servers with different IP addresses when Description encountering a failover. Permitted 0-Disabled 1-Enabled Values Default [1][2] Parameter account.X.sip_server.Y.expires <MAC>.cfg...
Page 307 Account Settings DNSTTL on the registered server expires, the phone will retry to send requests to the primary server. 2-Registration: the phone will send requests to the last registered server first. If the registration expires, the phone will retry to send requests to the primary server. 3-duration: the phone will send requests to the last registered server first.
Page 308 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones It enables or disables the phone to only send requests to the registered outbound proxy server when encountering a failover. Description Note: It works only if “account.X.outbound_proxy.Y.register_on_enable” is set to 1 (Enabled) and “account.X.outbound_proxy.Y.failback_mode”...
Page 309: Sip Server Name Resolution
Account Settings ing the normal use of the features associated with a subscription (for example, BLF, SCA). Default -1, the phone will invoke “account.X.sip_server.Y.failback_subscribe.enable” to take effect. [1][2] Parameter account.X.sip_server.Y.outbound_proxy_enable <MAC>.cfg It enables or disables the phone to use outbound proxy server address configured by “accoun- t.X.outbound_proxy.Y.address”.
Page 310: Static Dns Cache
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Values 1-SRV query using UDP, TCP, and TLS. Default Parameter sip.dns_transport_type <y0000000000xx>.cfg Description It configures the transport protocol the phone uses to perform a DNS query. 0-UDP Permitted Values 1-TCP Default Parameter static.network.dns.query_timeout <y0000000000xx>.cfg It configures the interval (in seconds) at which the phone retries to resolve a domain name when the...
Page 311: Static Dns Cache Configuration
Account Settings If the configured time interval is elapsed, the phone will attempt to perform a DNS query again. If the DNS query returns a result, the phone will use the returned record from the DNS server and ignore the stat- ically configured cache values.
Page 312 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Description It configures a domain name to be used for the next SRV query in NAPTR record X. Permitted Domain name Values Default Blank Parameter dns_cache_naptr.X.service <y0000000000xx>.cfg Description It configures the transport protocol available for the SIP server in NAPTR record X. SIP+D2U-SIP over UDP Permitted SIP+D2T-SIP over TCP...
Page 313 Account Settings When priorities are equal, weight is used to differentiate the preference. Higher weight is more pre- ferred. Permitted Integer from 0 to 65535 Values Default Parameter dns_cache_srv.X.ttl <y0000000000xx>.cfg It configures the time interval (in seconds) that SRV record X may be cached before the record should Description be consulted again.
Page 314: Logon Wizard
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Default 3600 Parameter static.network.dns.last_cache_expired.enable <y0000000000xx>.cfg It enables or disables the phone to use the DNS cache (even if the cache has expired) when the DNS Description server fails to resolve the domain name. Permitted 0-Disabled 1-Enabled...
Page 315 Account Settings tup when there is no registered account. Note: It works only if “phone_setting.logon_wizard” is set to 1 (Enabled). Permitted 0-Disabled 1-Enabled Values Default Supported All phones except CP920 Devices Parameter hotdesking.startup_password_enable <y0000000000xx>.cfg It enables or disables the phone to provide an input field of password on the logon wizard after startup when there is no registered account.
Page 316: Multiple Line Keys Per Account
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Multiple Line Keys per Account You can assign multiple line keys to associate with a specific account. The line keys are automatically assigned with Line type from the first unused one (unused one means the line key is configured as N/A or the associated account is not registered).
Page 317 Account Settings Default Supported All phones except T19(P) E2 and CP920 Devices account.X.phone_setting.call_appearance.transfer_via_new_ Parameter <MAC>.cfg linekey It enables or disables to distribute a transferring call to a new line key (the new line key is not seized) for account X. If all line keys are seized, the current line key will be used.
Page 318: Auto Line Labels Rule Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Default Blank Supported All phones except T19(P) E2 and CP920 Devices X is the account ID. For T57W/T54W/T48U/T48S/T48G/T46U/T46S/T46G/T29G, X=1-16; for T53W/T53/T43U/T42U/T42G/T42S, X=1-12; for T41P/T41S/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 Label (set by “account.X.label”) as default label to display on the screen.
Page 319 Account Settings The following table lists the parameters you can use to configure the default account. Parameter static.features.default_account <y0000000000xx>.cfg It configures the default account. 1-Account 1 2-Account 2 3-Account 3 … 16-Account 16 100-PSTN 1 Description 101-PSTN 2 For T57W/T54W/T48U/T48S/T48G/T46U/T46S/T46G/T29G, accounts 1-16. For T53W/T53/T43U/T42U/T42S/T42G, accounts 1-12.
Page 320: Directory
1000 contacts and 48 groups (47 groups for CP920 phones). Contacts and groups can be added either one by one or in batch using a local contact file. Yealink phones support both *.xml and *.csv format contact files, but you can only customize the *.xml format contact file.
Page 321 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Note : You can package the tar formatted file using the tool 7-Zip or GnuWin32. You can download 7-Zip online: http://www.7-zip.org/ http://gnuwin32.sourceforge.net/packages/gtar.htm and GnuWin32 online: The procedure may be different if you package the tar formatted file using other software that is not listed above. Procedure 1.
Page 322: Local Contact File Customization
8. Click the OK button. A photo.tar file is generated in the directory C:\Program Files\photo. Local Contact File Customization You can ask the distributor or Yealink FAE for local contact template. You can also obtain the local contact template online: http://support.yealink.com/documentFront/forwardToDocumentFrontDisplayPage. Topics...
Page 323 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Elements Attributes Description Error: display_name="Hurrell " &" Mclean" Correct 1: display_name="Hurrell & Mclean" Correct 2: display_name="Hurrell & Mclean" Note: The contact name cannot be blank. office_number Specify the office number or macro EDK Macro Strings. mobile_number Specify the mobile number or macro EDK Macro Strings.
Page 324: Customizing Local Contact File
Directory Example: Using EDK Macro Strings as the Contact Number XML Conversion Table Customizing Local Contact File 1. Open the local contact file. 2. To add a group, add <group display_name="" ring=""/ > to the file. Each starts on a new line. 3.
Page 325 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones local_contact.photo.url = tftp://192.168.10.25/Photo.jpg Permitted URL within 511 characters Values Default Blank Supported All color screen phones Devices Parameter local_contact.icon_image.url <y0000000000xx>.cfg It configures the access URL of a contact icon file. The format of the contact icon must be *.png, *.jpg, *.bmp, *.jpeg. Description The contact icon file should be uploaded to the provisioning server in advance.
Page 326: Example: Adding Contacts Using A Contact File
Directory Devices Parameter local_contact.icon.url <y0000000000xx>.cfg It configures the access URL of a TAR contact icon file. The format of the contact icon must be *.png, *.jpg, *.bmp. The contact icon file should be compressed as a TAR file in advance and then place it to the pro- Description visioning server.
Page 327: Local Contacts Backup
Local Contacts Backup Yealink phones support storing all local contacts to a contact file named <MAC>-contact.xml. You can back up this file to the server, avoiding data loss. Once the contacts update, the phone will automatically upload this file to the provisioning server or a specific server.
Page 328: Favorite Contacts
Directory Default Favorite Contacts You can enable the user to mark local contacts as favorites. The favorite contacts are stored in the Favorites dir- ectory and the phone will automatically assign Speed Dial keys for these favorite contacts. The following figures show that you have three favorite contacts: In the Favorites directory: On the idle screen: Topic...
Page 329: Google Contacts
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Values 1-Enter the Add Contact screen Default Supported All phones except T19(P) E2 and CP920 Devices Parameter phone_setting.favorite_sequence_type <y0000000000xx>.cfg It configures the order of Speed Dial (Favorite) keys to be assigned automatically. Description Note: It works only if “local_contact.favorite.enable”...
Page 330: Signing In To The Google Contact Server
2 or 3. The following LDAP servers are supported: Microsoft Active Directory Sun ONE Directory Server Open LDAP Directory Server Microsoft Active Directory Application Mode (ADAM) LDAP Directory on Yealink IP Phones For more information on LDAP, refer to Topics LDAP Attributes Securely Storing the LDAP Credentials...
Page 331: Securely Storing The Ldap Credentials
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Abbreviation Name Description distinguishedName Unique identifier for each entry Domain component company Company or organization name telephoneNumber Office phone number mobile mobilephoneNumber Mobile or cellular phone number ipPhone IPphoneNumber Home phone number Securely Storing the LDAP Credentials You can enable the IP phone to securely store the LDAP user credentials when Broadsoft Flexible Seating feature is enabled.
Page 332 Directory Example: ldap.name_filter = (|(cn=%)(sn=%)) When the cn or sn of the LDAP contact matches the entered name, the record will be displayed on the phone screen. ldap.name_filter = (&(cn=*)(sn=%)) When the cn of the LDAP contact is set and the sn of the LDAP contact matches the entered name, the records will be displayed on the phone screen.
Page 333 It configures the LDAP search base which corresponds to the location of the LDAP phonebook from which the LDAP search request begins. The search base narrows the search scope and decreases directory search time. Description Example: ldap.base = dc=yealink,dc=cn Permitted String within 99 characters Values Default...
Page 334 Directory Parameter ldap.password <y0000000000xx>.cfg It configures the password to log into the LDAP server. Description This parameter can be left blank in case the server allows anonymous to log into. Otherwise, you will need to provide the password to log into the LDAP server. Permitted String within 99 characters Values...
Page 335 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones user0007-telephoneNumber (blank), mobile (18954125624) Set the following: ldap.numb_attr = telephoneNumber mobile This requires the "telephoneNumber" and “mobile” attributes set for each contact record on the LDAP server. And the phone screen will display the number in the order of the configured attributes (tele- phoneNumber >...
Page 336 Directory Default Web UI Directory > LDAP > LDAP Lookup for Callout Parameter ldap.ldap_sort <y0000000000xx>.cfg Description It enables or disables the phone to sort the search results in alphabetical order or numerical order. Permitted 0-Disabled Values 1-Enabled Default Web UI Directory >...
Page 337 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones ldap.extra_attr = title lang This requires the "title" and “lang” extra attributes set for each contact record on the LDAP server. Note: It works only if “ldap.enable” is set to 1 (Enabled). Permitted String Values...
Page 338: Remote Phone Book
You can add multiple contacts at a time and/or share contacts between the phones using the supplied template files (Menu.xml and Department.xml). You can ask the distributor or Yealink FAE for remote phone book template. You can also obtain the remote phone book template online: http://support.yealink.com/documentFront/forwardToDocumentFrontDisplayPage.
Page 339: Customizing Remote Phone Book File
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Template Element Valid Values <URL > Department URI</URL > Specify the department/group access URL between <URL > and</URL > </MenuItem > <SoftKeyItem > Specify a department/group file for a key: <Name > #</Name > Specify *key, # key or digit key between <Name >...
Page 340 Directory should be less than 750K. For other phones, the size of a remote phone book file should be less than 1.5M. Permitted URL within 511 characters Values Default Blank Web UI Directory > Remote Phone Book > Remote URL Parameter remote_phonebook.data.X.name <y0000000000xx>.cfg Description It configures the display name of the remote phone book item.
Page 341: Example: Configuring A Remote Phone Book
Directory List File Customization Directory List Configuration Example: Configuring a Directory List Directory List File Customization You can ask the distributor or Yealink FAE for directory template. You can also obtain the directory template online: http://support.yealink.com/documentFront/forwardToDocumentFrontDisplayPage. Topics Directory List File Attributes...
Page 342: Directory List File Attributes
Directory Directory List File Attributes The following table lists the attributes you can use to add contact lists to the directory list file. We recommend that you do not edit these attributes. Attributes Valid Values Description localdirectory history networkcalllog remotedirectory ldap broadsoftdirectory plcmdirectory...
Page 343: Customizing Directory List File
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Attributes Valid Values Description Google Contact Shared Directory (only applicable to T57W/T54W/T53W/T53 phones) Dect Intercom (only applicable to T57WT54W/T53W/T53 phones) Presence List 1 to 18 priority The display priority of the directory list. 1 is the highest priority.
Page 344 Directory 1-Enabled Values Default Parameter directory_setting.local_directory.priority <y0000000000xx>.cfg Description It configures the display priority of the local directory. Permitted Integer greater than or equal to 0 Values Default Parameter directory_setting.history.enable <y0000000000xx>.cfg Description It enables or disables the users to access the history by pressing the Directory/Dir soft key. Permitted 0-Disabled 1-Enabled...
Page 345: Example: Configuring A Directory List
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Values Default Example: Configuring a Directory List The following example shows the configuration for the directory list. Customize the directory list file, and then place this file to the provisioning server “http://192.168.10.25”. Example static.directory_setting.url = http://192.168.10.25 /favorite_setting.xml After provisioning, you can press the Directory/Dir soft key to access the desired contact list quickly.
Page 346: Number Matching Settings
Directory Default Supported All color screen phones Devices Parameter phone_setting.search_t9.enable <y0000000000xx>.cfg It enables or disables the phone to perform an intelligent search when searching for contacts in the dir- Description ectory. 0-Disabled, the phone only displays the search results of a number match. Permitted Values 1-Enabled...
Page 347: Example: Matching Contacts With The Caller's Phone Number Using The Regular Expression
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Description It configures the matching pattern used to identify the replaced string of the caller's phone number. Permitted Regular Expression Values Default Blank Related phone_setting.reverse_lookup.incoming_call.replace.with Parameters Supported All phones except T48G, T46G, T42G, T41P and T29G Devices Parameter phone_setting.reverse_lookup.incoming_call.replace.with <y0000000000xx>.cfg...
Page 348: Call Log
Call Log Call Log Yealink phones record and maintain phone events to a call log, also known as a call list. Call log consists of four lists: Missed Calls, Placed Calls, Received Calls, and Forwarded Calls. Each call log list supports up to 100 entries.
Page 349 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones 0-Disabled, the phone cannot log the placed calls, received calls, missed calls and the forwarded Permitted calls in the call lists. Values 1-Enabled Default Web UI Features > General Information > Save Call Log Color Screen Phones: Menu >...
Page 350 Call Log Reject an incoming call Forward an incoming call The outgoing call is rejected Transfer a call Answer a transferred/forwarded call from the remote party; your call is transferred/forwarded to another party. Note: It works only if “features.save_call_history” is set to 1 (Enabled). 0-Disabled Permitted 1-Enabled, you can get the detailed call-disposition information at the path via the phone user inter-...
Page 351 Call Logs Backup Yealink phones support storing all call logs to a call log file named <MAC>-calllog.xml. You can back up this file to the server, avoiding data loss. Once the call logs update, the phone will automatically upload this file to the pro- visioning server or a specific server.
Page 352 Call Log Default Blank Parameter static.auto_provision.local_calllog.write_delay.terminated <y0000000000xx>.cfg It configures the delay time (in seconds) for the phone to upload the <MAC>-calllog.xml file each time the call logs update. Description Note: It works only if “static.auto_provision.local_calllog.backup.enable” is set to 1 (Enabled). Permitted Integer from 10 to 600 Values...
Page 353: Call Features
You can use the regular expression to define the dial plan. Yealink phones support four patterns: Replace rule: is an alternative string that replaces the numbers entered by the user. Yealink phones support up to 100 replace rules.
Page 354: Basic Regular Expression Syntax For Four Patterns
The replace rule file helps create multiple replace rules. At most 100 replace rules can be added to the IP phone. It is not applicable to T19(P) E2 phones. You can ask the distributor or Yealink FAE for the replace rule file template. You can also obtain the replace rule file template online: http://support.yealink.com/documentFront/forwardToDocumentFrontDisplayPage.
Page 355: Customizing The Replace Rule File
The dial now file helps create multiple dial now rules. At most 100 dial now rules can be added to the IP phone. It is not applicable to T19(P) E2 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 356: Customizing The Dial Now File
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Attributes Description Note: This is not applicable to T19(P) E2 phones. Customizing the Dial Now File 1. Open the dial now file. 2. To add a dial-now rule, add <Data DialNowRule="" LineID="" / > to the file. Each starts on a new line. 3.
Page 357: Dial Now Configuration
Call Features 0 to 2 (for T21(P) E2) 0, 1 (for CP920) Default Blank Supported All phones except T19(P) E2 Devices Web UI Settings > Dial Plan > Replace Rule > Account Parameter dialplan_replace_rule.url <y0000000000xx>.cfg It configures the access URL of the replace rule template file. For customizing replace rule template file, refer to Replace Rule File Customization.
Page 358: Area Code Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones 0 to 2 (for T21(P) E2) 0, 1 (for CP920) Default Blank Supported All phones except T19(P) E2 Devices Web UI Settings > Dial Plan > Dial Now > Account Parameter phone_setting.dialnow_delay <y0000000000xx>.cfg It configures the delay time (in seconds) for the dial now rule.
Page 359: Block Out Configuration
Call Features Note: The length of the entered number must be between the minimum length configured by the para- meter “dialplan.area_code.min_len” and the maximum length configured by the parameter “dial- plan.area_code.max_len”. It works only if “dialplan.digitmap.enable” and “account.X.dialplan.digitmap.enable” are set to 0 (Disabled). Permitted String within 16 characters Values...
Page 360: Example: Adding Replace Rules Using A Replace Rule File
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Parameter dialplan.block_out.number.X <y0000000000xx>.cfg It configures the block out numbers. Example: dialplan.block_out.number.1 = 4321 Description When you dial the number “4321” on your phone, the dialing will fail and the phone screen will prompt "Forbidden Number".
Page 361: Dial Plan Defined By Digit Map (New Dial Plan Mechanism)
Call Features Dial Plan Defined by Digit Map (New Dial Plan Mechanism) Digit maps, described in 3435, are defined by a single string or a list of strings. If a number entered matches any string of a digit map, the call is automatically placed. If a number entered matches no string - an impossible match - you can specify the phone’s behavior.
Page 362: Digit Map For All Lines Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Example: “235x!” would match “2351”, “2352”, “2353”, and so on. The number starting with 235 will be blocked to dial out. The comma “,” can be used as a separator to generate a secondary dial tone. Example: “<9,:55>xx”, after entering digit “9”, secondary dial tone plays and you can complete the remaining two- digit number.
Page 363 Call Features dialplan.digitmap.string = 1xxT|xxxxx<T1> dialplan.digitmap.interdigit_long_timer = 10 dialplan.digitmap.interdigit_short_timer = 5 When you enter 1, it matches part of two-digit maps, the phone tries to wait 10 seconds and then dials out 1 if no numbers entered; When you enter 15, it also matches part of two-digit maps, the phone tries to wait 10 seconds and then dials out 15 if no numbers entered;...
Page 364 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones 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 phone screen will prompt “Forbidden Number” Permitted Values 2-allow users to accumulate digits and dispatch call manually with the send key or automatically dial...
Page 365: Digit Map For A Specific Line Configuration
Call Features Parameter dialplan.digitmap.apply_to.forward <y0000000000xx>.cfg It enables or disables the digit map to be applied to the numbers that you want to forward to when per- forming call forward. Description Note: It works only if “dialplan.digitmap.enable” or “account.X.dialplan.digitmap.enable” is set to 1 (Enabled).
Page 366 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Note: The string must be compatible with the digit map feature of MGCP described in 2.1.5 of RFC 3435. It works only if “account.X.dialplan.digitmap.enable” is set to 1 (Enabled). The value configured by the parameter “account.X.dialplan.digitmap.string”...
Page 367 Call Features Distribution configuration (configure a string of positive integers separated by “|” for each string of the digit map in the corresponding position) If there are more digit maps than timeout values, the last timeout is applied to the extra digit map. If there are more timeout values than digit maps, the extra timeout values are ignored.
Page 368: Emergency Dialplan And Enhanced 911
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones It enables or disables the digit map to be applied to the numbers dialed from the directory. Note: It works only if “account.X.dialplan.digitmap.enable” is set to 1 (Enabled). The value configured Description by the parameter “account.X.dialplan.digitmap.apply_to.directory_dial”...
Page 369: Emergency Dialplan And Enhanced 911 Configuration
Call Features Yealink phones support emergency dialplan and enhanced 911. Emergency Dial Plan You can configure the emergency dial plan for the phone (for example, emergency number, emergency routing). The phone determines if this is an emergency number by checking the emergency dial plan. When placing an emer- gency call, the call is directed to the configured emergency server.
Page 370 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones T53W/T53/T43U/T42U/T42S/T42G: Integer from 1 to 12; T41P/T41S/T27G: Integer from 1 to 6; Values T40P/T40G/T23P/T23G: Integer from 1 to 3; T21(P) E2: Integer from 1 to 2; T19(P) E2/CP920: 1. Default Parameter dialplan.emergency.custom_asserted_id <y0000000000xx>.cfg It configures the custom outbound identity when placing an emergency call.
Page 371 Call Features 3-DNS-NAPTR Default Parameter dialplan.emergency.X.value <y0000000000xx>.cfg It configures the emergency number to use on your phones so a caller can contact emergency ser- vices in the local area when required. Description Note: It works only if “dialplan.emergency.enable” is set to 1 (Enabled) and “dial- plan.emergency.asserted_id_source”...
Page 372 It configures the custom element value to be sent in a location request message. Example: dialplan.emergency.held.request_element.1.value = 001565B38ECB Description dialplan.emergency.held.request_element.2.value = 6f2f2d50-c385-4b72-b84a-ce0ca3a77cb7 dialplan.emergency.held.request_element.3.value = 8611@pbx.yealink.com Note: It works only if “dialplan.emergency.enable” is set to 1 (Enabled) and “dial- plan.emergency.asserted_id_source” is set to HELD. Permitted String...
Page 373: Hotline Configuration
If you lift the handset, press the Speakerphone key or the line key, and do nothing for a specified time interval, the phone will automatically dial out the hotline number. Yealink phones only support one hotline number.
Page 374: Off Hook Hot Line Dialing
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones If it is set to a value greater than 0, the phone will wait the designated seconds before dialing out the preset hotline number when you lift the handset, press the Speakerphone/off-hook key or press the line key.
Page 375: Live Dialpad
Call Features T19(P) E2/CP920 phones; handset and Speakerphone key are not applicable to CP920 phones; the off-hook key is only applicable to CP920 phones. Permitted String within 1024 characters Values Default Blank X is the account ID. For T57W/T54W/T48U/T48S/T48G/T46U/T46S/T46G/T29G, X=1-16; for T53W/T53/T43U/T42G/T42U/T42S, X=1-12;...
Page 376 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Parameter auto_redial.enable <y0000000000xx>.cfg It enables or disables the phone to automatically redial the last dialed number when the callee is tem- Description porarily unavailable. Permitted 0-Disabled 1-Enabled Values Default Web UI Features >...
Page 377: Recall Configuration
Call Features Recall Configuration Recall, also known as last call return, allows you to dial the last received call. Recall is implemented on the phones using a Recall key. The following shows configuration for a Recall key. Line Key Configuration Programmable Key Configuration linekey.X.type = 7 programablekey.X.type = 7 linekey.X.label =Recall...
Page 378: Password Dial
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Password Dial Password dial feature allows the callee number to be partly displayed on the IP phone when placing a call. The hid- den digits are displayed as asterisks on the phone screen. The number in the placed call list is also partly displayed on the IP phone.
Page 379: Call Timeout Configuration
Call Features Call Timeout Configuration Call Timeout Configuration The following table lists the parameter you can use to configure call timeout. Parameter phone_setting.ringback_timeout <y0000000000xx>.cfg It configures the duration time (in seconds) in the ringback state. Description If it is set to 180, the phone will cancel the dialing if the call is not answered after 180 seconds. Permitted Integer from 1 to 3600 Values...
Page 380: Call Number Filter
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Phone UI Menu > Features > Anonymous Call > Send Anonymous Code (Send Anony Code) Parameter account.X.anonymous_call.server_base_only <MAC>.cfg It enables or disables the phone to perform the anonymous call feature on server-side only. Description Note: You need to configure parameters “account.X.anonymous_call_oncode”...
Page 381: Ip Address Call
Call Features Parameter features.call_num_filter <y0000000000xx>.cfg It configures the characters the phone filters when dialing. If the dialed number contains configured characters, the phone will automatically filter these char- acters when dialing. Example: Description features.call_num_filter = - If you dial 3-61, the phone will filter the character - and then dial out 361. Note: If it is left blank, the phone will not automatically filter any characters when dialing.
Page 382: Ignoring Incoming Calls Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones When the phone receives an incoming call in the call state, the screen does not prompt the incoming call inform- ation. You can perform other features on the current call. You can only answer the incoming call after ending the cur- rent call.
Page 383: Auto Answer
Devices Auto Answer Yealink phones support answering a SIP call or an IP address call automatically. Auto answer is configurable on a per-line basis, while IP address call is not. By default, the phones will not automatically answer the incoming call during a call or while dialing even if the auto answer is enabled;...
Page 384 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Note: It works only if “features.direct_ip_call_enable" is set to 1 (Enabled). The phone cannot auto- matically answer the incoming IP call when the IP phone is in a call or dialing even if IP call auto answer is enabled.
Page 385 Call Features Ring1.wav, Ring2.wav, Ring3.wav, Ring4.wav, Ring5.wav, Ring6.wav, Ring7.wav, Ring8.wav, Silent.wav, Splash.wav or custom ring tone name (for example, Customring.wav) Default Supported All phones except T48G, T46G, T42G, T41P and T29G Devices Parameter features.custom_auto_answer_tone.enable <y0000000000xx>.cfg It configures the type of auto answer tone. Description Note: It works only if “features.auto_answer_tone.enable”...
Page 386: Anonymous Call Rejection
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Web UI Account > Basic > Auto Answer Mute Phone UI Menu > Features > Auto Answer > Auto Answer Mute X is the account ID. For T57W/T54W/T48U/T48S/T48G/T46U/T46S/T46G/T29G, X=1-16; for T53W/T53/T43U/T42G/T42U/T42S, X=1-12; for T41P/T41S/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21 (P) E2, X=1-2;...
Page 387: Call Waiting
You can enable call waiting feature and set the phone to play a warning tone to avoid missing important calls dur- ing a call. Yealink phones also support call waiting on code and off code to activate and deactivate server-side call waiting feature. They may vary on different servers.
Page 388: Do Not Disturb (Dnd)
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Description It enables or disables the call waiting feature. 0-Disabled, a new incoming call is automatically rejected by the phone with a busy message during a Permitted call. Values 1-Enabled, the phone screen will present a new incoming call during a call. Default Web UI Features >...
Page 389: Dnd Settings Configuration
Call Features Usually, you can activate DND when the phone is idle. The phone stays in the DND state until you deactivate DND manually. You can also temporarily activate DND during calls, the new incoming calls are rejected automatically. After ending the call, the DND is deactivated automatically.
Page 390 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones manually. Default Supported All phones except CP920 Devices Parameter features.dnd.emergency_enable <y0000000000xx>.cfg It enables or disables the phone to receive incoming calls from authorized numbers when the DND feature is enabled. Description Note: The authorized numbers are configured by the parameter “features.dnd.emergency_author- ized_number”.
Page 391: Dnd Feature Configuration
Custom: DND feature can be configured for a specific line or multiple lines. Note : DND mode is set by the parameter “features.dnd_mode”. Yealink phones also support DND on code and off code to activate and deactivate server-side DND feature. They may vary on different servers. Topics...
Page 392: Dnd In Custom Mode Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones (Phone) (except T19(P) E2/CP920 phones). Permitted String within 32 characters Values Default Blank Web UI Features > Forward&DND > DND > Off Code Phone UI Menu > Features > DND > Off Code DND in Custom Mode Configuration The following table lists the parameters you can use to configure DND in Custom mode.
Page 393: Dnd Synchronization For Server-Side Configuration
Call Features Default Blank Supported All phones except T19(P) E2 and CP920 Devices Web UI Features > Forward& DND > DND > AccountX > Off Code Phone UI Menu > Features > DND > AccountX > Off Code X is the account ID. For T57W/T54W/T48U/T48S/T48G/T46U/T46S/T46G/T29G, X=1-16; for T53W/T53/T43U/T42U/T42G/T42S, X=1-12;...
Page 394: Multiple Call Appearances
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones It enables or disables the DND feature synchronization for account X. Note: The value configured by this parameter takes precedence over that configured by the parameter Description "features.dnd.feature_key_sync.enable". It works only if “account.X.feature_key_sync.enable” is set to 1 (Enabled).
Page 395: Call Hold
Call Features Parameter phone_setting.call_appearance.calls_per_linekey <y0000000000xx>.cfg It configures the maximum number of concurrent calls per line key for all registered lines. If it is set to 0, there is no limit for the number of concurrent calls. Example: Description phone_setting.call_appearance.calls_per_linekey = 2 It means that you can have up to two concurrent calls per line key on the IP phone.
Page 396: Call Hold Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Topics Call Hold Configuration Music on Hold (MoH) Configuration Call Hold Configuration The following table lists the parameters you can use to configure call hold. Parameter sip.rfc2543_hold <y0000000000xx>.cfg Description It enables or disables the phone to use RFC 2543 (c=0.0.0.0) outgoing hold signaling. 0-Disabled, SDP media direction attributes (such as a=sendonly) per RFC 3264 is used when placing a call on hold.
Page 397 Call Features Note: It works only if “features.play_hold_tone.enable” is set to 1 (Enabled). Permitted Integer from 3 to 3600 Values Default Web UI Features > General Information > Hold Tone Interval(second) Parameter features.play_held_tone.enable <y0000000000xx>.cfg Description It enables or disables the phone to play the call held tone when a call is held by the other party. Permitted 0-Disabled 1-Enabled...
Page 398: Music On Hold (Moh) Configuration
(P) E2, X=1-2; for T19(P) E2/CP920, X=1. Call Mute You can mute the microphone of the active audio device (handset, headset or speakerphone) on Yealink phones during an active call or when the phone is on the pre-dialing/dialing/calling/ringing screen. The call is automatically muted when setting up successfully.
Page 399: Keep Mute
Call Features Parameter features.allow_mute <y0000000000xx>.cfg It enables or disables the allow mute feature for the IP phone. Description Note: For T23P/T23G/T21(P) E2 phones, you are allowed to activate the mute feature on the pre-dial- ing/dialing/calling/ringing screen only if “features.keep_mute.enable” is set to 1 (Enabled). 0-Disabled Permitted 1-Enabled, you are allowed to mute an active call or activate the mute feature on the pre-dial-...
Page 400: Call Forward
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Parameter features.play_mute_tone.enable <y0000000000xx>.cfg Description It enables or disables the phone to play an audible tone when the mute status is changed. 0-Disabled Permitted Values 1-Enabled Default Supported CP920 Devices Parameter features.play_mute_tone.interval <y0000000000xx>.cfg It configures time interval (in seconds) for playing an audible tone when the phone is in the mute state Description...
Page 401 Call Features Default Parameter features.fwd_mode <y0000000000xx>.cfg It configures the call forward mode. Description Note: It works only if “features.fwd.allow” is set to 1 (Enabled). 0-Phone, call forward feature is effective on a phone basis. Permitted Values 1-Custom, you can configure call forward feature on a per-line basis. Default Supported All phones except T19(P) E2 and CP920...
Page 402: Call Forward Feature Configuration
Custom: Call forward feature can be configured for a specific line or multiple lines. Note: Forward mode is set by the parameter “features.fwd_mode”. Yealink phones also support call forward on code and off code to activate and deactivate server-side call forward feature. They may vary on different servers.
Page 403 Call Features Default Web UI Features > Forward&DND > Forward > Always Forward > On/Off Phone UI Menu > Features > Call Forward > Always Forward > Always Forward Parameter forward.always.target <y0000000000xx>.cfg It configures the destination number of the always forward on a phone basis. Description Note: It works only if “features.fwd.allow”...
Page 404 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones 1-On, incoming calls are forwarded to the destination number (configured by the parameter “for- Values ward.busy.target”) when the callee is busy. Default Web UI Features > Forward&DND > Forward > Busy Forward > On/Off Phone UI Menu >...
Page 405 Call Features (Phone) (except T19(P) E2/CP920 phones). DND activated on the IP phone deactivates the local No Answer Forward settings. 0-Off Permitted 1-On, incoming calls are forwarded to the destination number (configured by the parameter “for- Values ward.no_answer.target”) after a period of ring time. Default Web UI Features >...
Page 406: Call Forward In Custom Mode Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones (Enabled). Permitted Integer greater than or equal to 0 Values Default Parameter forward.no_answer.on_code <y0000000000xx>.cfg It configures the no answer forward on code to activate the server-side no answer forward feature. The phone will send the no answer forward on code and the pre-configured destination number (con- figured by the parameter “forward.no_answer.target”) to the server when you activate the no answer Description forward feature on a phone basis.
Page 407 Call Features Web UI Features > Forward&DND > Forward > AccountX > Always Forward > On/Off Phone UI Menu > Features > Call Forward > AccountX > Always Forward > Always Forward Parameter account.X.always_fwd.target <MAC>.cfg It configures the destination number of the always forward. Description Note: It works only if “features.fwd.allow”...
Page 408 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Description It triggers the busy forward feature to on or off. 0-Off Permitted 1-On, incoming calls to the account X are forwarded to the destination number (configured by the para- Values meter “account.X.busy_fwd.target”) when the callee is busy.
Page 409 Call Features Values Default Blank Supported All phones except T19(P) E2 and CP920 Devices Web UI Features > Forward&DND > Forward > AccountX > Busy Forward > Off Code Phone UI Menu > Features > Call Forward > AccountX > Busy Forward > Off Code Parameter account.X.timeout_fwd.enable <MAC>.cfg It triggers no answer forward feature to on or off.
Page 410: Call Forward Synchronization For Server-Side Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Web UI Features > Forward&DND > Forward > AccountX > No Answer Forward > After Ring Time(0~120s) Phone UI Menu > Features > Call Forward > AccountX > No Answer Forward > After Ring Time Parameter account.X.timeout_fwd.on_code <MAC>.cfg It configures the no answer forward on code to activate the server-side no answer forward feature.
Page 411 Call Features Description It enables or disables to synchronize the feature status between the IP phone and the server. 0-Disabled Permitted Values 1-Enabled, the phone sends a SUBSCRIBE message with event “as-feature-event” to the server. Default Parameter account.X.feature_key_sync.enable <y0000000000xx>.cfg It enables or disables to synchronize the feature status between the IP phone and the server for account X.
Page 412: Call Transfer
B, party A can transfer this call to party C (the third party). Then, party B will begin a new call with party C, and party A will disconnect. Yealink phones support call transfer using the REFER method specified in RFC 3515...
Page 413: Transfer Mode For Dsskey Configuration
Call Features It enables or disables the Refer-To header to use the information of the Contact header in the second Description 200 OK message when attended transfer. Permitted 0-Disabled 1-Enabled Values Default features.transfer_keep_session2_after_failed.en- Parameter <y0000000000xx>.cfg able It enables or disables the phone to keep the original call status after semi-attended/attended transfer Description is rejected by the server.
Page 414: Conference
(P) E2, X=1-2; for T19(P) E2/CP920, X=1. Local Conference Configuration The local conference requires a host phone to process the audio of all parties. Yealink phones support up to 3 parties (5 parties for CP920/T42U/T43U/T53/T53W phones, 10 partes for T46U/T48U/T54W/T57W) (including your- self) in a local conference call.
Page 415: Network Conference Configuration
Call Features Parameter features.conference.local.enable <y0000000000xx>.cfg It enables or disables the local conference feature for the IP phone. Description Note: It works only when “account.X.conf_type” is set to 0 (Local Conference). 0-Disabled Permitted Values 1-Enabled Default Parameter features.conference.with_previous_call.enable <y0000000000xx>.cfg It enables or disables the phone to merge two calls into a conference directly by pressing the con- Description ference key when there are two calls on the phone.
Page 416: Usb Recording
(P) E2, X=1-2; for T19(P) E2/CP920, X=1. USB Recording Yealink phones support manual recording during a call or automatic recording once the call is set up. Yealink CP920 phones support recording when the phone is idle, helping users record an important discussion in the local conference room.
Page 417: Multicast Paging
Yealink phones support the following 31 channels: 0: Broadcasts are sent to channel 0. Note that the Yealink phones running firmware version 80 or earlier can be regarded as listening to channel 0. It is the default channel.
Page 418: Multicast Paging Group Configuration
Multicast Paging Group Configuration Yealink phones support up to 31 groups for paging. You can assign multicast IP address with a channel for each group, and specify a label to each group to identify the phones in the group, such as All, Sales, or HR.
Page 419: Multicast Listening Group Configuration
Multicast Listening Group Configuration Yealink phones support up to 31 groups for listening. You can assign multicast IP address with a channel for each group, and specify a label to each group to identify the phones in the group, such as All, Sales, or HR.
Page 420: Multicast Paging Settings Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Paging Barge You can set your phone whether an incoming paging call interrupts an active call. The Paging Barge defines the lowest priority of the paging group from which the phone can receive a paging call when there is a voice call (a normal phone call rather than a multicast paging call) in progress.
Page 421 Call Features Parameter multicast.receive_priority.priority <y0000000000xx>.cfg It configures the priority of the voice call (a normal phone call rather than a multicast paging call) in progress. Description 1 is the highest priority, 31 is the lowest priority. 0-Disabled, all incoming multicast paging calls will be automatically ignored when a voice call is in progress.
Page 422 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Values Default Parameter multicast.receive.enhance_volume <y0000000000xx>.cfg It enables or disables the volume enhancement feature when receiving the multicast paging calls. Note: It works only if “multicast.listen_address.X.volume" is not set to 0. If the value the parameter "mul- Description ticast.listen_address.X.volume"...
Page 423: Advanced Features
Call Pickup You can use call pickup to answer someone else’s incoming call on your phone. The Yealink phones support Directed Call Pickup and Group Call Pickup: Directed Call Pickup: allows you to pick up incoming calls to a specific phone.
Page 424 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones You can configure a directed call pickup code and pick up the incoming call using the DPickup soft key. : You can set a DSS key as a Directed Pickup key, and specify a contact you want to pick up a call from for this key. For DSS Keys more information, refer to The following table lists the parameters you can use to configure directed call pickup.
Page 425: Group Call Pickup
Advanced Features Group Call Pickup Group call pickup is used for picking up incoming calls within a predefined group. When any phone within a pre- defined group of phones receives an incoming call, you can pick up that call easily on the phone. If you enable group call pickup, the phone screen will display a GPickup soft key when picking up the handset, pressing the Speakerphone key or pressing the line key.
Page 426: Dialog Info Call Pickup
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Permitted String within 32 characters Values Default Blank Web UI Account > Advanced > Group Call Pickup Code X is the account ID. For T57W/T54W/T48U/T48S/T48G/T46U/T46S/T46G/T29G, X=1-16; for T53W/T53/T43U/T42G/T42U/T42S, X=1-12; for T41P/T41S/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21 (P) E2, X=1-2;...
Page 427: Dialog Info Call Pickup Configuration
Callee does not answer Callee actively rejects the incoming call before answering Yealink phones support call completion using the SUBSCRIBE/NOTIFY method, which is specified in draft-poetzl- sipping-call-completion-00, to subscribe to the busy party and receive notifications of their status changes.
Page 428 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...
Page 429 Via: SIP/2.0/UDP 10.10.20.31:5060;branch=z9hG4bK3431394016 From: <sip:1000@10.2.1.48:5060>;tag=1558968605 To: "10111" <sip:10111@10.2.1.48:5060>;tag=140677866 Call-ID: 0_2584152566@10.10.20.32 CSeq: 5 NOTIFY Contact: <sip:1000@10.10.20.31:5060> Content-Type: application/dialog-info+xml Max-Forwards: 70 User-Agent: Yealink SIP-T46G 28.82.0.20 Subscription-State: active;expires=48 Event: dialog Content-Length: 217 <?xml version="1.0"?> <dialog-info xmlns="urn:ietf:params:xml:ns:dialog-info" version="4" state="partial" entity- y="sip:1000@10.2.1.48:5060"> <dialog id="65644"> <state>terminated</state>...
Page 430: Call Completion Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Topics Call Completion Configuration Example: Using Call Completion Call Completion Configuration The following table lists the parameters you can use to configure the call completion feature. Parameter features.call_completion_enable <y0000000000xx>.cfg Description It enables or disables the call completion feature. 0-Disabled Permitted Values...
Page 431 Advanced Features Description It configures the call park mode. 1-FAC, park a call through dialing the call park code. Permitted Values 2-Transfer, blind transfer the call to a shared parking lot. Default Web UI Features > Pick up & Park > Call Park Mode Parameter features.call_park.enable <y0000000000xx>.cfg Description It enables or disables the call park feature.
Page 432: Example: Setting Call Park And Retrieve In Fac Mode
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones 0-Disabled, the call is parked by the current line, which is in call state. Permitted Values 1-Enabled Default Supported All phones except T19(P) E2 Devices Parameter features.call_park.performby_holdhardkey.enable <y0000000000xx>.cfg Description It enables or disables the phone to park a call using the HOLD hard key. 0-Disabled Permitted Values...
Page 433: Automatic Call Distribution (Acd)
Advanced Features features.call_park.park_retrieve_code = *11 After provisioning, the call park mode is set to Transfer. A Park soft key will display on the phone during an active call and a Retrieve soft key will display on the Dialing screen. You can press the Park soft key to park a call to the shared parking lot “*01”, or press the Retrieve soft key to retrieve the parked call from the shared parking lot “*01”...
Page 434 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Permitted 0-Disabled 1-Enabled Values Default Parameter account.X.subscribe_acd_expires <MAC>.cfg It configures the period (in seconds) of ACD subscription. Description Note: It works only if “account.X.acd.enable” is set to 1 (Enabled). Permitted Integer from 120 to 3600 Values Default 3600...
Page 435: Example: Setting Acd
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/CP920 IP phone. Yealink phones support two methods of BLF configuration: Configure a line key as BLF key to monitor a specific remote line...
Page 436: Blf Key Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones 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 Call Information Display Configuration BLF Key Configuration You can configure a BLF key for a specific line.
Page 437 Advanced Features Description It configures the feature access code of directed call pickup with barge-in for account X. Permitted String within 32 characters Values Default Blank Supported All phones except T19(P) E2 and CP920 Devices Web UI Account > Advanced > BLF List Barge in Code Parameter account.X.blf_list_call_parked_code <MAC>.cfg Description It configures the feature access code of call park for account X.
Page 438: State Indicator Of Remote Line
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Default Blank Supported All phones except T19(P) E2 and CP920 Devices Web UI Account > Advanced > BLF List Retrieve Call Parked Code Parameter phone_setting.auto_blf_list_enable <y0000000000xx>.cfg Description It enables or disables the phone to automatically configure the BLF list DSS keys in order. Permitted 0-Disabled 1-Enabled...
Page 439: Blf/Blf List Subscription
The monitored line fails to register or does not exist. BLF/BLF List Subscription Yealink phones support BLF using a SUBSCRIBE/NOTIFY mechanism as specified in 3265. BLF Subscription When you configure the IP phone to monitor a specific line, the phone sends a SUBSCRIBE request with Request- URI containing the monitor line URI to the server, and then receives a NOTIFY request.
Page 440: Blf/Blf List Subscription Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones <resource uri="sip:4605@pbx.yealink.com"> <name > 4607 Yealink</name> <instance id="pXHQ97tPyQ" state="active" cid="tYzwJM@broadworks"/> </resource> </list> Topic BLF/BLF List Subscription Configuration BLF/BLF List Subscription Configuration The following table lists the parameters you can use to configure BLF/BLF List subscription.
Page 441 Advanced Features Default Supported All phones except T19(P) E2 and CP920 Devices Parameter sip.terminate_notify_sub_delay_time <y0000000000xx>.cfg It configures the interval (in seconds) for the phone to re-subscribe when it receives the NOTIFY mes- sage with the subscription state of Terminated. Description If it is set to 0, the phone will re-subscribe immediately.
Page 442: Visual And Audio Alert For Monitor Lines
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Devices linekey.X.type/expansion_module.X.key.Y.type Related linekey.X.extension/expansion_module.X.key.Y.extension Parameters linekey.X.value/expansion_module.X.key.Y.value X is the account ID. For T57W/T54W/T48U/T48S/T48G/T46U/T46S/T46G/T29G, X=1-16; for T53W/T53/T43U/T42U/T42G/T42S, X=1-12; for T41P/T41S/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 443 Advanced Features ListX Default Supported All phones except T48G, T46G, T42G, T41P, T29G, T19(P) E2 and CP920 Devices Parameter features.pickup.blf_audio_enable <y0000000000xx>.cfg It enables or disables the phone to play an audio alert when the monitored user receives an incoming Description call.
Page 444: Example: Configuring Visual And Audio Alert For Monitor Lines
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Web UI Features > Pickup & Park > Ring Type for BLF Pickup Color Screen Phones: Menu > Basic > Sound > BLF Ring Type Phone UI Black-and-white Screen Phones: Menu > Settings > Basic Settings > Sound > BLF Ring Type Parameter features.pickup_display.method <y0000000000xx>.cfg It configures the display method of the call party information on the visual prompt.
Page 445: Led Mode For Blf/Blf List Key
Advanced Features Example features.pickup.blf_visual_enable = 1 features.pickup.blf_audio_enable = 1 When the monitored line receives an incoming call, the phone screen shows an incoming call to the monitored line (for example, “6001<-6002”, 6001 is the monitored extension which receives an incoming call from 6002) (from 1008 to 1001), the following occurs on the phone: The phone plays a specific alert tone.
Page 446 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones LED Status Description The monitored user does not exist. Line Key/Expansion Module Key LED (configured as a BLF key or a BLF List key and BLF LED Mode is set to 1) LED Status Description Fast-flashing red...
Page 447: Blf Led Mode Configuration
Advanced Features LED Status Description Solid green The monitored user is talking. Slowly-flashing green (1s) The monitored user does not exist. The monitored user is idle. BLF LED Mode Configuration The following table lists the parameters you can use to configure BLF LED Mode. Parameter features.blf_led_mode <y0000000000xx>.cfg Description It configures the BLF LED mode.
Page 448: Blf Key Led/Icon And Behavior For Idle State Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Related Topic Macro Action Strings BLF Key LED/Icon and Behavior for Idle State Configuration The following table lists the parameters you can use to configure BLF key LED/icon and Behavior for the idle state (the monitored user is idle).
Page 449: Blf Key Led/Icon And Behavior For Call-In State Configuration
Advanced Features Values Default Blank Supported All phones except T19(P) E2 and CP920 Devices Parameter blf.enhanced.idle.idle.action <y0000000000xx>.cfg It configures the behavior when pressing the BLF/BLF list DSS key if the monitor and monitored user are idle. Description Note: It works only if “blf.enhanced.idle.enable” is set to 1 (Enabled). Permitted String Values...
Page 450: Blf Key Led/Icon And Behavior For Call-Out State Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones are ringing. Note: It works only if “blf.enhanced.callin.enable” is set to 1 (Enabled). Permitted String Values Default Blank Supported All phones except T19(P) E2 and CP920 Devices Parameter blf.enhanced.callin.talking.action <y0000000000xx>.cfg It configures the behavior when pressing the BLF/BLF list DSS key if the monitor is talking and mon- itored user is ringing.
Page 451: Blf Key Led/Icon And Behavior For Talking State Configuration
Advanced Features For T57W/T48U/T48S/T48G phones, the BLF/BLF List DSS key field displays a green icon for 1000ms and then turns to white. For other phones, the BLF/BLF list DSS key LED glows green for 1000ms and then goes out. Note: It works only if “blf.enhanced.callout.enable” is set to 1 (Enabled). Permitted String Values...
Page 452 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones 1-Enabled, the phone will display the custom BLF/BLF List DSS key LED status/icon colors and per- form the custom behavior when pressing the BLF/BLF List DSS key. Default Supported All phones except T19(P) E2 and CP920 Devices Parameter blf.enhanced.talking.led <y0000000000xx>.cfg...
Page 453: Blf Key Led/Icon And Behavior For Parked-Against State Configuration
Advanced Features Values Default Blank Supported All phones except T19(P) E2 and CP920 Devices BLF Key LED/Icon and Behavior for Parked-Against State Configuration The following table lists the parameters you can use to configure BLF key LED/icon and Behavior for the parked- against state (a call is being parked against the monitored phone).
Page 454: Blf Key Led/Icon And Behavior For Hold State Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones parked against the monitored phone. 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). Permitted String Values...
Page 455: Blf Key Led/Icon And Behavior For Dnd State Configuration
Advanced Features For other phones, the BLF/BLF list DSS key LED glows green for 1000ms and then goes out. Note: It works only if “blf.enhanced.hold.enable” is set to 1 (Enabled). Permitted String Values Default Blank Supported All phones except T48G, T46G, T42G, T41P, T29G, T19(P) E2 and CP920 Devices BLF Key LED/Icon and Behavior for DND State Configuration The following table lists the parameters you can use to configure BLF key LED/icon and Behavior for DND state...
Page 456: Call Information Display Configuration
Devices Shared Line Yealink 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.
Page 457: Shared Call Appearance (Sca) Configuration
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 phones support SCA using a SUBSCRIBE/NOTIFY mechanism as specified in 3265. The events used are: “call-info”...
Page 458: Sca Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones SCA Configuration The following table lists the parameters you can use to configure SCA. Parameter account.X.shared_line <MAC>.cfg Description It configures the registration line type. 0-Disabled Permitted Values 1-Shared Call Appearance Default Web UI Account >...
Page 459: Bridge Lines Appearance (Bla)
IP phone. To use this feature, a BLA group should be pre-configured on the server and one of them is specified as a BLA number. Yealink phones support BLA using a SUBSCRIBE/NOTIFY mechanism as specified in 3265. The event used is: “dialog”...
Page 460: Intercom
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones the value of this parameter to 0 (Disabled). 0-Disabled Permitted Values 1-Enabled Default Supported All phones except T19(P) E2 Devices Parameter account.X.bla.subscribe_uri_build_type <MAC>.cfg It configures the constitution of the URI for BLA subscription. Description Note: It works only if “account.X.shared_line”...
Page 461: Intercom Key Configuration
Advanced Features Topics Intercom Key Configuration 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 con- tact.
Page 462: State Monitor For Intercom Contact Configuration
Supported All phones except T19(P) E2 and CP920 Devices Outgoing Intercom Configuration Yealink phones support two methods for initialing intercom calls. The following table lists the parameters you can use to configure outgoing intercom. Parameter features.intercom.mode <y0000000000xx>.cfg Description It configures the intercom mode.
Page 463: Incoming Intercom Configuration
Advanced Features It configures the value of the Call-Info header for intercom feature. The value format likes: <sip:XXX (X can be any value)>; answer-after=0. Description Note: If both Call-Info header and Alert-Info header (defined by the parameter "account.X.alert_info") are configured, the Call-Info header has a higher priority than the Alert-Info header. Permitted String within 256 characters Values...
Page 464: Csta Control
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones It enables or disables the phone to answer an incoming intercom call while there is already an active call on the IP phone. Description Note: It works only if “features.intercom.allow” and "call_waiting.enable" are set to 1 (Enabled) and “phone_setting.call_appearance.calls_per_linekey”...
Page 465: Csta Control Configuration
Advanced Features The uaCSTA feature on the phone may be used for remote control of the phone from computer applications such as PC softphone. You can use the application to control the phone to perform basic call operations. For example, place a call, answer a call, end a call and transfer a call to another party.
Page 466 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Event Description Register Failed When the IP phone fails to register an account. Off Hook When the IP phone is off hook. On Hook When the IP phone is on hook. Incoming Call When the IP phone receives an incoming call.
Page 467: Variable Values List
Advanced Features Event Description Attended Transfer When the IP phone performs the semi-attended/attended transfer. Hold When the IP phone places a call on hold. UnHold When the IP phone resumes a held call. Held When a call of the IP phone is held. UnHeld When a held call is resumed.
Page 468 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Variable Value Description $mac The MAC address of the IP phone. The IP address of the IP phone. $model The IP phone model. $firmware The firmware version of the IP phone. The SIP URI of the current account when the IP phone places a call, receives an incoming $active_url call or establishes a call.
Page 469: Action Url Configuration
Advanced Features Variable Value Description http://10.82.21.10/Upload/?Cfg=$cfg_local Action URL Configuration The following table lists the parameters you can use to configure the action URL. Parameter action_url.setup_completed <y0000000000xx>.cfg It configures the action URL the phone sends after startup. Description Example: action_url.setup_completed = http://192.168.0.20/help.xml?IP=$ip Permitted URL within 511 characters Values...
Page 470 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Parameter action_url.off_hook <y0000000000xx>.cfg It configures the action URL the phone sends when off hook. Description Example: action_url.off_hook = http://192.168.0.20/help.xml?IP=$ip Permitted URL within 511 characters Values Default Blank Web UI Features > Action URL > Off Hook Parameter action_url.on_hook <y0000000000xx>.cfg It configures the action URL the phone sends when on hook.
Page 471 Advanced Features Default Blank Web UI Features > Action URL > Established Parameter action_url.dnd_on <y0000000000xx>.cfg It configures the action URL the phone sends when DND feature is activated. Description Example: action_url.dnd_on = http://192.168.0.20/help.xml?IP=$ip Permitted URL within 511 characters Values Default Blank Web UI Features >...
Page 472 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Permitted URL within 511 characters Values Default Blank Web UI Features > Action URL > Busy Forward On Parameter action_url.busy_fwd_off <y0000000000xx>.cfg It configures the action URL the phone sends when the busy forward feature is deactivated. Description Example: action_url.busy_fwd_off = http://192.168.0.20/help.xml?IP=$ip...
Page 473 Advanced Features Example: action_url.blind_transfer_call = http://192.168.0.20/help.xml?IP=$ip Permitted URL within 511 characters Values Default Blank Web UI Features > Action URL > Blind Transfer Parameter action_url.attended_transfer_call <y0000000000xx>.cfg It configures the action URL the 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 Permitted...
Page 474 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Example: action_url.unheld = http://192.168.0.20/help.xml?IP=$ip Permitted URL within 511 characters Values Default Blank Parameter action_url.mute <y0000000000xx>.cfg It configures the action URL the phone sends when muting a call. Description Example: action_url.mute = http://192.168.0.20/help.xml?IP=$ip Permitted URL within 511 characters Values...
Page 475 Advanced Features idle. Example: action_url.busy_to_idle = http://192.168.0.20/help.xml?IP=$ip Permitted URL within 511 characters Values Default Blank Web UI Features > Action URL > Busy to Idle Parameter action_url.idle_to_busy <y0000000000xx>.cfg It configures the action URL the phone sends when changing the state of the phone from idle to busy. Description Example: action_url.idle_to_busy = http://192.168.0.20/help.xml?IP=$ip...
Page 476 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Web UI Features > Action URL > Reject Incoming Call Parameter action_url.answer_new_incoming_call <y0000000000xx>.cfg It configures the action URL the 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 Permitted URL within 511 characters Values...
Page 477 Advanced Features Values Default Blank Web UI Features > Action URL > Call Waiting On Parameter action_url.call_waiting_off <y0000000000xx>.cfg It configures the action URL the phone sends when the call waiting feature is disabled. Description Example: action_url.call_waiting_off = http://192.168.0.20/help.xml?IP=$ip Permitted URL within 511 characters Values Default Blank...
Page 478 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Web UI Features > Action URL > Cancel Call Out Parameter action_url.remote_busy <y0000000000xx>.cfg It configures the action URL the phone sends when the outgoing call is rejected. Description Example: action_url.remote_busy = http://192.168.0.20/help.xml?IP=$ip Permitted URL within 511 characters Values...
Page 479: Action Uri
Advanced Features Action URI Yealink phones can perform the specified action by receiving and handling an HTTP or HTTPS GET request or accept a SIP NOTIFY message with the “Event: ACTION-URI” header from a SIP proxy server. Topics Supported HTTP/HTTPS GET Request...
Page 480: Variable Values List
Variable Values List Yealink phones also support a combination of the variable values in the URI, but the order of the variable value is determined by the operation of the phone. The valid URI format is: http(s)://<phoneIPAddress>/servlet?key=variable value[;variable value]. Variable values are separated by a semicolon from each other. This method is not applicable to T57W/T48U/T48S/T48G phones.
Page 481 Advanced Features Variable Value Phone Action Cancel/CANCEL Cancel actions, reject incoming calls or end a call. Cancel actions, reject incoming calls or mute or un-mute calls. (not applicable to T57W phones) 0-9/*/POUND Press the keypad (0-9, * or #). Press the line keys (for T57W/T48U/T48S/T48G, X=29; for T54W/T46U/T46S/T46G/T29G, X=27;...
Page 482 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Variable Value Phone Action A and D are in a call, the call is active; B and D are in a call, the call is placed on hold; C and D are in a call, the call is placed on hold; callid_A: 32775 callid_B: 32776 Example:...
Page 483: Action Uri Configuration
(n is the times of 6, for example, 24). It is only applicable to no answer forward feature. Note: For Yealink phones, it works only if “features.fwd.allow” is set swFwdOn=xxx=n to 1 (Enabled) and call forward mode is Phone, the always/busy/no answer forward feature will apply to all the accounts on the phone.
Page 484: Example: Capturing The Current Screen Of The Phone
Note : Yealink phones also support capturing the screen display using the old URI “http://<- phoneIPAddress>/servlet?command=screenshot”. Before capturing the phone’s current screen, ensure that the IP address of the computer is included in the trusted IP address for Action URI on the phone.
Page 485: Example: Placing A Call Via Web User Interface
Else, the browser will display an image of the phone’s current screen directly. You can save the image to your local system. Note : Frequent capture may affect phone performance. Yealink recommends you to capture the phone screen display within a minimum interval of 4 seconds. Example: Placing a Call via Web User Interface Procedure 1.
Page 486: Voice Mail
Yealink phones support voice mail. You can configure a message waiting indicator (MWI) to inform users how many messages are waiting in their mail- box without calling the mailbox. Yealink phones support both audio and visual MWI alert when receiving new voice messages.
Page 487 Advanced Features Values 1-Enabled Default Parameter account.X.sub_fail_retry_interval <MAC>.cfg Description It configures the interval (in seconds) for the phone to retry to re-subscribe when subscription fails. Permitted Integer from 0 to 3600 Values Default Parameter account.X.subscribe_mwi_to_vm <MAC>.cfg It enables or disables the phone to subscribe to the message waiting indicator for the voice mail num- ber.
Page 488: Short Message Service (Sms)
(P) E2, X=1-2; for T19(P) E2/CP920, X=1. Short Message Service (SMS) Yealink phones (except CP920 phones) support short message service (SMS). It allows users to send and receive a text message on the support server. By default, SMS is enabled. You can use SMS at the path: Menu > Message > Text Message. You can also disable SMS.
Page 489 Advanced Features Parameter push_xml.server <y0000000000xx>.cfg Description It configures the address of the push XML server. Blank-The phone will reject HTTP POST messages from any server. any-The phone will accept HTTP POST messages from any server. Permitted Values IP address or domain name-Multiple addresses are separated by commas. (for example, 10.1.4.3,10.1.4.23);...
Page 490: Hot Desking
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Parameter features.xml_browser.user_name <y0000000000xx>.cfg Description It configures the authentication user name for the XML request. Permitted String within 15 characters Values Default Blank Parameter features.xml_browser.pwd <y0000000000xx>.cfg Description It configures the authentication password for the XML request. Permitted String within 15 characters Values...
Page 491: Hot Desking Key Configuration
Advanced Features 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 492 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones when pressing the Hot Desking DSS key. 0-Disabled Permitted Values 1-Enabled Default Supported All phones except CP920 Devices Parameter hotdesking.dsskey_outbound_enable <y0000000000xx>.cfg It enables or disables the phone to provide an input field of the outbound server on the hot desking Description login wizard when pressing the Hot Desking DSS key.
Page 493: General Features
Cloud Line Identification Presentation Yealink phones can derive calling and connected line identification from SIP headers and display the name asso- ciated with the telephone number on the LCD screen. Calling Line Identification Presentation (CLIP): It allows the phones to display the caller identity, derived from a SIP header contained in the INVITE message when receiving an incoming call.
Page 494 <y0000000000xx>.cfg It configures the priority order for the sources of caller identity information. Note: Yealink phones can derive caller identity from the following SIP headers: From, P-Asserted-Iden- Description tity (PAI), P-Preferred-Identity and Remote-Party-ID (RPID). It works only if “account.X.cid_source” is set to 6 (PREFERENCE).
Page 495: Return Code For Refused Call
General Features X is the account ID. For T57W/T54W/T48U/T48S/T48G/T46U/T46S/T46G/T29G, X=1-16; for T53W/T53/T43U/T42G/T42U/T42S, X=1-12; for T41P/T41S/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21 (P) E2, X=1-2; for T19(P) E2/CP920, X=1. Return Code for Refused Call You can define the return code and reason of the SIP response message for the refused call. The caller’s phone LCD screen displays the reason according to the received return code.
Page 496: Hide Feature Access Codes
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones It configures a return code and reason of SIP response messages when the phone does not answer Description an incoming call. A specific reason is displayed on the caller’s phone screen. 404-Not Found 480-Temporarily Unavailable (Temporarily not available) Permitted...
Page 497: Accept Sip Trust Server Only
CSeq: 2 INVITE Contact: <sip:1025@10.3.6.197:5060 > Authorization: Digest username="1025", realm="pbx.test.com", nonce="BroadWorksXi5stub71Ts2nb05BW", uri- i="sip:1024@pbx.test.com:5060", response="f7e9d35c55af45b3f89beae95e913171", algorithm=MD5, cnon- ce="0a4f113b", qop=auth, nc=00000001 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...
Page 498: 100 Reliable Retransmission Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Supported: 100rel Allow-Events: talk,hold,conference,refer,check-sync Content-Length: 302 Topic 100 Reliable Retransmission Configuration 100 Reliable Retransmission Configuration The following table lists the parameter you can use to configure the 100 reliable retransmission. Parameter account.X.100rel_enable <MAC>.cfg Description It enables or disables the 100 reliable retransmission feature.
Page 499: Session Timer
UAC performs the refresh. Example of UPDATE message (UAC mode): UPDATE sip:1058@10.10.20.34:5060 SIP/2.0 Via: SIP/2.0/UDP 10.10.20.32:5060;branch=z9hG4bK2104991394 From: "10111" <sip:10111@10.2.1.48:5060 > ;tag=2170397024 To: <sip:1058@10.2.1.48:5060 > ;tag=200382096 Call-ID: 4_1556494084@10.10.20.32 CSeq: 2 UPDATE Contact: <sip:10111@10.10.20.32:5060 > Max-Forwards: 70 User-Agent: Yealink SIP-T46G 28.82.0.20 Session-Expires: 90;refresher=uac...
Page 500: Session Timer Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Supported: timer Content-Length: 0 Topic Session Timer Configuration Session Timer Configuration The following table lists the parameters you can use to configure the session timer. Parameter account.X.session_timer.enable <MAC>.cfg Description It enables or disables the session timer. 0-Disabled Permitted Values...
Page 501: Reboot In Talking Configuration
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: 300 Topic Reserve # in User Name Configuration Reserve # in User Name Configuration The following table lists the parameter you can use to configure the reserve # in user name.
Page 502: Busy Tone Delay
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Default Web UI Features > General Information > Reserve # in User Name Busy Tone Delay The busy tone is an audible signal to indicate that the call is released by the other party. You can define the amount of time that the busy tone lasts.
Page 503: Media Loopback
General Features After configuration, you can check the configuration file version information at the path: Menu > Status > Phone > MAC Version (phone user interface) or Status > Status > Version > MAC Version (web user interface). Permitted String Values Default Blank...
Page 504: Cloud
Values Default Cloud Yealink CP920 phones support cloud feature. The Cloud enterprise administrator uses the Yealink VC Cloud man- agement service to assign each user an individual Cloud account. For more information, refer to Yealink VC Cloud Management Service Administrator Guide After registered with a Yealink Cloud account successfully, the phone will download the Cloud accounts information from the server automatically.
Page 505: Cloud Configuration
General Features Topic Cloud Configuration Cloud Configuration The following table lists the parameters you can use to configure the Cloud. Parameter vcaccount.enable <y0000000000xx>.cfg Description It enables or disables the Cloud feature. 0-Disabled Permitted Values 1-Enabled Default Supported CP920 Devices Web UI Features >...
Page 506: Configuration Parameters
Configuration Parameters Configuration Parameters This section provides a description and permitted values of some settings. Topics BroadSoft Parameters Start2Start ACD Parameters Ethernet Interface MTU Parameters SIP Settings Parameters Call Settings Parameters BroadSoft Parameters This section shows the parameters you can use to configure the phone with BroadSoft server. For more information on BSFT, refer to Yealink_IP_Phone_Features_Integrated_with_BroadSoft_UC-One_User_ Guide...
Page 507: Broadsoft Uc
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Default Supported All color screen phones Devices If you change this parameter, the phone will reboot to make the change take effect. Broadsoft UC Parameter bw.xmpp.enable <y0000000000xx>.cfg It enables or disables the UC feature. Description Note: It works only if “bw.enable"...
Page 508 Configuration Parameters your presence status manually on the IP phone. Permitted 0-Disabled Values 1-Enabled Default Supported All color screen phones Devices Parameter bw.xmpp.change_presence.enable <y0000000000xx>.cfg It enables or disables the phone to change the user’s current presence state locally. Description Note: It works only if “bw.xmpp.enable" is set to 1 (Enabled). Permitted 0-Disabled Values...
Page 509 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones The phone displays the keys with left-to-right order. For example, “favorite,uc_favorite,blf_list” means the display order is Favorite keys > UC Favorite keys > BLF List keys. If only one type is configured, the configured type will have the highest priority. For example, “blf_list” means the IP phone preferentially display the BLF List keys, and remaining keys’...
Page 510: Broadsoft Xsi
Configuration Parameters Permitted 0-Disabled Values 1-Enabled Default Supported All color screen phones Devices Parameter directory_setting.bw_uc_buddies.priority <y0000000000xx>.cfg Description It configures the display priority of the BroadSoft Buddies directory. Permitted Integer greater than or equal to 0 Values Default Supported All color screen phones Devices If you change this parameter, the phone will reboot to make the change take effect.
Page 511 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones http-HTTP Permitted Values https-HTTPS Default http Web UI Applications > Broadsoft XSI > XSI Account > XSI Server Type Parameter account.X.xsi.port <MAC>.cfg It configures the port of the Xtended Services Platform server. Description Note: It works only if “bw.xsi.enable"...
Page 512: Broadsoft Acd
Configuration Parameters word of the SIP account for XSI authentication. Default Web UI Applications > Broadsoft XSI > XSI Account > Allow SIP Authentication for XSI Parameter default_input_method.xsi_password <y0000000000xx>.cfg It configures the default input method when the XSI authentication is failed and the user re-enters the Description password.
Page 513 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Values Default Blank Parameter account.X.call_center.call_info_enable <MAC>.cfg Description It enables or disables the call center call information feature. Permitted 0-Disabled 1-Enabled Values Default Parameter account.X.call_center.show_call_info_time <MAC>.cfg It configures the interval (in seconds) to specify how long the call center call information displays. Description Note: It works only if "account.X.call_center.call_info_enable"...
Page 514 Configuration Parameters reached the maximum number of calls or have waited too long. 0-Disabled (power LED indicator does not flash) Permitted Values 1-Enabled (power LED indicator fast flashes (300ms) red) Default Parameter features.homescreen_softkey.acd.enable <y0000000000xx>.cfg It enables or disables the phone to display the ACD soft keys such as Login or Logout on the idle screen.
Page 515 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Permitted String within 99 characters Values Default Blank Supported All phones except T48G, T46G, T42G, T41P and T29G Devices Parameter bw.virtual_user.1.xsi.password <MAC>.cfg It configures the password of virtual account for XSI access authentication. Description Note: It works only if “bw.xsi.enable”...
Page 516: Broadsoft Centralized Call Recording
Configuration Parameters Default Blank [1][2] Parameter account.X.bw_disp_code_name.Y <MAC>.cfg It configures the disposition code name which must match one of the names configured on Description BroadWorks. Permitted String within 99 characters Values Default Blank X is the account ID. For T57W/T54W/T48U/T48S/T48G/T46U/T46S/T46G/T29G, X=1-16; for T53W/T53/T43U/T42G/T42U/T42S, X=1-12;...
Page 517 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Description It enables or disables the hoteling feature. 0-Disabled Permitted 1-Enabled, users can use any available host (shared) phone by logging in with user credentials. After Values logging in, users have access to their own guest profile on the host phone. Default Parameter account.X.hoteling.user_id <MAC>.cfg...
Page 518: Broadsoft Flexible Seating
Configuration Parameters Default X is the account ID. For T57W/T54W/T48U/T48S/T48G/T46U/T46S/T46G/T29G, X=1-16; for T53W/T53/T43U/T42G/T42U/T42S, X=1-12; for T41P/T41S/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21 (P) E2, X=1-2; for T19(P) E2/CP920, X=1. Broadsoft Flexible Seating Parameter account.X.flexible_seating.enable <MAC>.cfg It enables or disables the flexible seating feature. Description Note: For the host, it works only if “account.X.hoteling.enable”...
Page 519: Broadsoft Call Decline
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Default Supported All phones except T48G, T46G, T42G, T41P and T29G Devices X is the account ID. For T57W/T54W/T48U/T48S/T48G/T46U/T46S/T46G/T29G, X=1-16; for T53W/T53/T43U/T42G/T42U/T42S, X=1-12; for T41P/T41S/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21 (P) E2, X=1-2;...
Page 520 Configuration Parameters Note: It works only if "bw.xsi.directory.enable" is set to 1 (Enabled). Permitted 0-Disabled Values 1-Enabled Default Web UI Applications > Broadsoft XSI > Network Directory > Personal Parameter bw_phonebook.group_common_enable <y0000000000xx>.cfg It enables or disables the phone to display the group common directory. Description Note: It works only if "bw.xsi.directory.enable"...
Page 521 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Default Web UI Applications > Broadsoft XSI > Network Directory > Enable Custom Directory Parameter bw_phonebook.group_displayname <y0000000000xx>.cfg It configures the display name on the phone screen for the group directory. Description Note: It works only if "bw.xsi.directory.enable"...
Page 522 Configuration Parameters Default Parameter bw.xsi.call_log.multiple_accounts.enable <y0000000000xx>.cfg It enables or disables the user to view BroadSoft Call Log for multiple accounts. Description Note: It works only if “bw.xsi.call_log.enable” is set to 1 (Enabled). 0-Disabled, you will directly access the BroadSoft Call Log for the first account by default, and you can only view the BroadSoft call log entry for the first account Permitted Values...
Page 523 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Default GroupCommon Web UI Applications > Broadsoft XSI > Network Directory > Group Common Parameter bw.xsi.directory.alphabetized_by_lastname.enable <y0000000000xx>.cfg It configures the call ID (first name and last name) display method when the phone receives an incom- Description ing call, places an outgoing call or is during an active call.
Page 524: Broadsoft Visual Voice Mail
Configuration Parameters Broadsoft Visual Voice Mail Parameter bw.voice_mail.visual.enable <y0000000000xx>.cfg It enables or disables the visual voice mail feature for the phone. Description Note: It works only if “bw.xsi.enable" is set to 1 (Enabled). Permitted 0-Disabled Values 1-Enabled Default Parameter bw.voice_mail.visual.display_videomail.enable <y0000000000xx>.cfg It enables or disables the phone to display the video mails in the voice mail list.
Page 525: Broadsoft Call Park
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Values 1-Enabled Default Supported All phones except T19(P) E2 and CP920 Devices Parameter features.auto_release_bla_line <y0000000000xx>.cfg It enables or disables the server to release the connection by sending a notify message to phone Description when the SCA call is ended.
Page 526 Configuration Parameters 0-Disabled Permitted Values 1-Enabled Default Web UI Features > Pickup & Park > Audio Alert for Parked Call Parameter features.call_park.park_visual_notify_enable <y0000000000xx > .cfg Description It enables or disables the phone to display a parked indicator when a call is parked against its line. Permitted 0-Disabled 1-Enabled...
Page 527: Broadsoft Emergency Call
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Menu > Settings > Basic Settings > Sound > Ring Type for BLF Parked Call Monitor Parameter features.call_park.group_park_code <y0000000000xx>.cfg It configures the group call park code. Description Note: It works only if “features.call_park.park_mode” is set to 1 (FAC). Permitted String within 32 characters Values...
Page 528 <MAC>.cfg It configures the URL the phone sends when the ACD agent changes the status to away (you press the Away soft key on the phone). For example : account.1.acd.away_url= http://portal-dev.star2star.com:8181/yealink/reason_code_respon- se?reason_code=#REASONCODE&agent_extension=ext_843 85&agent_location= starbox_628&a- Description gent_phone=94&customer_id=435s #REASONCODE will be automatically replaced with the away code you entered when the URL is sent to the server.
Page 529: Alcatel-Lucent Barge In Parameters
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Alcatel-Lucent Barge in Parameters If you want to use Barge In feature, you should configure a feature access code on the phone. If no feature access code is configured, the Barge In feature is disabled. Parameter blf.normal_barge_in_code <y0000000000xx>.cfg It configures the feature access code for normally barging in the active call of the monitored line.
Page 530: Ethernet Interface Mtu Parameters
Configuration Parameters Parameter blf.listen_barge_in_code <y0000000000xx>.cfg It configures the feature access code for barging in the active call of the monitored line in listening mode. Description If configured, you can press the Listen BargeIn soft key to barge in the call. You are automatically muted so you can listen on the call only.
Page 531 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Values 1-Enabled Default Parameter account.X.custom_ua <MAC>.cfg Description It configures the suffix of User-Agent in SIP request messages from the phone. Permitted String within 256 characters Values Default Blank Parameter account.X.call_id_mode <MAC>.cfg Description It configures the constitution of caller ID.
Page 532 Configuration Parameters Values 1-Enabled Default Parameter sip.unreg_with_socket_close <y0000000000xx>.cfg It enables or disables the phone to close the socket immediately when the user deregisters the cor- Description responding account(s). Permitted 0-Disabled 1-Enabled Values Default Parameter account.X.check_cseq.enable <MAC>.cfg It enables or disables the phone to check if the CSeq sequence number in the request is lower than Description that in the previous request on the same dialog.
Page 533 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Result: The target characters %5F remain the same. Parameter sip.reserve_characters <y0000000000xx>.cfg It specifies the characters that the phone does not recognize as the escape one. Description Multiple characters are not separated. Permitted String Values...
Page 534: Call Settings Parameters
Configuration Parameters Default Parameter sip.sdp_early_answer_or_offer <y0000000000xx>.cfg It enables or disables the phone to generate an SDP Offer or Answer message when receiving a reli- Description able provisional response or PRACK request and response. Permitted 0-Disabled 1-Enabled Values Default Parameter sip.reliable_protocol.timerae.enable <y0000000000xx>.cfg It enables or disables the timer for ict and nict when TCP protocol is used.
Page 535 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones place a new call. Default Parameter phone_setting.end_call_net_disconnect.enable <y0000000000xx>.cfg Description It enables or disables the phone to end the call if the network is unavailable during the call. 0-Disabled Permitted Values 1-Enabled, the phone will end the call and go to the Idle screen after 5 seconds. Default Parameter features.station_name.value <y0000000000xx>.cfg...
Page 536: Unify Parameters
Configuration Parameters Description It configures how the phone behaves when pressing the OK key during the call. 0-Do not response 1-The phone sends a SIP INFO request that contains the event flashhook message body to the remote party. Permitted 2-Enter the Status screen, you can check the firmware version, phone's IP address and so on for Values troubleshooting.
Page 537: Troubleshooting Methods
Troubleshooting Methods Troubleshooting Methods Yealink phones provide feedback in a variety of forms such as log files, packets, status indicators and so on, which can help you more easily find the system problem and fix it. Topics Log Files Resetting Phone and Configuration...
Page 538: Local Logging Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Viewing the Log Files Local Logging Configuration The following table lists the parameters you can use to configure local logging. Parameter static.local_log.enable <y0000000000xx>.cfg It enables or disables the phone to record log locally. Description Note: We recommend that you do not disable this feature.
Page 539 Troubleshooting Methods (1) If the local log files are configured to be uploaded to the server by the parameter “static.auto_pro- vision.local_log.backup.enable”, the phone will clear all the local log files on the phone once suc- cessfully backing up. (2) If “static.auto_provision.local_log.backup.enable” is set to 0 (Disabled), the phone will erase half of the logs from the oldest log information on the phone.
Page 540: Exporting The Log Files To A Local Pc
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones If you leave it blank, the phone will upload the local log files to the provisioning server. If you configure a relative URL (for example, /upload), the phone will upload the local log files by extracting the root directory from the access URL of the provisioning server.
Page 541: Uploading Log To The Usb Flash Drive
Troubleshooting Methods 3. Select 6 from the Local Log Level drop-down menu. The default local log level is “3”. 4. Enter the limit size of the log files in the Max Log File Size field. 5. Click Confirm to accept the change. 6.
Page 542: Syslog Logging
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones 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.log): The <MAC>.log file reports the logs with a configured severity level and the higher. For example, if you have con- figured the severity level of the log to be reported to the <MAC>.log file to 4, then the log with a severity level of 0 to 4 will all be reported.
Page 543 Troubleshooting Methods It configures the IP address or domain name of the syslog server when exporting log to the syslog Description server. Permitted String within 99 characters Values Default Blank Web UI Settings > Configuration > Syslog > Syslog Server Parameter static.syslog.server_port <y0000000000xx>.cfg Description It configures the port of the syslog server.
Page 544 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones 2-Mail System 3-System Daemons 4-Security/Authorization Messages (Note 1) 5-Messages are generated internally by syslog 6-Line Printer Subsystem 7-Network News Subsystem 8-UUCP Subsystem 9-Clock Daemon (note 2) 10-Security/Authorization Messages (Note 1) 11-FTP Daemon 12-NTP Subsystem 13-Log Audit (note 1) 14-Log Alert (note 1)
Page 545: Viewing The Syslog Messages On Your Syslog Server
Troubleshooting Methods Viewing the Syslog Messages on Your Syslog Server You can view the syslog file in the desired folder on the syslog server. The location of the folder may differ from the syslog server. For more information, refer to the network resources. The following figure shows a portion of the syslog: Resetting Phone and Configuration Generally, some common issues may occur while using the IP phone.
Page 546: Resetting The Ip Phone To Default Factory Settings
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Parameter features.reset_by_long_press_enable <y0000000000xx>.cfg Description It enables or disables the phone to reset to factory by long pressing OK/√key. Permitted 0-Disabled 1-Enabled Values Default Parameter features.factory_pwd_enable <y0000000000xx>.cfg It enables or disables the phone to prompt for the administrator password when you long press the Description OK/√key to perform a factory reset on the idle screen.
Page 547: Deleting The Custom Factory Settings Files
Troubleshooting Methods Parameter static.features.custom_factory_config.enable <y0000000000xx>.cfg Description It enables or disables the Custom Factory Configuration feature. 0-Disabled Permitted 1-Enabled, Import Factory Configuration item will be displayed on the IP phone's web user interface at Values the path Settings > Configuration. You can import a custom factory configuration file or delete the user-defined factory configuration via the web user interface.
Page 548: Capturing The Packets Via Web User Interface
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Capturing the Packets via Web User Interface For Yealink phones, you can export the packets file to the local system and analyze it. Yealink devices support the following two modes for capturing the packets: Normal: Export the packets file after stopping capturing.
Page 549: Ethernet Software Capturing Configuration
Troubleshooting Methods 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.
Page 550: Watch Dog Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Watch Dog Configuration The following table lists the parameter you can use to configure watch dog. Parameter static.watch_dog.enable <y0000000000xx>.cfg Description It enables or disables the Watch Dog feature. 0-Disabled Permitted Values 1-Enabled, the phone will reboot automatically when the system crashed.
Page 551: Network Reachability Detection Configuration
Troubleshooting Methods Network Reachability Detection Configuration The following table lists the parameters you can use to configure network reachability detection. Parameter static.features.network_test.enable <y0000000000xx>.cfg Description It enables or disables the network reachability detection. 0-Disabled Permitted 1-Enabled, if the network is unreachable, "Network unreachable" is displayed on the Values T42S/T42U/T41S phones, while a network unreachable icon is displayed in the status bar of other phones.
Page 552: Analyzing Configuration Files
We recommend that you edit the exported CFG file instead of the BIN file to change the phone’s current settings. The config.bin file is an encrypted file. For more information on config.bin file, contact your Yealink reseller. Topics...
Page 553: Importing Cfg Configuration Files To Phone
Troubleshooting Methods Importing CFG Configuration Files to Phone You can import the configuration files from local to the phones via the web user interface. The configuration files contain the changes for phone features and these changes will take effect after importing. Procedure 1.
Page 554: Device Status
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Default Blank T57W/T54W/T53W/T53/T48U/T46U/T43U/T42U: Settings > Configuration > BIN Configuration > Import Configuration Web UI Other Phones: Settings > Configuration > BIN Configuration > Export or Import Configuration If you change this parameter, the phone will reboot to make the change take effect. Device Status Available information on device status includes: General information (IPv4 address or IPv6 address, phone MAC address, Machine ID, Wi-Fi dongle MAC...
Page 555: Notify Reboot Configuration
Troubleshooting Methods NOTIFY sip:<user>@<dsthost> SIP/2.0 To: sip:<user>@<dsthost> From: sip:sipsak@<srchost> CSeq: 10 NOTIFY Call-ID: 1234@<srchost> Event: check-sync;reboot=true Topic Notify Reboot Configuration Notify Reboot Configuration The following table lists the parameter you can use to configure notify reboot. Parameter sip.notify_reboot_enable <y0000000000xx>.cfg It configures the IP phone behavior when receiving a SIP NOTIFY message which contains the Description header “Event: check-sync”.
Page 556: Troubleshooting Solutions
Troubleshooting Solutions Troubleshooting Solutions This section describes solutions to common issues that may occur while using the device. Upon encountering a case not listed in this section, contact your Yealink reseller for further support. Topics IP Address Issues Time and Date Issues...
Page 557: Time And Date Issues
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Scenario 2: Yealink phones support using FTP, TFTP, HTTP, and HTTPS protocols to download configuration files or resource files. You can use one of these protocols for provisioning. When provisioning your IP phone obtaining an IPv6 address, the provisioning server should support IPv6 and the format of the access URL of the provisioning server can be “tftp://[IPv6 address or domain name]”.
Page 558: There Is No Sound When The Other Party Picks Up The Call
The phone cannot connect to Bluetooth devices all the time Try to delete the registration information of the Bluetooth device on both IP phone and Bluetooth device, and then pair and connect it again. Contact Yealink field application engineer and your Bluetooth device manufacturer for more information.
Page 559: Verifying The Firmware Version
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Verifying the firmware version Press the OK/√key or select Menu > Status when the 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: 97: T57W 96: T54W 95: T53W/T53...
Page 560: System Log Issues
Ensure that you have configured the syslog server address correctly via the web user interface on your IP phone. Reboot the phone. The configurations require a reboot to take effect. Protocols and Ports Issues What communication protocols and ports do Yealink IP phones sup- port? Destination...
Page 561: Password Issues
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Destination Source Destination Destination Description of des- Source IP Source Port Port (Listen- Protocol Device Device tination port ing port) server from DHCP server. Determined LDAP protocol port, it is IP address LDAP by des- used to obtain the contact...
Page 562: Logo Issues
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. Try to use recovery mode to get your phone ready. For more information on recovery mode, refer to Recovery Mode on Yealink phones. Other Issues The difference among user name, register name, and display name Both user name and register name are defined by the server.
Page 563: The Difference Between Rfc 2543 Hold Enabled And Disabled
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones For example, if you set the Always Forward on code to be *78 (may vary on different servers), and the target number to be 201. When you enable Always Forward on the IP phone, the phone sends *78201 to the server, and then the server will enable Always Forward feature on the server side, hence being able to get the right status of the exten- sion.
Page 564: Appendix
Appendix Appendix RFC and Internet Draft Support The following RFC’s and Internet drafts are supported: RFC 1321—The MD5 Message-Digest Algorithm RFC 1889—RTP Media control RFC 2112—Multipart MIME RFC 2327—SDP: Session Description Protocol RFC 2387—The MIME Multipart/Related Content-type RFC 2543—SIP: Session Initiation Protocol RFC 2617—Http Authentication: Basic and Digest access authentication RFC 2782—A DNS RR for specifying the location of services (DNS SRV) RFC 2806—URLs for Telephone Calls...
Page 565 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones RFC 3665—Session Initiation Protocol (SIP) Basic Call Flow Examples RFC 3666—SIP Public Switched Telephone Network (PSTN) Call Flows. RFC 3680—SIP Event Package for Registrations RFC 3702—Authentication, Authorization, and Accounting Requirements for the SIP RFC 3711—The Secure Real-time Transport Protocol (SRTP) RFC 3725—Best Current Practices for Third Party Call Control (3pcc) in the Session Initiation Protocol (SIP) RFC 3842—A Message Summary and Message Waiting Indication Event Package for the Session Initiation Pro-...
Page 566: Reading Icons
T41S Wired network is unavailable Wired network is (T48U/- (T46U/- unreachable Private line registers suc- cessfully Registration failed T42- Registering (Flash- (Flash- ing) ing) Yealink Cloud account registers successfully Hands-free (speakerphone) mode Handset mode Headset mode Voice Mail Text Message...
Page 567 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones T42- T53W/T- T42- T23P/T23- T48U/S/- T46U/S/- T40P/- CP92- T57W T54W T42- T29G Description /T43U T41- T21(P) E2 /T27G T41S Auto Answer Do Not Disturb Phone Warning (T48U/- (T46U/- Call Forward Call Hold Call Mute Keep Mute Ringer volume is...
Page 568 Appendix T42- T53W/T- T42- T23P/T23- T48U/S/- T46U/S/- T40P/- CP92- T57W T54W T42- T29G Description /T43U T41- T21(P) E2 /T27G T41S Recording can- not be stopped (DSSKey record- ing) VPN is enabled Bluetooth mode is on Bluetooth head- set is both paired and connected Bluetooth- enabled mobile...
Page 569 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones T42- T53W/T- T42- T23P/T23- T48U/S/- T46U/S/- T40P/- CP92- T57W T54W T42- T29G Description /T43U T41- T21(P) E2 /T27G T41S Line key type is BLF (BLF hold state) Line key type is BLF/BLF List (BLF/BLF list cal- lout state)
Page 570 Appendix T42- T53W/T- T42- T23P/T23- T48U/S/- T46U/S/- T40P/- CP92- T57W T54W T42- T29G Description /T43U T41- T21(P) E2 /T27G T41S Line key type is Intercom (inter- com failed state) Line key type is DTMF/Prefix Line key type is Local Group/XML Group/LDAP/Goo- gle Contacts Line key type is...
Page 571 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones T42- T53W/T- T42- T23P/T23- T48U/S/- T46U/S/- T40P/- CP92- T57W T54W T42- T29G Description /T43U T41- T21(P) E2 /T27G T41S Line key type is Line key type is Phone Lock Line key type is Directory Line key type is Custom Key...
Page 572 Appendix T42- T53W/T- T42- T23P/T23- T48U/S/- T46U/S/- T40P/- CP92- T57W T54W T42- T29G Description /T43U T41- T21(P) E2 /T27G T41S only applicable to CP920) USB flash drive is detected High Definition Voice...

Yealink SIP-T5 Series Administrator's Manual

Before You Begin

Table of Contents

Getting Started

Network Configurations

Phone Provisioning

Security Features

Firmware Upgrade

Using Handsets with T57W/T54W/T53W/T53 Phones

Audio Features

Phone Customization

Quick Links

Troubleshooting

Related Manuals for Yealink SIP-T5 Series

Summary of Contents for Yealink SIP-T5 Series