Page 2 Yealink and/or its respective suppliers are not responsible for the suitability of the information contained in this doc- ument for any reason. The information is provided “as is”, and Yealink does not provide any warranty and is subject to change without notice. All risks other than risks caused by use of the information are borne by the recipient. In no...
Page 3 We are striving to improve our documentation quality and we appreciate your feedback. Email your opinions and com- ments to DocsFeedback@yealink.com. Technical Support Visit Yealink WIKI (http://support.yealink.com/) for the latest firmware, guides, FAQ, Product documents, and more. For better service, we sincerely recommend you to use Yealink Ticketing system (https://ticket.yealink.com) to submit all your technical issues.
Page 4 GPL. Please refer to the GPL for the exact terms and conditions of the license. The original GPL license, source code of components licensed under GPL and used in Yealink products can be down-...
Page 5: Introduction
Auto Provisioning Guide, describes how to provision IP phones using the boot file and configuration files. The Auto Provisioning Guide is to serve as a basic guidance for provisioning Yealink IP phones with a provisioning server. If you are a novice, this guide is helpful for you.
Page 6: Recommended References
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 IP phones, refer to the Document Download page for your phone at Yealink Technical Support.
Page 7: Table Of Contents
Recommended References Typographic and Writing Conventions 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 Contacting the Provisioning Server...
Page 8 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Wi-Fi Configuration Real-Time Transport Protocol (RTP) Ports RTP Ports Configuration Network Address Translation (NAT) NAT Traversal Configuration Keep Alive Configuration Rport Configuration SIP Port and TLS Port Configuration Internet Port and PC Port...
Page 9 Table of Contents Navigating the Web User Interface Phone User Interface Central Provisioning Auto Provisioning Settings Configuration User-Triggered Provisioning Settings Configuration Viewing Configurations Configured via Different Provisioning Methods Setting Up a Provisioning Server Supported Provisioning Protocols Provisioning Protocols Configuration Supported Provisioning Server Discovery Methods Zero Touch Provision Configuration PnP Provision Configuration DHCP Provision Configuration...
Page 10 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Adding a Wallpaper from a USB Flash Drive Example: Setting a Custom Picture as Wallpaper Transparency Transparency Configuration Screen Saver Screensaver Display Customization Screensaver File Elements and Attributes Customizing the Screen Saver File...
Page 11 Table of Contents Custom Logo Picture Limit Customizing a Logo Picture Custom Logo Configuration Example: Setting a Custom Logo Display Call Display Call Display Configuration Display Method on Dialing Display Method on Dialing Configuration Key As Send Key As Send Configuration Softkey Layout Supported Call States and Soft Keys Softkey Layout File Customization...
Page 12 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Ext Keys Ext Keys Configuration Enhanced DSS Keys Guidelines for Configuring Enhanced DSS Keys Macro Action Strings EDK Configuration EDK List Configuration EDK User Input Prompt Configuration EDK Soft Keys Configuration...
Page 13 Table of Contents Logon Wizard Logon Wizard Configuration Multiple Line Keys per Account Multiple Line Keys per Account Configuration Auto Line Labels Rule Configuration Default Account Call Log Call Log Display Call Log Configuration Call Logs Backup Directory Local Directory Contact Avatars and Icons Picture Limit Preparing the Tar Formatted File Local Contact File Customization...
Page 14 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Call Features Dial Plan Defined by Four Patterns (Old Dial Plan Mechanism) Basic Regular Expression Syntax for Four Patterns Replace Rule File Customization Replace Rule File Attributes Customizing the Replace Rule File...
Page 15 Table of Contents Auto Answer Auto Answer Configuration Anonymous Call Rejection Anonymous Call Rejection Configuration 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...
Page 16 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Alert Tone Alert Tone Configuration Touch Tone Touch Tone Configuration Ring Tones Custom Ringtone Limit Ringtone Configuration Distinctive Ring Tones Supported Alert-Info Headers Format Alert-Info: Bellcore-drN Alert-Info: ringtone-N/Alert-Info: ringtone-RingN.wav (or Alert-Info: MyMelodyN/Alert-Info: MyMelodyRingN.wav)
Page 17 Table of Contents CNG Configuration Jitter Buffer Jitter Buffer Configuration Smart Noise Block Smart Noise Block Configuration DTMF DTMF Keypad Transmitting DTMF Digit Transmitting DTMF Digit Configuration Suppress DTMF Display Suppress DTMF Display Configuration Transfer via DTMF Transfer via DTMF Configuration Local DTMF Tone Local DTMF Tone Configuration Voice Quality Monitoring (VQM)
Page 18 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Contact Files Encryption and Decryption Encryption and Decryption Configuration Example: Encrypting Configuration Files Incoming Network Signaling Validation Incoming Network Signaling Validation Configuration Advanced Features Call Pickup Directed Call Pickup Directed Call Pickup Configuration...
Page 19 Table of Contents BLF Key LED/Icon and Behavior for DND State Configuration BLF Key for Intercom Configuration Call Information Display Configuration Shared Line State Indicator of Shared Line Shared Call Appearance (SCA) Configuration SCA Configuration Bridge Lines Appearance (BLA) BLA Configuration Intercom Intercom Key Configuration State Monitor for Intercom Contact...
Page 20 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Return Code for Unanswered Call Configuration Hide Feature Access Codes Hide Feature Access Codes Configuration Accept SIP Trust Server Only Accept SIP Trust Server Only Configuration 100 Reliable Retransmission 100 Reliable Retransmission Configuration...
Page 21 Table of Contents Troubleshooting Methods Log Files Local Logging Local Logging Configuration Exporting the Log Files to a Local PC Viewing the Log Files Syslog Logging Syslog Logging Configuration Viewing the Syslog Messages on Your Syslog Server Resetting Phone and Configuration Reset to Factory Configuration Resetting the IP phone to Default Factory Settings Resetting the IP phone to Custom Factory Settings...
Page 22 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones The IP phone does not get an IP address Solving the IP conflict problem Specific format in configuring IPv6 on Yealink IP phones Time and Date Issues Display time and date incorrectly...
Page 23: Getting Started
There are many ways to set up a phone network using Yealink IP phones. The following shows an example of a network setup:...
Page 24: Initialization Process Overview
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Initialization Process Overview The initialization process of the IP phone is responsible for network connectivity and operation of the IP phone in your local network. Once you connect your IP phone to the network and to an electrical supply, the IP phone begins its ini- tialization process.
Page 25: Loading The Rom File
Getting Started Loading the ROM File The ROM file resides in the flash memory of the IP phone. The IP phone comes from the factory with a ROM file pre- loaded. During initialization, the IP phone runs a bootstrap loader that loads and executes the ROM file. Configuring the VLAN If you connect the IP phone to a switch, the switch notifies the IP phone of the VLAN information defined on the switch (if using LLDP or CDP).
Page 26 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones 4. Press the OK/√key or press Menu->Status to check the IP phone status, the phone screen displays the valid IP address, MAC address, firmware version, and so on. If the IP phone has successfully passed through these steps, it starts up properly and is ready for use.
Page 27: Phone Network
Phone Network Phone Network Yealink IP phones operate on an Ethernet local area network (LAN) or wireless network. You can configure the local area network to accommodate a number of network designs, which varies by organization and Yealink IP phones.
Page 28: Ipv4 Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Default Web UI Network->Basic->Internet Port->Mode(IPv4/IPv6) T54S/T52S/T48S/T48G/T46S/T46G/T29G: Menu->Advanced (default password: admin)->Network->WAN Port->IP Mode Phone UI T42G/T42S/T41P/T41S/T40P/T40G/T27G/T23P/T23G/T21(P) E2/T19(P) E2/CP920: 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 network in a Dual-Stack mode.
Page 29 Phone Network Default Web UI Network->Basic->IPv4 Config T54S/T52S/T48S/T48G/T46S/T46G/T29G: Menu->Advanced (default password: admin)->Network->WAN Port->IPv4 Phone UI T42G/T42S/T41P/T41S/T40P/T40G/T27G/T23P/T23G/T21(P) E2/T19(P) E2/CP920: Menu->Settings->Advanced Settings (default password: admin)->Network->WAN Port->IPv4 Parameter static.network.internet_port.ip <y0000000000xx>.cfg It configures the IPv4 address. Example: Description static.network.internet_port.ip = 192.168.1.20 Note: It works only if “static.network.ip_address_mode” is set to 0 (IPv4) or 2 (IPv4 & IPv6), and "stat- ic.network.internet_port.type"...
Page 30 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones It configures the IPv4 default gateway. Example: Description static.network.internet_port.gateway = 192.168.1.254 Note: It works only if “static.network.ip_address_mode” is set to 0 (IPv4) or 2 (IPv4 & IPv6), and "stat- ic.network.internet_port.type" is set to 2 (Static IP Address).
Page 31: Ipv6 Configuration
Phone Network Menu->Advanced (default password: admin)->Network->WAN Port->IPv4->Static IP->Primary DNS Or Menu->Settings->Advanced Settings (default password: admin)->Network->WAN Port->IPv4- >DHCP->Static DNS (Enabled) ->Primary DNS T42G/T42S/T41P/T41S/T40P/T40G/T27G/T23P/T23G/T21(P) E2/T19(P) E2/CP920: Menu->Settings->Advanced Settings (default password: admin)->Network->WAN Port->IPv4->Static IPv4 Client->Pri.DNS Or Menu->Settings->Advanced Settings (default password: admin)->Network->WAN Port->IPv4- >DHCP IPv4 Client->Static DNS (Enabled) ->Pri.DNS Parameter static.network.secondary_dns <y0000000000xx>.cfg It configures the secondary IPv4 DNS server.
Page 32 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Note: It works only if “static.network.ip_address_mode” is set to 1 (IPv6) or 2 (IPv4 & IPv6). 0-DHCP Permitted Values 1-Static IP Address Default Web UI Network->Basic->IPv6 Config T54S/T52S/T48S/T48G/T46S/T46G/T29G: Menu->Advanced (default password: admin)->Network->WAN Port->IPv6...
Page 33 Phone Network Parameter static.network.ipv6_internet_port.gateway <y0000000000xx>.cfg It configures the IPv6 default gateway. Example: Description static.network.ipv6_internet_port.gateway = 3036:1:1:c3c7:c11c:5447:23a6:255 Note: It works only if “static.network.ip_address_mode” is set to 1 (IPv6) or 2 ( IPv4 & IPv6), and "stat- ic.network.ipv6_internet_port.type" is set to 1 (Static IP Address). Permitted IPv6 Address Values...
Page 34 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones T54S/T52S/T48S/T48G/T46S/T46G/T29G: Menu->Advanced (default password: admin)->Network->WAN Port->IPv6->Static IP->Primary DNS Or Menu->Advanced (default password: admin)->Network->WAN Port->IPv6->DHCP->Static DNS (Enabled) ->Primary DNS Phone UI T42G/T42S/T41P/T41S/T40P/T40G/T27G/T23P/T23G/T21(P) E2/T19(P) E2/CP920: Menu->Settings->Advanced Settings (default password: admin)->Network->WAN Port->IPv6->Static IPv6 Client->Pri.DNS Or Menu->Settings->Advanced Settings (default password: admin)->Network->WAN Port->IPv6-...
Page 35: Dhcp Option For Ipv4
DHCP Option 42, Option 2 and Option 100 DHCP Option 12 DHCP Option 120 DHCP Option 60 Supported DHCP Option for IPv4 The following table lists common DHCP options for IPv4 supported by Yealink IP phones. DHCP Parameters Description Option Subnet Mask Specify the client’s subnet mask.
Page 36: Dhcp Option 42, Option 2 And Option 100
DHCP Option 42, Option 2 and Option 100 Yealink IP phones support using the NTP server address offered by DHCP. DHCP option 42 is used to specify a list of NTP servers available to the client by IP address. NTP servers should be listed in order of preference.
Page 37: Dhcp Option 120
Phone Network For T48S IP phones: SIP-T48S. For T46G IP phones: SIP-T46G. For T46S IP phones: SIP-T46S. For T42G IP phones: SIP-T42G. For T42S IP phones: SIP-T42S. For T41P IP phones: SIP-T41P. For T41S IP phones: SIP-T41S. For T40P IP phones: SIP-T40P. For T40G IP phones: SIP-T40G.
Page 38: Dhcp Option 60
The IP 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 IP phones. DHCP Parameters Description Option DNS Server Specify a list of DNS servers available to the client.
Page 39: Dhcp Option 59 And Custom Option
In addition to manual configuration, the IP phone also supports automatic discovery of VLAN via LLDP, CDP or DHCP. The assignment takes effect in this order: assignment via LLDP/CDP, manual configuration, then assignment via DHCP. For more information on VLAN, refer to VLAN Feature on Yealink IP Phones. Topics...
Page 40 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Values 1-Enabled, the IP phone will attempt to determine its VLAN ID through LLDP. Default Web UI Network->Advanced->LLDP->Active T54S/T52S/T48S/T48G/T46S/T46G/T29G: Menu->Advanced (default password: admin) ->Network->LLDP->LLDP Status Phone UI T42G/T42S/T41P/T41S/T40P/T40G/T27G/T23P/T23G/T21(P) E2/T19(P) E2/CP920: Menu->Settings->Advanced Settings (default password: admin) ->Network->LLDP->LLDP Status Parameter static.network.lldp.packet_interval...
Page 41 Phone Network Menu->Advanced (default password: admin) ->Network->CDP->CDP Status T42G/T42S/T41P/T41S/T40P/T40G/T27G/T23P/T23G/T21(P) E2/T19(P) E2/CP920: Menu->Settings->Advanced Settings (default password: admin) ->Network->CDP->CDP Status Parameter static.network.cdp.packet_interval <y0000000000xx>.cfg It configures the interval (in seconds) at which the IP phone sends the CDP (Cisco Discovery Protocol) request. Description Note: It works only if “static.network.cdp.enable”...
Page 42 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Default Web UI Network->Advanced->VLAN->WAN Port->VID (1-4094) T54S/T52S/T48S/T48G/T46S/T46G/T29G: Menu->Advanced (default password: admin) ->Network->VLAN->WAN Port->VID Number Phone UI T42G/T42S/T41P/T41S/T40P/T40G/T27G/T23P/T23G/T21(P) E2/T19(P) E2/CP920: Menu->Settings->Advanced Settings (default password: admin) ->Network->VLAN->WAN Port->VID Number Parameter static.network.vlan.internet_port_priority <y0000000000xx>.cfg It configures the VLAN priority for the Internet port.
Page 43 DHCP VLAN Yealink IP phones support VLAN discovery via DHCP. When the VLAN discovery method is set to DHCP, the IP phone will examine DHCP option for a valid VLAN ID. The predefined option 132 is used to supply the VLAN ID by default. You can customize the DHCP option used to request the VLAN ID.
Page 44: Vlan Setting Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Menu->Settings->Advanced Settings (default password: admin) ->Network->VLAN->DHCP VLAN- >DHCP VLAN static.network.vlan.dhcp_option Parameter <y0000000000xx>.cfg It configures the DHCP option from which the IP phone will obtain the VLAN settings. You can configure at most five DHCP options and separate them by commas.
Page 45: Wi-Fi Configuration
Phone Network You can check the Wi-Fi dongle MAC address at the path: Menu->Status->Wi-Fi MAC (phone user interface) or Status->Status->Network Common->Wi-Fi MAC (web user interface). Note To use Wi-Fi feature on T48G/T48S/T46G/T46S/T42S/T41S/T29G/T27G IP phones, make sure the Wi-Fi USB dongle is prop- erly connected to the USB port on the back of the phone.
Page 46 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones works only if “static.wifi.function.enable” is set to 1 (Enabled). Permitted 0-Disabled 1-Enabled Values Default Web UI Network->Wi-Fi->Wi-Fi Active T54S/T52S/T48S/T48G/T46S/T46G/T29G: Menu->Basic->Wi-Fi->Wi-Fi Phone UI T42S/T41S/T27G/CP920: Menu->Settings->Basic Settings->Wi-Fi Parameter static.wifi.X.label <y0000000000xx>.cfg It configures the profile name of the wireless network X for the IP phone.
Page 47 Phone Network Menu->Basic->Wi-Fi->Wi-Fi (On)->Known Network->Option->Edit->SSID T42S/T41S/T27G/CP920: Menu->Settings->Basic Settings->Wi-Fi (On)->Known Network (press Add)->SSID Menu->Settings->Basic Settings->Wi-Fi->Wi-Fi (On)->Known Network->Option->Edit->SSID Parameter static.wifi.X.priority <y0000000000xx>.cfg It configures the priority for the wireless network X for the IP phone. 5 is the highest priority, 1 is the lowest priority. Description Note: It works only if “static.wifi.enable”...
Page 48 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones If “static.wifi.X.security_mode” is set to NONE, the permitted value of this parameter is NONE. If “static.wifi.X.security_mode” is set to WEP, the permitted value of this parameter is WEP. If “static.wifi.X.security_mode” is set to other values, the permitted values of this parameter are TKIP, AES or TKIP AES.
Page 49 Phone Network It configures the EAP authentication mode of the wireless network X. Note: It works only if “static.wifi.enable” is set to 1 (Enabled) and “static.wifi.X.security_mode” is set to Description WPA-EAP or WPA2-EAP. It is only applicable to T54S/T52S/T48S/T48G/T46S/T46G/T42S/T41S/T29G/T27G IP phones. Permitted TTLS, PEAP or TLS Values...
Page 50: Real-Time Transport Protocol (Rtp) Ports
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Menu->Settings->Basic Settings->Wi-Fi->Wi-Fi (On)->Known Network->Option->Edit->WPA Shared Parameter static.wifi.show_scan_prompt <y0000000000xx>.cfg It enables or disables the IP phone to prompt you whether to scan Wi-Fi after connecting Wi-Fi USB dongle WF40/WF50 to the IP phone.
Page 51: Network Address Translation (Nat)
VoIP deployments. Yealink IP phones support three NAT traversal techniques: manual NAT, STUN and ICE. If you enable manual NAT and STUN, the IP phone will use the manually-configured external IP address for NAT traversal. The TURN protocol is used as part of the ICE approach to NAT traversal.
Page 52 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Web UI Account->Register->NAT T54S/T52S/T48S/T48G/T46S/T46G/T29G: Menu->Advanced (default password: admin)->Accounts->Account X->NAT Status Phone UI T42G/T42S/T41P/T41S/T40P/T40G/T27G/T23P/T23G/T21(P) E2/T19(P) E2/CP920: Menu->Settings->Advanced Settings (default password: admin)->Accounts->AccountX->NAT Status Note: Manual NAT cannot be configured via phone user interface.
Page 53 Phone Network Note: It works only if “static.sip.nat_stun.enable” is set to 1 (Enabled). Permitted IP Address or Domain Name Values Default Blank Web UI Network->NAT->STUN->STUN Server T54S/T52S/T48S/T48G/T46S/T46G/T29G: Menu->Advanced (default password: admin) ->Network->NAT->STUN Server Phone UI T42G/T42S/T41P/T41S/T40P/T40G/T27G/T23P/T23G/T21(P) E2/T19(P) E2/CP920: Menu->Settings->Advanced Settings (default password: admin) ->Network->NAT->STUN Server Parameter static.sip.nat_stun.port <y0000000000xx>.cfg It configures the port of the STUN (Simple Traversal of UDP over NATs) server.
Page 54 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones static.sip.nat_turn.server = 218.107.220.202 Note: It works only if “static.sip.nat_turn.enable” is set to 1 (Enabled). Permitted IP Address or Domain Name Values Default Blank Web UI Network->NAT->TURN->TURN Server Parameter static.sip.nat_turn.port <y0000000000xx>.cfg It configures the port of the TURN (Traversal Using Relays around NAT) server.
Page 55: Keep Alive Configuration
Phone Network Keep Alive Configuration Yealink IP phones can send keep-alive packets to the NAT device for keeping the communication port open. The following table lists the parameters you can use to configure keep alive. Parameter account.X.nat.udp_update_enable <MAC>.cfg It configures the type of keep-alive packets sent by the IP phone to the NAT device to keep the com- Description munication port open so that NAT can continue to function.
Page 56: Sip Port And Tls Port Configuration
Settings->SIP->TLS SIP Port Internet Port and PC Port Yealink IP phones support two Ethernet ports: Internet port and PC port. You can enable or disable the PC port on the IP phones. The CP920 IP phones have Internet port only.
Page 57 Phone Network Parameter static.network.pc_port.enable <y0000000000xx>.cfg It enables or disables the PC port. Description Note: It is not applicable to CP920 IP phones. 0-Disabled Permitted Values 1-Auto Negotiation Default Web UI Network->PC Port->PC Port Active Parameter static.network.internet_port.speed_duplex <y0000000000xx>.cfg It configures the transmission method of the Internet port. Note: For T54S/T52S/T48S/T48G/T46S/T46G/T42G/T42S/T40G/T29G/T27G/T23G/CP920 IP phones, you can Description set the transmission speed to 1000Mbps/Auto Negotiation to transmit in 1000Mbps if the IP phone is con-...
Page 58: Vpn
If you change this parameter, the IP phone will reboot to make the change take effect. Yealink IP phones use OpenVPN to achieve VPN feature. To prevent disclosure of private information, tunnel endpoints must authenticate each other before secure VPN tunnel is established. After you configure VPN feature on the IP phone, the IP phone will act as a VPN client and use the certificates to authenticate with the VPN server.
Page 59: Quality Of Service (Qos)
Phone Network Default Web UI Network->Advanced->VPN->Active T54S/T52S/T48S/T48G/T46S/T46G/T29G: Menu->Advanced (default password: admin) ->Network->VPN->VPN Active Phone UI T42G/T42S/T41P/T41S/T40P/T40G/T27G/T23P/T23G/T21(P) E2/T19(P) E2/CP920: 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 Example: static.openvpn.url = http://192.168.10.25/OpenVPN.tar Permitted...
Page 60: 802.1X Authentication
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Parameter static.network.qos.audiotos <y0000000000xx>.cfg It configures the DSCP (Differentiated Services Code Point) for voice packets. Description The default DSCP value for RTP packets is 46 (Expedited Forwarding). Permitted Integer from 0 to 63...
Page 61 It configures the anonymous identity (user name) for 802.1X authentication. It is used for constructing a secure tunnel for 802.1X authentication. Description Example: static.network.802_1x.anonymous_identity = user@yealink.com Note: It works only if “static.network.802_1x.mode” is set to 2, 3, 4, 5, 6 or 7. Permitted String within 512 characters...
Page 62 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Default Blank Web UI Network->Advanced->802.1x->Identity T54S/T52S/T48S/T48G/T46S/T46G/T29G: Menu->Advanced (default password: admin) ->Network->802.1x->Identity Phone UI T42G/T42S/T41P/T41S/T40P/T40G/T27G/T23P/T23G/T21(P) E2/T19(P) E2/CP920: Menu->Settings->Advanced Settings (default password: admin) ->Network->802.1x->Identity Parameter static.network.802_1x.md5_password <y0000000000xx>.cfg It configures the password for 802.1x authentication.
Page 63: Tr-069 Device Management
TR-069 uses common transport mechanisms (HTTP and HTTPS) for communication between CPE and ACS (Auto Configuration Servers). The HTTP(S) messages contain XML-RPC methods defined in the standard for configuration and management of the CPE. For more information on TR-069, refer to Yealink TR-069 Technote. Topics Supported RPC Methods...
Page 64: Tr069 Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones RPC Method Description This method is used to cause the CPE to upload a specified file to the designated location. File types supported by IP phones are: Upload Configuration File Log File...
Page 65 Phone Network Default Blank Web UI Settings->TR069->ACS Password Parameter static.managementserver.url <y0000000000xx>.cfg It configures the access URL of the ACS (Auto Configuration Servers). Description Example: static.managementserver.url = http://officetelprov.orangero.net:8080/ftacs-digest/ACS Permitted URL within 511 characters Values Default Blank Web UI Settings->TR069->ACS URL static.managementserver.connection_request_user- Parameter <y0000000000xx>.cfg name...
Page 66 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones 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)
Page 67: Phone Provisioning
Files Download Process Boot Files Yealink IP phones support boot files. The boot files maximize the flexibility to allow you to customize features and set- tings for multiple phones. With the boot file, you can specify which configuration files should be downloaded. It is effective for you to provision...
Page 68: Common Boot File
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Customizing a Boot File Common Boot File Common boot file, named y000000000000.boot, is effective for all phones. You can use a common boot file to apply common feature settings to all of the phones rather than a single phone.
Page 69: Customizing A Boot File
For example: overwrite_mode = 1 specific_model.excluded_mode = 1 6. Save the boot file and place it on the provisioning server. Related Topic Boot File Attributes Configuration Files Yealink supports two configuration template files: Common CFG file and MAC-Oriented CFG file.
Page 70: Common Cfg File
Static: The parameters start with a prefix “static.”, for example, static.auto_provision.custom.protect. Non-static: The parameters do not start with a prefix “static.”, for example, local_time.date_format. You can deploy and maintain a mass of Yealink IP phones automatically through configuration files stored in a pro- visioning server.
Page 71: Mac-Oriented Cfg File
Phone Provisioning Phone Model Common CFG file T21(P) E2 y000000000052.cfg T19(P) E2 y000000000053.cfg CP920 y000000000078.cfg MAC-Oriented CFG File MAC-Oriented CFG file, which is named after the MAC address of the IP phone. For example, if the MAC address of an IP phone is 00156574B150, the name of MAC-Oriented CFG file is 00156574b150.cfg (lowercase).
Page 72: Configuration File Attributes
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones [T46S,T48S]voice_mail.number.1 = *5 [T27G]account.1.dnd.enable = 1 [T46S]account.2.dnd.enable = 1 [T48S]features.dnd.enable = 0 ## These parameters only apply to their own specific phone models. 4. Save the configuration file and place it on the provisioning server.
Page 73: Supported Resource Files
Phone Provisioning Supported Resource Files Yealink supplies some template of resource files for you, so you can directly edit the files as required. The following table lists the resource files Yealink supplies: Reference in Sec- Template File File Name Description...
Page 74: Provisioning Methods
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones The parameters in the newly downloaded configuration files will override the same parameters in files downloaded earlier. Note For the phone running firmware version 82 or earlier, it downloads configuration files referenced in the boot file in sequence.
Page 75: Provisioning Methods Priority
Phone Provisioning Viewing Configurations Configured via Different Provisioning Methods Provisioning Methods Priority There is a priority for configuration among the provisioning methods - settings you make using a higher priority pro- visioning method override settings made using a lower priority provisioning method. The precedence order for configuration parameter changes is as follows (highest to lowest): Note The provisioning priority mechanism takes effect only if “static.auto_provision.custom.protect”...
Page 76: Accessing The Web User Interface
It is helpful to quickly log into the web user interface without entering the username and password in the login page. Yealink IP phones support domain name customization. You can use a custom domain name to access the web user interface.
Page 77: Web Server Type Configuration
Web Server Type Configuration Yealink IP phones support both HTTP and HTTPS protocols for accessing the web user interface. You can configure the web server type. Web server type determines access protocol of the web user interface. If you disable to access web user interface using the HTTP/HTTPS protocol, both you and the user cannot access the web user interface.
Page 78: Navigating The Web User Interface
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Web UI Network->Advanced->Web Server->HTTPS T54S/T52S/T48S/T48G/T46S/T46G/T29G: Menu->Advanced (default password: admin) ->Network->Web Server->HTTPS Status Phone UI T42G/T42S/T41P/T41S/T40P/T40G/T27G/T23P/T23G/T21(P) E2/T19(P) E2/CP920: Menu->Settings->Advanced Settings (default password: admin) ->Network->Web Server->HTTPS Status Parameter static.network.port.https <y0000000000xx>.cfg It configures the HTTPS port for the user to access the web user interface of the IP phone using the HTTPS Description protocol.
Page 79: Phone User Interface
The following figure shows how the phone interoperates with provisioning server when you use the centralized pro- visioning method: Yealink IP phones can obtain the provisioning server address during startup. Then IP phones first download boot files and configuration files from the provisioning server, and then resolve and update the configurations written in con- figuration files.
Page 80: Auto Provisioning Settings Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones The IP phones can be configured to upload log files (log files provide a history of phone events), call log files and con- tact files to the provisioning server. You can also configure a directory for each of these three files respectively.
Page 81 Phone Provisioning It enables or disables the IP phone to reboot after auto provisioning, even if there is no specific con- figuration requiring a reboot. It is especially useful when there is no specific configuration requiring reboot in the configuration files, but you want the IP phone to reboot after auto provisioning. Note: It works only for the current auto provisioning process.
Page 82 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Description It triggers the weekly feature to on or off. 0-Off Permitted Values 1-On, the IP phone will perform an auto provisioning process weekly. Default Web UI Settings->Auto Provision->Weekly Parameter static.auto_provision.weekly_upgrade_interval <y0000000000xx>.cfg...
Page 83 Phone Provisioning weeks. Note: It works only if “static.auto_provision.weekly.enable” is set to 1 (On). 0,1,2,3,4,5,6 or a combination of these digits 0-Sunday 1-Monday 2-Tuesday Permitted Values 3-Wednesday 4-Thursday 5-Friday 6-Saturday Default 0123456 Web UI Settings->Auto Provision->Day of Week static.auto_provision.weekly.begin_time Parameter <y0000000000xx>.cfg static.auto_provision.weekly.end_time It configures the starting/ending time of the day for the IP phone to perform auto provisioning weekly.
Page 84 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones MAC address. Note: It works only if “static.auto_provision.flexible.enable” is set to 1 (On). Permitted Integer from 1 to 1000 Values Default Web UI Settings->Auto Provision->Flexible Interval Days Parameter static.auto_provision.flexible.begin_time <y0000000000xx>.cfg It configures the starting time of the day for the IP phone to perform auto provisioning at random.
Page 85: User-Triggered Provisioning Settings Configuration
Phone Provisioning Description It enables or disables the long connection for downloading files via auto provisioning. Permitted 0-Disabled, the IP phone uses the short connection for downloading files via auto provisioning 1-Enabled Values Default Parameter static.auto_provision.authentication.expired_time <y0000000000xx>.cfg It configures the timeout (in seconds) after which the authentication pop-up box for auto provisioning Description will disappear.
Page 86 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Default Blank [1][2] static.autoprovision.X.user Parameter <y0000000000xx>.cfg It configures the user name for authentication during auto provisioning which is triggered by activation Description code. Permitted String within 64 characters Values Default Blank [1][2] static.autoprovision.X.password...
Page 87: Viewing Configurations Configured Via Different Provisioning Methods
Phone Provisioning Viewing Configurations Configured via Different Provisioning Methods On the web user interface, you can click after each configuration to see its detailed information. It is only applic- able to T48S/T46S/T42S/T41S/T27G/CP920 IP phones. From the detailed information, you can do the following: Check whether settings you make using a higher priority provisioning method override settings made using a lower priority provisioning method.
Page 88: Supported Provisioning Protocols
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Supported Provisioning Protocols Yealink IP phones support several transport protocols for provisioning: Trivial File Transfer Protocol (TFTP) File Transfer Protocol (FTP) Hyper Text Transfer Protocol – Secure (HTTPS) File Transfer Protocol – Secure (FTPS) Note There are two types of FTP methods—active and passive.
Page 89: Zero Touch Provision Configuration
Phone Provisioning PnP: PnP feature allows IP phones to discover the provisioning server address by broadcasting the PnP SUBSCRIBE message during startup. DHCP: DHCP option can be used to provide the address or URL of the provisioning server to IP phones. When the IP phone requests an IP address using the DHCP protocol, the resulting response may contain option 66 (for IPv4)/op- tion 59 (for IPv6) or the custom option (if configured) that contains the provisioning server address.
Page 90: Pnp Provision Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Parameter static.features.hide_zero_touch_url.enable <y0000000000xx>.cfg Description It enables or disables the phone to hide the provisioning URL item on the Zero Touch screen. Permitted 0-Disabled 1-Enabled Values Default PnP Provision Configuration The following table lists the parameter you can use to configure PnP provision.
Page 91: Static Provision Configuration
Phone Provisioning Note: It works only if “static.auto_provision.dhcp_option.enable” is set to 1 (On). Permitted Integer from 135 to 65535, except 143 Values Default Blank Web UI Settings->Auto Provision->IPv6 Custom Option Parameter static.auto_provision.url_wildcard.pn <y0000000000xx>.cfg It configures the characters to replace the wildcard $PN in the received URL of the provisioning server. Description Note: The configured characters must be in accordance with the actual directory name of the pro- visioning server.
Page 92: Configuring A Provisioning Server
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Note A URL should contain forward slashes instead of backslashes and should not contain spaces. Escape characters are not sup- ported. If a user name and password are not specified as part of the provisioning server address, the User Name and Password of the provisioning server configured on the phone will be used.
Page 93: Keeping User's Personalized Settings After Auto Provisioning
Phone Provisioning Keeping User’s Personalized Settings after Auto Provisioning Generally, you deploy phones in batch and timely maintain company phones via auto provisioning, yet some users would like to keep the personalized settings (for example, ring tones, wallpaper or DSS keys) after auto provisioning. Topics Keeping User’s Personalized Settings Configuration Auto Provisioning Flowchart for Keep User’s Personalized Configuration Settings...
Page 94: Auto Provisioning Flowchart For Keep User's Personalized Configuration Settings
Default Auto Provisioning Flowchart for Keep User’s Personalized Configuration Settings The following shows auto provisioning flowchart for Yealink IP phones when a user wishes to keep user’s personalized configuration settings. Example: Keeping User’s Personalized Settings This section shows you how to keep the personalized settings.
Page 95: Clearing User's Personalized Configuration Settings
Phone Provisioning Parameters Settings: static.auto_provision.custom.protect =1 After provisioning, if the users make changes via phone user interface or web user interface, the MAC-local.cfg file with non-static personal settings generates locally. Scenario: Keeping user’s personalized settings when upgrading the firmware If you set “ static.auto_provision.custom.sync =1 ”, then the phones attempt to upload the MAC-local.cfg file to the pro- visioning server each time the file updates.
Page 96 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones For example, 001565b09d886.boot and y000000000000.boot. 2. Create per-phone configuration files or common configuration files, and edit the feature parameters in the file you want to apply to the phones. For example, phone_setting.contrast = 7...
Page 97 Phone Provisioning For the parameter settings in the CustomSettings.cfg file, the phone-specific parameters will only take effect on the spe- cific phone models. The following shows the provisioning flowchart for different phone models with phone-specific settings.
Page 98 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones...
Page 99: Firmware Upgrade
Firmware Upgrade Configuration Firmware for Each Phone Model You can download the latest firmware online: http://support.yealink.com/documentFront/forwardToDocumentFrontDisplayPage. The following table lists the associated and latest firmware name for each IP phone model (X is replaced by the actual firmware version). IP Phone Model...
Page 100 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Firmware Upgrade Configuration Before upgrading firmware, you need to know the following: Do not close and refresh the browser when the IP phone is upgrading firmware via web user interface. Do not unplug the network cables and power cables when the IP phone is upgrading firmware.
Page 101: Phone Customization
Recent Call Display in Dialing Recent Call Display in Dialing Icon Customization Warnings Display Language Yealink IP phones support multiple languages. Languages used on the phone user interface and web user interface can be specified respectively as required. Topics Supported Languages Language Display Configuration...
Page 102: Supported Languages
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Supported Languages You can ask the distributor or Yealink FAE for language packs. You can also obtain the language packs online: http://support.yealink.com/documentFront/forwardToDocumentFrontDisplayPage. The following table lists available languages and associated language packs supported by the phone user interface and the web user interface.
Page 103: Language For Phone Display Customization
Phone Customization English, Chinese_S, Chinese_T, French_CA, French, German, Italian, Polish, Portuguese, Portuguese_LA, Spanish, Spanish_LA, Turkish, Russian or the custom language name. T48G/T46G/T42G/T41P/T40P: English, Chinese_S, Chinese_T, French, German, Italian, Polish, Portuguese, Spanish, Turkish, Russian or the custom language name. Default English T54S/T52S/T48S/T48G/T46S/T46G/T29G: Menu->Basic->Language Phone UI...
Page 104: Custom Language For Phone Display Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/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.
Page 105: Language For Web Display Customization
You can also customize the translation of the note language pack. The note information is displayed in the icon 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. Topics...
Page 106: Customizing A Language Pack For Note Display
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Save the language pack and place it to the provisioning server. 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 12, “name”...
Page 107: Custom Language For Web And Note Display Configuration
Phone Customization Custom Language for Web and Note Display Configuration If you want to add a new language (for example, Wuilan) to IP phones, prepare the language file named as “12.Wuilan.js” and “12.Wuilan_note.xml” for downloading. After the update, you will find a new language selection “Wuilan”...
Page 108: Wallpaper
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones For T29G IP phones, it configures the LCD’s contrast of the connected EXP20 only. For T27G IP phones, it configures the LCD’s contrast of the IP phone and the connected EXP20.
Page 109: Wallpaper Customization
Phone Customization Note On T54S/T52S/T46S/T46G/T29G IP phones, the line and soft key labels display over the wallpaper picture. The following table lists the parameters you can use to change the wallpaper. Parameter phone_setting.backgrounds <y0000000000xx>.cfg It configures the wallpaper displayed on the IP phone Idle screen. Description Note: It is only applicable to T54S/T52S/T48S/T48G/T46S/T46G/T29G IP phones.
Page 110: Custom Wallpaper Picture Limit
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Custom Wallpaper Configuration Deleting a Custom Picture Custom Wallpaper Picture Limit Either the smaller or the larger picture will be scaled proportionally to fit the screen. The wallpaper picture format must...
Page 111: Transparency
Phone Customization wallpaper_upload.url = http://192.168.10.25/wallpaper.jpg phone_setting.backgrounds = wallpaper.jpg After provisioning, the phone idle screen wallpaper changes to custom picture “wallpaper.jpg”. Transparency The T54S/T52S/T48S/T48G IP phones display line keys and status bar transparently. If you use a custom picture with a color or complex background, it may affect the user’s experience.
Page 112: Screensaver Display Customization
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones You can set custom pictures as the screen saver. You can also add personal pictures on your phone using a USB flash drive. The time & date, certain status icons (for example, auto answer, DND, a new text message), or custom information (for example, notifications or company logo) is also configurable to display on the screen saver.
Page 113: Screensaver File Elements And Attributes
Phone Customization 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 you do not edit these elements and attributes. Description Elements Attributes LineSpacing The vertical distance between different lines.
Page 114: Customizing The Screen Saver File
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/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.
Page 115 Phone Customization 21600-6h Default 21600 Web UI Settings->Preference->Screensaver Wait Time T54S/T52S/T48S/T48G/T46S/T46G/T29G: Menu->Basic->Display->Screensaver->Wait Time Phone UI T42G/T42S/T41P/T41S/T40P/T40G/T27G/T23P/T23G/T21(P) E2/T19(P) E2/CP920: Menu->Settings->Basic Settings->Display->Screensaver->Wait Time(s) Parameter screensaver.display_clock.enable <y0000000000xx>.cfg It enables or disables the IP phone to display the clock and icons when the screen saver starts. Description Note: It works only if “screensaver.type”...
Page 116 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones If you want to upload multiple screen saver images to the phone simultaneously, you can configure as fol- lowing: screensaver.upload_url = http://192.168.10.25/Screencapture.jpg screensaver.upload_url = http://192.168.10.25/Screensaver.jpg Note: It is only applicable to T54S/T52S/T48S/T48G/T46S/T46G/T29G IP phones.
Page 117: Adding A Screensaver Picture From A Usb Flash Drive
Phone Customization Values Default Parameter screensaver.picture_change_interval <y0000000000xx>.cfg It configures the interval (in seconds) for the IP phone to change the picture when the screen saver starts. Note: It works only if “screensaver.type” is set to 1 (Upload Picture) and the parameter “screensaver- Description .upload_url”...
Page 118: Supported Backlight Options
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Always On: Backlight is on permanently. Always Off: Backlight is off permanently. It is not available for the T54S/T52S/T48S/T48G/T46S/T46G/T29G IP phone. 15s, 30s, 1min, 2min, 5min, 10min or 30min: Backlight is changed when the phone is inactive after the designated time (in seconds).
Page 119 Phone Customization Menu->Basic->Display->Backlight->Active Level T27G: Menu->Settings->Basic Settings->Display->Backlight Parameter phone_setting.inactive_backlight_level <y0000000000xx>.cfg It configures the intensity of the LCD screen when the phone is inactive. Note: It is applicable to theT54S/T52S/T48S/T48G/T46S/T46G/T29G IP phone. If expansion module EXP20 Description or EXP40 is connected, the backlight on the expansion module automatically changes to match this set- ting.
Page 120: Label Length For Line Key Display
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Label Length for Line Key Display By default, the line key label only displays the first few characters when the length of the label exceeds the maximum length. You can specify the line key label length as needed. It is only applicable to T54S/T48S/T48G/T46S/T46G/T29G IP phones.
Page 121: Label Length Display Configuration
Phone Customization 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 It configures the label length displayed on the idle LCD screen for the line key. Description Note: It is only applicable to T54S/T48S/T48G/T46S/T46G/T29G IP phones.
Page 122: Linekey Length In Short
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones It configures the alignment mode of line key/ext key label. Note: It is only applicable to T54S/T52S/T46S/T46G/T29G IP phones and EXP50 expansion modules con- Description nected to the T54S/T52S IP phones. If some ext keys already exist before configuration, you need to refresh the page (press the page keys, or try re-connecting the expansion module) to make the change take effect.
Page 123: Linekey Length In Short Configuration
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 T54S/T52S/T46S/T46G/T42S/T42G/T41P/T41S/T29G/T27G IP phones and expansion module EXP50 support page switch key. Topics...
Page 124: Phone Page Tips
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Phone Page Tips On T54S/T52S/T46S/T46G/T42S/T42G/T41P/T41S/T29G/T27G IP phones, the page tips feature supports the page icon and page switch key LED to indicate different line key status. Topics Phone Page Tips Indicator...
Page 125: Expansion Module Page Tips
Phone Customization Note: It is only applicable to T54S/T52S/T46S/T46G/T42S/T42G/T41S/T41P/T29G/T27G IP phones. Permitted 0-Disabled 1-Enabled Values Default Web UI Dsskey->Line Key->Enable Page Tips Expansion Module Page Tips On expansion module EXP50, the page tips feature supports page switch key LED to indicate that BLF monitored user receives an incoming call on the non-current page.
Page 126: Time And Date
Time and Date Yealink IP phones maintain a local clock. You can choose to get the time and date from SNTP (Simple Network Time Protocol) time server to have the most accurate time and set DST (Daylight Saving Time) to make better use of daylight and to conserve energy, or you can set the time and date manually.
Page 127 Phone Customization Time Zone Time Zone Name Time Zone Time Zone Name Guatemala E.Europe El Salvador Tripoli Honduras Romania(Bucharest) Nicaragua Syria(Damascus) Costa Rica Turkey(Ankara) Belize Ukraine(Kyiv, Odessa) Canada-Manitoba(Winnipeg) East Africa Time Chile(Easter Islands) Iraq(Baghdad) Guadalajara Russia(Moscow) Monterrey St.Petersburg Mexico(Mexico City,Acapulco) Kuwait,Riyadh Saskatchewan Nairobi...
Page 128 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Time Zone Time Zone Name Time Zone Time Zone Name Trinidad&Tobago +5:30 India(Calcutta) -3:30 Canada-New Foundland(St.Johns) +5:30 Mumbai,Chennai Greenland(Nuuk) +5:30 Kolkata,New Delhi Argentina(Buenos Aires) +5:30 Sri Jayawardenepura Brazil(no DST) +5:45 Nepal(Katmandu)
Page 129: Ntp Settings
Phone Customization Time Zone Time Zone Name Time Zone Time Zone Name Belgium(Brussels) Russia(Vladivostok) Caicos Magadan (RTZ 9) Belgrade Guam,Port Moresby Bratislava Solomon Islands Ljubljana +10:30 Australia(Lord Howe Islands) Chad New Caledonia(Noumea) Copenhagen Chokurdakh (RTZ 10) West Central Africa Russia(Srednekolymsk Time) Poland(Warsaw) +11:30 Norfolk Island...
Page 130 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Description It configures the priority for the IP phone to use the NTP server address offered by the DHCP server. 0- High (use the NTP server address offered by the DHCP server preferentially)
Page 131: Dst Settings
Phone Customization Menu->Basic->Time & Date->General->SNTP Settings->NTP Server2 T42G/T42S/T41P/T41S/T40P/T40G/T27G/T23P/T23G/T21(P) E2/T19(P) E2/CP920: Menu->Settings->Basic Settings->Time&Date->SNTP Settings->NTP Server2 Parameter local_time.interval <y0000000000xx>.cfg Description It configures the interval (in seconds) at which the phone updates time and date from the NTP server. Permitted Integer from 15 to 86400 Values Default 1000...
Page 132: Auto Dst File Attributes
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 template. You can also obtain the DST template online: http://sup- port.yealink.com/documentFront/forwardToDocumentFrontDisplayPage.
Page 133: Dst Configuration
Phone Customization <DST szTime="+6" szZone="Paradise" iType="1" szStart="3/5/7/2" szEnd="10/5/7/3" szOffset="30"/> Modify the DST settings for the existing time zone “+5 Pakistan(Islamabad)” and add DST settings for the existing time zone “+5:30 India(Calcutta)”. 4. Save this file and place it to the provisioning server. Related Topic Time Zone DST Configuration...
Page 134 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones 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 It works only if “local_time.summer_time” is set to 1 (Enabled).
Page 135: Time And Date Manually Configuration
Phone Customization Permitted Integer from -300 to 300 Values Default Blank Web UI Settings->Time&Date->Offset(minutes) Parameter auto_dst.url <y0000000000xx>.cfg It configures the access URL of the DST file (AutoDST.xml). Description Note: It works only if "local_time.summer_time" is set to 2 (Automatic). URL within 511 characters Permitted Values For example, tftp://192.168.1.100/AutoDST.xml...
Page 136 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Menu->Basic->Time & Date->Time & Date Format->Time Format T42G/T42S/T41P/T41S/T40P/T40G/T27G/T23P/T23G/T21(P) E2/T19(P) E2/CP920: Menu->Settings->Basic Settings->Time&Date->Time & Date Format->Time Format Parameter local_time.date_format <y0000000000xx>.cfg It configures the date format. Description Note: The value configured by the parameter “lcl.datetime.date.format” takes precedence over that con- figured by this parameter.
Page 137: Date Customization Rule
Phone Customization One or more than one “D” (for example, DDD) represents a two-digit day; “W”/“WW” represents the abbreviation of the day of the week, three or more three “W” letters (for example, WWW) represent the long format of the day of the week. For the more rules, refer to Date Customization Rule.
Page 138: Logo Customization
Before uploading your custom logo to IP phones, ensure your logo file is correctly formatted. Customizing a Logo Picture Yealink IP phones only support the *.dob format logo picture. Yealink provides PictureExDemo tool to convert *.bmp format to *.dob format. You can ask the distributor or Yealink FAE for the PictureExDemo tool.
Page 139: Custom Logo Configuration
Phone Customization 1. Double click the PictureExDemo.exe. 2. Click Add button to open a *.bmp file. You can repeat the step 2 to add multiple original picture files. 3. Click the Convert button. Then you can find the DOB logo files in the adv directory. Custom Logo Configuration The following table lists the parameters you can use to configure custom logo.
Page 140: Example: Setting A Custom Logo Display
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Parameter lcd_logo.url <y0000000000xx>.cfg It configures the access URL of the custom logo file. Description Note: It works only if “phone_setting.lcd_logo.mode” is set to 2 (Custom Logo). It is not applicable to T54S/T52S/T48S/T48G/T46S/T46G/T29G IP phones.
Page 141: Call Display Configuration
Phone Customization Call Display Configuration The following table lists the parameters you can use to configure call display. Parameter phone_setting.contact_photo_display.enable <y0000000000xx>.cfg It configures whether to display contact avatar when it receives an incoming call, dials an outgoing call or engages in a call. Description Note: It is only applicable to T54S/T52S/T48S/T48G/T46S/T46G/T29G IP phones.
Page 142 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones 5-Null Default Web UI Settings->Call Display->Call Information Display Method Parameter phone_setting.call_display_name.mode <y0000000000xx>.cfg It specifies which display names to be used as the caller ID/callee ID for calls from/to contacts in the phone directory.
Page 143: Display Method On Dialing
When the IP phone is on the pre-dialing or dialing screen, the account information will be displayed on the LCD screen. Yealink IP phones support three display methods: Label, Display Name and User Name. You can customize the account information to be displayed on the IP phone as required.
Page 144: Softkey Layout
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Parameter features.key_as_send <y0000000000xx>.cfg Description It configures the "#" or "*" key as the send key. 0-Disabled, neither “#” nor “*” can be used as the send key. Permitted 1-# key, the pound key is used as the send key.
Page 145: Supported Call States And Soft Keys
Phone Customization Supported Call States and Soft Keys Softkey Layout File Customization Softkey Layout Configuration Example: Setting the Soft Keys Layout in Talking State Supported Call States and Soft Keys The following table lists soft keys available for IP phones in different call states. Call States Enabled Soft Keys Disabled Soft Keys...
Page 146 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Call States Enabled Soft Keys Disabled Soft Keys Retrieve Send Empty DialConference History Delete Directories Cancel Directories Empty DialConferenceEmpty Empty History Cancel B Transfer Empty DialTrans Send History (Transfer to) Delete...
Page 147 Phone Customization Call States Enabled Soft Keys Disabled Soft Keys Security Join (only applicable to CP920) Empty Transfer Switch Resume Park Hold NewCall GPark End Call Security Join (only applicable to CP920) Empty Switch Transfer NewCall Hold Held Park Conference GPark End Call Security...
Page 148: Softkey Layout File Customization
Softkey Layout File Customization You can also configure the softkey layout using the softkey layout templates for different call states. You can ask the distributor or Yealink FAE for softkey layout template. You can also obtain the softkey layout template online: http://support.yealink.com/documentFront/forwardToDocumentFrontDisplayPage.
Page 149: Customizing Softkey Layout File
Phone Customization Elements & Attributes Description <Default> Specify the default soft key list. </Default> The phone screen displays these soft keys by default. <Key Type=" "/> Specify the soft key type. Customizing Softkey Layout File 1. Open the template file. 2.
Page 150: Softkey Layout Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones 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 151 Phone Customization custom_softkey_call_failed.url = http://192.168.1.20/XMLfiles/CallFailed.xml During auto provisioning, the IP phone connects to the provisioning server “192.168.1.20”, and down- loads the CallFailed.xml file from the “XMLfiles” directory. Note: It works only if “phone_setting.custom_softkey_enable” is set to 1 (Enabled). Permitted URL within 511 characters Values Default Blank...
Page 152: Example: Setting The Soft Keys Layout In Talking State
After provisioning, you can use the enabled soft keys during a call. Input Method Yealink IP phones support 6 input methods: 2aB, abc, Abc, 123, ABC and Hebrew. You can specify the default input method for entering different types of data. You can also customize the existing input method.
Page 153: Input Method File Customization
IP phone in advance. The changes in the “Hebrew_ime.txt” file becomes effective when the language is set to Hebrew. You can ask the distributor or Yealink FAE for keypad input method file. You can also obtain the keypad input method file online: http://support.yealink.com/documentFront/forwardToDocumentFrontDisplayPage.
Page 154: Input Method Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones If you just want to customize the input method for a certain language, the file name must be “language name_ime.txt” (for example, German_ime.txt). The valid language names are: English, Chinese_S, Chinese_T, French_CA, French, German, Italian, Polish, Portuguese, Portuguese_LA, Spanish, Spanish_LA, Turkish and Russian.
Page 155: Notification Popups
Phone Customization 5-2aB Default Parameter directory.edit_default_input_method <y0000000000xx>.cfg It configures the default input method when the user edits contacts in the Local Directory, LDAP, Remote Phone Book, Blacklist or Network Directory. Description Example: directory.edit_default_input_method = abc Permitted Abc, 2aB, 123, abc or ABC Values Default Parameter directory.search_default_input_method...
Page 156: Notification Popups Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Topic Notification Popups Configuration Notification Popups Configuration The following table lists the parameters you can use to configure notification popups. Parameter features.voice_mail_popup.enable <y0000000000xx>.cfg It enables or disables the IP phone to pop up the message when it receives a new voice mail.
Page 157: Power Led Indicator
Phone Customization Permitted 0-Disabled 1-Enabled Values Default Web UI Features->Notification Popups->Display Forward Call Popup Parameter features.text_message_popup.enable <y0000000000xx>.cfg It enables or disables the IP phone to pop up the message when it receives a new text message. Description Note: It works only if “features.text_message.enable” is set to 1. It is not applicable to CP920 IP phones. Permitted 0-Disabled 1-Enabled...
Page 158 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Default Web UI Features->Power LED->Common Power Light On Parameter phone_setting.ring_power_led_flash_enable <y0000000000xx>.cfg It enables or disables the power LED indicator to flash when the IP phone receives an incoming call. Descrip- tion Note: It is not applicable to CP920 IP phones.
Page 159 Phone Customization 1-Enabled (power LED indicator fast flashes (300ms) red) For T19(P) E2 IP phones: 0-Disabled (power LED indicator does not flash) 1-Enabled (power LED indicator fast flashes (300ms) yellow) Default Web UI Features->Power LED->Mute Power Light Flash phone_setting.hold_and_held_power_led_flash_ Parameter <y0000000000xx>.cfg enable It enables or disables the power LED indicator to flash when a call is placed on hold or is held.
Page 160: Bluetooth
Features->Power LED->MissCall Power Light Flash Bluetooth Yealink IP phones support Bluetooth. You can pair and connect a Bluetooth headset or Bluetooth-Enabled mobile phone with the IP phone. After connecting the Bluetooth-Enabled mobile phone, you can choose to synchronize the mobile contacts to the IP phone. It is only applicable to T54S/T52S/T48S/T48G/T46S/T46G/T42S/T41S/T29G/T27G/CP920 IP phones.
Page 161 Note: It works only if “features.bluetooth_enable” is set to 1 (On). It is only applicable to T54S/T52S/T48S/T48G/T46S/T46G/T42S/T41S/T29G/T27G/CP920 IP phones. Permitted String within 64 characters Values For T54S IP phones: Yealink T54S. For T52S IP phones: Yealink T52S. For T48G IP phones: Yealink T48G. For T48S IP phones: Yealink T48S. For T46G IP phones: Yealink T46G.
Page 162: Handset/Headset/Speakerphone Mode
If you change this parameter, the IP phone will reboot to make the change take effect. Handset/Headset/Speakerphone Mode Yealink IP phones support three ways to place/answer a call: using the handset, using the headset or using the speak- erphone. You can disable the infrequently used audio device as required.
Page 163: Dss Keys
Phone Customization Permitted 0-Disabled 1-Enabled Values Default Parameter features.headset_mode.enable <y0000000000xx>.cfg It enables or disables the phone’s headset mode. Description Note: It is not applicable to CP920 IP phones. Permitted 0-Disabled 1-Enabled Values Default Parameter phone_setting.headsetkey_mode <y0000000000xx>.cfg It configures headset mode precedence during a call. Description Note: It is not applicable to CP920 IP phones.
Page 164: Supported Dsskey Types
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Phone Model Line Keys Programmable Keys Ext Keys T46G/S T42G/S T41P/S T40P/G T29G T27G T23P/G T19(P) E2 CP920 Supported Dsskey Types The supported Dsskey function types vary by line keys, programmable keys and Ext keys.
Page 165: Line Keys
Phone Customization 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) XML Directory Group Listening (Line key/Pro- (Line key/Ext key) grammable key) Line Keys Line keys provide one-touch feature (for example, one-touch park).
Page 166 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Note: It is not applicable to T19(P) E2/CP920 IP phones. 38-LDAP (only appear when “ldap.enable=1”) 39-BLF List 0-N/A 15-Line 1-Conference 40-Prefix 16-BLF 2-Forward 41-Zero Touch 17-URL 3-Transfer 42-ACD 18-Group Listening 4-Hold...
Page 167 Phone Customization T21(P) E2: 1-2 Default Web UI Dsskey->Line Key->Line KeyX->Line Phone UI Menu->Features->DSS Keys->Line Key X->Account ID Parameter linekey.X.value <y0000000000xx>.cfg It configures the value for some line key features. For example, when you assign the Speed Dial to the line key, this parameter is used to specify the contact number you want to dial out.
Page 168 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones It configures the pickup code. Note: It is only applicable when “linekey.X.type” is set to 13, 14, 16, 24 or 39. It is not applicable to T19(P) E2/CP920 IP phones. For multicast paging:...
Page 169: Example: Set A Park/Retrieve Key For Fac Call Park Mode
Phone Customization X is the line key ID. For T48G/T48S, X=1-29; For T54S/T46G/T46S/T29G, X=1-27; for T52S/T27G, X=1-21; for T42G/T42S/T41P/T41S, X=1-15; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2. Example: Set a Park/Retrieve Key for FAC Call Park Mode Scenario Conditions Related Topic features.call_park.park_code = *68 features.call_park.park_retrieve_code = *88 Call Park and Retrieve...
Page 170: Example: Setting A Line Key As Directed Pickup Key
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones linekey.1.label =Bill ######Set a Retrieve key#### linekey.3.type = 56 linekey.3.line = 1 linekey.3.value =*11 linekey.3.label =Retrieve Bill After provisioning, you can easily press the Park key (line key 1) to park a call to the specific shared parking lot (*01) during a call, and press the Retrieve key (line key 3) to retrieve the parked call from the shared parking lot (*01) using the retrieve code (*11).
Page 171: Example: Setting A Line Key As Forward Key
Phone Customization linekey.1.label =Sell After provisioning, you can easily press the Group Pickup key (line key 1) to pick up an incoming call to any phone within a predefined group of phones. Note If the “linekey.X.value” is not assigned with a group pickup code, the Park key will invoke the group pickup code set by “fea- tures.pickup.group_pickup_code”...
Page 172: Example: Setting A Line Key As Blf List Key
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones After provisioning, you can easily press the Forward key (line key 1 or line key 2) to activate/deactivate the always for- ward feature. For example, after pressing line key 1 to activate always forward and forward all calls to Bill (4603), you can press the line key 1 to deactivate always forward, or press line key 2 to switch the forward target and forward all calls to Tom (4605).
Page 173: Supported Programmable Keys
Phone Customization Supported Programmable Keys The following tables list programmable keys for each phone model. T52S/T42G/T42S/T41- Pro- T19(P) T23P/T23G/T2- T29G/T27- T54S/T48G/T48S/T46G/T46- grammable CP920 1(P) E2 Key IDs T41S/T40P/T40G SoftKey- SoftKey- SoftKey1 SoftKey1 SoftKey1 SoftKey1 SoftKey- SoftKey- SoftKey2 SoftKey2 SoftKey2 SoftKey2 SoftKey- SoftKey- SoftKey3...
Page 174 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones To remove a function type, specify programmable key type IDs which start with the symbol “-”. For example, “-14, 5, 2” means to remove “Intercom”, “DND”, “Forward” types from the Dsskey function types list.
Page 175 Phone Customization Values 1-Network CallLog (only appear when "bw.enable=1" and "bw.xsi.call_log.enable=1") Default Web UI Dsskey->Programmable Key->Line Parameter programablekey.X.line <y0000000000xx>.cfg It configures the desired line to apply the programmable key feature. Description Note: It is not applicable to T19(P) E2 IP phones. T48G/T48S/T54S/T46G/T46S/T29G: 1-16;...
Page 176: Ext Keys
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Values Default Blank Web UI Dsskey->Programmable Key->Label Parameter programablekey.X.extension <y0000000000xx>.cfg For multicast paging: It configures the channel of the multicast paging group. Description For intercom feature: It configures the pickup code.
Page 177: Ext Keys Configuration
Phone Customization Ext Keys Configuration The following table lists the parameters you can use to configure ext keys. Parameter expkey.type_range.custom <y0000000000xx>.cfg It configures the list for available ext key types list when configuring ext keys. To assign function types, specify ext key type IDs which start with or without a symbol ”+”. For example, “+2,15,16,7,4”...
Page 178 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Y=1 or 21, default: 37 – Switch, only for T29G/T27G Y=2-20, 22-40, default: 0 – NA, only for T29G/T27G Web UI Dsskey->Ext Key->Type Parameter expansion_module.X.key.Y.line <y0000000000xx>.cfg It configures the desired line to apply the ext key feature.
Page 179: Enhanced Dss Keys
The rules for configuring EDK for DSS keys are different. Before using EDK, you are advised to become familiar with the macro language. For more information on Enhanced DSS Keys, refer to Using Enhanced DSS Keys on Yealink IP Phones. Topics...
Page 180: Guidelines For Configuring Enhanced Dss Keys
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Macro Action Strings EDK Configuration EDK List Configuration 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...
Page 181 Example: $Sanswer$ means pressing the Answer soft key. $S<softkey ID>$ Yealink IP phones support customizing soft keys. When invoking a custom soft key, the prefix “#” must be added. Example: If the custom softkey label is IVR1, the custom softkey ID is custom_ macro, then $S#custom_macro$ means pressing the IVR1 soft key.
Page 182 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Macro Action Description ExtX@Y (X stands for the serial number of expansion module key, Y stands for the serial number of expansion module; For T48S/T48G/T46S/T46G/T29G: X ranges from 1 to 40, Y ranges from 1 to 6; For T54S/T52S: X ranges from 1 to 60, Y ranges from 1 to 3;...
Page 183: Edk Configuration
EDK feature is disabled. Yealink IP phones can display the softkey ID or menu item ID by long pressing the Volume Up key. It is especially useful for those users who need to view the softkey ID or menu item ID when configuring EDK macros.
Page 184: Edk List Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/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...
Page 185: Edk User Input Prompt Configuration
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 smal- lest value of X. It works only if “features.enhanced_dss_keys.enable” is set to 1 (Enabled). Permitted String Values...
Page 186 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Default Default Parameter edk.edkprompt.X.type <y0000000000xx>.cfg 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 187: Edk Soft Keys Configuration
Phone Customization EDK Soft Keys Configuration You can customize the soft keys as need. This feature is typically used to access frequently-used functions or to create menu shortcuts to frequently-used phone settings. Custom soft keys can be added in the following phone states: Idle - There are no active calls on the phone.
Page 188 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones softkey.1.position = 3 Note: It works only if “features.enhanced_dss_keys.enable” and “softkey.X.enable” are set to 1 (Enabled). Integer from 0 to 10 If it is set to 0, the soft key X is located in the first available position from the left.
Page 189 Phone Customization Default Parameter softkey.X.use.connecting <y0000000000xx>.cfg It enables or disables the custom soft key X to be displayed in the connecting 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.transfer_connecting <y0000000000xx>.cfg...
Page 190: Example: Configuring Edk List For A Line Key
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones It enables or disables the custom soft key X to be displayed in the hold state. Description Note: It works only if “features.enhanced_dss_keys.enable” and “softkey.X.enable” are set to 1 (Enabled). Permitted...
Page 191: Example: Using Edk Macro Strings As The Contact Number
Phone Customization linekey.1.type = 73 linekey.1.value = !IVR1 linekey.1.label = Custom After provisioning, the line key 1 will invoke the macro “IVR1”. You can press the line key 1 to execute the action “1013$Tinvite$$Cwc$$Cp10$$Penter number&C4&N$$Tdtmf$$Cp3$$Chu$”. You can also set “linekey.1.value = 1013$Tinvite$$Cwc$$Cp10$$Penter number&C4&N$$Tdtmf$$Cp3$$Chu$” without configuring an EDK list.
Page 192: Power Saving Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones figured to display after the phone has been idle for 5 minutes, and the power-saving mode is configured to turn off the backlight and screen after the phone has been idle for 15 minutes, the backlight and screen will be turned off after the screen saver displays for 10 minutes.
Page 193 Phone Customization Default Web UI Settings->Power Saving->Power Saving Parameter features.power_saving.office_hour.idle_timeout <y0000000000xx>.cfg It configures the time (in minutes) to wait in the idle state before IP phone enter power-saving mode dur- ing the office hours. Example: Description features.power_saving.office_hour.idle_timeout = 600 The IP phone will enter the power-saving mode when it has been inactivated for 600 minutes (10 hours) during the office hours.
Page 194: Usb Port Lock
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones features.power_saving.office_hour.tuesday features.power_saving.office_hour.wednesday features.power_saving.office_hour.thursday features.power_saving.office_hour.friday features.power_saving.office_hour.saturday features.power_saving.office_hour.sunday It configures the start time and end time of the day’s office hour. Start time and end time are separated by a comma. Start time and end time are separated by a comma.
Page 195: Usb Port Lock Configuration
Phone Customization Adding a Wallpaper from a USB Flash Drive Adding a Screensaver Picture from a USB Flash Drive Wi-Fi (except CP920) Bluetooth (except T54S/T52S/CP920) USB Recording Topic USB Port Lock Configuration USB Port Lock Configuration The following table lists the parameters you can use to configure USB port lock. Parameter static.usb.power.enable <y0000000000xx>.cfg It enables or disables the USB port.
Page 196: Search Source File Customization
Topics Search Source File Customization Search Source List Configuration Search Source File Customization You can ask the distributor or Yealink FAE for super search template. You can also obtain the super search template online: http://support.yealink.com/documentFront/forwardToDocumentFrontDisplayPage. Topics Search Source File Attributes...
Page 197: Customizing Search Source File
Phone Customization Attributes Valid Values Description Remote Phonebook LDAP Network Directories BroadSoft Buddies PhoneBook Personal Address Book Network Contacts Network Call List Mobile Contacts Google Contacts 1 to 12 priority The priority of the search results. 1 is the highest priority, 12 is the lowest. Enable or disable the IP phone to search the desired enable 0: Disabled...
Page 198 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Permitted URL within 511 characters Values Default Blank Web UI Directory->Setting->Search Source List In Dialing Parameter search_in_dialing.local_directory.enable <y0000000000xx>.cfg It enables or disables the IP phone to automatically search entries from the local directory, and display res- Description ults on the pre-dialing/dialing screen.
Page 199: Recent Call Display In Dialing
Phone Customization Parameter search_in_dialing.remote_phone_book.priority <y0000000000xx>.cfg Description It configures the search priority of the remote phone book. Permitted Integer greater than or equal to 0 Values Default Web UI Directory->Setting->Search Source List In Dialing Parameter search_in_dialing.ldap.enable <y0000000000xx>.cfg It enables or disables the IP phone to automatically search entries from the LDAP, and display results on Description the pre-dialing/dialing screen.
Page 200: Icon Customization
Icon Customization You can upload custom DSS keys icons and menu icons to the phone. Contact Yealink FAE to obtain the Icon Tem- plates Pack. Make sure that the name, size and format of new icons are the same as the built-in ones.
Page 201: Warnings Display Configuration
Phone Customization Topic Warnings Display Configuration Warnings Display Configuration The following table lists the parameter you can use to configure the warnings display. Parameter phone_setting.warnings_display.mode <y0000000000xx>.cfg Description It enables or disables the phone to display warnings on the phone. 0-Disabled Permitted Values 1-Enabled Default...
Page 202 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones...
Page 203: Account Settings
Account Registration Registering an account makes it easier for the IP phones to receive an incoming call or dial an outgoing call. Yealink IP phones support registering multiple accounts on a phone (T19(P) E2 phones only support registering one SIP account;...
Page 204 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Description It enables or disables the user to use a specific account. Permitted 0-Disabled, the account is not available for the user. 1-Enabled Values Default Web UI Account->Register->Line Active T54S/T52S/T48S/T48G/T46S/T46G/T29G: Menu->Advanced (default password: admin)->Accounts->Account X->Activation...
Page 205 Account Settings Menu->Advanced (default password: admin)->Accounts->Account X->Register Name T42G/T42S/T41P/T41S/T40P/T40G/T27G/T23P/T23G/T21(P) E2/T19(P) E2/CP920: Menu->Settings->Advanced Settings (default password: admin)->Accounts->Register Name Parameter account.X.user_name <MAC>.cfg Description It configures the register user name. Permitted String within 99 characters Values Default Blank Web UI Account->Register->User Name T54S/T52S/T48S/T48G/T46S/T46G/T29G: Menu->Advanced (default password: admin)->Accounts->Account X->User Name Phone UI T42G/T42S/T41P/T41S/T40P/T40G/T27G/T23P/T23G/T21(P) E2/T19(P) E2/CP920:...
Page 206 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones It configures the port of SIP server Y. If it is set to 0 when UDP is used ("account.X.sip_server.Y.transport_type" is set to 0), the phone uses a ran- dom port for responding the messages from the server.
Page 207 Account Settings Note: It works only if “account.X.outbound_proxy_enable” is set to 1 (Enabled). Permitted Integer from 0 to 65535 Values Default 5060 Web UI Account->Register->Outbound Proxy Server Y->Port Parameter account.X.reg_fail_retry_interval <MAC>.cfg It configures the interval (in seconds) at which the IP phone to retries to re-register account X when regis- tration fails.
Page 208: Pstn Account Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones PSTN Account Configuration The following table lists the parameters you can use to register the PSTN account. Parameter pstn.account.X.enable <MAC>.cfg It enables or disables the PSTN account X. Description Note: It is only applicable to CP920 IP phones.
Page 209 Account Settings For T54S/T48G/T48S/T46G/T46S/T29G: 0~15 stand for line1~line16; For T52S/T42G/T42S: 0~11 stand for line1~line12; For T41P/T41S/T27G: 0~5 stand for line1~line6; For T40P/T40G/T23P/T23G: 0~2 stand for line1~line3; For T21(P) E2: 0~1 stand for line1~line2; For T19(P) E2/CP920: 0 stands for line1. Permitted 0-Disabled Values...
Page 210 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones the REGISTER message. For example: Contact: <sip:1012@10.2.20.160:5060>;+sip.instance="<urn:uuid:5acd54e8-f197-57e2-aa42- 5f4a5d04367c>" Default Parameter sip.reg_surge_prevention <y0000000000xx>.cfg Description It configures the waiting time (in seconds) for account register after startup. Permitted Integer from 0 to 60...
Page 211: Outbound Proxy In Dialog
Account Settings Outbound Proxy in Dialog An outbound proxy server can receive all initiating request messages and route them to the designated destination. If the IP phone is configured to use an outbound proxy server within a dialog, all SIP request messages from the IP phone will be sent to the outbound proxy server as a mandatory requirement.
Page 212: Behaviors When Working Server Connection Fails
Yealink IP phones support Failover and Fallback server redundancy types. In some cases, you can deploy a com- bination of the two server redundancy types. For more information on server redundancy, refer to...
Page 213: Registration Method Of The Failover/Fallback Mode
Account Settings 1. Sends the INVITE request to the primary server. 2. If the primary server does not respond correctly to the INVITE (that is, the primary server responds to the INVITE with 503 message or the request for responding with 100 Trying message times out (64*T1 seconds, defined in 3261)), then tries to make the call using the secondary server.
Page 214: Failover Server Redundancy Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Default Parameter account.X.outbound_proxy_fallback_interval <MAC>.cfg It configures the time interval (in seconds) for the IP phone to detect whether the working outbound proxy server is available by sending the registration request after the fallback server takes over call con- Description trol.
Page 215 Account Settings Default [1][2] Parameter account.X.sip_server.Y.expires <MAC>.cfg It configures the registration expiration time (in seconds) of SIP server Y. Description Example: account.1.sip_server.1.expires = 3600 Permitted Integer from 30 to 2147483647 Values Default 3600 Web UI Account->Register->SIP Server Y->Server Expires [1][2] Parameter account.X.sip_server.Y.retry_counts <MAC>.cfg It configures the retry times for the IP phone to resend requests when the SIP server Y is unavailable or...
Page 216 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones on the registered server expires, the phone will retry to send requests to the primary server. 2-Registration: the IP phone will send requests to the last registered server first. If the registration expires, the phone will retry to send requests to the primary server.
Page 217 Account Settings The IP phone moves to the next available outbound proxy server after three failed attempts. Permitted Integer from 0 to 20 Values Default -1, the IP phone will invoke “account.X.sip_server.Y.retry_counts” to take effect. account.X.outbound_proxy.Y.only_signal_with_ Parameter <MAC>.cfg [1][2] registered It enables or disables the IP phone to only send requests to the registered outbound proxy server when encountering a failover.
Page 218: Sip Server Name Resolution
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Permitted 0, Integer from 60 to 65535 Values Default -1, the IP phone will invoke “account.X.sip_server.Y.failback_timeout” to take effect. account.X.outbound_proxy.Y.failback_sub- Parameter <MAC>.cfg [1][2] scribe.enable It enables or disables the IP phone to retry to re-subscribe after registering to the secondary outbound proxy server with different IP addresses when encountering a failover.
Page 219: Static Dns Cache
Account Settings 1-TCP 2-TLS Values 3-DNS-NAPTR, if no server port is given, the IP phone performs the DNS NAPTR and SRV queries for the service type and port. 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 IP phone to be performed when no result is returned from Description NAPTR query.
Page 220: Behave With A Configured Dns Server
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Support for negative caching of DNS queries as described in RFC 2308 is also provided to allow faster failover when prior DNS queries have returned no results from the DNS server.
Page 221 Integer from 0 to 65535 Values Default Parameter dns_cache_naptr.X.replace <y0000000000xx>.cfg It configures a domain name to be used for the next SRV query in NAPTR record X. Description Example: dns_cache_naptr.1.replace = _sip._tcp.yealink.pbx.com Permitted Domain name Values Default Blank Parameter dns_cache_naptr.X.service <y0000000000xx>.cfg It configures the transport protocol available for the SIP server in NAPTR record X.
Page 222 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Permitted Integer from 30 to 2147483647 Values Default Parameter dns_cache_srv.X.name <y0000000000xx>.cfg It configures the domain name in SRV record X. Description Example: dns_cache_srv.1.name = _sip._tcp.yealink.pbx.com Permitted Domain name Values Default Blank Parameter dns_cache_srv.X.port...
Page 223 Integer from 30 to 2147483647 Values Default Parameter dns_cache_a.X.name <y0000000000xx>.cfg It configures the domain name in A record X. Description Example: dns_cache_a.1.name = yealink.pbx.com Permitted Domain name Values Default Blank Parameter dns_cache_a.X.ip <y0000000000xx>.cfg It configures the IP address that the domain name in A record X maps to.
Page 224: Logon Wizard
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Note: It works only if "static.network.dns.last_cache_expired.enable" is set to 1 (Enabled). Integer from 0 to 65535 0-the expired DNS cache can only be used once. After using, the IP phone will perform a DNS query Permitted again.
Page 225 Account Settings Note: It works only if “phone_setting.logon_wizard” is set to 1 (Enabled). It is not applicable to CP920 IP phones. Permitted 0-Disabled 1-Enabled Values Default Parameter hotdesking.startup_username_enable <y0000000000xx>.cfg It enables or disables the IP phone to provide input field of user name on the logon wizard after startup when there is no registered account.
Page 226: Multiple Line Keys Per Account
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Values 1-Enabled Default 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 227 Account Settings Note: The number of the line keys is determined by “account.X.number_of_linekey”. The value configured by the parameter “account.X.phone_setting.call_appearance.transfer_via_new_linekey” takes precedence over that configured by this parameter. It is not applicable to T19(P) E2/CP920 IP phones. Permitted 0-Disabled, the IP phone will transfer a call on the current line key. 1-Enabled Values Default...
Page 228: Auto Line Labels Rule Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Default Blank X is the account ID. For T54S/T48S/T48G/T46S/T46G/T29G, X=1-16; for T52S/T42G/T42S, X=1-12; for T41P/T41S/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2. Auto Line Labels Rule Configuration When assigning multiple line keys per account, these automatically assigned line keys use its Account Label (set by “account.X.label”) as default label to display on the screen.
Page 229 Account Settings From the idle screen, you can press the left or right navigation key to select the desired account as the default account for all IP phones. You can also do the following to configure the default account. The following table lists the parameters you can use to configure the default account. Parameter static.features.default_account <y0000000000xx>.cfg It configures the default account.
Page 230 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones...
Page 231: Call Log
Call Log Yealink IP phones record and maintain phone events to a call log, also known as a call list. Call log consists of four lists: Missed Calls, Placed Calls, Received Calls, and Forwarded Calls. Each call log list supports up to 100 entries.
Page 232 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones warded calls) in the call lists. Note: To log the missed calls, “account.X.missed_calllog” should be set to 1 (Enabled). 0-Disabled, the IP phone cannot log the placed calls, received calls, missed calls and the forwarded calls Permitted in the call lists.
Page 233 Call Log It is applicable to the following scenarios: Reject an incoming call Forward an incoming call The outgoing call is rejected Transfer a call Answer a transferred/forwarded call from the remote party; your call is transferred/forwarded to another party. Note: It works only if “features.save_call_history”...
Page 234: Call Logs Backup
Call Logs Backup Yealink IP phones support storing all call logs to a call log file named <MAC>-calllog.xml. You can back up this file to the server, avoiding data loss. Once the call logs update, the IP phone will automatically upload this file to the pro- visioning server or a specific server.
Page 235 Call Log Note: It works only if “static.auto_provision.local_calllog.backup.enable” is set to 1 (Enabled). Permitted String Values Default Blank static.auto_provision.local_calllog.write_delay.ter- Parameter <y0000000000xx>.cfg minated It configures the delay time (in seconds) for the IP phone to upload the <MAC>-calllog.xml file each time the call logs update.
Page 236 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones...
Page 237: Directory
XML phone book, refer to Local Directory Yealink IP phones maintain a local directory that you can use to store contacts. The local directory can store up to 1000 contacts and 48 groups (47 groups for CP920 IP phones). Contacts and groups can be added either one by one, or in batch using a local contact file. Yealink IP phones support both *.xml and *.csv format contact files, but you can only customize the *.xml format contact file.
Page 238: Preparing The Tar Formatted File
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones The contact icon format must meet the following: Phone Model Format Resolution T48S/G .jpg/.png/.bmp/.jpeg <=41*41 Preparing the Tar Formatted File This section provides you on how to package the tar file using 7-Zip.
Page 239: Local Contact File Customization
8. Click the OK button. A photo.tar file is generated in the directory C:\Program Files\photo. Local Contact File Customization You can ask the distributor or Yealink FAE for local contact template. You can also obtain the local contact template online: http://support.yealink.com/documentFront/forwardToDocumentFrontDisplayPage. Topics...
Page 240 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Elements Attributes Description Specify the contact name. display_name For example: Jim Note: The contact name cannot be blank or duplicated. office_number Specify the office number or macro EDK Macro Strings. mobile_number Specify the mobile number or macro EDK Macro Strings.
Page 241: Customizing Local Contact File
Directory Example: Using EDK Macro Strings as the Contact Number Customizing Local Contact File 1. Open the local contact file. 2. To add a group, add <group display_name="" ring=""/> to the file. Each starts on a new line. 3. To add a contact, add <contact display_name="" office_number="" mobile_number="" other_number="" line="" ring=""...
Page 242 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Example: local_contact.photo.url = tftp://192.168.10.25/Photo.jpg Note: It is not applicable to T54S/T52S/T48S/T48G/T46S/T46G/T29G IP phones. Permitted URL within 511 characters Values Default Blank Parameter local_contact.icon_image.url <y0000000000xx>.cfg It configures the access URL of a contact icon file.
Page 243: Example: Adding Contacts Using A Contact File
Directory Default Blank Parameter local_contact.icon.url <y0000000000xx>.cfg It configures the access URL of a TAR contact icon file. The format of the contact icon must be *.png, *.jpg, *.bmp. The contact icon file should be compressed as a TAR file in advance and then place it to the provisioning server.
Page 244: Local Contacts Backup
Local Contacts Backup Yealink IP 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 IP phone will automatically upload this file to the provisioning server or a specific server.
Page 245: Favorite Contacts
Directory It configures the way the IP phone uploads the <MAC>-local.cfg file, <MAC>-calllog.xml file or <MAC>- Description contact.xml file to the provisioning server (for HTTP/HTTPS server only). 0-PUT Permitted Values 1-POST Default Favorite Contacts You can enable the user to mark local contacts as favorites. The favorite contacts are stored in the Favorites directory and the phone will automatically assign Speed Dial keys for these favorite contacts.
Page 246: Google Contacts
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Note: It works only if “local_contact.favorite.enable” is set to 1 (Enabled). It is not applicable to T19(P) E2/CP920 IP phones. 0-Enter the line key/ext key configuration screen Permitted Values 1-Enter the Add Contact screen Default Parameter phone_setting.favorite_sequence_type...
Page 247: Signing In To The Google Contact Server
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 IP phones.
Page 248: Securely Storing The Ldap Credentials
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones 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 249 Directory 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 99 characters Values Default Blank Web UI Directory->LDAP->LDAP Name Filter Parameter ldap.number_filter <y0000000000xx>.cfg It configures the search criteria for LDAP contact numbers look up. The “*”...
Page 250 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Web UI Directory->LDAP->Server Address Parameter ldap.port <y0000000000xx>.cfg It configures the port of the LDAP server. Description Example: ldap.port = 389 Permitted Integer from 1 to 65535 Values Default Web UI Directory->LDAP->Port Parameter ldap.base...
Page 251 Directory Default Blank Web UI Directory->LDAP->Password Parameter ldap.max_hits <y0000000000xx>.cfg It configures the maximum number of search results to be returned by the LDAP server. If the value of the “Max.Hits” is blank, the LDAP server will return all searched results. Please note that a very large value of the “Max.
Page 252 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones ldap.display_name = %cn The cn of the contact record is displayed on the phone screen. Permitted String within 99 characters Values Default Blank Web UI Directory->LDAP->LDAP Display Name Parameter ldap.version <y0000000000xx>.cfg It configures the LDAP protocol version supported by the IP phone.
Page 253: Remote Phone Book
URL of the remote phone book. The IP phone can establish a connection with the remote server and download the phone book, and then display the remote phone book entries on the phone. Yealink IP phones support up to 5 remote phone books. The remote phone book is customizable. Note For T40P/T40G/T23P/T23G/T21(P) E2/T19(P) E2 IP phones, we recommend you to download less than 3000 remote contacts (including one name and three numbers fields) from the remote server.
Page 254: Remote Phone Book File Customization
You can add multiple contacts at a time and/or share contacts between IP phones using the supplied template files (Menu.xml and Department.xml). You can ask the distributor or Yealink FAE for remote phone book template. You can also obtain the remote phone book template online: http://support.yealink.com/documentFront/forwardToDocumentFrontDisplayPage.
Page 255: Remote Phone Book Configuration
Directory <DirectoryEntry> <Name>Lily </Name> <Telephone label="Mobile Number">12345654626</Telephone> </DirectoryEntry> <DirectoryEntry> <Name>Jim</Name> <Telephone label="Office Number">654321</Telephone> <Telephone label="Mobile Number">54321665462</Telephone> <Telephone label="Other Number">8608</Telephone> <Extra label="Language">English</Extra> </DirectoryEntry> 2. You can create multiple department.xml files, rename these files and specify multiple contacts in these files. For example, Market.xml with contact Lily and Jim, Propaganda.xml with other contacts and so on.
Page 256 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Parameter remote_phonebook.data.X.name <y0000000000xx>.cfg It configures the display name of the remote phone book item. Description Example: remote_phonebook.data.1.name = Xmyl Permitted String within 99 characters Values Default Blank Web UI Directory->Remote Phone Book->Display Name Parameter remote_phonebook.data.X.username...
Page 257: Example: Configuring A Remote Phone Book
Directory List File Customization Directory List Configuration Example: Configuring a Directory List Directory List File Customization You can ask the distributor or Yealink FAE for directory template. You can also obtain the directory template online: http://support.yealink.com/documentFront/forwardToDocumentFrontDisplayPage. Topics Directory List File Attributes...
Page 258: Directory List File Attributes
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Customizing Directory List File Directory List File Attributes The following table lists the attributes you can use to add contact lists to the directory list file. We recommend you do not edit these attributes.
Page 259: Customizing Directory List File
Directory Attributes Valid Values Description Google Contact 1 to 15 priority The display priority of the directory list. 1 is the highest priority, 15 is the lowest. Whether to display this list when you press enable 0: Disabled Directory (Dir) on the phone. 1: Enabled common The applicable phone models of the directory...
Page 260 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Default Parameter directory_setting.local_directory.priority <y0000000000xx>.cfg Description It configures the display priority of the local directory. Permitted Integer greater than or equal to 0 Values Default Parameter directory_setting.history.enable <y0000000000xx>.cfg Description It enables or disables the users to access the history by pressing the Directory/Dir soft key.
Page 261: Example: Configuring A Directory List
Directory Example: Configuring a Directory List The following example shows the configuration for the directory list. Customize the directory list file, and then place this file to the provisioning server “http://192.168.10.25”. Example static.directory_setting.url = http://192.168.10.25 /favorite_setting.xml After provisioning, you can press the Directory/Dir soft key to access the desired contact list quickly. Directory Search Settings You can configure how the phones search contacts and whether to highlight the matched keywords for contact search- ing.
Page 262 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones...
Page 263: Call Features
You can use the regular expression to define the dial plan. Yealink IP phones support four patterns: Replace rule: is an alternative string that replaces the numbers entered by the user. Yealink IP phones support up to 100 replace rules.
Page 264: Basic Regular Expression Syntax For Four Patterns
Block out: prevents users from dialing out specific numbers. When entered numbers match the predefined block out rule, the phone screen prompts “Forbidden Number”. Yealink IP phones support up to 10 block out rules. You can configure these four patterns via web user interface or auto provisioning. For replace rule and dial now, you can select to add the rule one by one or using the template file to add multiple rules at a time.
Page 265: Replace Rule File Customization
The replace rule file helps create multiple replace rules. At most 100 replace rules can be added to the IP phone. It is not applicable to T19(P) E2 IP phones. You can ask the distributor or Yealink FAE for the replace rule file template. You can also obtain the replace rule file template online: http://support.yealink.com/documentFront/forwardToDocumentFrontDisplayPage.
Page 266: Dial Now File Attributes
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Dial Now File Attributes The following table lists the attributes you can use to add dial-now rules to the dial now file: Attributes Description DialNowRule Specify the dial-now number. Specify a registered line to apply the dial-now rule.
Page 267: Dial Now Configuration
Call Features When you enter the number ”1” and press the send key, the number “254245” will replace the entered number “1”. Note: It works only if “dialplan.digitmap.enable” and “account.X.dialplan.digitmap.enable” are set to 0 (Disabled). Permitted String within 32 characters Values Default Blank...
Page 268 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Example: dialplan.dialnow.rule.1 = 123 Note: It works only if “dialplan.digitmap.enable” and “account.X.dialplan.digitmap.enable” are set to 0 (Disabled). Permitted String within 511 characters Values Default Blank Web UI Settings->Dial Plan->Dial Now->Rule Parameter dialplan.dialnow.line_id.X <y0000000000xx>.cfg...
Page 269: Area Code Configuration
Call Features Values Default Blank Parameter dialplan.transfer.mode <y0000000000xx>.cfg It configures the transfer type the IP phone will perform when the entered transferee numbers match the Dial Now rule of the dial plan. Description Note: It is only applicable to the old dial plan mechanism. 0-Semi-attended Transfer/Attended Transfer Permitted Values...
Page 270: Block Out Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Default Web UI Settings->Dial Plan->Area Code->Max Length (1-15) Parameter dialplan.area_code.line_id <y0000000000xx>.cfg It configures the desired line to apply the area code rule. The digit 0 stands for all lines. If it is left blank, the area code rule will apply to all lines on the IP phone.
Page 271: Example: Adding Replace Rules Using A Replace Rule File
Call Features 0 to 12 (for T52S/T42G/T42S) 0 to 6 (for T41P/T41S/T27G) Values 0 to 3 (for T40P/T40G/T23P/T23G) 0 to 2 (for T21(P) E2) 0, 1 (for CP920) Default Blank Web UI Settings->Dial Plan->Block Out->Account X is from 1 to 10. Example: Adding Replace Rules Using a Replace Rule File The following example shows the configuration for adding replace rules.
Page 272: Digit Map For All Lines Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Example: “[35-7]” would match the number “3”, “5”, ”6” or ”7”. Note: The digits must be concrete, for example, [3-x] is invalid. The dot “.” can be used as a placeholder or multiple placeholders, including zero, of occurrences of the pre- ceding construct.
Page 273 Call Features It enables or disables the digit map feature for the IP phone. Description Note: The value configured by the parameter “account.X.dialplan.digitmap.enable” takes precedence over that configured by this parameter. Permitted 0-Disabled 1-Enabled Values Default Parameter dialplan.digitmap.string <y0000000000xx>.cfg It configures the digit map pattern used for the dial plan. Example: dialplan.digitmap.string = <[2-9]x:86>3.T|0x.!|1xxx Description...
Page 274 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Parameter dialplan.digitmap.interdigit_short_timer <y0000000000xx>.cfg It configures the timeout interval (in seconds) for any string of digit map. The IP phone will wait this many seconds before matching the entered digits to the dial plan and placing the call.
Page 275 Call Features Permitted 0-Disabled 1-Enabled Values Default Parameter dialplan.digitmap.apply_to.on_hook_dial <y0000000000xx>.cfg It enables or disables the entered number to match the predefined string of the digit map after pressing a send key when dialing on-hook or pressing the DSS key (for example, speed dial, BLF or prefix key). Description Note: It works only if “dialplan.digitmap.enable”...
Page 276: Digit Map For A Specific Line Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones send key. It is only applicable to the off-hook dialing. The off-hook dialing includes: pick up the handset, press the Speakerphone key or press the line key when the phone is idle.
Page 277 Call Features If it is set to 0, the IP phone will not dial the entered number if it only a partial match exists. The value of this parameter should be greater than that configured by the parameter “accoun- t.X.dialplan.digitmap.interdigit_short_timer”. For example: account.1.dialplan.digitmap.string = 1xxT|xxxxx<T1>...
Page 278 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones 9]x:86>3.T” digit map, 5 is applied to “2T” digit map, 3 is applied to “1xxT” digit map, 6 is applied to “0x.!” digit map, 2 is applied to the “[2-9]11T” digit map, the last digit 1 is ignored.
Page 279: Emergency Dialplan And Enhanced 911
You can dial the emergency telephone number (emergency services number) at any time when the IP phone is powered on and has been connected to the network. It is available even if your phone keypad is locked or no SIP account is registered. Yealink IP phones support emergency dialplan and enhanced 911.
Page 280: Emergency Dialplan And Enhanced 911 Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Emergency Dial Plan You can configure the emergency dial plan for the phone (for example, emergency number, emergency routing). The phone determines if this is an emergency number by checking the emergency dial plan. When placing an emergency call, the call is directed to the configured emergency server.
Page 281 Call Features Description It configures the account to be used to retrieve E911 location information. T54S/T48S/T48G/T46S/T46G/T29G: Integer from 1 to 16; T52S/T42S/T42G: Integer from 1 to 12; T41P/T41S/T27G: Integer from 1 to 6; Permitted Values T40P/T40G/T23P/T23G: Integer from 1 to 3; T21(P) E2: Integer from 1 to 2;...
Page 282 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Note: It works only if “dialplan.emergency.enable” is set to 1 (Enabled) and “dialplan.emergency.asserted_ id_source” is not set to HELD. 0-UDP 1-TCP Permitted Values 2-TLS 3-DNS-NAPTR Default Parameter dialplan.emergency.X.value <y0000000000xx>.cfg It configures the emergency number to use on your IP phone so a caller can contact emergency services in the local area when required.
Page 283 It configures the custom element value to be sent in a location request message. For example: dialplan.emergency.held.request_element.1.value = 001565B38ECB Description dialplan.emergency.held.request_element.2.value = 6f2f2d50-c385-4b72-b84a-ce0ca3a77cb7 dialplan.emergency.held.request_element.3.value = 8611@pbx.yealink.com Note: It works only if “dialplan.emergency.enable” is set to 1 (Enabled) and “dialplan.emergency.asserted_ id_source” is set to HELD. Permitted String...
Page 284: Hotline
If you lift the handset, press the Speakerphone key or the line key, and do nothing for a specified time interval, the IP phone will automatically dial out the hotline number. Yealink IP phones only sup- port one hotline number.
Page 285: Off Hook Hot Line Dialing
Call Features number. If it is set to 0 (0s), the IP phone will immediately dial out the preset hotline number when you lift the handset, press the Speakerphone/off-hook key or press the line key. If it is set to a value greater than 0, the IP phone will wait the designated seconds before dialing out the preset hotline number when you lift the handset, press the Speakerphone/off-hook key or press the line key.
Page 286: Live Dialpad
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones 1-Enabled, the phone will first dial out the pre-configured number (configured by the parameter “accoun- Values t.X.auto_dial_num”). Default Parameter account.X.auto_dial_num <MAC>.cfg It configures the number that the IP phone first dials out when a user lifts the handset, presses the Speak- erphone/off-hook key or desired line key, dials out a call using account X.
Page 287: Auto Redial
Call Features Auto Redial You can set the phone automatically redial the last dialed number when the callee is temporarily unavailable. Both the number of attempts and waiting time between redials are configurable. Topic Auto Redial Configuration Auto Redial Configuration The following table lists the parameters you can use to configure auto redial.
Page 288: Recall Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones T54S/T52S/T48S/T48G/T46S/T46G/T29G: Menu->Features->Others->Auto Redial->Redial Times Phone UI T42G/T42S/T41P/T41S/T40P/T40G/T27G/T23P/T23G/T21(P) E2/T19(P) E2/CP920: Menu->Features->Auto Redial->Redial Times Parameter features.redial_via_local_sip_server.enable <y0000000000xx>.cfg Description It configures the IP phone to redial via local SIP server or remote SIP server.
Page 289: Password Dial
Call Features Line Key Configuration Programmable Key Configuration linekey.X.type = 13 programablekey.X.type = 13 linekey.X.line = 1 programablekey.X.line = 1 linekey.X.value = 4603 programablekey.X.value = 4603 linekey.X.label = Bill After provisioning, a Speed Dial key for Bill (4603) is available on the phone, and you can press the Speed Dial key to call Bill (4603) quickly.
Page 290: Call Timeout
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Parameter features.password_dial.length <y0000000000xx>.cfg It configures how many digits to be displayed as asterisks. Example: features.password_dial.length = 3 Description If set the prefix to 12 and the length to 3, when you want to dial the number 123456, the entered number is displayed as 12***6 on the LCD screen.
Page 291 Call Features Parameter account.X.anonymous_call <MAC>.cfg Description It triggers the anonymous call feature to on or off. 0-Off Permitted 1-On, the IP phone will block its identity from showing to the callee when placing a call. The callee’s Values phone screen presents “Anonymous” instead of the caller’s identity. Default Web UI Account->Basic->Anonymous (“account.X.anonymous_call.server_base_only”...
Page 292: Call Number Filter
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones The IP phone will send the code to activate anonymous call feature on server-side when you activate it on the IP phone. Example: account.1.anonymous_call_oncode = *72 Permitted String within 32 characters...
Page 293: Ip Address Call
Call Features Note: If it is left blank, the IP phone will not automatically filter any characters when dialing. Permitted String within 99 characters Values Default , -() Web UI Features->General Information->Call Number Filter IP Address Call You can set the phone whether to receive or place an IP call. You can neither receive nor place an IP call if you disable this feature.
Page 294: Ignoring Incoming Calls Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Topic Ignoring Incoming Calls Configuration Ignoring Incoming Calls Configuration The following table lists the parameter you can use to configure ignoring incoming calls. Parameter features.ignore_incoming_call.enable <y0000000000xx>.cfg Description It enables or disables the IP phone to ignore the incoming call.
Page 295: Auto Answer
Default Auto Answer Yealink IP 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 IP phones will not automatically answer the incoming call during a call or while dialing even if auto answer is enabled;...
Page 296 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Parameter features.ip_call.auto_answer.enable <y0000000000xx>.cfg It enables or disables the auto answer feature for IP call. Note: It works only if “features.direct_ip_call_enable" is set to 1 (Enabled). The IP phone cannot auto- Description matically answer the incoming IP call when the IP phone is in a call or dialing even if IP call auto answer is enabled.
Page 297: Anonymous Call Rejection
Call Features Values 1-Double beep Default Parameter features.mute.autoanswer_mute.enable <y0000000000xx>.cfg It enables or disables the auto answer mute feature. Description Note: It works only if “account.X.auto_answer” and “features.allow_mute” are set to 1 (Enabled). It is not available to the intercom call. 0-Disabled Permitted 1-Enabled, the IP phone will mute the microphone when an incoming call is automatically answered, and...
Page 298: Anonymous Call Rejection Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Anonymous call rejection on a specific server, you may need to configure anonymous call rejection on code and off code to activate and deactivate server-side anonymous call rejection feature. Topic Anonymous Call Rejection Configuration Anonymous Call Rejection Configuration The following table lists the parameters you can use to configure anonymous call rejection.
Page 299: Call Waiting
You can enable call waiting feature and set the phone to play a warning tone to avoid missing important calls during a call. Yealink IP phones also support call waiting on code and off code to activate and deactivate server-side call waiting fea- ture. They may vary on different servers.
Page 300 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Parameter call_waiting.enable <y0000000000xx>.cfg Description It enables or disables the call waiting feature. 0-Disabled, a new incoming call is automatically rejected by the IP phone with a busy message during a Permitted call.
Page 301: Do Not Disturb (Dnd)
Call Features Web UI Features->General Information->Call Waiting Off Code Phone UI Menu->Features->Call Waiting->Off Code Do Not Disturb (DND) DND feature enables the phone to reject all incoming calls automatically when you do not want to be interrupted. You can choose to implement DND locally on the phone or on the server-side. Usually, you can activate DND when the phone is idle.
Page 302 It configures a return code and reason of SIP response messages when rejecting an incoming call by DND. A specific reason is displayed on the caller’s phone screen. Description Note: For Yealink IP phones, it works only if “features.dnd.allow” is set to 1 (Enabled). 404-Not Found Permitted...
Page 303: Dnd Feature Configuration
Custom: DND feature can be configured for a specific line or multiple lines. Note DND mode is set by the parameter “features.dnd_mode”. Yealink IP phones also support DND on code and off code to activate and deactivate server-side DND feature. They may vary on different servers. Topics...
Page 304: Dnd In Custom Mode Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Example: features.dnd.on_code = *71 Note: It works only if “features.dnd.allow” is set to 1 (Enabled) and the value of the parameter “fea- tures.dnd_mode” is set to 0 (Phone) (except T19(P) E2/CP920 IP phones).
Page 305: Dnd Synchronization For Server-Side Configuration
Call Features account.1.dnd.on_code = *73 Note: It works only if “features.dnd.allow”, “features.dnd_mode” and “account.X.dnd.enable” are both set to 1. It is not applicable to T19(P) E2/CP920 IP phones. Permitted String within 32 characters Values Default Blank Web UI Features->Forward& DND->DND->AccountX->On Code Phone UI Menu->Features->DND->AccountX->On Code Parameter account.X.dnd.off_code...
Page 306 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Note: It is not applicable to T48G/T46G/T42G/T41P/T29G/CP920 IP phones. The value configured by this parameter takes precedence over that configured by the parameter "features.feature_key_sync.enable". 0-Disabled Permitted Values 1-Enabled, the IP phone to send a SUBSCRIBE message with event “as-feature-event”.
Page 307: Multiple Call Appearances
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 corresponding line key.
Page 308: Call Hold
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Default Blank X is the account ID. For T54S/T48S/T48G/T46S/T46G/T29G, X=1-16; for T52S/T42GT42S, X=1-12; for T41P/T41S/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2. 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 309 Call Features Default 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 IP phone to play the initial call hold tone. If it is set to 30 (30s), the IP phone will wait 30 seconds to play the initial call hold tone after you place a Description call on hold.
Page 310: Music On Hold (Moh) Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones If it is set to 3 (3s) and “features.play_held_tone.delay” is set to 30 (30s), the IP phone will begin to play a held tone after a call is held by the other party for 30 seconds, and repeat the call held tone every 3 seconds.
Page 311: Call Mute
X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2; for T19(P) E2/CP920, X=1. Call Mute You can mute the microphone of the active audio device (handset, headset or speakerphone) on Yealink IP phones dur- ing an active call or when the phone is on the pre-dialing/dialing/calling/ringing screen. The call is automatically muted when setting up successfully.
Page 312: Keep Mute Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Note For T23P/T23G/T21(P) E2 IP phones, the Cancel key (X key) can be used to cancel actions, reject incoming calls, mute/un- mutes calls or activate the mute feature. If keep mute feature is enabled, the Cancel key can only be used as a mute key.
Page 313: Call Forward
Call Features Permitted Integer from 3 to 3600 Values Default Call Forward You can forward calls from any line on your phone to a contact. There are two ways of forwarding your calls: Forward calls in special situations, such as when the phone is busy or there is no answer, or forwarding all incoming calls to a contact immediately.
Page 314 Parameter forward.international.enable <y0000000000xx>.cfg It enables or disables the IP phone to forward incoming calls to international numbers (the prefix is 00). Description Note: For Yealink IP phones, it works only if “features.fwd.allow” is set to 1 (Enabled). Permitted 0-Disabled 1-Enabled...
Page 315: Call Forward Feature Configuration
Note Forward mode is set by the parameter “features.fwd_mode”. Yealink IP phones also support call forward on code and off code to activate and deactivate server-side call forward fea- ture. They may vary on different servers. You can set a DSS key as a Forward key, and specify a contact you want to forward the incoming calls to for this key. For...
Page 316 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Note: It works only if “features.fwd.allow” is set to 1 (Enabled) and the value of the parameter “fea- tures.fwd_mode” is set to 0 (Phone) (except T19(P) E2/CP920 IP phones). Permitted String within 32 characters...
Page 317 Call Features Web UI Features->Forward&DND->Forward->Busy Forward->On/Off Phone UI Menu->Features->Call Forward->Busy Forward->Busy Forward Parameter forward.busy.target <y0000000000xx>.cfg It configures the destination number of the busy forward on a phone basis. Description Note: It works only if “features.fwd.allow” is set to 1 (Enabled) and the value of the parameter “fea- tures.fwd_mode”...
Page 318 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones deactivates the local No Answer Forward settings. 0-Off Permitted 1-On, incoming calls are forwarded to the destination number (configured by the parameter “forward.no_ Values answer.target”) after a period of ring time.
Page 319: Call Forward In Custom Mode Configuration
Call Features Note: It works only if “forward.no_answer.enable” or “account.X.timeout_fwd.enable” is set to 1 (Enabled). Permitted Integer greater than or equal to 0 Values Default Parameter forward.no_answer.on_code <y0000000000xx>.cfg It configures the no answer forward on code to activate the server-side no answer forward feature. The IP phone will send the no answer forward on code and the pre-configured destination number (con- figured by the parameter “forward.no_answer.target”) to the server when you activate the no answer for- Description...
Page 320 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Web UI Features->Forward&DND->Forward->AccountX->Always Forward->On/Off Phone UI Menu->Features->Call Forward->AccountX->Always Forward->Always Forward Parameter account.X.always_fwd.target <MAC>.cfg It configures the destination number of the always forward. Description Note: It works only if “features.fwd.allow” is set to 1 (Enabled) and “features.fwd_mode” is set to 1 (Cus- tom).
Page 321 Call Features 1-On, incoming calls to the account X are forwarded to the destination number (configured by the para- Values meter “account.X.busy_fwd.target”) when the callee is busy. Default Web UI Features->Forward&DND->Forward->AccountX->Busy Forward->On/Off Phone UI Menu->Features->Call Forward->AccountX->Busy Forward->Busy Forward Parameter account.X.busy_fwd.target <MAC>.cfg It configures the destination number of the busy forward.
Page 322 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones It triggers no answer forward feature to on or off. Note: It works only if “features.fwd.allow” is set to 1 (Enabled) and “features.fwd_mode” is set to 1 (Cus- Description tom). It is not applicable to T19(P) E2/CP920 IP phones. DND activated on the specific account deactivates the local No Answer Forward settings.
Page 323: Call Forward Synchronization For Server-Side Configuration
Call Features Default Blank 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. The IP phone will send the no answer forward off code to the server when you deactivate no answer for- Description ward feature on the IP phone.
Page 324: Call Transfer
B, party A can transfer this call to party C (the third party). Then, party B will begin a new call with party C, and party A will disconnect. Yealink IP phones support call transfer using the REFER method specified in RFC 3515...
Page 325: Call Transfer Configuration
Call Features Blind Transfer -- Transfer a call directly to another party without consulting. Blind transfer is implemented by a simple REFER method without Replaces in the Refer-To header. Semi-attended Transfer -- Transfer a call after hearing the ringback tone. The semi-attended transfer is imple- mented by a REFER method with Replaces in the Refer-To header.
Page 326: Transfer Mode For Dsskey Configuration
Transfer Mode for Dsskey Configuration You can configure the transfer mode for the IP phone when transferring the current call via a specified DSS key. Yealink IP phones support four transfer modes: New Call, Attended Transfer, Blind Transfer and Optional.
Page 327: Local Conference Configuration
X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2; for T19(P) E2/CP920, X=1. Local Conference Configuration The local conference requires a host phone to process the audio of all parties. Yealink IP phones support up to 3 parties (5 parties for CP920 IP phones) (including yourself) in a local conference call.
Page 328: Network Conference Configuration
USB Recording Yealink IP phones support manual recording during a call or automatic recording once the call is set up. Yealink CP920 IP phones support recording when the phone is idle, helping users record an important discussion in the local con- ference room.
Page 329: Usb Recording Configuration
Call Features The recorded calls are saved in *.wav format and include a date/time stamp, the other party’s number/IP address/name (or the first person’s number/IP address/name you called), duration of the call and the recording file size. For example, 20160422-1515-Bob was created on Apr. 22, 2016, at 15:15 and you have a call with Bob. If the recording is created when the phone is idle, the file is saved with a keyword "idleREC".
Page 330: Multicast Paging
Yealink IP phones support the following 31 channels: 0: Broadcasts are sent to channel 0. Note that the Yealink IP phones running firmware version 80 or earlier can be regarded as listening to channel 0. It is the default channel.
Page 331: Multicast Listening Group Configuration
Multicast Listening Group Configuration Yealink IP phones support up to 31 groups for listening. You can assign multicast IP address with a channel for each group, and specify a label to each group to identify the phones in the group, such as All, Sales, or HR.
Page 332: Multicast Paging Settings
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Parameter multicast.listen_address.X.ip_address <y0000000000xx>.cfg It configures the multicast address and port number that the IP phone listens to. Example: Description multicast.listen_address.1.ip_address = 224.5.6.20:10008 Note: The valid multicast IP addresses range from 224.0.0.0 to 239.255.255.255.
Page 333: Multicast Paging Settings Configuration
Call Features Paging Barge You can set your phone whether an incoming paging call interrupts an active call. The Paging Barge defines the lowest priority of the paging group from which the phone can receive a paging call when there is a voice call (a normal phone call rather than a multicast paging call) in progress. You can specify a priority that the incoming paging calls with higher or equal priority are automatically answered, and the lower ones are ignored.
Page 334 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones the one with a lower priority. Default Web UI Directory->Multicast IP->Paging Priority Active Parameter multicast.receive_priority.priority <y0000000000xx>.cfg It configures the priority of the voice call (a normal phone call rather than a multicast paging call) in pro- gress.
Page 335 Call Features If it is set to 0, the current volume of the speaker takes effect. The volume of the speaker can be adjusted by pressing the Volume key in advance when the phone is during a call. You can also adjust the volume of the speaker during the paging call.
Page 336 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones...
Page 337: Audio Features
Audio Features Audio Features This chapter describes the audio sound quality features and options you can configure for the IP phone. Topics Alert Tone Touch Tone Ring Tones Distinctive Ring Tones Ringer Device Audio Volume Tones Audio Codecs Packetization Time (PTime) Early Media Headset Prior Dual Headset...
Page 338 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Values Default Blank Web UI Features->Audio->Redial Tone Parameter account.X.dial_tone <MAC>.cfg Description It configures the dial tone for the IP phone. 0-Default (depend on the country tone by “voice.tone.country”) Permitted 1-440/250,0/250 Values...
Page 339: Touch Tone
Audio Features Default Web UI Features->Audio->Key Tone T54S/T52S/T48S/T48G/T46S/T46G/T29G: Menu->Basic->Sound->Key Tone Phone UI T42G/T42S/T41P/T41S/T40P/T40G/T27G/T23P/T23G/T21(P) E2/T19(P) E2/CP920: Menu->Settings->Basic Settings->Sound->Key Tone Touch Tone If you enable touch tone and tap the keys (except the off-hook key), the phone will produce a sound when it is not on the dialing/pre-dialing screen and not in a call.
Page 340: Ringtone Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Single File Phone Model Format Note Size 2MB of space should be reserved for the T54S/T52S/T48S/T46S/T42S/T41S/T27G .wav <=8MB phone 2.4MB of space should be reserved for the T48G/T46G/T29G .wav <=8MB phone)
Page 341 Audio Features Default Common Web UI Account->Basic->Ring Type T54S/T52S/T48S/T48G/T46S/T46G/T29G: Menu->Basic->Sound->Ring Tones->AccountX Phone UI T42G/T42S/T41P/T41S/T40P/T40G/T27G/T23P/T23G/T21(P) E2/T19(P) E2/CP920: Menu->Settings->Basic Settings->Sound->Ring Tones->AccountX Parameter pstn.account.X.ring_type <MAC>.cfg It configures a ring tone for PSTN account X. Example: pstn.account.1.ring_type = Ring3.wav It means PSTN account 1 will use the Ring3.wav as the ring tone. Description pstn.account.1.ring_type = Common It means PSTN account 1 will use the ring tone selected for the IP phone configured by the parameter...
Page 342: Distinctive Ring Tones
Supported Alert-Info Headers Format Distinctive Ring Tones Configuration Supported Alert-Info Headers Format Yealink IP 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 IP phone will process the keywords in the following order: AutoAnswer>URL>info text/Bellcore-drN/ringtone-N (ringtone-RingN)>MyMelodyN (MyMelodyRingN).
Page 343: Alert-Info: Bellcore-Drn
Audio Features Alert-Info: Bellcore-drN When the Alter-Info header contains the keyword “Bellcore-drN”, the IP phone will play the desired ring tone. The following table identifies the corresponding ring tone: Ring Tone Ring Tone Value of N (features.alert_info_tone = 1) (features.alert_info_tone = 0) Bellcore-dr1 Ring1.wav Bellcore-dr2...
Page 344: Alert-Info: Ringtone-N/Alert-Info: Ringtone-Ringn.wav
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Pattern Minimum Duration Nominal Duration Maximum Duration Bellcore Tone Pattern Cadence (ms) (ms) (ms) Ringing Short Silent Ringing Short Bellcore-dr3 Silent Ringing Long 1025 Silent 2975 4000 4400 Ringing Short Silent...
Page 345: Alert-Info:
Audio Features Value of N Ring Tone Ring1.wav Ring2.wav Ring3.wav Ring4.wav Ring5.wav Ring6.wav Ring7.wav Ring8.wav Silent.wav Splash.wav N<1 or N>10 Ring1.wav Alert-Info: <URL> When the Alert-Info header contains a remote URL, the IP phone will try to download the WAV ring tone file from the URL and then play the remote ring tone if “account.X.alert_info_url_enable”...

Page 346: Distinctive Ring Tones Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones If the auto answer tone feature is enabled, the phone plays a warning tone to alert you before answering the incoming call. Related Topic Auto Answer Distinctive Ring Tones Configuration The following table lists the parameters you can use to configure distinctive ring tones.
Page 347: Ringer Device
USB headset) should be connected to the IP phone and the headset mode also should be activated in advance. The USB headset is only applicable to T41S/T42S/T46S/T48S/T52S/T54S IP phones. You can press the HEADSET key to activate the headset mode. For more information, refer to the Yealink phone-spe- cific user guide.
Page 348: Audio Volume
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Audio Volume You can configure the sending volume and ringer volume for the phone. Topics Ringer Volume Configuration Sending Volume Configuration Ringer Volume Configuration You can configure the ringer volume as a fixed level, so the user cannot adjust the ringer volume on the phone. This feature is used to avoid missing calls when the user turns down the ringer volume.
Page 349: Tones
Audio Features Note: We recommend that you modify this parameter cautiously. A suitable value may render the voice quality bad. It is not applicable to CP920 IP phones. Permitted Integer from -50 to 50 Values Default Web UI Features->Audio->Handset Send Volume (-50~50) Parameter voice.handset.autoreset_spk_vol <y0000000000xx>.cfg It configures the handset's volume level during a call.
Page 350: Supported Tones
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Tones Configuration Supported Tones The default tones used on IP phones are the US tone sets. Available tone sets for IP phones: Australia Austria Brazil Belgium China Czech Denmark Finland France...
Page 351: Tones Configuration
Audio Features Condition Description Call Wait- Call waiting tone (For more information on call waiting, refer to Call Waiting) Dial Recall When receiving a call back Info When receiving a special message Stutter When receiving a voice mail (For more information on voice mail tone, refer to Alert Tone) Message...
Page 352 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Note: It works only if “voice.tone.country” is set to Custom. Permitted String Values Default Blank Web UI Settings->Tones->Dial Parameter features.partition_tone <y0000000000xx>.cfg It enables or disables the IP phone to play the different dial tones when there is no active account.
Page 353 Audio Features Values Default Blank Web UI Settings->Tones->Busy Parameter voice.tone.congestion <y0000000000xx>.cfg It customizes the tone when the network is congested. The value format is Freq/Duration. For more information on the value format, refer to the parameter Description “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 354 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Permitted String Values Default Blank Web UI Settings->Tones->Dial Recall Parameter voice.tone.info <y0000000000xx>.cfg It customizes the info tone. The phone will play the info tone with the special information, for example, the number you are calling is not in service.
Page 355: Audio Codecs
Audio Features Note: It works only if “voice.tone.country” is set to Custom. If you want to disable this warning tone, set it to 0. Permitted String Values Default Blank Web UI Settings->Tones->Auto Answer Audio Codecs CODEC is an abbreviation of COmpress-DECompress, capable of coding or decoding a digital data stream or signal by implementing an algorithm.
Page 356 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Codec Algorithm Reference Bit Rate Sample Rate Packetization Time 5.3 Kbps G723_53/ G723_63 G.723.1 RFC 3551 8 Ksps 30ms 6.3 Kbps iLBC_15_2kbps iLBC RFC 3952 15.2 Kbps 8 Ksps 20ms iLBC_13_33kbps...
Page 357: Audio Codecs Configuration
G722, PCMU, PCMA, G729 Audio Codecs Configuration Yealink IP phones running firmware version 81 or later support a new configuration behavior for the audio codecs. It is more effective for you to provision different IP phone modules. The configuration parameters are different for the new configuration behavior and the older one. For more information...
Page 358 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones 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.
Page 359 Audio Features g729-G729 g726_16-G726-16 g726_24-G726-24 g726_32-G726-32 g726_40-G726-40 g723_53-G723_53 g723_63-G723_63 opus-Opus ilbc_15_2kpbs-iLBC_15_2kbps ilbc_13_33kpbs-iLBC_13_33kbps Example: account.1.codec.g722.priority = 1 Note: The priority of the codec in disable codec list is not specified, and numerical value 1 is defined as the highest priority in the enable codec list. The name of the audio codec in this parameter should be the correct one as listed in the above example, otherwise the corresponding configuration will not take effect.
Page 360: Packetization Time (Ptime)
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones When the audio codec is iLBC_13_33kpbs, the default value is 0; Web UI Account->Codec->Audio Codec Parameter account.X.codec.opus.para <MAC>.cfg It configures the sample rate of the Opus audio codec. Description Note: It is only applicable to T54S/T52S/T48S/T46S/T42S/T41S/T27G/CP920 IP phones.
Page 361: Ptime Configuration
Audio Features Codec Packetization Time (Minimum) Packetization Time (Maximum) G729 10ms 80ms G726-16 10ms 30ms G726-24 10ms 30ms 30ms G726-32 10ms (40ms for T40P/T40G/T23P/T23G/T21(P) E2/T19(P) E2) G726-40 10ms 30ms G723_53/ 30ms 60ms G723_63 iLBC 20ms 30ms opus 10ms 20ms iLBC_15_2kpbs 20ms, 40ms, 60ms iLBC_13_33kpbs 30ms, 60ms...
Page 362: Early Media
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Early Media The early media refers to the media (for example, audio and video) played to the caller before a SIP call is actually estab- lished. Current implementation supports early media through the 183 message. When the caller receives a 183 message with SDP before the call is established, a media channel is established.
Page 363: Headset Prior
Audio Features Headset Prior Headset prior allows users to use headset preferentially if a headset is physically connected to the IP phone. This fea- ture is especially useful for permanent or full-time headset users. It is not applicable to CP920 IP phones. Note It is not applicable to the Bluetooth headset and USB headset.
Page 364: Dual Headset Configuration
Smart Noise Block Acoustic Echo Cancellation (AEC) Yealink IP phones employ advanced AEC for hands-free operation. You can configure the AEC feature to remove the echo of the local loudspeaker from the local microphone without removing the near-end speech. AEC is not normally required for calls via the handset. In some cases, where echo is experienced by the remote party, AEC may be used to reduce/avoid echo when you use the handset.
Page 365: Noise Suppression
Audio Features Parameter voice.echo_cancellation <y0000000000xx>.cfg Description It enables or disables the AEC (Acoustic Echo Canceller) feature on the IP phone. Permitted 0-Disabled 1-Enabled Values Default Web UI Settings->Voice->Echo Cancellation->ECHO Noise Suppression The impact noise in the room is picked-up, including paper rustling, coffee mugs, coughing, typing, and silverware striking plates.
Page 366: Vad Configuration
Jitter Buffer Yealink IP phones support two types of jitter buffers: fixed and adaptive. A fixed jitter buffer adds the fixed delay to voice packets. You can configure the delay time for the static jitter buffer on IP phones. An adaptive jitter buffer is cap- able of adapting the changes in the network's delay.
Page 367 Audio Features Parameter voice.jib.adaptive <y0000000000xx>.cfg Description It configures the type of jitter buffer in the wired network. 0-Fixed Permitted Values 1-Adaptive Default Web UI Settings->Voice->JITTER BUFFER->Type Parameter voice.jib.min <y0000000000xx>.cfg It configures the minimum delay time (in milliseconds) of jitter buffer in the wired network. Description Note: It works only if “voice.jib.adaptive”...
Page 368: Smart Noise Block
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones It configures the minimum delay time (in milliseconds) of jitter buffer in the wireless network. Note: It works only if “voice.jib.wifi.adaptive” is set to 1 (Adaptive). The value of the minimum delay time...
Page 369: Dtmf
Audio Features Default Web UI Settings->Voice->Noise Proof->Smart Noise Block DTMF DTMF (Dual Tone Multi-frequency) tone, better known as touch tone. DTMF is the signal sent from the IP phone to the network, which is generated when pressing the IP phone’s keypad during a call. Each key pressed on the IP phone gen- erates one sinusoidal tone of two frequencies.
Page 370: Transmitting Dtmf Digit Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Topic Transmitting DTMF Digit Configuration Transmitting DTMF Digit Configuration The following table lists the parameters you can use to configure the transmitting DTMF digit. Parameter account.X.dtmf.type <MAC>.cfg Description It configures the DTMF type.
Page 371: Suppress Dtmf Display
Audio Features out automatically. Note: If the time interval between two DTMF digits is less than this value, two or more same DTMF digits could be identified as one DTMF digit. This may cause the loss of one or more DTMF digits. For example, 2662 may be identified as 262.
Page 372: Transfer Via Dtmf
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones It enables or disables the IP phone to display the DTMF digits for a short period before displaying asterisks during an active call. Description Note: It works only if “features.dtmf.hide” is set to 1 (Enabled).
Page 373: Local Dtmf Tone Configuration
These metrics can be sent between the phones in RTCP-XR packets. These metrics can also be sent in SIP PUBLISH messages to a central voice quality report collector. Yealink IP phones support two mechanisms for voice quality monitoring: RTCP-XR and VQ-RTCPXR.
Page 374: Vq-Rtcpxr
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Default Parameter voice.rtcp_cname <y0000000000xx>.cfg Description It configures the cname of the RTCP packets. Permitted String Values Default Blank If you change this parameter, the IP phone will reboot to make the change take effect.
Page 375 Audio Features odically throughout a call. Permitted 0-Disabled 1-Enabled Values Default Web UI Settings->Voice Monitoring->VQ RTCP-XR Interval Report Parameter phone_setting.vq_rtcpxr_interval_period <y0000000000xx>.cfg It configures the interval (in seconds) for the IP phone to send an interval quality report to the central report collector periodically throughout a call.
Page 376: Vq-Rtcpxr Display
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones For example, if it is set to 500, when the value of one way delay computed by the phone is greater than or equal to 500, the phone will send a warning alert quality report to the central report collector; when the value of one way delay computed by the phone is less than 500, the phone will not send a warning alert quality report to the central report collector.
Page 377 Audio Features Values Default Web UI Settings->Voice Monitoring->Display Report options on Web Parameter phone_setting.vq_rtcpxr.states_show_on_gui.enable <y0000000000xx>.cfg It enables or disables the voice quality data of the last call or current call to be displayed on the phone screen. You can view the voice quality data of the last call on the phone at the path Menu->Status- Description >More->RTP (RTP Status).
Page 378 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Values 1-Enabled Default Web UI Settings->Voice Monitoring->Report options on phone->Remote User Parameter phone_setting.vq_rtcpxr_display_local_codec.enable <y0000000000xx>.cfg It enables or disables the phone to display Local Codec on the phone screen Description Note: It works only if “phone_setting.vq_rtcpxr.states_show_on_gui.enable” is set to 1 (Enabled).
Page 379: Central Report Collector
Audio Features Default Web UI Settings->Voice Monitoring->Report options on phone->Packets lost phone_setting.vq_rtcpxr_display_symm_oneway_ Parameter <y0000000000xx>.cfg delay.enable It enables or disables the phone to display SymmOneWayDelay on the phone screen. Description Note: It works only if “phone_setting.vq_rtcpxr.states_show_on_gui.enable” is set to 1 (Enabled). Permitted 0-Disabled 1-Enabled...
Page 380: Central Report Collector Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Central Report Collector Configuration The following table lists the parameters you can use to configure central report collector. Parameter account.X.vq_rtcpxr.collector_name <MAC>.cfg It configures the host name of the central report collector that accepts voice quality reports contained in Description SIP PUBLISH messages.
Page 381: Security Features
You can also customize the access permission for configurations on the web user interface and phone user interface. Yealink IP phones support 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 382: User Access Level Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Parameter static.security.user_name.var <y0000000000xx>.cfg It configures the user name of the var for phone’s web user interface access. Description Note: It works only if “static.security.var_enable” is set to 1 (Enabled). Permitted String within 32 characters...
Page 383: Auto Logout Time
You can lock the IP phone to prevent it from unauthorized use. Once the IP phone is locked, anyone must enter the password to unlock it. Yealink IP phones offer three types for phone lock: Lock the Menu soft key: it prevents unauthorized users from accessing the menu, changing the personal settings for your phone.
Page 384: Operation Behaviors On Lock Phone
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Lock all keys: it only allows unauthorized users to use the keypad for dialing an emergency number or authorized numbers that set up by your administrator, answer or reject an incoming call and ending a call. T48G/S IP phones only support All Keys type of phone lock.
Page 385: Phone Lock Configuration
Security Features Function All Keys Menu key Keys hook key and on-hook key. Note: Pressing X key to end the call is not applicable to T23P/T23G/T21(P) E2/T19(P) E2/CP920 IP phones; Line key is not applicable to SIP-T19(P) E2 and CP920 IP phones. HEADSET and Speakerphone key is not applicable to CP920 IP phones.
Page 386: Transport Layer Security (Tls)
Yealink IP phones support TLS version 1.0, 1.1 and 1.2. When TLS is enabled for an account, the SIP message of this account will be encrypted, and a lock icon appears on the LCD screen after the successful TLS negotiation.
Page 387: Supported Cipher Suites
A cipher suite is a named combination of authentication, encryption, and message authentication code (MAC) algorithms used to negotiate the security settings for a network connection using the TLS/SSL network protocol. Yealink IP phones support the following cipher suites: DHE-RSA-AES256-SHA...
Page 388: Supported Trusted And Server Certificates
The format of the server certificate files must be *.pem and *.cer and the maximum file size is 5MB. A unique server certificate: It is unique to an IP phone (based on the MAC address) and issued by the Yealink Cer- tificate Authority (CA).
Page 389 Security Features Thawte Personal Freemail CA Thawte Premium Server CA Thawte Primary Root CA Thawte Primary Root CA - G2 Thawte Primary Root CA - G3 Thawte Server CA VeriSign Class 1 Public Primary Certification Authority VeriSign Class 1 Public Primary Certification Authority - G2 VeriSign Class 1 Public Primary Certification Authority - G3 VeriSign Class 2 Public Primary Certification Authority - G2 VeriSign Class 2 Public Primary Certification Authority - G3...
Page 390: Tls Configuration
Note Yealink endeavors to maintain a built-in list of most common used CA Certificates. Due to memory constraints, we cannot ensure a complete set of certificates. If you are using a certificate from a commercial Certificate Authority not in the list above, you can send a request to your local distributor.
Page 391 Security Features Parameter static.security.default_ssl_method <y0000000000xx>.cfg Description It configures the TLS version the IP phone uses to authenticate with the server. 0-TLS 1.0 only 3-SSL V23 (automatic negotiation with the server. The phone starts with TLS1.2 for negotiation.) Permitted Values 4-TLS 1.1 only 5-TLS 1.2 only Default Parameter static.security.trust_certificates...
Page 392 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Parameter static.trusted_certificates.url <y0000000000xx>.cfg It configures the access URL of the custom trusted certificate used to authenticate the connecting server. Example: Description static.trusted_certificates.url = http://192.168.1.20/tc.crt Note: The certificate you want to upload must be in *.pem, *.crt, *.cer or *.der format.
Page 393: Secure Real-Time Transport Protocol (Srtp)
Security Features Default Parameter phone_setting.reserve_certs_config.enable <y0000000000xx>.cfg It enables or disables the IP 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”, “stat- ic.security.dev_cert”...
Page 394: Srtp Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones The callee receives the INVITE message with the RTP encryption algorithm, and then answers the call by responding with a 200 OK message which carries the negotiated RTP encryption algorithm. Example of the RTP encryption algorithm carried in the SDP of the 200 OK message:...
Page 395: Encrypting And Decrypting Files
X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2; for T19(P) E2/CP920, X=1. Encrypting and Decrypting Files Yealink IP phones support downloading encrypted files from the server and encrypting files before/when uploading them to the server. You can encrypt the following files: Configuration files: MAC-Oriented CFG file (<MAC>.cfg), Common CFG file (y0000000000xx.cfg), MAC-local CFG...
Page 396: Configuration Files Encryption Tools
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Configuration Files Encryption Tools Configuration Files Encryption and Decryption Contact Files Encryption and Decryption Encryption and Decryption Configuration Example: Encrypting Configuration Files Configuration Files Encryption Tools Yealink provides three configuration files encryption tools: Config_Encrypt_Tool.exe (via graphical tool for Windows platform)
Page 397 Security Features Parameter static.auto_provision.update_file_mode <y0000000000xx>.cfg Description It enables or disables the IP phone only to download the encrypted files. 0-Disabled, the IP phone will download the configuration files (for example, sip.cfg, account.cfg, <MAC>-local.cfg) and <MAC>-contact.xml file from the server during auto provisioning no matter whether the files are encrypted or not.
Page 398 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones The valid characters contain: 0 ~ 9, A ~ Z, a ~ z and the following special characters are also supported: # $ % * + , - . : = ? @ [ ] ^ _ { } ~.
Page 399: Example: Encrypting Configuration Files
The following example describes how to use “Config_Encrypt_Tool.exe” to encrypt the account.cfg file. For more information on the other two encryption tools, refer to Yealink Configuration Encryption Tool User Guide. The way the IP phone processes other configuration files is the same as that of the account.cfg file.
Page 400 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones 2. When you start the application tool, a file folder named “Encrypted” is created automatically in the directory where the application tool is located. 3. Click Browse to locate configuration file(s) (for example, account.cfg) from your local system in the Select File(s) field.
Page 401: Incoming Network Signaling Validation
Incoming Network Signaling Validation Yealink IP phones support the following three optional levels of security for validating incoming network signaling: Source IP address validation: ensure the request is received from an IP address of a server belonging to the set of target SIP servers.
Page 402 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Parameter sip.request_validation.digest.realm <y0000000000xx>.cfg It configures the string used for authentication parameter Realm when performing the digest authen- Description tication. Permitted A valid string Values Default YealinkSPIP Parameter sip.request_validation.event <y0000000000xx>.cfg It configures which events specified within the Event header of SUBSCRIBE or NOTIFY request should be validated when performing the digest authentication.
Page 403: Advanced Features
You can use call pickup to answer someone else’s incoming call on your phone. The Yealink IP phones support Directed Call Pickup and Group Call Pickup: Directed Call Pickup: allows you to pick up incoming calls to a specific phone.
Page 404 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones You can configure a directed call pickup code and pick up the incoming call using the DPickup soft key. You can set a DSS key as a Directed Pickup key, and specify a contact you want to pick up a call from for this key. For more...
Page 405: Group Call Pickup
Advanced Features X is the account ID. For T54S/T48S/T48G/T46S/T46G/T29G, X=1-16; for T52S/T42G/T42S, X=1-12; for T41P/T41S/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2; for T19(P) E2/CP920, X=1. Group Call Pickup Group call pickup is used for picking up incoming calls within a pre-defined group. When any phone within a pre- defined group of phones receives an incoming call, you can pick up that call easily on the phone.
Page 406: Dialog Info Call Pickup
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Default Blank Web UI Features->Pick up & Park->Group Call Pickup Code Parameter account.X.group_pickup_code <MAC>.cfg It configures the group pickup code. Note: The group call pickup code configured on a per-line basis (configured by the parameter “accoun- Description t.X.group_pickup_code”) takes precedence over that configured on a phone basis (configured by the para-...
Page 407: Dialog Info Call Pickup Configuration
CSeq: 1 INVITE Contact: <sip:1010@10.10.20.18: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 Replaces: 0_1756536024@10.10.20.34;to-tag=3779921438;from-tag=3408640225 Allow-Events: talk,hold,conference,refer,check-sync Supported: replaces Content-Length: 304 Related Topics Dialog Info Call Pickup Configuration...
Page 408: Call Completion
Callee does not answer Callee actively rejects the incoming call before answering Yealink IP phones support call completion using the SUBSCRIBE/NOTIFY method, which is specified in draft-poetzl-sip- ping-call-completion-00, to subscribe to the busy party and receive notifications of their status changes.
Page 409 Advanced Features Content-Type: application/dialog-info+xml Max-Forwards: 70 User-Agent: Yealink SIP-T46G 28.82.0.20 Subscription-State: active;expires=60 Event: dialog Content-Length: 584 <?xml version="1.0"?> <dialog-info xmlns="urn:ietf:params:xml:ns:dialog-info" version="1" state="full" entity="sip:1000@10.2.1.48:5060"> <dialog id="65626" call-id="0_3138198645@10.10.20.31" local-tag="2331766736" remote-tag="1786911541" dir- ection="initiator"> <state>confirmed</state> <local> <identity>sip:1000@10.2.1.48:5060</identity> <target uri="sip:1000@10.2.1.48:5060"/> </local> <remote> <identity>sip:1@10.2.1.48:5060</identity> <target uri="sip:1@10.2.1.48:5060"/>...
Page 410: Call Completion Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Contact: <sip:1000@10.10.20.31:5060> Content-Type: application/dialog-info+xml Max-Forwards: 70 User-Agent: Yealink SIP-T46G 28.82.0.20 Subscription-State: active;expires=48 Event: dialog Content-Length: 217 <?xml version="1.0"?> <dialog-info xmlns="urn:ietf:params:xml:ns:dialog-info" version="4" state="partial" entity- y="sip:1000@10.2.1.48:5060"> <dialog id="65644"> <state>terminated</state> </dialog> </dialog-info> Topics Call Completion Configuration...
Page 411: Call Park And Retrieve
Advanced Features Example features.call_completion_enable = 1 After provisioning, when you place a call and the callee is temporarily unavailable to answer the call, the phone screen will prompt whether to wait for the callee party. You can activate the call completion feature. After the called party becomes idle, the phone screen will prompt whether to dial the number.
Page 412: Example: Setting Call Park And Retrieve In Fac Mode
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Default Blank Web UI Features->Pick up & Park->Call Park Code Parameter features.call_park.park_retrieve_code <y0000000000xx>.cfg It configures the park retrieve code for FAC call park mode, or configures retrieve parking lot for Transfer Description call park mode.
Page 413: Example: Setting Call Park And Retrieve In Transfer Mode
Advanced Features You can set a line key as a Park key or a Retrieve key, specify an extension you want to park a call to for Park key and spe- Line Keys cify a parked extension you want to retrieve a parked call from for Retrieve key. For more information, refer to Example: Setting Call Park and Retrieve in Transfer Mode The following example shows the configuration for Transfer call park mode.
Page 414: Acd Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Related Topic Line Keys Configuration ACD Configuration The following table lists the parameters you can use to configure ACD. Parameter account.X.acd.enable <MAC>.cfg Description It enables or disables the ACD (Automatic Call Distribution) feature.
Page 415: Example: Setting Acd
Advanced Features Default Parameter account.X.acd.unavailable_reason_enable <MAC>.cfg It enables or disables the unavailable/away reason code feature. Description Note: It works only if “account.X.acd.available" is set to 1 (Enabled). 0-Disabled Permitted 1-Enabled, the unavailable/away reason of agent state will be displayed on the IP phone screen (for Values example, on lunch, in the bathroom, taking a coffee break or a personal break).
Page 416: Busy Lamp Field
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Busy Lamp Field The Busy Lamp Field (BLF) feature enables the IP phone to monitor specific remote lines for state changes on the phone. It is not available on the T19(P) E2/CP920 IP phone.
Page 417 Advanced Features lines. The following table lists the parameters you can use to configure BLF List. Parameter account.X.blf.blf_list_uri <MAC>.cfg It configures the BLF List URI to monitor a list of users for account X. Example: Description account.1.blf.blf_list_uri = 4609@pbx.test.com Note: It is not applicable to T19(P) E2/CP920 IP phones. Permitted SIP URI within 256 characters Values...
Page 418 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Default Blank Web UI Account->Advanced->BLF List Call Parked Code Parameter account.X.blf_list_call_parked_list <MAC>.cfg It configures the serial numbers of the monitored users in the BLF list where you can park the active call for account X.
Page 419: State Indicator Of Remote Line
Advanced Features Parameter phone_setting.blf_list_sequence_type <y0000000000xx>.cfg It configures the order of BLF list DSS keys assigned automatically. Description Note: It works only if “phone_setting.auto_blf_list_enable” is set to 1 (Enabled). It is only applicable to T54S/T52S/T48S/T48G/T46S/T46G/T29G/T27G IP phones. 0-linekey->exp1 key->expN key 1-exp1 key ->expN key ->linekey Permitted 2-linekey page1->page1 from exp1 key to expN key ->page2 from exp1 key to expN key ->…->linekey Values...
Page 420: Blf/Blf List Subscription
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones BLF/BLF List Subscription Yealink IP phones support BLF using a SUBSCRIBE/NOTIFY mechanism as specified in 3265. BLF Subscription When you configure the IP phone to monitor a specific line, the IP phone sends a SUBSCRIBE request with Request-URI containing the monitor line URI to the server, and then receives a NOTIFY request.
Page 421 Advanced Features Note: It is not applicable to T19(P) E2/CP920 IP phones. Permitted Integer from 30 to 2147483647 Values Default 1800 Web UI Account->Advanced->Subscribe Period(Seconds) Parameter account.X.blf.subscribe_event <MAC>.cfg It configures the event of the BLF subscription. Description Note: It is not applicable to T19(P) E2/CP920 IP phones. 0-dialog Permitted Values...
Page 422: Visual And Audio Alert For Monitor Lines
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Note: It works only if “account.X.subscribe_expires_overlap" is set to 0 (Disabled). It is not applicable to T19(P) E2/CP920 IP phones. 0-Disabled Permitted 1-Enabled, the IP phone will generate a random value. The final renewal time is equal to the original Values renewal time plus the random value.
Page 423 Advanced Features Note: It works only if "features.pickup.blf_visual_enable” is set to 1 (Enabled). It is not applicable to CP920/T48G/T46G/T42G/T41P/T29G/T19(P) E2 IP phones. Permitted Monitored phone number Values ListX Default Parameter features.pickup.blf_audio_enable <y0000000000xx>.cfg It enables or disables the IP phone to play an audio alert when the monitored user receives an incoming call.
Page 424: Example: Configuring Visual And Audio Alert For Monitor Lines
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones E2/CP920 IP phones. Permitted Ring1.wav, Ring2.wav, Ring3.wav, Ring4.wav, Ring5.wav, Ring6.wav, Ring7.wav, Ring8.wav, Silent.wav, Values Splash.wav or custom ring tone name (for example, Config:Customring.wav). Default Splash.wav Web UI Features->Pickup & Park->Ring Type for BLF Pickup T54S/T52S/T48S/T48G/T46S/T46G/T29G: Menu->Basic->Sound->BLF Ring Type...
Page 425: Led Mode For Blf/Blf List Key
Advanced Features features.pickup.direct_pickup_code = *97 linekey.1.type = 16 linekey.1.line = 1 BLF Key Configuration linekey.1.value = 1001 linekey.1.label = Bill Example features.pickup.blf_visual_enable = 1 features.pickup.blf_audio_enable = 1 When the monitored line receives an incoming call, the phone screen shows an incoming call to the monitored line (e.g., “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 426 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones LED Status Description Solid green The monitored user is idle. Fast-flashing red The monitored user receives an incoming call. (200ms) The monitored user is dialing. The monitored user is talking. Solid red The monitored user’s conversation is placed on hold (This LED status requires server sup-...
Page 427: Blf Led Mode Configuration
Advanced Features Description LED Status The monitored user is talking. The monitored user’s conversation is placed on hold (This LED status requires server sup- port). Slow-flashing red (1s) The call is parked against the monitored user’s phone number. The monitored user is idle. The monitored user does not exist.
Page 428: Supported Blf/Blf List Key Behaviors
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones BLF Key LED/Icon and Behavior for Hold State Configuration BLF Key LED/Icon and Behavior for DND State Configuration Supported BLF/BLF List Key Behaviors The following behaviors are supported when pressing the BLF/BLF List keys:...
Page 429: Blf Key Led/Icon And Behavior For Call-In State Configuration
Advanced Features Parameter blf.enhanced.idle.callin.action <y0000000000xx>.cfg It configures the behavior when pressing the BLF/BLF list DSS key if the monitor is ringing and monitored user is idle. This value uses the same macro action string syntax as an Enhanced DSS key. Description Example: blf.enhanced.idle.callin.action = newcall...
Page 430 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Note: It is not applicable to T19(P) E2/CP920 IP phones. 0-Disabled Permitted 1-Enabled, the IP phone will display the custom BLF/BLF List DSS key LED status/icon colors and perform Values the custom behavior when pressing the BLF/BLF List DSS key.
Page 431: Blf Key Led/Icon And Behavior For Call-Out State Configuration
Advanced Features Permitted String Values Default Blank Parameter blf.enhanced.callin.idle.action <y0000000000xx>.cfg It configures the behavior when pressing the BLF/BLF list DSS key if the monitor is idle and monitored user is ringing. This value uses the same macro action string syntax as an Enhanced DSS key. Description Example: blf.enhanced.callin.idle.action = newcall...
Page 432: Blf Key Led/Icon And Behavior For Talking State Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Default Blank Parameter blf.enhanced.callout.callin.action <y0000000000xx>.cfg It configures the behavior when pressing the BLF/BLF list DSS key if the monitor is ringing and monitored user is calling out. This value uses the same macro action string syntax as an Enhanced DSS key.
Page 433 Advanced Features Parameter blf.enhanced.talking.enable <y0000000000xx>.cfg It enables or disables the custom configuration when the monitored user is talking. Description Note: It is not applicable to T19(P) E2/CP920 IP phones. 0-Disabled Permitted 1-Enabled, the IP phone will display the custom BLF/BLF List DSS key LED status/icon colors and perform Values the custom behavior when pressing the BLF/BLF List DSS key.
Page 434: Blf Key Led/Icon And Behavior For Parked-Against State Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Note: It works only if “blf.enhanced.talking.enable” is set to 1 (Enabled). It is not applicable to T19(P) E2/CP920 IP phones. Permitted String Values Default Blank Parameter blf.enhanced.talking.idle.action <y0000000000xx>.cfg It configures the behavior when pressing the BLF/BLF list DSS key if the monitor is idle and monitored user is talking.
Page 435 Advanced Features Permitted String Values Default Blank Parameter blf.enhanced.parked.callin.action <y0000000000xx>.cfg It configures the behavior when pressing the BLF/BLF list DSS key if the monitor is ringing and a call is parked against the monitored phone. This value uses the same macro action string syntax as an Enhanced DSS key. Description Example: blf.enhanced.parked.callin.action = newcall...
Page 436: Blf Key Led/Icon And Behavior For Hold State Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones BLF Key LED/Icon and Behavior for Hold State Configuration The following table lists the parameters you can use to configure BLF key LED/icon and Behavior for hold state (the call on the monitored phone is placed on hold).
Page 437: Blf Key For Intercom Configuration
Default Shared Line Yealink IP phones support Shared Call Appearance (SCA) and Bridged Line Appearance (BLA) to share a line. Shared call appearances and bridged line appearances are similar signaling methods that enable more than one phone to share the same line or registration. The methods you use vary with the SIP server you are using.
Page 438: State Indicator Of Shared Line
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Place and answer calls Place a call on hold Retrieve a held call remotely Barge in an active call (only SCA) Pull a shared call (only SCA) Topics State Indicator of Shared Line...
Page 439: Shared Call Appearance (Sca) Configuration
In SCA scenario, an incoming call can be presented to multiple phones simultaneously. Any IP phone can be used to originate or receive calls on the shared line. Yealink IP phones support SCA using a SUBSCRIBE/NOTIFY mechanism as specified in 3265. The events used are: “call-info”...
Page 440: Bridge Lines Appearance (Bla)
IP phone. To use this feature, a BLA group should be pre-configured on the server and one of them is specified as a BLA number. Yealink IP phones support BLA using a SUBSCRIBE/NOTIFY mechanism as specified in 3265. The event used is: “dia- log”...
Page 441: Intercom
Advanced Features It enables or disables the IP 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).
Page 442: State Monitor For Intercom Contact
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Line Key Configuration Programmable Key Configuration linekey.X.type = 14 programablekey.X.type = 14 linekey.X.line = 1 programablekey.X.line = 1 linekey.X.value = 4603 programablekey.X.value = 4603 linekey.X.label = Bill After provisioning, an Intercom key for Bill (4603) is available on the phone. You can press the Intercom key to place an intercom call to Bill (4603).
Page 443: State Monitor For Intercom Contact Configuration
0-Disabled Values 1-Enabled Default Outgoing Intercom Configuration Yealink IP phones support two methods for initialing intercom calls. The following table lists the parameters you can use to configure outgoing intercom. Parameter features.intercom.mode <y0000000000xx>.cfg Description It configures the intercom mode. 0-SIP...
Page 444: Incoming Intercom Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Values Default Blank X is the account ID. For T54S/T48S/T48G/T46S/T46G/T29G, X=1-16; for T52S/T42G/T42S, X=1-12; for T41P/T41S/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2; for T19(P) E2/CP920, X=1. Incoming Intercom Configuration The IP phone can process incoming calls differently depending on settings.
Page 445: Csta Control
Advanced Features already an active call on the IP phone. Values 1-Enabled, the IP phone will automatically answer the intercom call while there is already an active call on the IP phone and place the active call on hold. Default Web UI Features->Intercom->Intercom Barge Phone UI...
Page 446: Csta Control Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones 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 It enables or disables the uaCSTA (User Agent Computer Supported Telecommunications Applications) fea- ture on the IP phone.
Page 447 Advanced Features Event Description Outgoing Call When the IP phone places a call. Established When the IP phone establishes a call. Terminated When the IP phone terminates a call. Open DND When the IP phone enables the DND mode. Close DND When the IP phone disables the DND mode.
Page 448: Variable Values List
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Event Description Autop Finish When the IP phone completes auto provisioning via power on. Open Call Waiting When the IP phone enables the call waiting. Close Call Waiting When the IP phone disables the call waiting.
Page 449: Action Url Configuration
Advanced Features Variable Value Description $ehs_number The number of the connected EHS. $udisk_number The number of the connected USB flash drives. $usbheadset_ The number of the connected USB headset devices. number $wifi_number The number of the connected Wi-Fi dongles. $bluetooth_num- The number of the connected Bluetooth dongles.
Page 450 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Parameter action_url.registered <y0000000000xx>.cfg It configures the action URL the IP phone sends after an account is registered. Description Example: action_url.registered = http://192.168.0.20/help.xml?IP=$ip URL within 511 characters Permitted The value format is: http(s)://IP address of server/help.xml?variable name=variable value. For Pre-defined...
Page 451 Advanced Features Parameter action_url.on_hook <y0000000000xx>.cfg It configures the action URL the IP phone sends when on hook. Description Example: action_url.on_hook = http://192.168.0.20/help.xml?IP=$ip URL within 511 characters Permitted The value format is: http(s)://IP address of server/help.xml?variable name=variable value. For Pre-defined Values events, refer to Pre-defined Events List.
Page 452 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Parameter action_url.dnd_on <y0000000000xx>.cfg It configures the action URL the IP phone sends when DND feature is activated. Description Example: action_url.dnd_on = http://192.168.0.20/help.xml?IP=$ip URL within 511 characters Permitted The value format is: http(s)://IP address of server/help.xml?variable name=variable value. For Pre-defined...
Page 453 Advanced Features Parameter action_url.busy_fwd_on <y0000000000xx>.cfg It configures the action URL the IP 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 URL within 511 characters Permitted The value format is: http(s)://IP address of server/help.xml?variable name=variable value. For Pre-defined Values events, refer to Pre-defined Events...
Page 454 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Parameter action_url.transfer_call <y0000000000xx>.cfg It configures the action URL the IP phone sends when performing a transfer. Description Example: action_url.transfer_call = http://192.168.0.20/help.xml?IP=$ip URL within 511 characters Permitted The value format is: http(s)://IP address of server/help.xml?variable name=variable value. For Pre-defined...
Page 455 Advanced Features Parameter action_url.unhold <y0000000000xx>.cfg It configures the action URL the IP phone sends when resuming a hold call. Description Example: action_url.unhold = http://192.168.0.20/help.xml?IP=$ip URL within 511 characters Permitted The value format is: http(s)://IP address of server/help.xml?variable name=variable value. For Pre-defined Values events, refer to Pre-defined Events...
Page 456 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones action_url.unmute = http://192.168.0.20/help.xml?IP=$ip URL within 511 characters Permitted The value format is: http(s)://IP address of server/help.xml?variable name=variable value. For Pre-defined Values events, refer to Pre-defined Events List. For variable value, refer to Variable Values List.
Page 457 Advanced Features Example: action_url.idle_to_busy = http://192.168.0.20/help.xml?IP=$ip URL within 511 characters Permitted The value format is: http(s)://IP address of server/help.xml?variable name=variable value. For Pre-defined Values events, refer to Pre-defined Events List. For variable value, refer to Variable Values List. Default Blank Web UI Features->Action URL->Idle to Busy Parameter action_url.ip_change...
Page 458 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones action_url.answer_new_incoming_call = http://192.168.0.20/help.xml?IP=$ip URL within 511 characters Permitted The value format is: http(s)://IP address of server/help.xml?variable name=variable value. For Pre-defined Values events, refer to Pre-defined Events List. For variable value, refer to Variable Values List.
Page 459 Advanced Features action_url.call_waiting_on = http://192.168.0.20/help.xml?IP=$ip URL within 511 characters Permitted The value format is: http(s)://IP address of server/help.xml?variable name=variable value. For Pre-defined Values events, refer to Pre-defined Events List. For variable value, refer to Variable Values List. Default Blank Web UI Features->Action URL->Call Waiting On Parameter action_url.call_waiting_off <y0000000000xx>.cfg...
Page 460 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones It configures the action URL the IP phone sends when canceling the outgoing call in the ring-back state. Description Example: action_url.cancel_callout= http://192.168.0.20/help.xml?IP=$ip URL within 511 characters Permitted The value format is: http(s)://IP address of server/help.xml?variable name=variable value. For Pre-defined...
Page 461: Action Uri
Advanced Features Action URI Yealink IP phones can perform the specified action by receiving and handling an HTTP or HTTPS GET request or accept a SIP NOTIFY message with the “Event: ACTION-URI” header from a SIP proxy server. Topics Supported HTTP/HTTPS GET Request...
Page 462: Variable Values List
Variable Values List Yealink IP phones also support a combination of the variable values in the URI, but the order of the variable value is determined by the operation of the phone. The valid URI format is: http(s)://<phoneIPAddress>/servlet?key=variable value[;variable value]. Variable values are separated by a semicolon from each other. This method is not applicable to T48G/S IP phones.
Page 463 Reboot the phone. AutoP Perform auto provisioning. Activate the DND feature. DNDOn Note: For Yealink IP phones, it works only if “features.dnd.allow” is set to 1 (Enabled). Deactivate the DND feature. DNDOff Note: For Yealink IP phones, it works only if “features.dnd.allow”...
Page 464 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Variable Value Phone Action Hang up the handset (not applicable to CP920 IP phones). ONHOOK Press the on-hook key. (only applicable to CP920 IP phones) ANSWER/ASW/Asw Answer a call. Reset Reset a phone.
Page 465: Action Uri Configuration
Advanced Features Variable Value Phone Action 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)://<phoneIPAddress>/help.xml?CallId=$call_id. For more information, refer to Action URL.
Page 466: Example: Capturing The Current Screen Of The Phone
(which is saved as a JPG file and named with the phone model and the capture time) to the local system. Note Yealink IP phones also support capturing the screen display using the old URI “http://<- phoneIPAddress>/servlet?command=screenshot”. Before capturing the phone’s current screen, ensure that the IP address of the computer is included in the trusted IP address for Action URI on the phone.
Page 467: Example: Placing A Call Via Web User Interface
Else, the browser will display an image of the phone’s current screen directly. You can save the image to your local system. Note Frequent capture may affect the phone performance. Yealink recommends you to capture the phone screen display within a minimum interval of 4 seconds. Example: Placing a Call via Web User Interface Procedure 1.
Page 468: Voice Mail
Yealink IP phones support voice mail. You can configure a message waiting indicator (MWI) to inform users that how many messages are waiting in their mailbox without calling the mailbox. Yealink IP phones support both audio and visual MWI alert when receiving new voice messages.
Page 469 Advanced Features Permitted 0-Disabled 1-Enabled Values Default Parameter account.X.sub_fail_retry_interval <MAC>.cfg Description It configures the interval (in seconds) for the IP phone to retry to re-subscribe when subscription fails. Permitted Integer from 0 to 3600 Values Default Parameter account.X.subscribe_mwi_to_vm <MAC>.cfg It enables or disables the IP phone to subscribe the message waiting indicator to the voice mail number. Description Note: It works only if “account.X.subscribe_mwi”...
Page 470: Short Message Service (Sms)
X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2; for T19(P) E2/CP920, X=1. Short Message Service (SMS) Yealink IP phones (except CP920 IP phones) support short message service (SMS). It allows users to send and receive text message on the support server.
Page 471 Advanced Features any-The phone will accept HTTP POST messages from any server. IP address or domain name-Multiple addresses are separated by commas. (for example, 10.1.4.3,10.1.4.23); Support asterisk wildcard, each asterisk represents a field of the IP address (10.10.*.* rep- resents 10.10.0.0 to 10.10.255.255). Default Blank Web UI...
Page 472: Hot Desking
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Values Default Blank Parameter features.xml_browser.pwd <y0000000000xx>.cfg Description It configures the authentication password for XML request. Permitted String within 15 characters Values Default Blank Parameter push_xml.username <y0000000000xx>.cfg Description It configures the user name for the IP phone to authenticate with the push XML server.
Page 473: Hot Desking Key Configuration
Advanced Features Hot Desking Key Configuration The following shows configuration for a Hot Desking key. Line Key Configuration Programmable Key Configuration linekey.X.type = 34 programablekey.X.type = 34 linekey.X.label = Hot Desking After provisioning, a Hot Desking key is available on the phone. You can press the Hot Desking key to clear pre-regis- tration configurations of all accounts and register their own account on line 1.
Page 474 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones when pressing the Hot Desking DSS key. Note: It is not applicable to CP920 IP phones. 0-Disabled Permitted Values 1-Enabled, the original SIP server information will be cleared. Default Parameter hotdesking.dsskey_outbound_enable <y0000000000xx>.cfg...
Page 475: General Features
Cloud Line Identification Presentation Yealink IP 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 IP phones to display the caller identity, derived from a SIP header contained in the INVITE message when receiving an incoming call.
Page 476 It configures the priority order for the sources of caller identity information. The headers can be in any order. Description Note: Yealink IP phones can derive caller identity from the following SIP headers: From, P-Asserted-Iden- tity (PAI), P-Preferred-Identity and Remote-Party-ID (RPID). It works only if “account.X.cid_source” is set to 6 (PREFERENCE).
Page 477: Return Code For Refused Call
General Features ported header. The caller then receives an UPDATE message from the server, and displays the identity in the “From” header. 3-PAI-RPID-Contact Default X is the account ID. For T54S/T48S/T48G/T46S/T46G/T29G, X=1-16; for T52S/T42G/T42S, X=1-12; for T41P/T41S/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2; for T19(P) E2/CP920, X=1. Return Code for Refused Call You can define the return code and reason of the SIP response message for the refused call.
Page 478: Return Code For Unanswered Call Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Return Code for Unanswered Call Configuration Return Code for Unanswered Call Configuration The following table lists the parameters you can use to configure the return code for the refused call. Parameter features.no_answer_code <y0000000000xx>.cfg...
Page 479: Accept Sip Trust Server Only
General Features Barge In Retrieve Call Park Group Park Call Pull Permitted 0-Disabled 1-Enabled Values Default Web UI Features->General Information->Hide Feature Access Codes Accept SIP Trust Server Only Accept SIP trust server only enables the IP phones to only accept the SIP message from your SIP server and outbound proxy server.
Page 480: 100 Reliable Retransmission Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones CSeq: 2 INVITE Contact: <sip:1025@10.3.6.197:5060> Authorization: Digest username="1025", realm="pbx.test.com", nonce="BroadWorksXi5stub71Ts2nb05BW", uri- i="sip:1024@pbx.test.com:5060", response="f7e9d35c55af45b3f89beae95e913171", algorithm=MD5, cnon- ce="0a4f113b", qop=auth, nc=00000001 Content-Type: application/sdp Allow: INVITE, INFO, PRACK, ACK, BYE, CANCEL, OPTIONS, NOTIFY, REGISTER, SUBSCRIBE, REFER, PUBLISH, UPDATE,...
Page 481: Sip Session Timer Configuration
General Features The user registers a SIP account for the IP phone and then set the value of Timer T1, Timer T2 respectively (Timer T1: 0.5, Timer T2: 4). The SIP registration request message will be re-transmitted between the IP phone and SIP server. The re- transmitting and doubling of Timer T1 (0.5) will continue until the retransmitting time reaches the Timer T2 (4).
Page 482: Session Timer Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones SIP server will function as a UAC. The session expiration is negotiated via the Session-Expires header in the INVITE mes- sage. The negotiated refresher is always the UAC and it will send an UPDATE request at the negotiated session expir- ation.
Page 483: Reboot In Talking
General Features Default 1800 Web UI Account->Advanced->Session Expires(90~7200s) Parameter account.X.session_timer.refresher <MAC>.cfg It configures the function of the endpoint who initiates the SIP request. Description Note: It works only if “account.X.session_timer.enable” is set to 1 (Enabled). 0-UAC Permitted Values 1-UAS Default Web UI Account->Advanced->Session Refresher X is the account ID.
Page 484: Reserve # In User Name Configuration
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones From: "1010" <sip:1010%23@10.2.1.48:5060>;tag=1945988802 To: <sip:2@10.2.1.48:5060> Call-ID: 0_2336101648@10.3.20.6 CSeq: 1 INVITE Contact: <sip:1010%23@10.3.20.6:5060> Content-Type: application/sdp Allow: INVITE, INFO, PRACK, ACK, BYE, CANCEL, OPTIONS, NOTIFY, REGISTER, SUBSCRIBE, REFER, PUBLISH, UPDATE, MESSAGE Max-Forwards: 70 User-Agent: Yealink SIP-T46G 28.82.0.20...
Page 485: Cfg File Version Information
General Features 3-3s, a busy tone is audible for 3 seconds on the IP phone. Values 5-5s, a busy tone is audible for 5 seconds on the IP 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.
Page 486: Media Loopback
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Values Default Blank Media Loopback The SIP RTP media loopback can be used to make test calls to verify the media path between the phone and server. RTP packets are looped back toward the source device. In a voice loopback call, an echo is heard at the device ori- ginating the call.
Page 487: Cloud
Values Default Cloud Yealink CP920 IP phones support cloud feature. The Cloud enterprise administrator uses the Yealink VC Cloud man- agement service to assign each user an individual Cloud account. For more information, refer to Yealink VC Cloud Man- agement Service Administrator Guide After registering a Yealink Cloud account successfully, the IP phone will download the Cloud accounts information from the server automatically.
Page 488 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Values 1-Enabled Default Web UI Features->General Information->Cloud Enable...
Page 489: Configuration Parameters
Configuration Parameters Configuration Parameters This section provides a description and permitted values of some settings. Topics BroadSoft Parameters Start2Start ACD Parameters Ethernet Interface MTU Parameter SIP Settings Parameters Call Settings Parameters BroadSoft Parameters This section shows the parameters you can use to configure the phone with BroadSoft server. For more information on BSFT, refer to Yealink_IP_Phone_Features_Integrated_with_BroadSoft_UC-One_User_Guide Yealink_IP_Phones_Deployment_Guide_for_BroadSoft_UC-One_Environment.
Page 490 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones It configures the password for UC authentication. Description Note: It works only if “bw.xmpp.enable" is set to 1 (Enabled). It is only applicable to T54S/T52S/T48S/T48G/T46S/T46G/T29G IP phones. Permitted String within 32 characters...
Page 491 Configuration Parameters Note: It works only if “phone_setting.dsskey_directory_auto.enable” is set to 1 (Enabled). To assign Ext Key, make sure the expansion module has been connected to the phone in advance. It is only applicable to T54S/T52S/T48S/T48G/T46S/T46G/T29G IP phones. 0-linekey->exp1 key->expN key 1-exp1 key ->expN key ->linekey Permitted 2-linekey page1->page1 from ex1 key to expN key ->page2 from exp1 key to expN key ->…->linekey...
Page 492: Broadsoft Xsi
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones and display results on the pre-dialing/dialing screen. Note: It is only applicable to T54S/T52S/T48S/T48G/T46S/T46G/T29G IP phones. Permitted 0-Disabled 1-Enabled Values Default Parameter search_in_dialing.bw_uc_buddies.priority <y0000000000xx>.cfg It configures the search priority of the BroadSoft Buddies directory.
Page 493 Configuration Parameters Example: account.1.xsi.password = 123456 Note: It works only if “sip.authentication_for_xsi” is set to 0 (User Login Credentials for XSI Authentic- ation) and “bw.xsi.enable" is set to 1 (Enabled). Permitted String within 99 characters Values Default Blank Web UI Applications->Broadsoft XSI->XSI Account->Password (if bw.enable =1) Parameter account.X.xsi.host <MAC>.cfg...
Page 494 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Description It enables or disables the XSI authentication feature for the IP phone. 0-Disabled 1-Enabled If it is set to 0 (Disabled), the following features are unavailable on the phone: BroadWorks Anywhere...
Page 495: Broadsoft Acd
Configuration Parameters X is the account ID. For T54S/T48S/T48G/T46S/T46G/T29G, X=1-16; for T52S/T42G/T42S, X=1-12; for T41P/T41S/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2; for T19(P) E2/CP920, X=1. If you change this parameter, the IP phone will reboot to make the change take effect. Broadsoft ACD Parameter account.X.acd.initial_state <MAC>.cfg...
Page 496 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Description It configures the interval (in seconds) to specify how long the call center call information displays. Permitted Integer from 1 to 86400 Values Default Parameter account.X.call_center.disp_code_enable <MAC>.cfg Description It enables or disables the disposition code feature.
Page 497 Configuration Parameters Values 1-Enabled Default Parameter bw.virtual_user.1.enable <MAC>.cfg It enables or disables the virtual account for the call center. Description Note: It works only if “bw.xsi.enable” is set to 1 (Enabled). It is not applicable to T48G/T46G/T42G/T41P/T29G IP phones. 0-Disabled Permitted Values 1-Enabled...
Page 498 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Parameter bw.virtual_user.1.xsi.host <MAC>.cfg It configures the IP address of the Xtended Services Platform server for the virtual account. Description Note: It works only if “bw.xsi.enable” is set to 1 (Enabled). It is not applicable to T48G/T46G/T42G/T41P/T29G IP phones.
Page 499 Configuration Parameters Description It configures the disposition code name which must match one of the names configured on BroadWorks. Permitted String within 99 characters Values Default Blank [1][2] Parameter account.X.supervisor_info_code.Y <MAC>.cfg Description It configures the supervisor number. Permitted Integer from 1 to 2147483647 Values Default Blank...
Page 500 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones 1-Enabled, it provides the capability for the call center agent to immediately escalate a call to a supervisor Values by pressing a key on the phone. The supervisor is immediately joined into the call.
Page 501 Configuration Parameters Parameter bw.virtual_user.1.xsi.dnd.enable <MAC>.cfg It enables or disables the DND feature for the call center. Note: It works only if “bw.xsi.enable” is set to 1 (Enabled). It is not applicable to SIP- Description T48G/T46G/T42G/T41P/T29G IP phones. If you leave it blank, the virtual user name uses VirtualUser1 by default.
Page 502: Broadsoft Centralized Call Recording
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Broadsoft Centralized Call Recording Parameter account.X.call_recording.enable <MAC>.cfg Description It enables or disables the centralized call recording feature. Permitted 0-Disabled Values 1-Enabled Default Parameter bw.call_recording.mode <y0000000000xx>.cfg It configures the centralized call recording mode.
Page 503: Broadsoft Flexible Seating
Configuration Parameters Description It configures the password used to log into the guest profile. Permitted String within 99 characters Values Default Blank Parameter features.homescreen_softkey.hoteling.enable <y0000000000xx>.cfg It enables or disables the IP phone to display the Hoteling soft keys such as GuestIn or GuestOut on the idle screen.
Page 504: Broadsoft Call Decline
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Default Parameter account.X.hoteling.mode <MAC>.cfg Description It configures the hoteling mode. 0-Disabled 1-Hoteling Permitted Values 2-Flexible Seating Host 3-Flexible Seating Guest Default Parameter account.X.hoteling.pin <MAC>.cfg Description It configures the flexible seating PIN.
Page 505: Broadsoft Network Directory
Configuration Parameters Description It enables or disables call decline feature. Permitted 0-Disabled 1-Enabled Values Default Blank Parameter features.call_decline.enable <y0000000000xx>.cfg Description It enables or disables call decline feature for the IP phone. Permitted 0-Disabled Values 1-Enabled Default X is the account ID. For T54S/T48S/T48G/T46S/T46G/T29G, X=1-16; for T52S/T42G/T42S, X=1-12; for T41P/T41S/T27G, X=1-6;...
Page 506 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Values 1-Enabled Default Web UI Applications->Broadsoft XSI->Network Directory->Group Common (if bw.enable =1) Parameter bw_phonebook.enterprise_enable <y0000000000xx>.cfg It enables or disables the IP phone to display the enterprise directory. Description Note: It works only if "bw.xsi.enable" and "bw.xsi.directory.enable" are set to 1 (Enabled).
Page 507 Configuration Parameters on the BroadWorks server Default Parameter bw.xsi.call_log.multiple_accounts.enable <y0000000000xx>.cfg It enables or disables the user to view BroadSoft Call Log for multiple accounts. Description Note: It works only if “bw.xsi.call_log.enable” is set to 1 (Enabled). It is not applicable to T19(P) E2 IP/CP920 phones.
Page 508 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Values Default Personal Web UI Applications->Broadsoft XSI->Network Directory->Personal (if bw.enable =1) Parameter directory.update_time_interval <y0000000000xx>.cfg It configures the interval (in minutes) for the IP phone to update the data of the BroadSoft directory from the BroadSoft server.
Page 509: Broadsoft Visual Voice Mail
Configuration Parameters Permitted 0-Disabled, the IP phone will enter Local Calls screen when pressing the History soft key. 1-Enabled Values Default Parameter search_in_dialing.bw_directory.enable <y0000000000xx>.cfg It enables or disables the IP phone to automatically search entries from the BroadSoft directory, and dis- Description play the results on the pre-dialing/dialing screen.
Page 510: Broadsoft Sca
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Parameter voice_mail.message_key.mode <y0000000000xx>.cfg Description It configures the phone behavior when pressing the MESSAGE key when the IP phone is idle. 0-enter the Set Voice Mail Code screen if the voice mail access code has not been configured; dial out the Permitted voice mail access code if the voice mail access code has been configured.
Page 511: Broadsoft Call Park
Configuration Parameters If the user does not perform any operation for 10 seconds on Shared Calls screen, the IP phone will exit the screen. Note: You can enter the Shared Calls screen by long pressing the shared line key when there is a call on the remote shared line party.
Page 512: Broadsoft Emergency Call
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Web UI Features->Pickup & Park->Group Call Park Code (if bw.enable =1) Parameter sip.call_park_without_blf <y0000000000xx>.cfg It enables or disables the phone to close the BLF monitoring feature for call park DSS key.
Page 513 <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_response?reason_ code=#REASONCODE&agent_extension=ext_843 85&agent_location= starbox_628&agent_phone- Description e=94&customer_id=435s #REASONCODE will be automatically replaced with the away code you entered when the URL is sent to the server.
Page 514: Ethernet Interface Mtu Parameter
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones X is the account ID. For T54S/T48S/T48G/T46S/T46G/T29G, X=1-16; for T52S/T42G/T42S, X=1-12; for T41P/T41S/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2; for T19(P) E2/CP920, X=1. Ethernet Interface MTU Parameter Parameter static.network.mtu_value <y0000000000xx>.cfg...
Page 515 Configuration Parameters Default Parameter account.X.insert_outbound_in_route.enable <MAC>.cfg It enables or disables the IP phone to add outbound server address as the topmost Route header in the request message. Description Note: It works only if the received 200 OK response for the REGISTER request contains the Service route header.
Page 516 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Values 1-Enabled. If the To-tag does not exist, the IP phone will reject the request. Default Parameter features.call_invite_format <y0000000000xx>.cfg Description It configures the format of callee field in the INVITE message.
Page 517: Call Settings Parameters
Configuration Parameters Parameter sip.send_keepalive_by_socket <y0000000000xx>.cfg Description It enables or disables the IP phone to send the keep-alive packets based on the TCP socket. Permitted 0-Disabled 1-Enabled Values Default Parameter sip.sdp_early_answer_or_offer <y0000000000xx>.cfg It enables or disables the IP phone to generate an SDP Offer or Answer message when receiving a reliable Description provisional response or PRACK request and response.
Page 518 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones 0-Disabled, the IP phone will not prompt the incoming call information when the user is dialing or select- ing a contact from the directory/call log lists to transfer a call/to set up a conference/to place a new call.
Page 519: Troubleshooting Methods
Log Files Yealink IP phone can log events into two different log files: boot log and system log. You can choose to generate the log files locally or sent to syslog server in real time, and use these log files to generate informational, analytic and troubleshoot phones.
Page 520 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Parameter static.local_log.enable <y0000000000xx>.cfg It enables or disables the IP phone to record log locally. Description Note: We recommend that you do not disable this feature. 0-Disabled, the IP phone will stop recording log to the log files (<MAC>-boot.log and <MAC>-sys.log) locally.
Page 521 Troubleshooting Methods Integer from 256 to 1024 For T54S/T52S/T48S/T48G/T46S/T46G/T42G/T42S/T41P/T41S/T29G/T27G/CP920 IP phones: The default value is 1024 Default For T40P/T40G/T23P/T23G/T21(P) E2/T19(P) E2 IP phones: The default value is 256 T54S/T52S/T48S/T48G/T46S/T46G/T42G/T42S/T41P/T41S/T29G/T27G/CP920: Settings->Configuration->Max Log File Size (256-2048KB) Web UI T40P/T40G/T23P/T23G/T21(P) E2/T19(P) E2: Settings->Configuration->Max Log File Size (256-1024KB) Parameter static.auto_provision.local_log.backup.enable <y0000000000xx>.cfg It enables or disables the IP phone to upload the local log files (<MAC>-boot.log and <MAC>-sys.log) to...
Page 522: Exporting The Log Files To A Local Pc
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones visioning for uploading files. Example: static.auto_provision.local_log.backup.path = tftp://10.3.6.133/upload/ Note: It works only if “static.auto_provision.local_log.backup.enable” is set to 1 (Enabled). Permitted URL within 1024 characters Values Default Blank Parameter static.auto_provision.local_log.backup.append <y0000000000xx>.cfg It configures whether the uploaded local log files (<MAC>-boot.log and <MAC>-sys.log) overwrite the Description existing files or are appended to the existing files.
Page 523: Viewing The Log Files
Troubleshooting Methods 1. From the web user interface, navigate to Settings->Configuration. 2. Select Enabled from the pull-down list of Enable Local Log. 3. Select 6 from the pull-down list of Local Log Level. The default local log level is “3”. 4.
Page 524: Syslog Logging
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones The <MAC>-sys.log file reports the logs with a configured severity level and the higher. For example, if you have con- figured the severity level of the log to be reported to the <MAC>-sys.log file to 4, then the log with a severity level of 0 to 4 will all be reported.
Page 525 Troubleshooting Methods static.syslog.port = 515 Permitted Integer from 1 to 65535 Values Default Web UI Settings->Configuration->Syslog->Syslog Server->Port Parameter static.syslog.transport_type <y0000000000xx>.cfg It configures the transport protocol that the IP phone uses when uploading log messages to the syslog Description server. 0-UDP Permitted 1-TCP Values...
Page 526: Viewing The Syslog Messages On Your Syslog Server
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones 6-Line Printer Subsystem 7-Network News Subsystem 8-UUCP Subsystem 9-Clock Daemon (note 2) 10-Security/Authorization Messages (Note 1) 11-FTP Daemon 12-NTP Subsystem 13-Log Audit (note 1) 14-Log Alert (note 1) 15-Clock Daemon (Note 2)
Page 527: Resetting Phone And Configuration
Troubleshooting Methods Resetting Phone and Configuration Generally, some common issues may occur while using the IP phone. You can reset your phone to factory con- figurations after you have tried all troubleshooting suggestions, but still do not solve the problem. Resetting the phone to factory configurations clears the flash parameters, removes log files, user data, and cached data, and resets the administrator password to admin.
Page 528: Resetting The Ip Phone To Default Factory Settings
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Parameter features.reset_by_long_press_enable <y0000000000xx>.cfg Description It enables or disables the IP phone to reset to factory by long pressing OK/√key. Permitted 0-Disabled 1-Enabled Values Default Parameter features.factory_pwd_enable <y0000000000xx>.cfg It enables or disables the IP phone to prompt for the administrator password when you long press the Description OK/√key to perform factory reset on the idle screen.
Page 529: Deleting The Custom Factory Settings Files
Troubleshooting Methods Description It enables or disables the Custom Factory Configuration feature. 0-Disabled Permitted 1-Enabled, Import Factory Configuration item will be displayed on the IP phone's web user interface at Values the path Settings->Configuration. You can import a custom factory configuration file or delete the user- defined factory configuration via web user interface.
Page 530: Capturing The Packets Via Web User Interface
Ethernet Software Capturing Configuration Capturing the Packets via Web User Interface For Yealink IP phones, you can export the packets file to the local system and analyze it. Yealink IP phones support the following two modes for capturing the packets: Normal: Export the packets file after stopping capturing.
Page 531: Ethernet Software Capturing Configuration
Troubleshooting Methods 6. Enter the desired value in the Packet Filter String field. 7. Click Start in the Pcap Feature field to start capturing signal traffic. 8. Reproduce the issue to get stack traces. 9. Click Stop in the Pcap Feature field to stop capturing. 10.
Page 532: Watch Dog
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Watch Dog The IP phone provides a troubleshooting feature called “Watch Dog”, which helps you monitor the IP phone status and provides the ability to get stack traces from the last time the IP phone failed. If the Watch Dog feature is enabled, the IP phone will automatically reboot when it detects a fatal failure.
Page 533: Network Reachability Detection Configuration
Troubleshooting Methods You can also diagnose network via phone user interface at the path: Menu->Features->Diagnostics->Network->Ping or Menu->Features->Diagnostics->Network->Trace Route. Network Reachability Detection Configuration The following table lists the parameters you can use to configure network reachability detection. Parameter static.features.network_test.enable <y0000000000xx>.cfg Description It enables or disables the network reachability detection. 0-Disabled Permitted 1-Enabled, if the network is unreachable, "Network unreachable"...
Page 534: Analyzing Configuration Files
We recommend you to edit the exported CFG file instead of the BIN file to change the phone’s current settings. The config.bin file is an encrypted file. For more information on config.bin file, contact your Yealink reseller. Topics Exporting CFG Configuration Files from Phone...
Page 535: Importing Cfg Configuration Files To Phone
Troubleshooting Methods <MAC>-non-static.cfg: It contains all changes associated with non-static parameters made via phone user inter- face, web user interface and using configuration files. <MAC>-config.cfg: It contains changes associated with non-static parameters made using configuration files. It can be exported only if “static.auto_provision.custom.protect” is set to 1 (Enabled). Procedure 1.
Page 536: Bin Files Import Url Configuration
Exporting All the Diagnostic Files Yealink IP phones support three types of diagnostic files (including Pcap trace, log files (boot.log and sys.log) and BIN configuration files) to help analyze your problem. You can export these files at a time and troubleshoot if necessary.
Page 537: Viewing The Phone Status
Troubleshooting Methods T54S/T52S/T48S/T46S/T42S/T41S/T27G/CP920 IP phone. Topic Viewing the Phone Status Viewing the Phone Status You can view phone status via phone user interface by pressing the OK key or navigating to Menu->Status You can also view the phone status via the web user interface. Procedure 1.
Page 538: Rebooting The Ip Phone Via Phone User Interface
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Parameter sip.notify_reboot_enable <y0000000000xx>.cfg It configures the IP phone behavior when receiving a SIP NOTIFY message which contains the header Description “Event: check-sync”. 0-The IP phone will reboot only if the SIP NOTIFY message contains an additional string “reboot=true”.
Page 539: Troubleshooting Solutions
Troubleshooting Solutions Troubleshooting Solutions This section describes solutions to common issues that may occur while using the IP phone. Upon encountering a case not listed in this section, contact your Yealink reseller for further support. Topics IP Address Issues Time and Date Issues...
Page 540: Time And Date Issues
PC to access the web user interface. Scenario 2: Yealink IP phones support using FTP, TFTP, HTTP and HTTPS protocols to download configuration files or resource files. You can use one of these protocols for provisioning. When provisioning your IP phone obtaining an IPv6 address, the provisioning server should support IPv6 and the format of the access URL of the provisioning server can be “tftp://[IPv6 address or domain name]”.
Page 541: Get Poor Sound Quality During A Call
The phone cannot connect to Bluetooth devices all the time Try to delete the registration information of the Bluetooth device on both IP phone and Bluetooth device, and then pair and connect it again. Contact Yealink field application engineer and your Bluetooth device manufacturer for more information.
Page 542: Firmware And Upgrading Issues
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones Firmware and Upgrading Issues Fail to upgrade the phone firmware Do one of the following: Ensure that the target firmware is not the same as the current firmware. Ensure that the target firmware is applicable to the IP phone model.
Page 543: The Ip Phone Does Not Update The Configurations
Troubleshooting Solutions Item Description Note: With the same major version, the larger it is, the newer the mimor version is. The IP phone does not update the configurations Do one of the following: Ensure that the configuration is set correctly. Reboot the phone.
Page 544: Logo Issues
If your IP phone does not boot, check if the provisioning server is accessible on the network and a valid software firm- ware and valid configuration files are available. Try to use recovery mode to get your phone ready. For more inform- ation on recovery mode, refer to Recovery Mode on Yealink IP phones. Other Issues The difference among user name, register name and display name Both user name and register name are defined by the server.
Page 545: On Code And Off Code
Troubleshooting Solutions On code and off code They are codes that the IP phone sends to the server when a certain action takes place. On code is used to activate a feature on the server side, while off code is used to deactivate a feature on the server side. 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.
Page 546: The Difference Between Shared Call Appearance (Sca) And Bridge Lines Appearance (Bla)
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones The difference between Shared Call Appearance (SCA) and Bridge Lines Appearance (BLA) SCA and BLA are similar signaling methods that enable more than one phone to share a SIP line. The method you use varies with the SIP server you are using.
Page 547: Appendix
Appendix Appendix RFC and Internet Draft Support The following RFC’s and Internet drafts are supported: RFC 1321—The MD5 Message-Digest Algorithm RFC 1889—RTP Media control RFC 2112—Multipart MIME RFC 2327—SDP: Session Description Protocol RFC 2387—The MIME Multipart/Related Content-type RFC 2543—SIP: Session Initiation Protocol RFC 2617—Http Authentication: Basic and Digest access authentication RFC 2782—A DNS RR for specifying the location of services (DNS SRV) RFC 2806—URLs for Telephone Calls...
Page 548 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones RFC 3581—An Extension to the SIP for Symmetric Response Routing RFC 3608—SIP Extension Header Field for Service Route Discovery During Registration RFC 3611—RTP Control Protocol Extended Reports (RTCP XR) RFC 3665—Session Initiation Protocol (SIP) Basic Call Flow Examples RFC 3666—SIP Public Switched Telephone Network (PSTN) Call Flows.
Page 549: Reading Icons
T48S T48G T46S T46G T29G Description /T21(P) E2 Wired net- work is unavailable Wired net- work is unreachable Private line registers suc- cessfully Registration failed Registering (Flash- (Flash- ing) ing) Yealink Cloud account registers suc- cessfully Hands-free (speak- erphone) mode...
Page 550 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones T54S/T- T42S/T- T42G/T- T40P- T27- CP9- T23P/T23G- T48S T48G T46S T46G T29G Description /T21(P) E2 Handset mode Headset mode Voice Mail Text Mes- sage Auto Answer Do Not Dis- turb Phone Warn-...
Page 551 Appendix T54S/T- T42S/T- T42G/T- T40P- T27- CP9- T23P/T23G- T48S T48G T46S T46G T29G Description /T21(P) E2 A call cannot be recorded (DSSKey recording) Recording starts suc- cessfully (DSSKey recording) Recording cannot be started (DSSKey recording) Recording cannot be stopped (DSSKey recording) VPN is enabled...
Page 552 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones T54S/T- T42S/T- T42G/T- T40P- T27- CP9- T23P/T23G- T48S T48G T46S T46G T29G Description /T21(P) E2 / Conference The default contact icon The default caller photo Line key type is Line (line...
Page 553 Appendix T54S/T- T42S/T- T42G/T- T40P- T27- CP9- T23P/T23G- T48S T48G T46S T46G T29G Description /T21(P) E2 Line key type is Direct Pickup Line key type is Group Pickup Line key type is Call Park (park suc- cessfully/call park idle state) Line key type is Call Park (call park...
Page 554 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones T54S/T- T42S/T- T42G/T- T40P- T27- CP9- T23P/T23G- T48S T48G T46S T46G T29G Description /T21(P) E2 Line key type is Local Group/XML Group/LDAP Line key type is XML Browser Line key type...
Page 555 Appendix T54S/T- T42S/T- T42G/T- T40P- T27- CP9- T23P/T23G- T48S T48G T46S T46G T29G Description /T21(P) E2 Line key type is ACD Line key type is Zero Touch Line key type is URL Line key type is Phone Lock Line key type is Directory Line key type is Custom...
Page 556 Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series/CP920 IP Phones T54S/T- T42S/T- T42G/T- T40P- T27- CP9- T23P/T23G- T48S T48G T46S T46G T29G Description /T21(P) E2 public hold USB flash drive/PSTN box is detect- ing (PSTN (Flash- (Flash- (Flash- (Flash- (Flash- (Flash-...

This manual is also suitable for:

Sip-t4 series Sip-t5 series Cp920 T54s T52s T48s ... Show all

Yealink SIP-T2 Series Administrator's Manual

Introduction

Table of Contents

Getting Started

Phone Network

Phone Provisioning

Firmware Upgrade

Phone Customization

Account Settings

Call Log

Directory

Quick Links

Troubleshooting

Related Manuals for Yealink SIP-T2 Series

Summary of Contents for Yealink SIP-T2 Series