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.
The following sections are new for this version: Provisioning Parameters URL Icon Hide BLF Send DTMF Configuration Enterprise Directory Local Contacts Number Configuration Web Access Time Limit Configuration Upgrading Yealink Headset Firmware Ultrasonic Configuration Zoom Parameters Zoom Settings Zoom Barge in Parameters Zoom Call Settings Zoom SCA...
Before You Begin Audio Codecs Configuration Added the parameter "phone_setting.talking_codec_display". Call Transfer Configuration Added the parameter "features.transfer.allow". "Call Display Configuration" on page 261 Added the parameter "phone_setting.call_number_display.replace.pattern", "phone_setting.call_number_dis- play.replace.with". Hot Desking Configuration Added the parameter "hotdesking.log_out_prompt.duration", "hotdesking.log_out_prompt.time", "hot- desking.clear_specified_account". Dsskey Page Reset Configuration Added the parameter "features.dsskey_page_reset.switch_time".
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Call Transfer Configuration Added the parameter "features.transfer.mode". Voice Quality Reports Configuration Added the parameter "phone_setting.vq_rtcpxr.min_callduration". Call Display Configuration Added the parameter "features.caller_name_type_on_call". Call Settings Parameters Added the parameter "features.missed_call_icon_event". DND Settings Configuration Call Forward Settings Configuration Added the parameter "phone_setting.fwd_and_dnd.suspension_prompt".
Page 6
Before You Begin Out of Service PIN Code Provisioning Settings Configuration Smart Noise Filtering Unify Parameters Example: Using VPN based on L2TP Protocol Exporting the OpenVPN Configuration File from the Phone Importing the OpenVPN Configuration File to Phone Dsskey Page Reset Configuration Major updates have occurred to the following sections: Bluetooth Language...
Changes for Release V85, Guide Version V85.2 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 9
Table of Contents Customizing a Configuration File Configuration File Attributes Resource Files Supported Resource Files Files Download Process Provisioning Methods Provisioning Methods Priority Web User Interface Accessing the Web User Interface Quick Login Configuration Web Server Type Configuration Web Access Time Limit Configuration Navigating the Web User Interface Phone User Interface Central Provisioning...
Page 10
Incoming Network Signaling Validation Configuration USB Port Lock USB Port Lock Configuration Firmware Upgrade Firmware for Each Phone Model Firmware Upgrade Configuration Upgrading Yealink Headset Firmware Using DECT Handsets with T57W/T54W/T53W/T53/T53C Phones Handset Backlight Handset Backlight Configuration Handset Keypad Light Handset Keypad Light Configuration...
Page 11
Table of Contents Shared Contact File Customization Shared Contact File Elements and Attributes Customizing Shared Contact File Satellite Mode Satellite Mode Configuration Example: Configuring the Satellite Mode Feature Repeater Settings Parameters Handset Settings Parameters Custom Handset Related Configurations Handset Firmware Upgrade Configuration Emergency Alarm Emergency Alarm Configuration Line Keys...
Page 12
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones PTime Configuration Early Media Early Media Configuration Headset Prior Headset Prior Configuration Dual Headset Dual Headset Configuration Acoustic Clarity Technology Acoustic Echo Cancellation (AEC) AEC Configuration Noise Suppression Noise Suppression Configuration Background Noise Suppression (BNS) Automatic Gain Control (AGC) Voice Activity Detection (VAD)
Page 13
Table of Contents Central Report Collector Configuration Ultrasonic Configuration Phone Customization Language Supported Languages Language Display Configuration Language for Phone Display Customization Customizing a Language Pack for Phone Display Custom Language for Phone Display Configuration Example: Setting a Custom Language for Phone Display Language for Web Display Customization Customizing a Language Pack for Web Display Customizing a Language Pack for Note Display...
Page 14
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Phone Page Tips Phone Page Tips Indicator Phone Page Tips Configuration Expansion Module Page Tips Expansion Module Page Tips Indicator Expansion Module Page Tips Configuration Time and Date Time Zone NTP Settings NTP Configuration DST Settings...
Page 15
Table of Contents Layout File Elements and Attributes Customizing a Layout File Input Method Configuration Example: Configuring the French Onscreen Keyboard Input Method Notification Popups Notification Popups Configuration Power LED Indicator Power LED Indicator Configuration Bluetooth Bluetooth Configuration Handset/Headset/Speakerphone Mode Handset/Headset/Speakerphone Mode Configuration DSS Keys Supported DSS Keys...
Page 16
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Search Source List in Dialing Search Source File Customization Search Source File Attributes Customizing Search Source File Search Source List Configuration Recent Call Display in Dialing Recent Call in Dialing Configuration Icon Customization Custom Icons Configuration Warnings Display...
Page 17
Table of Contents XML Conversion Table Local Contact File Elements and Attributes Customizing Local Contact File Local Contact Files and Resource Upload Example: Adding Contacts Using a Contact File Local Contacts Backup Local Contacts Order Configuration Local Contacts Number Configuration Favorite Contacts Favorites Configuration Google Contacts...
Page 18
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Replace Rule File Attributes Customizing the Replace Rule File Dial Now File Customization Dial Now File Attributes Customizing the Dial Now File Replace Rule Configuration Dial Now Configuration Area Code Configuration Block Out Configuration Example: Adding Replace Rules Using a Replace Rule File Dial Plan Defined by Digit Map (New Dial Plan Mechanism)
Page 19
Table of Contents Call Waiting Call Waiting Configuration Do Not Disturb (DND) DND Settings Configuration DND Feature Configuration DND in Phone Mode Configuration DND in Custom Mode Configuration DND Synchronization for Server-side Configuration Multiple Call Appearances Multiple Call Appearances Configuration Call Hold Call Hold Configuration Music on Hold (MoH) Configuration...
Page 20
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Group Call Pickup Configuration Dialog Info Call Pickup Dialog Info Call Pickup Configuration Call Completion Call Completion Configuration Example: Using Call Completion Call Park and Retrieve Call Park and Retrieve Configuration Example: Setting Call Park and Retrieve in FAC Mode Example: Setting Call Park and Retrieve in Transfer Mode Automatic Call Distribution (ACD)
Page 21
Table of Contents Intercom Key Configuration State Monitor for Intercom Contact State Indicator of Intercom Contact State Monitor for Intercom Contact Configuration Outgoing Intercom Configuration Incoming Intercom Configuration CSTA Control CSTA Control Configuration Action URL Predefined Events List Variable Values List Action URL Configuration Action URI Supported HTTP/HTTPS GET Request...
Page 22
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones SIP Session Timer Configuration Session Timer Session Timer Configuration Reboot in Talking Reboot in Talking Configuration Reserve # in User Name Reserve # in User Name Configuration Busy Tone Delay Busy Tone Delay Configuration CFG File Version Information CFG File Version Information Configuration...
Page 23
Table of Contents Unify Parameters Provisioning Parameters Troubleshooting Methods Exporting All the Diagnostic Files Exporting Headset Audio Diagnostic File Exporting Headset Log Log Files Local Logging Local Logging Configuration Exporting the Log Files to a Local PC Uploading Log to the USB Flash Drive Viewing the Log Files Syslog Logging Syslog Logging Configuration...
Page 24
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 The web screen displays "Default password is in use.
Page 25
Table of Contents The difference among user name, register name, and display name On code and off code The difference between RFC 2543 Hold enabled and disabled The difference between Shared Call Appearance (SCA) and Bridge Lines Appearance (BLA) Appendix RFC and Internet Draft Support Reading Icons...
Page 26
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /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.
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.
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...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Black-and-white Screen Phones: Menu > Settings > Advanced Settings (default password: admin) > Network > WAN Port > IP Mode 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”...
Page 32
Network Configurations Color Screen Phones: Menu > Advanced (default password: admin) > Network > WAN Port > IPv4 > Type CP925: Phone UI More > Advanced (default password: admin) > Network > WAN Port > IPv4 > Type Black-and-white Screen Phones: Menu >...
Page 33
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Black-and-white Screen Phones: Menu > Settings > Advanced Settings (default password: admin) > Network > WAN Port > IPv4 > Static IPv4 Client > Subnet Mask Parameter static.network.internet_port.gateway <y0000000000xx>.cfg It configures the IPv4 default gateway for the wired network. Description Note: It works only if "static.network.internet_port.type"...
Page 34
Network Configurations (On). Permitted Values IPv4 Address Default Blank T57W/T54W/T53W/T53/T53C/T48U/T46U/T43U/T42U/CP925: Network > Basic > IPv4 Config > Static DNS > Primary DNS Web UI Other Phones: Network > Basic > IPv4 Config > Static IP Address > Primary DNS Color Screen Phones: Menu >...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Sec.DNS In the DHCP environment: Menu > Advanced (default password: admin) > Network > WAN Port > IPv4 > DHCP > Static DNS (Enabled) > Sec.DNS CP925: More > Advanced (default password: admin) > Network > WAN Port > IPv4 > DHCP > Static DNS (Enabled) >...
Page 36
Network Configurations Permitted IPv6 Address Values Default Blank T57W/T54W/T53W/T53/T53C/T48U/T46U/T43U/T42U/CP925: Network > Basic > IPv6 Config > Configuration Type (Static IP) > IP Address Web UI Other Phones: Network > Basic > IPv6 Config > Static IP Address > IP Address Color Screen Phones: Menu >...
Page 37
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Network > Basic > IPv6 Config > Static IP Address > Default Gateway Color Screen Phones: Menu > Advanced (default password: admin) > Network > WAN Port > IPv6 > Static IP > Default Gate- CP925: Phone UI More >...
Page 38
Network Configurations In DHCP environment: Menu > Advanced (default password: admin) > Network > WAN Port > IPv6 > DHCP > Static DNS (Enabled) > Pri.DNS CP925: More > Advanced (default password: admin) > Network > WAN Port > IPv6 > DHCP > Static DNS (Enabled) >...
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.
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones For T48S phones: SIP-T48S For T46U phones: SIP-T46U For T46G phones: SIP-T46G For T46S phones: SIP-T46S For T43U phones: SIP-T43U For T42G phones: SIP-T42G For T42S phones: SIP-T42S For T42U phones: SIP-T42U For T41P phones: SIP-T41P For T41S phones: SIP-T41S For T40P phones: SIP-T40P...
Description It configures the vendor class identifier string to use in the DHCP interaction. Permitted String within 99 characters Values Default yealink Web UI Settings > Auto Provision > IPv4 DHCP Option Value Color Screen Phones: Menu > Advanced (default password: admin) > Auto Provision > IPv4 DHCP Option Value...
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. Parameters DHCPv6 Option Description ACS URL Specify the access URL of the TR-069 ACS server.
Network Configurations When LLDP feature is enabled on the phones, the phones periodically advertise their own information to the dir- ectly connected LLDP-enabled switch. The phones can also receive LLDP packets from the connected switch and obtain their VLAN IDs. The following table lists the parameters you can use to configure LLDP.
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Values 1-Enabled, the phone attempts to determine its VLAN ID through CDP. Default Web UI Network > Advanced > CDP > Active Color Screen Phones: Menu > Advanced (default password: admin) > Network > CDP > CDP Status CP925: Phone UI More >...
Page 46
Network Configurations Black-and-white Screen Phones: Menu > Settings > Advanced Settings (default password: admin) > Network > VLAN > WAN Port > VLAN Status Parameter static.network.vlan.internet_port_vid <y0000000000xx>.cfg It configures the VLAN ID for the Internet port. Description Note: It works only if “static.network.vlan.internet_port_enable” is set to 1 (Enabled). Permitted Integer from 1 to 4094 Values...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Web UI Network > Advanced > VLAN > PC Port > Active Color Screen Phones: Menu > Advanced (default password: admin) > Network > VLAN > PC Port > VLAN Status Phone UI Black-and-white Screen Phones: Menu >...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Wi-Fi Wi-Fi feature enables you to connect the phones to the organization’s wireless network. Wi-Fi feature is only applic- able to T57W/T54W/T53W/T53/T53C/T48U/T48S/T48G/T46U/T46S/T46G/T43U/T42U/T42S/T41S/T29G/T27G/CP920/CP9- 25/CP935W phones. You can configure the phones to operate in IPv4, IPv6, or dual-stack (IPv4/IPv6) mode, and configure IPv4 or IPv6 wireless network settings manually.
Page 50
Network Configurations Default Supported T57W, T54W, T53W, T53, T53C, T48U, T48S, T48G, T46U, T46S, T46G, T43U, T42U, T42S, T41S, Devices T29G, T27G, CP920, CP925 Parameter static.wifi.enable <y0000000000xx>.cfg It activates or deactivates the Wi-Fi mode. Description Note: It works only if “static.wifi.function.enable” is set to 1 (Enabled). Permitted 0-Disabled 1-Enabled...
Page 51
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Note: It works only if “static.wifi.enable” is set to 1 (Enabled). Permitted Integer from 1 to 5 Values Default Supported T57W, T54W, T53W, T53, T53C, T48U, T48S, T48G, T46U, T46S, T46G, T43U, T42U, T42S, T41S, T29G, T27G, CP920, CP925, CP935W Devices Web UI...
Page 52
Network Configurations Devices T29G, T27G, CP920, CP925, CP935W 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 CP925/CP935W: Phone UI More >...
Page 53
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones It configures the anonymous identity (user name) for Wi-Fi 802.1X authentication. Description Note: It works only if “static.wifi.enable” is set to 1 (Enabled) and “static.wifi.X.security_mode” is set to 802.1x EAP. Permitted String within 255 characters Values...
Network Configurations 0-Disabled, the phone will enable the Wi-Fi feature and try to connect to the known wireless network Permitted (according to the priority) automatically. But if the phone fails to connect to any known wireless net- Values work, the phone will still display the Wi-Fi scanning prompt when connecting to the phone. 1-Enabled Default Supported...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Static IPv4 Client > Sec.DNS In DHCP environment: Menu > Settings > Advanced Settings (default password: admin) > Network > Wi-Fi Port > IPv4 > DHCP IPv4 Client > Static DNS (Enabled) > Sec.DNS IPv6 Wireless Network Configuration If you configure the network settings on the phone for an IPv6 network, you can set up an IP address for the phone by using SLAAC (ICMPv6), DHCPv6 or by manually entering an IP address.
Page 60
Network Configurations Other Phones: Network > Wi-Fi > IPv6 Config > Static IP Address > IP Address Color Screen Phones: Menu > Advanced (default password: admin) > Network > Wi-Fi Port > IPv6 > Static IP > IP Address CP925/CP935W: Phone UI More >...
Page 61
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Menu > Advanced (default password: admin) > Network > Wi-Fi Port > IPv6 > Static IP > Default Gate- CP925/CP935W: More > Advanced (default password: admin) > Network > Wi-Fi Port > IPv6 > Static IP > Default Gate- Black-and-white Screen Phones: Menu >...
Page 62
Network Configurations CP925/CP935W: More > Advanced (default password: admin) > Network > Wi-Fi Port > IPv6 > Static IP > Pri.DNS In DHCP environment: Menu > Advanced (default password: admin) > Network > Wi-Fi Port > IPv6 > DHCP > Static DNS (Enabled) >...
The phones can traverse NAT gateways to establish and maintain connections with external devices. Yealink phones support three NAT traversal techniques: manual NAT, STUN and ICE. If you enable manual NAT and STUN, the phone will use the manually-configured external IP address for NAT traversal. The TURN protocol is used as part of the ICE approach to NAT traversal.
Page 65
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Default Web UI Network > NAT > Manual NAT > Active Parameter static.network.static_nat.addr <y0000000000xx>.cfg It configures the IP address to be advertised in SIP signaling. It should match the external IP address used by the NAT device. Description Note: It works only if “static.network.static_nat.enable”...
Page 66
Network Configurations Note: It works only if “static.sip.nat_stun.enable” is set to 1 (Enabled). Permitted Integer from 1024 to 65535 Values Default 3478 Web UI Network > NAT > STUN > STUN Port (1024~65535) Color Screen Phones: Menu > Advanced (default password: admin) > Network > NAT > STUN Port CP925/CP935W: Phone UI More >...
T40P/T40G/T23P/T23G, X=1-3; for T31P/T31G/T31/T21(P) E2, X=1-2; for T30P/T30/T19(P) E2/CP920/CP925/CP935W, X=1. 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. Parameter account.X.nat.udp_update_enable <MAC>.cfg...
Network Configurations X is the account ID. For T57W/T54W/T48U/T48S/T48G/T46U/T46S/T46G/T29G, X=1-16; for T53W/T53/T53C/T43U/T42G/T42U/T42S, X=1-12; for T41P/T41S/T27G, X=1-6; for T33P/T33G, X=1-4; for T40P/T40G/T23P/T23G, X=1-3; for T31P/T31G/T31/T21(P) E2, X=1-2; for T30P/T30/T19(P) E2/CP920/CP925/CP935W, X=1. Rport Configuration Rport allows a client to request that the server sends the response back to the source IP address and port from which the request originated.
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/CP925 phones have Internet port only.
Page 70
Network Configurations 4-Half Duplex 100Mbps 5-Full Duplex 1000Mbps (only applicable to T57W/T54W/T53W/T53/T53C/T48U/T48S/T48G/T46U/T46S/T46G/T43U/T42U/T42G/T42S/T40G/T33G/T- 31G/T29G/T27G/T23G phones) Default Web UI Network > Advanced > Port Link > WAN Port Link Para- static.network.pc_port.speed_duplex <y0000000000xx>.cfg meter It configures the network speed over Ethernet of the PC port. Note: It works only if “static.network.pc_port.enable”...
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 72
Network Configurations Black-and-white Screen Phones: Menu > Settings > Advanced Settings (default password: admin) > Network > VPN > VPN Active Parameter static.openvpn.url <y0000000000xx>.cfg It configures the access URL of the *.tar file for OpenVPN. Description Note: It works only if "static.network.vpn.mode" is set to 1 (OpenVPN). Permitted URL within 511 characters Values...
Network Configurations 3. In the Import VPN Configuration File field, click Browse to locate a OpenVPN configuration file in your local sys- tem. 4. Click Upload to import the configuration file. Quality of Service (QoS) VoIP is extremely bandwidth and delay-sensitive. QoS is a major issue in VoIP implementations, regarding how to guarantee that packet traffic is not delayed or dropped due to interference from other lower priority traffic.
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Other Phones: Network > Advanced > Voice QoS > SIP QoS (0~63) 802.1x Authentication Yealink phones support the following protocols for 802.1x authentication: EAP-MD5 EAP-TLS (requires Device and CA certificates, requires no password) EAP-PEAP/MSCHAPv2 (requires CA certificates)
Page 76
Network Configurations Note: It works only if “static.network.802_1x.mode” is set to 7 (EAP-FAST). 0-Unauthenticated Provisioning, EAP In-Band provisioning is enabled by server unauthenticated PAC (Protected Access Credential) provisioning using the anonymous Diffie-Hellman key exchange. Permitted Values 1-Authenticated Provisioning, EAP In-Band provisioning is enabled by server authenticated PAC pro- visioning using certificate-based server authentication.
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Menu > Settings > Advanced Settings (default password: admin) > Network > 802.1x > MD5 Password Parameter static.network.802_1x.root_cert_url <y0000000000xx>.cfg It configures the URL for uploading the 802.1x CA certificate. The format of the certificate must be *.pem, *.crt, *.cer or *.der. Description Note: It works only if “static.network.802_1x.mode”...
Network Configurations RPC Method Description GetRPCMethods This method is used to discover the set of methods supported by the CPE. SetParameterValues This method is used to modify the value of one or more CPE parameters. GetParameterValues This method is used to obtain the value of one or more CPE parameters. GetParameterNames This method is used to discover the parameters accessible on a particular CPE.
Page 79
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Default Blank Web UI Settings > TR069 > ACS Username Parameter static.managementserver.password <y0000000000xx>.cfg It configures the TR-069 ACS server password used to authenticate the phone. Description Leave it blank if no authentication is required. Permitted String within 64 characters Values...
Page 80
Network Configurations Note: It works only if “static.managementserver.periodic_inform_enable” is set to 1 (Enabled). Permitted Integer from 5 to 4294967295 Values Default Web UI Settings > TR069 > Periodic Inform Interval (seconds)
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.
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /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).
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.
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Configuration File Attributes 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.
Phone Provisioning Phone Model Common CFG file CP935W y000000000149.cfg MAC-Oriented CFG File MAC-Oriented CFG file, which is named after the MAC address of the IP phone. For example, if the MAC address of an IP phone is 00156574B150, the name of MAC-Oriented CFG file is 00156574b150.cfg (lowercase). It contains parameters unique to a particular phone, such as account registration.
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...
Phone Provisioning Template File File Name Description Reference in Section 000.GUI.English.lang Display Customization 1.English_note.xml guage on the phone/web user interface. Language for Web Display Customization 1.English.js ime.txt Keypad Input Keypad Input Method Russian_ime.txt Customize the existing input method. Method File File Customization Hebrew_ime.txt keyboard_lang.xml...
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.
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”...
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).
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.
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Permitted 0-Disabled 1-Enabled Values Default Web UI Network > Advanced > Web Server > HTTPS Color Screen Phones: Menu > Advanced (default password: admin) > Network > Web Server > HTTPS Status CP925/CP935W: Phone UI More >...
Page 93
Phone Provisioning wui.login_wait_time = 3 It means if you haven't logged into the web page after 3 minutes, the web page is disabled. If you want to access the web user interface again, do one of the following: Configure "static.wui.https_enable = 1" via auto provisioning. Enable HTTPS/HTTPS Status via phone user interface at the path: Menu >...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones It means if you log into the web page and perform configuration operations for 30 minutes, regardless of whether you are operating or not, the web page will be forcibly disabled. If you want to access the web user interface again, do one of the following: Configure "static.wui.https_enable = 1"...
Phone Provisioning Yealink phones can obtain the provisioning server address during startup. Then the phones first download boot files and configuration files from the provisioning server and then resolve and update the configurations written in configuration files. This entire process is called auto provisioning. For more information on auto provisioning, refer Yealink SIP IP Phones Auto Provisioning Guide.
Page 96
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones It configures the timeout (in seconds) to transfer a file for HTTP/HTTPS connection. Description Note: It has a lower priority than the value defined by the parameter “static.auto_provision.attempt_ expired_time”. Permitted Integer from 1 to 20 Values Default...
Page 97
Phone Provisioning Web UI Settings > Auto Provision > Power On Parameter static.auto_provision.repeat.enable <y0000000000xx>.cfg Description It triggers the repeatedly feature to on or off. 0-Off Permitted Values 1-On Default Web UI Settings > Auto Provision > Repeatedly Parameter static.auto_provision.repeat.minutes <y0000000000xx>.cfg It configures the interval (in minutes) for the phone to perform auto provisioning repeatedly.
Page 98
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones been inactivated for 60 minutes (1 hour) between the starting time and ending time. Note: The phone may perform auto provisioning when you are using the phone during office hour. It works only if “static.auto_provision.weekly.enable”...
Page 99
Phone Provisioning 0-Off 1-On, the phone performs auto provisioning at random between a starting time configured by the para- Permitted meter "static.auto_provision.flexible.begin_time" and an ending time configured by the parameter "stat- Values ic.auto_provision.flexible.end_time" on a random day within the period configured by the parameter "static.auto_provision.flexible.interval".
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones figuration changes) during auto provisioning. Note: If the phone performs auto provisioning when receiving a SIP NOTIFY message which contains the header “Event: check-sync”, the phone will display the prompt message no matter whether the con- figuration is updated.
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.
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.
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones DHCP: DHCP option can be used to provide the address or URL of the provisioning server to phones. When the IP phone requests an IP address using the DHCP protocol, the resulting response may contain option 66 (for IPv4)/option 59 (for IPv6) or the custom option (if configured) that contains the provisioning server address.
Phone Provisioning PnP Provision Configuration The following table lists the parameter you can use to configure PnP provision. Parameter static.auto_provision.pnp_enable <y0000000000xx>.cfg Description It triggers the Plug and Play (PnP) feature to on or off. 0-Off Permitted 1-On, the phone broadcasts SIP SUBSCRIBE messages to obtain a provisioning server URL where Values the phone can request the configuration from during startup.
Phone Provisioning 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 For T41P phones: T41P For T41S phones: T41S For T40P phones: T40P For T40G phones: T40G For T33G phones: T33G...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones The following table lists the parameters you can use to configure static provision. Parameter static.auto_provision.server.url <y0000000000xx>.cfg Description It configures the access URL of the provisioning server. Permitted URL within 511 characters Values Default Blank...
(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.
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones 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.
Phone Provisioning 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 “ static.auto_provision.custom.sync =0 ”, the MAC-local.cfg file will be kept locally. The personalized set- tings will not be overridden after auto provisioning.
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 115
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Permitted String within 32 characters Values Default Parameter static.security.user_password <y0000000000xx>.cfg It configures the password. The phone uses “user” as the default user password, "var" as the default var password and “admin” as the default administrator password.
If you change this parameter, the phone will reboot to make the change take effect. User Access Level Configuration For more information, refer to Yealink SIP IP Phones Configuration Guide for User Access Level. The following table lists the parameters you can use to configure the user access level.
You can lock the IP phone to prevent it from unauthorized use. Once the IP phone is locked, anyone must enter the password to unlock it. Yealink phones offer three types for phone lock: Lock the Menu soft key: it prevents unauthorized users from accessing the menu and changing the personal settings for your phone.
Security Features You can set a waiting time, after which the phone is locked automatically. If the waiting time is set to 0, the phone will not be automatically locked. You need to lock the phone manually. Note : The Volume key, HEADSET key and Speakerphone key are always available even when you lock the phone. Topics Operation Behaviors on Lock Phone Phone Lock Configuration...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones For T57W/T48U/T48S/T48G, all keys and screen are locked except the HEADSET key, Volume key, digit keys, # key, * key, and Speakerphone key. Phone Lock Configuration The following table lists the parameters you can use to configure the phone lock. Parameter phone_setting.phone_lock.enable <y0000000000xx>.cfg Description It enables or disables the phone lock feature.
Page 120
Security Features CP925/CP935W: More > Basic > Change PIN Black-and-white Screen Phones: Menu > Settings > Basic Settings > Change PIN Parameter phone_setting.phone_lock.lock_time_out <y0000000000xx>.cfg It configures the idle time (in seconds) before the phone is automatically locked. The default value is 0 (the phone is locked only by long pressing the pound key or pressing the phone Description lock DSS key).
Yealink phones support TLS version 1.0, 1.1, 1.2, and 1.3. 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.
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 123
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Equifax Secure Certificate Authority Equifax Secure eBusiness CA-1 Equifax Secure Global eBusiness CA-1 GeoTrust Global CA GeoTrust Global CA2 GeoTrust Primary Certification Authority GeoTrust Primary Certification Authority G2 GeoTrust Universal CA GeoTrust Universal CA2 Thawte Personal Freemail CA Thawte Premium Server CA...
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 125
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones 3-DNS NAPTR, if no server port is given, the phone performs the DNS NAPTR and SRV queries for the service type and port. Default Web UI Account > Register > SIP Server Y > Transport Parameter static.security.default_ssl_method <y0000000000xx>.cfg It configures the TLS version to use for handshake negotiation between the phone and server (for...
Page 126
Security Features 3-SSL V23 (automatic negotiation with the server. The phone starts with TLS 1.2 for negotiation.) 4-TLS 1.1 Values 5-TLS 1.2 6-TLS 1.3 Default Blank security.web_server.tls_cipher_list security.xmpp_xsi.tls_cipher_list static.security.xml_browser.tls_cipher_list static.security.remote_phonebook.tls_cipher_list static.security.dm.tls_cipher_list Parameter <y0000000000xx>.cfg static.security.auto_provision.tls_cipher_list static.security.tr069.tls_cipher_list static.security.802_1x.tls_cipher_list static.security.sip.tls_cipher_list static.security.sopi.tls_cipher_list Description It specifies the cipher list for the specific module. Permitted String Values...
Page 127
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones 0-Disabled Permitted 1-Enabled, the desired module will authenticate the server certificate based on the trusted certificates Values list. Only when the authentication succeeds, will the desired module trust the server. Default Blank Security >...
Page 128
Security Features static.security.remote_phonebook.cn_validation static.security.dm.cn_validation static.security.auto_provision.cn_validation static.security.tr069.cn_validation static.security.802_1x.cn_validation static.security.sip.cn_validation static.security.sopi.cn_validation It enables or disables the desired module to mandatorily validate the CommonName or Sub- Description jectAltName of the certificate sent by the server. Permitted 0-Disabled 1-Enabled Values Default Blank Security > Trusted Certificates > Module(web_server/auto_provision/xml_browser/remote_phone- Web UI book/sip/sopi/802_1x/dm/tr069) >...
Page 129
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Permitted URL within 511 characters Values Default Blank T57W/T54W/T53W/T53/T53C/T48U/T46U/T43U/T42U/CP925/CP935W: Security > Trusted Certificates > Upload Trusted Certificate File Web UI Other Phones: Security > Trusted Certificates > Load Trusted Certificates File Parameter static.trusted_certificates.delete <y0000000000xx>.cfg Description It configures to delete all uploaded trusted certificates.
Security Features Parameter static.phone_setting.reserve_certs_config.enable <y0000000000xx>.cfg It enables or disables the phone to reserve the trusted and server certificates settings after the phone Description reset to factory defaults. 0-Disabled, “static.security.trust_certificates”, “static.security.ca_cert”, “static.security.cn_validation” and “static.security.dev_cert” will be reset. Permitted Values 1-Enabled, “static.security.trust_certificates”, “static.security.ca_cert”, “static.security.cn_validation”, “static.security.dev_cert”...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones a=rtpmap:0 PCMU/8000 a=rtpmap:101 telephone-event/8000 a=crypto:1 AES_CM_128_HMAC_SHA1_80 inline:NGY4OGViMDYzZjQzYTNiOTNkOWRiYzRlMjM0Yzcz a=sendrecv a=ptime:20 a=fmtp:101 0-15 When SRTP is enabled on both phones, RTP streams will be encrypted, and a lock icon appears on the LCD screen of each IP phone after a successful negotiation.
T40P/T40G/T23P/T23G, X=1-3; for T31P/T31G/T31/T21(P) E2, X=1-2; for T30P/T30/T19(P) E2/CP920/CP925/CP935W, 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 CFG file (<MAC>-local.cfg) or other custom CFG files (for example, sip.cfg, account.cfg)
Contact Files Encryption and Decryption Encryption and Decryption Configuration Configuration Files Encryption Tools Yealink provides three configuration files encryption tools: Config_Encrypt_Tool.exe (via graphical tool for Windows platform) YealinkEncrypt CMD.exe (via DOS command line for Windows platform) yealinkencrypt (for Linux platform) The encryption tools support two encryption modes: RSA Mode and Compatibility Mode.
Page 134
Security Features Default Parameter static.auto_provision.aes_key_in_file <y0000000000xx>.cfg Description It configures how the phone decrypts files. 0-The phone will decrypt the encrypted configuration files using plaintext AES keys configured on the phone. 1-The phone determines whether the file is an encrypted file generated in RSA mode. If yes, the phone will decrypt the encrypted configuration file using the phone built-in RSA private key or self- Permitted define RSA private key.
Page 135
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones loaded MAC-Oriented file is encrypted and the parameter “static.auto_provision.aes_key.mac” is left blank, the phone will try to encrypt/decrypt the MAC-Oriented file using the AES key configured by the parameter “static.auto_provision.aes_key.com”. Permitted 16/32 characters Values...
Page 136
Security Features 1-Enabled, the call log file will be encrypted uploaded and will replace the one (encrypted or unen- crypted) stored on the server if you have configured to back up the call log to the server by the para- meter “static.auto_provision.local_calllog.backup.enable”.
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.
Security Features Values Default Blank USB Port Lock You can lock the USB port on T57W/T54W/T53W/T53/T53C/T48U/T48S/T48G/T46U/T46S/T46G/T43U/T42U/T42S/T41S/T29G/T27G/CP920/CP9- 25/CP935W phones. The following features are not available when you disable the USB port: Adding a Wallpaper from a USB Flash Drive Adding a Screensaver Picture from a USB Flash Drive Wi-Fi (except T57W/T54W/T53W/CP920/CP925/CP935W) Bluetooth...
All configurations will be cleared on the T23P/T23G/T21(P) E2/T19(P) E2 phones when downgrading the phones from firm- ware version 84 to 83. Topics Firmware for Each Phone Model Firmware Upgrade Configuration Upgrading Yealink Headset Firmware Firmware for Each Phone Model You can download the latest firmware online: http://sup- port.yealink.com/documentFront/forwardToDocumentFrontDisplayPage.
You can upgrade Yealink USB headset WH62/WH63/UH33/UH36/CP900/CP700 on T5XW/T4XU phones. Procedure 1. From the web user interface, click Settings > Upgrade. 2. In the Upgrade Yealink Headset Firmware block, click Browse to locate the headset firmware from your local system.
Page 141
Firmware Upgrade 3. Click Upload. Note Menu Headset Firmware Update : You can also upgrade Yealink USB headset via phone user interface: -> ->...
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...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Parameter custom.handset.backlight_in_charger.enable <y0000000000xx>.cfg It enables or disables the handset backlight to be on for about 30 minutes when it is charged. Description Note: It will take effect on all handsets that are registered on the same phone. It works only if “static.auto_provision.handset_configured.enable”...
Using DECT Handsets with T57W/T54W/T53W/T53/T53C Phones Parameter custom.handset.keypad_light.enable <y0000000000xx>.cfg It enables or disables the handset to turn on the keypad light (digital key, # key, * key, TRAN key, and Mute key) when any key is pressed. Description Note: It will take effect on all handsets that are registered to the same phone. It works only if “stat- ic.auto_provision.handset_configured.enable”...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Handset Screen Saver The screen saver of the handset is designed to protect your LCD screen. You can enable the screen saver to pro- tect the LCD screen, an analog clock will be activated and appear on the LCD screen after the handset is idle for approximately 10 seconds.
Using DECT Handsets with T57W/T54W/T53W/T53/T53C Phones Status > Handset > Handset Name > Handset X Web UI T57W/T54W/T53C: Menu > DECT Settings > Handsets > Handset X Phone UI T53W/T53: Menu > Settings > DECT Settings > Handsets > Handset X W78H/W73H/W59R/W53H/W56H: OK >...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones The incoming line for handset 3 is line 3. The incoming line for handset 4 is line 4. The incoming line for handset 5 is line 5. Web UI Account > Number Assignment > Incoming lines Parameter handset.X.dial_out_lines <y0000000000xx>.cfg It configures the lines to place outgoing calls for a specific handset.
Using DECT Handsets with T57W/T54W/T53W/T53/T53C Phones 1-Always Default Supported W78H, W73H, W59R, W53H, W56H Devices Web UI Features > General Information > End Call On Hook Advisory Tones Advisory tones are the acoustic signals of your handset, which inform you of different actions and states. It is not applicable to DD phones.
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones CP930W: Menu > Settings > Basic Settings > Sound > Advisory Tones > Keypad Tone Parameter custom.handset.confirmation_tone.enable <y0000000000xx>.cfg It enables or disables the handset to play a tone when a user saves settings or places the handset in the charger cradle.
Using DECT Handsets with T57W/T54W/T53W/T53/T53C Phones Base PIN Configuration The following table lists the parameters you can use to configure the base PIN. Parameter base.pin_code <y0000000000xx>.cfg Description It configures the base PIN. Permitted Integer from 0000 to 9999 Values Default 0000 Web UI Security >...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones DECT Intercom Intercom is a useful feature in an office environment to quickly connect with the operator or the secretary. Users can make internal intercom calls and external intercom calls on the handset. Internal intercom calls are made among handsets registered to the same phone.
Page 152
Using DECT Handsets with T57W/T54W/T53W/T53/T53C Phones Default Web UI Directory > LDAP > Handset X > Enable LDAP Parameter handset.X.ldap.name_filter <MAC>.cfg It configures the search criteria for LDAP contact names lookup. The “*” symbol in the filter stands for any character. The “%” symbol in the filter stands for the name entered by the user.
Page 153
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 512 characters Values Default...
Page 154
Using DECT Handsets with T57W/T54W/T53W/T53/T53C Phones 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 512 characters Values Default Blank...
Page 155
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Default Blank Web UI Directory > LDAP > Handset X > LDAP Display Name Parameter handset.X.ldap.version <MAC>.cfg It configures the LDAP protocol version supported by the IP phone. The version must be the same as Description the version assigned on the LDAP server.
Using DECT Handsets with T57W/T54W/T53W/T53/T53C Phones Default [1]X is the handset ID. X=1-5. Handset Network Directory Parameter bw.xsi.directory.multiple_accounts.enable <y0000000000xx>.cfg It configures the handset to display BSFT network directory on the screen. Description Note: It works only if “bw.xsi.directory.enable" is set to 1 (Enabled). 0-All handsets display network directory of account 1.
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.
Using DECT Handsets with T57W/T54W/T53W/T53/T53C 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.
Using DECT Handsets with T57W/T54W/T53W/T53/T53C 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".
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP 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 162
Using DECT Handsets with T57W/T54W/T53W/T53/T53C 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 163
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones W59R/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 164
Using DECT Handsets with T57W/T54W/T53W/T53/T53C Phones 5-DD MMM YYYY 6-WWW DD MMM 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 >...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones It enables or disables the handsets to keep user personalized settings after handset reboot or regis- tration. Description Note: It works only if "static.auto_provision.handset_configured.enable" is set to 0 (Disabled). It is only applicable to the custom handset related configurations.
Using DECT Handsets with T57W/T54W/T53W/T53/T53C Phones Parameter Related Topic custom.handset.screen_saver.enable Handset Screen Saver Configuration custom.handset.auto_intercom DECT Intercom Configuration custom.handset.language Handset Settings Parameters Handset Firmware Upgrade Configuration The following table lists the parameters you can use to upgrade handset firmware. Parameter over_the_air.url <y0000000000xx>.cfg Description It configures the access URL of the handset firmware file.
Page 167
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones 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 of firmware upgrade. If “over_the_air.handset_tip” is set to 0, you may go to Settings > Permitted Upgrade Firmware on the handset to trigger the upgrading manually.
Using DECT Handsets with T57W/T54W/T53W/T53/T53C Phones Note: The priority of parameter “over_the_air.url.t54w_dd10k” is higher than “over_the_air.url”. Permitted URL within 512 characters Values Default Blank Emergency Alarm Emergency alarm can provide safety reliance for people who work in dangerous environment. W59R handset supports the following four alarm types: Button: Long press the emergency alarm button for 2 seconds to manually set off the emergency alarm.
Page 169
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Default Blank Web UI Features > Alarm > Alarm Template (Alarm Template X) > Alarm Name Parameter alarm.X.type <y0000000000xx>.cfg Description It configures the alarm type. 0-None, do not turn on the alarm. 1-Button Permitted 2-Man Down...
Page 170
Using DECT Handsets with T57W/T54W/T53W/T53/T53C Phones Parameter alarm.X.ring.enable <y0000000000xx>.cfg Description It enables or disables to play the ringtone when the handset initiates the pre-alarm. 0-Disabled Permitted Values 1-Enabled Default Web UI Features > Alarm > Alarm Template (Alarm Template X) > Ring alarm.X.weekly.begin_time Parameter <y0000000000xx>.cfg...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Default Blank Web UI Account > Alarm Assignment > Sever Host Parameter alarm.server.port <y0000000000xx>.cfg Description It configures the port of the alarm server. Permitted Integer from 0 to 65535 Values Default 5060 Web UI...
Using DECT Handsets with T57W/T54W/T53W/T53/T53C Phones Line Keys Configuration The following table lists the parameters you can use to configure line keys for DD phones and CP935W-Base. [1][2] Parameter ddp.X.linekey.Y.type <y0000000000xx>.cfg Description It configures the key feature. 39-BLF List 0-N/A 15-Line Permitted Values...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Default Blank Supported DD Phone(Color Screen), CP935W-Base Devices DD Phone: Menu > Features > Dsskey > Line Key X > Label Phone UI CP935W: More > Features > Dsskey > Line Key X > Label [1][2] Parameter ddp.X.linekey.Y.extension <y0000000000xx>.cfg...
Page 174
Using DECT Handsets with T57W/T54W/T53W/T53/T53C Phones The phone displays a visual alert when any monitored user receives an incoming call. ddp.X.features.pickup.blf_visual.list = 4604,4605 The phone displays a visual alert when monitored user 4604 or 4605 receives an incoming call. ddp.X.features.pickup.blf_visual.list = List1 The phone displays a visual alert when any user in the List 1 receives an incoming call.
Page 175
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Devices X is the DDphone ID. X=1-8.
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 177
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Devices Web UI Features > Audio > Redial Tone Parameter account.X.dial_tone <MAC>.cfg Description It configures the dial tone for the phone. 0-Default (depend on the country tone by “voice.tone.country”) Permitted 1-440/250,0/250 Values 2-1000/250,0/250...
Audio Features More > Basic > Sound > Key Tone > Key Tone Black-and-white Screen Phones: Menu > Settings > Basic Settings > Sound > Key Tone > Key Tone X is the account ID. For T57W/T54W/T48U/T48S/T48G/T46U/T46S/T46G/T29G, X=1-16; for T53W/T53/T53C/T43U/T42G/T42U/T42S, X=1-12; for T41P/T41S/T27G, X=1-6; for T33P/T33G, X=1-4; for T40P/T40G/T23P/T23G, X=1-3;...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Phone Model Format Single File Size Color Screen Phones .wav <=8MB Black-and-white Screen Phones .wav <=100KB Note : The ring tone file must be in PCMU/PCMA audio format, mono channel, 8K sample rate, and 16-bit resolution. Ringtone Configuration The following table lists the parameters you can use to configure ringtone.
Page 180
Audio Features For T3 phones: Ring1.wav, Ring2.wav, Ring3.wav, Ring4.wav, Silent.wav, Splash.wav or custom ring tone name (for example, Customring.wav) Default Common Web UI Account > Basic > Ring Type Color Screen Phones: Menu > Basic > Sound > Ring Tones > AccountX CP925/CP935W: Phone UI More >...
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:...
Audio Features Topics Alert-Info: Bellcore-drN Alert-Info: ringtone-N/Alert-Info: ringtone-RingN.wav (or Alert-Info: MyMelodyN/Alert-Info: MyMelodyRingN.wav) Alert-Info: <URL> Alert-Info: info=info text;x-line-id=0 Alert-Info: Bellcore-drN When the Alter-Info header contains the keyword “Bellcore-drN”, the phone will play the desired ring tone. The following table identifies the corresponding ring tones: Ring Tone Ring Tone Value of N...
Page 183
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Ring Tone Ring Tone Value of N (features.alert_info_tone = 1) (features.alert_info_tone = 0) Splash.wav N<1 or N>6 Ring1.wav 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.
Audio Features Note: If the user is waiting for a call, “Bellcore-dr5” is a splash ring tone reminding the user that the DND or Always Call Forward feature is enabled on the server side. Alert-Info: ringtone-N/Alert-Info: ringtone-RingN.wav (or Alert-Info: MyMelodyN/Alert-Info: MyMelodyRingN.wav) When the Alter-Info header contains the keyword “ringtone-N/ringtone-RingN”...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Value of N Ring Tone Ring11.wav Ring12.wav Ring12.wav Ring13.wav Ring13.wav Silent.wav Silent.wav Splash.wav Splash.wav N<1 or N>15 Ring1.wav For T3 phones: Value of N Ring Tone Ring1.wav Ring1.wav Ring2.wav Ring2.wav Ring3.wav Ring3.wav Ring4.wav...
Audio Features Alert-Info: info=family;x-line-id=0 Alert-Info: <http://10.1.0.31>;info=family Alert-Info: <http://10.1.0.31>;info=family;x-line-id=0 Auto Answer If the INVITE request contains the following string types, the phone will answer incoming calls automatically without playing the ring tone: Alert-Info: Auto Answer Alert-Info: info = alert-autoanswer Alert-Info: answer-after = 0 (or Alert-Info: Answer-After = 0) Alert-Info: Intercom If the auto answer tone feature is enabled, the phone plays a warning tone to alert you before answering an incom- ing call.
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/T53C/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.
Audio Features It is not applicable to CP920/CP925/CP935W phones. 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”...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Supported T57W, T54W, T53W, T53, T53C, T48U, T46U, T43U, T42U, T48S, T46S, T42S, T41S, T33P, T33G, T31P, T31G, T31, T30P, T30, T27G, CP920, CP925, CP935W Devices Sending Volume Configuration You can configure the sending volume of currently engaged audio devices (handset, speakerphone or headset) when the phone is in use.
Page 190
Audio Features Note: We recommend that you modify this parameter cautiously. An unsuitable value may render the voice quality bad. Permitted Integer from -50 to 50 Values Default Supported All phones except CP920/CP925/CP935W 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.
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones over that configured by this parameter. 0-Disabled Permitted 1-Enabled, if the headset's volume level for the current call is adjusted to level 12/13/14/15, the Values volume level automatically resets to 11 after the call. That is, the initial volume level is 11 for the next call.
Audio Features United States Chile Czech ETSI Configured tones can be heard on the phones in the following conditions. Condition Description Dial When in the dialing interface Secondary When adding a comma “,” to the digit map (For more information on digit map, refer to Dial Plan Dial Defined by Digit Map (New Dial Plan...
Page 193
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones For other phones: A tone is comprised of at most four different frequencies. Duration: the duration (in milliseconds) of the dial tone, ranges from 0 to 30000ms. You can configure at most eight different tones for one condition, and separate them by commas. (for example, 250/200,0/1000,200+300/500,200+500+800+1500/1000).
Page 194
Audio Features It customizes the tone when the callee is busy. The value format is Freq/Duration. For more information on the value format, refer to the parameter “voice.tone.dial”. Description Note: It works only if “voice.tone.country” is set to Custom. If you want to disable this warning tone, set it to 0.
Page 195
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones The value format is Freq/Duration. For more information on the value format, refer to the parameter “voice.tone.dial”. Note: It works only if “voice.tone.country” is set to Custom. If you want to disable this warning tone, set it to 0.
Page 196
Audio Features Parameter voice.tone.autoanswer <y0000000000xx>.cfg It customizes the warning tone for the auto answer. The value format is Freq/Duration. For more information on the value format, refer to the parameter “voice.tone.dial”. Description Note: It works only if “voice.tone.country” is set to Custom. If you want to disable this warning tone, set it to 0.
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Supported T57W, T54W, T53W, T53, T53C, T33P, T33G, T31P, T31G, T31, T30P, T30, CP920, CP925, CP935W Devices Parameter voice.tone.stutter_dial_tone.apply_to_vm.enable <y0000000000xx>.cfg It enables or disables the phone to play a specified dial tone when the phone has a new voice mes- sage.
Page 200
Audio Features g723_63-G723(63 kbps) opus-Opus ilbc_15_2kpbs- iLBC(15.2kbps) ilbc_13_33kpbs-iLBC(13.33kbps) g729ab-G729AB(G729B) Example: account.1.codec.g722.enable = 1 Note: 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. Permitted 0-Disabled 1-Enabled...
Page 201
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones g722_1c_24kpbs-G.722.1c(24kb/s) (only for CP920/CP925/CP935W) g722_1_24kpbs-G.722.1(24kb/s) (only for CP920/CP925/CP935W) g722-G722 pcmu-PCMU(G.711μ) pcma-PCMA(G.711A) g729-G729(G729A) g726_16-G726(16 kbps) g726_24-G726(24 kbps) g726_32-G726(32 kbps) g726_40-G726(40 kbps) g723_53-G723(53 kbps) g723_63-G723(63 kbps) opus-Opus ilbc_15_2kpbs- iLBC(15.2kbps) ilbc_13_33kpbs-iLBC(13.33kbps) g729ab-G729AB 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.
Page 202
Audio Features When the audio codec is G723(53 kbps), the default value is 0; When the audio codec is G723(63 kbps), the default value is 0; When the audio codec is Opus, the default value is 0; When the audio codec is iLBC(15.2kbps), the default value is 0; When the audio codec is iLBC(13.33kbps), the default value is 0;...
Audio Features 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. 0-Disabled 10-10 20-20 Permitted 30-30 Values 40-40 50-50 60-60 Default Web UI Account >...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Parameter phone_setting.is_deal180 <y0000000000xx>.cfg It enables or disables the phone to deal with the 180 SIP message received after the 183 SIP mes- Description sage. 0-Disabled Permitted 1-Enabled, the phone will resume and play the local ringback tone upon a subsequent 180 message Values received.
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.
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones 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.
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.
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Jitter Buffer Configuration Jitter Buffer Configuration You can configure the mode of jitter buffer and the delay time for jitter buffer in the wired network or wireless net- work. The following table lists the parameters you can use to configure the jitter buffer. Parameter voice.jib.adaptive <y0000000000xx>.cfg Description It configures the type of jitter buffer in the wired network.
Audio Features Default Supported T57W, T54W, T53W, T53, T53C, T48U, T48S, T48G, T46U, T46S, T46G, T43U, T42U, T42S, T41S, Devices T29G, T27G, CP920, CP925, CP935W Parameter voice.jib.wifi.min <y0000000000xx>.cfg It configures the minimum delay time (in milliseconds) of the jitter buffer in the wireless network. Description Note: It works only if “voice.jib.wifi.adaptive”...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Values 1-Enabled Default Supported CP920, CP925, CP935W Devices Web UI Settings > Voice > Noise Proof > Smart Noise Block Acoustic Shield The acoustic shield feature is designed for background noise suppression when you are using the phone handset or a connected headset.
Audio Features 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). Topic Smart Noise Filtering Configuration Smart Noise Filtering Configuration...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones 1209 Hz 1336 Hz 1477 Hz 1633 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 214
Audio Features 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 Values...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones X is the account ID. For T57W/T54W/T48U/T48S/T48G/T46U/T46S/T46G/T29G, X=1-16; for T53W/T53/T53C/T43U/T42G/T42U/T42S, X=1-12; for T41P/T41S/T27G, X=1-6; for T33P/T33G, X=1-4; for T40P/T40G/T23P/T23G, X=1-3; for T31P/T31G/T31/T21(P) E2, X=1-2; for T30P/T30/T19(P) E2/CP920/CP925/CP935W, X=1. Suppress DTMF Display Suppress DTMF display allows the phones to suppress the display of DTMF digits during an active call.
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.
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones 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...
Page 218
Audio Features 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. Permitted 0-Disabled 1-Enabled Values Default Web UI Settings > Voice Monitoring > VQ RTCP-XR Session Report Parameter phone_setting.vq_rtcpxr.interval_report.enable <y0000000000xx>.cfg It enables or disables the phone to send an interval quality report to the central report collector peri-...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Permitted Integer from 15 to 40 Values Default Blank Web UI Settings > Voice Monitoring > Critical Threshold for Moslq Parameter phone_setting.vq_rtcpxr_delay_threshold_warning <y0000000000xx>.cfg It configures the threshold value of one-way delay (in milliseconds) that causes the phone to send a warning alert quality report to the central report collector.
Audio Features Note RTP Status : You can configure the softkey layout feature to display the soft key during the conference. Then you can RTP Status Softkey press the soft key to check the voice quality data with different parties. For more information, refer to Layout Topic VQ-RTCPXR Display Configuration...
Page 221
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Note: It works only if “phone_setting.vq_rtcpxr.states_show_on_gui.enable” is set to 1 (Enabled). Permitted 0-Disabled 1-Enabled Values Default Web UI Settings > Voice Monitoring > Report Options on Phone > Local User 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.
Page 222
Audio Features Default Web UI Settings > Voice Monitoring > Report Options on Phone > Jitter Buffer Max Parameter phone_setting.vq_rtcpxr_display_packets_lost.enable <y0000000000xx>.cfg It enables or disables the phone to display Packets lost on the phone screen. 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...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Central Report Collector To operate with the central report collector, the phones must be configured to forward their voice quality reports to the specified report collector. You can specify the report collector on a per-line basis. Topic Central Report Collector Configuration Central Report Collector Configuration...
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-...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /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...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Modify the characters within the double quotation marks on the right of the equal sign. Do not modify the item on the left of the equal sign. The following shows a portion of the language pack “000.GUI.English.lang” for the phone user interface: Save the language pack and place it to the provisioning server.
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.
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /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.
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”...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /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/T53C phones)/expansion module EXP43 (connected to the T48U/T46U/T43U phones).
Page 233
Phone Customization custom wallpaper name (for example, wallpaper.jpg) Default Default.jpg (Default.png for T46U) Supported All color screen phones Devices T57W/T54W/T53C/T48U/T46U/CP925/CP935W: Settings > Preference > Upload Wallpaper > System Wallpaper Web UI Other Phones: Settings > Preference > Wallpaper Menu > Basic > Display > Wallpaper Phone UI CP925/CP935W: More >...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Devices Web UI Settings > Preference > Wallpaper with Dsskey Unfold Phone UI Menu > Basic > Display > Dsskey Wallpaper Wallpaper Customization You can configure a custom picture, such as company logo, and then upload the custom picture to the IP phone that users can choose from when changing the wallpaper for the phone idle screen, expansion module or Dsskey screen.
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...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Values 20%, 40%, 60%, 80% or 100% Default 100% Supported T57W, T54W, T53C, T48U, T48S, T48G, T33P, T33G Devices Web UI Settings > Preference > Transparency Phone UI Menu > Basic > Display > Transparency Screen Saver The screen saver will automatically start when the IP phone is idle for the preset waiting time.
Phone Customization Topics Screensaver File Elements and Attributes 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...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Customizing the Screen Saver File 1. Open the screen saver file. 2. Modify settings as you want. 3. Save this file and place it to the provisioning server. 4. Specify the access URL of the screen saver file in the configuration file. Custom Screensaver Picture Limit Either the smaller or the larger picture will be scaled proportionally to fit the screen.
Page 239
Phone Customization 14400-4h 21600-6h 28800-8h 43200-12h Note: The permitted values for web/phone UI are Off, 30min, 1h, 2h, 4h, 6h (default), 8h, 12h. 15-15s 30-30s 60-1min 120-2min 300-5min 600-10min 900-15min 1200-20min 1800-30min 2700-45min 3600-1h 7200-2h Note: The permitted values for web/phone UI are 5min, 10min, 30min, 1h, 2h (default)). Default 21600 (7200 for CP925/CP935W) Web UI...
Page 240
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones CP925/CP935W: More > Basic > Display > Screensaver > Display Clock (not configurable when the Screensaver Type is set to Server XML) Parameter screensaver.type <y0000000000xx>.cfg Descrip- It configures the type of screen saver to display. tion 0-System, the LCD screen will display the built-in picture.
Page 241
Phone Customization 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 It configures the access URL of the screen saver XML file. Example: Descrip- screensaver.xml_browser.url = http://192.168.10.25/ScreenSaver.xml...
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...
Phone Customization 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) T53C(EXP50) T48U(EXP43) T48S/G(EXP40) Inactive Level (not applicable to EXP50/EXP43) T46U(EXP43) Active Level T46S/G(EXP40)
Page 244
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones T48S/T48G/T46S/T46G/T29G/T27G: Settings > Preference > Active Backlight Level Web UI T57W/T54W/T53W/T53/T53C/T48U/T46U/T43U/T42U/T33P/T33G/T31P/T31G/T31/CP925/CP935W: Settings > Preference > Active Level Color Screen Phones: Menu > Basic > Display > Backlight > Active Level CP925/CP935W: Phone UI More >...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones When label length feature is set to Mid Range (not applicable to T57W/T48U/T48S/T48G/T33P/T33G phones): Topic Label Length Display Configuration Label Length Display Configuration The following table lists the parameters you can use to configure the label length display. Parameter features.config_dsskey_length <y0000000000xx>.cfg Description It configures the label length displayed on the idle LCD screen for the line key.
Phone Customization Default Supported T54W, T46U, T46S, T46G, T29G Devices Label Alignment for Line/Ext Key Display You can customize the line/Ext key label alignment. This feature is only applicable to T54W/T53C/T46U/T46S/T46G/T33P/T33G/T29G phones and expansion module EXP50 (connected to the T57W/T54W/T53W/T53/T53C phones)/EXP43 (connected to the T48U/T46U/T43U phones).
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/T53C/T46U/T46S/T46G/T43U/T42U/T42S/T42G/T41P/T41S/T33P/T33G/T29G/T27G/CP925/CP93- 5W phones and expansion module EXP50/EXP43 support page switch key.
Phone Customization Phone Models LED Status Icons Description Fast-flashing: the BLF monitored user Fast-flashing receives an incoming call on the non-cur- rent page. Solid: there is a parked call to the line on CP925/CP935W Solid red the non-current page. Fast-flashing Fast-flashing: the line receives an incom- green ing call on the non-current page.
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...
Phone Customization daylight and to conserve energy, or you can set the time and date manually. The time and date can be displayed in several formats on the idle screen. Topics Time Zone NTP Settings DST Settings Time and Date Manually Configuration Time and Date Format Configuration Date Customization Rule Time Zone...
Page 252
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Time Zone Time Zone Name Time Zone Time Zone Name Chile(Easter Islands) East Africa Time Guadalajara Iraq(Baghdad) Monterrey Russia(Moscow) Mexico(Mexico City,Acapulco) St.Petersburg Saskatchewan Kuwait,Riyadh United States-Central Time Nairobi Bahamas(Nassau) Minsk Bogota,Lima Volgograd (RTZ 2) Canada(Montreal,Ottawa,Quebec)
Page 253
Phone Customization Time Zone Time Zone Name Time Zone Time Zone Name Montevideo Russia(Novosibirsk,Omsk) Salvador Bangladesh(Dhaka) Brazil(DST) +6:30 Myanmar(Naypyitaw) -2:30 Newfoundland and Labrador +6:30 Yangon (Rangoon) Brazil(no DST) Russia(Krasnoyarsk) Mid-Atlantic Thailand(Bangkok) Portugal(Azores) Vietnam(Hanoi) Cape Verde Islands Jakarta China(Beijing) Greenland Singapore(Singapore) Western Europe Time Hong Kong,Urumqi Monrovia...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Time Zone Time Zone Name Time Zone Time Zone Name West Central Africa Chokurdakh (RTZ 10) Poland(Warsaw) Russia(Srednekolymsk Time) Spain(Madrid) +11:30 Norfolk Island Croatia(Zagreb) New Zealand(Wellington,Auckland) Czech Republic(Prague) Fiji Islands Denmark(Kopenhagen) Russia(Kamchatka Time) France(Paris)
Page 255
Phone Customization Values 1-Enabled Default Web UI Settings > Time & Date > DHCP Time Color Screen Phones: Menu > Basic > Time & Date > DHCP Time CP925/CP935W: Phone UI More > Basic > Time & Date > DHCP Time Black-and-white Screen Phones: Menu >...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Permitted Integer from 15 to 86400 Values Default 1000 Web UI Settings > Time & Date > Update Interval (15~86400s) Parameter local_time.time_zone <y0000000000xx>.cfg Description It configures the time zone. -12 to +14 Permitted Values For available time zones, refer to...
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.
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Modify the DST settings for the existing time zone “+5 Pakistan(Islamabad)” and add DST settings for the exist- ing time zone “+5:30 India(Calcutta)”. 4. Save this file and place it to the provisioning server. Related Topic Time Zone DST Configuration...
Page 259
Phone Customization 0-DST by Date Permitted Values 1-DST by Week Default Web UI Settings > Time & Date > Fixed Type Parameter local_time.start_time <y0000000000xx>.cfg It configures the start 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:Minute-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...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones ward Default 12/31/23 Web UI Settings > Time & Date > End Date Parameter local_time.offset_time <y0000000000xx>.cfg It configures the offset time (in minutes) of Daylight Saving Time (DST). Description Note: It works only if “local_time.summer_time” is set to 1 (Enabled). Permitted Integer from -300 to 300 Values...
Page 261
Phone Customization format as required. The following table lists the parameters you can use to configure time and date format. Parameter local_time.time_format <y0000000000xx>.cfg Description It configures the time format. 0-Hour 12, the time will be displayed in 12-hour format with AM or PM specified. Permitted Values 1-Hour 24, the time will be displayed in 24-hour format (for example, 2:00 PM displays as 14:00).
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Black-and-white Screen Phones: Menu > Settings > Basic Settings > Time&Date > Time & Date Format > Date Format Parameter lcl.datetime.date.format <y0000000000xx>.cfg Description It configures the display format of the date. Any combination of Y, M, D, W and the separator (for example, space, dash, slash).
Since a logo is a visual entity signifying an organization or company, you can upload a custom logo or specify the logo text 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: It is not applicable to color screen phones.
: 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.
Description Note: It works only if "phone_setting.lcd_logo.mode" is set to 1 (System Logo). Permitted Combination of up to 7 letters Values Default Yealink Supported T31P, T31G, T31, T30P, T30 Devices Web UI Features > General Information > Logo Text Parameter lcd_logo.url <y0000000000xx>.cfg...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP 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 and the logo is loaded, the device will not exit the logo display page until you wake up Description the device.
Phone Customization 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 268
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Supported T46S, T48S, T46U, T48U, T53C, T54W, T57W, T33P, T33G Devices Get the picture from call-info and display it on the phone as the wallpaper while receiving/dialing a call, or during a call: Configure the call-info: Case Scen- ario...
Page 269
Phone Customization 4-Full Contact Info (display name<sip:xxx@domain.com>) Note: Name refers to the Label, Display Name (Label > Display Name > User Name); Number refers to the User Name. Default Parameter features.caller_name_type_on_call <y0000000000xx>.cfg Description It configures the local identity displayed when the phone receives an incoming call or is during a call. 0-Label, configured by the parameter “account.X.label”.
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones phone_setting.call_number_display.replace.pattern = ^(\d{3})(\d{3})(\d{4})$ phone_setting.call_number_display.replace.with = $1-$2-$3 ario Result: When the phone receives a call from number 1234567890, it will display the replaced num- ber 123-456-7890 on the ringing screen and talking screen. However, the phone still displays the call log entry 1234567890.
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 Parameter features.caller_name_type_on_dialing...
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.
Phone Customization Softkey Layout File Elements and Attributes Customizing Softkey Layout File Softkey Layout File Elements and Attributes The following table lists the elements and attributes you need to understand in the softkey layout file. We recom- mend that you do not edit these elements and attributes. Elements &...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /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 275
Phone Customization ralized call recording, and executive-assistant). 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- Values able. Default Parameter custom_softkey_call_failed.url <y0000000000xx>.cfg It configures the access URL of the custom softkey layout file in the CallFailed 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.
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.
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones File Name File Type Template File Description (* represents any char- acter) Lang keyboard_lang.xml keyboard_lang.xml Configures the language of the keyboard. Configures the alternative characters for keyboard_ime_en.xml English keyboard in alphabetic input mode.
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...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /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.
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 282
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones ish_LA, Turkish and Russian. Permitted URL within 511 characters Values Default Blank Supported All phones except CP925/CP935W Devices 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...
Phone Customization Supported All phones except CP925/CP935W Devices Parameter default_input_method.xml_browser_input_screen <y0000000000xx>.cfg It configures the default input method when the type for input box is set to “string” in the InputScreen object. Description Note: For T57W/T48U/T48S/T48G, it works only if "phone_setting.virtual_keyboard.enable" is set to 0 (Disabled).
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Customize the onscreen keyboard input method files “keyboard_lang.xml”, "keyboard_ime_francais.xml", "key- board_ime_num.xml", "keyboard_layout_francais.xml", "keyboard_layout_2.xml" and place these files to the pro- visioning server “http://192.168.10.25”. Example phone_setting.virtual_keyboard.enable = 1 gui_onscreen_keyboard.url = http://192.168.10.25/keyboard_lang.xml gui_onscreen_keyboard.url = http://192.168.10.25/keyboard_ime_francais.xml gui_onscreen_keyboard.url = http://192.168.10.25/keyboard_ime_num.xml gui_onscreen_keyboard.url = http://192.168.10.25/keyboard_layout_francais.xml...
Phone Customization It enables or disables the phone to pop up the message when it receives a new voice mail. If the message disappears, it will not pop up again unless the phone receives a new voice mail or the Description user re-registers the account that has unread voice mail(s).
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones The IP phone is busy The IP phone misses a call Topic Power LED Indicator Configuration Power LED Indicator Configuration The following table lists the parameters you can use to configure the power LED indicator. Parameter phone_setting.common_power_led_enable <y0000000000xx>.cfg Description It enables or disables the power LED indicator to be turned on.
Page 287
Phone Customization 0-Disabled (power LED indicator does not flash) 1-Enabled (power LED indicator slowly flashes (1s) yellow) 2-Enabled (if there are unread voice mails or text messages, the power LED indicator slowly flashes (1s) yellow even when the phone is busy, but value set by "phone_setting.talk_and_dial_power_led_ enable"...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones 1-Enabled (power LED indicator glows yellow) Default Supported All phones except CP920/CP925/CP935W Devices Web UI Features > Power LED > Talk/Dial Power Light On Parameter phone_setting.missed_call_power_led_flash.enable <y0000000000xx>.cfg Description It enables or disables the power LED indicator to flash when the phone misses a call. 0-Disabled (power LED indicator does not flash) 1-Enabled (power LED indicator slowly flashes (1s) red) Permitted...
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 291
Phone Customization Description It enables or disables the phone’s speakerphone mode. Permitted 0-Disabled Values 1-Enabled Default Supported All phones except CP920/CP925/CP935W Devices Parameter features.handset_mode.enable <y0000000000xx>.cfg Description It enables or disables the phone’s handset mode. Permitted 0-Disabled 1-Enabled Values Default Supported All phones except CP920/CP925 Devices Parameter features.group_listen_in_talking_enable...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones 0-Always use (pressing the Speakerphone key and picking up the handset are not effective when the Permitted headset mode is activated) Values 1-Use as normal Default Supported All phones except CP920/CP925 Devices DSS Keys There are three kinds of DSS keys: Line Keys, Programmable Keys, and Ext Keys.
Phone Customization Programmable Phone Model Line Keys Ext Keys Keys T30P/T30 T29G T27G T23P/T23G T19(P) E2 CP920 CP925 CP935W Note : The programmable key takes effect only if the phone is idle. The ext key takes effect only if the expansion module is connected to the phone. Supported Dsskey Types The supported Dsskey function types vary by line keys, programmable keys, and Ext keys.
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones DSS Key Types DSS Key Types DSS Key Types Intercom Prefix Line Zero Touch (Line key/Ext key) (Line key/Ext key) (Line key/Ext key) Local Group (Line key/Ext key) Group Listening Phone Lock (Line key/Ext key) (Line key/Ext key)
Page 295
Phone Customization 39-BLF List 40-Prefix 41-Zero Touch 42-ACD 45-Local Group 1-Conference 50-Phone Lock 2-Forward 56-Retrieve Park 16-BLF 3-Transfer 61-Directory 17-URL 4-Hold 66-Paging List 18-Group Listening 5-DND 72-Missed Call (only applicable to 20-Private Hold T57W/T54W/T53W/T53/T53C/T48U/T46U/T43U/T42U/ 7-Recall 22-XML Group T33P/T33G/T31P/T31G/T31/T30P/T30 phones) 8-SMS 23-Group Pickup 73-Custom Key (only available when “features.enhanced_ 9-Pickup(pick...
Page 296
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Menu > Features > Dsskey > Line Key X > Type CP925/CP935W: Phone UI Dsskey > Line Key X > Type Para- linekey.X.line <y0000000000xx>.cfg meter 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 297
Phone Customization tion This is an optional configuration. Permitted String within 99 characters Values Default Blank Supported All phones except T30P, T30, T19(P) E2 and CP920 Devices Web UI Dsskey > Line Key > Line KeyX > Label Menu > Features > Dsskey > Line Key X > Label CP925/CP935W: Phone UI Dsskey >...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Values Default Supported All phones except T30P, T30, T19(P) E2 and CP920 Devices Web UI Dsskey > Line Key > Line KeyX > Line Para- features.flash_url_dsskey_led.enable <y0000000000xx>.cfg meter It enables or disables the LED indicator of the URL DSS key. Descrip- The LED indicator behavior depends on the response message from the server when you press the tion...
Phone Customization linekey.3.value =4603 linekey.3.label =Retrieve Bill After provisioning, you can easily press the Park key (line key 1) to park a call to a specific extension (4603) during a call, and press the Retrieve key (line key 3) to retrieve the parked call from the specific extension (4603) when the phone is idle.
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones linekey.1.type = 9 linekey.1.line =1 linekey.1.value= 4603 linekey.1.label=Bill After provisioning, you can easily press the Directed Pickup key (line key 1) to pick up an incoming call to a specific phone (4603).
Phone Customization ######Set a Forward key for Bill###### linekey.1.type = 2 linekey.1.line =1 linekey.1.value =4603 linekey.1.label =Bill ######Set a Forward key for Tom###### linekey.2.type = 2 linekey.2.line =1 linekey.2.value =4605 linekey.2.label =Tom After provisioning, you can easily press the Forward key (line key 1 or line key 2) to activate/deactivate the always forward feature.
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Programmable Keys You can customize programmable keys on the phone to enable users to access frequently used functions, or, if your phone does not have a particular hard key, you can create a soft key. For example, if the phone does not have a Do Not Disturb hard key, you can create a Do Not Disturb soft key.
Phone Customization Programmable Keys Configuration For T23P/T23G/T21(P) E2 phones, Cancel key can be configured only when “features.keep_mute.enable” is set to 0 (Disabled). For other phones, Mute key can be configured only when “features.keep_mute.enable” is set to 0 (Disabled). The following table lists the parameters you can use to configure programmable keys. Parameter programablekey.type_range.custom <y0000000000xx>.cfg It configures the list for available programmable key types when configuring programmable keys.
Page 304
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones 310-DECT Intercom (only applicable to T57W/T54W/T53W/T53/T53C phones when the DECT USB dongle is connected) Note: The permitted values are configurable by “programablekey.type_range.custom”. The CP925/CP935W phones only support the following types: N/A (0), XML Browser (27), Dial (308), Bluetooth (309), History (28), Directory (29), Status (33).
Page 305
Phone Customization 102-PSTN2 Note: features.fwd_mode = 1 & programablekey.X.type =2 & programablekey.X.line =0: it means for- ward will apply to all lines on the phone; programablekey.X.type = 13 & programablekey.X.line =0: it means the phone can automatically switch accounts for speed dial; programablekey.X.type = 14 & pro- gramablekey.X.line =0: it means the phone can automatically switch accounts for intercom.
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones It specifies a specific group/phone book when multiple groups/phone books are configured on the IP phone. For, example, both Remote Phone Book 1 “Sell” and Remote Phone Book 2 “Market” are configured on the phone, you can configure “programablekey.X.xml_phonebook = 0”...
Page 307
Phone Customization Description It configures the feature for a specific ext key. 37-Switch (only applicable to ext key 1 for T29G/T27G phones) 38-LDAP (only appears when “ldap.enable=1”) 39-BLF List 40-Prefix 41-Zero Touch 0-N/A 42-ACD 15-Line 1-Conference 45-Local Group 16-BLF 2-Forward 50-Phone Lock 17-URL 3-Transfer...
Page 308
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones T53W/T53/T53C/T43U: 0, 1-12; T27G: 0, 1-6; Values Note: The permitted value 0 is configurable only when "features.fwd_mode" is set to 1 (Custom) and "expansion_module.X.key.Y.type" is set to 2 (Forward). Default Supported T57W, T54W, T53W, T53, T53C, T48U, T48S, T48G, T46U, T46S, T46G, T43U, T29G, T27G Devices...
Phone Customization Web UI Dsskey > Ext Key > Extension Parameter expansion_module.X.key.Y.xml_phonebook <y0000000000xx>.cfg It specifies a specific group/phone book when multiple groups/phone books are configured on the phone. For example, both Remote Phone Book 1 “Sell” and Remote Phone Book 2 “Market” are configured on the phone, you can configure “expansion_module.X.key.Y.xml_phonebook = 0”...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones If it is set to a value, the phone prompts users to enter the password when using the corresponding dsskey configured by "custom.features.dsskey_lock_type". Permitted String within 32 characters Values Default Blank (no prompt for entering the unlock password) Supported All phones except T48G, T46G, T42G, T41P and T29G...
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...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones EDK User Input Prompt Configuration EDK Soft Keys Configuration Example: Configuring EDK List for a Line Key Example: Using EDK Macro Strings as the Contact Number Guidelines for Configuring Enhanced DSS Keys The following guidelines will help you to configure EDK efficiently: Activation of EDK functions requires valid macro construction.
Page 313
Example: $Sanswer$ means pressing the Answer soft key. Yealink phones support customizing soft keys. When the phone invokes a cus- tom soft key, the prefix “#” must be added. Example: If the custom softkey label is IVR1, the custom softkey ID is custom_ macro, then $S#custom_macro$ means pressing the IVR1 soft key.
Page 314
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Macro Action Description Home (You can return to the idle screen by executing this command on the dialing screen for T57W/T48U/T48S/T48G phones) Example: $KDialPadPound$ means pressing the pound key. Note: If a key (for example, Redial key) is not found but the function is avail- able, the phone will perform the corresponding action.
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.
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones The following table lists the parameters you can use to configure EDK. Parameter features.enhanced_dss_keys.enable <y0000000000xx>.cfg Description It enables or disables the Enhanced DSS Keys (EDK) feature. Permitted 0-Disabled 1-Enabled Values Default Parameter edk.id_mode.enable <y0000000000xx>.cfg...
Phone Customization edk.edklist.2.mname = macro2 Note: If there are two or more same macros, the soft key or DSS key will invoke the macro with the smallest value of X. It works only if “features.enhanced_dss_keys.enable” is set to 1 (Enabled). Permitted String Values...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones It configures the type of characters entered by the user for user input prompt X. If it is set to numeric, the default input method is 123, and you can switch among abc/ABC/2aB input methods.
Page 319
Phone Customization Transfer ring back - There is a call being transferred to another phone. Moreover, the phone is in the ringback state. Hold – The call is placed on hold on the phone. Held – The call is held. Conference –...
Page 320
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Note: It works only if “features.enhanced_dss_keys.enable” and “softkey.X.enable” are set to 1 (Enabled). Permitted String Values Default Blank Parameter softkey.X.softkey_id <y0000000000xx>.cfg It configures the softkey id for custom soft key X. Example: Description softkey.1.softkey_id = custom_macro1...
Page 321
Phone Customization Default Parameter softkey.X.use.on_talk <y0000000000xx>.cfg It enables or disables the custom soft key X to be displayed in the talking state. Description Note: It works only if “features.enhanced_dss_keys.enable” and “softkey.X.enable” are set to 1 (Enabled). Permitted 0-Disabled 1-Enabled Values Default Parameter softkey.X.use.call_failed <y0000000000xx>.cfg...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Default Parameter softkey.X.use.conferenced <y0000000000xx>.cfg It enables or disables the custom soft key X to be displayed in the conference state. Description Note: It works only if “features.enhanced_dss_keys.enable” and “softkey.X.enable” are set to 1 (Enabled).
Phone Customization Example: Using EDK Macro Strings as the Contact Number When you add a contact number in the local directory, LDAP, Remote phone book or XML phone book, you can use the EDK macro strings. Use one of the following formats when adding a contact number: Add an exclamation mark (!) prefix to the macro name, and then enclose them in parenthesis.
Page 324
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones User Input Extension Idle TimeOut: specify the idle timeout that applies after you use the IP phone (for example, press a key on the phone or pick up/hang up the handset). By default, the Office Hours Idle Timeout is much longer than the Off Hours Idle TimeOut.
Page 325
Phone Customization Values Default Supported All phones except T30P/T30/T19(P) E2 Devices Web UI Settings > Power Saving > Off Hour Idle TimeOut Parameter features.power_saving.user_input_ext.idle_timeout <y0000000000xx>.cfg It configures the minimum time (in minutes) to wait in the idle state - after using the phone - before the Description phone enters the power-saving mode.
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 327
Phone Customization Attributes Valid Values Description remote_directory_search ldap_search BroadSoft_directory_search BroadSoft_UC_search plcm_directory_search genband_directory_search MetaSwitch_directory_search MetaSwitch_calllog_search mobile_directory_search google_directory_search Local Contacts History Remote Phonebook LDAP Network Directories The display name of the directory list. BroadSoft Buddies display_name Note: We recommend that you do not edit this field. PhoneBook Personal Address Book Network Contacts...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones 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. <item id_name="local_directory_search"...
Phone Customization Permitted Integer greater than or equal to 0 Values Default Web UI Directory > Settings > Search Source List In Dialing Parameter search_in_dialing.remote_phone_book.enable <y0000000000xx>.cfg It enables or disables the phone to automatically search entries from the remote phone book, and dis- Description play results on the pre-dialing/dialing screen.
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.
Phone Customization Values Default Blank Supported T57W, T54W, T53C, 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 Account registration failed Provisioning credentials are wrong Network is unavailable...
T57W, T54W, T53W, T53, T53C, T48U, T46U, T43U, T42U, T48S, T46S, T42S, T41S, T33P, T33G, T31P, T31G, T31, T30P, T30, T27G, CP920, CP925, CP935W Devices Analog Headset Mode You can manually configure audio solutions for Yealink RJ headsets. Topic Analog Headset Mode Configuration Analog Headset Mode Configuration The following table lists the parameters you can use to configure analog headset mode.
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 (T30P/T30/T19(P) E2 phones only support registering one SIP account;...
Page 334
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Description It defines the activation status of the account. Permitted 0-Disabled 1-Enabled Values Default Web UI Account > Register > Line Active Color Screen Phones: Menu > Advanced (default password: admin) > Accounts > Account X > Activation CP925/CP935W: Phone UI More >...
Page 335
Account Settings Permitted String within 99 characters Values Default Blank Web UI Account > Register > Register Name Color Screen Phones: Menu > Advanced (default password: admin) > Accounts > Account X > Register Name CP925/CP935W: Phone UI More > Advanced (default password: admin) > Accounts > Account X > Register Name Black-and-white Screen Phones: Menu >...
Page 336
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Default Blank Web UI Account > Register > SIP Server Y > Server Host Color Screen Phones: Menu > Advanced (default password: admin) > Accounts > Account X > SIP ServerY CP925/CP935W: Phone UI More >...
Page 337
Account Settings CP925/CP935W: More > Advanced (default password: admin) > Accounts > Account X > Outbound ProxyY Black-and-white Screen Phones: Menu > Settings > Advanced Settings (default password: admin) > Accounts > Outbound ProxyY [1][2] Parameter account.X.outbound_proxy.Y.port <MAC>.cfg It configures the port of the outbound proxy server. Description Note: It works only if “account.X.outbound_proxy_enable”...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones X is the account ID. For T57W/T54W/T48U/T48S/T48G/T46U/T46S/T46G/T29G, X=1-16; for T53W/T53/T53C/T43U/T42G/T42U/T42S, X=1-12; for T41P/T41S/T27G, X=1-6; for T33P/T33G, X=1-4; for T40P/T40G/T23P/T23G, X=1-3; for T31P/T31G/T31/T21(P) E2, X=1-2; for T30P/T30/T19(P) E2/CP920/CP925/CP935W, X=1. Y is the server ID. For T57W/T54W/T53W/T53/T53C/T48U/T46U/T43U/T42U/T33P/T33G/T31P/T31G/T31/T30P/T30, Y=1-3;...
Account Settings Registration Settings Configuration The following table lists the parameters you can use to change the registration settings. Parameter account.X.enable_user_equal_phone <MAC>.cfg Description It enables or disables the phone to add “user=phone” to the SIP header of the INVITE message. Permitted 0-Disabled Values...
Page 340
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones 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" is set to 1 (Enabled)) Permitted 8-Genesys Values...
Account Settings 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 Default Parameter account.X.subscribe_expires_overlap <MAC>.cfg Description It configures the renewal time (in seconds) away from the subscription lease. Permitted Positive integer and -1 Values...
(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.
Account Settings 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 Server Redund- ancy on Yealink IP Phones.
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones 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 345
Account Settings 0-Disabled, the phone will not attempt to register to the secondary server, since the phone assumes that the primary and secondary servers share registration information. So the phone will directly send Permitted the requests to the secondary server. Values 1-Enabled, the phone will register to the secondary server first, and then send the requests to it.
Page 346
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Note: It works only if “account.X.sip_server.Y.address” is set to the domain name of the SIP server. 0-newRequests: all requests are sent to the primary server first, regardless of the last server that was used.
Page 347
Account Settings Values Default -1, the phone will invoke “account.X.sip_server.Y.retry_counts” to take effect. [1][2] Parameter account.X.outbound_proxy.Y.only_signal_with_registered <MAC>.cfg 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”...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones proxy server with different IP addresses when encountering a failover. Note: It works only if “account.X.outbound_proxy.Y.failback_mode” is set to 1, 2 or 3. 0-Disabled Permitted 1-Enabled, the phone will immediately re-subscribe to the secondary outbound proxy server, for ensur- Values ing the normal use of the features associated with a subscription (for example, BLF, SCA).
Account Settings Default Web UI Account > Register > SIP Server Y > Transport Parameter account.X.naptr_build <MAC>.cfg It configures the way of SRV query for the phone to be performed when no result is returned from the Description NAPTR query. 0-SRV query using UDP only Permitted Values...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Behave with a Configured DNS Server Static DNS Cache Configuration Behave with a Configured DNS Server When the phone is configured with a DNS server, it will behave as follows to resolve the domain name of the server: The phone performs a DNS query to resolve the domain name from the DNS server.
Page 351
Account Settings It configures the preference of NAPTR record X. Description NAPTR record with lower preference is more preferred. Permitted Integer from 0 to 65535 Values Default Parameter dns_cache_naptr.X.replace <y0000000000xx>.cfg Description It configures a domain name to be used for the next SRV query in NAPTR record X. Permitted Domain name Values...
Page 352
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones It configures the weight of the target host in SRV record X. Description When priorities are equal, weight is used to differentiate the preference. Higher weight is more pre- ferred. Permitted Integer from 0 to 65535 Values...
Account Settings use the DNS address obtained by DHCP. 2-The DNS list is composed of dynamic DNS + static DNS. Use the DNS obtained by DHCP first, and then use the static DNS when the dynamic DNS is invalid. Default Parameter static.network.wifi.dns_list.mode <y0000000000xx>.cfg Description It configures the DNS query mode in the wireless network.
Page 354
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Default Supported All phones except CP920 Devices Parameter hotdesking.startup_username_enable <y0000000000xx>.cfg It enables or disables the phone to provide an input field of user name on the logon wizard after star- tup when there is no registered account.
Account Settings Default Supported All phones except CP920 Devices 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 356
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones figured by the parameter “account.X.phone_setting.call_appearance.transfer_via_new_linekey” takes precedence over that configured by this parameter. Permitted 0-Disabled, the phone will transfer a call on the current line key. 1-Enabled Values Default Supported All phones except T30P, T30, T19(P) E2 and CP920 Devices Parameter account.X.phone_setting.call_appearance.transfer_via_new_linekey...
Account Settings Note: The number of the line keys is determined by “account.X.number_of_linekey”. The value con- figured by this parameter takes precedence over that configured by the parameter “phone_set- ting.call_appearance.conference_via_new_linekey”. 0-Disabled, the phone will place a new call using the current line key when pressing the Conf/Con- ference soft key.
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Default {L}_{1} Supported All phones except T30P, T30, 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/T53C/T43U/T42U/T42G/T42S, X=1-12; for T41P/T41S/T27G, X=1-6; for T33P/T33G, X=1-4; for T40P/T40G/T23P/T23G, X=1-3;...
Page 359
Account Settings Default Parameter features.linekey_call_with_default_account <y0000000000xx>.cfg It enables or disables the phone to switch the default account when pressing the line key to dial. Description For example, the account on line 2 is not the default account, if this feature is enabled, when pressing the line key 2 to dial, the default account will switch to the account on line 2.
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.
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Preparing the Tar Formatted File This section provides you on how to package the tar file using 7-Zip. 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:...
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 363
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Elements Attributes Description Specify the group name. display_name For example All Contacts, Blocklist or Friend Specify a ringtone for the group. System ring tone: Auto group Silent.wav ring Splash.wav RingN.wav (integer N ranges from 1 to 8) Custom ring tone: Name.wav (the custom ring tone should be uploaded in advance) Specify the contact name.
Directory Elements Attributes Description RingN.wav (integer N ranges from 1 to 8) Custom ring tone: XX.wav (for example, Music.wav, the custom ring tone should be uploaded in advance) Specify which group the contact adds to. Built-in group: group_id_name All Contacts, Blocklist Custom group: XXX (for example, Friend) Built-in avatar:...
Page 365
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Note: If "static.auto_provision.local_contact.backup.enable" is set to 1 (Enabled), the contacts in the contact file “contact.xml” downloaded from the provisioning server do not take effect. Permitted URL within 511 characters Values Default Blank Web UI...
Directory Example: local_contact.image.url = tftp://192.168.10.25/photo.tar Permitted URL within 511 characters Values Default Blank Supported All color screen phones (except T33P/T33G) Devices Parameter local_contact.data_photo_tar.url <y0000000000xx>.cfg It configures the access URL of the compressed TAR file consisting of the avatars TAR file and con- tact XML file.
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.
Directory Example: static.auto_provision.local_contact.backup.path = http://192.168.1.20/contact Once the contacts update, the phone will upload the contact file to the specified path “http://192.168.1.20/contact”. During auto provisioning, the phone downloads the contact file “<MAC>-contact.xml” from the spe- cified path “http://192.168.1.20/contact”. Note: It works only if “static.auto_provision.local_contact.backup.enable” is set to 1 (Enabled). Permitted String Values...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones In the Favorites directory: On the idle screen: Topic Favorites Configuration Favorites Configuration The following table lists the parameters you can use to configure the favorites. Parameter local_contact.favorite.enable <y0000000000xx>.cfg Description It enables or disables the Favorites feature. 0-Disabled Permitted Values...
Directory Note: It works only if “local_contact.favorite.enable” is set to 1 (Enabled). To assign Ext key, make sure the expansion module has been connected to the phone in advance. 0 - linekey > exp1 key > … > expN key 1 - exp1 key >...
Microsoft Active Directory Sun ONE Directory Server Open LDAP Directory Server Microsoft Active Directory Application Mode (ADAM) For more information on LDAP, refer to LDAP Directory on Yealink IP Phones Topics LDAP Attributes Securely Storing the LDAP Credentials LDAP Configuration LDAP Attributes The following table lists the most common attributes used to configure the LDAP lookup on the phones.
Directory Abbreviation Name Description 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. When the user logs into the guest profile next time, he/she can access the LDAP directory directly instead of entering the LDAP user credentials again.
Page 373
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones ldap.name_filter = (!(cn=%)) When the cn of the LDAP contact does not match the entered name, the records will be displayed on the phone screen. Permitted String within 512 characters Values Default Blank...
Page 374
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 512 characters Values Default...
Page 375
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Default Blank T57W/T54W/T53W/T53/T53C/T48U/T46U/T43U/T42U/CP925/CP935W: Directory > LDAP > LDAP Password Web UI Other Phones: Directory > LDAP > Password Parameter ldap.max_hits <y0000000000xx>.cfg Description It configures the maximum number of search results to be returned by the LDAP server. Permitted Integer from 1 to 1000 Values...
Page 376
Directory user0005 2598 user0006 3598 user0007 4598 user0008 18954125624 Web UI Directory > LDAP > LDAP Number Attributes Parameter ldap.display_name <y0000000000xx>.cfg It configures the display name of the contact record displayed on the phone screen. The value must start with a “%” symbol. Description Example: ldap.display_name = %cn...
Page 377
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Default Web UI Directory > LDAP > LDAP Sorting Results Parameter ldap.incoming_call_special_search.enable <y0000000000xx>.cfg It enables or disables the phone to search the telephone numbers starting with ”+” symbol and “00” from the LDAP server if the incoming phone number starts with”+”...
Page 378
Directory Default Blank Supported T57W, T54W, T53C, T48U, T48S, T46U, T46S Devices Parameter ldap.display_extra_attr <y0000000000xx>.cfg It configures the extra attributes list of each record to be displayed on the phone. The attribute must start with a “%” symbol. Multiple attributes are separated by spaces. Example: Description ldap.display_extra_attr = %title %lang...
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.
Directory The Menu.xml file defines the group/department of a remote phone book. The Department.xml file defines contact lists for a department/group, which is nested in Menu.xml file. The following table lists the elements you can use to add groups or contacts in the remote phone book file. We recommend that you do not edit these elements.
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones <Name > Market</Name> <URL > http://192.168.0.1:99/Market.xml</URL> </MenuItem> <SoftKeyItem> <Name>1</Name> <URL>http://192.168.0.1:99/Propaganda.xml</URL> </SoftKeyItem> 5. Save Menu.xml file and place it to the provisioning server. Remote Phone Book Configuration The following table lists the parameters you can use to configure the remote phone book. Parameter remote_phonebook.data.X.url <y0000000000xx>.cfg It configures the access URL of the remote phone book.
Customize the “Department.xml “and “Menu.xml“ files, and then place these files to the provisioning server “http://192.168.10.25”. Example remote_phonebook.data.1.url = http://192.168.10.25/Menu.xml remote_phonebook.data.1.name = Yealink remote_phonebook.data.2.url = http://192.168.10.25/Market.xml remote_phonebook.data.2.name = Market After provision, you can go to Menu > Directory > Remote Phone Book to access the corporate directory straight...
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...
Directory Attributes Valid Values Description History Network CallLog Remote Phone Book LDAP Network Directories PhoneBook Global Address Book Personal Address Book Note: We recommend that you do not edit Network Contacts this field. Network Directories and Network name CallLog lists are hidden for phones in GA Network Call List firmware, GA firmware which is designed for the BroadWorks environment.
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones 3. Save the change and place this file to the provisioning server. Directory List Configuration The following table lists the parameters you can use to configure the directory list. Parameter static.directory_setting.url <y0000000000xx>.cfg Description It configures the access URL of the custom directory file (favorite_setting.xml).
Directory Default Parameter directory_setting.remote_phone_book.priority <y0000000000xx>.cfg Description It configures the display priority of the remote phone book. Permitted Integer greater than or equal to 0 Values Default Parameter directory_setting.ldap.enable <y0000000000xx>.cfg Description It enables or disables the users to access the LDAP by pressing the Directory/Dir soft key. Permitted 0-Disabled Values...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Directory Search Settings Configuration The following table lists the parameters you can use to configure directory search settings. Parameter directory.search_type <y0000000000xx>.cfg It configures the search type when searching the contact in Local Directory, Remote Phone Book, Net- Description work Directory or Blocklist.
Directory Number Matching Settings Configuration The following table lists the parameters you can use to configure number matching settings. Parameter phone_setting.reverse_lookup.contact_list.replace.pattern <y0000000000xx>.cfg It configures the matching pattern used to identify the replaced string of the contact number / blocklist Description number.
"+49123456" will be replaced with "123456". Then the phone rejects the call from the phone number "+49123456". Enterprise Directory Yealink phones support enterprise directory to meet the needs of Huawei's corporate communications market. Topics Enterprise Directory Configuration Enterprise Directory Configuration The following table lists the parameter that the phone can use to configure enterprise directory.
Page 390
Directory Devices Parameter features.enterprise_directory.host <y0000000000xx>.cfg It configures the IP address of the enterprise directory server. You need to configure the complete address (port is required), such as: https://11.11.182.202/ser- Description vices:443. Note: It works only if "features.enterprise_directory.enable" is set to 1 (Enabled). Permitted String Values...
Page 391
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Parameter features.enterprise_directory.password <y0000000000xx>.cfg It configures the password used for authentication of the enterprise directory. Description Note: It works only if "features.enterprise_directory.authentication_type" is set to 1. Permitted String Values Default Blank Supported T57W, T54W, T53W, T53, T53C, T48U, T46U, T43U, T42U, T33P, T33G, T31P, T31G, T31, T30P, T30 Devices...
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 393
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /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 394
Call Log It enables or disables the phone to indicate what happened to the call in the call log lists. It is applicable to the following scenarios: Reject an incoming call Forward an incoming call Description The outgoing call is rejected Transfer a call Answer a transferred/forwarded call from the remote party;...
Page 395
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 396
Call Log Permitted String Values 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...
It is only applicable to W90 multi-cell system. 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. Dial now: is a string used to match numbers entered by the user. When entered numbers match the predefined dial now rule, the phone will automatically dial out the numbers without pressing the send key.
The replace rule file helps create multiple replace rules. At most 100 replace rules can be added to the IP phone. You can ask the distributor or Yealink FAE for the replace rule file template. You can also obtain the replace rule file template online: http://support.yealink.com/documentFront/forwardToDocumentFrontDisplayPage.
The dial now file helps create multiple dial now rules. At most 100 dial now rules can be added to the IP phone. You can ask the distributor or Yealink FAE for dial now file template. You can also obtain the dial now file template online: http://support.yealink.com/documentFront/forwardToDocumentFrontDisplayPage.
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Customizing the Dial Now File 1. Open the dial now file. 2. To add a dial-now rule, add <Data DialNowRule="" LineID="" /> to the file. Each starts on a new line. 3.
Call Features Default Blank 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.
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Default Blank 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. When entered numbers match the predefined dial now rule, the phone will automatically dial out the entered number after the designated delay time.
Call Features Permitted String within 16 characters Values Default Blank Web UI Settings > Dial Plan > Area Code > Code Parameter dialplan.area_code.min_len <y0000000000xx>.cfg It configures the minimum length of the entered number. Description Note: It works only if “dialplan.digitmap.enable” and “account.X.dialplan.digitmap.enable” are set to 0 (Disabled).
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Example: dialplan.block_out.number.1 = 4321 When you dial the number “4321” on your phone, the dialing will fail and the phone screen will prompt "Forbidden Number". Note: It works only if “dialplan.digitmap.enable” and “account.X.dialplan.digitmap.enable” are set to 0 (Disabled).
Call Features Topics Basic Regular Expression Syntax for Digit Map Digit Map for All Lines Configuration Digit Map for a Specific Line Configuration Basic Regular Expression Syntax for Digit Map You need to know the following basic regular expression syntax when creating a new dial plan: The timer letter “T”...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Example: “<9,:55>xx”, after entering digit “9”, secondary dial tone plays and you can complete the remaining two- digit number. Note: The secondary dial tone can be customized. For more information, refer to Tones. The letter “A”...
Page 407
Call Features 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 408
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones 2-allow users to accumulate digits and dispatch call manually with the send key or automatically dial out the entered number after a certain period of time configured by the parameter “dial- plan.digitmap.interdigit_long_timer”...
Call Features takes precedence over that configured by this parameter. 0-Disabled Permitted 1-Enabled, the incoming calls will be forwarded to the desired destination number according to the Values string of the digit map. Default Parameter dialplan.digitmap.apply_to.press_send <y0000000000xx>.cfg It enables or disables the entered number to match the predefined string of the digit map after press- ing a send key.
Page 410
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Values Default Blank Parameter account.X.dialplan.digitmap.interdigit_long_timer <MAC>.cfg It configures the time (in seconds) to wait before dialing an entered number if it matches part of any string of the digit map for the account X. If it is set to 0, the phone will not dial the entered number if only a partial match exists.
Page 411
Call Features Example: account.1.dialplan.digitmap.interdigit_short_timer = 4|5|3|6|2|1 If “dialplan.digitmap.string” is set to <[2-9]x:86 > 3.T|2T|1xxT|0x.!|[2-9]11T, 4 is applied to the “<[2- 9]x:86 > 3.T” digit map, 5 is applied to “2T” digit map, 3 is applied to “1xxT” digit map, 6 is applied to “0x.!”...
You can dial the emergency telephone number (emergency services number) at any time when the IP phone is powered on and has been connected to the network. It is available even if your phone keypad is locked or no SIP account is registered. Yealink phones support emergency dialplan and enhanced 911. Emergency Dial Plan...
Call Features 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. Multiple emergency servers may need to be con- figured for emergency routing, avoiding that emergency calls could not get through because of the server failure.
Page 414
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones T33P/T33G: Integer from 1 to 4; T40P/T40G/T23P/T23G: Integer from 1 to 3; T31P/T31G/T31/T21(P) E2: Integer from 1 to 2; T30P/T30/T19(P) E2/CP920/CP925/CP935W: 1. Default Parameter dialplan.emergency.custom_asserted_id <y0000000000xx>.cfg It configures the custom outbound identity when placing an emergency call. Description Note: It works only if “dialplan.emergency.enable”...
Page 415
Call Features 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 416
If it is set to REDSKY, the phone will send the location request message defined by REDSKY. Values If it is set to YEALINK, the phone will send the location request message defined by REDSKY and the <ChassisID>, </PortID> fields.
Page 417
Call Features It configures the password authentication when the phone sends location information to the E911 Location Information Server. Description Note: It works only if “dialplan.emergency.held.request_type” is set to YEALINKor REDSKY. Permitted String Values Default Blank Supported T57W, T54W, T53W, T53, T53C, T48U, T46U, T43U, T42U, T33P, T33G, T31P, T31G, T31, T30P, T30 Devices Parameter dialplan.emergency.held.secondary.username <y0000000000xx>.cfg...
Page 418
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Default Supported T57W, T54W, T53W, T53, T53C, T48U, T46U, T43U, T42U, T33P, T33G, T31P, T31G, T31, T30P, T30 Devices Parameter dialplan.emergency.held.prompt_enable <y0000000000xx>.cfg It enables or disables the phone to pop up the "Set E911 location failed! Please contact your admin- istrator."...
Page 419
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.
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Topic Hotline Configuration Hotline Configuration The following table lists the parameters you can use to configure hotline. Parameter features.hotline_number <y0000000000xx>.cfg It configures the hotline number that the phone automatically dials out when you lift the handset, press the Speakerphone/off-hook key or the line key.
Call Features Menu > Features > Hot Line > Hotline Delay Off Hook Hot Line Dialing For security reasons, the phones support off hook hot line dialing feature, which allows the phone to automatically dial out the pre-configured number when you lift the handset, press the Speakerphone key or desired line key. The SIP server may then prompts you to enter an activation code for call service.
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Live Dialpad Live Dialpad allows the phones to automatically dial out the entered phone number without pressing the send key after a designated period of time. Topic Live Dialpad Configuration Live Dialpad Configuration The following table lists the parameters you can use to configure live dialpad.
Page 423
Call Features Menu > Features > Others > Auto Redial > Auto Redial CP925/CP935W: More > Features > Auto Redial Setting > Auto Redial Black-and-white Screen Phones: Menu > Features > Auto Redial > Auto Redial Parameter auto_redial.interval <y0000000000xx>.cfg It configures the interval (in seconds) for the phone to wait between redials. Description The phone redials the last dialed number at regular intervals untill the callee answers the call.
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones 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...
Call Features 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.
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Topic 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.
Page 427
Call Features Default Web UI Account > Basic > Send Anonymous Code Menu > Features > Anonymous Call > Line X > Send Anonymous Code (Send Anony Code) Phone UI CP925/CP935W: More > Features > Anonymous Call > Line X > 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.
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Description It enables or disables to synchronize the anonymous call status between the IP phone and the server. Permitted 0-Disabled 1-Enabled Values Default X is the account ID. For T57W/T54W/T48U/T48S/T48G/T46U/T46S/T46G/T29G, X=1-16; for T53W/T53/T53C/T43U/T42G/T42U/T42S, X=1-12;...
Call Features Values 1-Enabled Default Web UI Features > General Information > Allow IP Call Ignoring Incoming Calls By default, when a phone receives an incoming call, the phone screen prompts the incoming call information. You should handle the incoming call first before performing other features. For example, you should handle the incom- ing call when there is an active call in progress, otherwise, you cannot hold or set up a conference on the current call.
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 431
Call Features More > Features > Auto Answer > Line X > Auto Answer Black-and-white Screen Phones: Menu > Features > Auto Answer > Status Parameter account.X.auto_answer_mute_enable <MAC>.cfg It enables or disables the auto answer mute feature. Note: It works only if the values of parameters “account.X.auto_answer” and “features.allow_mute” Description are set to 1 (Enabled).
Page 432
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones T48G/T46G/T42G/T41P/T29G: Integer from 1 to 4 Permitted Values Other Phones: Integer from 1 to 60 Default Web UI Features > General Information > Auto Answer Delay Parameter features.auto_answer_tone.enable <y0000000000xx>.cfg It enables or disables the phone to play a warning tone when an incoming call is automatically answered.
Call Features Default Parameter pstn.account.X.auto_answer <MAC>.cfg It enables or disables the auto answer feature for PSTN account X. Description Note: The IP phone cannot automatically answer the incoming call during a call even if the auto answer is enabled. 0-Disabled Permitted Values 1-Enabled, the phone can automatically answer an incoming call.
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Topic Anonymous Call Rejection Configuration Anonymous Call Rejection Configuration The following table lists the parameters you can use to configure anonymous call rejection. Parameter account.X.reject_anonymous_call <MAC>.cfg Description It triggers the anonymous call rejection feature to on or off. 0-Off Permitted 1-On, the phone will automatically reject incoming calls from users enabled anonymous call feature.
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.
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones More > Features > Call Waiting > Call Waiting Parameter call_waiting.tone <y0000000000xx>.cfg It enables or disables the phone to play the call waiting tone when the phone receives an incoming call during a call.
Call Features You can also temporarily activate DND during calls, the new incoming calls are rejected automatically. After ending the call, the DND is deactivated automatically. It prevents from interrupting during current calls and avoids missing calls after calls end. Topics DND Settings Configuration DND Feature Configuration...
Page 438
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones 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”.
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...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Default Blank Web UI Features > Forward&DND > DND > On Code Menu > Features > DND > On Code Phone UI CP925/CP935W: More > Features > DND > On Code Parameter features.dnd.off_code <y0000000000xx>.cfg It configures the DND off code to deactivate the server-side DND feature.
Call Features Web UI Features > Forward& DND > DND > AccountX > On Code Phone UI Menu > Features > DND > AccountX > On Code Parameter account.X.dnd.off_code <MAC>.cfg It configures the DND off code to deactivate the server-side DND feature. The phone will send the DND off code to the server when you deactivate the DND feature on the phone.
Page 442
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Devices Parameter features.dnd.feature_key_sync.enable <y0000000000xx>.cfg It enables or disables the DND feature synchronization. Description Note: It works only if “features.feature_key_sync.enable” is set to 1 (Enabled). 0-Disabled Permitted Values 1-Enabled, server-based DND is enabled. Server and local phone DND are synchronized. Default Supported All phones except CP920/CP925/CP935W...
Call Features Multiple Call Appearances You can enable each registered line to support multiple concurrent calls. For example, you can place one call on hold, switch to another call on the same registered line, and have both calls displayed. You can set the maximum number of concurrent calls per line key on all-lines basis or a per-line basis. For example, if you specify 3 concurrent-calls for account 1, you can only have three call appearances on a cor- responding line key.
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones X is the account ID. For T57W/T54W/T48U/T48S/T48G/T46U/T46S/T46G/T29G, X=1-16; for T53W/T53/T53C/T43U/T42U/T42G/T42S, X=1-12; for T41P/T41S/T27G, X=1-6; for T33P/T33G, X=1-4; for T40P/T40G/T23P/T23G, X=1-3; for T31P/T31G/T31/T21(P) E2, X=1-2. Call Hold Call hold provides a service of placing an active call on hold. It enables you to pause activity on an active call so that you can use the phone for another task, for example, to place or receive another call.
Page 445
Call Features Web UI Features > General Information > Play Hold Tone Parameter features.play_hold_tone.delay <y0000000000xx>.cfg It configures the time (in seconds) to wait for the phone to play the initial call hold tone. If it is set to 30 (30s), the phone will wait 30 seconds to play the initial call hold tone after you place a Description call on hold.
It configures the address of the Music On Hold server. Examples for valid values: <10.1.3.165> , 10.1.3.165, sip:moh@sip.com, <sip:moh@sip.com> , Description <yealink.com > or yealink.com. Note: The DNS query in this parameter only supports A query. Permitted SIP URI within 256 characters...
E2/CP920/CP925/CP935W, 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. Muting before a call is answered prevents the other party from hearing the local discussion.
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Keep Mute Configuration The following table lists the parameter you can use to enable or disable keep mute. Parameter features.keep_mute.enable <y0000000000xx>.cfg It configures the keep mute feature. Description Note: It works only if “features.allow_mute” is set to 1 (Enabled). 0-The mute feature is automatically deactivated when the active call ends.
Call Features Default Supported CP920, CP925, CP935W 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 during the call. Permitted Integer from 3 to 3600 Values Default Supported...
Page 450
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones 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 Web UI Features > Forward&DND > Forward > Mode Parameter features.forward.emergency.enable <y0000000000xx>.cfg It enables or disables the phone to receive the call from authorized numbers when the call forward fea-...
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 452
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones (Phone) . 0-Off Permitted 1-On, incoming calls are forwarded to the destination number (configured by the parameter “for- Values ward.always.target”) immediately. Default Web UI Features > Forward&DND > Forward > Always Forward > On/Off Menu >...
Page 453
Call Features Values Default Blank Web UI Features > Forward&DND > Forward > Always Forward > Off Code Menu > Features > Call Forward > Always Forward > Off Code Phone UI CP925/CP935W: More > Features > Call Forward > Always Forward > Off Code Parameter forward.busy.enable <y0000000000xx>.cfg It triggers the busy forward feature to on or off on a phone basis.
Page 454
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Web UI Features > Forward&DND > Forward > Busy Forward > On Code Menu > Features > Call Forward > Busy Forward > On Code Phone UI CP925/CP935W: More > Features > Call Forward > Busy Forward > On Code Parameter forward.busy.off_code <y0000000000xx>.cfg It configures the busy forward off code to deactivate the server-side busy forward feature.
Page 455
Call Features Parameter forward.no_answer.timeout <y0000000000xx>.cfg It configures ring times (N) to wait before forwarding incoming calls. The incoming calls will be forwarded when not answered after N*M (M is configurable by “phone_set- ting.ring_duration”) seconds. Description Note: It works only if “features.fwd.allow” is set to 1 (Enabled) and “features.fwd_mode” is set to 0 (Phone) .
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones CP925/CP935W: More > Features > Call Forward > No Answer Forward > On Code Parameter forward.no_answer.off_code <y0000000000xx>.cfg It configures the no answer forward off code to deactivate the server-side no answer forward feature. The phone will send the no answer forward off code to the server when you deactivate the no answer Description forward feature on a phone basis.
Page 457
Call Features Phone UI Menu > Features > Call Forward > AccountX > Always Forward > Forward to Parameter account.X.always_fwd.on_code <MAC>.cfg It configures the always forward on code to activate the server-side always forward feature. The phone will send the always forward on code and the pre-configured destination number (con- figured by the parameter “account.X.always_fwd.target”) to the server when you activate always for- Description ward feature on the phone.
Page 458
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Note: It works only if “features.fwd.allow” is set to 1 (Enabled) and “features.fwd_mode” is set to 1 (Custom). Permitted String within 32 characters Values Default Blank Supported All phones except T30P, T30, T19(P) E2, CP920, CP925 and CP935W Devices Web UI Features >...
Page 459
Call Features meter “account.X.timeout_fwd.target”) after a period of ring time. Default Supported All phones except T30P, T30, T19(P) E2, CP920, CP925 and CP935W Devices Web UI Features > Forward&DND > Forward > AccountX > No Answer Forward > On/Off Phone UI Menu >...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Devices Web UI Features > Forward&DND > Forward > AccountX > No Answer Forward > On Code Phone UI Menu > Features > Call Forward > AccountX > No Answer Forward > On Code Parameter account.X.timeout_fwd.off_code <MAC>.cfg It configures the no answer forward off code to deactivate the server-side no answer forward feature.
Page 461
Call Features Default Blank Supported All phones except T48G, T46G, T42G, T41P, T29G, CP920, CP925 and CP935W Devices Parameter features.forward.feature_key_sync.enable <y0000000000xx>.cfg It enables or disables the forward feature synchronization. Description Note: It works only if “features.feature_key_sync.enable” is set to 1 (Enabled). 0-Disabled Permitted 1-Enabled, server-based call forward is enabled.
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 463
Call Features Default Parameter features.transfer_keep_session2_after_failed.enable <y0000000000xx>.cfg It enables or disables the phone to keep the original call status after the server rejects the semi-atten- Description ded/attended transfer. Permitted 0-Disabled 1-Enabled Values Default Parameter transfer.blind_tran_on_hook_enable <y0000000000xx>.cfg It enables or disables the phone to complete the blind transfer through on-hook besides pressing the Trans/Transfer soft key or TRAN/TRANSFER key.
All phones except T30P, T30, T19(P) E2 and CP920 Devices Web UI Features > Transfer > Transfer Mode via Dsskey Conference The Yealink phones support local conference and network conference. Topics Conference Type Configuration Local Conference Configuration Network Conference Configuration Conference Type Configuration You can specify which type of conference to establish.
E2/CP920/CP925/CP935W, 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 CP935W/CP925/CP920/T42U/T43U/T53/T53W/T33P/T33G/T31P/T31G/T31/T30P/T30 phones, 10 partes for T46U/T48U/T53C/T54W/T57W) (including yourself) in a local conference call.
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones 1-Enabled, the other two parties remain connected when the conference initiator drops the con- Values ference call. Default Web UI Features > Transfer > Transfer on Conference Hang up Parameter account.X.local_conf.transfer_mode <MAC>.cfg It enables or disables the phone to transfer the host to the other parties before the conference initiator drops the local conference call.
E2/CP920/CP925/CP935W, 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.
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.
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.
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.
Call Features Web UI Directory > Multicast IP > Multicast Listening > Channel X ranges from 1 to 31. Multicast Paging Settings You can configure some general settings for multicast paging, for example, specify a codec, configure the volume and audio device for listening to a paging call. By default, all the listening groups are considered with a certain priority from 1 (lower priority) to 31 (higher priority).
Page 472
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Parameter multicast.receive_priority.enable <y0000000000xx>.cfg It enables or disables the phone to handle the incoming multicast paging calls when there is an active Description multicast paging call on the phone. 0-Disabled, the phone will ignore the incoming multicast paging calls when there is an active mul- ticast paging call on the phone.
Page 473
Call Features Web UI Directory > Multicast IP > Ignore DND Parameter multicast.listen_address.X.volume <y0000000000xx>.cfg It configures the volume of the speaker when receiving the multicast paging calls. If it is set to 0, the current volume of the speaker takes effect. The volume of the speaker can be adjus- ted by pressing the Volume key in advance when the phone is during a call.
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 475
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /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.
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.
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /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/T53C/T43U/T42G/T42U/T42S, X=1-12; for T41P/T41S/T27G, X=1-6; for T33P/T33G, X=1-4; for T40P/T40G/T23P/T23G, X=1-3;...
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 479
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...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /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 482
Advanced Features Parameter features.call_park.park_mode <y0000000000xx>.cfg 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.
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Note: It works only if “features.call_park.park_mode” is set to 2 (Transfer). 0-Disabled, the call is parked by the current line, which is in call state. Permitted Values 1-Enabled Default Supported All phones except T30P/T30/T19(P) E2 Devices Parameter features.call_park.performby_holdhardkey.enable...
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 485
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /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...
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 T30P/T30/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...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Park and retrieve calls to the monitored line Initiate an outgoing intercom call to the monitored line Barging In an Active Call by BLF List Key Park the active call to the monitored users who are in the BLF list Topics BLF Key Configuration BLF List Configuration...
Page 488
Advanced Features Description It configures the feature access code that initiates a directed call pickup for account X. Permitted String within 32 characters Values Default Blank Supported All phones except T30P, T30, T19(P) E2 and CP920 Devices Web UI Account > Advanced > BLF List Pickup Code Parameter account.X.blf_list_barge_in_code <MAC>.cfg Description It configures the feature access code of directed call pickup with barge-in for account X.
Page 489
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones serial numbers of monitored users in the BLF list Default Blank Supported All phones except T48G, T46G, T42G, T41P, T30P, T30, T29G, T19(P) E2 and CP920 Devices Parameter account.X.blf_list_retrieve_call_parked_code <MAC>.cfg Description It configures the feature access code that initiates retrieval of a parked call on the monitored user.
The monitored line places a call on hold. A call is parked to the monitored line. The monitored line fails to register or does not exist. BLF/BLF List Subscription Yealink phones support BLF using a SUBSCRIBE/NOTIFY mechanism as specified in 3265. BLF Subscription...
The following example shows a NOTIFY message for a BLF List, the BLF List contains 4605 and 4607: <?xml version="1.0" <?xml version="1.0"?> <list xmlns="urn:ietf:params:xml:ns:rlmi" xmlns="urn:ietf:params:xml:ns:rlmi" version="0" fullState="true"> <resource uri="sip:4605@pbx.yealink.com"> <name > 4605 Yealink</name> <instance id="JQZxud2qeo" state="active" cid="8y35ri@broadworks"/> </resource> <resource uri="sip:4605@pbx.yealink.com">...
Page 492
Advanced Features Description It configures the event of the BLF subscription. 0-dialog Permitted Values 1-presence Default Supported All phones except T30P, T30, T19(P) E2 and CP920 Devices Parameter account.X.out_dialog_blf_enable <MAC>.cfg Description It enables or disables the phone to handle NOTIFY messages out of the BLF dialog. 0-Disabled Permitted Values...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones X is the account ID. For T57W/T54W/T48U/T48S/T48G/T46U/T46S/T46G/T29G, X=1-16; for T53W/T53/T53C/T43U/T42U/T42G/T42S, X=1-12; for T41P/T41S/T27G, X=1-6; for T33P/T33G, X=1-4; for T40P/T40G/T23P/T23G, X=1-3; for T31P/T31G/T31/T21(P) E2, X=1-2; for CP925/CP935W, X=1. Visual and Audio Alert for Monitor Lines Visual and Audio Alert feature allows the phone to display the caller ID and play an audio alert when a BLF line receives an incoming call.
Page 494
Advanced Features 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 incom- Description ing call. Permitted 0-Disabled 1-Enabled Values Default Supported All phones except T30P, T30, T19(P) E2 and CP920 Devices Web UI Features >...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /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 >...
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 497
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /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...
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.
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /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).
Advanced Features Values Default Blank Supported All phones except T30P, T30, 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...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /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 T30P, T30, 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.
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 503
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /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 T30P, T30, T19(P) E2 and CP920 Devices Parameter blf.enhanced.talking.led <y0000000000xx>.cfg...
Advanced Features Values Default Blank Supported All phones except T30P, T30, 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).
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /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...
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, T30P, T30, 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...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones “features.intercom.mode”). Permitted 0-Disabled 1-Enabled Values Default Supported All phones except T30P, T30, T19(P) E2 and CP920 Devices Call Information Display Configuration The following table lists the parameter you can use to configure call information display. Parameter features.blf.show_callinfo.enable <y0000000000xx>.cfg It enables or disables the phone to display the call information by long pressing the BLF/BLF List/Call...
E2/CP920/CP925/CP935W, X=1. 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.
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”...
Advanced Features You have the option to provide users the ability to do the following: Configure a private hold soft key or Private Hold key and provide users the ability to hold a call privately. Configure a call pull code, which allows users to retrieve an existing call from another shared phone that is in an active or public hold status.
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 512
Advanced Features Default Blank Web UI Account > Advanced > BLA Number Parameter account.X.bla.notify_with_expire.enable <MAC>.cfg It enables or disables the phone to add the Expires attribute to the Subscription-State header of the BLA NOTIFY message. Description Note: It works only if “account.X.shared_line” is set to 3 (Draft BLA). For teltronnic BLA, you need to set the value of this parameter to 0 (Disabled).
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones T40P/T40G/T23P/T23G, X=1-3; for T31P/T31G/T31/T21(P) E2, X=1-2; for T30P/T30/T19(P) E2/CP920/CP925/CP935W, X=1. Intercom Intercom is a useful feature in an office environment to quickly connect with the operator or the secretary. You can press the intercom key to place a call to a contact that is answered automatically on the contact's phone as long as the contact is not in an active call.
Supported All phones except T30P, T30, 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.
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Permitted String Values Default Blank Parameter account.X.call_info <MAC>.cfg 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.
Page 516
Advanced Features It enables or disables the phone to play a warning tone when answering an intercom call. Description Note: It works only if “features.intercom.allow” is set to 1 (Enabled). Permitted 0-Disabled 1-Enabled Values Default Web UI Features > Intercom > Intercom Tone Menu >...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Permitted String within 256 characters Values Default Blank Parameter voice.intercom.tone_vol <y0000000000xx>.cfg It configures the intercom tone as a fixed volume. Description Note: It works only if “features.intercom.tone” is set to 1 (Enabled). During a call, the phone plays the call waiting tone instead of the intercom tone when the phone receives an intercom call.
Advanced Features Topic CSTA Control Configuration CSTA Control Configuration The following table lists the parameter you can use to configure CSTA control. Parameter features.csta_control.enable <y0000000000xx>.cfg Description It enables or disables the CSTA feature. Permitted 0-Disabled Values 1-Enabled Default Supported All phones except T30P, T30, T19(P) E2 and CP920 Devices Web UI Features >...
Page 519
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Event Description Incoming Call When the IP phone receives an incoming call. Outgoing Call When the IP phone places a call. Established When the IP phone establishes a call. Terminated When the IP phone terminates a call.
Advanced Features Event Description 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. Mute When the IP phone mutes a call. UnMute When the IP phone un-mutes a call. Missed Call When the IP phone misses a call.
Page 521
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Variable Value Description $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.
Advanced Features 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 Default Blank...
Page 523
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones 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. Description Example: action_url.on_hook = http://192.168.0.20/help.xml?IP=$ip...
Page 524
Advanced Features Example: action_url.call_terminated = http://192.168.0.20/help.xml?IP=$ip Permitted URL within 511 characters Values Default Blank Web UI Features > Action URL > Terminated 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...
Page 525
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Parameter action_url.busy_fwd_on <y0000000000xx>.cfg It configures the action URL the phone sends when the busy forward feature is activated. Description Example: action_url.busy_fwd_on = http://192.168.0.20/help.xml?IP=$ip Permitted URL within 511 characters Values Default Blank Web UI Features >...
Page 526
Advanced Features Default Blank Web UI Features > Action URL > Transfer Call Parameter action_url.blind_transfer_call <y0000000000xx>.cfg It configures the action URL the phone sends when performing a blind transfer. Description 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...
Page 527
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Permitted URL within 511 characters Values Default Blank Parameter action_url.unheld <y0000000000xx>.cfg It configures the action URL the phone sends when a held call is resumed. Description Example: action_url.unheld = http://192.168.0.20/help.xml?IP=$ip Permitted URL within 511 characters Values...
Page 528
Advanced Features 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 529
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Example: action_url.forward_incoming_call = http://192.168.0.20/help.xml?IP=$ip Permitted URL within 511 characters Values Default Blank Web UI Features > Action URL > Forward Incoming Call Parameter action_url.transfer_finished <y0000000000xx>.cfg It configures the action URL the phone sends when completing a call transfer. Description Example: action_url.transfer_finished = http://192.168.0.20/help.xml?IP=$ip...
Page 530
Advanced Features 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 Web UI Features > Action URL > Call Waiting Off Parameter action_url.headset <y0000000000xx>.cfg It configures the action URL the phone sends when pressing the HEADSET key.
Page 531
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones action_url.remote_busy = http://192.168.0.20/help.xml?IP=$ip Permitted URL within 511 characters Values Default Blank Web UI Features > Action URL > Remote Busy Parameter action_url.call_remote_canceled <y0000000000xx>.cfg It configures the action URL the phone sends when the remote party cancels the outgoing call in the ringing state.
Features > Action URL > SIP INFO Display Update 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.
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 534
Advanced Features For CP920 phones: http://10.3.20.10/servlet?key=F1;OK;F3;DOWN;DOWN;DOWN;OK;OK. For other phones: http://10.3.20.10/servlet?key=F1;F3;DOWN;DOWN;DOWN;OK;OK. Note : The variable value is not applicable to all events. For example, the variable value “MUTE” is only applicable when the IP phone is during a call. When authentication is required, you can use the following URI format: http(s)://user- name:password@<phoneIPAddress>/servlet?key=variable value.
Page 535
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Variable Value Phone Action phones). UP/DOWN/LEFT/RIGHT Press the navigation keys. (not applicable to T57W phones) Reboot Reboot the phone. AutoP Perform auto provisioning. Activate the DND feature. DNDOn Note: It works only if “features.dnd.allow” is set to 1 (Enabled). Deactivate the DND feature.
Page 536
AlwaysFwdOn/BusyFwdOn/NoAn- swFwdOn=xxx=n Note: For Yealink phones, it works only if “features.fwd.allow” is set to 1 (Enabled) and call forward mode is Phone, the always/busy/no answer forward feature will apply to all the accounts on the phone.
Page 537
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Variable Value Phone Action http://10.10.20.10/servlet?key=NoAnswFwdOff CALLEND/CallEnd End a call. Answer/end/hold/unhold a call (xxx refers to the call-id of the active call). Example: ASW/CANCEL/HOLD/UNHOLD:xxx http://10.10.20.10/servlet?key=ASW:33093 Note: To get the call-id of the active call, configure the action URL: http(s)://<serverIPAddress>/help.xml?CallId=$call_id.
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.
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.
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 541
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones It configures MWI subscribe expiry time (in seconds). Description Note: It works only if “account.X.subscribe_mwi” is set to 1 (Enabled). Permitted Integer from 0 to 84600 Values Default 3600 Web UI Account >...
Page 542
Advanced Features Values 1-Enabled Default Web UI Account > Advanced > Voice Mail Display Parameter features.voice_mail_alert.enable <y0000000000xx>.cfg It enables or disables the phone to pop up the message when receiving the same amount of new Description voicemails. Permitted 0-Disabled 1-Enabled Values Default Parameter features.voice_mail_key_lamp_field.enable...
E2/CP920/CP925/CP935W, X=1. Short Message Service (SMS) Yealink phones (except CP920/CP925/CP935W 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.
Users can customize practical applications, such as weather report, stock information, Google search, news service, and so on. To use the XML browser feature, you must configure an XML browser key in advance. For more information on XML browser, refer to Yealink IP Phones XML Browser Developer's Guide. Topic XML Browser Configuration XML Browser Configuration The following table lists the parameters you can use to configure XML browser.
Page 545
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Parameter push_xml.phonebook.search.delay <y0000000000xx>.cfg It configures the time (in milliseconds) to wait for the phone to send the entered keywords to XML phonebook server if the user does not press OK to confirm. If it is set to 0, the phone immediately sends the entered keywords to the server.
Advanced Features Default Blank Web UI Features > Remote Control > Password Parameter features.upload_server <y0000000000xx>.cfg It configures the server address which the DssKey.cfg file is uploaded to when the phone receives an Description XML command (Command:UploadSystemInfo). Permitted URL within 1024 characters Values Default Blank...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones 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. Related Topic Line Keys Configuration Programmable Keys Configuration...
Page 548
Advanced Features 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. 0-Disabled Permitted Values 1-Enabled Default Supported All phones except CP920 Devices Parameter features.hotdesking_clear_calllog.enable...
Page 549
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Values Account ID-The specified accounts will be cleared. Default Supported T57W, T54W, T53W, T53, T53C, T48U, T46U, T43U, T42U, T33P, T33G, T31P, T31G, T31, T30P, T30 Devices...
Device Management Device Management You can enable the device management feature to connect device and report device information to the Yealink Device Management Platform (YDMP)/Yealink Management Cloud Service (YMCS), where you can view device information, manage devices, and diagnose devices.
Page 551
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Menu > Security > Call Quality Statistics static.remote_control.X.allow Parameter <y0000000000xx>.cfg Description It configures whether to allow the YDMP/YMCS to take phone's screenshots or capture packets. 0-Unauthorized, when the YDMP/YMCS wants to take phone's screenshots or capture packets, the phone will pop up a dialog, prompting users to allow or reject the request.
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 553
<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).
General Features X is the account ID. For T57W/T54W/T48U/T48S/T48G/T46U/T46S/T46G/T29G, X=1-16; for T53W/T53/T53C/T43U/T42G/T42U/T42S, X=1-12; for T41P/T41S/T27G, X=1-6; for T33P/T33G, X=1-4; for T40P/T40G/T23P/T23G, X=1-3; for T31P/T31G/T31/T21(P) E2, X=1-2; for T30P/T30/T19(P) E2/CP920/CP925/CP935W, 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.
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Return Code for Unanswered Call Configuration The following table lists the parameters you can use to configure the return code for the unanswered call. Parameter features.no_answer_code <y0000000000xx>.cfg It configures a return code and reason of SIP response messages when the phone does not answer Description an incoming call.
General Features Group Park Call Pull Permitted 0-Disabled 1-Enabled Values Default Web UI Features > General Information > Hide Feature Access Codes Parameter features.hide_feature_access_codes.dsskey_type <y0000000000xx>.cfg It configures the phone to display the label instead of the feature access code when pressing the speficed Dsskey to dial out.
General Features SIP Session Timer SIP session timers T1, T2 and T4 are SIP transaction layer timers defined in 3261. These session timers are configurable on the phones. Timer T1 Timer T1 is an estimate of the Round Trip Time (RTT) of transactions between a SIP client and SIP server. Timer T2 Timer T2 represents the maximum retransmitting time of any SIP request message.
General Features Note: It works only if “account.X.session_timer.enable” is set to 1 (Enabled). Permitted Integer from 90 to 7200 Values Default 1800 Web UI Account > Advanced > Session Expires (90~7200s) Parameter account.X.session_timer.refresher <MAC>.cfg It configures who refreshes the SIP session during a call. Description Note: It works only if “account.X.session_timer.enable”...
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.
General Features 5-5s, a busy tone lasts for 5 seconds on the phone Default Web UI Features > General Information > Busy Tone Delay (Seconds) CFG File Version Information You can customize the version information for the CFG configuration file and then check the version information via phone/web user interface.
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Default Blank Supported All phones except T48G, T46G, T42G, T41P and T29G Devices Parameter static.auto_provision.config_version.mac <y0000000000xx>.cfg It configures the version information of the MAC CFG configuration file. After configuration, you can check the configuration file version information at the path: Menu > Status Description >...
Page 564
General Features Default Parameter sip.loopback_type <y0000000000xx>.cfg Description It configures the media loopback type. 1-rtp-media-loopback, the packet received by loopback mirror is re-encoded based on the SDP nego- tiation. The re-encoded content is returned to the loopback source as an RTP packet with payload type corresponding to the re-encoding format.
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones 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...
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 Yealink IP Phones Deployment Guide for BroadSoft UC-One Environment.
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Values 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 568
Configuration Parameters Parameter bw.xmpp.change_presence.force_manual.enable <y0000000000xx>.cfg It enables or disables to synchronize the presence status to the BroadWorks server when you change Description your presence status manually on the IP phone. Permitted 0-Disabled 1-Enabled Values Default Supported All color screen phones Devices Parameter bw.xmpp.change_presence.enable <y0000000000xx>.cfg...
Page 569
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones simultaneously. 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’...
Configuration Parameters It enables or disables the users to access the BroadSoft Buddies directory by pressing the Description Directory/Dir soft key. 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...
Page 571
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Note: It works only if “bw.xsi.enable" is set to 1 (Enabled). 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.
Configuration Parameters It configures the port of TCP connection when XSI events are delivered by using an event channel. Description Note: It works only if “bw.xsi.xsi_event_mode" is set to 1. Default Integer from 1 to 65535 Default Supported T57W, T54W, T53W, T53, T53C, T48U, T46U, T43U, T42U, T33P, T33G, T31P, T31G, T31, T30P, T30 Devices Parameter bw.xsi.xsi_event_mode <y0000000000xx>.cfg...
Page 573
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Default [1][2] Parameter account.X.reason_code.Y <MAC>.cfg It configures the unavailable code which must match one of the codes configured on the BroadWorks Description platform. Permitted Integer from 1 to 2147483647 Values Default Blank [1][2]...
Page 574
Configuration Parameters Parameter account.X.call_center.trace_enable <MAC>.cfg Description It enables or disables the customer originated trace feature. 0-Disabled Permitted Values 1-Enabled, it is used to trace the origin of an obscene, harassing, or threatening call. Default Parameter account.X.call_center.emergency_enable <MAC>.cfg Description It enables or disables the emergency escalation feature. 0-Disabled Permitted 1-Enabled, it provides the capability for the call center agent to immediately escalate a call to a super-...
Page 575
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Devices Parameter bw.virtual_user.1.label <MAC>.cfg It configures the virtual account label displayed on the phone. Description Note: If you leave it blank, the virtual user name uses VirtualUser1 by default. Permitted String within 99 characters Values Default...
Configuration Parameters Parameter bw.virtual_user.1.xsi.server_type <MAC>.cfg It configures the access protocol of the Xtended Services Platform server for the virtual account. Description Note: It works only if “bw.xsi.enable” is set to 1 (Enabled). Permitted HTTP or HTTPS Values Default Blank Supported All phones except T48G, T46G, T42G, T41P and T29G Devices Parameter bw.virtual_user.1.xsi.port...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Description It configures the centralized call recording mode. 0-XSI Permitted Values 1-SIP Default X is the account ID. For T57W/T54W/T48U/T48S/T48G/T46U/T46S/T46G/T29G, X=1-16; for T53W/T53/T53C/T43U/T42G/T42U/T42S, X=1-12; for T41P/T41S/T27G, X=1-6; for T33P/T33G, X=1-4; for T40P/T40G/T23P/T23G, X=1-3;...
Configuration Parameters Note: It works only if “account.X.hoteling.enable” is set to 1 (Enabled). 0-Disabled Permitted Values 1-Enabled Default Parameter hoteling.authentication_mode <y0000000000xx>.cfg It configures the XML browser hoteling authentication mode. Description Note: It works only if “account.X.hoteling.enable” is set to 1 (Enabled). 0-The phone uses the hoteling user ID and password as authentication credentials.
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones 3-Flexible Seating Guest Default Parameter account.X.hoteling.pin <MAC>.cfg Description It configures the flexible seating PIN. Permitted String Values Default Blank Parameter features.homescreen_softkey.hoteling.enable <y0000000000xx>.cfg It enables or disables the phone to display the Flexible Seating soft keys such as GuestIn or GuestOut on the idle screen.
Configuration Parameters 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/T53C/T43U/T42G/T42U/T42S, X=1-12; for T41P/T41S/T27G, X=1-6; for T33P/T33G, X=1-4; for T40P/T40G/T23P/T23G, X=1-3; for T31P/T31G/T31/T21(P) E2, X=1-2; for T30P/T30/T19(P) E2/CP920/CP925/CP935W, X=1. Broadsoft Network Directory Parameter bw.xsi.directory.enable <y0000000000xx>.cfg It enables or disables the network directory feature. Description Note: It works only if “bw.xsi.enable"...
Page 581
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Default Web UI Applications > Broadsoft XSI > Network Directory > Enterprise Parameter bw_phonebook.enterprise_common_enable <y0000000000xx>.cfg It enables or disables the phone to display the enterprise common directory. Description Note: It works only if "bw.xsi.directory.enable" is set to 1 (Enabled). Permitted 0-Disabled 1-Enabled...
Page 582
Configuration Parameters Web UI Applications > Broadsoft XSI > Network Directory > Enterprise Parameter bw_phonebook.personal_displayname <y0000000000xx>.cfg It configures the display name on the phone screen for the personal directory. Description Note: It works only if "bw.xsi.directory.enable" and "bw_phonebook.personal_enable" are set to 1 (Enabled).
Page 583
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Default Parameter bw.xsi.directory.update.enable <y0000000000xx>.cfg It enables or disables the phone to automatically download all contacts in the BroadSoft Directory from the server. Description Note: It works only if “bw.xsi.directory.enable” is set to 1 (Enabled). 0-Disabled, the phone downloads partial contacts from the server (the maximum of contacts available for viewing at one time is determined by the server), and you can manually download the remaining Permitted...
Configuration Parameters Parameter search_in_dialing.bw_directory.enable <y0000000000xx>.cfg It enables or disables the phone to automatically search entries from the BroadSoft directory, and dis- Description play the results on the pre-dialing/dialing screen. Permitted 0-Disabled 1-Enabled Values Default Parameter search_in_dialing.bw_directory.priority <y0000000000xx>.cfg Description It configures the search priority of the BroadSoft directory. Permitted Integer greater than or equal to 0 Values...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones 1-enter the View Voice Mail screen Default Broadsoft SCA Parameter account.X.share_line.barge_in.enable <MAC>.cfg Description It enables or disables the users to interrupt/barge into an active call on the shared line. 0-Disabled Permitted Values 1-Enabled...
Configuration Parameters Devices X is the account ID. For T57W/T54W/T48U/T48S/T48G/T46U/T46S/T46G/T29G, X=1-16; for T53W/T53/T53C/T43U/T42U/T42G/T42S, X=1-12; for T41P/T41S/T27G, X=1-6; for T33P/T33G, X=1-4; for T40P/T40G/T23P/T23G, X=1-3; for T31P/T31G/T31/T21(P) E2, X=1-2. Broadsoft Call Park Parameter features.call_park.park_mode <y0000000000xx>.cfg Description It configures the call park mode. 0-XSI Permitted Values...
Page 587
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Default Supported All phones except T48G, T46G, T42G, T41P, T30P, T30, T29G, T19(P) E2, CP920, CP925 and Devices CP935W Web UI Features > Pickup & Park > Audio Alert for BLF Parked Call Monitor Parameter features.parked_call_monitor.blf_visual_enable <y0000000000xx>.cfg It enables or disables the phone to display a visual alert when a call is parked against the monitored...
Configuration Parameters works-callpark" Default X is the account ID. For T57W/T54W/T48U/T48S/T48G/T46U/T46S/T46G/T29G, X=1-16; for T53W/T53/T53C/T43U/T42G/T42U/T42S, X=1-12; for T41P/T41S/T27G, X=1-6; for T33P/T33G, X=1-4; for T40P/T40G/T23P/T23G, X=1-3; for T31P/T31G/T31/T21(P) E2, X=1-2; for T30P/T30/T19(P) E2/CP920/CP925/CP935W, X=1. Broadsoft Emergency Call Parameter bw.emergency_calling.enable <y0000000000xx>.cfg Description It enables or disables the BroadWorks Emergency Calling feature. 0-Disabled Permitted Values...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Default Supported T57W, T54W, T53W, T53, T53C, T48U, T46U, T43U, T42U, T33P, T33G, T31P, T31G, T31, T30P, T30 Devices Parameter account.X.personal_meeting_id <y0000000000xx>.cfg It configures the personal meeting ID for the every Zoom user when they have a meeting. Description Note: It works only if "zm.enable"...
Page 590
Configuration Parameters indicate the arrival of a new participant to the call and all call participants can interact. Note: It applies to the Zoom server only. Permitted String within 32 characters Values Default Blank Supported T57W, T54W, T53W, T53, T53C, T48U, T46U, T43U, T42U, T33P, T33G, T31P, T31G, T31, T30P, T30 Devices The feature access code is *32.
Page 591
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Default Blank Supported T57W, T54W, T53W, T53, T53C, T48U, T46U, T43U, T42U, T33P, T33G, T31P, T31G, T31, T30P, T30 Devices The feature access code is *32. A (your phone) monitors party B (number: 8866), party B and party C is during the call.
Configuration Parameters 1-The phone displays the identity contained in the Remote field of the NOTIFY message when the phone monitored the call queue. Default Blank Supported T57W, T54W, T53W, T53, T53C, T48U, T46U, T43U, T42U, T33P, T33G, T31P, T31G, T31, T30P, T30 Devices The feature access code is *32.
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Parameter account.X.ice.hold_mode <y0000000000xx>.cfg Description It enables or disables the ICE to use ICE restart when the phone on hold or resume. 0-Enabled Permitted Values 1-Disabled Default Supported T57W, T54W, T53W, T53, T53C, T48U, T46U, T43U, T42U, T33P, T33G, T31P, T31G, T31, T30P, T30 Devices Parameter features.blind_transfer.call_display_method <y0000000000xx>.cfg...
Configuration Parameters X is the account ID. For T57W/T54W/T48U/T48S/T48G/T46U/T46S/T46G/T29G, X=1-16; for T53W/T53/T53C/T43U/T42U/T42G/T42S, X=1-12; for T41P/T41S/T27G, X=1-6; for T33P/T33G, X=1-4; for T40P/T40G/T23P/T23G, X=1-3; for T31P/T31G/T31/T21(P) E2, X=1-2. Zoom Emergency Call Parameter account.X.take_switch_info.signals <y0000000000xx>.cfg It configures the phone to obtain and the MAC and Port ID information of the switch or the BSSID Description information of the WIFI when the LLDP changed.
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones verstat.passed.criteria=TN-VALIDATION-PASSED,TN-VALIDATION-NOT-PRESENT The INVITE message with the"P-Asserted-Identity: "Zoom calling for Main Auto Receptionist" <sip:16692521823@nil;verstat=TN-VALIDATION-PASSED>" and "P-Asserted-Identity: "Zoom calling for Main Auto Receptionist" <sip:16692521823@nil;verstat=TN-VALIDATION-NOT-PRESENT> header fields will be safe. Default Blank Supported T57W, T54W, T53W, T53, T53C, T48U, T46U, T43U, T42U, T33P, T33G, T31P, T31G, T31, T30P, T30 Devices Parameter verstat.failed.criteria...
<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 597
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones The feature access code is *32. A (your phone) monitors party B (number: 8866), party B and party C is during the call. Set the following: Case Scen- blf.normal_barge_in_code = *32 ario features.blf.show_callinfo.enable = 1 During the call of the monitored line, long press the BLF key and press the Barge In soft key, then the...
Configuration Parameters blf.listen_barge_in_code = *32 features.blf.show_callinfo.enable = 1 During the call of the monitored line, long press the BLF key and you press the Listen BargeIn soft key, then the phone calls *328866 to barge in the call. You are automatically muted, so you can hear all call participants, but no one can hear you.
Page 599
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones 2–Use random digits plus MAC address Default Parameter account.X.path.enable <MAC>.cfg It enables or disables the phone to carry the Supported:path header in the REGISTER request mes- Description sage. Permitted 0-Disabled 1-Enabled Values Default...
Page 600
Configuration Parameters 1-Enabled. If the CSeq sequence number in the request is lower than that in the previous request, the phone will reject the request. Default Parameter account.X.check_to_tag.enable <MAC>.cfg Description It enables or disables the phone to check if the To-tag is carried in the To header in renewal request. 0-Disabled Permitted Values...
Page 601
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Description It configures the listening port mode. 0-random source port (non 506x), fixed ports (506x) carried in the Contact, Via header. Permitted Values 1-random source port (non 506x) and other ports (non 506x) carried in the Contact, Via header. Default Parameter sip.listen_mode <y0000000000xx>.cfg...
Configuration Parameters Default Parameter sip.mac_in_ua <y0000000000xx>.cfg Description It enables or disables the phone to carry the MAC address information in the User-Agent header. 0-Disabled 1-Enabled, the phone will carry the MAC address with colons (for example 00:15:65:7f:fb:7e) in the Permitted User-Agent header.
Page 603
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones abled). For T43U/T42G/T42S/T42U/T41P/T41S/T27G phones, the station name is displayed in the middle bottom of the idle screen. Blank (the label of the default account will be displayed) Permitted Values String Default Blank Parameter features.station_name.scrolling_display...
Configuration Parameters 2-There is no response when tapping the missed call icon. Default When you disable the phone to pop up the message if it misses a call (features.missed_call_ Case Scen- popup.enable=0), you can also disable the phone to pop up the message when tapping the missed ario call icon in the status bar.
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 Exporting All the Diagnostic Files...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Exporting Headset Log When the Yealink USB headset is connected to your T4XU/T5XW phone, you can export the headset log to help analyze your problem. Procedure 1. From the web user interface, go to Settings > Configuration.
Page 607
Troubleshooting Methods Default Supported All phones except T48G, T46G, T42G, T41P, T40P, T40G, T33P, T33G, T31P, T31G, T31, T30P, T30, Devices T29G, T23P, T23G, T21(P) E2 and T19(P) E2 Web UI Settings > Configuration > Local Log > USB Auto Exporting Syslog Parameter static.local_log.level <y0000000000xx>.cfg It configures the lowest level of local log information to be rendered to the <MAC>.log file.
Page 608
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Settings > Configuration > Local Log > Max Log File Size (256-2048KB) Parameter static.auto_provision.local_log.backup.enable <y0000000000xx>.cfg It enables or disables the phone to upload the local log files to the provisioning server or a specific server.
Troubleshooting Methods Default Parameter static.auto_provision.local_log.backup.append.limit_mode <y0000000000xx>.cfg It configures the behavior when local log files on the provisioning server or a specific server reach the Description maximum file size. 0-Append Delete, the server will delete the old log and the phone will continue uploading log. Permitted Values 1-Append Stop, the phone will stop uploading log.
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones 4. Enter the limit size of the log files in the Max Log File Size field. 5. Click Confirm to accept the change. 6. Reproduce the issue. The log files are uploaded to your USB flash drive. Viewing the Log Files You can verify whether you got the correct log through the following key fields: <0+emerg >...
Troubleshooting Methods You can specify syslog details such as IP address or hostname, server type, facility, and the severity level of events you want to log. You can also choose to prepend the phone's MAC address to log messages. Topics Syslog Logging Configuration Viewing the Syslog Messages on Your Syslog Server Syslog Logging Configuration...
Page 612
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones 0-Emergency: system is unusable 1-Alert: action must be taken immediately 2-Critical: critical conditions Permitted 3-Critical: error conditions Values 4-Warning: warning conditions 5-Warning: normal but significant condition 6-Informational: informational messages Default Web UI Settings >...
Troubleshooting Methods 23-Local Use 7 (Local7) Note: Note 1 - Various operating systems have been found to utilize Facilities 4, 10, 13 and 14 for security/authorization, audit, and alert messages which seem to be similar. Note 2 - Various operating systems have been found to utilize both Facilities 9 and 15 for clock (cron/at) messages.
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Reset to Factory: All configurations on the phone will be reset. Reset a configuration at a time You can reset the IP phone to default factory configurations. The default factory configurations are the settings that reside on the IP phone after it has left the factory.
Troubleshooting Methods Note : Reset of your phone may take a few minutes. Do not power off until the phone starts up successfully. Resetting the IP phone to Custom Factory Settings After you enable the custom factory feature, you can import the custom factory configuration file, and then reset the IP phone to custom factory settings.
Ethernet Software Capturing Configuration Capturing the Packets via Web User Interface For Yealink phones, you can export the packets file to the local system and analyze it. Yealink devices support the following two modes for capturing the packets: Normal: Export the packets file after stopping capturing.
Troubleshooting Methods Note: The steps may differ for different web browsers. Capturing the Packets in Normal Way Procedure 1. From the web user interface, go to Settings > Configuration. 2. Select Normal from the Pcap Type drop-down menu. 3. Click Start in the Pcap Feature field to start capturing signal traffic. 4.
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Span to PC Port Configuration The following table lists the parameter you can use to configure span to PC port. Parameter static.network.span_to_pc_port <y0000000000xx>.cfg It enables or disables the phone to span data packets received from the WAN port to the PC port. Description Note: It works only if “static.network.pc_port.enable”...
Troubleshooting Methods 1. From the web user interface, click Network > Diagnostics. 2. Select Ping or Traceroute from the Command drop-down menu. 3. Enter an IP address or a URL (for example, 10.200.108.48) in the IP Address field. 4. Click Start to start a ping. You can also diagnose network via the phone user interface at the path: Menu >...
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...
Troubleshooting Methods Exporting CFG Configuration Files from Phone You can export the phone’s configuration file to local and make changes to the phone’s current feature settings. You can apply these changes to any phone by importing the configuration files via the web user interface. You can export five types of CFG configuration files to the local system: <MAC>-local.cfg: It contains changes associated with non-static parameters made via the phone user interface and web user interface.
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones Importing BIN Files from the Phone Procedure 1. From the web user interface, click Settings > Configuration > BIN Configuration. 2. In the Export or Import Configuration (Import Configuration) block, click Browse to locate a BIN configuration file from your local system.
Troubleshooting Methods 1. Open a web browser on your computer. 2. Enter the IP address in the browser’s address bar, and then press the Enter key. For example, “http://192.168.0.10” for IPv4 or “http://[2005:1:1:1:215:65ff:fe64:6e0a]” for IPv6. 3. Enter the user name (admin) and password (admin) in the login page. 4.
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones 1. Press Menu > Basic > Reboot (Menu > Settings > Basic Settings > Reboot). 2. Press OK. The device begins rebooting. Any reboot of the device may take a few minutes. Rebooting the Device via Web User Interface You can reboot your IP phone via the web user interface.
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...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /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]”.
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.
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /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: 96: T57W/T54W/T53W/T53/T53C 108: T48U/T46U/T43U/T42U...
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...
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /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-...
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.
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /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.
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 634
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /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-...
(turn off wire- less network for CP935W phones) Wired net- work is unreachable (it is not (T48U- (T46U- applicable to CP935W phones.) Private line registers suc- cessfully Registration failed T42- Registering (Flash- (Flash- (Flashing) ing) ing) Yealink Cloud account...
Page 639
Appendix T31P/T31- T42- G/T31/ T53W/- T42- T30P/T30/ CP925/CP- T54W/T53C/T3- T48U/- T46U/- T42- T40- CP9- T57W T29G Description 935W 3P/T33G /T43U T41- T23P/T23- T41- /T27G /T21(P) E2 Line key type is Voice Mail Line key type is Direct Pickup Line key type is Group Pickup Line key type...
Page 640
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones T31P/T31- T42- G/T31/ T53W/- T42- T30P/T30/ CP925/CP- T54W/T53C/T3- T48U/- T46U/- T42- T40- CP9- T57W T29G Description 935W 3P/T33G /T43U T41- T23P/T23- T41- /T27G /T21(P) E2 Line key type is DTMF/Pre- Line key type is Local Group/XML...
Page 641
Appendix T31P/T31- T42- G/T31/ T53W/- T42- T30P/T30/ CP925/CP- T54W/T53C/T3- T48U/- T46U/- T42- T40- CP9- T57W T29G Description 935W 3P/T33G /T43U T41- T23P/T23- T41- /T27G /T21(P) E2 Line key type is Hot Desk- Line key type is ACD Line key type is Zero Touch Line key type is URL...
Page 642
Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones T31P/T31- T42- G/T31/ T53W/- T42- T30P/T30/ CP925/CP- T54W/T53C/T3- T48U/- T46U/- T42- T40- CP9- T57W T29G Description 935W 3P/T33G /T43U T41- T23P/T23- T41- /T27G /T21(P) E2 ing) ing) call The shared line is in con- versation The shared...