Yealink SIP-T2 Series User manual

Table of Contents
i

Table of Contents
iii
Table of Contents......................................................................iii
Summary of Changes..............................................................vii
Changes for Release 72, Guide Version 72.30.................................................................vii
Changes for Release 72, Guide Version 72.2...................................................................vii
Changes for Release 72, Guide Version 72.1..................................................................viii
Changes for Release 71, Guide Version 71.165..............................................................viii
Changes for Release 71, Guide Version 71.140..............................................................viii
Changes for Release 71, Guide Version 71.125..............................................................viii
Changes for Release 71, Guide Version 71.120..............................................................viii
Changes for Release 71, Guide Version 71.110................................................................ix
Changes for Release 70, Guide Version 1.3......................................................................ix
Introduction............................................................................... 1
Getting Started......................................................................... 3
Obtaining Configuration Information ................................................................................ 3
Obtaining Configuration Files ......................................................................................... 3
Obtaining Phone Information.......................................................................................... 4
Managing Configuration Files............................................................................................ 4
Editing Common CFG File................................................................................................ 5
Editing MAC-Oriented CFG File...................................................................................... 7
Managing MAC-local CFG File..................................................................................... 14
Encrypting Configuration Files ...................................................................................... 17
Customizing Resource Files............................................................................................ 17
Customizing a Ring Tone............................................................................................. 17
Customizing an LCD Language ................................................................................. 18
Customizing an LCD Logo........................................................................................... 19
Customizing a Local Contact File .............................................................................. 21
Customizing a Replace Rule File................................................................................ 23
Customizing a Dial-now File....................................................................................... 24
Customizing a Directory Template ............................................................................ 25
Customizing a Super Search Template..................................................................... 26
Upgrading Firmware................................................................................................... 27

Yealink IP Phones Auto provisioning Guide
iv
Configuring a TFTP Server...................................................... 29
Preparing a Root Directory................................................................................................ 29
Configuring a TFTP Server................................................................................................. 30
Obtaining the Address of Provisioning Server ...................... 31
Zero Touch........................................................................................................................... 31
Plug and Play (PnP) Server ............................................................................................... 33
DHCP Options..................................................................................................................... 34
Phone Flash......................................................................................................................... 35
Update Mode......................................................................... 37
Power On............................................................................................................................. 37
Repeatedly.......................................................................................................................... 38
Weekly................................................................................................................................. 39
Auto Provision Now ............................................................................................................ 40
Multi-mode Mixed ............................................................................................................. 41
SIP NOTIFY Message ......................................................................................................... 41
Downloading and Verifying Configurations .......................... 43
Downloading Configuration Files..................................................................................... 43
Resolving and Updating Configurations ......................................................................... 43
Verifying Configurations .................................................................................................... 44
Specific Scenarios.............................................................................................................. 45
Scenario A Protect personalized configuration settings ............................................ 45
Scenario (A) Protect personalized configuration settings (IP phones are running
firmware version prior to X.72.0.30) .......................................................................... 45
Scenario (B) Protect personalized configuration settings (IP phones are running
firmware version X.72.0.30 or later) .......................................................................... 49
Scenario B Clear personalized configuration settings ............................................... 52
Scenario C Protect personalized configuration settings during factory reset ......... 54
Scenario D Import or export the local configuration file............................................ 55
Troubleshooting ...................................................................... 59
Glossary.................................................................................. 61
Appendix ................................................................................ 63
Configuring an FTP Server ................................................................................................ 63

Table of Contents
v
Preparing a Root Directory ............................................................................................ 63
Configuring an FTP Server ............................................................................................. 64
Configuring an HTTP Server.............................................................................................. 66
Preparing a Root Directory ............................................................................................ 66
Configuring an HTTP Server .......................................................................................... 66
Configuring a DHCP Server .............................................................................................. 69
Customizing a Ring Tone Using Cool Edit Pro ................................................................. 77
Customizing a Logo File Using PictureExDemo .............................................................. 78
Auto Provisioning Flowchart (Protect personalized configuration settings)................ 79
Generating A MAC-local CFG file ................................................................................... 80
Description of Configuration Parameters in CFG Files .................................................. 81
Time Zones........................................................................................................................ 215
BLF LED Mode................................................................................................................... 218

Yealink IP Phones Auto provisioning Guide
vi

Summary of Changes
vii
This section describes the changes to this guide for each release and guide version.
This version is updated to remove SIP-T4X, SIP-T21P and SIP-T19P IP phones. The following
sections are new for this version:
Managing MAC-local CFG File on page 14
Specific Scenarios on page 45
Auto Provisioning Flowchart (Protect personalized configuration settings) on page
79
Generating A MAC-local CFG file on page 80
Major updates have occurred to the following sections:
Obtaining Configuration Files on page 3
Downloading Configuration Files on page 43
Resolving and Updating Configurations on page 43
Description of Configuration Parameters in CFG Files on page 81
This version is updated to incorporate SIP-T48G IP phones. The following sections are
new for this version:
Customizing a Directory Template on page 25
Customizing a Super Search Template on page 26
Major updates have occurred to the following sections:
Editing Common CFG File on page 5
Editing MAC-Oriented CFG File on page 7
Customizing Resource Files on page 17
Description of Configuration Parameters in CFG Files on page 81
BLF LED Mode on page 218

Yealink IP Phones Auto provisioning Guide
viii
This version is updated to incorporate SIP-T46G, SIP-T42G and SIP-T41P IP phones. The
following sections are new for this version:
Time Zones on page 215
BLF LED Mode on page 218
Major updates have occurred to the following sections:
Editing Common CFG File on page 5
Editing MAC-Oriented CFG File on page 7
Customizing Resource Files on page 17
Description of Configuration Parameters in CFG Files on page 81
Documentations of the newly released SIP-T21P and SIP-T19P IP phones have also been
added.
Major updates have occurred to the following sections:
Editing Common CFG File on page 5
Editing MAC-Oriented CFG File on page 7
Encrypting Configuration Files on page 17
Customizing an LCD Logo on page 19
Customizing a Local Contact File on page 21
Description of Configuration Parameters in CFG Files on page 81
Major updates have occurred to the following section:
Customizing an LCD Logo on page 19
Major updates have occurred to the following section:
Description of Configuration Parameters in CFG Files on page 81

Summary of Changes
ix
The following sections are new for this version:
Encrypting Configuration Files on page 17
Update Mode on page 37
SIP NOTIFY Message on page 41
Resolving and Updating Configurations on page 43
Description of Configuration Parameters in CFG Files on page 81
Major updates have occurred to the following sections:
Customizing a Local Contact File on page 21
Customizing a Replace Rule File on page 23
Customizing a Dial-now File on page 24
The following sections are new for this version:
Customizing a Replace Rule File on page 23
Customizing a Dial-now File on page 24
Major updates have occurred to the following sections:
Customizing a Local Contact File on page 21
Upgrading Firmware on page 27

Introduction
1
Yealink IP phones are full-featured telephones that can be plugged directly into an IP
network and can be used easily without manual configuration.
This guide provides instructions on how to provision Yealink IP phones with the minimum
settings required. Yealink IP phones support FTP, TFTP, HTTP, and HTTPS protocols for auto
provisioning and are configured by default to use the TFTP protocol.
The purpose of this guide is to serve as a basic guidance for provisioning Yealink IP
phones, including:
Yealink SIP-T28P
Yealink SIP-T26P
Yealink SIP-T22P
Yealink SIP-T20P
The auto provisioning process outlined in this guide applies to Yealink IP phones
running firmware version X.72.0.30 or later. We recommend that IP phones running the
latest firmware CANNOT be downgraded to an earlier firmware version. The new
firmware is compatible with old configuration parameters, but not vice versa.
This guide is also applicable to SIP-T20 IP phones.

Yealink IP Phones Auto provisioning Guide
2

Getting Started
3
This section provides instructions on how to get ready for auto provisioning. The auto
provisioning process discussed in this guide uses the TFTP server as the provisioning
server.
To begin the auto provisioning process, the following steps are required:
Obtaining Configuration Information
Managing Configuration Files
Before beginning provisioning, you need to obtain configuration files. There are two
configuration files both of which are CFG-formatted. We call these two files Common
CFG file and MAC-Oriented CFG file. The phone tries to download these CFG files from
the server during provisioning.
IP phones also support a local configuration file named as MAC-local.cfg. When a user
modifies configurations via web user interface or phone user interface, the
configurations will be saved to the MAC-local CFG file on the phone.
The MAC-Oriented and MAC-local CFG files are only effectual for the specific phone.
They use the 12-digit MAC address of the phone as the file name. For example, if the
MAC address of the phone is 0015651130F9, the MAC-Oriented CFG and MAC-local
CFG files have to be named as 0015651130F9.cfg and 0015651130F9-local.cfg
respectively. However, the Common CFG file is effectual for all the phones with the
same model. It uses a fixed name “y0000000000XX.cfg”or “y00000000000X.cfg”as the
file name, where "XX" or “X”equals to the first two digits or the first digit (except 0 for
SIP-T28P) of the hardware version of the phone model.
The names of the Common CFG file for each phone model are:
Phone Model
Common CFG File
SIP-T28P
y000000000000.cfg
SIP-T26P
y000000000004.cfg
SIP-T22P
y000000000005.cfg
SIP-T20P
y000000000007.cfg

Yealink IP Phones Auto provisioning Guide
4
You can ask the distributor or Yealink FAE for configuration files. The IP phones running
firmware version 71 or later can only recognize configuration files using UTF-8 or ANSI
encoding. The local configuration file can also be exported via web user interface. For
more information on how to export a local configuration file, refer to Scenario D Import
or export the local configuration file on page 55.
Before beginning provisioning, you also need the phone information. For example, MAC
address and the SIP account information of the phone.
MAC Address: The unique 12-digit serial number of the phone. You can obtain it from the
bar code on the back of the phone.
SIP Account Information: This may include SIP credentials such as user name, password
and IP address of the SIP server. Ask your system administrator for SIP account
information.
Auto provisioning enables Yealink IP phones to update themselves automatically via
downloading Common CFG and MAC-Oriented CFG files. Before beginning
provisioning, you may need to edit and customize your configuration files. For more
information on configuration parameters in configuration files, refer to Description of
Configuration Parameters in CFG Files on page 81.

Getting Started
5
Common CFG file contains configuration parameters which apply to phones with the
same model, such as language and volume.
The following figure shows a portion of the common CFG file:
The partial parameters in the Common CFG file are described as follows:
####################################################
## Common CFG File ##
####################################################
#!version:1.0.0.1
##File header "#!version:1.0.0.1" cannot be edited or deleted, and must be placed in
the first line. This template file is applicable to SIP-T28P/T26P/T22P/T20P IP phones running
firmware version 72 or later. For more information on configuration parameters, refer to
Yealink_SIP-T2_Series_IP_Phones_Auto_Provisioning_Guide. ##
######################################################
## Hostname ##
######################################################
network.dhcp_host_name =
######################################################
## PPPOE ##
######################################################
network.pppoe.user =
network.pppoe.password =
The line beginning with “#”is considered to be a comment.
The file header “#!version:1.0.0.1”is not a comment and must be placed in the
first line. It cannot be edited or deleted.

Yealink IP Phones Auto provisioning Guide
6
######################################################
## PC Port ##
######################################################
network.bridge_mode =
network.pc_port.ip =
network.pc_port.mask =
network.dhcp.start_ip =
network.dhcp.end_ip =
######################################################
## Network Advanced ##
######################################################
network.pc_port.enable =
network.internet_port.speed_duplex =
network.pc_port.speed_duplex =
network.pc_port.dhcp_server =
network.static_dns_enable =
######################################################
## VLAN ##
######################################################
network.vlan.internet_port_enable =
network.vlan.internet_port_vid =
network.vlan.internet_port_priority =
network.vlan.pc_port_enable =
network.vlan.pc_port_vid =
network.vlan.pc_port_priority =
network.vlan.dhcp_enable =
network.vlan.dhcp_option =
######################################################
## WEB Port ##
######################################################
network.port.http =
network.port.https =
wui.https_enable =
wui.http_enable =
######################################################
## QoS ##
######################################################
network.qos.rtptos =
network.qos.signaltos =
######################################################
## 802.1X ##
######################################################
network.802_1x.mode =
network.802_1x.identity =
network.802_1x.md5_password =
network.802_1x.root_cert_url =
network.802_1x.client_cert_url =

Getting Started
7
######################################################
## OpenVPN ##
######################################################
network.vpn_enable =
openvpn.url =
######################################################
## LLDP ##
######################################################
network.lldp.enable =
network.lldp.packet_interval =
MAC-Oriented CFG file contains configuration parameters which are expected to be
updated per phone, such as the registration information.
The following figure shows a portion of the MAC-Oriented CFG file:
The partial parameters in the MAC-Oriented CFG file are described as follows:
####################################################
## MAC-Oriented CFG File ##
####################################################
#!version:1.0.0.1
##File header "#!version:1.0.0.1" cannot be edited or deleted, and must be placed in
the first line. This template file is applicable to SIP-T28P/T26P/T22P/T20P IP phones running
firmware version 72 or later. For more information on configuration parameters, refer to
Yealink_SIP-T2_Series_IP_Phones_Auto_Provisioning_Guide. ##

Yealink IP Phones Auto provisioning Guide
8
######################################################
## Account1 Basic Settings ##
######################################################
account.1.enable =
account.1.label =
account.1.display_name =
account.1.auth_name =
account.1.user_name =
account.1.password =
account.1.outbound_proxy_enable =
account.1.outbound_host =
account.1.outbound_port =
account.1.sip_listen_port =
account.1.transport =
######################################################
## Failback ##
######################################################
account.1.reregister_enable =
account.1.naptr_build =
account.1.fallback.redundancy_type =
account.1.fallback.timeout =
account.1.sip_server.1.address =
account.1.sip_server.1.port =
account.1.sip_server.1.expires =
account.1.sip_server.1.retry_counts =
account.1.sip_server.1.failback_mode =
account.1.sip_server.1.failback_timeout =
account.1.sip_server.1.register_on_enable =
account.1.sip_server.2.address =
account.1.sip_server.2.port =
account.1.sip_server.2.expires =
account.1.sip_server.2.retry_counts =
account.1.sip_server.2.failback_mode =
account.1.sip_server.2.failback_timeout =
account.1.sip_server.2.register_on_enable =

Getting Started
9
######################################################
## Account2 Basic Settings ##
######################################################
account.2.enable =
account.2.label =
account.2.display_name =
account.2.auth_name =
account.2.user_name =
account.2.password =
account.2.outbound_proxy_enable =
account.2.outbound_host =
account.2.outbound_port =
account.2.sip_listen_port =
account.2.transport =
######################################################
## Failback ##
######################################################
account.2.reregister_enable =
account.2.naptr_build =
account.2.fallback.redundancy_type =
account.2.fallback.timeout =
account.2.sip_server.1.address =
account.2.sip_server.1.port =
account.2.sip_server.1.expires =
account.2.sip_server.1.retry_counts =
account.2.sip_server.1.failback_mode =
account.2.sip_server.1.failback_timeout =
account.2.sip_server.1.register_on_enable =
account.2.sip_server.2.address =
account.2.sip_server.2.port =
account.2.sip_server.2.expires =
account.2.sip_server.2.retry_counts =
account.2.sip_server.2.failback_mode =
account.2.sip_server.2.failback_timeout =
account.2.sip_server.2.register_on_enable =

Yealink IP Phones Auto provisioning Guide
10
######################################################
## Account3 Basic Settings (except SIP-T20P Model) ##
######################################################
account.3.enable =
account.3.label =
account.3.display_name =
account.3.auth_name =
account.3.user_name =
account.3.password =
account.3.outbound_proxy_enable =
account.3.outbound_host =
account.3.outbound_port =
account.3.sip_listen_port =
account.3.transport =
######################################################
## Failback ##
######################################################
account.3.reregister_enable =
account.3.naptr_build =
account.3.fallback.redundancy_type =
account.3.fallback.timeout =
account.3.sip_server.1.address =
account.3.sip_server.1.port =
account.3.sip_server.1.expires =
account.3.sip_server.1.retry_counts =
account.3.sip_server.1.failback_mode =
account.3.sip_server.1.failback_timeout =
account.3.sip_server.1.register_on_enable =
account.3.sip_server.2.address =
account.3.sip_server.2.port =
account.3.sip_server.2.expires =
account.3.sip_server.2.retry_counts =
account.3.sip_server.2.failback_mode =
account.3.sip_server.2.failback_timeout =
account.3.sip_server.2.register_on_enable =