publication may be reproduced or transmitted in any form or by any means, electronic or mechanical,
photocopying, recording, or otherwise, for any purpose, without the express written permission of
Yealink (Xiamen) Network Technology CO., LTD. Under the law, reproducing includes translating into
another language or format.
When this publication is made available on media, Yealink (Xiamen) Network Technology CO., LTD. gives
its consent to downloading and printing copies of the content provided in this file only for private use
but not for redistribution. No parts of this publication may be subject to alteration, modification or
commercial use. Yealink (Xiamen) Network Technology CO., LTD. will not be liable for any damages
arising from use of an illegally modified or altered publication.
Trademarks
Yealink®, the logo and the name and marks is trademark of Yealink (Xiamen) Network Technology CO.,
LTD, which are registered legally in China, the United States, EU (European Union) and other countries.
All other trademarks belong to their respective owners. Without Yealink’s express written permission,
recipient shall not reproduce or transmit any portion hereof in any form or by any means, with any
purpose other than personal use.
Warranty
(1) Warranty
THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS GUIDE ARE SUBJECT TO
CHANGE WITHOUT NOTICE. ALL STATEMENTS, INFORMATION, AND RECOMMENDATIONS IN THIS
GUIDE ARE BELIEVED TO BE ACCURATE AND PRESENTED WITHOUT WARRANTY OF ANY KIND, EXPRESS
OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF PRODUCTS.
(2) Disclaimer
YEALINK (XIAMEN) NETWORK TECHNOLOGY CO., LTD. MAKES NO WARRANTY OF ANY KIND WITH
REGARD TO THIS GUIDE, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. Yealink (Xiamen) Network Technology
CO., LTD. shall not be liable for errors contained herein nor for incidental or consequential damages in
connection with the furnishing, performance, or use of this guide.
(3) Limitation of Liability
Yealink and/or its respective suppliers are not responsible for the suitability of the information contained
in this document for any reason. The information is provided “as is”, and Yealink does not provide any
ii
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 event, even if Yealink has been suggested the occurrence of
damages that are direct, consequential, incidental, special, punitive or whatsoever (Including but not
limited to loss of business profit, business interruption or loss of business information), shall not be liable
for these damages.
End User License Agreement
This End User License Agreement ("EULA") is a legal agreement between you and Yealink. By installing,
copying or otherwise using the Products, you: (1) agree to be bounded by the terms of this EULA, (2) you
are the owner or an authorized user of the device, and (3) you represent and warrant that you have the
right, authority and capacity to enter into this agreement and to abide by all its terms and conditions, just
as if you had signed it. The EULA for this product is available on the Yealink Support page for the product.
Patent Information
China, the United States, EU (European Union) and other countries are protecting one or more patents of
accompanying products and/or patents being applied by Yealink.
Customer Feedback
We are striving to improve our documentation quality and we appreciate your feedback. Email your
opinions and comments 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.
iii
GNU GPL INFORMATION
Yealink IP phone firmware contains third-party software under the GNU General Public License (GPL).
Yealink uses software under the specific terms of the GPL. Please refer to the GPL for the exact terms and
conditions of the license.
The original GPL license, source code of components licensed under GPL and used in Yealink products
can be downloaded from Yealink web site:http://www.yealink.com/onepage_83.html.
iv
Introduction
Introduction
Yealink administrator guide provides general guidance on setting up phone network, provisioning and
managing phones.
This guide is not intended for end users, but for administrators with experience in networking who
understand the basic of open SIP networks and VoIP endpoint environments.
As an administrator, you can do the following with this guide:
Set up a VoIP network and provisioning server.
Provision the phone with features and settings.
Troubleshoot, update and maintain phones.
The information detailed in this guide is applicable to the following Yealink devices running firmware
version 83 or higher:
T5 series IP phones, including T54S and T52S.
T4 series IP phones, including T48S/G, T46S/G, T42S/G, T41S/P and T40P/G.
T2 series IP phones, including T29G, T27P/G, T23P/G, T21(P) E2 and T19(P) E2.
Expansion modules, including EXP20, EXP40 and EXP50.
Read the Yealink Products Regulatory Notices guide for all regulatory and safety guidance.
Related Documentations
The following related documents are available:
Quick Start Guides, describe how to assemble IP phones and configure the most basic features
available on IP phones.
User Guides, describe how to configure and use the basic and advanced features available on IP
phones via phone user interface or via web user interface.
Auto Provisioning Guide, describes how to provision IP phones using the boot file and configuration
files.
The
Auto Provisioning Guide
a provisioning server. If you are novice, this guide is helpful for you.
is to serve as a basic guidance for provisioning Yealink IP phones with
Using features integrated with Broadsoft UC-One, refer to the following two guides to have a better
knowledge of BroadSoft features.
IP Phones Deployment Guide for BroadSoft UC-One Environments, describes how to configure
BroadSoft features on the BroadWorks web portal and IP phones.
IP Phone Features Integrated with BroadSoft UC-One User Guide, describes how to configure and
i
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones
Convention
Description
Bold
Highlight the web/phone user interface items such as menus, menu
selections, soft keys, or directory names when they are involved in a
procedure or user action (for example, click Settings->Upgrade.).
Also used to emphasize text (for example, Important!).
Italics
Used to emphasize text, to show the example values or inputs (format of
examples:
http(s)://[IPv6 address]
).
Blue Text
Used for cross references to other topics related to this topic (for example,
Ring Tones), for hyperlinks to external sites and documents, for example, RFC
3315 or Yealink_SIP_IP_Phones_Auto_Provisioning_Guide.
Convention
Description
<>
Indicate that you must enter information specific to phone or network. For
example, when you see <MAC>, enter your phone’s 12-digit MAC address. If
you see <phoneIPAddress>, enter your phone’s IP address.
use IP phone features integrated with BroadSoft UC-One on Yealink IP phones.
For support or service, please contact your Yealink reseller or go to Yealink Technical Support online:
http://support.yealink.com/.
Recommended References
For more information on configuring and administering other Yealink products not included in this guide,
refer to product support page at Yealink Technical Support.
To access the latest Release Notes or other guides for Yealink IP phones, refer to the Document
Downloadpage for your phone at Yealink Technical Support.
If you want to find Request for Comments (RFC) documents, type
(NNNN is the RFC number) into the location field of your browser.
For other references, look for the hyperlink or web info throughout this administrator guide.
http://www.ietf.org/rfc/rfcNNNN.txt
Typographic and Writing Conventions
Yealink documentations contain a few typographic conventions and writing conventions.
You need to know the following basic typographic conventions to distinguish types of in-text
information:
You also need to know the following writing conventions to distinguish conditional information:
ii
Convention
Description
->
Indicate that you need to select an item from a menu. For example,
Settings->Basic Settings indicates that you need to select Basic Settings
from the Settings menu.
Introduction
iii
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones
iv
Table of Contents
Table of Contents
Introduction..................................................................................... i
Related Documentations ......................................................................................................................................................... i
Recommended References .................................................................................................................................................... ii
Typographic and Writing Conventions ............................................................................................................................. ii
Table of Contents ........................................................................... v
Getting Started ............................................................................... 1
Yealink IP Phones in a Network ........................................................................................................................................... 1
Initialization Process Overview ............................................................................................................................................. 2
Loading the ROM File ..................................................................................................................................................... 3
Configuring the VLAN .................................................................................................................................................... 3
Querying the DHCP (Dynamic Host Configuration Protocol) Server .......................................................... 3
Contacting the Provisioning Server .......................................................................................................................... 3
SIP Port and TLS Port Configuration...................................................................................................................... 39
Internet Port and PC Port .................................................................................................................................................... 40
Internet Port and PC Port Configuration ............................................................................................................. 40
VPN Related Files ........................................................................................................................................................... 42
Quality of Service (QoS) ....................................................................................................................................................... 43
Voice and SIP QoS Configuration ........................................................................................................................... 44
Files Download Process ............................................................................................................................................... 63
Central Provisioning ..................................................................................................................................................... 71
Setting Up a Provisioning Server ...................................................................................................................................... 80
Supported Provisioning Server Discovery Methods ....................................................................................... 82
Configuring a Provisioning Server .......................................................................................................................... 86
Keeping User’s Personalized Settings after Auto Provisioning ............................................................................ 87
Auto Provisioning Flowchart for Keep User’s Personalized Configuration Settings ......................... 88
vi
Table of Contents
Example: Deploying Phones from the Provisioning Server ................................................................................... 89
Firmware for Each Phone Model ...................................................................................................................................... 91
Language .................................................................................................................................................................................... 94
Language Display Configuration ............................................................................................................................. 95
Language Customization ............................................................................................................................................ 96
Example: Setting a Custom Language for Phone Display .......................................................................... 101
Backlight Brightness and Time Configuration ................................................................................................. 114
Label Length for Line Key Display .................................................................................................................................. 116
Linekey Length in Short ...................................................................................................................................................... 118
Linekey Length in Short Configuration ............................................................................................................... 119
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones
Time and Date ........................................................................................................................................................................ 123
Time Zone ....................................................................................................................................................................... 124
Time and Date Manually Configuration ............................................................................................................. 134
Time and Date Format Configuration ................................................................................................................. 135
Date Customization Rule .......................................................................................................................................... 136
Logo Customization ............................................................................................................................................................. 137
Custom Logo Picture Limit ...................................................................................................................................... 138
Customizing a Logo Picture .................................................................................................................................... 138
Custom Logo Configuration.................................................................................................................................... 139
Example: Setting a Custom Logo Display .......................................................................................................... 140
Display Method on Dialing ............................................................................................................................................... 143
Display Method on Dialing Configuration ........................................................................................................ 143
Key As Send ............................................................................................................................................................................. 144
Key As Send Configuration ...................................................................................................................................... 144
Supported Call States and Soft Keys ................................................................................................................... 145
Power LED Indicator ............................................................................................................................................................. 159
Power LED Indicator Configuration ...................................................................................................................... 159
Bluetooth .................................................................................................................................................................................. 162
Bluetooth Configuration ........................................................................................................................................... 162
Line Keys .......................................................................................................................................................................... 167
EDK List Configuration ............................................................................................................................................... 189
Example: Configuring EDK List for a Line Key .................................................................................................. 197
Power Saving .......................................................................................................................................................................... 197
Power Saving Configuration ................................................................................................................................... 198
USB Port Lock ......................................................................................................................................................................... 201
USB Port Lock Configuration .................................................................................................................................. 201
Search Source List in Dialing ............................................................................................................................................ 201
Outbound Proxy in Dialog ................................................................................................................................................ 215
Outbound Proxy in Dialog Configuration ......................................................................................................... 215
Server Redundancy............................................................................................................................................................... 216
Behaviors When Working Server Connection Fails ....................................................................................... 217
Registration Method of the Failover/Fallback Mode .................................................................................... 218
Fallback Server Redundancy Configuration...................................................................................................... 218
Failover Server Redundancy Configuration ...................................................................................................... 220
SIP Server Name Resolution ............................................................................................................................................. 225
SIP Server Name Resolution Configuration ...................................................................................................... 225
Static DNS Cache................................................................................................................................................................... 226
Behave with a Configured DNS Server ............................................................................................................... 226
Static DNS Cache Configuration ........................................................................................................................... 227
Multiple Line Keys per Account ...................................................................................................................................... 233
Multiple Line Keys per Account Configuration ............................................................................................... 233
Auto Line Labels Rule Configuration ................................................................................................................... 235
Local Directory ....................................................................................................................................................................... 245
Contact Avatars and Icons Picture Limit ............................................................................................................ 245
Preparing the Tar Formatted File .......................................................................................................................... 246
Local Contact File Customization .......................................................................................................................... 247
Local Contact Files and Resource Upload ......................................................................................................... 249
Example: Adding Contacts Using a Contact File ............................................................................................. 252
Local Contacts Backup ........................................................................................................................................................ 252
Remote Phone Book ............................................................................................................................................................ 262
Remote Phone Book File Customization ........................................................................................................... 263
Remote Phone Book Configuration ..................................................................................................................... 265
Example: Configuring a Remote Phone Book.................................................................................................. 266
Directory List for Directory/Dir Soft Key ...................................................................................................................... 267
Directory List File Customization ........................................................................................................................... 267
Directory List Configuration .................................................................................................................................... 269
Example: Configuring a Directory List ................................................................................................................. 271
Call Features ............................................................................... 273
Dial Plan .................................................................................................................................................................................... 274
Dial Plan Defined by Four Patterns ...................................................................................................................... 274
Dial Plan Defined by Digit Map ............................................................................................................................. 283
Emergency Dialplan and Enhanced 911 ...................................................................................................................... 293
Emergency Dialplan and Enhanced 911 Configuration ............................................................................... 294
Off Hook Hot Line Dialing ................................................................................................................................................. 300
Off Hook Hot Line Dialing Configuration .......................................................................................................... 300
Live Dialpad ............................................................................................................................................................................. 301
Live Dialpad Configuration ...................................................................................................................................... 301
Auto Redial .............................................................................................................................................................................. 302
Auto Redial Configuration ....................................................................................................................................... 302
Call Number Filter ................................................................................................................................................................. 309
Call Number Filter Configuration .......................................................................................................................... 309
IP Address Call ........................................................................................................................................................................ 309
IP Address Call Configuration................................................................................................................................. 309
Off Hook Answering ............................................................................................................................................................ 311
Off Hook Answering Configuration ..................................................................................................................... 311
Auto Answer ............................................................................................................................................................................ 311
Auto Answer Configuration ..................................................................................................................................... 312
Do Not Disturb (DND) ......................................................................................................................................................... 318
Call Hold ................................................................................................................................................................................... 325
Call Hold Configuration ............................................................................................................................................ 326
Music on Hold (MoH) Configuration ................................................................................................................... 328
Call Forward Synchronization for Server-side Configuration .................................................................... 343
Call Transfer ............................................................................................................................................................................. 345
Call Transfer Configuration ...................................................................................................................................... 345
Transfer Mode for Dsskey Configuration .......................................................................................................... 347
Conference Type Configuration ............................................................................................................................ 347
Local Conference Configuration ............................................................................................................................ 348
xi
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones
USB Recording ....................................................................................................................................................................... 350
USB Recording Configuration ................................................................................................................................ 350
Audio Features ........................................................................... 359
Alert Tone ................................................................................................................................................................................. 359
Alert Tone Configuration .......................................................................................................................................... 360
Ring Tones ............................................................................................................................................................................... 361
Distinctive Ring Tones ......................................................................................................................................................... 364
Supported Alert-Info Headers Format ................................................................................................................ 364
Distinctive Ring Tones Configuration .................................................................................................................. 368
Packetization Time (PTime) ............................................................................................................................................... 383
Supported PTime of Audio Codec ........................................................................................................................ 383
Early Media .............................................................................................................................................................................. 384
Early Media Configuration ....................................................................................................................................... 385
Automatic Gain Control (AGC) ............................................................................................................................... 388
Transfer via DTMF ........................................................................................................................................................ 396
Local DTMF Tone ......................................................................................................................................................... 397
Security Features ........................................................................ 407
User and Administrator Identification .......................................................................................................................... 407
User and Administrator Identification Configuration ................................................................................... 407
User Access Level Configuration ........................................................................................................................... 409
Auto Logout Time ................................................................................................................................................................. 409
Auto Logout Time Configuration .......................................................................................................................... 410
Group Call Pickup ........................................................................................................................................................ 437
Example: Using Call Completion ........................................................................................................................... 441
xiii
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones
Call Park and Retrieve ......................................................................................................................................................... 441
Call Park and Retrieve Configuration .................................................................................................................. 442
Example: Setting Call Park and Retrieve in FAC Mode ................................................................................ 443
Example: Setting Call Park and Retrieve in Transfer Mode ........................................................................ 444
Automatic Call Distribution (ACD) ................................................................................................................................. 444
Busy Lamp Field ..................................................................................................................................................................... 447
BLF List Configuration ................................................................................................................................................ 448
State Indicator of Remote Line .............................................................................................................................. 451
BLF/BLF List Subscription.......................................................................................................................................... 451
Visual and Audio Alert for Monitor Lines .......................................................................................................... 454
LED Mode for BLF/BLF List Key .............................................................................................................................. 456
BLF/BLF List Key LED Status and Behavior Configuration ........................................................................... 459
BLF Key for Intercom Configuration .................................................................................................................... 468
Shared Line .............................................................................................................................................................................. 469
State Indicator of Shared Line ................................................................................................................................ 469
State Monitor for Intercom Contact .................................................................................................................... 474
CSTA Control ........................................................................................................................................................................... 478
CSTA Control Configuration .................................................................................................................................... 479
Pre-defined Events List .............................................................................................................................................. 479
Variable Values List ..................................................................................................................................................... 481
Action URI ................................................................................................................................................................................ 496
Supported HTTP/HTTPS GET Request ................................................................................................................ 497
Variable Values List ..................................................................................................................................................... 499
Action URI Configuration ......................................................................................................................................... 502
Example: Capturing the Current Screen of the Phone ................................................................................. 503
Example: Placing a Call via Web User Interface .............................................................................................. 504
Voice Mail ................................................................................................................................................................................. 505
MWI for Voice Mail Configuration ....................................................................................................................... 505
Short Message Service (SMS) .......................................................................................................................................... 507
XML Browser ........................................................................................................................................................................... 508
xiv
Table of Contents
XML Browser Configuration .................................................................................................................................... 508
Hot Desking ............................................................................................................................................................................. 510
Hot Desking Key Configuration ............................................................................................................................. 511
Hot Desking Configuration ...................................................................................................................................... 511
General Features ........................................................................ 513
Line Identification Presentation ...................................................................................................................................... 513
CLIP and COLP Configuration................................................................................................................................. 514
Return Code for Refused Call........................................................................................................................................... 515
Return Code for Refused Call Configuration ................................................................................................... 515
Accept SIP Trust Server Only ............................................................................................................................................ 517
Accept SIP Trust Server Only Configuration ..................................................................................................... 517
Reboot in Talking .................................................................................................................................................................. 522
Reboot in Talking Configuration ........................................................................................................................... 522
Reserve # in User Name ..................................................................................................................................................... 522
Reserve # in User Name Configuration .............................................................................................................. 523
Busy Tone Delay .................................................................................................................................................................... 523
Busy Tone Delay Configuration ............................................................................................................................. 524
CFG File Version Information ........................................................................................................................................... 524
CFG File Version Information Configuration .................................................................................................... 524
Media Loopback .................................................................................................................................................................... 524
Media Loopback Configuration ............................................................................................................................. 525
Broadsoft Call Park ...................................................................................................................................................... 548
Watch Dog ...................................................................................................................................................................... 571
Exporting All the Diagnostic Files ......................................................................................................................... 574
Phone Status .................................................................................................................................................................. 575
IP Address Issues.......................................................................................................................................................... 577
Time and Date Issues ................................................................................................................................................. 578
Phone Book Issues ...................................................................................................................................................... 579
Wi-Fi and Bluetooth Issues ...................................................................................................................................... 580
Firmware and Upgrading Issues ............................................................................................................................ 581
System Log Issues ....................................................................................................................................................... 582
Logo Issues ..................................................................................................................................................................... 583
Power and Startup Issues ......................................................................................................................................... 583
Other Issues ................................................................................................................................................................... 584
RFC and Internet Draft Support ...................................................................................................................................... 586
Note: It works only if “static.network.ip_address_mode” is set to 0 (IPv4) or 2 (IPv4 &
IPv6), and "static.network.internet_port.type" is set to 2 (Static IP Address).
Permitted
Values
IPv4 Address
Default
Blank
Web UI
Network->Basic->IPv4 Config->Static IP Address->IP Address
[1]
If you change this parameter, the IP phone will reboot to make the change take effect.
[2]
X is the account ID. For T54S/T48S/T48G/T46S/T46G/T29G, X=1-16; for T52S/T42G/T42S, X=1-12; for
T41P/T41S/T27P/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2; for T19(P) E2, X=1.
IPv4 Configuration
The following table lists the parameters you can use to configure IPv4.
7
Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones