Yealink SIP-T2 Series T19P T4 Series IP Phones Auto Provisioning Guide V72 1 PDF
Yealink SIP-T2 Series T19P T4 Series IP Phones Auto Provisioning Guide V72 1 PDF
i
Table of Contents
Summary of Changes............................................................... v
Changes for Release 72, Guide Version 72.1 .................................................................... 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 ............................................................... vi
Changes for Release 71, Guide Version 71.110 ............................................................... vi
Changes for Release 70, Guide Version 1.3 ..................................................................... vi
Introduction ............................................................................... 1
iii
Yealink IP Phones Auto provisioning Guide
Troubleshooting ...................................................................... 43
Glossary .................................................................................. 45
Appendix ................................................................................ 47
Configuring an FTP Server ................................................................................................ 47
Preparing a Root Directory ............................................................................................ 47
Configuring an FTP server .............................................................................................. 48
Configuring an HTTP Server .............................................................................................. 50
Preparing a Root Directory ............................................................................................ 50
Configuring an HTTP Server .......................................................................................... 50
Configuring a DHCP server ............................................................................................... 53
Customizing a Ring Tone Using Cool Edit Pro ................................................................. 61
Customizing a Logo File Using PictureExDemo .............................................................. 62
Description of Configuration Parameters in CFG Files .................................................. 63
Time Zones ........................................................................................................................ 217
BLF LED Mode ................................................................................................................... 220
iv
Summary of Changes
This section describes the changes to this guide for each release and guide version.
This version is updated to incorporate SIP-T46G, SIP-T42G and SIP-T41P IP phones. The
following sections are new for this version:
Documentations of the newly released SIP-T21P and SIP-T19P IP phones have also been
added.
v
Yealink IP Phones Auto provisioning Guide
vi
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 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-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, SIP-T20 and SIP-T19 IP phones running firmware V72
or later, which are not PoE-compliant.
1
Yealink IP Phones Auto provisioning Guide
2
Getting Started
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:
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 of the hardware version
of the phone model (except 0 for SIP-T28P).
The names of the Common CFG file for each phone model are:
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-T46G y000000000028.cfg
SIP-T42G y000000000029.cfg
3
Yealink IP Phones Auto provisioning Guide
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.
4
Getting Started
Common CFG file contains configuration parameters which apply to phones with the
same model, such as language, volume.
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:
####################################################
####################################################
#!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/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-T41P/T42G Models) ##
######################################################
network.pppoe.user =
5
Yealink IP Phones Auto provisioning Guide
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 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 =
6
Getting Started
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 =
7
Yealink IP Phones Auto provisioning Guide
The parameters commonly edited in the MAC-Oriented CFG file are described as
follows:
####################################################
####################################################
#!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/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. ##
######################################################
######################################################
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 =
8
Getting Started
account.1.sip_server.2.address =
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 (except SIP-T19P Model) ##
######################################################
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 =
9
Yealink IP Phones Auto provisioning Guide
account.2.sip_server.2.retry_counts =
account.2.sip_server.2.failback_mode =
account.2.sip_server.2.failback_timeout =
account.2.sip_server.2.register_on_enable =
######################################################
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 =
######################################################
######################################################
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 =
10
Getting Started
account.3.sip_server.2.failback_timeout =
account.3.sip_server.2.register_on_enable =
######################################################
## Account4 Basic Settings (for SIP-T28P/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 =
######################################################
######################################################
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 =
11
Yealink IP Phones Auto provisioning Guide
######################################################
######################################################
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 =
######################################################
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 =
12
Getting Started
######################################################
## Account6 Basic Settings (for SIP-T28P/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 (for SIP-T28P/T46G models) ##
######################################################
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 =
13
Yealink IP Phones Auto provisioning 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
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 ring tones. You can change the ring type, or
customize a ring tone and upload it to the phone via auto provisioning.
The following table lists the supported ring tone file format, one file size and total file
size for each phone model:
SIP-T28P/T26P/T22P/T20P
.wav <=100K <=100K
/T42G/T41P
The ring tone file must be PCMU audio format, mono channel, 8K sample rate and 16 bit
resolution.
####################################################
####################################################
ringtone.url =
14
Getting Started
ringtone.delete = http://localhost/all
For more information on customizing a ring tone file, refer to Customizing a Ring Tone
Using Cool Edit Pro on page 61.
You can modify the language translation for the phone user interface. For SIP-T4X IP
phones, you can also add a new language to the phones.
The following table lists available languages and the associated language files for the
phone user interface:
Chinese_S / lang-Chinese_S.txt
Chinese_T / lang-Chinese_T.txt
15
Yealink IP Phones Auto provisioning Guide
####################################################
####################################################
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.
gui_lang.delete = http://localhost/all
SIP-T46G IP phones also support adding a custom or modifying 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. For more information, contact
Yealink FAE.
16
Getting Started
Yealink IP phones allow you to customize the logo displayed on the LCD screen. SIP-T20P
IP phones only support a text logo. SIP-T46G IP phones do not support an LCD logo.
The following table lists the supported logo file format, resolution and total file size for
each phone model:
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:
####################################################
####################################################
lcd_logo.url =
To use the custom logo, you also need to configure the following parameter:
phone_setting.lcd_logo.mode = 2
#0-Disabled, 1-Enabled
phone_setting.lcd_logo.mode = 1
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
For more information on customizing a logo file, refer to Customizing a Logo File Using
17
Yealink IP Phones Auto provisioning Guide
Yealink 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-T46G IP phones:
Wallpaper Image
Phone Model Resolution One File Size Total File Size
Format
Upload the wallpaper image to the provisioning server and then specify the access URL
in configuration files:
####################################################
####################################################
wallpaper_upload.url =
To use the custom wallpaper, you also need to configure the following parameter:
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 supplied local contact template file. The existing
local contacts on the phones will be overwritten by the downloaded local contacts.
When editing the local contact template file, learn the following:
18
Getting Started
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-T46G, valid values are -1~5. -1
stands for Auto (the first registered line). 0~5 stand for line1~line6)
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
SIP-T2xP/T19P/T42G/T41P and from 1 to 8 for SIP-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-T46G IP phones.
2. For each group that you wish to add, add the following string to the file. Each starts
on a separate line:
Where:
3. For each contact that you wish to add, add the following string to the file. Each
starts on a separate line:
Where:
display_name=”” specifies the name of the contact (This value cannot be blank or
duplicated).
19
Yealink IP Phones Auto provisioning Guide
group_id_name=”” specifies the group you want to add the contact to.
default_photo=”” specifies the avatar for the contact (for SIP-T46G IP phones).
After editing the local contact template file, upload it to the provisioning server and
then specify the access URL in configuration files.
The following shows an example of a local contact file used for SIP-T2xP IP phones:
<root_group>
</root_group>
<root_contact>
</root_contact>
####################################################
####################################################
local_contact.data.url =
20
Getting Started
####################################################
## Upload TAR file of local contact file and avatar TAR file ##
####################################################
local_contact.data_photo_tar.url =
You can create replace rules directly in configuration files, or create multiple replace
rules using the supplied replace rule template file. The existing replace rules on the
phones will be overwritten by the downloaded replace rules.
When editing the replace rule template file, learn the following:
<DialRule> indicates the start of the template file and </DialRule> indicates the
end of the template file.
When specifying the desired line(s) to apply the replace rule, valid values are 0
and line ID. The digit 0 stands for all lines. Multiple line IDs are separated by
commas. This is not applicable to SIP-T19P IP phones.
For the basic expression syntax of the replace rule, refer to Yealink phone-specific
user guide.
2. For each replace rule you wish to add, add the following string to the file. Each
starts on a separate line:
Where:
LineID=”” specifies the desired line(s) for this rule. When you leave it blank or enter
0, this replace rule will apply to all lines.
21
Yealink IP Phones Auto provisioning Guide
<DialRule>
</DialRule>
####################################################
####################################################
dialplan_replace_rule.url =
You can create dial-now rules directly in configuration files, or create multiple dial-now
rules using the supplied dial-now rule template file. The existing dial-now rules on the
phones will be overwritten by the downloaded dial-now rules.
<DialNow> indicates the start of the template file and </DialNow> indicates the
end of the template file.
When specifying the desired line(s) for the dial-now rule, valid values are 0 and
line ID. The digit 0 stands for all lines. Multiple line IDs are separated by commas.
This is not applicable to SIP-T19P IP phones.
For the basic expression syntax of the dial-now rule, refer to Yealink phone-specific
user guide.
2. For each dial-now rule you wish to add, add the following string to the file. Each
starts on a separate line:
Where:
LineID=””/ lines=”” specifies the desired line(s) for this rule. When you leave it
blank or enter 0, this dial-now rule will apply to all lines.
22
Getting Started
<DialNow>
</DialNow>
####################################################
####################################################
dialplan_dialnow.url =
Yealink IP phones allow you to upgrade firmware manually via web user interface, or
upgrade firmware in batch via auto provisioning.
The following table lists the firmware name for each phone model (X is replaced by the
actual firmware version):
SIP-T28P 2.x.x.x.rom
SIP-T26P 6.x.x.x.rom
SIP-T22P 7.x.x.x.rom
SIP-T21P 34.x.x.x.rom
SIP-T20P 9.x.x.x.rom
SIP-T19P 31.x.x.x.rom
SIP-T46G 28.x.x.x.rom
SIP-T42G 29.x.x.x.rom
SIP-T41P 36.x.x.x.rom
23
Yealink IP Phones Auto provisioning Guide
To upgrade the phones’ firmware in batch via auto provisioning, ask the distributor for
the firmware file, upload it to the provisioning server, and then specify the access URL in
configuration files.
####################################################
firmware.url =
24
Configuring a TFTP Server
Yealink IP phones support using FTP, TFTP, HTTP and HTTPS protocols to download
configuration files. You can use one of these protocols for provisioning. The TFTP protocol
is used by default. The following section provides instructions on how to configure a TFTP
server.
We recommend that you use 3CDaemon or TFTPD32 as a TFTP server. 3CDaemo and
TFTPD32 are free applications for Windows. You can download 3CDaemon online:
http://www.oldversion.com/3Com-Daemon.html and TFTPD32 online:
http://tftpd32.jounin.net/.
For more information on how to configure FTP and HTTP servers, refer to Configuring an
FTP server on page 47 and Configuring an HTTP Server on page 50.
You need to define a user or a group name, and set the permissions: read, write or
modify. Security permissions vary by organizations.
25
Yealink IP Phones Auto provisioning Guide
If you have a 3CDaemon application installed on your local system, use it directly.
Otherwise, download and install it.
2. Select Configure TFTP Server. Click the button to locate the TFTP root directory
from your local system:
The server URL “tftp://IP/” (Here “IP” means the IP address of the provisioning
server, for example, ”tftp://192.168.1.100/”) is where the phone downloads
configuration files from.
26
Obtaining the Address of Provisioning Server
Yealink IP phones support obtaining the provisioning server address in the following
ways:
Zero Touch
DHCP Options
Phone Flash
The priority of obtaining the provisioning server address is as follows: Zero Touch-->PnP
Server-->DHCP Options (Custom option-->option 66-->option 43) -->Phone Flash.
Zero Touch allows you to configure the network parameters and provisioning server
address via phone user interface during startup. This feature is helpful when there is a
system failure on the phone. To use Zero Touch, make sure this feature is enabled.
27
Yealink IP Phones Auto provisioning Guide
When Zero Touch is enabled, there will be a configuration wizard during startup (Take
T28P IP phone as an example):
Press the Next soft key after finishing the network parameters.
28
Obtaining the Address of Provisioning Server
Configure the provisioning server address, authentication user name (optional) and
password (optional) in the Auto Provision screen.
Yealink IP phones support obtaining the provisioning server address from the PnP server.
The phone broadcasts the PnP SUBSCRIBE message to obtain the provisioning server
address during startup. To use Plug and Play, make sure this feature is enabled.
Any PnP server activated in the network responses with a SIP NOTIFY message, and an
address of the provisioning server is contained in the message body. Then the phone
29
Yealink IP Phones Auto provisioning Guide
can connect to the provisioning server and perform the auto provisioning process.
Yealink IP phones support obtaining the provisioning server address from DHCP options.
You can configure the phone to obtain the provisioning server address from a custom
DHCP option, or the phone will automatically detect the Option 66 and Option 43. The
Option 66 is used to identify the TFTP server. To obtain the provisioning server address
by a custom DHCP option, make sure the DHCP option is set properly.
The custom DHCP option must be in accordance with the one defined in the DHCP
server. For more information on configuring a DHCP server, refer to Configuring a DHCP
server on page 53.
30
Obtaining the Address of Provisioning Server
Yealink IP phones support obtaining the provisioning server address from the phone
flash. To obtain the provisioning server address by reading the phone flash, make sure
the configuration is set properly.
31
Yealink IP Phones Auto provisioning Guide
2. Enter the URL, user name and password of the provisioning server in the Server
URL, User Name and Password fields (the user name and password are optional).
32
Update Mode
The update mode is used to set the desired time for the phone to perform the auto
provisioning process. This chapter introduces the following update modes in detail:
Power On
Repeatedly
Weekly
Multi-mode Mixed
When there is an active call on the phone during provisioning, the auto provisioning
process will detect the call status every 30 seconds. If the call is released within 2 hours,
the auto provisioning process will be performed normally. Otherwise, the process will be
completed, due to timeout.
The phone performs the auto provisioning process when the phone is powered on.
33
Yealink IP Phones Auto provisioning Guide
The phone performs the auto provisioning process at regular intervals. You can
configure the interval for the Repeatedly mode. The default interval is 1440 minutes.
34
Update Mode
3. Enter the interval time (in minutes) in the Interval (Minutes) field.
The phone performs the auto provisioning process at the fixed time every week. You
can configure what time of the day and which day of the week to trigger the phone to
perform the auto provisioning process. For example, you can configure the phone to
check and update new configuration between 2 to 3 o’clock every Friday and Sunday.
35
Yealink IP Phones Auto provisioning Guide
You can use Auto Provision Now mode to manually trigger the phone to perform the
auto provisioning process immediately.
To use the Auto Provision Now mode via web user interface:
36
Update Mode
You can activate more than one update mode for auto provisioning. For example, you
can activate the “Power On” and “Repeatedly” modes simultaneously. The phone will
perform the auto provisioning process when it is powered on and at a specified interval.
The phone will perform the auto provisioning process when receiving a SIP NOTIFY
message which contains the header “Event: check-sync”. If the header of the SIP
NOTIFY message contains an additional string “reboot=true”, the phone will reboot
immediately and then perform the auto provisioning process. This update mode
requires server support.
37
Yealink IP Phones Auto provisioning Guide
38
Downloading and Verifying Configurations
Once obtaining a provisioning server address in one of the ways introduced above, the
phone will connect to the provisioning server and download configuration files. During
the auto provisioning process, the phone will try to download the Common CFG file
firstly, and then try to download the MAC-Oriented CFG file from the provisioning server.
If resource files need to be updated and the access URLs have been specified in
configuration files, the phone will then try to download and update the resource files.
After downloading, the phone resolves the configuration files, downloads the resource
files requested in the configuration files, and then updates the configurations and
resource files to the phone flash. Generally, updated configurations will automatically
take effect after the auto provisioning process is completed. For update of some specific
configurations which require a reboot before taking effect, for example, network
configurations, the phone will reboot to make the configurations effective after the auto
provisioning process is completed.
The phone calculates the MD5 values of the downloaded files. If the MD5 values of the
Common and MAC-Oriented configuration files are the same as those of the last
downloaded configuration files, this means these two configuration files on the
provisioning server are not changed. The phone will complete the auto provisioning
without repeated update. This is used to avoid unnecessary restart and impact of
phone use.
If configuration files have been AES-encrypted, the phone will decrypt them after
downloading the configuration files. For more information on how to decrypt
configuration files, refer to Yealink Configuration Encryption Tool User Guide.
The phone only reboots when there is at least a specific configuration requiring reboot
during auto provisioning.
For more information on the specific configurations requiring a reboot during auto
provisioning, refer to Description of Configuration Parameters in CFG Files on page 63.
39
Yealink IP Phones Auto provisioning Guide
After auto provisioning, you can then verify the update via phone user interface, or you
can verify it via web user interface of the phone. For more information, refer to Yealink
phone-specific user guide.
During the auto provisioning process, you can monitor the downloading requests and
response messages by a WinPcap tool. The following shows some examples.
Example1: Yealink SIP-T28P IP phone downloads configuration files from the TFTP server.
Example 2: Yealink SIP-T28P IP phone downloads configuration files from the FTP server.
40
Downloading and Verifying Configurations
Example 3: Yealink SIP-T28P IP phone downloads configuration files from the HTTP server.
41
Yealink IP Phones Auto provisioning Guide
42
Troubleshooting
This chapter provides general troubleshooting information to help you solve problems
you might encounter when deploying phones.
If you require additional information or assistance with the deployment, contact your
system administrator.
Ensure that the Ethernet cable is plugged into the Internet port on the phone and
the Ethernet cable is not loose.
Ensure that the configurations of network are properly set in the configuration files.
Why is the permission denied when uploading files to the root directory of the FTP
server?
Ensure that the complete path to the root directory of the FTP server is authorized.
Check security permissions on the root directory of the FTP server, if necessary,
change the permissions.
Why doesn’t the phone obtain the IP address from the DHCP server?
Ensure that the phone is configured to obtain the IP address from the DHCP server.
43
Yealink IP Phones Auto provisioning Guide
Ensure that the size of the ring tone file is no larger than that the phone supports.
Ensure that the properties of the ring tone for the phone are correct.
Ensure that the network is available and the root directory is right for downloading.
Ensure that the ring tone file exists on the provisioning server.
Ensure that the configuration files are different from the last ones.
Ensure that the parameters are correctly set in the configuration files.
44
Glossary
MAC Address: A Media Access Control address (MAC address) is a unique identifier
assigned to network interfaces for communications on the physical network segment.
MD5: The MD5 Message-Digest Algorithm is a widely used cryptographic hash function
that produces a 128-bit (16-byte) hash value.
FTP: File Transfer Protocol (FTP) is a standard network protocol used to transfer files from
one host to another host over a TCP-based network, such as the Internet. It is often used
to upload web pages and other documents from a private development machine to a
public web-hosting server.
HTTP: The Hypertext Transfer Protocol (HTTP) is an application protocol for distributed,
collaborative, hypermedia information systems. HTTP is the foundation of data
communication for the World Wide Web.
TFTP: Trivial File Transfer Protocol (TFTP) is a simple protocol to transfer files. It has been
implemented on top of the User Datagram Protocol (UDP) using port number 69.
XML: Extensible Markup Language (XML) is a markup language that defines a set of
rules for encoding documents in a format that is both human-readable and
machine-readable.
45
Yealink IP Phones Auto provisioning Guide
46
Appendix
This section provides instructions on how to configure an FTP server using 3CDaemon.
You can download the 3CDaemon software online:
http://www.oldversion.com/3Com-Daemon.html.
You need to define a user or group name, and set the permissions: read, write, and
modify. Security permissions vary by organizations.
47
Yealink IP Phones Auto provisioning Guide
If you have a 3CDaemon application installed on your local system, use it directly.
Otherwise, download and install it.
2. Click the FTP Server button on the left of the main page.
4. Click the button to locate the FTP root directory from your local system:
6. Click the Set/Change user’s password button to set the password in the pop-up
48
Appendix
dialogue box.
8. Mark the check boxes of Login, Download and Upload to make sure the FTP user
has the login, download and upload permission.
9. Click the Save Profile button to save the settings and finish the configurations.
10. Click the Confirm button to finish configuring the FTP server.
49
Yealink IP Phones Auto provisioning Guide
This section provides instructions on how to configure an HTTP server using HFS tool. You
can download the HFS software online: http://www.snapfiles.com/get/hfs.html.
You need to define a user or group name and set the permissions: read, write, and
modify. Security permissions vary by organizations.
1. Download the application file to your local directory, double click the hfs.exe.
50
Appendix
2. Click Menu in the main page and select the IP address of the PC from IP address.
51
Yealink IP Phones Auto provisioning Guide
The default HTTP port is 8080. You can also reset the HTTP port (make sure there is no
port conflict).
3. Right click the icon on the left of the main page, select Add folder from disk to
add the HTTP Server root directory.
52
Appendix
4. Locate the root directory from your local system. Select the kind of folder which you
want.
5. Check the server URL “http:// IP:Port/” in the “Open in browser” address bar (For
example, the server URL ”http:// 10.2.11.101:8088/” is shown on the screenshot) . We
recommend that you can fill the server URL in the address bar of the web browser
and then press <Enter> key to check the HTTP server before provisioning.
Yealink IP phones also support the Hypertext Transfer Protocol with SSL/TLS (HTTPS)
protocol for auto provisioning. HTTPS protocol provides the encrypted communication and
secure identification. For more information on installing and configuring an Apache HTTPS
Server, refer to the network resource.
This section provides instructions on how to configure a DHCP server for Windows using
DHCP Turbo. You can download this software online:
http://www.tucows.com/preview/265297 and install it following the setup wizard.
53
Yealink IP Phones Auto provisioning Guide
2. Click the Login button (the login password is blank) to log in.
3. You can then edit the existing DHCP server, or you can right click localhost and
select New Server to add a new DHCP server.
54
Appendix
5. Configure the DHCP server name, the DHCP IP range and the subnet mask.
7. You can add a custom option via DHCP Turbo. Select Option Types, right click one
of the options on the right of the main page, and then select New Option Type.
55
Yealink IP Phones Auto provisioning Guide
8. Set the custom DHCP option (custom DHCP option tag number ranges from 128 to
254) and select the option type (Yealink supports String and IP Address option
types only). Click the OK button to finish setting the option properties. Click to
save the change.
9. Click Named Policies-->Global, right click the blank area on the right of the main
page and then select New Option.
56
Appendix
10. Scroll down and double click the custom option 128.
57
Yealink IP Phones Auto provisioning Guide
You can add the option 66 via DHCP Turbo. The following shows the detailed processes.
1. Click Named Policies-->Global, right click the blank area on the right of the main
page and then select New Option.
58
Appendix
You also can add the option 43. The following shows the detailed processes.
1. Click Named Policies-->Global, right click the blank area on the right of the main
page and then select New Option.
59
Yealink IP Phones Auto provisioning Guide
60
Appendix
If you have installed the Cool Edit application, double click to open it. Otherwise, you
can download the installation package online:
http://www.toggle.com/lv/group/view/kl36218/Cool_Edit_Pro.htm and install it.
3. Locate the ring tone file, click Open, the file is uploaded as follows.
5. Select File->New to create a new file, set the channels as Mono, the sample rate as
8000 and the resolution as 16-bit.
7. Select File->Save as to save the new audio file. On the Save waveform page,
61
Yealink IP Phones Auto provisioning Guide
The original picture format must be *.bmp or *.gif. We recommend placing all files and
the PictureExDemo application to the root directory of the PC.
You can repeat the second step to add multiple original picture files.
Then you can find the DOB logo files in the adv directory.
62
Appendix
If you want to reset the configuration of a parameter, set the value of the parameter to !NULL!
or %NULL%. For example, local_time.ntp_server1 = %NULL%. After the auto provisioning
process is completed, the NTP server 1 will be reset to “cn.pool.ntp.org”.
Permitted
Parameter Descriptions Web Setting Path
Values
0-IPv4
Network->Basic->
network.ip_ad 1-IPv6
0, 1 or 2 Internet Port->
dress_mode = 2-IPv4&IPv6
Mode (IPv4/IPv6)
The default value is 0.
0-DHCP
network.intern Network->Basic->
0, 1 or 2
et_port.type = 1-PPPoE (not applicable to SIP-T41P and IPv4 Config
SIP-T42G IP phones)
2-Static IP Address
1-Enabled
63
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
network.pppo
e.user =
It configures the user name for PPPoE Network->Basic->
(not String within
connection. IPv4 Config->
applicable to 32
The default value is blank. PPPoE->User
SIP-T41P and characters
It takes effect after a reboot. Name
SIP-T42G IP
phones)
64
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
65
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
phones) PC connection.
66
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
0-Disabled
network.pc_p Network->PC Port
0 or 1 1-Auto Negotiation
ort.enable = ->PC Port Active
The default value is 1.
network.pc_p
ort.ip =
It configures the IP address of the PC
(only
Network->PC Port
(LAN) port when the PC (LAN) port is
applicable to
->PC Port Config
IP address configured as Router.
SIP-T20P,
->As Router->IP
SIP-T22P, The default value is 10.0.0.1.
Address
SIP-T26P and It takes effect after a reboot.
SIP-T28P IP
phones)
network.pc_p
ort.mask =
It configures the mask of the PC (LAN)
(only
Network->PC Port
port when the PC (LAN) port is
applicable to
->PC Port Config
IP address configured as Router.
SIP-T20P,
->As Router
SIP-T22P, The default value is 255.255.255.0.
->Subnet Mask
SIP-T26P and It takes effect after a reboot.
SIP-T28P IP
phones)
network.pc_p
ort.dhcp_serv It enables or disables the phone to act
er = as a DHCP server when the PC (LAN)
Network->PC Port
(only port is configured as Router.
->PC Port Config
applicable to 0-Disabled
0 or 1 ->As Router
SIP-T20P,
1-Enabled ->Enable DHCP
SIP-T22P,
The default value is 1. Server
SIP-T26P and
SIP-T28P IP It takes effect after a reboot.
phones)
network.dhcp.
It configures the start IP address of the Network->PC Port
start_ip =
DHCP IP segment. ->PC Port Config
(only IP address
The default value is 10.0.0.10. ->As Router->Start
applicable to
It takes effect after a reboot. IP Address
SIP-T20P,
67
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
SIP-T22P,
SIP-T26P and
SIP-T28P IP
phones)
network.dhcp.
end_ip =
0-Auto negotiate
0-Auto negotiate
68
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
(only 0 or 1 port.
69
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
70
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
71
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
0-Disabled
1-EAP-MD5
Network->
network.802_1 2-EAP-TLS
0, 1, 2, 3 or 4 Advanced->802.1x
x.mode = 3-PEAP-MSCHAPV2
->802.1x Mode
4-EAP-TTLS/EAP-MSCHAPv2
72
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
openvpn.url =
Network->
(not URL within It configures the access URL of the *.tar
Advanced->VPN-
applicable to 511 file for OpenVPN.
>Upload VPN
SIP-T19P IP characters The default value is blank.
Config
phones)
0-Disabled Network->
network.lldp.e
0 or 1 1-Enabled Advanced->LLDP-
nable =
The default value is 1. >Active
Network->
It configures the maximum duration (in
Advanced->
seconds) for account register after
sip.reg_surge_ Integer from Registration
startup.
prevention = 0 to 60 Random->
The default value is 0.
Registration
It takes effect after a reboot.
Random (0~60s)
73
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
74
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
0-Disabled Settings->Auto
auto_provision
0 or 1 1-Enabled Provision->Power
.power_on =
The default value is 1. On
1-Enabled
0-Sunday
1-Monday
0,1,2,3,4,5,6
2-Tuesday
auto_provision or a Settings->Auto
3-Wednesday
.weekly.dayof combination provision->Day of
4-Thursday
week = of these week
5-Friday
digits
6-Saturday
Example:
auto_provision.weekly.dayofweek =
01 means the phone will check the
new configuration every Sunday and
75
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
Monday.
76
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
auto_provision
It configures the custom DHCP option Settings->Auto
.dhcp_option.l Integer from
for provisioning server address. Provision->Custom
ist_user_optio 128 to 254
The default value is blank. Option (128~254)
ns =
auto_provision
String within It configures the value (vendor name Settings->Auto
.dhcp_option.
99 of the device) of DHCP option 60. Provision->DHCP
option60_valu
characters The default value is yealink. Option Value
e=
77
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
0-Disabled
1-Enabled
78
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
79
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
is broken down.
0-Disabled
1-Enabled
managements
erver.enable
= It enables or disables TR069 feature.
0-Disabled Settings->TR069->
(not
0 or 1
applicable to 1-Enabled Enable TR069
managements
erver.usernam
e=
String within It configures the user name for the
(not Settings->TR069->
128 phone to authenticate with the ACS.
applicable to ACS Username
characters The default value is blank.
SIP-T41P and
SIP-T42G IP
phones)
managements
erver.passwor
d=
String within It configures the password for the
(not Settings->TR069->
64 phone to authenticate with the ACS.
applicable to ACS Password
characters The default value is blank.
SIP-T41P and
SIP-T42G IP
phones)
managements
erver.url =
80
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
e= 1-Enabled
managements
erver.periodic
_inform_interv
It configures the interval (in seconds)
al = Integer from Settings->TR069->
for the phone to report its configuration
(not 5 to Periodic Inform
to the ACS.
applicable to 4294967295 Interval (seconds)
The default value is 60.
SIP-T41P and
SIP-T42G IP
phones)
managements
erver.connecti
on_request_us
It configures the user name for the
ername = String within Settings->TR069->
phone to authenticate the connection
(not 128 Connection
requests.
applicable to characters Request Username
The default value is blank.
SIP-T41P and
SIP-T42G IP
phones)
managements
erver.connecti
on_request_p
It configures the password for the
assword = String within Settings->TR069->
phone to authenticate the connection
(not 64 Connection
requests.
applicable to characters Request Password
The default value is blank.
SIP-T41P and
SIP-T42G IP
phones)
0-Enabled
81
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
1-Disabled
2-Blind Transfer
transfer.multi_
It enables or disables the phone to
call_trans_ena
enter Transfer to menu during multiple
ble = Features->General
calls when pressing the transfer soft
(not key or TRAN key. Information->
0 or 1
applicable to Allow Trans Exist
0-Disabled
SIP-T20P and Call
1-Enabled
SIP-T4X IP
The default value is 1.
phones)
82
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
Custom,
It configures the country tone for the
voice.tone.cou Australia, Settings->Tones->
phone.
ntry = Austria, Select Country
The default value is Custom.
Brazil,
83
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
Belgium,
China,
Czech,
Denmark,
Finland,
France,
Germany,
Great
Britain,
Greece,
Hungary,
Lithuania,
India, Italy,
Japan,
Mexico,
New
Zealand,
Netherlands,
Norway,
Portugal,
Spain,
Switzerland,
Sweden,
Russia,
United
States,
Chile, Czech
ETSI
tonelist = element[,element]
[,element]…
84
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
85
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
86
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
87
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
voice.handfre
e_send =
voice.handset
_send =
voice.headset
_send =
88
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
89
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
security.var_e 0-Disabled
0 or 1
nable = 1-Enabled
phone_setting
.custom_softke It enables or disables customizing the
90
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
custom_softke
y_call_in.url = It configures the access URL of the file
URL within
(not for custom soft keys layout on the LCD
511
applicable to screen when Call in.
characters
SIP-T20P IP The default value is blank.
phones)
custom_softke
y_connecting.
It configures the access URL of the file
url = URL within
for custom soft keys layout on the LCD
(not 511
screen when Connecting.
applicable to characters
The default value is blank.
SIP-T20P IP
phones)
custom_softke
y_dialing.url = It configures the access URL of the file
URL within
(not for custom soft keys layout on the LCD
511
applicable to screen when Dialing.
characters
SIP-T20P IP The default value is blank.
phones)
custom_softke
y_ring_back.ur
It configures the access URL of the file
l= URL within
for custom soft keys layout on the LCD
(not 511
screen when Ringback.
applicable to characters
The default value is blank.
SIP-T20P IP
phones)
custom_softke
y_talking.url = It configures the access URL of the file
URL within
(not for custom soft keys layout on the LCD
511
applicable to screen when Talking.
characters
SIP-T20P IP The default value is blank.
phones)
91
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
5-DND
7-Call Return
8-SMS
9-Directed Pickup
10-Call Park
11-DTMF
12-Voice Mail
13-Speed Dial
14-Intercom
15-Line
16-BLF
17-URL
18-Group Listening
20-Private Hold
22-XML Group
23-Group Pickup
24-Multicast Paging
25-Record
27-XML Browser
34-Hot Desking
35-URL Record
38-LDAP
39-BLF List
40-Prefix
41-Zero Touch
42-ACD
45-Local Group
46-Network Group
49-Custom Button
92
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
50-Keypad Lock
55-Meet-Me Conference
56-Retrieve Park
57-Hoteling
58-ACD Trace
59-Disp Code
60-Emergency
61-Directory
memorykey.X.
value =
It configures the value of the memory
(X ranges
key feature.
from 1 to 10) String within DSSKey->Memory
For example, when setting the key
(only 99 Key->Memory
feature to BLF, it configures the number
applicable to characters KeyX->Value
of the monitored user.
SIP-T26P and
The default value is blank.
SIP-T28P IP
phones)
memorykey.X.
pickup_value It configures the pickup code for BLF
SIP-T28P IP
93
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
phones)
0-All contacts
0-All contacts
1-Group
2-Enterprise
3-GroupCommon
4-EnterpriseCommon
5-Personal
94
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
1 to 2. phones)
SIP-T22P/T26P: 1-Conference
X ranges from 2-Forward
1 to 3.
3-Transfer
SIP-T28P: X
4-Hold
ranges from 1
5-DND
to 6.
7-Call Return
SIP-T41P/T42G:
X ranges from 8-SMS (not applicable to SIP-T20P,
16-BLF
18-Group Listening
20-Private Hold
23-Group Pickup
24-Multicast Paging
25-Record
27-XML Browser
34-Hot Desking
35-URL Record
39-BLF List
40-Prefix
41-Zero Touch
42-ACD
95
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
45-Local Group
50-Keypad Lock
55-Meet-Me Conference
56-Retrieve Park
57-Hoteling
58-ACD Trace
59-Disp Code
60-Emergency
61-Directory
linekey.X.line
It configures the desired line to apply
=
the key feature.
DSSKey->Line
(SIP-T20P/T21P: Integer from
1-Line 1 Key->Line
X ranges from 1 to 6
2-Line 2 KeyX->Line
1 to 2.
3-Line 3
SIP-T22P/T26P:
96
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
linekey.X.valu
e=
(SIP-T20P/T21P:
X ranges from
1 to 2.
SIP-T22P/T26P:
X ranges from
1 to 3.
It configures the value of the line key
SIP-T28P: X
feature.
ranges from 1 String within DSSKey->Line
For example, when setting the key
to 6. 99 Key->Line
feature to BLF, it configures the number
SIP-T41P/T42G: characters KeyX->Value
of the monitored user.
X ranges from
The default value is blank.
1 to 15.
SIP-T46G: X
ranges from 1
to 27)
(not
applicable to
SIP-T19P IP
phones)
linekey.X.pick String within It configures the pickup code for BLF DSSKey->Line
up_value = 256 feature or conference ID followed by Key->Line
97
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
SIP-T28P: X
ranges from 1
to 6.
SIP-T41P/T42G:
X ranges from
1 to 15.
SIP-T46G: X
ranges from 1
to 27)
(not
applicable to
SIP-T19P IP
phones)
98
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
0-All contacts
1-Group
2-Enterprise
3-GroupCommon
4-EnterpriseCommon
5-Personal
linekey.X.label
=
(SIP-T20P/T21P:
X ranges from
1 to 2.
SIP-T22P/T26P:
X ranges from
1 to 3.
SIP-T28P: X
String within It configures the label displayed on the DSSKey->Line
ranges from 1
99 LCD screen for each line key. Key->Line
to 6.
characters The default value is blank. KeyX->Label
SIP-T41P/T42G:
X ranges from
1 to 15.
SIP-T46G: X
ranges from 1
to 27)
(not
applicable to
SIP-T19P IP
99
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
phones)
0-N/A
2-Forward
5-DND
7-Call Return
43-Local Directory
44-Network Directory
45-Local Group
100
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
46-Network Group
50-Keypad Lock
55-Meet-Me Conference
61-Directory
programablek
ey.X.line =
It configures the desired line to apply
(SIP-T19P:
the programmable key feature.
X=1-9, 13, 14;
1-Line 1
SIP-T20P:
2-Line 2
X=5-12, 14;
SIP-T21P: 3-Line 3
programablek
It configures the value of the
ey.X.value =
programmable key feature.
(SIP-T19P: String within DSSKey->
For example, when configuring the key
X=1-9, 13, 14; 99 Programmable
feature to be Speed Dial, it configures
SIP-T20P: characters Key->Value
the number.
X=5-12, 14;
The default value is blank.
SIP-T21P:
101
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
X=1-10, 14;
SIP-T22P:
X=1-10, 12-14
SIP-T26/T28P: X
ranges from 1
to 14.
SIP-T26/T28P: X
ranges from 1
to 14.
SIP-T41P/T42G:
X=1-10, 13.
SIP-T46G:
X=1-10, 12-14)
SIP-T20P: IP phones.
ranges from 1 …
to 14. 48-Forty-eighth local group
SIP-T41P/T42G: Local groups 6-48 are only applicable
X=1-10, 13. to SIP-T4X IP phones.
SIP-T46G: When the key feature is configured as
X=1-10, 12-14) XML Group (remote phone book),
valid values are:
102
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
0-All contacts
1-Group
2-Enterprise
3-GroupCommon
4-EnterpriseCommon
5-Personal
programablek
ey.X.history_ty
pe =
(SIP-T19P:
X=1-9, 13, 14;
SIP-T21P:
X=1-10, 14;
SIP-T22P:
It configures the history type of
X=1-10, 12-14
programmable key.
DSSKey->
SIP-T26/T28P: X
Integer 0-Local History Programmable
ranges from 1
1-Network History Key->Line
to 14.
The default value is 0.
SIP-T41P/T42G:
X=1-10, 13.
SIP-T46G:
X=1-10, 12-14)
(not
applicable to
SIP-T20P IP
phones)
programablek
String within It configures the label displayed on the DSSKey->
ey.X.label =
99 LCD screen for each soft key. Programmable
(X ranges
characters The default value is blank. Key->Label
from 1 to 4)
103
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
(not
applicable to
SIP-T20P IP
phones)
programablek
ey.X.pickup_v
alue =
(SIP-T19P:
X=1-9, 13, 14;
SIP-T20P:
X=5-12, 14; It configures conference ID followed by
SIP-T21P: the # sign for Meet-Me conference
String within DSSKey->Program
X=1-10, 14; feature.
256 mable
SIP-T22P: It only applies to Meet-Me conference
characters Key->Extension
X=1-10, 12-14 feature.
SIP-T26/T28P: X The default value is blank.
ranges from 1
to 14.
SIP-T41P/T42G:
X=1-10, 13.
SIP-T46G:
X=1-10, 12-14)
(only 8-SMS
applicable to
9-Directed Pickup
SIP-T26P,
10-Call Park
SIP-T28P and
11-DTMF
SIP-T46G IP
phones) 12-Voice Mail
104
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
13-Speed Dial
14-Intercom
15-Line
16-BLF
17-URL
18-Group Listening
20-Private Hold
22-XML Group
23-Group Pickup
24-Multicast Paging
25-Record
27-XML Browser
34-Hot Desking
35-URL Record
38-LDAP
39-BLF List
40-Prefix
41-Zero Touch
42-ACD
45-Local Group
46-Network Group
49-Custom Button
50-Keypad Lock
55-Meet-Me Conference
56-Retrieve Park
57-Hoteling
58-ACD Grace
59-Disp Code
60-Emergency
61-Directory
105
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
SIP-T46G IP phones)
expansion_mo
dule.X.key.Y.lin
e=
It configures the desired line to apply
(SIP-T26P: X
the expansion module key feature.
ranges from 1
1-Line 1
to 3.
2-Line 2
SIP-T28P/T46G:
X ranges from 3-Line 3
Integer from DSSKey->Ext
1 to 6. 4-Line 4
1 to 6 Key->Line
Y ranges from 5-Line 5
1 to 40) 6-Line 6
(only Lines 4-6 are only applicable to
applicable to SIP-T28P and SIP-T46G IP phones.
SIP-T26P,
The default value is 1.
SIP-T28P and
SIP-T46G IP
phones)
expansion_mo
dule.X.key.Y.v
alue =
(SIP-T26P: X
String within It configures the value of the
ranges from 1 DSSKey->Ext
99 expansion module key feature.
to 3. Key->Value
characters The default value is blank.
SIP-T28P/T46G:
X ranges from
1 to 6.
Y ranges from
106
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
1 to 40)
(only
applicable to
SIP-T26P,
SIP-T28P and
SIP-T46G IP
phones)
expansion_mo
dule.X.key.Y.pi
ckup_value =
SIP-T28P and
SIP-T46G IP
phones)
expansion_mo
dule.X.key.Y.la
bel =
(X ranges
from 1 to 6.
It configures the label displayed on the
Y ranges from String within
LCD screen of the expansion module DSSKey->Ext
1 to 40) 99
for each key. Key->Label
characters
(only
The default value is blank.
applicable to
SIP-T26P,
SIP-T28P and
SIP-T46G IP
phones)
expansion_mo
It only applies to the Local Group, XML
dule.X.key.Y.x
Group and Network Group features. DSSKey->Ext
ml_phoneboo Integer from
When the key feature is configured as Key->Ext
k= 0 to 48
Local Group, valid values are: KeyX->Line
(X ranges
0-All contacts
from 1 to 6.
107
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
0-All contacts
1-Group
2-Enterprise
3-GroupCommon
4-EnterpriseCommon
5-Personal
108
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
wallpaper_upl
oad.url = Settings->
URL within It configures the access URL of the
(only Preference->Uploa
511 custom wallpaper image.
applicable to d Wallpaper
characters The default value is blank.
SIP-T46G IP (480*272)
phones)
Features->Forwar
String within It configures the always forward on
forward.alwa d &DND->Always
32 code.
ys.on_code = Forward->On
characters The default value is blank.
Code
Features->Forwar
String within It configures the always forward off
forward.alwa d &DND->Always
32 code.
ys.off_code = Forward->Off
characters The default value is blank.
Code
109
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
1-Enabled
Features->Forwar
String within
forward.busy. It configures the busy forward on code. d &DND->Busy
32
on_code = The default value is blank. Forward->On
characters
Code
Features->Forwar
String within
forward.busy. It configures the busy forward off code. d &DND->Busy
32
off_code = The default value is blank. Forward->Off
characters
Code
Features->Forwar
forward.no_a String within It configures the no answer forward on d &DND->No
nswer.on_cod 32 code. Answer
e= characters The default value is blank. Forward->On
Code
Features->Forwar
forward.no_a String within It configures the no answer forward off
d &DND->No
nswer.off_cod 32 code.
Answer
e= characters The default value is blank.
Forward->Off
110
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
Code
$mac
$ip
$active_user
$active_host
$local
$remote
$display_local
$display_remote
$call_id
111
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
Example:
action_url. setup_completed =
http://192.168.0.20/help.xml?IP=$ip
Example:
Example:
action_url.on_ URL within It configures the action URL the phone Features->Action
hook = 511 sends when on hook. URL->On Hook
112
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
characters Example:
action_url.on_hook =
http://192.168.0.20/help.xml?IP=$ip
http://192.168.0.20/help.xml?IP=$ip
113
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
http://192.168.0.20/help.xml?IP=$ip
http://192.168.0.20/help.xml?IP=$ip
http://192.168.0.20/help.xml?IP=$ip
action_url.no_ URL within It configures the action URL the phone Features->Action
answer_fwd_o 511 sends when no answer forward URL->Open No
114
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
Example:
action_url.no_answer_fwd_on =
http://192.168.0.20/help.xml?IP=$ip
http://192.168.0.20/help.xml?IP=$ip
http://192.168.0.20/help.xml?IP=$ip
http://192.168.0.20/help.xml?IP=$ip
115
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
http://192.168.0.20/help.xml?IP=$ip
116
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
Example:
action_url.idle_to_busy =
http://192.168.0.20/help.xml?IP=$ip
= http://192.168.0.20/help.xml?IP=$ip
http://192.168.0.20/help.xml?IP=$ip
117
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
English,
Chinese_S,
Chinese_T, It configures the language of the
118
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
1-Enabled
119
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
Settings->Time &
It configures the end time of the DST.
Date-> End Date
Value formats are:
For DST By Week:
Month/Day/Hour (for By Date)
local_time.en Settings ->Time &
Time Month/ Day of Week/ Day of
d_time =
Date->DST Stop
Week Last in Month/ Hour of Day Month/DST Stop
(for By Week) Day of Week/DST
1-Enabled
120
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
/T22P/T26P/T phones:
28P/T4X) 0-WWW MMM DD
7, 8 or 9 1-DD-MMM-YY
(for SIP-T20P)
2-YYYY-MM-DD
3-DD/MM/YYYY
4-MM/DD/YY
6-WWW DD MMM
7-MM DD YY
8-DD MM YY
9-YY MM DD
1-Enabled
121
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
1-Enabled
1-Enabled
1-Enabled
1-Enabled
122
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
1-Enabled
1-Enabled
1-Enabled
123
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
unavailable. Redial
0-Disabled
1-Enabled
Features->General
It configures the interval (in seconds)
auto_redial.int Integer from Information->Auto
for the phone to wait before redial.
erval = 1 to 300 Redial Interval
The default value is 10.
(1~300s)
1-Enabled
124
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
Settings->Dial
dialplan.area It configures the minimum length of the
Integer from Plan->Area
_code.min_len number prefixed with the area code.
1 to 15 Code->Min Length
= The default value is 1.
(1-15)
125
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
(X ranges NumberX
from 1 to 10)
dialplan.dialn
String within Settings->Dial
ow.rule.X = It configures the dial now rule.
511 Plan->Dial-now->
(X ranges The default value is blank.
characters Rule
from 1 to 100)
Features->General
phone_setting It configures the delay time (in
Integer from Information->Time-
.dialnow_dela seconds) for the dial-now rule.
1 to 14 Out for Dial-Now
y= The default value is 1.
Rule
126
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
dialplan.repla
ce.replace.X String within It configures the alternate number to Settings->Dial
= 32 replace the entered number. Plan->Replace
from 1 to 100)
remote_phone
book.data.X.u
rl =
applicable to
SIP-T20P IP
phones)
remote_phone
book.data.X.n
ame =
applicable to
SIP-T20P IP
phones)
127
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
remote_phone
book.display_
It configures the display name of the
name =
remote phone book.
(not String within
If it is left blank, Remote Phone Book is
applicable to 99
displayed on the LCD screen at the
SIP-T20P, characters
path Menu->Directory.
SIP-T41P and
The default value is blank.
SIP-T42G IP
phones)
ldap.enable =
It enables or disables LDAP feature.
(not
applicable to 0-Disabled Directory->LDAP->
0 or 1
SIP-T19P and 1-Enabled Enable LDAP
ldap.name_filt
er = It configures the criteria for searching
the contact name attributes.
(not String within
Directory->LDAP->
applicable to 99 Example:
LDAP Name Filter
SIP-T19P and characters ldap.name_filter = (|(cn=%)(sn=%))
SIP-T20P IP The default value is blank.
phones)
ldap.host =
(not
IP address It configures the IP address or domain
applicable to Directory->LDAP->
or domain name of the LDAP server.
SIP-T19P and Server Address
name The default value is blank.
SIP-T20P IP
phones)
128
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
SIP-T19P and
SIP-T20P IP
phones)
ldap.user =
(not
String within It configures the user name for
applicable to Directory->LDAP->
99 accessing the LDAP server.
SIP-T19P and Username
characters The default value is blank.
SIP-T20P IP
phones)
ldap.passwor
d=
ldap.max_hits
=
It configures the maximum of the
(not Directory->LDAP->
Integer from search results returned by the LDAP
applicable to Max. Hits
1 to 32000 server to be displayed.
SIP-T19P and (1~32000)
The default value is 50.
SIP-T20P IP
phones)
129
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
ldap.version
=
(not
It configures the LDAP version. Directory->LDAP->
applicable to 2 or 3
The default value is 3. Protocol
SIP-T19P and
SIP-T20P IP
phones)
ldap.call_in_lo
It enables or disables the phone to
okup =
perform an LDAP search when
(not receiving an incoming call. Directory->LDAP->
ldap.ldap_sort
It enables or disables the phone to sort
=
the search results in alphabetical order
(not or numerical order. Directory->LDAP->
applicable to 0 or 1 LDAP Sorting
0-Disabled
SIP-T19P and Results
1-Enabled
SIP-T20P IP
The default value is 0.
phones)
130
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
features.fwd_
mode = It configures the call forward mode.
Features->
(not 0-Phone
0 or 1 Forward&DND->Fo
applicable to 1-Custom
rward->Mode
SIP-T19P IP The default value is 0.
phones)
131
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
SIP-T19P IP
phones)
Features->
String within It configures the DND on code when
features.dnd.o Forward&DND->
32 the DND mode is configured as Phone.
n_code = DND->DND On
characters The default value is Blank.
Code
Features->
String within It configures the DND off code when
features.dnd.o Forward&DND->
32 the DND mode is configured as Phone.
ff_code = DND->DND Off
characters The default value is Blank.
Code
132
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
1-Enabled
1-Enabled
133
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
features.remot
It enables or disables the phone to
e_phonebook.
perform a remote phone book search
Directory->Remote
enable =
when receiving an incoming call.
Phone Book->
(not 0 or 1
0-Disabled Search Remote
applicable to
1-Enabled Phonebook Name
SIP-T20P IP
The default value is 0.
phones)
features.remot
e_phonebook. It configures the interval (in seconds)
Directory->Remote
flash_time = Integer from for the phone to update the data of the
Phone Book->
(not 3600 to remote phone book from the remote
Search Flash Time
applicable to 2592000 phone book server.
(Seconds)
SIP-T20P IP The default value is 21600.
phones)
SIP-T20P IP Delay
0-Disabled
phones)
1-Enabled
134
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
features.head
set_training = It enables or disables dual headset
feature.
(not Features->General
Features->General
It configures the duration time (in
features.busy_ Information->Busy
0, 3 or 5 seconds) for the busy tone.
tone_delay = Tone Delay
The default value is 0.
(Seconds)
135
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
0-Disabled
1-Enabled
136
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
Example:
features.redial_tone = 125
1-Enbaled
Features->General
features.save_ 0 or 1 It enables or disables the phone to
Information->Save
137
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
0-Disabled
1-Enabled
138
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
139
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
140
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
1-Enabled
141
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
1-Enabled
wd = 1-Blank
2-Plaintext
features.picku
It enables or disables the phone to
p.group_picku
display the GPickup soft key when the
p_enable = Features->Call
phone is in the pre-dialing screen.
(not 0 or 1 Pickup->Group
0-Disabled
applicable to Call Pickup
1-Enabled
SIP-T20P IP
The default value is 0.
phones)
features.picku
It enables or disables the phone to
p.direct_picku
display the DPickup soft key when the
p_enable = Features->Call
phone is in the pre-dialing screen.
(not 0 or 1 Pickup->Directed
0-Disabled
applicable to Call Pickup
1-Enabled
SIP-T20P IP
The default value is 0.
phones)
142
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
(not call.
applicable to 0-Disabled
SIP-T20P IP
1-Enabled
phones)
The default value is 0.
1-Enabled
143
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
G726-32
G726-40
G723_53
_address.X.ip_ phone.
Directory->
IP address:
address = Example: Multicast IP->
port
(X ranges multicast.listen_address.1.ip_address Listening Address
from 1 to 10) = 224.5.6.20:10008
multicast.listen
It configures the label displayed on the
_address.X.la String within
LCD screen when receiving the Directory->
bel = 99
multicast paging. Multicast IP->Label
(X ranges characters
The default value is blank.
from 1 to 10)
144
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
phone_setting
.phone_lock.e It enables or disables keypad lock
nable = feature.
Features->Phone
phone_setting
It configures the keypad lock type.
.phone_lock.lo
ck_key_type = 0-All Keys Features->Phone
SIP-T4X IP
The default value is 0.
phones)
Features->Phone
phone_setting characters It configures the password for
Lock->Phone
.phone_lock.u within 15 unlocking the keypad.
Unlock PIN (0~15
nlock_pin = digits The default value is 123.
Digit)
key)
145
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
(only 1-Enabled
applicable to The default value is 0.
SIP-46G IP
phones)
Ring1.wav,
It configures the ring tone for the
Ring2.wav,
phone.
Ring3.wav,
Example:
phone_setting Ring4.wav, Settings->Preferen
phone_setting.ring_type = Ring1.wav
.ring_type = Ring5.wav ce->Ring Type
The default value is Ring1.wav.
Ring6.wav,
Note: Ring tones 6-8 are only
Ring7.wav,
applicable to SIP-T46G IP phones.
Ring8.wav
146
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
1-System logo
2-Custom logo
0-Disabled
1-Enabled
phone_setting
.lcd_logo.text
= String within Features->General
It configures a text logo.
(only 15 Information->Text
The default value is Yealink.
applicable to characters Logo
SIP-T20P IP
phones)
lcd_logo.url =
(not
URL within It configures the access URL of logo Features->General
applicable to
511 file. Information->
SIP-T20P and
characters The default value is blank. Upload Logo
SIP-T46G IP
phones)
lcd_logo.delet
e=
147
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
phone_setting
It configures the phone to go out or
.inactive_back
reduce intensity of the backlight on the
Settings->
light_level =
LCD screen after a period of inactivity.
Preference->
(only 0 or 1
0-Off Backlight Inactive
applicable to
1-Low Level
SIP-T46G IP
The default value is 1.
phones)
0-Always off
1-Always on
15-15s
30-30s
60-60s
phone_setting
120-120s
.backlight_tim
300-300s
e=
600-600s
(not 0, 1, 15, 30, Settings->Preferen
30-30s
60-60s
120-120s
300-300s
600-600s
1800-1800s
148
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
Ring6.wav
Ring7.wav
Ring8.wav
1-Use as normal
149
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
directory_setti
ng.url =
URL within It configures the access URL of the
(not Directory->
511 custom directory list file.
applicable to Setting->Directory
characters The default value is blank.
SIP-T20P IP
phones)
super_search.
url = Directory->
URL within It configures the access URL of the
(not Setting->Search
511 custom search source list in dialing file.
applicable to Source List In
characters The default value is blank.
SIP-T20P IP Dialing
phones)
150
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
Security->Trusted
URL within It configures the access URL of the
trusted_certific Certificates->Load
511 custom trusted certificate file.
ates.url = trusted certificates
characters The default value is blank.
file
local_contact.
It configures the access URL of the TAR
data_photo_t
file compressed from custom contact
ar.url = URL within
file and avatar TAR file.
(only 511
All avatars needed for contacts should
applicable to characters
be tarred in advance.
SIP-T46G IP
The default value is blank.
phones)
features.custo
It enables or disables Import Factory
m_factory_con 0 or 1
Configuration feature.
fig.enable =
151
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
0-Disabled
1-Enabled
account.X.out
_dialog_blf_en
able =
(SIP-T19P: X=1
It enables or disables the phone to
SIP-T20P/T21P:
handle NOTIFY messages out of the
X ranges from
BLF dialog for account X.
1 to 2.
0 or 1
0-Disabled
SIP-T22P/T26P/T
41P/T42G: X 1-Enabled
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.ena
ble =
(SIP-T19P: X=1
SIP-T20P/T21P:
X ranges from It enables or disables the account X.
1 to 2.
0-Disabled Account->Register
SIP-T22P/T26P/T 0 or 1
1-Enabled ->Line Active
41P/T42G: X
The default value is 0.
ranges from 1
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6)
152
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
account.X.lab
el =
(SIP-T19P: X=1
SIP-T20P/T21P:
X ranges from
1 to 2. String within It configures the label displayed on the
Account->Register
99 LCD screen for account X.
SIP-T22P/T26P/T
->Label
41P/T42G: X characters The default value is blank.
ranges from 1
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.dis
play_name =
(SIP-T19P: X=1
SIP-T20P/T21P:
X ranges from
1 to 2. String within It configures the display name for
Account->Register
99 account X.
SIP-T22P/T26P/T
->Display Name
41P/T42G: X characters The default value is blank.
ranges from 1
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.aut
h_name =
(SIP-T19P: X=1
SIP-T20P/T21P:
X ranges from
String within It configures the user name for register
1 to 2. Account->Register
99 authentication for account X.
->Register Name
SIP-T22P/T26P/T characters The default value is blank.
41P/T42G: X
ranges from 1
to 3.
SIP-T28P/T46G:
X ranges from
153
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
1 to 6)
account.X.use
r_name =
(SIP-T19P: X=1
SIP-T20P/T21P:
X ranges from
1 to 2. String within It configures the register user name for
Account->Register
32 account X.
SIP-T22P/T26P/T
->User Name
41P/T42G: X characters The default value is blank.
ranges from 1
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.pas
sword =
(SIP-T19P: X=1
SIP-T20P/T21P:
X ranges from
1 to 2. String within It configures the password for register
Account->Register
99 authentication for account X.
SIP-T22P/T26P/T
->Password
41P/T42G: X characters The default value is blank.
ranges from 1
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.tran
sport =
SIP-T28P/T46G:
154
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
X ranges from
1 to 6)
account.X.rere
gister_enable
=
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.nap
tr_build =
(SIP-T19P: X=1
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.fall
back.redunda
ncy_type = It configures the registration mode for
(SIP-T19P: X=1
account X.
0 or 1 0-Concurrent registration
SIP-T20P/T21P:
X ranges from 1-Successive registration
SIP-T22P/T26P/T
41P/T42G: X
155
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
ranges from 1
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.fall
back.timeout
=
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.sip_
server.Y.addre
ss =
(SIP-T19P: X=1
It configures the IP address or domain
SIP-T20P/T21P: name of SIP server Y for account X.
X ranges from
Example:
1 to 2.
IP address account.1.sip_server.1.address = Account->Register
SIP-T22P/T26P/T
or domain 10.2.1.128 ->SIP Server Y->
41P/T42G: X
name The default value is blank. Server Host
ranges from 1
to 3. Note: The old parameter
“account.X.sip_server_host” is also
SIP-T28P/T46G:
applicable to IP phones.
X ranges from
1 to 6.
Y ranges from
1 to 2)
156
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
SIP-T22P/T26P/T
41P/T42G: X
ranges from 1
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6.
Y ranges from
1 to 2)
account.X.sip_
server.Y.expire
s=
(SIP-T19P: X=1
SIP-T20P/T21P:
X ranges from
1 to 2. It configures the registration expiration
Integer from Account->Register
SIP-T22P/T26P/T time (in seconds) to SIP server Y for
30 to ->SIP Server Y->
41P/T42G: X account X.
2147483647 Server Expires
ranges from 1 The default value is 3600.
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6.
Y ranges from
1 to 2)
account.X.sip_
server.Y.retry_
counts =
It configures the times for the phone to
(SIP-T19P: X=1
retransmit the request when the SIP Account->Register
SIP-T20P/T21P:
Integer from server Y is unavailable or there is no ->SIP Server Y
X ranges from
0 to 20 response from the SIP server Y for ->Server Retry
1 to 2.
account X. Counts
SIP-T22P/T26P/T
The default value is 3.
41P/T42G: X
ranges from 1
to 3.
157
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
SIP-T28P/T46G:
X ranges from
1 to 6.
Y ranges from
1 to 2)
account.X.sip_
server.Y.failba
ck_timeout =
1 to 6.
Y ranges from
1 to 2)
158
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
account.X.sip_
server.Y.regist
er_on_enable
=
(SIP-T19P: X=1
41P/T42G: X 0-Disabled
Y ranges from
1 to 2)
account.X.stat
ic_cache_pri
=
SIP-T28P/T46G:
X ranges from
1 to 6)
159
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.dns
_cache_a.Y.na
me =
(SIP-T19P: X=1
SIP-T20P/T21P:
It configures the domain name of A
X ranges from
record Y in the DNS static cache for
1 to 2. Domain
account X.
SIP-T22P/T26P/T name
The default value is blank.
41P/T42G: X
It takes effect after a reboot.
ranges from 1
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.dns
_cache_a.Y.ip
=
(SIP-T19P: X=1
SIP-T20P/T21P:
It configures the IP address that the
X ranges from
domain name of A record Y maps to in
1 to 2.
IP address the DNS static cache for account X.
SIP-T22P/T26P/T
The default value is blank.
41P/T42G: X
It takes effect after a reboot.
ranges from 1
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6)
160
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
SIP-T22P/T26P/T
41P/T42G: X
ranges from 1
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.dns
_cache_srv.Y.n
ame =
(SIP-T19P: X=1
SIP-T20P/T21P:
X ranges from It configures the domain name of SRV
name account X.
SIP-T22P/T26P/T
41P/T42G: X It takes effect after a reboot.
ranges from 1
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.dns
_cache_srv.Y.p
ort =
(SIP-T19P: X=1
SIP-T20P/T21P:
X ranges from It configures the port to be used in SRV
SIP-T28P/T46G:
X ranges from
1 to 6)
161
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
account.X.dns
_cache_srv.Y.p
riority =
(SIP-T19P: X=1
SIP-T20P/T21P:
It configures the priority for the specific
X ranges from
host entry in SRV record Y for account
1 to 2. Integer from
X. Lower priority is more preferred.
SIP-T22P/T26P/T 0 to 65535
The default value is 0.
41P/T42G: X
It takes effect after a reboot.
ranges from 1
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.dns
_cache_srv.Y.t
arget =
(SIP-T19P: X=1
SIP-T20P/T21P:
X ranges from It configures the actual host for an A
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.dns
_cache_srv.Y.
It configures the weight of SRV record Y
weight =
for account X.
(SIP-T19P: X=1
When priorities are equal, weight is
SIP-T20P/T21P: Integer from
used to differentiate the preference.
X ranges from 0 to 65535
Higher weight is more preferred.
1 to 2.
The default value is 0.
SIP-T22P/T26P/T
It takes effect after a reboot.
41P/T42G: X
ranges from 1
162
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.dns
_cache_srv.Y.tt
l=
(SIP-T19P: X=1
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.dns
_cache_naptr.
Y.name =
(SIP-T19P: X=1
SIP-T20P/T21P:
It configures the domain name to
X ranges from
which NAPTR record Y refers in the
1 to 2. Domain
DNS static cache for account X.
SIP-T22P/T26P/T name
The default value is blank.
41P/T42G: X
It takes effect after a reboot.
ranges from 1
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6)
163
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
account.X.dns
_cache_naptr.
Y.order =
(SIP-T19P: X=1
SIP-T20P/T21P:
It configures the order of NAPTR record
X ranges from
Y for account X. NAPTR record with
1 to 2. Integer from
lower order is more preferred.
SIP-T22P/T26P/T 0 to 65535
The default value is 0.
41P/T42G: X
It takes effect after a reboot.
ranges from 1
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.dns
_cache_naptr.
Y.preference
=
(SIP-T19P: X=1
It configures the preference of NAPTR
SIP-T20P/T21P:
record Y for account X. NAPTR record
X ranges from
Integer from with lower preference is more
1 to 2.
0 to 65535 preferred.
SIP-T22P/T26P/T
The default value is 0.
41P/T42G: X
It takes effect after a reboot.
ranges from 1
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6)
164
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
account.X.dns
_cache_naptr.
Y.replace =
(SIP-T19P: X=1
SIP-T20P/T21P:
It configures a domain name to be
X ranges from
used for the next SRV query in NAPTR
1 to 2. Domain
record Y for account X.
SIP-T22P/T26P/T name
The default value is blank.
41P/T42G: X
It takes effect after a reboot.
ranges from 1
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.dns
_cache_naptr.
Y.service =
(SIP-T19P: X=1
SIP-T20P/T21P:
It configures the transport protocol
X ranges from
String within available for SIP in NAPTR record Y for
1 to 2.
32 account X.
SIP-T22P/T26P/T
characters The default value is blank.
41P/T42G: X
It takes effect after a reboot.
ranges from 1
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.dns
_cache_naptr.
Y.ttl = It configures the time interval that
41P/T42G: X
ranges from 1
165
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.srv_
ttl_timer_enab
le =
(SIP-T19P: X=1
It enables or disables the phone to
SIP-T20P/T21P: refresh the DNS-SRV query record at
X ranges from the regular time for account X.
1 to 2.
0 or 1 0-Disabled
SIP-T22P/T26P/T
1-Enabled
41P/T42G: X
The default value is 0.
ranges from 1
It takes effect after a reboot.
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.out
bound_proxy_
enable =
(SIP-T19P: X=1
It enables or disables the phone to use
SIP-T20P/T21P:
the outbound proxy server for account
X ranges from Account->Register
X.
1 to 2. ->Enable
0 or 1
0-Disabled Outbound Proxy
SIP-T22P/T26P/T
41P/T42G: X 1-Enabled Server
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.out
bound_host = It configures the IP address or domain
IP address Account->Register
(SIP-T19P: X=1 name of the outbound proxy server for
or domain ->Outbound Proxy
account X.
SIP-T20P/T21P:
name Server
X ranges from The default value is blank.
1 to 2.
166
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
SIP-T22P/T26P/T
41P/T42G: X
ranges from 1
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.out
bound_port =
(SIP-T19P: X=1
SIP-T20P/T21P:
X ranges from
1 to 2. It configures the port of the outbound Account->Register
Integer from
proxy server for account X. ->Outbound Proxy
SIP-T22P/T26P/T
0 to 65535
41P/T42G: X The default value is 5060. Server->Port
ranges from 1
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6)
voice_mail.nu
mber.X =
(SIP-T19P: X=1
SIP-T20P/T21P:
X ranges from
1 to 2. String within It configures the voice mail number for Account->
99 account X. Advanced->Voice
SIP-T22P/T26P/T
41P/T42G: X characters The default value is blank. Mail
ranges from 1
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.pro
xy_require = String within It configures the proxy server for
Account->Basic->
(SIP-T19P: X=1 256 account X.
Proxy Require
characters The default value is blank.
SIP-T20P/T21P:
X ranges from
167
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
1 to 2.
SIP-T22P/T26P/T
41P/T42G: X
ranges from 1
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.sip_
trust_ctrl =
(SIP-T19P: X=1
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.ano
nymous_call =
(SIP-T19P: X=1
SIP-T20P/T21P:
It enables or disables anonymous call
X ranges from
feature for account X.
1 to 2.
Account->Basic->
0 or 1 0-Disabled
SIP-T22P/T26P/T
Local Anonymous
41P/T42G: X 1-Enabled
SIP-T28P/T46G:
X ranges from
1 to 6)
168
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.ano
nymous_call_o
ncode =
(SIP-T19P: X=1
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.ano
nymous_call_o
ffcode =
(SIP-T19P: X=1
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6)
169
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
account.X.reje
ct_anonymous
_call =
(SIP-T19P: X=1
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.ano
nymous_reject
_oncode =
(SIP-T19P: X=1
SIP-T20P/T21P:
X ranges from It configures the code for activating the Account->Basic->
String within
1 to 2. server-side anonymous call rejection Anonymous Call
32
feature for account X. Rejection->On
SIP-T22P/T26P/T
characters
41P/T42G: X The default value is blank. Code
ranges from 1
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.ano
nymous_reject
_offcode =
SIP-T22P/T26P/T
41P/T42G: X
ranges from 1
170
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.dnd
.enable =
(SIP-T20P/T21P:
X ranges from
1 to 2.
It enables or disables DND feature for
SIP-T22P/T26P/T
account X when the DND mode is
41P/T42G: X
configured as Custom. Features->Forwar
ranges from 1
0 or 1 d& DND->DND
to 3. 0-Disabled
->DND Status
SIP-T28P/T46G: 1-Enabled
(not
applicable to
SIP-T19P IP
phones)
account.X.dnd
.on_code =
(SIP-T20P/T21P:
X ranges from
1 to 2.
SIP-T22P/T26P/T
41P/T42G: X It configures the DND on code for
String within Features->Forwar
ranges from 1 account X when the DND mode is
32 d& DND->DND On
to 3. configured as Custom.
characters Code
SIP-T28P/T46G: The default value is blank.
X ranges from
1 to 6)
(not
applicable to
SIP-T19P IP
phones)
account.X.dnd String within It configures the DND off code for Features->Forwar
.off_code = 32 account X when the DND mode is d& DND->DND Off
171
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
SIP-T22P/T26P/T
41P/T42G: X
ranges from 1
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6)
(not
applicable to
SIP-T19P IP
phones)
account.X.alw
ays_fwd.enab
le =
(SIP-T20P/T21P:
X ranges from
1 to 2. It enables or disables always forward
feature for account X when the call
SIP-T22P/T26P/T
forward mode is configured as
41P/T42G: X Features->Forwar
Custom.
ranges from 1 0 or 1 d& DND->Always
to 3. 0-Disabled Forward->On/Off
SIP-T28P/T46G: 1-Enabled
(not
applicable to
SIP-T19P IP
phones)
account.X.alw
ays_fwd.targe
It configures the target number the
t=
String within phone forwards all incoming calls to Features->Forwar
(SIP-T20P/T21P:
32 for account X when the call forward d& DND->Always
X ranges from
characters mode is configured as Custom. Forward->Target
1 to 2.
The default value is blank.
SIP-T22P/T26P/T
41P/T42G: X
172
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
ranges from 1
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6)
(not
applicable to
SIP-T19P IP
phones)
account.X.bus
y_fwd.enable
=
(SIP-T20P/T21P:
X ranges from
1 to 2. It enables or disables busy forward
feature for account X when the call
SIP-T22P/T26P/T
forward mode is configured as
41P/T42G: X Features->Forwar
Custom.
ranges from 1 0 or 1 d& DND->Busy
to 3. 0-Disabled Forward->On/Off
SIP-T28P/T46G: 1-Enabled
(not
applicable to
SIP-T19P IP
phones)
account.X.bus
y_fwd.target
=
(SIP-T20P/T21P:
It configures the target number the
X ranges from
phone forwards incoming calls to
1 to 2. String within Features->Forwar
when busy for account X when the call
SIP-T22P/T26P/T 32 d& DND->Busy
forward mode is configured as
41P/T42G: X characters Forward->Target
Custom.
ranges from 1
The default value is blank.
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6)
173
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
(not
applicable to
SIP-T19P IP
phones)
account.X.tim
eout_fwd.ena
ble =
(SIP-T20P/T21P:
X ranges from
1 to 2. It enables or disables no answer
forward feature for account X when
SIP-T22P/T26P/T
the call forward mode is configured as Features->Forwar
41P/T42G: X
Custom. d& DND->No
ranges from 1 0 or 1
Answer Forward->
to 3. 0-Disabled
On/Off
SIP-T28P/T46G: 1-Enabled
(not
applicable to
SIP-T19P IP
phones)
account.X.tim
eout_fwd.targ
et =
(SIP-T20P/T21P:
X ranges from
1 to 2.
It configures the target number the
SIP-T22P/T26P/T
phone forwards incoming calls to after Features->Forwar
41P/T42G: X String within
a period of ring time for account X d& DND->No
ranges from 1 32
when the call forward mode is Answer Forward->
to 3. characters
configured as Custom. Target
SIP-T28P/T46G:
The default value is blank.
X ranges from
1 to 6)
(not
applicable to
SIP-T19P IP
phones)
174
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
account.X.tim
eout_fwd.time
out =
(SIP-T20P/T21P:
X ranges from
1 to 2. It configures ring times (N) to wait
(not
applicable to
SIP-T19P IP
phones)
account.X.alw
ays_fwd.off_c
ode =
(SIP-T20P/T21P:
X ranges from
1 to 2.
X ranges from
1 to 6)
(not
applicable to
SIP-T19P IP
phones)
175
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
1 to 2.
SIP-T22P/T26P/T
41P/T42G: X
ranges from 1
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6)
(not
applicable to
SIP-T19P IP
phones)
account.X.bus
y_fwd.off_cod
e=
(SIP-T20P/T21P:
X ranges from
1 to 2.
SIP-T22P/T26P/T
It configures the busy forward off code Features->Forwar
41P/T42G: X String within
for account X when the call forward d& DND->Busy
ranges from 1 32
mode is configured as Custom. Forward ->Off
to 3. characters
The default value is blank. Code
SIP-T28P/T46G:
X ranges from
1 to 6)
(not
applicable to
SIP-T19P IP
phones)
account.X.bus
y_fwd.on_cod
e=
41P/T42G: X
ranges from 1
to 3.
176
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
SIP-T28P/T46G:
X ranges from
1 to 6)
(not
applicable to
SIP-T19P IP
phones)
account.X.tim
eout_fwd.off_c
ode =
(SIP-T20P/T21P:
X ranges from
1 to 2.
X ranges from
1 to 6)
(not
applicable to
SIP-T19P IP
phones)
account.X.tim
eout_fwd.on_c
ode =
(SIP-T20P/T21P:
X ranges from
1 to 2. It configures the no answer forward on
Features->Forwar
SIP-T22P/T26P/T String within code for account X when the call
d& DND->No
41P/T42G: X 32 forward mode is configured as
Answer Forward
ranges from 1 characters Custom.
->On Code
to 3. The default value is blank.
SIP-T28P/T46G:
X ranges from
1 to 6)
(not
applicable to
177
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
SIP-T19P IP
phones)
account.X.sip_
listen_port =
(SIP-T19P: X=1
SIP-T20P/T21P:
X ranges from
1 to 2. Integer from It configures the local SIP port for Account->
1024 to account X. Advanced->Local
SIP-T22P/T26P/T
41P/T42G: X 65535 The default value is 5060. SIP Port
ranges from 1
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.100
rel_enable =
(SIP-T19P: X=1
SIP-T20P/T21P:
It enables or disables 100 reliable
X ranges from
retransmission feature for account X.
1 to 2. Account->
0 or 1 0-Disabled Advanced->
SIP-T22P/T26P/T
41P/T42G: X 1-Enabled Retransmission
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.sub
scribe_mwi =
178
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.sub
scribe_mwi_e
xpires =
(SIP-T19P: X=1
SIP-T20P/T21P:
X ranges from Account->
It configures the interval (in seconds)
1 to 2. Integer from Advanced->MWI
of MWI subscription for account X.
SIP-T22P/T26P/T 0 to 84600 Subscription Period
The default value is 3600.
41P/T42G: X (Seconds)
ranges from 1
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.cid_
source = It configures the source caller identity
(SIP-T19P: X=1 for presentation when receiving an
1 to 6)
account.X.cid_
source_privac It enables or disables the phone to
SIP-T22P/T26P/T
179
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
41P/T42G: X
ranges from 1
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.cid_
source_ppi =
(SIP-T19P: X=1
It enables or disables the phone to
SIP-T20P/T21P: process the P-Preferred-Identity header
X ranges from for caller identity presentation when
1 to 2. receiving an incoming call for account
SIP-T22P/T26P/T 0 or 1 X.
41P/T42G: X 0-Disabled
ranges from 1
1-Enabled
to 3.
The default value is 1.
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.cp_
source =
(SIP-T19P: X=1
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.ses
It enables or disables the session timer
sion_timer.ena
for account X.
Account->
ble =
0 or 1 0-Disabled Advanced->
(SIP-T19P: X=1
1-Enabled Session Timer
SIP-T20P/T21P:
The default value is 0.
X ranges from
180
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
1 to 2.
SIP-T22P/T26P/T
41P/T42G: X
ranges from 1
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.ses
sion_timer.exp
ires =
(SIP-T19P: X=1
SIP-T20P/T21P:
X ranges from It configures the interval (in seconds) Account->
1 to 2. Integer from for refreshing the SIP session for Advanced->
30 to 7200 account X. Session Expires
SIP-T22P/T26P/T
41P/T42G: X The default value is 1800. (30~7200s)
ranges from 1
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.ses
sion_timer.refr
esher =
(SIP-T19P: X=1
SIP-T28P/T46G:
X ranges from
1 to 6)
181
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
SIP-T20P/T21P: 1-Enabled
X ranges from The default value is 0.
1 to 2.
SIP-T22P/T26P/T
41P/T42G: X
ranges from 1
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.srtp
_encryption =
(SIP-T19P: X=1
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.pti
me =
(SIP-T19P: X=1
SIP-T20P/T21P:
X ranges from
1 to 2. 0 (Disabled), It configures the RTP packet time for Account->
10, 20, 30, account X. Advanced->PTime
SIP-T22P/T26P/T
41P/T42G: X 40, 50 or 60 The default value is 20. (ms)
ranges from 1
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6)
182
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
account.X.bla
_number =
(SIP-T19P: X=1
SIP-T20P/T21P:
X ranges from
1 to 2. String within It configures the BLA number for Account->
99 account X. Advanced->BLA
SIP-T22P/T26P/T
41P/T42G: X characters The default value is blank. Number
ranges from 1
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.bla
_subscribe_pe
riod =
(SIP-T19P: X=1
SIP-T20P/T21P:
X ranges from
It configures the period (in seconds) of Account->
1 to 2. Integer from
BLA subscription for account X. Advanced->BLA
SIP-T22P/T26P/T 60 to 7200
The default value is 300. Subscription Period
41P/T42G: X
ranges from 1
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.regi
ster_mac =
(SIP-T19P: X=1
It enables or disables the phone to
SIP-T20P/T21P: carry the MAC address in the
X ranges from REGISTER message for account X. Account->
1 to 2. 0 or 1 Advanced->SIP
0-Disabled
Send MAC
SIP-T22P/T26P/T
1-Enabled
41P/T42G: X
The default value is 0.
ranges from 1
to 3.
SIP-T28P/T46G:
183
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
X ranges from
1 to 6)
account.X.regi
ster_line =
(SIP-T19P: X=1
SIP-T22P/T26P/T 0 or 1 Advanced->SIP
0-Disabled
41P/T42G: X Send Line
1-Enabled
ranges from 1
The default value is 0.
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.dial
oginfo_callpic
kup =
(SIP-T20P/T21P:
X ranges from
1 to 2.
It enables or disables the phone to
SIP-T22P/T26P/T pick up a call according to the SIP
Account->
41P/T42G: X header of dialog-info for account X.
Advanced->
ranges from 1 0 or 1
0-Disabled Dialog Info Call
to 3.
1-Enabled Pickup
SIP-T28P/T46G:
The default value is 0.
X ranges from
1 to 6)
(not
applicable to
SIP-T19P IP
phones)
account.X.gro
up_pickup_co
String within It configures the group pickup code for Account->
de =
32 account X. Advanced->Group
(SIP-T19P: X=1
characters The default value is blank. Call Pickup Code
SIP-T20P/T21P:
X ranges from
184
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
1 to 2.
SIP-T22P/T26P/T
41P/T42G: X
ranges from 1
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.dire
ct_pickup_cod
e=
(SIP-T19P: X=1
SIP-T20P/T21P:
X ranges from Account->
String within It configures the directed pickup code
1 to 2. Advanced->
32 for account X.
SIP-T22P/T26P/T Directed Call
characters The default value is blank.
41P/T42G: X Pickup Code
ranges from 1
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.aut
o_answer =
(SIP-T19P: X=1
SIP-T20P/T21P:
It enables or disables auto answer
X ranges from
feature for account X.
1 to 2.
Account->Basic->
0 or 1 0-Disabled
SIP-T22P/T26P/T
Auto Answer
41P/T42G: X 1-Enabled
SIP-T28P/T46G:
X ranges from
1 to 6)
185
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
call.
account.X.mis
sed_calllog =
(SIP-T19P: X=1
SIP-T20P/T21P:
It enables or disables the phone to
X ranges from
record the missed call of account X.
1 to 2.
Account->Basic->
0 or 1 0-Disabled
SIP-T22P/T26P/T
Missed Call Log
41P/T42G: X 1-Enabled
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.sub
scribe_mwi_to
_vm =
(SIP-T19P: X=1
It enables or disables the phone to
SIP-T20P/T21P: subscribe to the voice mail number for
X ranges from the message waiting indicator for Account->
1 to 2. account X. Advanced->
0 or 1
SIP-T22P/T26P/T Subscribe MWI To
0-Disabled
41P/T42G: X Voice Mail
1-Enabled
ranges from 1
The default value is 0.
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.reg
_fail_retry_inte
rval =
It configures the interval (in seconds) Account->
(SIP-T19P: X=1
Integer from for the phone to retry to register Advanced->SIP
SIP-T20P/T21P: account X when registration fails.
0 to 1800 Registration Retry
X ranges from
The default value is 30. Timer (0~1800s)
1 to 2.
SIP-T22P/T26P/T
41P/T42G: X
186
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
ranges from 1
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.con
f_type =
(SIP-T19P: X=1
SIP-T20P/T21P:
It configures the conference type for
X ranges from
account X.
1 to 2. Account->
0 or 2 0-Local Conference Advanced->
SIP-T22P/T26P/T
41P/T42G: X 2-Network Conference Conference Type
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.con
f_uri =
(SIP-T19P: X=1
SIP-T20P/T21P:
X ranges from
1 to 2. SIP URI It configures the network conference Account->
within 511 URI for account X. Advanced->
SIP-T22P/T26P/T
41P/T42G: X characters The default value is blank. Conference URI
ranges from 1
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.blf.s
ubscribe_peri
od = Integer from It configures the period (in seconds) of
X ranges from
1 to 2.
187
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
SIP-T22P/T26P/T
41P/T42G: X
ranges from 1
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.blf.s
ubscribe_even
t=
(SIP-T19P: X=1
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.sip_
server_type =
(SIP-T19P: X=1
It configures the SIP server type for
SIP-T20P/T21P:
account X.
X ranges from
0-Default
1 to 2. Account->
0, 2, 4 or 6 2-BroadSoft Advanced->SIP
SIP-T22P/T26P/T
41P/T42G: X 4-Cosmocom Server Type
account.X.mus
SIP URI It configures the URI of the Music On Account->
ic_server_uri
within 256 Hold server for account X. Advanced->Music
=
characters The default value is blank. Server URI
(SIP-T19P: X=1
188
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
SIP-T20P/T21P:
X ranges from
1 to 2.
SIP-T22P/T26P/T
41P/T42G: X
ranges from 1
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.dtm
f.type =
(SIP-T19P: X=1
It configures the DTMF type for account
SIP-T20P/T21P:
X.
X ranges from
0-INBAND
1 to 2. Account->
0, 1, 2 or 3 1-RFC2833 Advanced->DTMF
SIP-T22P/T26P/T
41P/T42G: X 2-SIP INFO Type
account.X.dtm
f.dtmf_payloa
d=
(SIP-T19P: X=1
SIP-T20P/T21P:
X ranges from Account->
It configures the RFC2833 payload for
1 to 2. Integer from Advanced->DTMF
account X.
SIP-T22P/T26P/T 96 to 127 Payload Type
The default value is 101.
41P/T42G: X (96~127)
ranges from 1
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6)
189
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
(SIP-T19P: X=1 INFO”, “AUTO or SIP INFO” for account Info Type
X.
SIP-T20P/T21P:
X ranges from 0-Disabled
1 to 2. 1-DTMF-Relay
SIP-T22P/T26P/T 2-DTMF
41P/T42G: X 3-Telephone-Event
ranges from 1
The default value is 0.
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.nat.
nat_traversal
=
(SIP-T19P: X=1
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.nat.
stun_server =
(SIP-T19P: X=1
SIP-T20P/T21P:
X ranges from
IP address It configures the IP address or domain
1 to 2. Account->Register
or domain name of the STUN server for account X.
->STUN Server
SIP-T22P/T26P/T name The default value is blank.
41P/T42G: X
ranges from 1
to 3.
SIP-T28P/T46G:
X ranges from
190
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
1 to 6)
account.X.nat.
stun_port =
(SIP-T19P: X=1
SIP-T20P/T21P:
X ranges from
1 to 2. Integer from It configures the port of the STUN Account->Register
1024 to server for account X. ->STUN Server
SIP-T22P/T26P/T
41P/T42G: X 65000 The default value is 3478. ->Port
ranges from 1
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.nat.
It configures the type of keep-alive
udp_update_e
packets sent by the phone to the NAT
nable =
device to keep the communication port
(SIP-T19P: X=1 open so that NAT can continue to
SIP-T20P/T21P: function for account X.
X ranges from 0-Dsiabled
Account->
1 to 2.
0, 1, 2 or 3 1-Default: the phone sends UDP Advanced->Keep
SIP-T22P/T26P/T packets to the server. Alive Type
41P/T42G: X
2-Option: the phone sends SIP OPTION
ranges from 1
packets to the server.
to 3.
3-Notify: the phone sends SIP NOTIFY
SIP-T28P/T46G:
packets to the server.
X ranges from
The default value is 1.
1 to 6)
account.X.nat.
udp_update_ti
me =
SIP-T22P/T26P/T
41P/T42G: X
ranges from 1
191
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.nat.
rport =
(SIP-T19P: X=1
SIP-T20P/T21P:
It enables or disables NAT Rport
X ranges from
feature for account X.
1 to 2.
Account->
0 or 1 0-Disabled
SIP-T22P/T26P/T
Advanced->RPort
41P/T42G: X 1-Enabled
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.adv
anced.timer_t
1=
(SIP-T19P: X=1
SIP-T20P/T21P:
X ranges from Account->
It configures the session timer T1 (in
1 to 2. Float from Advanced->SIP
seconds) for account X.
SIP-T22P/T26P/T 0.5~10s Session Timer T1
The default value is 0.5.
41P/T42G: X (0.5~10s)
ranges from 1
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.adv
anced.timer_t
Account->
2= It configures the session timer T2 (in
Float from Advanced->SIP
(SIP-T19P: X=1 seconds) for account X.
2~40s Session Timer T2
SIP-T20P/T21P: The default value is 4.
(2~40s)
X ranges from
1 to 2.
192
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
SIP-T22P/T26P/T
41P/T42G: X
ranges from 1
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.adv
anced.timer_t
4=
(SIP-T19P: X=1
SIP-T20P/T21P:
X ranges from Account->
It configures the session timer T4 (in
1 to 2. Float from Advanced->SIP
seconds) for account X.
SIP-T22P/T26P/T 2.5~60s Session Timer T4
The default value is 5.
41P/T42G: X (2.5~60s)
ranges from 1
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.aler
t_info_url_ena
ble =
(SIP-T19P: X=1
It enables or disables the distinctive
SIP-T20P/T21P:
ring tones by the Alert-Info SIP header
X ranges from Account->
for account X.
1 to 2. Advanced->
0 or 1
0-Disabled Distinctive Ring
SIP-T22P/T26P/T
41P/T42G: X 1-Enabled Tones
SIP-T28P/T46G:
X ranges from
1 to 6)
193
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
tones.
0-Disabled
1-Enabled
account.X.ring
tone.ring_type
It configures a ring tone for account X.
=
Common, Example:
(SIP-T19P: X=1 Ring1.wav,
account.1.ringtone.ring_type =
SIP-T20P/T21P: Ring2.wav,
Ring3.wav means configuring
X ranges from Ring3.wav
Ring3.wav for account1.
1 to 2. Ring4.wav Account->Basic->
account.1.ringtone.ring_type =
SIP-T22P/T26P/T Ring Type
Ring5.wav Common means account1 will use the
41P/T42G: X
Ring6.wav, ring tone selected for the phone.
ranges from 1
Ring7.wav, The default value is Common.
to 3.
Ring8.wav Note: Ring tones 6-8 are only
SIP-T28P/T46G:
applicable to SIP-T46G IP phones.
X ranges from
1 to 6)
194
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
SIP-T4X: Y G726-24;
195
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
SIP-T20P/T21P: account.1.codec.1.priority =1
X ranges from For SIP-T20P/T22P/T26P/T28P/T4X IP
1 to 2. Integer from phones:
196
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
Example:
account.1.codec.1.rtpmap = 0
account.X.cod
ec.Y.rtpmap = For SIP-T20P/T22P/T26P/T28P/T4X IP
phones:
(SIP-T19P: X=1
When Y=1, the default value is 0;
SIP-T20P/T21P:
X ranges from When Y=2, the default value is 8;
197
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
SIP-T22P/T26P/T
41P/T42G: X
ranges from 1
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.pict
ure_info_enab
It enables or disables the phone to
le =
download the picture information for
(SIP-T46G: X account X when receiving an incoming
ranges from 1 call or during a call.
0 or 1
to 6)
0-Disabled
(only
1-Enabled
applicable to
The default value is 0.
SIP-T46G IP
phones)
account.X.co
mpact_heade
r_enable =
(SIP-T19P: X=1
It enables or disables the phone to
SIP-T20P/T21P:
support compact SIP header for
X ranges from
account X.
1 to 2.
0 or 1
0-Disabled
SIP-T22P/T26P/T
41P/T42G: X 1-Enabled
SIP-T28P/T46G:
X ranges from
1 to 6)
198
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
SIP-T22P/T26P/T holding
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.acd
.enable =
(SIP-T19P: X=1
SIP-T20P/T21P:
It enables or disables ACD feature for
X ranges from
account X.
1 to 2.
0 or 1 0-Disabled
SIP-T22P/T26P/T
41P/T42G: X 1-Enabled
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.acd
.available =
(SIP-T19P: X=1
It enables or disables the phone to
SIP-T20P/T21P:
display the available and unavailable
X ranges from
soft keys for account X after the phone
1 to 2.
logs into the ACD system.
SIP-T22P/T26P/T 0 or 1
0-Disabled
41P/T42G: X
ranges from 1 1-Enabled
SIP-T28P/T46G:
X ranges from
1 to 6)
199
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
account.X.sub
scribe_acd_ex
pires =
(SIP-T19P: X=1
SIP-T20P/T21P:
X ranges from Account->
It configures the period (in seconds) of
1 to 2. Integer from Advanced->ACD
ACD subscription for account X.
SIP-T22P/T26P/T 120 to 3600 Subscrip Period
The default value is 1800.
41P/T42G: X (120~3600s)
ranges from 1
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6)
200
Appendix
The following table lists configuration parameters that are integrated with BroadSoft
platform. For more information on BroadSoft features, refer to
Yealink_IP_Phones_Deployment_Guide_for_BroadSoft_UC-One_Environment.
Permitted
Parameter Descriptions Web Setting Path
Values
0-Disabled
bw.enable = 0 or 1
1-Enabled
features.uc_us
ername = Configures the user name for UC Directory->
String within
authentication. Network
(only
99
applicable to The default value is blank. Directory->UC
characters
SIP-T46G IP It takes effect after a reboot. Username
phones)
features.uc_p
assword = It configures the password for UC Directory->
String within
authentication. Network
(only
32
applicable to The default value is blank. Directory->UC
characters
SIP-T46G IP It takes effect after a reboot. Password
phones)
features.confi
It enables or disables extended length
g_dsskey_len
of the label displayed on the idle LCD
gth =
screen for the line key.
(only 0 or 1
0-Disabled
applicable to
1-Enabled
SIP-T46G IP
The default value is 0.
phones)
201
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
0-Disabled
1-Enabled
202
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
bw_phoneboo
k.group_enabl It enables or disables the phone to
bw_phoneboo
k.group_displ
ayname = String within It configures the display name on the Directory->
SIP-T20P IP
phones)
bw_phoneboo
k.enterprise_e It enables or disables the phone to
display the enterprise directory. Directory->
nable =
Network
(not 0 or 1 0-Disabled
Directory->Enterpri
applicable to 1-Enabled
se
SIP-T20P IP The default value is 1.
phones)
bw_phoneboo
k.enterprise_d
Directory->
isplayname = String within It configures the display name on the
Network
(not 99 LCD screen for the enterprise directory.
Directory->Enterpri
applicable to characters The default value is Enterprise.
se
SIP-T20P IP
phones)
bw_phoneboo
k.group_com
It enables or disables the phone to
mon_enable Directory->
display the group common directory.
= Network
0 or 1 0-Disabled
(not Directory->Group
1-Enabled
applicable to Common
The default value is 1.
SIP-T20P IP
phones)
203
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
bw_phoneboo
k.group_com
mon_displayn It configures the display name on the Directory->
String within
ame = LCD screen for the group common Network
99
(not directory. Directory->Group
characters
applicable to The default value is GroupCommon. Common
SIP-T20P IP
phones)
bw_phoneboo
k.enterprise_c It enables or disables the phone to
bw_phoneboo
k.enterprise_c
It configures the display name on the
ommon_displ Directory->
String within LCD screen for the enterprise common
ayname = Network
99 directory.
(not Directory->Enterpri
characters The default value is
applicable to se Common
EnterpriseCommon.
SIP-T20P IP
phones)
bw_phoneboo
k.personal_en It enables or disables the phone to
display the personal directory. Directory->
able=
Network
(not 0 or 1 0-Disabled
Directory->Person
applicable to 1-Enabled
al
SIP-T20P IP The default value is 1.
phones)
bw_phoneboo
k.personal_dis
Directory->
playname= String within It configures the display name on the
Network
(not 99 LCD screen for the personal directory.
Directory->Person
applicable to characters The default value is Personal.
al
SIP-T20P IP
phones)
204
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
bw_phoneboo
It enables or disables custom directory
k.custom = Directory->
feature.
(not Network
0 or 1 0-Disabled
applicable to Directory->Enable
1-Enabled
SIP-T20P IP Custom Directory
The default value is 0.
phones)
directory.upd
ate_time_inter It configures the interval (in minutes)
val = for the phone to update the data of the
Integer from
(not BroadSoft directory from the BroadSoft
2 to 43200
applicable to server.
bw_phoneboo
k.call_log_ena It enables or disables BroadSoft call
(not 0 or 1 0-Disabled
applicable to 1-Enabled
SIP-T20P IP The default value is 0.
phones)
call_park.ena
It enables or disables the phone to
ble=
display the Park soft key during a call.
(not Features->Call
0 or 1 0-Disabled
applicable to Pickup->Call Park
1-Enabled
SIP-T20P IP
The default value is 0.
phones)
call_park.park
It enables or disables the phone to
_visual_notify_ Features->Call
display a parked indicator when a call
enable = Pickup->Visual
0 or 1 is parked against its line.
(not Alert for Parked
0-Disabled
applicable to Call
1-Enabled
SIP-T20P IP
205
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
account.X.blf.
blf_list_uri =
(SIP-T20P/T21P:
X ranges from
1 to 2.
SIP-T22P/T26P/T
41P/T42G: X
SIP URI It configures the BLF List URI to monitor Account->
ranges from 1
within 256 a list of users for account X. Advanced->BLF
to 3.
characters The default value is blank. List URI
SIP-T28P/T46G:
X ranges from
1 to 6)
(not
applicable to
SIP-T19P IP
phones)
account.X.blf_l
ist_code =
(SIP-T20P/T21P:
It configures the feature access code
X ranges from String within Account->
for directed call pickup (default: *97)
1 to 2. 32 Advanced->BLF
for account X.
SIP-T22P/T26P/T characters List Code
The default value is blank.
41P/T42G: X
ranges from 1
to 3.
206
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
SIP-T28P/T46G:
X ranges from
1 to 6)
(not
applicable to
SIP-T19P IP
phones)
account.X.blf_l
ist_barge_in_c
ode =
(SIP-T20P/T21P:
X ranges from
1 to 2.
SIP-T22P/T26P/T
It configures the feature access code
41P/T42G: X String within Account->
for directed call pickup with barge-in
ranges from 1 32 Advanced->BLF
(default: *33) for account X.
to 3. characters List Barge In Code
The default value is blank.
SIP-T28P/T46G:
X ranges from
1 to 6)
(not
applicable to
SIP-T19P IP
phones)
phone_setting
It enables or disables the phone to
.auto_blf_list_
automatically configure the BLF list
enable =
keys in order.
(not 0 or 1
0-Disabled
applicable to
1-Enabled
SIP-T19P IP
The default value is 1.
phones)
phone_setting
It configures the order of BLF list keys
.blf_list_seque
assigned automatically.
nce_type =
0-Line Keys->Memory
(only
0 or 1 Keys->Extension Keys
applicable to
1-Extension Keys->Memory
SIP-T26P,
Keys->Line Keys
SIP-T28P and
Memory keys are not applicable to
SIP-T46G IP
207
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
account.X.sha
red_line =
(SIP-T19P: X=1
SIP-T20P/T21P:
It enables or disables Broadsoft SCA
X ranges from
feature for account X.
1 to 2. Account->
0 or 1 0-Disabled Advanced->Share
SIP-T22P/T26P/T
41P/T42G: X 1-Broadsoft SCA d Line
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.acd
.initial_state =
(SIP-T19P: X=1
SIP-T20P/T21P:
It configures the initial agent state for
X ranges from
account X.
1 to 2.
1 or 2 1-Avaliable
SIP-T22P/T26P/T
41P/T42G: X 2-Unavailable
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.acd
.unavailable_r
eason_enable
It enables or disables unavailable
=
reason code feature for account X.
(SIP-T19P: X=1
0 or 1 0-Disabled
SIP-T20P/T21P:
1-Enabled
X ranges from
The default value is 0.
1 to 2.
SIP-T22P/T26P/T
41P/T42G: X
208
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
ranges from 1
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.rea
son_code.Y =
(SIP-T19P: X=1
SIP-T20P/T21P:
X ranges from
It configures the unavailable code
1 to 2.
which must match one of the codes
SIP-T22P/T26P/T Integer from
configured on BroadWorks for account
41P/T42G: X 1 to
X.
ranges from 1 2147483647
The value Y must be continuous.
to 3.
The default value is blank.
SIP-T28P/T46G:
X ranges from
1 to 6.
Y ranges from
1 to 100)
account.X.rea
son_code_na
me.Y =
(SIP-T19P: X=1
SIP-T20P/T21P:
X ranges from It configures the unavailable reason
SIP-T28P/T46G:
X ranges from
1 to 6.
Y ranges from
1 to 100)
209
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
fo_enable = 0-Disabled
SIP-T22P/T26P/T
41P/T42G: X
ranges from 1
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.call
_center.show_
call_info_time
=
(SIP-T19P: X=1
SIP-T20P/T21P:
It configures the interval (in seconds)
X ranges from
Integer from to specify how long the call center call
1 to 2.
1 to 86400 information displays for account X.
SIP-T22P/T26P/T
The default value is 30 seconds.
41P/T42G: X
ranges from 1
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.call
_center.disp_c
ode_enable =
(SIP-T19P: X=1
It enables or disables disposition code
SIP-T20P/T21P: feature for account X.
X ranges from
0 or 1 0-Disabled
1 to 2.
1-Enabled
SIP-T22P/T26P/T
The default value is 0.
41P/T42G: X
ranges from 1
to 3.
SIP-T28P/T46G:
210
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
X ranges from
1 to 6)
account.X.bw_
disp_code.Y =
(SIP-T19P: X=1
SIP-T20P/T21P:
X ranges from
It configures the disposition code
1 to 2.
which must match one of the codes
SIP-T22P/T26P/T Integer from
configured on BroadWorks for account
41P/T42G: X 1 to
X.
ranges from 1 2147483647
The value Y must be continuous.
to 3.
The default value is blank.
SIP-T28P/T46G:
X ranges from
1 to 6.
Y ranges from
1 to 100)
account.X.bw_
disp_code_na
me.Y =
(SIP-T19P: X=1
SIP-T20P/T21P:
X ranges from It configures the disposition code
SIP-T28P/T46G:
X ranges from
1 to 6.
Y ranges from
1 to 100)
enable = 0 or 1 0-Disabled
211
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
X ranges from
1 to 2.
SIP-T22P/T26P/T
41P/T42G: X
ranges from 1
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.call
_center.emerg
ency_enable
=
(SIP-T19P: X=1
It enables or disables the emergency
SIP-T20P/T21P:
escalation feature for account X.
X ranges from
1 to 2. 0 or 1 0-Disabled
SIP-T22P/T26P/T 1-Enabled
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.sup
ervisor_info_c
ode.Y =
(SIP-T19P: X=1
SIP-T20P/T21P:
X ranges from
It configures the supervisor number for
1 to 2. Integer from
account X.
SIP-T22P/T26P/T 1 to
The value Y must be continuous.
41P/T42G: X 2147483647
The default value is blank.
ranges from 1
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6.
Y ranges from
212
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
1 to 100)
account.X.sup
ervisor_info_c
ode_name.Y
=
(SIP-T19P: X=1
SIP-T20P/T21P:
X ranges from
It configures the supervisor name for
1 to 2. String within
account X.
SIP-T22P/T26P/T 99
The value Y must be continuous.
41P/T42G: X characters
The default value is blank.
ranges from 1
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6.
Y ranges from
1 to 100)
account.X.call
_center.queue
_status_enabl
e=
(SIP-T19P: X=1
It enables or disables the queue status
SIP-T20P/T21P:
notification feature for account X.
X ranges from
1 to 2. 0 or 1 0-Disabled
SIP-T22P/T26P/T 1-Enabled
SIP-T28P/T46G:
X ranges from
1 to 6)
213
Yealink IP Phones Auto provisioning Guide
Permitted
Parameter Descriptions Web Setting Path
Values
account.X.hot
eling.enable
=
(SIP-T19P: X=1
It enables or disables hoteling feature
SIP-T20P/T21P:
for account X.
X ranges from
1 to 2. 0-Disabled
0 or 1
SIP-T22P/T26P/T 1-Enabled
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.hot
eling.auto_log
in_enable =
(SIP-T19P: X=1
It enables or disables the phone to
SIP-T20P/T21P: save login credentials automatically
X ranges from when logging into the guest profile for
1 to 2. account X.
0 or 1
SIP-T22P/T26P/T 0-Disabled
41P/T42G: X
1-Enabled
ranges from 1
The default value is 0.
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6)
214
Appendix
Permitted
Parameter Descriptions Web Setting Path
Values
account.X.hot
eling.user_id
=
(SIP-T19P: X=1
SIP-T20P/T21P:
X ranges from
String within It configures the user ID used to log
1 to 2.
99 into the guest profile for account X.
SIP-T22P/T26P/T
characters The default value is blank.
41P/T42G: X
ranges from 1
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6)
account.X.hot
eling.passwor
d=
(SIP-T19P: X=1
SIP-T20P/T21P:
X ranges from
String within It configures the password used to log
1 to 2.
99 into the guest profile for account X.
SIP-T22P/T26P/T
characters The default value is blank.
41P/T42G: X
ranges from 1
to 3.
SIP-T28P/T46G:
X ranges from
1 to 6)
215
Yealink IP Phones Auto provisioning Guide
The following parameters are not applicable to IP phones running firmware version 72
or later, so the description of these parameters has been deleted in this guide.
account.X.bw_acd_reason_code.Y =
account.X.dns_query_timeout=
account.X.failback_mode =
account.X.failback_timeout =
account.X.retry_counts =
acd.bw =
bw.calllog_and_dir =
bw_phonebook.server_search_enable =
directory.incoming_call_match_enable =
features.action_uri_reboot_now =
features.auto_release_bla_line =
features.dsskey_blind_tran =
features.hold_trans_delay =
features.ldap.input_type =
ldap.dial_lookup =
network.snmp.enable =
network.snmp.port =
network.snmp.trust_ip =
phone_setting.blf_list_enable =
phone_setting.sms_popup_enable =
voice.call_preview_mode=
voice.tone.record =
features.hoteling.enable =
action_url.call_interrupt =
action_url.setup_autop_finish =
features.blf_pickup_only_send_code =
216
Appendix
217
Yealink IP Phones Auto provisioning Guide
218
Appendix
219
Yealink IP Phones Auto provisioning Guide
BLF LED Mode provides four kinds of definition for the BLF/BLF list key LED status. The
following tables list the LED statuses of the BLF/BLF list key when BLF LED Mode is set to 0,
1, 2 or 3 respectively. The default value of the BLF LED mode is 0.
Line key LED (configured as a BLF/BLF list key and BLF LED Mode is set to 0)
Memory key LED (configured as a BLF/BLF list key and BLF LED Mode is set to 0)
Fast flashing red (200ms) The monitored user receives an incoming call.
Line key LED (configured as a BLF/BLF list key and BLF LED Mode is set to 1)
220
Appendix
Memory key LED (configured as a BLF/BLF list key and BLF LED Mode is set to 1)
Fast flashing red (200ms) The monitored user receives an incoming call.
Line key LED (configured as a BLF/BLF list key and BLF LED Mode is set to 2)
Memory key LED (configured as a BLF/BLF list key and BLF LED Mode is set to 2)
Fast flashing red (200ms) The monitored user receives an incoming call.
Line key LED (configured as a BLF/BLF list key and BLF LED Mode is set to 3)
221
Yealink IP Phones Auto provisioning Guide
Memory key LED (configured as a BLF/BLF list key and BLF LED Mode is set to 3)
Fast flashing red (200ms) The monitored user receives an incoming call.
222
Appendix
We are striving to improve our documentation quality and we appreciate your feedback.
Email your opinions and comments to [email protected].
223