Yealink SIP-T2XP 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.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................................................................ 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................................................................................................ 4
Editing MAC-Oriented CFG File...................................................................................... 8
Encrypting Configuration Files ...................................................................................... 12
Customizing Resource Files............................................................................................ 12
Customizing a Ringtone .............................................................................................. 12
Customizing an LCD Language ................................................................................. 13
Customizing an LCD Logo........................................................................................... 13
Customizing a Wallpaper ........................................................................................... 15
Customizing a Screensaver........................................................................................ 15
Customizing a Local Contact File .............................................................................. 16
Customizing a Replace Rule File................................................................................ 18
Customizing a Dial-now File....................................................................................... 19
Updating Firmware ..................................................................................................... 20
Configuring a TFTP Server...................................................... 23
Preparing a Root Directory................................................................................................ 23
Configuring a TFTP Server................................................................................................. 24

Yealink IP Phones Auto provisioning Guide
iv
Obtaining the Address of Provisioning Server ...................... 25
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.
Documentations of the newly released SIP-T19P and SIP-T21P IP phones have also been
added.
Major updates have occurred to the following sections:
Editing Common CFG File on page 4
Editing MAC-Oriented CFG File on page 8
Encrypting Configuration Files on page 12
Customizing an LCD Logo on page 13
Customizing a Local Contact File on page 16
Description of Configuration Parameters in CFG Files on page 61
Major updates have occurred to the following sections:
Customizing an LCD Logo on page 13
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 12
Update Mode on page 31
SIP NOTIFY Message on page 35

Yealink IP Phones Auto provisioning Guide
vi
Resolving and Updating the Configurations on page 37
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 16
Customizing a Replace Rule File on page 18
Customizing a Dial-now File on page 19
The following sections are new for this version:
Customizing a Wallpaper on page 15
Customizing a Screensaver on page 15
Customizing a Replace Rule File on page 18
Customizing a Dial-now File on page 19
Major updates have occurred to the following sections:
Customizing a Local Contact File on page 16
Updating Firmware on page 20

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-T19(P)
Yealink SIP-T38G
Yealink SIP-T32G
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 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 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 SIP-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 IP Phones Auto provisioning 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 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 61.
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.

Getting Started
5
The parameters commonly edited in the Common CFG file are described as follows
(Take SIP-T2xP IP phones as examples):
####################################################
## 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.
#Require a reboot
network.pppoe.user =
network.pppoe.password =
#Enable or disable the PC port; 0-Disabled, 1-Auto Negotiation (default);
#Require a reboot
network.PC_port.enable =
#Configure the PC port type; 0-Router, 1-Bridge (default)
#Require a reboot
network.bridge_mode =
#Configure the IP address and mask when the PC port is configured as Router.
#Require a 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;

Yealink IP Phones Auto provisioning Guide
6
#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 =
#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 =

Getting Started
7
#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 SIP-T21P IP phones),
Turkish, Portuguese (not applicable to SIP-T21P IP phones), Spanish (not applicable to
SIP-T21P IP phones), Italian, French (not applicable to SIP-T21P IP phones) and German
lang.wui =
#Set the language used on the LCD screen
#The available values are: English (default), Chinese_S (only applicable to SIP-T21P IP
phones), Chinese_T (only applicable to SIP-T21P IP phones), German, French, Turkish,
Italian, Polish, Spanish and Portuguese
lang.gui =
#Enable or disable the IP phone to access its web user interface using the HTTP protocol;
#0-Disabled, 1-Enabled (default);
#Require a reboot
wui.http_enable =
#Set the HTTP port (80 by default)
#Require a 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 a reboot
wui.https_enable =
#Set the HTTPS port (443 by default)
#Require a 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 =

Yealink IP Phones Auto provisioning Guide
8
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 SIP-T2xP IP
phones as examples) 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 =

Getting Started
9
#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 (For SIP-T26P and SIP-T28P IP phones)
#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 =

Yealink IP Phones Auto provisioning Guide
10
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 SIP-T28P IP phones 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 SIP-T28P IP phones 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 =

Getting Started
11
#Configure the register user name
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 SIP-T28P IP phones 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 a reboot
network.internet_port.type =
#Configure the static IP address, submask, gateway address and DNS server address
for the phone
#Require a reboot
network.internet_port.ip =
network.internet_port.mask =
network.internet_port.gateway =
network.primary_ dns=
network.secondary_dns =

Yealink IP Phones Auto provisioning Guide
12
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 ringtone 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 ringtones. You can change the ring type, or
customize a ringtone and upload it to the phone via auto provisioning.
The ringtone file must be PCMU audio format, mono channel, 8K sample rate and 16 bit
resolution.
The ringtone file format must be *.wav.
The ringtone file uploaded must be within 100KB.
####################################################
## Configure the access URL of the customized ringtone ##
####################################################
ringtone.url =
For example, enter “tftp://192.168.1.100/Ring9.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 ringtone file “Ring9.wav”.
#ringtone.delete =http://localhost/all
#Delete all the custom ringtones
ringtone.delete =
For more information on customizing a ringtone file, refer to Customizing a Ringtone
Using Cool Edit Pro on page 59.

Getting Started
13
You can modify the language translation for the phone user interface, but you cannot
add new language to the phone. To modify the existing language translation, you need
to edit the language translation file, upload it to the provisioning server, and then
specify the access URL in the configuration file.
The following figure shows a portion of the English language translation file:
####################################################
## Configure the access URL of the LCD language file ##
####################################################
gui_lang.url =
For example, enter “tftp://192.168.1.100/lang+English.txt”in the “gui_lang.url = ”field.
During the auto provisioning process, the phone connects to the provisioning server
“192.168.1.100”, and downloads the language file “lang+English.txt”.
#gui_lang.delete = http://localhost/all
#Delete all custom languages
gui_lang.delete =
Yealink SIP-T2xP IP phones allow you to customize the logo displayed on the LCD screen.
SIP-T20P IP phones only support a text logo.
Available languages may vary between different firmware versions.
Do not rename the language file.

Yealink IP Phones Auto provisioning Guide
14
The following table lists the logo file format and resolution for each phone model:
Phone Model
Logo File Format
Resolution
SIP-T28P
.dob
<=236*82 2 gray scale
SIP-T26P
.dob
<=132*64 2 gray scale
SIP-T22P/T21P/T19P
.dob
<=132*64 2 gray scale
Ask the distributor or Yealink FAE for the logo file, or you can customize a *.dob logo file.
Upload the logo file to the provisioning server and then specify the access URL in the
configuration file:
####################################################
## Configure the access URL of the Logo File ##
####################################################
#(For SIP-T2xP IP phones except SIP-T20P IP phone)
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 phone connects to the provisioning server
“192.168.1.100”, and downloads the logo file “logo.dob”.
To use the custom logo for SIP-T2xP (except for SIP-T20P) and SIP-T19P IP phones, you also
need to configure the following parameter:
#Configure the logo mode (For SIP-T2xP and SIP-T19P IP phones except SIP-T20P IP
phones).
#0-Disabled (Except for SIP-T28P IP phones), 1-System logo, 2-Custom logo
phone_setting.lcd_logo.mode = 2
To configure a text logo for SIP-T20P IP phones, you need to configure the following
parameter:
#Enable or disable a text logo. 0-Disabled, 1-Enabled
phone_setting.lcd_logo.mode = 1
#Configure a text logo
phone_setting.lcd_logo.text =Yealink
After auto provisioning, you will find that the custom logo or text logo appears on the
LCD screen.
#lcd_logo.delete = =http://localhost/all
#Delete all custom logo files (not applicable to SIP-T20P IP phones)
lcd_logo.delete =
For more information on customizing a logo file, refer to Customizing a Logo File Using
PictureExDemo on page 60.