Page 3
Note: This device is tested and complies with the limits for a Class B digital device, pursuant to Part 15 of the FCC Rules. These limits are designed to provide reasonable protection against harmful interference in a residential installation. This equipment generates, uses, and can radiate radio frequency energy and, if not installed and used in accordance with the instructions, may cause harmful interference to radio communications.
Page 5
For this reason, an understanding of IP networking and prior knowledge of IP telephony concepts are recommended. This guide covers the Yealink SIP-T28P , T26P , T22P and T20P IP phones. The following related documents for the SIP-T2xP IP phones are available: Quick Installation Guides, which describe how to assemble the IP phones.
Administrator’s Guide for SIP-T2xP IP Phones phones and the IP phone interface methods. Chapter 3, ‖Configuring Basic Features‖ describes how to configure the basic features on the IP phones. Chapter 4, ―Configuring Advanced Features‖ describes how to configure the ...
Page 7
About This Guide Major updates have occurred to the following sections: Creating Dial Plan on page Do Not Disturb (DND) on page Call Forward on page 802.1X Authentication on page ...
VoIP Principle ............................ 1 SIP Components..........................2 SIP IP Phone Models ........................3 Physical Features of the SIP-T2xP IP Phones ................4 Key Features of the SIP-T2xP IP Phones ................... 8 Getting Started ............... 11 Connecting the Phone ........................11 Installing the SIP-T28P and SIP-T26P IP Phones..............
Administrator’s Guide for SIP-T2xP IP Phones Administrator Password ........................ 26 Phone Lock ............................. 27 Time and Date ..........................28 Language ............................30 Loading Language Packs ...................... 31 Specifying the Language to Use................... 31 Missed Call Log ..........................32 Local Directory ..........................33 Call Waiting ............................
Product Overview This chapter contains the following information about the Yealink SIP-T2xP IP phones: VoIP Principle SIP Components SIP IP Phone Models VoIP VoIP (Voice over Internet Protocol) is a technology using the Internet Protocol instead of traditional Public Switch Telephone Network (PSTN) technology for voice communications.
Administrator’s Guide for SIP-T2xP IP Phones SIP provides the capabilities to: Determine the location of the target end point -- SIP supports address resolution, name mapping, and call redirection. Determine the media capabilities of the target end point -- Via Session Description ...
Page 15
SIP-T20P The Yealink SIP-T2xP IP phones comply with the SIP standard (RFC 3261), and they can only be used within a network that supports this type of phone. For the Yealink SIP-T2xP IP phones to successfully operate as SIP endpoints in your network, they must meet the following requirements: A working IP network is established.
Administrator’s Guide for SIP-T2xP IP Phones VoIP gateways are configured for SIP . The latest (or compatible) firmware of the SIP-T2xP IP phones is available. A call server is active and configured to receive and send SIP messages.
Page 17
Product Overview SIP-T26P Physical Features: TI TITAN chipset and TI voice engine 132x64 graphic LCD 3 VoIP accounts, Broadsoft/Avaya/Asterisk validated HD Voice: HD Codec, HD Handset, HD Speaker 45 keys including 13 programmable keys 1xRJ9 (4P4C) handset port 1xRJ9 (4P4C) headset port 2xRJ45 10/100M Ethernet ports 1XRJ12 (6P6C) expansion module port 16 LEDs: 1xpower, 3xline, 1xmessage, 1xheadset, 10xmemory...
Page 18
Administrator’s Guide for SIP-T2xP IP Phones SIP-T22P Physical Features: TI TITAN chipset and TI voice engine 132x64 graphic LCD 3 VoIP accounts, Broadsoft/Avaya/Asterisk validated HD Voice: HD Codec, HD Handset, HD Speaker 32 keys including 4 programmable keys 1xRJ9 (4P4C) handset port...
Page 19
Product Overview SIP-T20P Physical Features: TI TITAN chipset and TI voice engine 3-line LCD with an icon line and 2x15 characters lines 2 VoIP accounts, Broadsoft/Avaya/Asterisk validated HD Voice: HD Codec, HD Handset, HD Speaker 31 keys including 9 programmable keys 1xRJ9 (4P4C) handset port 1xRJ9 (4P4C) headset port 2xRJ45 10/100M Ethernet ports...
Page 20
Administrator’s Guide for SIP-T2xP IP Phones In addition to the physical features introduced above, the SIP-T2xP IP phones also support the following key features when running the latest firmware: Phone Features Call Options: emergency call, call waiting, dial plan, call hold, call mute, 3-way conference, speed dial.
Page 21
Product Overview Security HTTPS (server/client) SRTP (RFC3711) Transport Layer Security (TLS) VLAN (802.1q), QoS Digest authentication using MD5/MD5-sess Secure configuration file via AES encryption Phone lock for personal privacy protection Admin/User configuration mode...
Page 22
Administrator’s Guide for SIP-T2xP IP Phones...
Configuring Network Parameters Manually Creating Dial Plan This section introduces how to install SIP-T2xP IP phones with the components in the packing list. Attach the Stand Connect the Handset and optional Headset Connect the Network and Power Note A headset is not provided in the packing list.
Administrator’s Guide for SIP-T2xP IP Phones Connecting the Handset and optional Headset: Connecting the Network and Power: You have two options for power and network connections. Select a suitable way according to your actual situation. AC power Power over Ethernet (PoE) ...
Page 25
Getting Started To connect the PoE: Connect the Ethernet cable between the Internet port on the phone and an available port on the in-line power switch/hub. Attaching the Stand: Desk-mounted Method Wall-mounted Method ...
Page 26
Administrator’s Guide for SIP-T2xP IP Phones Connecting the Handset and optional Headset: Connecting the Network and Power: AC power Power over Ethernet (PoE) AC Power To connect the AC power and network: Connect the DC plug of the power adapter to the DC5V port on the phone and connect the other end of the power adapter into an electrical power outlet.
Page 27
Getting Started To connect the PoE: Connect the Ethernet cable between the Internet port on the phone and an available port on the in-line power switch/hub. If in-line power is provided, you don’t need to connect the AC adapter. Make sure the Note Ethernet cable and switch/hub are PoE compliant.
Page 28
Administrator’s Guide for SIP-T2xP IP Phones DHCP (Dynamic Host Configuration Protocol) The IP phone is capable of querying a DHCP server. DHCP is enabled on the IP phone by default. The following network settings can be obtained from the DHCP server during...
Getting Started After connecting the power and network, the IP phone begins the startup process by cycling through the following steps: The power indicator LED is illuminated. The message ―Initializing, Please wait‖ appears as phone starts up. The main LCD screen displays the following: Time and Date ...
MAC-Oriented CFG file is named with the MAC address of the IP phone. For example, a SIP-T22P IP phone whose MAC address is 001565113af8, the two configuration files must be: y000000000005.cfg and 001565113af8.cfg. The name of the Common CFG file for each SIP-T2xP IP phone model is: SIP-T28P: y000000000000.cfg ...
Page 31
Getting Started Use white space before or after a variable or value. Comment the variable on a separated line. Use the pound (#) delimiter to distinguish the comments. The IP phone can accept two sources of configuration data: Downloaded from the configuration files ...
Page 32
Administrator’s Guide for SIP-T2xP IP Phones T28P T26P T22P T20P Description Do Not Disturb Call Forward Call Hold Call Mute Ringer volume is 0 Phone Lock Received Calls Dialed Calls Missed Calls By default, DHCP is enabled on the IP phone. The IP phone can automatically derive the network settings from the DHCP server.
Configure the basic network parameters of the phone. Phone User Interface For more information, refer to the SIP-T2xP User Guide. To configure the network settings via web user interface: Click on Network. Mark the Static IP Address radio box. Enter the IP Address, subnet mask, default gateway, primary DNS and secondary DNS in the corresponding fields.
Administrator’s Guide for SIP-T2xP IP Phones "12x" would match "121", "122", "123", "12a", etc. Numeric ranges are allowed within the brackets: Digit ―-‖ Digit. Example: ―[5-7]‖ would match the number‖5‖, ‖6‖or ‖7‖. The square bracket "[]" can be used as a placeholder for a single character which matches any of a set of characters.
ConfigManApp.com?Id=12 For more information, refer to the SIP-T2xP User Guide. Area codes are also known as Numbering Plan Areas (NPAs). They usually indicate geographical areas in one country. You can configure only one area code for the IP phone. When dialing out numbers, the IP phone will automatically add the area code before the dialed numbers.
Administrator’s Guide for SIP-T2xP IP Phones Configure the area code and specify the maximum and minimum lengths of the dialed numbers. Navigate to: Local Web User Interface http://<phoneIPAddress>/cgi-bin/ ConfigManApp.com?Id=12 For more information, refer to the SIP-T2xP User Guide. You can block the IP phone to dial out some specific numbers by configuring block out numbers.
Configuring Basic Features The IP phone has specific features you can configure to customize your phone. This chapter provides information for making configuration changes for the following basic features: User Password Administrator Password Phone Lock Time and Date ...
Administrator’s Guide for SIP-T2xP IP Phones Several setting menus are protected with two privilege levels, user and administrator, each with its own password. When logging in the web user interface, the IP phone will prompt for the username and password before granting access to various menu options.
Configuring Basic Features 107. Change the administrator password. Local Web User Interface Navigate to: http://<phoneIPAddress>/cgi-bin/ ConfigManApp.com?Id=8 To change the administrator password via web user interface: Click on Security. Mark the admin radio box. Enter the current administrator password in the Current Password field. Enter a new password in the New Password and Confirm Password fields.
Administrator’s Guide for SIP-T2xP IP Phones Procedure Phone lock can be configured using the configuration files or locally. Configure the type of phone lock. Change the unlock password and configure the interval to automatically lock the phone. Configure the emergency Configuration File <y0000000000xx>.cfg...
Configuring Basic Features The following table lists the available methods for each feature: Feature Methods of Configuration Web User Interface Set Time Phone User Interface Configuration Files Set Time Format Web User Interface Phone User Interface Configuration Files Set Time Zone Web User Interface Web User Interface Set Date...
Administrator’s Guide for SIP-T2xP IP Phones Configure the DST, time and date manually. Navigate to: Web User Interface http://<phoneIPAddress>/cgi-bin/ ConfigManApp.com?Id=5 For more information, refer to the Local SIP-T2xP User Guide. Configure the time and date manually. Phone User Interface For more information, refer to the SIP-T2xP User Guide.
Page 43
Configuring Basic Features All supported languages may not be available for selection. The available selected languages are dependent on the language packs currently on the IP phone. You can make languages available to display on the phone user interface by loading language files to the IP phone.
Administrator’s Guide for SIP-T2xP IP Phones For more information, refer to the SIP-T2xP User Guide. Specify the language for the phone user interface. Phone User Interface For more information, refer to the SIP-T2xP User Guide. The IP phone can display the number of missed calls and log the missed calls in the Missed Calls list.
Navigate to: http://<phoneIPAddress>/cgi-bin/ Web User Interface ConfigManApp.com?Id=9 For more information, refer to the Local SIP-T2xP User Guide. Add the contact to the local directory directly. Phone User Interface For more information, refer to the SIP-T2xP User Guide.
Administrator’s Guide for SIP-T2xP IP Phones When you are in an active call, the call waiting feature notifies you of the new incoming call, and presents the incoming call visually on the phone LCD screen. If the call waiting feature is disabled, the new incoming call will be automatically rejected by the IP phone with a busy message.
Configuring Basic Features The auto redial feature allows the IP phone to redial the dialed out number automatically when the dialed number is busy. You can set the times of auto redial and the seconds to wait between redial attempts. The IP phone will retry as many times as configured till the dialed number is no longer busy.
Page 48
Administrator’s Guide for SIP-T2xP IP Phones Return Message When DND When the DND mode is activated on the IP phone, any user calls the accounts registered on the IP phone will be rejected automatically and receives a busy tone and a message.
Configuring Basic Features Select the desired type from the pull-down list of Return Code When DND. Click Confirm to save the change. To configure the DND key mode via web user interface: Click on Phone->Features->DND>>. Select the desired mode in the DND Key Mode field. Click Confirm to save the change.
Administrator’s Guide for SIP-T2xP IP Phones To configure the call hold method via web user interface: Click on Phone->Features->General Information >>. Select the desired value from the pull-down list of RFC 2543 Hold. Click Confirm to save the change. To configure the call hold tone and call hold tone delay features via web user interface: Click on Phone->Features->Audio Settings>>.
Navigate to: Web User Interface http://<phoneIPAddress>/cgi-bi n/ConfigManApp.com?Id=6 For more information, refer to Local SIP-T2xP User Guide. Configure the call forward feature. Phone User Interface For more information, refer to SIP-T2xP User Guide. The call transfer feature allows user to transfer an existing call to another party. The IP phone offers three types of transfer: Blind Transfer -- Transfer a call directly to another party without consulting.
Administrator’s Guide for SIP-T2xP IP Phones transfer feature. For more information, refer to Call Transfer on page 123. Configure the phone to complete the blind or attended transfer through on-hook. Configure the semi-attended Local Web User Interface transfer feature. Navigate to: http://<phoneIPAddress>/cgi-bin/...
Configuring Basic Features All parties release from the call when the conference initiator drops from the conference call. You can enable the Transfer on Conference Hang up feature on the initiator’s phone, the conference initiator will transfer the call when dropping from the conference call.
Administrator’s Guide for SIP-T2xP IP Phones Procedure Directed pickup can be configured using the configuration files or locally. Assign a directed pickup key. For more information, refer to Directed Pickup Key on page 172. Configure the directed pickup feature on a phone basis.
Page 55
For more information, refer to Group Pickup on page 130. Assign a group pickup key. Navigate to: http://<phoneIPAddress>/cgi-bi n/ConfigManApp.com?Id=21 For more information, refer to SIP-T2xP User Guide. Configure the group pickup feature on a phone basis. Web User Interface Navigate to: http://<phoneIPAddress>/cgi-bi Local n/ConfigManApp.com?Id=6 Configure the group pickup code on a per-account basis.
Administrator’s Guide for SIP-T2xP IP Phones The call park feature allows the user to park a call at a special extension and then retrieve it on any other phone in the system. A user can park a call at an extension, known as Call Park Orbit, by pressing the call park key.
Configuring Basic Features server. Procedure BLF call park feature can be configured using the configuration files or locally. Configure the BLF call park feature on the IP phone. <MAC>.cfg For more information, refer to BLF Call Park on page 129. Configuration File Assign a call park key.
Administrator’s Guide for SIP-T2xP IP Phones n/ConfigManApp.com?Id=21 For more information, refer to SIP-T2xP User Guide. Configure the hotline number and delay time. Phone User Interface For more information, refer to SIP-T2xP User Guide. User can access the web user interface of the IP phone using the HTTP and HTTPS protocols.
Configuring Basic Features Procedure Caller ID presentation can be configured using the configuration files or locally. Configure the presentation of the caller identity. Configuration File <MAC>.cfg For more information, refer to Caller ID Presentation on page 133. Configure the presentation of the caller identity.
Administrator’s Guide for SIP-T2xP IP Phones Callee ID Presentation on page 133. DTMF (Dual Tone Multi-frequency), better known as touch-tone, is used for telecommunication signaling over analog telephone lines in the voice-frequency band. DTMF is the signal sent from the IP phone to the network that you generate when pressing the phone’s keypad during the call.
Page 61
Configuring Basic Features SIP INFO DTMF digits are transmitted by the SIP INFO messages when the voice stream is established after a successful SIP 200 OK-ACK message sequence. The SIP INFO message is sent along the signaling path of the call. The SIP INFO message can support transmitting DTMF digits in three ways: DTMF , DTMF-Relay and Telephone-Event.
Administrator’s Guide for SIP-T2xP IP Phones Procedure Configuration changes can be performed using the configuration files or locally. Configure the hide DTMF and hide DTMF delay features. Configuration File <y0000000000xx>.cfg For more information, refer to Suppressing the Display of DTMF Digits on page 135.
Configuring Advanced Features This chapter provides information for making configuration changes for the following advanced features: Distinctive Ring Tones Tones Remote Phonebook LDAP Busy Lamp Field Shared Call Appearance As-Feature-Event Action URL Action URI ...
Administrator’s Guide for SIP-T2xP IP Phones then map the index ―N‖ to the relevant ring tone. When N is 1, the IP phone plays the ring tone ―Emergency.wav‖. If N is greater than 1 and less than 9, the IP phone plays the ring tone ―Ring(N-1).wav‖.
Page 65
Configuring Advanced Features Brazil China France Germany Great Britain Italy Mexico New Zealand United States Configured tones can be heard on the phone for the following conditions: Condition Description Dial In the pre-dialing interface Ring Back Ring-back tone Busy...
Administrator’s Guide for SIP-T2xP IP Phones Remote phonebook is the phone book which is maintained centrally, you need to configure the access URL of the remote phonebook on the IP phone to access it. The IP phone can establish a session with the remote phonebook and download the entries, the entries then display on the phone user interface.
Configuring Advanced Features Select the desired value from the pull-down list of SRemote Name. Enter the desired time in the SRemote Name Flash Time (seconds) field. Click Confirm to save the change. LDAP (Lightweight Directory Access Protocol) is an application protocol for accessing and maintaining information services of the distributed directory over an IP network.
Page 68
Administrator’s Guide for SIP-T2xP IP Phones Abbreviation Name Description surname Last name or family name distinguishedName Unique identifier for each entry Domain component company Company or organization name telephoneNumber Office phone number mobile mobilephoneNumber Mobile or cellular phone number ipPhone...
Page 69
BroadWorks web portal. The BLF List feature must be provisioned on the BroadWorks web portal in advance, refer to the document ―Yealink IP Phones Deployment Guide for BroadWorks Environments‖ for more information. The result of the provisioning will be a BLF List URI which represents a list of users to be monitored.
The SCA feature is specially designed to support the BroadSoft server. The SCA feature must be provisioned on the BroadWorks web portal in advance, refer to the document ―Yealink IP Phones Deployment Guide for BroadSoft BroadWorks Environments‖ for more information. The result of the provisioning will be a primary line with the SCA...
Configuring Advanced Features represented by its own unique SIP URI. Procedure Register the primary and secondary lines on two IP phones using the configuration files or locally. Configure the shared line on the IP phone. Configuration File <MAC>.cfg For more information, refer to Shared Call Appearance page 146.
Administrator’s Guide for SIP-T2xP IP Phones Procedure As-feature-event feature can be configured using the configuration files or locally. Configure the as-feature-event. Configuration File <y0000000000xx>.cfg For more information, refer to As-Feature-Event on page 149. Configure the as-feature-event. Navigate to: Local Web User Interface http://<phoneIPAddress>/cgi-bi...
Page 73
Configuring Advanced Features Event Description Open DND When the phone enables the DND mode. Close DND When the phone disables the DND mode. Open Always Forward When the phone enables the always forward. Close Always Forward When the phone disables the always forward. Open Busy Forward When the phone enables the busy forward.
Administrator’s Guide for SIP-T2xP IP Phones The following table lists the variable values may be used when specifying the URL: Variable Description $mac MAC address of the phone The current IP address of the phone $model Phone model $firmware Phone firmware version...
Configuring Advanced Features Configure the action URL on the IP phone. Local Web User Interface Navigate to: http://<phoneIPAddress>/cgi-bi n/ConfigManApp.com?Id=41 Opposite to Action URL, Action URI allows the IP phone to interact with web server application by receiving and handling HTTP GET requests. When receiving a URI, the IP phone will perform the specified action and response a 200 OK message.
Administrator’s Guide for SIP-T2xP IP Phones Variable Phone Action key=Reboot Reboot the phone. key=AutoP Let the phone do auto provisioning. key=DNDOn Activate the DND mode. key=DNDOff Deactivate the DND mode. Note key=MUTE The variable does not work with all events. For example, the variable ―...
Configuring Advanced Features Many SIP servers are deployed in redundant pairs, designated as primary and secondary servers. The IP phone must always contact the primary server except in failover conditions. Server redundancy is often required in VoIP deployments to ensure continuity of phone service, for events where the server needs to be taken offline for maintenance, the server fails, or the connection from the IP phone to the server fails.
Page 78
Administrator’s Guide for SIP-T2xP IP Phones Parameter Description regexp Always empty for SIP services. replacement Specifies a DNS name to be used for the next query. The IP phone picks the first record, because its order of 90 is lower than 100. The pref parameter is unimportant as there is no other record with order 90.
Configuring Advanced Features The following figure illustrates the IP phone is able to failover to an alternate server when there is no response to a REGISTER request. Procedure DNS SRV query can be configured using the configuration files or locally. Configure the DNS SRV query on the IP phone.
Page 80
Administrator’s Guide for SIP-T2xP IP Phones NAT Traversal In order to maintain connection with the remote party, the NAT traversal can be enabled on the IP phone. NAT traversal is a general term for techniques that establish and maintain IP connections traversing NAT gateways. The NAT traversal technique requires assistance from a STUN server.
IP address may send SNMP requests to the IP phone. The following table lists the basic object identifiers (OIDs) supported by the IP phone: Description The textual identification of the contact person for the IP phone, YEALINK-MIB 1.3.6.1.2.1.37459.2.1.1.0 together with the contact information. An administratively-assigned name for the IP phone.
Administrator’s Guide for SIP-T2xP IP Phones Procedure SNMP can be configured using the configuration files or locally. Configure the SNMP on the IP phone. Configuration File <y0000000000xx>.cfg For more information, refer to SNMP on page 153. Configure the SNMP .
Page 83
Configuring Advanced Features 802.1X on page 154. Configure the 802.1X on the IP phone. Local Web User Interface Navigate to: http://<phoneIPAddress>/cgi-bi n/ConfigManApp.com?Id=19 To configure the 802.1X via web user interface: Click on Network->Advanced. Select the desired protocol from the pull-down list of 802.1X Mode. a) If you select EAP-MD5: 1) Enter the username for authentication in the Identity field.
Page 84
CPE parameters. Reboot This method causes the CPE to reboot. This method is used to cause the CPE to download a specified file from the designated location. Download File type supported by the Yealink IP phones are:...
Page 85
Configuration File This method is used by an ACS to cause the CPE to upload a specified file to the designated location. File type supported by the Yealink IP phones are: Upload Configuration File Log File ...
Page 86
Administrator’s Guide for SIP-T2xP IP Phones Select the desired value from the pull-down list of Enable Periodic Inform. Enter the desired time in the Periodic Inform Interval (seconds) field. Enter the username and password authenticated by the IP phone in the Connection...
Security Features This chapter provides information for making configuration changes for the following security-related features: Transport Layer Security Encrypting Configuration Files The TLS protocol is a commonly-used protocol for providing communications privacy and managing the security of message transmission. The TLS allows the IP phone to communicate with other remote parties and connect to the HTTPS URL for provisioning in a way that is designed to prevent eavesdropping and tampering.
Page 88
Administrator’s Guide for SIP-T2xP IP Phones cannot be captured, a lock icon appears on the LCD screen when the IP phone is in the connecting state or in the calling state. TLS uses a program layer located between the internet's HTTP and TCP layers. TLS is designed to make use of TCP as a communication layer to provide a reliable end-to-end secure and authenticated connection between two points over a network.
Page 89
Security Features 160. Configure the IP phone to use TLS. Navigate to: http://<phoneIPAddress>/cgi-bi n/ConfigManApp.com?Id=4 Upload the certificates to the IP phone. Navigate to: Local Web User Interface http://<phoneIPAddress>/cgi-bi n/ConfigManApp.com?Id=8 Configure the IP phone to authenticate the connected server. Navigate to: http://<phoneIPAddress>/cgi-bi n/ConfigManApp.com?Id=32 To configure the TLS via web user interface:...
You can also encrypt the configuration files using the Yealink Configuration Conversion Tool. Refer to the Yealink Configuration Conversion Tool User Guide for more information. The filename extension of the encrypted configuration files must be .cfg. The common AES key is used to encrypt and decrypt the <y0000000000xx>.cfg file and the...
Page 91
Security Features For security purposes, it may be necessary for you to change the AES keys on the IP phone frequently. The process of updating the new AES keys includes decrypting the configuration files with the old AES keys and encrypting them with the new AES keys. After changing the AES keys, all encrypted configuration files on the configuration server are expected to be encrypted with the new AES keys.
Page 92
Administrator’s Guide for SIP-T2xP IP Phones...
7.x.x.x.rom SIP-T20P 9.x.x.x.rom Note You can download the latest firmware at: http://www.yealink.com/index.php/Support/. Upgrade via Web User Interface To manually upgrade firmware via web user interface, you need to store the firmware to your local system in advance. To upgrade the firmware manually via web user interface: Click on Upgrade.
Page 94
Administrator’s Guide for SIP-T2xP IP Phones Upgrade Firmware via Configuration Files The IP phone can download the firmware from the configuration server by stripping out the access URL of the firmware specified in the configuration files. To upgrade the firmware from the configuration server, the configuration server should be ready and able to accept connections.
Resource Files When configuring some features, you may need to upload resource files to the IP phone. The resources files can be local contact directory, remote phonebook and so on. If the resource file is to be used for a system of IP phones, the access URL of the resource file is best specified in the <y000000000000>.cfg file.
Administrator’s Guide for SIP-T2xP IP Phones Creating a replace rule template: Using an ASCII editor, create a new file. Type <DialRule> to indicate the start of the replace rule template. Add the following string to the template, each starting on a separate line: <Data Prefix=""...
Resource Files line ID. 0 stands for all lines, multiple line IDs are separated by comma. The file name must be dialnow.xml. Procedure Use the following procedures to create dial-now template. Creating a dial-now template: Using an ASCII editor, create a new file. Type <DialNow>...
Page 98
Administrator’s Guide for SIP-T2xP IP Phones <groupinfo> indicates the start of a group list and </groupinfo> indicates the end of a group list. Specify the values within double quotes. When specifying a ring tone for the contact or the group, the format of the value ...
Resource Files Type </groupinfo> to indicate the end of the group list. When completed, specify </contactData> to indicate the end of the contact file. 10. Save this file to the root directory of the configuration server. The following is an example of a local contact file: <contactData>...
Page 100
Administrator’s Guide for SIP-T2xP IP Phones For each contact that you wish to add, add the following strings to the phonebook, each starting on a separate line: <Name>Mary</Name> <Telephone>1001</Telephone> Where: Specify the contact name between <Name> and </Name>. Specify the contact number between <Telephone> and </Telephone>.
Page 101
Resource Files dial-now rule template. For more information, refer to Access URL of Dial-now Template on page 164. Configure the access URL of the local contact file. Configuration File <y0000000000xx>.cfg For more information, refer to Access URL of Local Contact File on page 164.
Page 102
Administrator’s Guide for SIP-T2xP IP Phones...
If you encounter a problem which is not listed in this chapter, contact your Yealink reseller for further support.
Page 104
Administrator’s Guide for SIP-T2xP IP Phones To configure the level of the log files via web user interface: Click on Upgrade->Advanced. Select the desired level from the pull-down list of Log Level. Click Confirm to accept the change. The web user interface prompts ―It will take effect after reboot, reboot now?‖.
Troubleshooting using the Ethernet software. You can analyze the packets captured for troubleshooting purposes. To capture packets via web user interface: Click on Upgrade->Advanced. Click Start to begin capturing signal traffic. Reproduce the issue to get stack traces. Click Stop to end capturing. Click Export to open file download window, and then save the file to your local system.
Page 106
Administrator’s Guide for SIP-T2xP IP Phones Sometimes, configuration errors may lead to your phone’s failure. You can export configuration files to view the current configuration of the IP phone and troubleshoot as necessary. To export configuration files via web user interface: Click on Upgrade->Advanced.
Page 107
Troubleshooting The phone LCD screen prompts ―No Service‖ message when there is no any available SIP account on the IP phone. Do one of the following: Confirm if any account is actively registered on the IP phone at the path ...
Page 108
Administrator’s Guide for SIP-T2xP IP Phones voice from the other party clearly. Turn off any other noisy equipment in the room such as fans. A line issue may also cause this problem. Disconnect the old line and redial the call ...
Page 109
Troubleshooting customized settings will be overwritten after resetting. To reset your phone via web user interface: Click on Upgrade. Click Reset in the Reset to Factory Settings field. The web user interface prompts the message ―Do you want to reset to factory?‖. Click OK to confirm the resetting.
Page 110
Administrator’s Guide for SIP-T2xP IP Phones...
Appendix 802.1x--an IEEE Standard for port-based Network Access Control (PNAC). It is part of the IEEE 802.1 group of networking protocols. It provides an authentication mechanism to devices wishing to attach to a LAN or WLAN. ACD (Automatic Call Distribution)--used to distribute calls from large volumes of incoming calls to the registered IP phone users.
Page 112
Administrator’s Guide for SIP-T2xP IP Phones IEEE (Institute of Electrical and Electronics Engineers)--a non-profit professional association headquartered in New York City that is dedicated to advancing technological innovation and excellence. LAN (Local Area Network)--used to interconnects network devices in a limited area such as a home, school, computer laboratory, or office building.
Page 113
Appendix This appendix describes the parameters you can set in the configuration files for the IP phone. The configuration files are <y0000000000xx>.cfg and <MAC> .cfg. You can set specific parameters in the configuration files for configuring you IP phone. The <y0000000000xx>.cfg and <MAC>.cfg files are stored on the configuration server. The IP phone checks for configuration files and looks for resource files when restarting the IP phone.
Page 114
Administrator’s Guide for SIP-T2xP IP Phones WAN settings. Note: If you change this parameter, the phone will reboot to make the change take effect. Format Dotted Decimal Default Value Blank Range Not Applicable Example network.internet_port.ip = 192.168.1.20 Parameter- Configuration File network.internet_port.mask...
Page 115
Appendix Format Dotted Decimal Default Value 202.101.103.55 Range Not Applicable Example network.primary_dns = 202.101.103.5 Parameter- Configuration File network.secondary_dns <y0000000000xx>.cfg Configures the secondary DNS server. Description Note: If you change this parameter, the phone will reboot to make the change take effect. Format Dotted Decimal Default Value...
Page 116
Administrator’s Guide for SIP-T2xP IP Phones 1-Enabled Prefix, Replaced: Not Applicable Line ID valid values are: 1 to 6 (for T28P) 1 to 3 (for T26P/T20P) 1 to 2 (for T20P) Note: Multiple line IDs are separated by comma. Example dialplan.item.1 = 1,123,0592,1,2,3...
Page 117
Appendix Integer Format Default Value Blank Range Not Applicable Example dialplan.area_code.code = 010 Parameter- Configuration File dialplan.area_code.min_len <y0000000000xx>.cfg Sets the minimum length of the entered Description numbers to add the area code. Integer Format Default Value Range 1 to 15 Example dialplan.area_code.min_len = 2 Parameter-...
Page 118
Administrator’s Guide for SIP-T2xP IP Phones 1 to 2 (for T20P) Note: Multiple line IDs are separated by comma. Example dialplan.area_code.line_id = 1,2 Parameter- Configuration File dialplan.block_out.number.x <y0000000000xx>.cfg Specifies the block out numbers. Description X ranges from 1 to 10.
Page 119
Appendix Parameter- Configuration File security.user_password <y0000000000xx>.cfg Sets a new user password for the IP phone. Note: The IP phone supports numeric and Description alphabetic characters (- *.+ are included) only in passwords. Format The value format is: username:password. Default Value user Numeric and alphabetic characters (- *.+ are Range...
Page 120
Administrator’s Guide for SIP-T2xP IP Phones 1-Menu Key 2-Function Keys 3-All Keys 4-Lock&Answer Example phone_setting.lock = 2 Parameter- Configuration File phone_setting.phone_lock.unlock_pin <y0000000000xx>.cfg Description Changes the phone unlock password. Format Numeric characters only Default Value Range 0 to 15 characters phone_setting.phone_lock.unlock_pin =...
Page 121
Configuration File local_time.time_zone_name <y0000000000xx>.cfg Description Defines the desired time zone name. Format Text Default Value China(Beijing) Refer to the SIP-T2xP User Guide for the Time Range Zone List. Example local_time.time_zone_name = Korea Parameter- Configuration File local_time.ntp_server1 <y0000000000xx>.cfg Sets the IP address or the domain name of the Description primary NTP server.
Page 122
Administrator’s Guide for SIP-T2xP IP Phones Default Value cn.pool.ntp.org Range Not Applicable Example local_time.ntp_server2 = 192.168.0.5 Parameter- Configuration File local_time.interval <y0000000000xx>.cfg Sets the interval (in seconds) for the IP phone Description to update time from the time server. Format Integer...
Page 123
Appendix 1-By Week Example local_time.dst_time_type = 1 Parameter- Configuration File local_time.start_time <y0000000000xx>.cfg Specifies the month, day and hour of day that Description DST starts. String The value formats are: Format MM/DD/HH (for By Date) Month/ Day of Week/ Day of Week Last in ...
Page 124
Administrator’s Guide for SIP-T2xP IP Phones Parameter- Configuration File local_time.offset_time <y0000000000xx>.cfg Description Sets the offset time (in minutes) of DST. Format Integer Default Value Range -300 to +300 Example local_time.offset_time = 120 Parameter- Configuration File local_time.time_format <y0000000000xx>.cfg Description Sets the time format.
Page 125
Appendix Parameter- Configuration File local_time.dhcp_time <y0000000000xx>.cfg Specifies the IP phone whether to update time with the offset time obtained from the DHCP server. Description Note: This feature is only available to the time zone 0. Format Boolean Default Value 0-Disabled Range 1-Enabled Example...
Page 126
Administrator’s Guide for SIP-T2xP IP Phones Parameter- Configuration File lang.wui <y0000000000xx>.cfg Specifies the language displaying on the web Description user interface. Format Text Default Value Not Applicable Valid values are: English Chinese_S Deutsch Range French Italian Portuguese Spanish Turkish Example lang.wui = French...
Page 127
Appendix Parameter- Configuration File account.x.missed_calllog <MAC>.cfg Enables or disables the missed call log feature. Description X ranges from 1 to 6. Format Boolean Default Value 0-Disabled Range 1-Enabled Example account.1.missed_calllog = 1 Parameter- Configuration File call_waiting.enable <y0000000000xx>.cfg Description Enables or disables the call waiting feature. Format Boolean Default Value...
Page 128
Administrator’s Guide for SIP-T2xP IP Phones Parameter- Configuration File auto_redial.enable <y0000000000xx>.cfg Enables or disables the IP phone to Description automatically redial the called number when it is busy. Format Boolean Default Value 0-Disabled Range 1-Enabled Example auto_redial.enable = 1 Parameter- Configuration File auto_redial.interval...
Page 129
Appendix Return Message When DND Parameter- Configuration File features.dnd_refuse_code <y0000000000xx>.cfg Defines the type of the return message when Description DND. Format Integer Default Value Valid values are: 404-No Found Range 480-Temporarily not available 486-Busy here Example features.dnd_refuse_code = 486 DND Key Mode Parameter- Configuration File features.dnd_mode...
Page 130
Administrator’s Guide for SIP-T2xP IP Phones Parameter- Configuration File features.play_hold_tone.delay <y0000000000xx>.cfg Sets the interval (in seconds) for the IP phone Description to play call hold tone. Format Integer Default Value Range Not Applicable Example features.play_hold_tone.delay = 60 Parameter- Configuration File sip.rfc2543_hold...
Page 131
Appendix Call Forward in Phone Mode Always Forward Parameter- Configuration File forward.always.enable < y0000000000xx >.cfg Enables or disables the always forward Description feature. Format Boolean Default Value 0-Disabled Range 1-Enabled Example forward.always.enable = 1 Parameter- Configuration File forward.always.target < y0000000000xx >.cfg Defines the destination number of the always Description forward.
Page 132
Administrator’s Guide for SIP-T2xP IP Phones Parameter- Configuration File forward.always.off_code < y0000000000xx >.cfg Sets the off code to inform the server to Description disable the always forward feature (optional). Format String Default Value Blank Range Not Applicable Example forward.always.off_code = *73...
Page 133
Appendix Default Value Blank Range Not Applicable Example forward.busy.on_code = *74 Parameter- Configuration File forward.busy.off_code < y0000000000xx >.cfg Sets the off code to inform the server to Description disable the busy forward feature (optional). Format String Default Value Blank Range Not Applicable Example forward.busy.off_code = *75...
Page 134
Administrator’s Guide for SIP-T2xP IP Phones Parameter- Configuration File forward.no_answer.timeout < y0000000000xx >.cfg Defines a period of ring time to wait before forwarding the ring call. Description The interval of the ring time is n*6 (0≤n≤20), the valid values ranges from 0 to 20.
Page 135
Appendix Call Forward in Custom Mode Always Forward Parameter- Configuration File account.x.always_fwd.enable <MAC>.cfg Enables or disables the always forward feature. Description X ranges from 1 to 6. Format Boolean Default Value 0-Disabled Range 1-Enabled Example account.1.always_fwd.enable = 1 Parameter- Configuration File account.x.always_fwd.target <MAC>.cfg Defines the destination number of the always...
Page 136
Administrator’s Guide for SIP-T2xP IP Phones Parameter- Configuration File account.x.busy_fwd.off_code <MAC>.cfg Sets the off code to inform the server to disable the always forward feature (optional). Description X ranges from 1 to 6. Format String Default Value Blank Range Not Applicable Example account.1.busy_fwd.off_code = *73...
Page 137
Appendix the busy forward feature (optional). X ranges from 1 to 6 Format String Default Value Blank Range Not Applicable Example account.1.busy_fwd.on_code = *74 Parameter- Configuration File account.x.busy_fwd.off_code <MAC>.cfg Sets the off code to inform the server to disable the busy forward feature (optional). Description X ranges from 1 to 6 Format...
Page 138
Administrator’s Guide for SIP-T2xP IP Phones Format String Default Value Blank Range Not Applicable Example account.1.timeout_fwd.target = 3603 Parameter- Configuration File account.x.timeout_fwd.timeout <MAC>.cfg Defines a period of ring time to wait before forwarding the ring call. The interval of the ring time is n*6 (0≤n≤20), Description the valid values ranges from 0 to 20.
Page 139
Appendix Default Value Blank Range Not Applicable Example account.1.timeout_fwd.off_code = *77 Parameter- Configuration File transfer.blind_tran_on_hook_enable <y0000000000xx>.cfg Enables or disables the IP phone to Description complete the blind transfer through on-hook. Format Boolean Default Value 0-Disabled Range 1-Enabled Example transfer.blind_tran_on_hook_enable = 1 Parameter- Configuration File transfer.on_hook_trans_enable...
Page 140
Administrator’s Guide for SIP-T2xP IP Phones Example transfer.semi_attend_tran_enable = 1 Parameter- Configuration File account.x.conf_type <MAC>.cfg Defines the conference type. Description X ranges from 1 to 6. Format Integer Default Value Valid values are: Range 0-Local 2-Network Conference Example account.1.conf_type = 2...
Page 141
Appendix Default Value 0-Disabled Range 1-Enabled transfer.tran_others_after_conf_enable Example Phone Basis Parameter- Configuration File features.pickup.direct_pickup_enable <y0000000000xx>.cfg Configures the IP phone to display the Description DPickup soft key in the dialing interface. Format Boolean Default Value 0-Disabled Range 1-Enabled features.pickup.direct_pickup_enable = Example Parameter- Configuration File features.pickup.direct_pickup_code...
Page 142
Administrator’s Guide for SIP-T2xP IP Phones Format String Default Value Blank Range Not Applicable Example account.1.direct_pickup_code = *68 Phone Basis Parameter- Configuration File features.pickup.group_pickup_enable <y0000000000xx>.cfg Configures the IP phone to display the Description GPickup soft key in the dialing interface.
Page 143
Appendix Default Value Blank Range Not Applicable Example account.1.group_pickup_code = *69 Parameter- Configuration File account.x.dialoginfo_callpickup <MAC>.cfg Configures the BLF call park on the IP phone. Description X ranges from 1 to 6. Format Boolean Default Value 0-Disabled Range 1-Enabled Example account.1.dialoginfo_callpickup = 1 Parameter- Configuration File...
Page 144
Administrator’s Guide for SIP-T2xP IP Phones Example features.hotline_delay = 6 Parameter- Configuration File network.web_server_type <y0000000000xx>.cfg Specifies the access type of the web server. Description Note: If you change this parameter, the phone will reboot to make the change take effect.
Page 145
Appendix Default Value Range 1 to 65535 Example network.port.https = 100 Parameter- Configuration File account.x.cid_source <MAC>.cfg Specifies the precedence of presenting the SIP header. X ranges from 1 to 6. 0-FROM (Derives the name and number of the caller from the ―From‖ header). 1-PAI (Derives the name and number of the caller from the ―PAI‖...
Page 146
Administrator’s Guide for SIP-T2xP IP Phones preferentially. If the server does not send the ―RPID‖ header, derives from the ―From‖ header). 1-Dialed Digits (Preferentially displays the dialed digits on the caller’s phone). 2-RFC 4916 (Derives the name and number of the callee from ―From‖...
Page 147
Appendix Range 96 to 255 Example account.1.dtmf.dtmf_payload = 101 Parameter- Configuration File account.x.dtmf.info_type <MAC>.cfg Configures the DTMF info type when using SIP INFO. Description X ranges from 1 to 6. Format Integer Default Value Valid values are: 0-Disabled Range 1-DTMF-Relay 2-DTMF 3-Telephone-Event Example...
Page 148
Administrator’s Guide for SIP-T2xP IP Phones Default Value 0-Disabled Range 1-Enabled Example features.dtmf.hide_delay = 1 Parameter- Configuration File distinctive_ring_tones.alert_info.x.text <y0000000000xx>.cfg Specifies the texts to map the keywords contained in the SIP header. Description X ranges from 1 to 10. Format...
Page 149
Appendix distinctive_ring_tones.alert_info.1.ringer Example Parameter- Configuration File voice.tone.country <y0000000000xx>.cfg Description Configures the tone type for the phone. Format Text Default Value Custom Valid values are: Custom Australia Austria Brazil Belgium China Czech Denmark Finland ...
Page 150
Administrator’s Guide for SIP-T2xP IP Phones Example voice.tone.country = Austria Parameter- Configuration File voice.tone.dial <y0000000000xx>.cfg voice.tone.ring voice.tone.busy voice.tone.congestion voice.tone.callwaiting voice.tone.dialrecall voice.tone.record voice.tone.info voice.tone.stutter voice.tone.message voice.tone.autoanswer Customizes the tone for each condition. Description This parameter is only applicable when the tone type is configured to Custom.
Page 151
Appendix the contact names from the remote phonebook when receiving incoming calls. Format Boolean Default Value 0-Disabled Range 1-Enabled Example features.remote_phonebook.enable = 1 Parameter- Configuration File features.remote_phonebook.flash_time <y0000000000xx>.cfg Sets the interval (in seconds) for the IP Description phone to update the information of the remote phonebook.
Page 152
Administrator’s Guide for SIP-T2xP IP Phones Parameter- Configuration File ldap.number_filter <y0000000000xx>.cfg Description Sets the search criteria for number lookups. Format String Default Value Blank Range Not Applicable ldap.number_filter = (|(telephoneNumber=%)(mobile=%)) (Here, the result of your search will be all LDAP...
Page 153
Appendix search is requested to begin. Format String Default Value Blank Range Not Applicable Example ldap.base = dc=yealink,dc=cn Parameter- Configuration File ldap.user <y0000000000xx>.cfg Description Sets the login username of the LDAP server. Format String Default Value Blank Range Not Applicable Example ldap.user = cn=manager,dc=yealink,dc=cn...
Page 154
Administrator’s Guide for SIP-T2xP IP Phones Parameter- Configuration File ldap.name_attr <y0000000000xx>.cfg Specifies the ―name‖ attributes of each record Description which are to be returned in the LDAP search results. Format String Default Value Blank Range Not Applicable Example ldap.name_attr = cn sn...
Page 155
Appendix Format Integer Default Value Range 2 or 3 Example ldap.version = 3 Parameter- Configuration File ldap.search_delay <y0000000000xx>.cfg Sets a delay time (in milliseconds) for the IP Description phone to display the search results. Format Integer Default Value Range 0 to 2000 Example ldap.search_delay = 20 Parameter-...
Page 156
Administrator’s Guide for SIP-T2xP IP Phones Parameter- Configuration File ldap.dial_lookup <y0000000000xx>.cfg Configures the IP phone to query the LDAP Description server when in the pre-dialing or the dialing state. Format Boolean Default Value 0-Disabled Range 1-Enabled Example ldap.dial_lookup = 1...
Page 157
Appendix Parameter- Configuration File account.x.blf_list_barge_in_code <MAC>.cfg Specifies the feature access code to barge in an active call of the monitored user. Description X ranges from 1 to 6. Format String Default Value Blank Range Not Applicable Example account.1.blf_list_barge_in_code = *33 Parameter- Configuration File features.pickup.blf_visual_enable...
Page 158
Administrator’s Guide for SIP-T2xP IP Phones Use the following parameters to register the shared line on the IP phone. Parameter- Configuration File account.x.enable <MAC>.cfg Enables or disables the account. Description X ranges from 1 to 6. Format Boolean Default Value...
Page 159
Appendix Parameter- Configuration File account.x.auth_name <MAC>.cfg Configures the register name of the account. X ranges from 1 to 6. Description Note: If configuring the secondary line on the phone, enter the register name of the primary line for this parameter. Format String Default Value...
Page 160
Administrator’s Guide for SIP-T2xP IP Phones X ranges from 1 to 6. Format IP Address or Domain Name Default Value Blank Range Not Applicable account.1.sip_server_host = server@domain Example name.net Parameter- Configuration File account.x.sip_server_port <MAC>.cfg Configures the SIP server port. Description X ranges from 1 to 6.
Page 161
Appendix Default Value Blank Range Not Applicable Example account.1.outbound_host = 199.19.195.10 Parameter- Configuration File account.x.outbound_port <MAC>.cfg Configures the outbound proxy server port. Description X ranges from 1 to 6. Format Integer Default Value 5060 Range Not Applicable Example account.1.outbound_port = 5060 Parameter- Configuration File account.x.shared_line...
Page 163
Appendix action_url.reject_incoming_call action_url.answer_new_incoming_call action_url.transfer_finished action_url.transfer_failed Specifies the URL for the predefined event. The value format is: http://IP address of server/help.xml? variable name=variable value Valid values are: $mac $model Description $firmware $active_url $active_user $active_host $local ...
Page 164
Administrator’s Guide for SIP-T2xP IP Phones Example features.action_uri_limit_ip = any Parameter- Configuration File account.x.transport <MAC>.cfg Enables or disables the server redundancy feature on the IP phone. Description X ranges from 1 to 6. Format Integer Default Value 0 (UDP) Valid values are:...
Page 165
Appendix X ranges from 1 to 6. Format IP Address or Domain Name Default Value Blank Range Not Applicable Example account.1.nat.stun_server = 192.168.1.20 Parameter- Configuration File account.x.nat.stun_port <MAC>.cfg Specifies the port of the STUN server. Description X ranges from 1 to 6. Format Integer Default Value...
Page 166
Administrator’s Guide for SIP-T2xP IP Phones will reboot to make the change take effect. Format Integer Default Value Blank Range 0 to 65535 Example network.snmp.port = 1008 Parameter- Configuration File network.snmp.trust_ip <y0000000000xx>.cfg Specifies the addresses (at most three addresses, each separated by space) from which SNMP requests will be accepted.
Page 167
Appendix Parameter- Configuration File network.802_1x.identity <y0000000000xx>.cfg Enters the identity used for the MD5 authentication of the 802.1X. Description Note: If you change this parameter, the phone will reboot to make the change take effect. Format String Default Value Blank Range Not Applicable Example network.802_1x.identity = admin...
Page 168
Administrator’s Guide for SIP-T2xP IP Phones Range Not Applicable network.802_1x.root_cert_url = Example http://192.168.1.10/ca.pem Parameter- Configuration File network.802_1x.client_cert_url <y0000000000xx>.cfg Specify the access URL of the client certificate used for authentication. Description It is only applicable to the EAP-TLS protocol. Note: If you change this parameter, the phone will reboot to make the change take effect.
Page 169
Appendix ACS. This string is set to the empty string if no authentication is required. Note: If you change this parameter, the phone will reboot to make the change take effect. Format String Default Value Blank Not Applicable Range Example managementserver.username = user Parameter- Configuration File...
Page 170
Administrator’s Guide for SIP-T2xP IP Phones Sets the username for the phone to authenticate the incoming connection requests. Description Note: If you change this parameter, the phone will reboot to make the change take effect. Format String Default Value Blank...
Page 171
Appendix managementserver.periodic_inform_enable = Example Parameter- Configuration File managementserver.periodic_in <y0000000000xx>.cfg form_interval Sets the interval (in seconds) to report its configuration information to the ACS. Description Note: If you change this parameter, the phone will reboot to make the change take effect. Format Integer Default Value...
Page 172
Administrator’s Guide for SIP-T2xP IP Phones security.trust_certificates <y0000000000xx>.cfg Enables or disables the IP phone to Description authenticate the connected server. Format Boolean Default Value 0-Disabled Range 1-Enabled Example security.trust_certificates = 1 Parameter- Configuration File trusted_certificates.url <y0000000000xx>.cfg Specifies the access URL of the trusted Description certificate.
Page 173
Appendix Changes the AES key which is used to encrypt Description or decrypt the <y0000000000xx >.cfg file. String Format () ><| "& cannot be included. Default Value Blank Range 16 characters auto_provision.aes_key_16.com = Example 0123456789abcdef Parameter- Configuration File auto_provision.aes_key_16.mac <y0000000000xx>.cfg Changes the AES key which is used to encrypt Description or decrypt the <MAC >.cfg file.
Page 174
Administrator’s Guide for SIP-T2xP IP Phones Example auto_provision.mode = 1 Parameter- Configuration File auto_provision.schedule.periodic_minute < y0000000000xx >.cfg Sets the interval (in minutes) for the phone to check new configuration files. Description This parameter is only applicable to the ―Repeatedly‖ and ―Power on + Repeatedly‖...
Page 175
Appendix Default Value 00:00 Range 00:00 to 23:59 Example auto_provision.schedule.time_to = 21:30 Parameter- Configuration File auto_provision.schedule.dayofweek < y0000000000xx >.cfg Defines the desired day(s) of a week for Description the phone to check new configuration. Format Integer Default Value 0123456 Valid values are: 0-Sunday 1-Monday 2-Tuesday...
Page 176
Administrator’s Guide for SIP-T2xP IP Phones Specifies the access URL of the replace rule Description template. Format String Default Value Blank Range Not Applicable dialplan_replace_rule.url = Example http://192.168.10.25/dialplan.xml Parameter- Configuration File dialplan_dialnow.url <y0000000000xx>.cfg Specifies the access URL of the dial-now Description template.
Page 177
Appendix Parameter- Configuration File remote_phonebook.data.x.url <y0000000000xx>.cfg Specifies the access URL of the remote XML phonebook. Description X ranges from 1 to 5. Format String Default Value Blank Range Not Applicable remote_phonebook.data.1.url = Example http://192.168.1.20/phonebook.xml Parameter- Configuration File syslog.server <y0000000000xx>.cfg Specifies the IP address of the syslog server where to export the log files.
Page 178
Administrator’s Guide for SIP-T2xP IP Phones Parameter- Configuration File syslog.log_level <y0000000000xx>.cfg Specifies the severity level of the logs to be reported to a log file. Description Note: If you change this parameter, the phone will reboot to make the change take effect.
Page 179
Appendix phones only support to be assigned features to the line keys. The configurations of the line key are basically the same as the memory key. The parameters of the DSS key are detailed in the following (take the memory key as an example): Parameter- Configuration File memorykey.x.line...
Page 180
Administrator’s Guide for SIP-T2xP IP Phones URL (not applicable to T20P) Keypad Lock Format Integer Default Value 0 (Auto) Valid values are: 0 to 6 (for T28P) Range 0 to 3 (for T26P/T22P) 0 to 2 (for T20P) Example memorykey.1.line = 2...
Page 181
Appendix Parameter- Configuration File memorykey.x.type <y0000000000xx>.cfg Specifies the key feature for the memory key. X ranges from 1 to 10. Valid types are: N/A (default for memory key) Conference Forward Transfer Hold Redial Call Return ...
Page 182
Administrator’s Guide for SIP-T2xP IP Phones Format Integer Default Value 0 (N/A) Valid values are: 0-N/A(default for memory key) 1-Conference 2-Forward 3-Transfer 4-Hold 5-DND 6-Redial 7-Call Return 8-SMS 9-Call Pickup 10-Call Park 11-DTMF 12-Voicemail 13-SpeedDial 14-Intercom 15-Line(default for line key)
Page 183
Appendix 46-Broadsoft Group 48- Custom Button 50-Keypad Lock Example memorykey.1.type = 8 Parameter- Configuration File memorykey.x.xml_phonebook <y0000000000xx>.cfg Specifies the desired phonebook when multiple phonebooks are configured on the phone. Description This parameter only applies to the Local Group/XML Group/Broadsoft Group features. X ranges from 1 to 10.
Page 184
Administrator’s Guide for SIP-T2xP IP Phones memorykey.x.type <y0000000000xx>.cfg Configures a memory key to be DND key on the phone. Description The digit 5 stands for the key type DND. X ranges from 1 to 10. Format Integer Value Example memorykey.1.type = 5...
Page 185
Appendix Specifies the directed pickup feature code followed by the number of monitored Description extension. X ranges from 1 to 10. Format String Range Not Applicable Example memorykey.1.value = *971001 Group Pickup Key Parameter- Configuration File linekey.x.type <y0000000000xx>.cfg Configures a line key to be group pickup key on the phone.
Page 186
Administrator’s Guide for SIP-T2xP IP Phones Specifies the group pickup feature code. Description X ranges from 1 to 10. Format String Range Not Applicable Example linekey.1.value = *98 Call Park Key Parameter- Configuration File memorykey.x.type <y0000000000xx>.cfg Configures a memory key to be call park key on the phone.
Page 187
Appendix Parameter- Configuration File memorykey.x.value <y0000000000xx>.cfg Specifies the call park feature code. Description X ranges from 1 to 10. Format String Range Not Applicable Example memorykey.2.value = *99 BLF Call Park Key Parameter- Configuration File memorykey.x.type <y0000000000xx>.cfg Configures a memory key to be call park key on the phone.
Page 188
Administrator’s Guide for SIP-T2xP IP Phones Parameter- Configuration File memorykey.x.value <y0000000000xx>.cfg Specifies the number of the monitored user. Description X ranges from 1 to 10. Format String Range Not Applicable Example memorykey.2.value = 1008 LDAP Key Parameter- Configuration File memorykey.x.type <y0000000000xx>.cfg...
Page 189
Not Applicable Example memorykey.3.pickup_value = *88 This section describes how the Yealink SIP-T2xP IP phones comply with the IETF definition of SIP as described in RFC 3261. This section contains compliance information in the following: RFC and Internet Draft Support ...
Page 190
Administrator’s Guide for SIP-T2xP IP Phones SIP Responses SIP Session Description Protocol (SDP) Usage The following RFC’s and Internet drafts are supported: RFC 1321—The MD5 Message-Digest Algorithm RFC 2327—SDP: Session Description Protocol RFC 2387—The MIME Multipart / Related Content-type ...
RFC number. The following SIP request messages are supported: Method Supported Notes REGISTER The Yealink SIP-T2xP IP phones support mid-call changes such as putting a INVITE call on hold as signaled by a new INVITE that contains an existing Call-ID.
Page 192
Administrator’s Guide for SIP-T2xP IP Phones Method Supported Notes INFO MESSAGE UPDATE PUBLISH The following SIP request headers are supported: Method Supported Notes Accept Alert-Info Allow Allow-Events Authorization Call-ID Call-Info Contact Content-Length Content-Type CSeq Diversion Event Expires From Max-Forwards Min-SE...
Appendix Method Supported Notes RAck Record-Route Refer-To Referred-By Remote-Party-ID Replaces Require Route RSeq Session-Expires Subscription-State Supported User-Agent The following SIP responses are supported: 1xx Response—Information Responses 1xx Response Supported Notes 100 Trying 180 Ringing 181 Call Is Being Forwarded 183 Session Progress 2xx Response—Successful Responses 2xx Response Supported...
Page 194
Administrator’s Guide for SIP-T2xP IP Phones 202 Accepted In REFER transfer. 3xx Response—Redirection Responses 3xx Response Supported Notes 300 Multiple Choices 301 Moved Permanently 302 Moved Temporarily 4xx Response—Request Failure Responses 4xx Response Supported Notes 400 Bad Request 401 Unauthorized...
Page 195
Appendix 4xx Response Supported Notes 481 Call/Transaction Does Not Exist 482 Loop Detected 483 Too Many Hops 484 Address Incomplete 485 Ambiguous 486 Busy Here 487 Request Terminated 488 Not Acceptable Here 491 Request Pending 493 Undecipherable 5xx Response—Server Failure Responses 5xx Response Supported Notes...
Page 196
Administrator’s Guide for SIP-T2xP IP Phones SDP Headers Supported v—Protocol version o—Owner/creator and session identifier a—Media attribute c—Connection information m—Media name and transport address s—Session name t—Active time SIP uses six request methods: INVITE—Indicates a user is being invited to participate in a call session.
Page 197
Appendix The following figure illustrates the scenario of a successful call. In this scenario, the two end users are User A and User B. User A and User B are located at the Yealink SIP IP phones. The call flow scenario is as follows: User A calls User B.
Page 198
Administrator’s Guide for SIP-T2xP IP Phones Step Action Description User A sends a SIP INVITE message to a proxy server. The INVITE request is an invitation to User B to participate in a call session. In the INVITE request: The IP address of User B is inserted ...
Page 199
Appendix Step Action Description User B sends a SIP 200 OK response to 200 OK— User B to Proxy the proxy server. The 200 OK response Server notifies User A that the connection has been made. The proxy server forwards the 200 OK 200OK—Proxy Server to User message to User A.
Page 200
The following figure illustrates the scenario of an unsuccessful call due to the reason of the called user being busy. In this scenario, the two end users are User A and User B. User A and User B are located at the Yealink SIP IP phones. The call flow scenario is as follows: User A calls User B.
Page 201
Appendix Step Action Description User A sends the INVITE message to a proxy server. The INVITE request is an invitation to User B to participate in a call session. In the INVITE request: The IP address of User B is inserted ...
Page 202
Administrator’s Guide for SIP-T2xP IP Phones Step Action Description The proxy server forwards the 486 Busy 486 Busy Here—Proxy Server Here response to notify User A that User to User A B is busy. User A sends a SIP ACK to the proxy server.
Page 203
In this scenario, the two end users are User A and User B. User A and User B are located at the Yealink SIP IP phones. The call flow scenario is as follows: User A calls User B.
Page 204
Administrator’s Guide for SIP-T2xP IP Phones Step Action Description User A sends the INVITE message to a proxy server. The INVITE request is an invitation to User B to participate in a call session. In the INVITE request: The IP address of User B is inserted ...
Page 205
Appendix Step Action Description User B User A wants to disconnect the call. User B sends a SIP 200 OK response to 200 OK—User B to Proxy the proxy server. The SIP 200 OK Server response indicates that User B has received the CANCEL request.
Administrator’s Guide for SIP-T2xP IP Phones The following figure illustrates a successful call setup and call hold. In this scenario, the two end users are User A and User B. User A and User B are located at the Yealink SIP IP phones.
Page 207
Appendix Step Action Description User A sends an INVITE message to a proxy server. The INVITE request is an invitation to User B to participate in a call session. In the INVITE request: The IP address of User B is inserted ...
Page 208
Administrator’s Guide for SIP-T2xP IP Phones Step Action Description User A sends a SIP ACK to the proxy server. The ACK confirms that User A ACK—User A to Proxy Server has received the 200 OK response. The call session is now active.
Page 209
In this call flow scenario, the end users are User A, User B, and User C. They are all using Yealink SIP IP phones, which are connected via an IP network.
Page 210
Administrator’s Guide for SIP-T2xP IP Phones Proxy Server User C User A User B F1. INVITE B F2. INVITE B F3. 180 Ringing F4. 180 Ringing F5. 200 OK F6. 200 OK F7. ACK F8. ACK 2-way RTP channel established F9.
Page 211
Appendix Step Action Description User A sends an SIP INVITE message to a proxy server. The INVITE request is an invitation to User B to participate in a call session. In the INVITE request: The IP address of User B is inserted ...
Page 212
Administrator’s Guide for SIP-T2xP IP Phones Step Action Description User A sends a SIP ACK to the proxy server, The ACK confirms that User A ACK—User A to Proxy Server has received the 200 OK response. The call session is now active.
Page 213
Appendix Step Action Description User A sends a mid-call INVITE request INVITE—User A to Proxy to the proxy server with new SDP Server session parameters, which are used to place the call on hold. INVITE—Proxy Server to User The proxy server forwards the mid-call INVITE message to User B.
Page 214
This is called a blind transfer. In this call flow scenario, the end users are User A, User B, and User C. They are all using Yealink SIP IP phones, which are connected via an IP network.
Page 215
Appendix User A Proxy Server User B User C F1. INVITE B F2. INVITE B F3. 180 Ringing F4. 180 Ringing F5. 200 OK F6. 200 OK F7. ACK F8. ACK 2-way RTP channel established F9. REFER F10. 202 Accepted F11.
Page 216
Administrator’s Guide for SIP-T2xP IP Phones Step Action Description User A sends an INVITE message to the proxy server. The INVITE request is an invitation to User B to participate in a call session. In the INVITE request: The IP address of User B is inserted ...
Page 217
Appendix Step Action Description User A sends a SIP ACK to the proxy server, The ACK confirms that User A ACK—User A to Proxy Server has received the 200 OK response. The call session is now active. The proxy server sends the SIP ACK to User B.
Page 218
Administrator’s Guide for SIP-T2xP IP Phones Step Action Description User B wants to release the call. The proxy server forwards the BYE BYE—Proxy Server to User A request to User A. User A sends a SIP 200 OK response to 200OK—User A to Proxy...
Page 219
This is called attended transfer. In this call flow scenario, the end users are User A, User B, and User C. They are all using Yealink SIP IP phones, which are connected via an IP network.
Page 220
Administrator’s Guide for SIP-T2xP IP Phones User A Proxy Server User B User C F1. INVITE B F2. INVITE B F3. 180 Ringing F4. 180 Ringing F5. 200 OK F6. 200 OK F7. ACK F8. ACK 2-way RTP channel established F9.
Page 221
Appendix Step Action Description User A sends an INVITE message to a proxy server. The INVITE request is an invitation to User B to participate in a call session. In the INVITE request: The IP address of User B is inserted ...
Page 222
Administrator’s Guide for SIP-T2xP IP Phones Step Action Description User A sends a SIP ACK to the proxy server, The ACK confirms that User A ACK—User A to Proxy Server has received the 200 OK response. The call session is now active.
Page 223
Appendix Step Action Description sends the INVITE request to User C. User C sends a SIP 180 Ringing 180 Ringing—User C to Proxy response to the proxy server. The 180 Server Ringing response indicates that the user is being alerted. The proxy server forwards the 180 180 Ringing—Proxy Server to Ringing response to User A.
Page 224
Administrator’s Guide for SIP-T2xP IP Phones Step Action Description response indicates that User B accepts the transfer. User B sends a SIP Notify message to NOTIFY—User B to Proxy the proxy server. The Notify message Server inform User A the state of User B.
User C when User A calls User B. In this call flow scenario, the end users are User A, User B, and User C. They are all using Yealink SIP IP phones, which are connected via an IP network.
Page 226
Administrator’s Guide for SIP-T2xP IP Phones Step Action Description User A sends an INVITE message to a proxy server. The INVITE request is an invitation to User B to participate in a call session. In the INVITE request: The IP address of the User B is ...
Page 227
Appendix Step Action Description User A sends a SIP INVITE request to the proxy server. In the INVITE request, a INVITE—User A to Proxy unique Call-ID is generated and the Server Contact-URI field indicates that User A requested the call. The proxy server maps the SIP URI in the INVITE—Proxy Server to User To field to User C.
User B is busy. In this call flow scenario, the end users are User A, User B, and User C. They are all using Yealink SIP IP phones, which are connected via an IP network. The call flow scenario is as follows: User B enables busy call forward, and the destination number is User C.
Page 229
Appendix Step Action Description User A sends the INVITE message to a proxy server. The INVITE request is an invitation to User B to participate in a call session. In the INVITE request: The IP address of User B is inserted ...
Page 230
Administrator’s Guide for SIP-T2xP IP Phones Step Action Description ACK message. 302 Move Temporarily—Proxy The proxy server forwards the 302 Server to User A Moved Temporarily message to User A. User A sends a SIP ACK to the proxy server. The ACK message notifies the ACK—User A to Proxy Server...
User C when User B does not answer the incoming call after a period of time. In this call flow scenario, the end users are User A, User B, and User C. They are all using Yealink SIP IP phones, which are connected via an IP network.
Page 232
Administrator’s Guide for SIP-T2xP IP Phones Step Action Description User A sends the INVITE message to a proxy server. The INVITE request is an invitation to User B to participate in a call session. In the INVITE request: The IP address of User B is inserted ...
Page 233
Appendix Step Action Description ACK message. 302 Move Temporarily—Proxy The proxy server forwards the 302 Server to User A Moved Temporarily message to User A. User A sends a SIP ACK to the proxy server. The ACK message notifies the ACK—User A to Proxy Server proxy server that User A has received the ACK message.
Page 234
User A mixes two RTP channels and therefore establishes a conference between User B and User C. In this call flow scenario, the end users are User A, User B, and User C. They are all using Yealink SIP IP phones, which are connected via an IP network.
Page 235
Appendix User A User B User C Proxy Server F1. INVITE B F2. INVITE B F3. 180 Ringing F4. 180 Ringing F5. 200 OK F6. 200 OK F7. ACK F8. ACK Session1 established between User A and User B is active F9.
Page 236
Administrator’s Guide for SIP-T2xP IP Phones Step Action Description User A sends the INVITE message to a proxy server. The INVITE request is an invitation to User B to participate in a call session. In the INVITE request: The IP address of User B is inserted ...
Page 237
Appendix Step Action Description User A sends a SIP ACK to the proxy server. The ACK confirms that User A ACK—User A to Proxy Server has received the 200 OK response. The call session is now active. The proxy server sends the SIP ACK to User B.
Page 238
Administrator’s Guide for SIP-T2xP IP Phones Step Action Description sends the SIP INVITE request to User C. User C sends a SIP 180 Ringing 180 Ringing—User C to Proxy response to the proxy server. The 180 Server Ringing response indicates that the user is being alerted.
Appendix This section provides the sample configuration file necessary to configure the IP phone. Any line starts with a pound sign (#) is considered to be a comment, unless the # is contained within double quotes. For Boolean fields, 0 = disabled, 1 = enabled. This file contains sample configurations for the <y0000000000xx>.cfg or <MAC>.cfg file.
Administrator’s Guide for SIP-T2xP IP Phones Time Settings local_time.time_zone = local_time.time_zone_name = local_time.ntp_server1 = local_time.ntp_server2 = local_time.interval = local_time.dhcp_time = #Use the following parameters to set the time and date manually. local_time.manual_time_enable = local_time.date_format = local_time.time_format = Auto DST Settings local_time.summer_time =...
Index Numeric Centralized Conference Changes from Previous Versions 802.1x Authentication Configuration Files Configuration Interface Changing the AES Keys on the Phone About This Guide Configuring Advanced features Action URL Configuring Basic Features Action URI Configuring Network Parameters Manually Administrator Password Connect the Network and Power Always Forward Connecting the Phone...
Administrator’s Guide for SIP-T2xP IP Phones Initialization Process Overview SIP Components SIP Header SIP IP Phone Models Key Features of the SIP-T2xP IP Phones SIP Request SIP Responses SIP Session Description Protocol Usage Language SNMP LDAP Specifying the Language to Use...
Need help?
Do you have a question about the SIP-T2xP and is the answer not in the manual?
Questions and answers