Yealink SIP-T19P, Yealink SIP-T26P, SIP-T4 Series, Yealink SIP-T28P, Yealink SIP-T22P Auto Provisioning Manual

...
Table of Contents
i
Table of Contents
iii
Changes for Release 72, Guide Version 72.25 ................................................................. vii
Changes for Release 72, Guide Version 72.2 ................................................................... vii
Changes for Release 72, Guide Version 72.1 ................................................................... vii
Changes for Release 71, Guide Version 71.165 .............................................................. viii
Changes for Release 71, Guide Version 71.140 .............................................................. viii
Changes for Release 71, Guide Version 71.125 .............................................................. viii
Changes for Release 71, Guide Version 71.120 .............................................................. viii
Changes for Release 71, Guide Version 71.110 .............................................................. viii
Changes for Release 70, Guide Version 1.3 ......................................................................ix
Obtaining Configuration Information ................................................................................ 3
Obtaining Configuration Files ......................................................................................... 3
Obtaining Phone Information .......................................................................................... 4
Managing Configuration Files ............................................................................................ 4
Editing Common CFG File ................................................................................................ 5
Editing MAC-Oriented CFG File...................................................................................... 7
Encrypting Configuration Files ...................................................................................... 14
Customizing Resource Files ............................................................................................ 14
Customizing a Ring Tone ............................................................................................. 14
Customizing an LCD Language ................................................................................. 15
Customizing an LCD Logo ........................................................................................... 16
Customizing a Wallpaper ........................................................................................... 17
Customizing a Local Contact File .............................................................................. 18
Customizing a Replace Rule File ................................................................................ 21
Customizing a Dial-now File ....................................................................................... 22
Customizing a Directory Template ............................................................................ 23
Customizing a Super Search Template ..................................................................... 24
Upgrading Firmware ................................................................................................... 25
Yealink IP Phones Auto provisioning Guide
iv
Preparing a Root Directory ................................................................................................ 27
Configuring a TFTP Server ................................................................................................. 28
Zero Touch ........................................................................................................................... 29
Plug and Play (PnP) Server ............................................................................................... 31
DHCP Options ..................................................................................................................... 32
Phone Flash ......................................................................................................................... 33
Power On ............................................................................................................................. 35
Repeatedly.......................................................................................................................... 36
Weekly ................................................................................................................................. 37
Auto Provision Now ............................................................................................................ 38
Multi-mode Mixed ............................................................................................................. 39
SIP NOTIFY Message ......................................................................................................... 39
Downloading Configuration Files ..................................................................................... 41
Resolving and Updating Configurations ......................................................................... 41
Verifying Configurations .................................................................................................... 42
Configuring an FTP Server ................................................................................................ 49
Preparing a Root Directory ............................................................................................ 49
Configuring an FTP server .............................................................................................. 50
Configuring an HTTP Server .............................................................................................. 52
Preparing a Root Directory ............................................................................................ 52
Configuring an HTTP Server .......................................................................................... 52
Configuring a DHCP server ............................................................................................... 55
Customizing a Ring Tone Using Cool Edit Pro ................................................................. 63
Customizing a Logo File Using PictureExDemo .............................................................. 64
Table of Contents
v
Description of Configuration Parameters in CFG Files .................................................. 65
Time Zones ........................................................................................................................ 225
BLF LED Mode ................................................................................................................... 228
Yealink IP Phones Auto provisioning Guide
vi
Summary of Changes
vii
This section describes the changes to this guide for each release and guide version.
Major updates have occurred to the following sections:
Description of Configuration Parameters in CFG Files on page 65
This version is updated to incorporate SIP-T48G IP phones. The following sections are
new for this version:
Customizing a Directory Template on page 23
Customizing a Super Search Template on page 24
Major updates have occurred to the following sections:
Editing Common CFG File on page 5
Editing MAC-Oriented CFG File on page 7
Customizing Resource Files on page 14
Description of Configuration Parameters in CFG Files on page 65
BLF LED Mode on page 228
This version is updated to incorporate SIP-T46G, SIP-T42G and SIP-T41P IP phones. The
following sections are new for this version:
Time Zones on page 225
BLF LED Mode on page 228
Major updates have occurred to the following sections:
Editing Common CFG File on page 5
Editing MAC-Oriented CFG File on page 7
Customizing Resource Files on page 14
Description of Configuration Parameters in CFG Files on page 65
Yealink IP Phones Auto provisioning Guide
viii
Documentations of the newly released SIP-T21P and SIP-T19P IP phones have also been
added.
Major updates have occurred to the following sections:
Editing Common CFG File on page 5
Editing MAC-Oriented CFG File on page 7
Encrypting Configuration Files on page 14
Customizing an LCD Logo on page 16
Customizing a Local Contact File on page 18
Description of Configuration Parameters in CFG Files on page 65
Major updates have occurred to the following section:
Customizing an LCD Logo on page 16
Major updates have occurred to the following section:
Description of Configuration Parameters in CFG Files on page 65
The following sections are new for this version:
Encrypting Configuration Files on page 14
Update Mode on page 35
SIP NOTIFY Message on page 39
Resolving and Updating Configurations on page 41
Description of Configuration Parameters in CFG Files on page 65
Major updates have occurred to the following sections:
Customizing a Local Contact File on page 18
Customizing a Replace Rule File on page 21
Summary of Changes
ix
Customizing a Dial-now File on page 22
The following sections are new for this version:
Customizing a Wallpaper on page 17
Customizing a Replace Rule File on page 21
Customizing a Dial-now File on page 22
Major updates have occurred to the following sections:
Customizing a Local Contact File on page 18
Upgrading Firmware on page 25
Introduction
1
Yealink IP phones are full-featured telephones that can be plugged directly into an IP
network and can be used easily without manual configuration.
This guide provides instructions on how to provision Yealink IP phones with the minimum
settings required. Yealink IP phones support FTP, TFTP, HTTP, and HTTPS protocols for auto
provisioning and are configured by default to use the TFTP protocol.
The purpose of this guide is to serve as a basic guidance for provisioning Yealink IP
phones, including:
Yealink SIP-T28P
Yealink SIP-T26P
Yealink SIP-T22P
Yealink SIP-T21P
Yealink SIP-T20P
Yealink SIP-T19P
Yealink SIP-T48G
Yealink SIP-T46G
Yealink SIP-T42G
Yealink SIP-T41P
The auto provisioning process outlined in this guide applies to Yealink IP phones running firmware V72 or later. We recommend that IP phones running firmware V72 or later CANNOT be downgraded to an earlier firmware version. The new firmware is compatible with old configuration parameters, but not vice versa.
This guide is also applicable to SIP-T21/T20/T19 IP phones.
Yealink IP Phones Auto provisioning Guide
2
Getting Started
3
This section provides instructions on how to get ready for auto provisioning. The auto
provisioning process discussed in this guide uses the TFTP server as the provisioning
server.
To begin the auto provisioning process, the following steps are required:
Obtaining Configuration Information
Managing Configuration Files
Before beginning provisioning, you need to obtain configuration files. There are two
configuration files both of which are CFG-formatted. We call these two files Common
CFG file and MAC-Oriented CFG file. The phone tries to download these CFG files from
the server during provisioning.
The MAC-Oriented CFG file is only effectual for the specific phone. It uses the 12-digit
MAC address of the phone as the file name. For example, if the MAC address of the
phone is 0015651130F9, the MAC-Oriented CFG file name must be 0015651130F9.cfg.
However, the Common CFG file is effectual for all the phones with the same model. It
uses a fixed name “y0000000000XX.cfg or y00000000000X.cfg as the file name,
where "XX" or X equals to the first two digits or the first digit (except 0 for SIP-T28P) of
the hardware version of the phone model.
The names of the Common CFG file for each phone model are:
Phone Model
Common CFG File
SIP-T28P
y000000000000.cfg
SIP-T26P
y000000000004.cfg
SIP-T22P
y000000000005.cfg
SIP-T21P
y000000000034.cfg
SIP-T20P
y000000000007.cfg
SIP-T19P
y000000000031.cfg
SIP-T48G
y000000000035.cfg
SIP-T46G
y000000000028.cfg
Yealink IP Phones Auto provisioning Guide
4
Phone Model
Common CFG File
SIP-T42G
y000000000029.cfg
SIP-T41P
y000000000036.cfg
You can ask the distributor or Yealink FAE for configuration files. The IP phones running
firmware version 71 or later can only recognize configuration files using UTF-8 or ANSI
encoding.
Before beginning provisioning, you also need the phone information. For example, MAC
address and the SIP account information of the phone.
MAC Address: The unique 12-digit serial number of the phone. You can obtain it from the
bar code on the back of the phone.
SIP Account Information: This may include SIP credentials such as user name, password
and IP address of the SIP server. Ask your system administrator for SIP account
information.
Auto provisioning enables Yealink IP phones to update themselves automatically via
downloading Common CFG and MAC-Oriented CFG files. Before beginning
provisioning, you may need to edit and customize your configuration files. For more
information on configuration parameters in configuration files, refer to Description of
Configuration Parameters in CFG Files on page 65.
Getting Started
5
Common CFG file contains configuration parameters which apply to phones with the
same model, such as language and volume.
The following figure shows a portion of the common CFG file:
The partial parameters in the Common CFG file are described as follows:
####################################################
## Common CFG File ##
####################################################
#!version:1.0.0.1
##File header "#!version:1.0.0.1" cannot be edited or deleted, and must be placed in the first line. This template file is applicable to SIP-T28P/T26P/T22P/T21P/T20P/T19P/T48G/T46G/T42G/T41P IP phones running firmware version 72 or later. For more information on configuration parameters, refer to Yealink_SIP-T2_Series_T19P_T4_Series_IP_Phones_Auto_Provisioning_Guide. ##
######################################################
## Hostname ##
######################################################
network.dhcp_host_name = ######################################################
## PPPOE(Except SIP-T42GP/T41P Models) ## ######################################################
network.pppoe.user =
The line beginning with # is considered to be a comment.
The file header #!version:1.0.0.1 is not a comment and must be placed in the first line. It cannot be edited or deleted.
Yealink IP Phones Auto provisioning Guide
6
network.pppoe.password =
###################################################### ## PC Port(Only SIP-T28P/T26P/T22P/T20P Models support) ##
######################################################
network.bridge_mode =
network.pc_port.ip =
network.pc_port.mask = network.dhcp.start_ip =
network.dhcp.end_ip =
###################################################### ## Network Advanced ##
###################################################### network.pc_port.enable =
network.internet_port.speed_duplex =
network.pc_port.speed_duplex =
network.pc_port.dhcp_server = network.static_dns_enable =
network.ipv6_static_dns_enable =
##Only T41P/T42G/T46G/T48G Models support this parameter## network.vlan.pc_port_mode =
###################################################### ## VLAN ## ######################################################
network.vlan.internet_port_enable =
network.vlan.internet_port_vid = network.vlan.internet_port_priority =
network.vlan.pc_port_enable =
network.vlan.pc_port_vid =
network.vlan.pc_port_priority = network.vlan.dhcp_enable =
network.vlan.dhcp_option =
###################################################### ## WEB Port ## ######################################################
network.port.http =
network.port.https =
wui.https_enable =
wui.http_enable = ######################################################
## QoS ##
######################################################
network.qos.rtptos = network.qos.signaltos =
###################################################### ## 802.1X ##
######################################################
network.802_1x.mode = network.802_1x.identity =
network.802_1x.md5_password =
Getting Started
7
network.802_1x.root_cert_url =
network.802_1x.client_cert_url = ######################################################
## OpenVPN(Except SIP-T19P Model) ## ######################################################
network.vpn_enable =
openvpn.url =
###################################################### ## LLDP ## ######################################################
network.lldp.enable =
network.lldp.packet_interval =
MAC-Oriented CFG file contains configuration parameters which are expected to be
updated per phone, such as the registration information.
The following figure shows a portion of the MAC-Oriented CFG file:
Yealink IP Phones Auto provisioning Guide
8
The partial parameters in the MAC-Oriented CFG file are described as follows:
####################################################
## MAC-Oriented CFG File ##
####################################################
#!version:1.0.0.1
##File header "#!version:1.0.0.1" cannot be edited or deleted, and must be placed in the first line. This template file is applicable to SIP-T28P/T26P/T22P/T21P/T20P/T19P/ T48G/T46G/T42G/T41P IP phones running firmware version 72 or later. For more information on configuration parameters, refer to Yealink_SIP-T2_Series_T19P_T4_Series_IP_Phones_Auto_Provisioning_Guide. ##
######################################################
## Account1 Basic Settings ##
######################################################
account.1.enable =
account.1.label =
account.1.display_name =
account.1.auth_name =
account.1.user_name =
account.1.password =
account.1.outbound_proxy_enable =
account.1.outbound_host =
account.1.outbound_port =
account.1.sip_listen_port =
account.1.transport =
######################################################
## Failback ##
######################################################
account.1.reregister_enable =
account.1.naptr_build =
account.1.fallback.redundancy_type =
account.1.fallback.timeout =
account.1.sip_server.1.address =
account.1.sip_server.1.port =
account.1.sip_server.1.expires =
account.1.sip_server.1.retry_counts =
account.1.sip_server.1.failback_mode =
account.1.sip_server.1.failback_timeout =
account.1.sip_server.1.register_on_enable =
account.1.sip_server.2.address =
Getting Started
9
account.1.sip_server.2.port =
account.1.sip_server.2.expires =
account.1.sip_server.2.retry_counts =
account.1.sip_server.2.failback_mode =
account.1.sip_server.2.failback_timeout =
account.1.sip_server.2.register_on_enable =
######################################################
## Account2 Basic Settings (except SIP-T19P Model) ##
######################################################
account.2.enable =
account.2.label =
account.2.display_name =
account.2.auth_name =
account.2.user_name =
account.2.password =
account.2.outbound_proxy_enable =
account.2.outbound_host =
account.2.outbound_port =
account.2.sip_listen_port =
account.2.transport =
######################################################
## Failback ##
######################################################
account.2.reregister_enable =
account.2.naptr_build =
account.2.fallback.redundancy_type =
account.2.fallback.timeout =
account.2.sip_server.1.address =
account.2.sip_server.1.port =
account.2.sip_server.1.expires =
account.2.sip_server.1.retry_counts =
account.2.sip_server.1.failback_mode =
account.2.sip_server.1.failback_timeout =
account.2.sip_server.1.register_on_enable =
account.2.sip_server.2.address =
account.2.sip_server.2.port =
account.2.sip_server.2.expires =
account.2.sip_server.2.retry_counts =
Yealink IP Phones Auto provisioning Guide
10
account.2.sip_server.2.failback_mode =
account.2.sip_server.2.failback_timeout =
account.2.sip_server.2.register_on_enable =
######################################################
## Account3 Basic Settings (except SIP-T21P/T20P/T19P Models) ##
######################################################
account.3.enable =
account.3.label =
account.3.display_name =
account.3.auth_name =
account.3.user_name =
account.3.password =
account.3.outbound_proxy_enable =
account.3.outbound_host =
account.3.outbound_port =
account.3.sip_listen_port =
account.3.transport =
######################################################
## Failback ##
######################################################
account.3.reregister_enable =
account.3.naptr_build =
account.3.fallback.redundancy_type =
account.3.fallback.timeout =
account.3.sip_server.1.address =
account.3.sip_server.1.port =
account.3.sip_server.1.expires =
account.3.sip_server.1.retry_counts =
account.3.sip_server.1.failback_mode =
account.3.sip_server.1.failback_timeout =
account.3.sip_server.1.register_on_enable =
account.3.sip_server.2.address =
account.3.sip_server.2.port =
account.3.sip_server.2.expires =
account.3.sip_server.2.retry_counts =
account.3.sip_server.2.failback_mode =
account.3.sip_server.2.failback_timeout =
Getting Started
11
account.3.sip_server.2.register_on_enable =
######################################################
## Account4 Basic Settings (for SIP-T28P/T48G/T46G models) ##
######################################################
account.4.enable =
account.4.label =
account.4.display_name =
account.4.auth_name =
account.4.user_name =
account.4.password =
account.4.outbound_proxy_enable =
account.4.outbound_host =
account.4.outbound_port =
account.4.sip_listen_port =
account.4.transport =
######################################################
## Failback ##
######################################################
account.4.reregister_enable =
account.4.naptr_build =
account.4.fallback.redundancy_type =
account.4.fallback.timeout =
account.4.sip_server.1.address =
account.4.sip_server.1.port =
account.4.sip_server.1.expires =
account.4.sip_server.1.retry_counts =
account.4.sip_server.1.failback_mode =
account.4.sip_server.1.failback_timeout =
account.4.sip_server.1.register_on_enable =
account.4.sip_server.2.address =
account.4.sip_server.2.port =
account.4.sip_server.2.expires =
account.4.sip_server.2.retry_counts =
account.4.sip_server.2.failback_mode =
account.4.sip_server.2.failback_timeout =
account.4.sip_server.2.register_on_enable =
Yealink IP Phones Auto provisioning Guide
12
######################################################
## Account5 Basic Settings (for SIP-T28P/T48G/T46G models) ##
######################################################
account.5.enable =
account.5.label =
account.5.display_name =
account.5.auth_name =
account.5.user_name =
account.5.password =
account.5.outbound_proxy_enable =
account.5.outbound_host =
account.5.outbound_port =
account.5.sip_listen_port =
account.5.transport =
######################################################
## Failback ##
######################################################
account.5.reregister_enable =
account.5.naptr_build =
account.5.fallback.redundancy_type =
account.5.fallback.timeout =
account.5.sip_server.1.address =
account.5.sip_server.1.port =
account.5.sip_server.1.expires =
account.5.sip_server.1.retry_counts =
account.5.sip_server.1.failback_mode =
account.5.sip_server.1.failback_timeout =
account.5.sip_server.1.register_on_enable =
account.5.sip_server.2.address =
account.5.sip_server.2.port =
account.5.sip_server.2.expires =
account.5.sip_server.2.retry_counts =
account.5.sip_server.2.failback_mode =
account.5.sip_server.2.failback_timeout =
account.5.sip_server.2.register_on_enable =
Getting Started
13
######################################################
## Account6 Basic Settings (for SIP-T28P/T48G/T46G models) ##
######################################################
account.6.enable =
account.6.label =
account.6.display_name =
account.6.auth_name =
account.6.user_name =
account.6.password =
account.6.outbound_proxy_enable =
account.6.outbound_host =
account.6.outbound_port =
account.6.sip_listen_port =
account.6.transport =
######################################################
## Failback ##
######################################################
account.6.reregister_enable =
account.6.naptr_build =
account.6.fallback.redundancy_type =
account.6.fallback.timeout =
account.6.sip_server.1.address =
account.6.sip_server.1.port =
account.6.sip_server.1.expires =
account.6.sip_server.1.retry_counts =
account.6.sip_server.1.failback_mode =
account.6.sip_server.1.failback_timeout =
account.6.sip_server.1.register_on_enable =
account.6.sip_server.2.address =
account.6.sip_server.2.port =
account.6.sip_server.2.expires =
account.6.sip_server.2.retry_counts =
account.6.sip_server.2.failback_mode =
account.6.sip_server.2.failback_timeout =
account.6.sip_server.2.register_on_enable =
Yealink IP Phones Auto provisioning Guide
14
To protect against unauthorized access and tampering of sensitive information (e.g.,
login password, registration information), you can encrypt configuration files using
Yealink Configuration Encryption Tool. AES keys must be 16 characters and the
supported characters contain: 0 ~ 9, A ~ Z, a ~ z. For more information on how to
encrypt configuration files, refer to
Yealink Configuration Encryption Tool User Guide
.
When configuring some particular features, you may need to upload resource files to IP
phones, such as personalized ring tone file, language package file and logo file. Yealink
supplies some resource file templates for the particular features. Ask the distributor or
Yealink FAE for resource file templates. The following provides information on how to
customize resource files and specify the access URL for the resource files.
Yealink IP phones have built-in system ring tones. You can change the ring type, or
customize a ring tone and upload it to the phone via auto provisioning.
The ring tone file must meet the following:
Phone Model
File Format
Single File Size
Total Files Size
SIP-T28P/T26P/T22P/T20P
.wav
<=100KB
<=100KB
SIP-T21P/T19P
.wav
<=100KB
<=200KB
SIP-T48G/T46G
.wav
<=8MB
<=20MB
SIP-T42G/T41P
.wav
<=100KB
<=100KB
For more information on customizing a ring tone file, refer to Customizing a Ring Tone
Using Cool Edit Pro on page 63.
####################################################
## Configure the access URL of the custom ring tone ##
####################################################
ringtone.url =
For example, enter tftp://192.168.1.100/Ring1.wav” in the ringtone.url = field. During
the auto provisioning process, the phone connects to the provisioning server
192.168.1.100, and downloads the ring tone file Ring1.wav.
The ring tone file must be PCMU audio format, mono channel, 8K sample rate and 16 bit resolution.
Getting Started
15
#Delete all custom ring tones.
ringtone.delete = http://localhost/all
You can modify the language translation for the phone user interface. For SIP-T4X IP
phones, you can also add a new language to IP phones.
The following table lists available languages and the associated language files for the
phone user interface:
Available
Language
Associated Language
Pack for
SIP-T28P/T26P/T22P/T20P/
T42G/T41P
Associated Language Pack
for SIP-T21P/T19P/T48G/T46G
English
lang+English.txt
lang+English.txt
Chinese_S
/
lang-Chinese_S.txt
Chinese_T
/
lang-Chinese_T.txt
German
lang-German.txt
lang-German.txt
French
lang-French.txt
lang-French.txt
Italian
lang-Italian.txt
lang-Italian.txt
Polish
lang-Polish.txt
lang-Polish.txt
Portuguese
lang-Portuguese.txt
lang-Portuguese.txt
Spanish
lang-Spanish.txt
lang-Spanish.txt
Turkish
lang-Turkish.txt
lang-Turkish.txt
The following figure shows a portion of a txt formatted English language file:
Yealink IP Phones Auto provisioning Guide
16
####################################################
## Configure the access URL of the LCD language file ##
####################################################
gui_lang.url =
If you want to modify the translation of an existing language, 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 phone connects to the provisioning server
192.168.1.100, and downloads the language file lang+English.txt.
If you want to add a new language Russian to SIP-T4X IP phones, configure the
parameter “gui_lang.url =” in the configuration file, for example:
gui_lang.url = tftp://192.168.1.100/lang-Russian.txt
During the auto provisioning process, the phone connects to the provisioning server
192.168.1.100, and downloads the language file lang-Russian.txt. After update, you
will find a new language selection Russian on the phone user interface:
Menu->Basic->Language.
#Delete all custom languages.
gui_lang.delete = http://localhost/all
Yealink IP phones allow you to customize the logo displayed on the LCD screen. SIP-T20P
IP phones only support a text logo. Logo is not applicable to SIP-T48G/T46G IP phones.
These two IP phone models use the wallpaper instead.
The following table lists the supported 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
SIP-T42G/T41P
.dob
<=192*64 2 gray scale
SIP-T48G/T46G IP phones also support adding a custom or modify an existing LCD language with an X.GUI.Y.lang (e.g., 0.GUI.English.lang) formatted language file. X is an integer which starts from 0. Y means the name of the language.
Available languages may vary between different firmware versions.
English language file name must be lang+English.txt.
To modify translation of an existing language, do not rename the language file.
Getting Started
17
For more information on customizing a logo file, refer to Customizing a Logo File Using
PictureExDemo on page 64.
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
configuration files:
####################################################
## Configure the access URL of the Logo File ##
####################################################
#(not applicable to SIP-T20P IP phones)
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, you also need to configure the following parameter:
#Configure the logo mode (not applicable to 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, you need to configure the following parameter:
#Enable or disable a text logo (only applicable to SIP-T20P IP phones).
#0-Disabled, 1-Enabled
phone_setting.lcd_logo.mode = 1
#Configure a text logo (only applicable to SIP-T20P IP phones).
phone_setting.lcd_logo.text =Yealink
After auto provisioning, you will find that the custom logo or text logo appears on the
LCD screen.
#Delete all custom logo files (not applicable to SIP-T20P IP phones).
lcd_logo.delete = http://localhost/all
Yealink SIP-T48G and SIP-T46G IP phones allow you to customize the wallpaper
displayed on the LCD screen.
The following table lists the supported wallpaper image format and resolution for
SIP-T48G and SIP-T46G IP phones:
Phone Model
Format
Resolution
Single File Size
Total File Size
SIP-T46G
.jpg/.png/.bmp
<=480*272
<=5MB
<=20MB
SIP-T48G
.jpg/.png/.bmp
<=800*480
<=5MB
<=20MB
Yealink IP Phones Auto provisioning Guide
18
Upload the wallpaper image to the provisioning server and then specify the access URL
in configuration files:
####################################################
## Configure the access URL of the wallpaper ##
####################################################
wallpaper_upload.url =
For example, enter tftp://192.168.1.100/wallpaper.jpg in the wallpaper_upload.url =
field. During the auto provisioning process, the phone connects to the provisioning
server 192.168.1.100, and downloads the wallpaper image wallpaper.jpg.
To use the custom wallpaper, you also need to configure the following parameter:
#Configure the custom image (e.g., wallpaper.jpg) as phone wallpaper.
phone_setting.backgrounds = Config:wallpaper.jpg
Yealink IP phones allow you to upload contact data in batch via auto provisioning. You
can create multiple contacts using the provided local contact template file. The existing
local contacts on the phones will be overwritten by the downloaded local contacts.
Yealink IP phones support both *.xml and *.csv formats.
When editing the local contact template file, learn the following:
Add groups between <root_group> and </root_group>.
At most 5 groups (including the default groups) can be stored on SIP-T19/T2xP IP
phones.
At most 48 groups (including the default groups) can be stored on SIP-T4X IP
phones.
Add local contacts between <root_contact> and </root_contact>.
At most 1000 local contacts can be added to IP phones.
When specifying a desired line for a contact, valid values are -1~6. This is not
applicable to SIP-T19P IP phones.
(For SIP-T21P/T20P, valid values are 0~2. For SIP-T26P/T22P, valid values are 0~3. For
SIP-T28P, valid values are 0~6. 0 stands for Auto (the first registered line). 1~6 stand
for line1~line6.
For SIP-T42G/T41P, valid values are -1~2. For SIP-T48G/T46G, valid values are -1~5.
-1 stands for Auto (the first registered line). 0~5 stand for line1~line6. Multiple line
IDs are separated by commas.)
When specifying a ring tone for a contact, valid values are Auto,
Resource:RingN.wav (system ring tone, integer N ranges from 1 to 5 for
Getting Started
19
SIP-T2xP/T19P/T42G/T41P and from 1 to 8 for SIP-T48G/T46G) and Custom:Name.wav
(custom ring tone).
When specifying a group for a contact, valid values are the group names (built-in
or custom groups).
When specifying an avatar for a contact, valid values are Default: avatar name
(for the built-in avatar) and Config: avatar name (for the custom avatar). This is
only applicable to SIP-T48G/T46G IP phones.
To customize a local contact file:
1. Open the template file using an ASCII editor.
2. For each group that you wish to add, add the following string to the file. Each starts
on a separate line:
<group display_name=”” ring=””/>
Where:
display_name=”” specifies the name of the group.
ring=”” specifies the ring tone for this group.
3. For each contact that you wish to add, add the following string to the file. Each
starts on a separate line:
<contact display_name=”” office_number=”” mobile_number=”” other_number=””
line=”” ring=”” group_id_name=”” default_photo=””/>
Where:
display_name=”” specifies the name of the contact (This value cannot be blank or
duplicated).
office_number=”” specifies the office number of the contact.
mobile_number=”” specifies the mobile number of the contact.
other_number=”” specifies the other number of the contact.
line=”” specifies the line for the contact.
ring=”” specifies the ring tone for the contact.
group_id_name=”” specifies the group you want to add the contact to.
default_photo=”” specifies the avatar for the contact (for SIP-T48G/T46G IP phones).
4. Specify the values within double quotes.
5. Save the change.
After editing the local contact template file, upload it to the provisioning server and
then specify the access URL in configuration files.
Yealink IP Phones Auto provisioning Guide
20
The following shows an example of a local contact file used for SIP-T2xP IP phones:
<root_group>
<group display_name="All Contacts" ring=""/>
<group display_name="Family" ring="Resource:Ring1.wav"/>
<group display_name="Friend" ring="Auto"/>
</root_group>
<root_contact>
<contact display_name="Mary" office_number="123" mobile_number="456"
other_number="2201" line="0" ring="Auto" group_id_name="Family"/>
<contact display_name="Damy" office_number="124" mobile_number="789"
other_number="2202" line="1" ring="Resource:Ring2.wav"
group_id_name=""/>
<contact display_name="Jack" office_number="125" mobile_number="234"
other_number="2203" line="2" ring="Custom:lin.wav"
group_id_name="Family"/>
<contact display_name="Ada" office_number="8800"
mobile_number="1234" other_number="0000" line="0" ring="
group_id_name="”/>
</root_contact>
####################################################
## Configure the access URL of the local contact file ##
####################################################
local_contact.data.url =
For example, enter tftp://192.168.1.100/contact_list.xml in the local_contact.data.url =
field. During the auto provisioning process, the phone connects to the provisioning
server 192.168.1.100, and downloads the contact file contact_list.xml.
####################################################
## Upload TAR file of local contact file and avatar TAR file ##
####################################################
#All avatars needed for contacts should be tarred in advance.
#(only applicable to SIP-T46G/T48G IP phones)
local_contact.data_photo_tar.url =
For example, enter “tftp://192.168.1.100/Contact.tar” in the
local_contact.data_photo_tar.url =” field. During the auto provisioning process, the
phone connects to the provisioning server “192.168.1.100”, and downloads the contact
file “Contact.tar”.
Loading...
+ 211 hidden pages