Yealink SIP-T2 Series User manual

Table of Contents
iii

Yealink IP Phones Auto Provisioning Guide

Table of Contents
iii
Table of Contents......................................................................iii
Summary of Changes............................................................... v
Changes for Release 70, Guide Version 70.50.................................................................. v
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................................................................................................ 4
Editing MAC-Oriented CFG File...................................................................................... 5
Encrypting Configuration Files ........................................................................................ 7
Customizing Resource Files.............................................................................................. 7
Configuring a TFTP Server...................................................... 15
Preparing a Root Directory................................................................................................ 15
Configuring a TFTP Server................................................................................................. 16
Obtaining the Provisioning Server Address .......................... 19
Zero Touch........................................................................................................................... 19
Plug and Play (PnP) Server ............................................................................................... 21
DHCP Options..................................................................................................................... 22
Phone Flash......................................................................................................................... 24
Configuring the Update Mode .............................................. 27
Power On............................................................................................................................. 27
Repeatedly.......................................................................................................................... 28
Weekly ................................................................................................................................. 29
Auto Provision Now ............................................................................................................ 30
Multi-mode Mixed ............................................................................................................. 31

Yealink IP Phones Auto Provisioning Guide
iv
Downloading and Verifying Configurations .......................... 33
Downloading Configuration Files..................................................................................... 33
Resolving and Updating Configurations ......................................................................... 33
Verifying Configurations .................................................................................................... 34
Troubleshooting ...................................................................... 35
Glossary.................................................................................. 37
Appendix ................................................................................ 39
Configuring an FTP Server ................................................................................................ 39
Preparing a Root Directory ............................................................................................ 39
Configuring an FTP Server ............................................................................................. 40
Configuring an HTTP Server.............................................................................................. 42
Preparing a Root Directory ............................................................................................ 42
Configuring an HTTP Server .......................................................................................... 43
Configuring a DHCP Server .............................................................................................. 46
Customizing a Ring Tone Using Cool Edit Pro ................................................................. 51
Customizing a Logo File Using PictureExDemo .............................................................. 53
Description of Configuration Parameters in CFG Files .................................................. 55
Time Zones........................................................................................................................ 140

Summary of Changes
v
This section describes the changes to this guide for each release and guide version.
Major update has occurred to the following section:
Description of Configuration Parameters in CFG Files on page 55

Yealink IP Phones Auto Provisioning Guide
vi

Introduction
1
Yealink IP phones with Lync firmware enable a new era in unified communications. It is
designed to work with Microsoft®Lync™ 2013.
Yealink IP phones with Lync firmware 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 to use the TFTP protocol by default.
The purpose of this guide is to serve as a basic guidance for provisioning Yealink IP
phones, including:
Yealink SIP-T48G
Yealink SIP-T22(P)
The auto provisioning process outlined in this guide applies to Yealink SIP-T48G/T22(P)
IP phones running firmware version 7 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.

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 IP phone tries to download these CFG files
from the server during auto provisioning.
The MAC-Oriented file is only effectual for the specific phone. It uses the 12-digit MAC
address of the IP phone as the file name. For example, if the MAC address of the IP
phone is 0015654D4405, the MAC-Oriented CFG file has to be named as
0015654d4405.cfg (case-sensitive). However, the Common CFG file is effectual for all
phones of the same model. It uses a fixed name “y0000000000XX.cfg”as the file name,
where "XX" equals to the first two digits of the hardware version of the IP phone model.
The names of the Common CFG file for the phone model is:
Phone Model
Common CFG File
SIP-T48G
y000000000035.cfg
SIP-T22(P)
y000000000005.cfg
The IP phones can only recognize configuration files using UTF-8 or ANSI encoding.
You can ask the distributor or Yealink FAE for Common CFG and MAC-Oriented files. You
can also obtain the Common CFG file and MAC-Oriented file online:
http://www.yealink.com/DocumentDownload.aspx?CateId=142&flag=142
To download Common CFG and MAC-Oriented files:
1. Go to Yealink Document Download Page and select the desired phone model under
the Documents and Downloads tab.
2. Download and uncompress the combined configuration files to your local system.

Yealink IP Phones Auto Provisioning Guide
4
3. Open the folder you uncompressed to and identify the files you will edit according
to the table introduced above.
Before beginning provisioning, you also need the IP phone information. For example,
MAC address and the hardware version of the IP phone.
MAC Address: The unique 12-digit serial number of the IP phone. You can obtain it from
the bar code on the back of the IP phone.
Hardware version: The current hardware version of the IP phone. You can view it via
phone user interface or web user interface.
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. Open each
configuration file with a text editor such as UltraEdit. For more information on
configuration parameters in configuration files, refer to Description of Configuration
Parameters in CFG Files on page 55.
Common CFG file contains configuration parameters which apply to phones with the
same model, such as language and ringtone.
The following figure shows a portion of the common CFG file:
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.

Getting Started
5
The partial parameters in the Common CFG file are described as follows:
####################################################
## Common CFG File ##
####################################################
#!version:1.0.0.1
######################################################
## Hostname ##
######################################################
network.dhcp_host_name =
######################################################
## PPPoE ##
######################################################
network.pppoe.user =
network.pppoe.password =
######################################################
## Network Advanced ##
######################################################
##It enables or disables the PC port.0-Disabled, 1-Auto Negotiation.
##The default value is 1.It takes effect after a reboot.
network.pc_port.enable =
##The default value is 0.It takes effect after a reboot.
network.internet_port.speed_duplex =
network.pc_port.speed_duplex =
##It enables or disables the phone to use manually configured static IPv4 DNS when
Internet (WAN) port type for IPv4 is configured as DHCP.
##0-Disabled (use the IPv4 DNS obtained by DHCP), 1-Enabled
##The default value is 0.It takes effect after a reboot.
network.static_dns_enable =
network.ipv6_static_dns_enable =
MAC-Oriented CFG file contains configuration parameters which are expected to be
updated per phone, such as time.

Yealink IP Phones Auto Provisioning Guide
6
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
######################################################
## Audio Codec ##
######################################################
account.1.codec.1.enable =
account.1.codec.1.payload_type =
account.1.codec.1.priority =
account.1.codec.1.rtpmap =
######################################################
## Advanced ##
######################################################
account.1.auto_answer =
account.1.missed_calllog =
######################################################
## Alert info ##
######################################################
account.1.ringtone.ring_type =

Getting Started
7
######################################################
## Time ##
######################################################
##It configures the time zone.
##The default value is +8.
local_time.time_zone =
##It configures the time zone name.
##The default time zone name is China(Beijing).
local_time.time_zone_name =
To protect against unauthorized access and tampering of sensitive information (e.g.,
login password), 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. The
following provides information on how to customize resource files and specify the
access URL for the resource files.

Yealink IP Phones Auto Provisioning Guide
8
For some features, you can customize the filename as required. The following table lists
the special characters supported by Yealink IP phones:
Server
HTTP/HTTPS
TFTP/FTP
Windows
Support: ~ ` ! @ $ ^ ( )
_ - , . ' ; [ ] { } (including
space)
Not Support: | < > : "
/ \ * ? # % & = +
Support: ~ ` ! @ $ ^ ( )
_ - , . ' ; [ ] { } % & = +
(including space)
Not Support: | < > : "
/ \ * ? #
Linux
Support: ~ ` ! @ $ ^ ( )
_ - , . ' ; [ ] { } | < > : "
(including space)
Not Support: / \ * ? #
% & = +
Support: ~ ` ! @ $ ^ ( )
_ - , . ' ; [ ] { } | < > : " %
& = + (including
space)
Not Support: / \ * ? #
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 IP phone via auto provisioning.
The ring tone file must meet the following:
Phone Model
File Format
Single File Size
Total Files Size
SIP-T48G
.wav
<=8MB
<=20MB
SIP-T22(P)
.wav
<=100KB
<=100KB
For more information on customizing a ring tone file, refer to Customizing a Ring Tone
Using Cool Edit Pro on page 51.
####################################################
## Configure the custom ring tone ##
####################################################
#Specify the access URL of the custom ring tone.
ringtone.url =
For example, enter “tftp://192.168.1.100/Customring.wav” in the “ringtone.url =” field.
During the auto provisioning process, the IP phone connects to the provisioning server
“192.168.1.100”, and downloads the ring tone file “Customring.wav”.
To use the custom ring tone for the IP phone, you also need to configure the following
The ring tone file must be PCMU audio format, mono channel, 8K sample rate and 16 bit
resolution.
Platform

Getting Started
9
parameter:
#Configure the custom ring tone (e.g., Customring.wav) for the IP phone.
phone_setting.ring_type = Customring.wav
To use the custom ring tone for the account, you also need to configure the following
parameter:
#Configure the custom ring tone (e.g., Customring.wav) for the account.
account.1.ringtone.ring_type = Customring.wav
#Delete all custom ring tones.
ringtone.delete = http://localhost/all
For more information on these parameters, refer to Description of Configuration
Parameters in CFG Files on page 55.
You can modify the existing language translation for phone user interface. You can also
add a new language (not included in the available language list) to SIP-T48G IP phones.
The following table lists available languages and the associated language files for
phone user interface:
Available Language
Associated Language File
for SIP-T48G
Associated Language
File for SIP-T22(P)
English
0.GUI.English.lang
lang+English.txt
Chinese Simplified
1.GUI.Chinese_S.lang
lang-Chinese_S.txt
Chinese Traditional
2.GUI.Chinese_T.lang
lang-Chinese_T.txt
French
3.GUI.French.lang
lang-French.txt
German
4.GUI.German.lang
lang-German.txt
Italian
5.GUI.Italian.lang
lang-Italian.txt
Polish
6.GUI.Polish.lang
lang-Polish.txt
Portuguese
7.GUI.Portuguese.lang
lang-Portuguese.txt
Spanish
8.GUI.Spanish.lang
lang-Spanish.txt
Turkish
9.GUI.Turkish.lang
lang-Turkish.txt
Korean
10.GUI.Korean.lang
lang-Korean.txt

Yealink IP Phones Auto Provisioning Guide
10
To customize a language file:
1. Open the desired language template file (e.g., lang+English.txt) using an ASCII
editor.
2. Modify the characters within the double quotation marks on the right of the equal
sign.
Don’t modify the translation item on the left of the equal sign.
The following figure shows a portion of the English language file (take SIP-T22P IP phones
for example):

Getting Started
11
####################################################
## Configure the custom LCD language file ##
####################################################
#Specify the access URL of the custom LCD language file.
gui_lang.url =
If you want to modify the existing language translation for the IP phone user interface,
edit the language translation and then configure the parameter “gui_lang.url =” in the
configuration file, for example:
gui_lang.url = tftp://192.168.1.100/lang+English.txt
During the auto provisioning process, the IP phone connects to the provisioning server
“192.168.1.100”, and downloads the language file “lang+English.txt”. The language
translation will be changed accordingly.
If you want to add a new language “Guilan”to your IP phone (only applicable to
SIP-T48G IP phones), prepare the language file named as 11.GUI.Guilan.lang for
downloading and configure the parameter “gui_lang.url =” in the configuration file, for
example:
gui_lang.url = tftp://192.168.1.100/11.GUI.Guilan.lang
During the auto provisioning process, the SIP-T48G IP phone connects to the provisioning
server “192.168.1.100”, and downloads the language file “11.GUI.Guilan.lang”. After
update, you will find a new language selection “Guilan”on the IP phone user interface:
Menu->Basic->Language.
To use the custom language for the IP phone, you also need to configure the following
parameter:
#Configure the custom language (e.g., English) for the phone user interface.
lang.gui = English
#Delete all custom languages.
gui_lang.delete = http://localhost/all
#Delete a custom language (e.g., lang+English.txt).
gui_lang.delete = http://localhost/lang+English.txt
For more information on these parameters, refer to Description of Configuration
Parameters in CFG Files on page 55.
For SIP-T48G IP phones, when adding a new language for the phone user interface,
the language file must be formatted as “X.GUI.name.lang” (X must start from 11.
“name” is replaced with the language name).
To modify translation of an existing language, do not rename the language file.
Available languages may vary between different firmware versions.

Yealink IP Phones Auto Provisioning Guide
12
Yealink IP phones allow you to customize the logo displayed on the LCD screen. Logo is
not applicable to SIP-T48G IP phones.
The following table lists the supported logo file format and resolution for SIP-T22(P) IP
phones:
Phone Model
Logo File Format
Resolution
SIP-T22(P)
.dob
<=132*64 2 gray scale
For more information on customizing a logo file, refer to Customizing a Logo File Using
PictureExDemo on page 53.
You can customize a *.dob logo file, upload the logo file to the provisioning server and
then specify the access URL in configuration files:
####################################################
## Configure the custom Logo File ##
####################################################
#Specify the access URL of the custom Logo File.
lcd_logo.url =
For example, enter “tftp://192.168.1.100/logo.dob” in the “lcd_logo.url =” field. During
the auto provisioning process, the IP phone connects to the provisioning server
“192.168.1.100”, and downloads the logo file “logo.dob”.
To use the custom logo, you also need to configure the following parameter:
#Configure the logo mode.
#0-Off, 1-System logo, 2-Custom logo
phone_setting.lcd_logo.mode = 2
After auto provisioning, you will find that the custom logo or text logo appears on the
LCD screen.
#Delete all custom logo files.
lcd_logo.delete = http://localhost/all
For more information on these parameters, refer to Description of Configuration
Parameters in CFG Files on page 55.
Yealink IP phones allow you to upgrade firmware manually via web user interface, or
upgrade firmware in batch via auto provisioning.
The following table lists the firmware name for the phone model (X is replaced by the
actual firmware version):

Getting Started
13
Phone Model
Firmware Name
SIP-T48G
35.x.x.x.rom
SIP-T22(P)
7.x.x.x.rom
To upgrade the IP phones’firmware in batch via auto provisioning, ask the distributor for
the firmware file, upload it to the provisioning server, and then specify the access URL in
configuration files.
##Specify the access URL of the firmware file.
firmware.url =
For example, enter “tftp://admin:[email protected]/7.7.0.50.rom”(“admin”is
replaced by the authentication user name and “password”is replaced by the
authentication password) in the “firmware.url =” field. During the auto provisioning
process, the IP phone connects to the provisioning server “192.168.1.100”, and
downloads the firmware file “7.7.0.50.rom”.
For more information on the parameter, refer to Description of Configuration Parameters
in CFG Files on page 55.
In addition to upgrading firmware manually via web user interface, or upgrading
firmware via auto provisioning, you can also upgrade firmware from lync server. For
more information, refer to Updating Lync Phone Firmware from Microsoft Lync Server.

Yealink IP Phones Auto Provisioning Guide
14