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 71, Guide Version 71.126................................................................ v
Changes for Release 71, Guide Version 71.125................................................................ v
Changes for Release 71, Guide Version 71.120................................................................ v
Changes for Release 71, Guide Version 71.110................................................................ v
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...................................................................................... 9
Encrypting Configuration Files ...................................................................................... 13
Customizing Resource Files............................................................................................ 13
Customizing a Ringtone .............................................................................................. 13
Customizing an LCD Language ................................................................................. 14
Customizing an LCD Logo........................................................................................... 14
Customizing a Wallpaper ........................................................................................... 16
Customizing a Screensaver........................................................................................ 16
Customizing a Local Contact File .............................................................................. 17
Customizing a Replace Rule File................................................................................ 19
Customizing a Dial-now File....................................................................................... 20
Updating Firmware ..................................................................................................... 21
Configuring a TFTP Server...................................................... 23
Preparing a Root Directory................................................................................................ 23
Configuring a TFTP Server................................................................................................. 24
Obtaining the Address of Provisioning Server ...................... 25

Yealink Auto provisioning User Guide
iv
Zero Touch........................................................................................................................... 25
Plug and Play (PnP) Server ............................................................................................... 27
DHCP Options..................................................................................................................... 28
Phone Flash......................................................................................................................... 29
Update Mode......................................................................... 31
Power On............................................................................................................................. 31
Repeatedly.......................................................................................................................... 32
Weekly................................................................................................................................. 33
Auto Provision Now ............................................................................................................ 34
Multi-mode Mixed ............................................................................................................. 35
SIP NOTIFY Message ......................................................................................................... 35
Downloading and Verifying Configurations .......................... 37
Downloading Configuration Files..................................................................................... 37
Resolving and Updating the Configurations .................................................................. 37
Verifying Configurations .................................................................................................... 38
Troubleshooting ...................................................................... 41
Glossary.................................................................................. 43
Appendix ................................................................................ 45
Configuring an FTP Server ................................................................................................ 45
Preparing a Root Directory ............................................................................................ 45
Configuring an FTP server.............................................................................................. 46
Configuring an HTTP Server.............................................................................................. 48
Preparing a Root Directory ............................................................................................ 48
Configuring an HTTP Server .......................................................................................... 48
Configuring a DHCP server............................................................................................... 51
Customizing a Ringtone Using Cool Edit Pro .................................................................. 59
Customizing a Logo File Using PictureExDemo .............................................................. 60
Description of Configuration Parameters in CFG Files .................................................. 61

Summary of Changes
v
This section describes the changes to this guide for each release and guide version.
Major updates have occurred to the following sections:
Customizing a Local Contact File on page 17
Description of Configuration Parameters in CFG Files on page 61
Major updates have occurred to the following sections:
Editing Common CFG File on page 5
Editing MAC-Oriented CFG File on page 9
Documentation of the newly released SIP-T19P and SIP-T21P IP phones has also been
added.
Major updates have occurred to the following sections:
Customizing an LCD Logo on page 14
Major updates have occurred to the following sections:
Description of Configuration Parameters in CFG Files on page 61
The following sections are new for this version:
Encrypting Configuration Files on page 13
Update Mode on page 31
SIP NOTIFY Message on page 35
Resolving and Updating the Configurations on page 37

Yealink Auto provisioning User Guide
vi
Description of Configuration Parameters in CFG Files on page 61
Major updates have occurred to the following sections:
Customizing a Local Contact File on page 17
Customizing a Replace Rule File on page 19
Customizing a Dial-now File on page 20
The following sections are new for this version:
Customizing a Wallpaper on page 16
Customizing a Screensaver on page 16
Customizing a Replace Rule File on page 19
Customizing a Dial-now File on page 20
Major updates have occurred to the following sections:
Customizing a Local Contact File on page 17
Updating Firmware on page 21

Summary of Changes
vii

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-T28(P)
Yealink SIP-T26(P)
Yealink SIP-T22(P)
Yealink SIP-T21(P)
Yealink SIP-T20(P)
Yealink SIP-T38G
Yealink SIP-T32G
Yealink SIP-T19(P)
Yealink VP530
The auto provisioning process outlined in this guide applies to Yealink IP phones running
firmware V71 or later. We recommend that Yealink IP phones running firmware V71 or later
CANNOT be downgraded to the earlier firmware version. If your phones are running a
firmware version earlier than 71, please contact your system administrator for help.

Yealink Auto provisioning User 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 2
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”as the file name, where "XX" equals to the
hardware version of the phone model, except 00 for T28(P).
The names of the Common CFG file for each phone model are:
Phone Model
Common CFG File
SIP-T28(P)
y000000000000.cfg
SIP-T26(P)
y000000000004.cfg
SIP-T22(P)
y000000000005.cfg
SIP-T21(P)
y000000000034.cfg
SIP-T20(P)
y000000000007.cfg
SIP-T38G
y000000000038.cfg
SIP-T32G
y000000000032.cfg
SIP-T19(P)
y000000000031.cfg
VP530
y000000000023.cfg

Yealink Auto provisioning User Guide
4
You can ask the distributor or Yealink FAE for configuration files. The IP phones running
firmware version 71 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 address of the registration 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 61.

Getting Started
5
Common CFG file contains configuration parameters which apply to phones with the
same model, such as language, time and date.
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.
The parameters commonly edited in the Common CFG file are described as follows
(Take T2xP IP phones as an example):
####################################################
## Common CFG File ##
####################################################
#!version:1.0.0.1
##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. ##
#Configure the transmission mode and the speed of the WAN port.
#0-Auto negotiate (default), 1-Full duplex 10Mbps, 2-Full duplex 100Mbps, 3-Half
duplex 10Mbps, 4-Half duplex 100Mbps;
network.internet_port.speed_duplex =
#Configure the user name and password for PPPoE connection.

Yealink Auto provisioning User Guide
6
#Require reboot
network.pppoe.user =
network.pppoe.password =
#Enable or disable the PC port; 0-Disabled, 1-Auto-Negotiation (default);
#Require reboot
network.PC_port.enable =
#Configure the PC port type; 0-Router, 1-Bridge (default)
#Require reboot
network.bridge_mode =
#Configure the IP address and mask when the PC port is configured as Router.
#Require reboot
network.pc_port.ip =
network.pc_port.mask =
network.pc_port.speed_duplex =
network.pc_port.dhcp_server =
network.dchp.start_ip =
network.dchp.end_ip =
#Enable or disable Plug and Play feature; 0-Disabled, 1-Enabled (default)
auto_provision.pnp_enable = 1
#Configure the domain name of the PnP server.
auto_provision.pnp_domain_name =
#Configure the auto provision mode;
#0-Disabled, 1-Power on (default), 4-Repeatedly, 5-Weekly, 6-Power on + Repeatedly,
7-Power on + Weekly;
auto_provision.mode =
#Configure the interval (in minutes) for the phone to check new configuration files. It
ranges from 1 to 43200, the default value is 1440.
#It is only applicable to "Repeatedly" and "Power on + Repeatedly" modes.
auto_provision.schedule.periodic_minute =
#Configure the start time of the day for the phone to check new configuration files. The
default value is 00:00.
#It is only applicable to "Weekly" and "Power on + Weekly" modes.
#If the desired start time of the day is seven forty-five a.m., the value format is 07:45.
auto_provision.schedule.time_from =

Getting Started
7
#Configure the end time of the day for the phone to check new configuration files. The
default time is 00:00.
#It is only applicable to "Weekly" and "Power on + Weekly" modes.
#If the desired end time of the day is seven forty-five p.m., the value format is 19:45.
auto_provision.schedule.time_to =
#Configure the day of week for the phone to check new configuration files. The default
value is 0123456.
#0-Sunday,1-Monday,2-Tuesday,3-Wednesday,4-Thursday,5-Friday,6-Saturday;
#It is only applicable to "Weekly" and "Power on + Weekly" modes.
#If the desired day of the week is Monday, Tuesday and Wednesday, the value format
#is 012.
auto_provision.schedule.dayofweek =
#Configure the URL of the auto provisioning server.
auto_provision.server.url =
#Configure the user name and password for authentication.
auto_provision.server.username =
auto_provision.server.password =
#Enable or disable DHCP option mode; 0-Disabled, 1-Enabled (default);
auto_provision.dhcp_enable =
#Configure the value (manufacturer of the device) of DHCP option 60.
auto_provision.dhcp_option.option60_value =
#Configure the custom DHCP option value. It ranges from 128 to 254.
auto_provision.dhcp_option.list_user_options =
#Set the AES key used for decrypting the Common CFG file
auto_provision.aes_key_16.com =
#Set the AES key used for decrypting MAC-Oriented CFG file
auto_provision.aes_key_16.mac =
#Set the language used on the web page
#The available values are: English, Chinese_S (only applicable to the T21P IP phone),
Turkish, Portuguese (not applicable to the T21P IP phone), Spanish (not applicable to
T21P IP phones), Italian, French (not applicable to the T21P IP phone) and German
lang.wui =
#Set the language used on the LCD screen

Yealink Auto provisioning User Guide
8
#The available values are: English (default), Chinese_S (only applicable to the T21P IP
phone), Chinese_T (only applicable to the T21P IP phone), German, French, Turkish,
Italian, Polish, Spanish and Portuguese
lang.gui = English
#Enable or disable the IP phone to access its web user interface using the HTTP protocol;
#0-Disabled, 1-Enabled (default);
#Require reboot
wui.http_enable =
#Set the HTTP port (80 by default)
#Require reboot
network.port.http =
# Enable or disable the IP phone to access its web user interface using the HTTPS
protocol;
#0-Disabled, 1-Enabled (default);
#Require reboot
wui.https_enable =
#Set the HTTPS port (443 by default)
#Require reboot
network.port.https =
#Set a new password for the user, var and administrator;
#The value format is user name:new password.
security.user_password =

Getting Started
9
MAC-Oriented CFG file contains configuration parameters which are expected to be
updated per phone, such as the registration information.
The parameters commonly edited in the MAC-Oriented CFG file (Take T2xP IP phones
as an example) are described as follows:
####################################################
## MAC-Oriented CFG File ##
####################################################
#!version:1.0.0.1
##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. ##
#Account1 settings
#Enable or disable the account1, 0-Disabled (Default), 1-Enabled
account. 1. enable =
#Configure the label displayed on the LCD screen for account1
account.1.label =
#Configure the display name of account1
account.1.display_name =

Yealink Auto provisioning User Guide
10
#Configure the user name and password for register authentication
account.1.auth_name =
account.1.password =
#Configure the register user name
account.1.user_name =
#Configure the SIP server address and port (5060 by default)
account.1.sip_server.1.address =
account.1.sip_server.1.port =
account.1.sip_server.2.address =
account.1.sip_server.2.port =
# Account2 settings
#Enable or disable the account2, 0-Disabled (Default), 1-Enabled
account.2.enable =
#Configure the label displayed on the LCD screen for account2
account.2.label =
#Configure the display name of account2
account.2.display_name =
#Configure the user name and password for register authentication
account.2.auth_name =
account.2.password =
#Configure the register user name
account.2.user_name =
#Configure the SIP server address and port (5060 by default)
account.2.sip_server.1.address =
account.2.sip_server.1.port =
account.2.sip_server.2.address =
account.2.sip_server.2.port =
# Account3 settings (Except for the T20P IP phone)
#Enable or disable the account3, 0-Disabled (Default), 1-Enabled
account.3.enable =
#Configure the label displayed on the LCD screen for account3
account.3.label =
#Configure the display name of account3
account.3.display_name =
#Configure the user name and password for register authentication
account.3.auth_name =

Getting Started
11
account.3.password =
#Configure the register user name
account.3.user_name =
#Configure the SIP server address and port (5060 by default)
account.3.sip_server.1.address =
account.3.sip_server.1.port =
account.3.sip_server.2.address =
account.3.sip_server.2.port =
# Account4 settings (For the T28P IP phone only)
#Enable or disable the account4, 0-Disabled (Default), 1-Enabled
account.4.enable =
#Configure the label displayed on the LCD screen for account4
account.4.label =
#Configure the display name of account4
account.4.display_name =
#Configure the user name and password for register authentication
account.4.auth_name =
account.4.password =
#Configure the register user name
account.4.user_name =
#Configure the SIP server address and port (5060 by default)
account.4.sip_server.1.address =
account.4.sip_server.1.port =
account.4.sip_server.2.address =
account.4.sip_server.2.port =
# Account5 settings (For the T28P IP phone only)
#Enable or disable the account5, 0-Disabled (Default) 1-Enabled
account.5.enable =
# Configure the label displayed on the LCD screen for account5
account.5.label =
#Configure the display name of account5
account.5.display_name =
#Configure the user name and password for register authentication
account.5.auth_name =
account.5.password =
#Configure the register user name

Yealink Auto provisioning User Guide
12
account.5.user_name =
#Configure the SIP server address and port (5060 by default)
account.5.sip_server.1.address =
account.5.sip_server.1.port =
account.5.sip_server.2.address =
account.5.sip_server.2.port =
# Account6 settings (For the T28P IP phone only)
#Enable or disable the account6, 0-Disabled (Default), 1-Enabled
account.6.enable =
#Configure the label displayed on the LCD screen for account6
account.6.label =
#Configure the display name of account6
account.6.display_name =
#Configure the user name and password for register authentication
account.6.auth_name =
account.6.password =
#Configure the register user name
account.6.user_name =
#Configure the SIP server address and port (5060 by default)
account.6.sip_server.1.address =
account.6.sip_server.1.port =
account.6.sip_server.2.address =
account.6.sip_server.2.port =
#Configure the WAN port type; 0-DHCP (default), 1-PPPoE, 2-Static IP Address
#Require reboot
network.internet_port.type =
#Configure the static IP address, submask, gateway address and DNS server address
for the phone
#Require reboot
network.internet_port.ip =
network.internet_port.mask =
network.internet_port.gateway =
network.primary_ dns=
network.secondary_dns =