Yealink SIP-T2 Series User manual

Table of Contents
i

Table of Contents
iii
Table of Contents......................................................................iii
Summary of Changes............................................................... v
Changes for Release 72, Guide Version 72.1.................................................................... v
Changes for Release 71, Guide Version 71.165................................................................ v
Changes for Release 71, Guide Version 71.140................................................................ v
Changes for Release 71, Guide Version 71.125................................................................ v
Changes for Release 71, Guide Version 71.120............................................................... vi
Changes for Release 71, Guide Version 71.110............................................................... vi
Changes for Release 70, Guide Version 1.3..................................................................... vi
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
Encrypting Configuration Files ...................................................................................... 14
Customizing Resource Files............................................................................................ 14
Customizing a Ring Tone............................................................................................. 14
Customizing an LCD Language ................................................................................. 15
Customizing an LCD Logo........................................................................................... 17
Customizing a Wallpaper ........................................................................................... 18
Customizing a Local Contact File .............................................................................. 18
Customizing a Replace Rule File................................................................................ 21
Customizing a Dial-now File....................................................................................... 22
Upgrading Firmware................................................................................................... 23
Configuring a TFTP Server...................................................... 25
Preparing a Root Directory................................................................................................ 25
Configuring a TFTP Server................................................................................................. 26

Yealink IP Phones Auto provisioning Guide
iv
Obtaining the Address of Provisioning Server ...................... 27
Zero Touch........................................................................................................................... 27
Plug and Play (PnP) Server ............................................................................................... 29
DHCP Options..................................................................................................................... 30
Phone Flash......................................................................................................................... 31
Update Mode......................................................................... 33
Power On............................................................................................................................. 33
Repeatedly.......................................................................................................................... 34
Weekly................................................................................................................................. 35
Auto Provision Now ............................................................................................................ 36
Multi-mode Mixed ............................................................................................................. 37
SIP NOTIFY Message ......................................................................................................... 37
Downloading and Verifying Configurations .......................... 39
Downloading Configuration Files..................................................................................... 39
Resolving and Updating Configurations ......................................................................... 39
Verifying Configurations .................................................................................................... 40
Troubleshooting ...................................................................... 43
Glossary.................................................................................. 45
Appendix ................................................................................ 47
Configuring an FTP Server ................................................................................................ 47
Preparing a Root Directory ............................................................................................ 47
Configuring an FTP server.............................................................................................. 48
Configuring an HTTP Server.............................................................................................. 50
Preparing a Root Directory ............................................................................................ 50
Configuring an HTTP Server .......................................................................................... 50
Configuring a DHCP server............................................................................................... 53
Customizing a Ring Tone Using Cool Edit Pro ................................................................. 61
Customizing a Logo File Using PictureExDemo .............................................................. 62
Description of Configuration Parameters in CFG Files .................................................. 63
Time Zones........................................................................................................................ 217
BLF LED Mode................................................................................................................... 220

Summary of Changes
v
This section describes the changes to this guide for each release and guide version.
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 217
BLF LED Mode on page 220
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 14
Description of Configuration Parameters in CFG Files on page 63
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 14
Customizing an LCD Logo on page 17
Customizing a Local Contact File on page 18
Description of Configuration Parameters in CFG Files on page 63
Major updates have occurred to the following section:
Customizing an LCD Logo on page 17

Yealink IP Phones Auto provisioning Guide
vi
Major updates have occurred to the following section:
Description of Configuration Parameters in CFG Files on page 63
The following sections are new for this version:
Encrypting Configuration Files on page 14
Update Mode on page 33
SIP NOTIFY Message on page 37
Resolving and Updating Configurations on page 39
Description of Configuration Parameters in CFG Files on page 63
Major updates have occurred to the following sections:
Customizing a Local Contact File on page 18
Customizing a Replace Rule File on page 21
Customizing a Dial-now File on page 22
The following sections are new for this version:
Customizing a Wallpaper on page 18
Customizing a Replace Rule File on page 21
Customizing a Dial-now File on page 22
Major updates have occurred to the following sections:
Customizing a Local Contact File on page 18
Upgrading Firmware on page 23

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-T21P
Yealink SIP-T20P
Yealink SIP-T19P
Yealink SIP-T46G
Yealink SIP-T42G
Yealink SIP-T41P
The auto provisioning process outlined in this guide applies to Yealink IP phones running
firmware V72 or later. We recommend that IP phones running firmware V72 or later
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-T21, SIP-T20 and SIP-T19 IP phones running firmware V72
or later, which are not PoE-compliant.

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.
The MAC-Oriented CFG file is only effectual for the specific phone. It uses 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 file name must be 0015651130F9.cfg.
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 of the hardware version
of the phone model (except 0 for SIP-T28P).
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-T21P
y000000000034.cfg
SIP-T20P
y000000000007.cfg
SIP-T19P
y000000000031.cfg
SIP-T46G
y000000000028.cfg
SIP-T42G
y000000000029.cfg

Yealink IP Phones Auto provisioning Guide
4
Phone Model
Common CFG File
SIP-T41P
y000000000036.cfg
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.
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 63.

Getting Started
5
Common CFG file contains configuration parameters which apply to phones with the
same model, such as language, volume.
The parameters commonly edited 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/T21P/T20P/T19P/T46G/T42G/T41P IP phones running firmware version
72 or later. For more information on configuration parameters, refer to
Yealink_SIP-T2_Series_T19P_T4_Series_IP_Phones_Auto_Provisioning_Guide . ##
######################################################
## Hostname ##
######################################################
network.dhcp_host_name =
######################################################
## PPPOE(Except SIP-T41P/T42G Models) ##
######################################################
network.pppoe.user =
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
network.pppoe.password =
######################################################
## PC Port(Only SIP-T28P/T26P/T22P/T20P Models support) ##
######################################################
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 =
network.ipv6_static_dns_enable =
##Only T41P/T42G/T46G Models support this parameter##
network.vlan.pc_port_mode =
######################################################
## 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 =

Getting Started
7
network.802_1x.root_cert_url =
network.802_1x.client_cert_url =
######################################################
## OpenVPN(Except SIP-T19P Model) ##
######################################################
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.

Yealink IP Phones Auto provisioning Guide
8
The parameters commonly edited 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/T21P/T20P/T19P/T46G/T42G/T41P IP phones running firmware version
72 or later. For more information on configuration parameters, refer to
Yealink_SIP-T2_Series_T19P_T4_Series_IP_Phones_Auto_Provisioning_Guide . ##
######################################################
## 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 =

Getting Started
9
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 =
######################################################
## Account2 Basic Settings (except SIP-T19P Model) ##
######################################################
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 (except SIP-T19P Model) ##
######################################################
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 =

Yealink IP Phones Auto provisioning Guide
10
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 =
######################################################
## Account3 Basic Settings (except SIP-T21P/T20P/T19P Models) ##
######################################################
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 (except SIP-T21P/T20P/T19P Models) ##
######################################################
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 =

Getting Started
11
account.3.sip_server.2.failback_timeout =
account.3.sip_server.2.register_on_enable =
######################################################
## Account4 Basic Settings (for SIP-T28P/T46G models) ##
######################################################
account.4.enable =
account.4.label =
account.4.display_name =
account.4.auth_name =
account.4.user_name =
account.4.password =
account.4.outbound_proxy_enable =
account.4.outbound_host =
account.4.outbound_port =
account.4.sip_listen_port =
account.4.transport =
######################################################
## Failback (for SIP-T28P/T46G models) ##
######################################################
account.4.reregister_enable =
account.4.naptr_build =
account.4.fallback.redundancy_type =
account.4.fallback.timeout =
account.4.sip_server.1.address =
account.4.sip_server.1.port =
account.4.sip_server.1.expires =
account.4.sip_server.1.retry_counts =
account.4.sip_server.1.failback_mode =
account.4.sip_server.1.failback_timeout =
account.4.sip_server.1.register_on_enable =
account.4.sip_server.2.address =
account.4.sip_server.2.port =
account.4.sip_server.2.expires =
account.4.sip_server.2.retry_counts =
account.4.sip_server.2.failback_mode =
account.4.sip_server.2.failback_timeout =
account.4.sip_server.2.register_on_enable =

Yealink IP Phones Auto provisioning Guide
12
######################################################
## Account5 Basic Settings (for SIP-T28P/T46G models) ##
######################################################
account.5.enable =
account.5.label =
account.5.display_name =
account.5.auth_name =
account.5.user_name =
account.5.password =
account.5.outbound_proxy_enable =
account.5.outbound_host =
account.5.outbound_port =
account.5.sip_listen_port =
account.5.transport =
######################################################
## Failback (for SIP-T28P/T46G models) ##
######################################################
account.5.reregister_enable =
account.5.naptr_build =
account.5.fallback.redundancy_type =
account.5.fallback.timeout =
account.5.sip_server.1.address =
account.5.sip_server.1.port =
account.5.sip_server.1.expires =
account.5.sip_server.1.retry_counts =
account.5.sip_server.1.failback_mode =
account.5.sip_server.1.failback_timeout =
account.5.sip_server.1.register_on_enable =
account.5.sip_server.2.address =
account.5.sip_server.2.port =
account.5.sip_server.2.expires =
account.5.sip_server.2.retry_counts =
account.5.sip_server.2.failback_mode =
account.5.sip_server.2.failback_timeout =
account.5.sip_server.2.register_on_enable =

Getting Started
13
######################################################
## Account6 Basic Settings (for SIP-T28P/T46G models) ##
######################################################
account.6.enable =
account.6.label =
account.6.display_name =
account.6.auth_name =
account.6.user_name =
account.6.password =
account.6.outbound_proxy_enable =
account.6.outbound_host =
account.6.outbound_port =
account.6.sip_listen_port =
account.6.transport =
######################################################
## Failback (for SIP-T28P/T46G models) ##
######################################################
account.6.reregister_enable =
account.6.naptr_build =
account.6.fallback.redundancy_type =
account.6.fallback.timeout =
account.6.sip_server.1.address =
account.6.sip_server.1.port =
account.6.sip_server.1.expires =
account.6.sip_server.1.retry_counts =
account.6.sip_server.1.failback_mode =
account.6.sip_server.1.failback_timeout =
account.6.sip_server.1.register_on_enable =
account.6.sip_server.2.address =
account.6.sip_server.2.port =
account.6.sip_server.2.expires =
account.6.sip_server.2.retry_counts =
account.6.sip_server.2.failback_mode =
account.6.sip_server.2.failback_timeout =
account.6.sip_server.2.register_on_enable =

Yealink IP Phones Auto provisioning Guide
14
To protect against unauthorized access and tampering of sensitive information (e.g.,
login password, registration information), you can encrypt configuration files using
Yealink Configuration Encryption Tool. AES keys must be 16 characters and the
supported characters contain: 0 ~ 9, A ~ Z, a ~ z. For more information on how to
encrypt configuration files, refer to Yealink Configuration Encryption Tool User Guide .
When configuring some particular features, you may need to upload resource files to IP
phones, such as personalized ring tone file, language package file and logo file. Yealink
provides some resource file templates for the particular features. Ask the distributor or
Yealink FAE for resource file templates. The following provides information on how to
customize resource files and specify the access URL for the resource files.
Yealink IP phones have built-in system ring tones. You can change the ring type, or
customize a ring tone and upload it to the phone via auto provisioning.
The following table lists the supported ring tone file format, one file size and total file
size for each phone model:
Phone Model
Ring Tone File
Format
One File Size
Total File Size
SIP-T28P/T26P/T22P/T20P
/T42G/T41P
.wav
<=100K
<=100K
SIP-T21P/T19P
.wav
<=100K
<=200K
SIP-T46G
.wav
<=8M
<=20M
The ring tone file must be PCMU audio format, mono channel, 8K sample rate and 16 bit
resolution.
####################################################
## Configure the access URL of the custom ring tone ##
####################################################
ringtone.url =
For example, enter “tftp://192.168.1.100/Ring1.wav” in the “ringtone.url =”field. During
the auto provisioning process, the phone connects to the provisioning server
“192.168.1.100”, and downloads the ring tone file “Ring1.wav”.