Yealink Yealink SIP-T28P User manual

Table of Contents
i

Yealink Auto provisioning User Guide
ii

Table of Contents
iii
Table of Contents
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....................................................................................... 7
Customizing Resource Files ............................................................................................ 10
Customizing a Ringtone ...................................................................................................................10
Customizing a LCD Language ........................................................................................................11
Customizing a LCD Logo..................................................................................................................12
Uploading Local Contacts............................................................................................................... 13
Updating Firmware ........................................................................................................................... 13
Configuring a TFTP Server ...................................................... 15
Preparing a Root Directory.............................................................................................. 15
Configuring a TFTP Server.................................................................................................16
Obtaining the Address of Provisioning Server ..................... 17
Zero-Sp-Touch.................................................................................................................... 17
Plug and Play (PNP) Server .............................................................................................. 19
DHCP Options.................................................................................................................... 20
Phone Flash ....................................................................................................................... 21
Downloading and Verifying Configurations ........................ 23
Downloading Configuration Files.................................................................................... 23
Ver ifyin g Configurations ................................................................................................... 23
Troubleshooting ...................................................................... 25
Glossary .................................................................................. 27
Appendix ................................................................................ 30

Yealink Auto provisioning User Guide
iv
Configuring a FTP Server .................................................................................................. 30
Preparing a Root Directory.......................................................................................... 30
Configuring a FTP server .............................................................................................. 31
Configuring a HTTP Server ................................................................................................ 33
Preparing a Root Directory.......................................................................................... 33
Configuring a HTTP Server............................................................................................ 33
Configuring a DHCP server.............................................................................................. 36
Customizing a Ringtone Using CoolEdit Pro .................................................................. 44
Customizing a Logo File Using PictureExDemo.............................................................. 45

Introduction
1
Introduction
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 shows you how to provision Yealink IP phones with the minimum settings
required. Yealink IP phones support the FTP, TFTP, HTTP, and HTTPS protocols for file
provisioning and are configured by default to use Trivial File Transfer Protocol (TFTP).
The purpose of this guide is to serve as a basic guidance for auto provisioning Yealink IP
phones, including:
!Yealink SIP-T28(P)
!Yealink SIP-T26(P)
!Yealink SIP-T22(P)
!Yealink SIP-T20(P)
!Yealink SIP-T18(P)
!Yealink SIP-T12(P)
!Yealink SIP-T38(G)
!Yealink SIP-T32(G)
!Yealink VP530
The provisioning process outlined in this document applies to the firmware V70 or higher
version of Yealink IP phones.

Yealink Auto provisioning User Guide
2

Getting Started
3
Getting Started
This section shows you how to get ready for the provisioning. The provisioning process
discussed in this guide uses TFTP and a personal computer (PC) as the provisioning server.
To begin the provisioning process, the following are required:
!Obtaining Configuration Information
!Managing Configuration Files
Obtaining Configuration Information
Obtaining Configuration Files
Before you begin provisioning, you need to obtain the configuration files. There are 2
configuration files both of which are CFG formatted that the phone will try to download
from the server during provisioning. We call them Common CFG file and MAC-Oriented
CFG file.
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, then 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 0 for T28 which is special.
The names of the Common CFG file for each phone model are:
Phone Model
Common Configuration File
SIP-T28(P)
y000000000000.cfg
SIP-T26(P)
y000000000004.cfg
SIP-T22(P)
y000000000005.cfg
SIP-T20(P)
y000000000007.cfg
SIP-T12(P)
y000000000008cfg
SIP-T18(P)
y000000000009.cfg
SIP-T38G
y000000000038.cfg
SIP-T32G
y000000000032.cfg
VP530
y000000000023.cfg
You can ask the distributor or the Yealink FAE for configuration files.

Yealink Auto provisioning User Guide
4
Obtaining Phone Information
Before you begin the provisioning, you will also need the phone information. For example,
MAC address and the SIP account of the phone.
MAC Address: The unique 12-digit serial number of the phone. You can obtain it from the
phone’s bar code at the back of the phone.
SIP Account: This may includes SIP credentials such as user name, password and the
address of the phone’s registration server. Ask your system administrator for SIP account
information you need. Although SIP accounts may not be required to get the phone
working, we strongly recommend using them.
Managing Configuration Files
Auto provisioning enables Yealink IP phones to update automatically via downloading
the Common CFG file and MAC-Oriented CFG file. Before provisioning you may need to
edit and customize your configuration files.
Editing Common CFG File
Common CFG file contains configuration parameters which apply to all phones of the
same phone model, such as the language displays on the phone LCD screen.
The line beginning with “#” is considered to be a comment.

Getting Started
5
The parameters commonly edited in the Common CFG file (T2xP as an example) are
detailed as following:
####################################################
## Common CFG File ##
####################################################
#!version:1.0.0.1
##File header "#!version:1.0.0.1" cannot be edited or deleted.##
#Configure the WAN port type; 0-DHCP(default), 1-PPPoE, 2-Static IP Address
#Require reboot
network.internet_port.type = 0
#Configure the static IP address, submask, gateway and DNS server for the phone
#Require reboot
network.internet_port.ip = 192.168.1.10
network.internet_port.mask = 255.255.255.0
network.internet_port.gateway =192.168.1.1
network.primary_ dns= 202.101.103.55
network.secondary_dns = 202.101.103.54
#Configure the PC port type;0-Router,1-Bridge(default)
#Require reboot
network.bridge_mode = 1
#LAN port as Router settings
#Require reboot
network.pc_port.ip = 10.0.0.1
network.pc_port.mask = 255.255.255.0
network.pc_port.speed_duplex = 0
network.pc_port.dhcp_server = 1
network.dchp.start_ip = 10.0.0.10
network.dchp.end_ip = 10.0.0.100
#Enable or disable the Plug and Play feature; 0-Disabled, 1-Enabled (default)
auto_provision.pnp_enable = 1
#Set the auto provisioning mode (0-Disabled (default), 1-Power on, 4-Repeatedly,
#5-Weekly, Power on + Repeatedly, Power on + Weekly)
auto_provision.mode = 1
auto_provision.power_on_enable = 1
auto_provision.repeat.enable = 0

Yealink Auto provisioning User Guide
6
auto_provision.repeat.minutes = 1440
auto_provision.schedule.periodic_minute = 1
auto_provision.schedule.time_from = 00:00
auto_provision.schedule.time_to = 00:00
auto_provision.schedule.dayofweek = 0123456
auto_provision.server.url =
auto_provision.server.username =
auto_provision.server.password =
auto_provision.weekly.enalbe = 0
auto_provision.weekly.mask = 0123456
auto_provision.weekly.begin_time = 00:00
auto_provision.weekly.end_time = 00:00
#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, Turkish, Portuguese, Spanish, Italian,
#French, Russian, Deutsch and Czech
lang.wui =
#Set the language used on the phone LCD screen
#The available values are: English (default), Chinese_S, Chinese_T, German, French,
#Turkish, Italiano, Polish, Spanish and Portuguese
lang.gui = English
#Set the web server access type (0-Disabled, 1-HTTP&HTTPS (default), 2-HTTP only,
#3-HTTPS only)
#Require reboot
network.web_server_type = 1
#Set the HTTP port (80 by default)
#Require reboot
network.port.http = 80
#Set the HTTPS port (443 by default)
#Require reboot
network.port.https = 443

Getting Started
7
#Set the new password (admin123) for the administrator
security.user_password = admin:admin123
#Set the new password (user123) for the user
security.user_password =user:user123
Editing MAC-Oriented CFG File
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 are detailed as following:
####################################################
## MAC-Oriented CFG File ##
####################################################
#!version:1.0.0.1
#File header "#!version:1.0.0.1" cannot be edited or deleted.##
#Line1 settings
#Activate/Deactivate the account1, 0-Disabled (Default), 1-Enabled
account.1.enable = 0
#Configure the label of account1 which will display on the LCD screen
account.1.label =
#Configure the display name of account1
account.1.display_name =

Yealink Auto provisioning User Guide
8
#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_host =
account.1.sip_server_port = 5060
#Line2 settings
#Activate/Deactivate account2, 0-Disabled(Default), 1-Enabled
account.2.enable = 0
#Configure the label of account2 which will display on the LCD screen
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_host =
account.2.sip_server_port = 5060
#Line3 settings
#Activate/Deactivate the account3, 0-Disabled(Default), 1-Enabled
account.3.enable = 0
#Configure the label of account3 which will display on the LCD screen
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 =
account.3.password =
#Configure the register user name
account.3.user_name =
#Configure the SIP server address and port (5060 by default)

Getting Started
9
account.3.sip_server_host =
account.3.sip_server_port = 5060
#Line4 settings (For T28P, T38G and VP phone only)
#Activate/Deactivate the account4, 0-Disabled(Default), 1-Enabled
account.4.enable = 0
#Configure the label of account4 which will display on the LCD screen
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_host =
account.4.sip_server_port = 5060
#Line5 settings (For T28P and T38G only)
#Activate/Deactivate account5, 0-Disabled(Default) 1-Enabled
account.5.enable = 0
#Configure the label of account5 which will display on the LCD screen
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
account.5.user_name =
#Configure the SIP server address and port (5060 by default)
account.5.sip_server_host =
account.5.sip_server_port = 5060
#Line6 settings (For T28P and T38G only)
#Activate/Deactivate the account6, 0-Disabled(Default), 1-Enabled
account.6.enable = 0
#Configure the label of account6 which will display on the LCD screen.

Yealink Auto provisioning User Guide
10
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_host =
account.6.sip_server_port = 5060
Customizing Resource Files
You can configure the phone features via the parameters in the configuration files. You
can also customize your phone with a personalized ringtone, language or logo.
Customizing a Ringtone
Yealink IP phones have built-in system ringtones and the default ring type is Ring1. You can
change the ring type, or you can customize your personal ringtone and make it take
effect via auto provisioning.
The ringtone file must use PCMU audio format, mono channel, 8K sample rate and 16 bit
resolution.
The ringtone file format must be .wav.
All ringtone files uploaded must be within 100KB.
####################################################
## Configure the access URL of the customizing ringtone ##
####################################################
ringtone.url =
#ringtone.delete =http://localhost/all
#Delete all the custom ringtones uploaded through auto provision
ringtone.delete =
For example: enter “ftp://192.168.1.100/Ring9.wav” in the “ringtone.url =” field. During the
auto provisioning process, the phone links to the provisioning server “192.168.1.100”, and
downloads the ringtone file “Ring9.wav”.
You’d better check that the ringtone file has been uploaded to the root directory of the
server before provisioning.
For more information about customizing a ringtone file, you can refer to the Customizing a

Getting Started
11
Ringtone Using CoolEdit Pro in this guide.
Customizing a LCD Language
Yealink IP phones allow you to modify the translation of the existing languages on the LCD
screen, but you cannot add new language to the phone. To modify the existing
language, you need to edit the language file and upload it to the root directory of the
provisioning server, then specify the access URL in the configuration file.
The following figure shows a portion of the language file:
####################################################
## Configure the access URL of the LCD language file ##
####################################################
gui_lang.url =
#gui_lang.delete = =http://localhost/all
#Delete all custom languages downloaded through auto provision
gui_lang.delete =
For example: enter “ftp://192.168.1.100/lang+English.txt” in the “gui_lang.url = ” field.
During the auto provisioning process, the phone links to the provisioning server
“192.168.1.100”, and download the language file “lang+English.txt”.
Available languages may be different between different firmware versions. Ask the
distributor for the language template file.

Yealink Auto provisioning User Guide
12
Customizing a LCD Logo
Yealink SIP-T2xP/T1xP IP phones allow you to customize the logo displayed on the phone
LCD screen (The SIP-T20P IP phone only supports displaying the text logo). Ask the
distributor for the logo file, or you can customize a .dob logo file. Upload the logo file to
the root directory of the provisioning server and then specify the access URL in the
configuration file:
####################################################
## Configure the access URL of the Logo File ##
####################################################
#(SIP-T2xP/T1xP only, not applicable to T20P)
lcd_logo.url =
#lcd_logo.delete = =http://localhost/all
#Delete all custom logo files
lcd_logo.delete =
For example: enter “ftp://192.168.1.100/ logo.dob” in the “lcd_logo.url =” field. During the
auto provisioning process, the phone links to the provisioning server “192.168.1.100”, and
downloads the logo file “logo.dob”.
The following table lists the logo file format 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
.dob
<=132*64 2 gray scale
SIP-T18P
.dob
<=132*64 2 gray scale
SIP-T12P
.dob
<=132*64 2 gray scale
Upload the logo file to the root directory of the provisioning server. After provisioning, the
phone boots up, and you will then find that the customized logo displays on the phone
LCD screen.
For more information about customizing a Logo file, refer to Customizing a Logo File Using
PictureExDemo in this guide.

Getting Started
13
Uploading Local Contacts
Yealink IP phones allow you to batch upload contact data by auto provisioning. Edit the
contactData.xml file, upload the file to the root directory of the provisioning server and
then specify the access URL in the configuration file.
The following shows an example of the contactData.xml file:
<contactData>
<group>
<contact sDisplayName="Mary" sOfficeNumber="1234" sMobilNumber="12345678901"
sOtherNumber="2231" sLine="0" sRing="Auto"/>
<contact sDisplayName="Damy" sOfficeNumber="1235"
sMobilNumber="12345678902" sOtherNumber="2232" sLine="0" sRing="Auto"/>
<contact sDisplayName="John" sOfficeNumber="1236" sMobilNumber="12345678903"
sOtherNumber="2233" sLine="0" sRing="Auto"/>
</group>
<blacklist>
<contact sDisplayName="Mili" sOfficeNumber="7788" sMobilNumber="44444444444"
sOtherNumber="2222" sLine="0" sRing="Auto"/>
</blacklist>
</contactData>
####################################################
## Upload local contact file ##
####################################################
local_contact.data.url =
For example: enter “ftp://192.168.1.100/ ContactData.xml” in the “local_contact.data.url
=” field. During the auto provisioning process, the phone links to the provisioning server
“192.168.1.100”, and download the contact file “ContactData.xml”.
Yealink IP phones support both the .xml and .csv formats.
Updating Firmware
Yealink IP Phones allow you to update the firmware manually via web user interface, or
batch update the firmware via the auto provisioning. To batch update the phones’
firmware via auto provisioning, ask the distributor for the firmware file, upload it to the root
directory of the provisioning server, and then specify the access URL in the configuration
files.
######################################################

Yealink Auto provisioning User Guide
14
## Configure the access URL of the firmware file ##
######################################################
firmware.url =
For example: enter “ftp://admin:[email protected]/2.61.0.80.rom” in the
“firmware.url =” field. During the auto provisioning process, the phone links to the
provisioning server “192.168.1.100” (“admin” as the authentication user name and
“password” as the authentication password), and download the firmware file
2.61.0.80.rom.

Configuring a TFTP Server
15
Configuring a TFTP Server
Yealink IP Phones support using the FTP, TFTP, HTTP and HTTPS protocols to download the
configuration files. TFTP server is used by default. You can use any protocol for provisioning.
The following section takes the TFTP server as an example.
We recommend that you can use 3CDaemon or TFTP32 tool as a TFTP server. 3CDaemo
and TFTPD32 are free applications for Windows. You can download the 3CDaemon
software at: http://www.oldversion.com/3Com-Daemon.html and TFTP32 at:
http://tftpd32.jounin.net/.
We provide a simple instruction of configuring a TFTP server using 3CDaemon tool in the
Configuring a FTP server section.
Preparing a Root Directory
To prepare a root directory:
1. Create a root TFTP directory on the local computer.
2. Store the configuration files to this root directory.
3. Set the security permissions for the TFTP directory folder.
4. You need to define a user or a group name, and set the permissions: read, write,
and modify files. Security permissions vary by organization.
An example of using the Windows platform is shown as below:

Yealink Auto provisioning User Guide
16
Configuring a TFTP Server
If you have a 3CDaemon application installed on your computer, use it directly. Otherwise,
download and install it.
To configure a TFTP server:
1. Double click the 3CDaemon.exe to start the application. A configuration page
shows as below:
2. Select Configure TFTP Server. Click the button to locate the TFTP root directory
on the computer:
3. Click the Confirm button to finish configuring the TFTP server. The server URL
“tftp://IP/” (Here “IP” means the IP address of the provisioning server, for
example, ”tftp://192.168.1.100/”) is capable of TFTP downloading.