Table of Contents i

Table of Contents i
Table of Contents
i
Table of Contents
Table of Contents.................................................................. iii
Summary of Changes .......................................................... vii
Changes for Release 72, Guide Version 72.2 ............................................................... vii
Changes for Release 72, Guide Version 72.1 ............................................................... vii
Changes for Release 71, Guide Version 71.165............................................................ vii
Changes for Release 71, Guide Version 71.140........................................................... viii
Changes for Release 71, Guide Version 71.125........................................................... viii
Changes for Release 71, Guide Version 71.120........................................................... viii
Changes for Release 71, Guide Version 71.110........................................................... viii
Changes for Release 70, Guide Version 1.3 .................................................................. ix
Introduction ...........................................................................1
Getting Started .....................................................................3
Obtaining Configuration Information ............................................................................. 3
Obtaining Configuration Files ...................................................................................... 3
Obtaining Phone Information ....................................................................................... 4
Managing Configuration Files ........................................................................................ 4
Editing Common CFG File ............................................................................................ 5
Editing MAC-Oriented CFG File .................................................................................. 7
Encrypting Configuration Files ................................................................................... 14
Customizing Resource Files ........................................................................................ 14
Customizing a Ring Tone ......................................................................................... 14
Customizing an LCD Language .............................................................................. 15
Customizing an LCD Logo ....................................................................................... 16
Customizing a Wallpaper ........................................................................................ 17
Customizing a Local Contact File ............................................................................ 18
Customizing a Replace Rule File ............................................................................. 21
Customizing a Dial-now File .................................................................................... 22
Customizing a Directory Template .......................................................................... 23
Customizing a Super Search Template .................................................................. 24
Upgrading Firmware ............................................................................................... 25
Configuring a TFTP Server ................................................... 27
iii
Yealink IP Phones Auto provisioning Guide
Preparing a Root Directory ............................................................................................ 27
Configuring a TFTP Server ............................................................................................. 28
Obtaining the Address of Provisioning Server ..................... 29
Zero Touch ...................................................................................................................... 29
Plug and Play (PnP) Server ............................................................................................ 31
DHCP Options ................................................................................................................ 32
Phone Flash .................................................................................................................... 33
Update Mode ..................................................................... 35
Power On ........................................................................................................................ 35
Repeatedly ..................................................................................................................... 36
Weekly ............................................................................................................................ 37
Auto Provision Now ........................................................................................................ 38
Multi-mode Mixed ......................................................................................................... 39
SIP NOTIFY Message ..................................................................................................... 39
Downloading and Verifying Configurations ......................... 41
Downloading Configuration Files.................................................................................. 41
Resolving and Updating Configurations ...................................................................... 41
Verifying Configurations ................................................................................................ 42
Troubleshooting ................................................................... 45
Glossary .............................................................................. 47
Appendix ............................................................................ 49
Configuring an FTP Server ............................................................................................. 49
Preparing a Root Directory ......................................................................................... 49
Configuring an FTP server .......................................................................................... 50
Configuring an HTTP Server .......................................................................................... 52
Preparing a Root Directory ......................................................................................... 52
Configuring an HTTP Server ....................................................................................... 52
Configuring a DHCP server ........................................................................................... 55
Customizing a Ring Tone Using Cool Edit Pro ............................................................... 63
Customizing a Logo File Using PictureExDemo ............................................................ 64
Description of Configuration Parameters in CFG Files ................................................. 65
Time Zones ................................................................................................................... 225
iv
Table of Contents
BLF LED Mode .............................................................................................................. 228
v
Yealink IP Phones Auto provisioning Guide
vi
Summary of Changes
This section describes the changes to this guide for each release and guide version.
This version is updated to incorporate SIP-T48G IP phones. The following sections are
new for this version:

Customizing a Directory Template on page 23

Customizing a Super Search Template on page 24
Major updates have occurred to the following sections:

Editing Common CFG File on page 5

Editing MAC-Oriented CFG File on page 7

Customizing Resource Files on page 14

Description of Configuration Parameters in CFG Files on page 65

BLF LED Mode on page 228
This version is updated to incorporate SIP-T46G, SIP-T42G and SIP-T41P IP phones. The
following sections are new for this version:

Time Zones on page 225

BLF LED Mode on page 228
Major updates have occurred to the following sections:

Editing Common CFG File on page 5

Editing MAC-Oriented CFG File on page 7

Customizing Resource Files on page 14

Description of Configuration Parameters in CFG Files on page 65
Documentations of the newly released SIP-T21P and SIP-T19P IP phones have also been
added.
vii
Yealink IP Phones Auto provisioning Guide
Major updates have occurred to the following sections:

Editing Common CFG File on page 5

Editing MAC-Oriented CFG File on page 7

Encrypting Configuration Files on page 14

Customizing an LCD Logo on page 16

Customizing a Local Contact File on page 18

Description of Configuration Parameters in CFG Files on page 65
Major updates have occurred to the following section:

Customizing an LCD Logo on page 16
Major updates have occurred to the following section:

Description of Configuration Parameters in CFG Files on page 65
The following sections are new for this version:

Encrypting Configuration Files on page 14

Update Mode on page 35

SIP NOTIFY Message on page 39

Resolving and Updating Configurations on page 41

Description of Configuration Parameters in CFG Files on page 65
Major updates have occurred to the following sections:
viii

Customizing a Local Contact File on page 18

Customizing a Replace Rule File on page 21

Customizing a Dial-now File on page 22
Summary of Changes
The following sections are new for this version:

Customizing a Wallpaper on page 17

Customizing a Replace Rule File on page 21

Customizing a Dial-now File on page 22
Major updates have occurred to the following sections:

Customizing a Local Contact File on page 18

Upgrading Firmware on page 25
ix
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-T48G

Yealink SIP-T46G

Yealink SIP-T42G

Yealink SIP-T41P
The auto provisioning process outlined in this guide applies to Yealink IP phones
running firmware V72 or later. We recommend that IP phones running firmware V72 or
later CANNOT be downgraded to an earlier firmware version. The new firmware is
compatible with old configuration parameters, but not vice versa.
This guide is also applicable to SIP-T21/T20/T19 IP phones.
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:

Obtaining Configuration Information

Managing Configuration Files
Before beginning provisioning, you need to obtain configuration files. There are two
configuration files both of which are CFG-formatted. We call these two files Common
CFG file and MAC-Oriented CFG file. The phone tries to download these CFG files from
the server during provisioning.
The MAC-Oriented CFG file is only effectual for the specific phone. It uses the 12-digit
MAC address of the phone as the file name. For example, if the MAC address of the
phone is 0015651130F9, the MAC-Oriented CFG file name must be 0015651130F9.cfg.
However, the Common CFG file is effectual for all the phones with the same model. It
uses a fixed name “y0000000000XX.cfg” or “y00000000000X.cfg” as the file name,
where "XX" or “X” equals to the first two digits or the first digit (except 0 for SIP-T28P) of
the hardware version of the phone model.
The names of the Common CFG file for each phone model are:
Phone Model
Common CFG File
SIP-T28P
y000000000000.cfg
SIP-T26P
y000000000004.cfg
SIP-T22P
y000000000005.cfg
SIP-T21P
y000000000034.cfg
SIP-T20P
y000000000007.cfg
SIP-T19P
y000000000031.cfg
SIP-T48G
y000000000035.cfg
SIP-T46G
y000000000028.cfg
3
Yealink IP Phones Auto provisioning Guide
Phone Model
Common CFG File
SIP-T42G
y000000000029.cfg
SIP-T41P
y000000000036.cfg
You can ask the distributor or Yealink FAE for configuration files. The IP phones running
firmware version 71 or later can only recognize configuration files using UTF-8 or ANSI
encoding.
Before beginning provisioning, you also need the phone information. For example, MAC
address and the SIP account information of the phone.
MAC Address: The unique 12-digit serial number of the phone. You can obtain it from the
bar code on the back of the phone.
SIP Account Information: This may include SIP credentials such as user name, password
and IP address of the SIP server. Ask your system administrator for SIP account
information.
Auto provisioning enables Yealink IP phones to update themselves automatically via
downloading Common CFG and MAC-Oriented CFG files. Before beginning
provisioning, you may need to edit and customize your configuration files. For more
information on configuration parameters in configuration files, refer to Description of
Configuration Parameters in CFG Files on page 65.
4
Getting Started
Common CFG file contains configuration parameters which apply to phones with the
same model, such as language and volume.
The following figure shows a portion of the common CFG file:
The line beginning with “#” is considered to be a comment.
The file header “#!version:1.0.0.1” is not a comment and must be placed in the
first line. It cannot be edited or deleted.
The partial parameters in the Common CFG file are described as follows:
####################################################
##
Common CFG File
##
####################################################
#!version:1.0.0.1
##File header "#!version:1.0.0.1" cannot be edited or deleted, and must be placed in
the first line. This template file is applicable to
SIP-T28P/T26P/T22P/T21P/T20P/T19P/T48G/T46G/T42G/T41P IP phones running firmware
version 72 or later. For more information on configuration parameters, refer to
Yealink_SIP-T2_Series_T19P_T4_Series_IP_Phones_Auto_Provisioning_Guide. ##
######################################################
##
Hostname
##
######################################################
network.dhcp_host_name =
######################################################
##
PPPOE(Except SIP-T42GP/T41P Models)
##
######################################################
network.pppoe.user =
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/T48G Models support this parameter##
network.vlan.pc_port_mode =
######################################################
##
VLAN
##
######################################################
network.vlan.internet_port_enable =
network.vlan.internet_port_vid =
network.vlan.internet_port_priority =
network.vlan.pc_port_enable =
network.vlan.pc_port_vid =
network.vlan.pc_port_priority =
network.vlan.dhcp_enable =
network.vlan.dhcp_option =
######################################################
##
WEB Port
##
######################################################
network.port.http =
network.port.https =
wui.https_enable =
wui.http_enable =
######################################################
##
QoS
##
######################################################
network.qos.rtptos =
network.qos.signaltos =
######################################################
##
802.1X
##
######################################################
network.802_1x.mode =
network.802_1x.identity =
network.802_1x.md5_password =
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 =
MAC-Oriented CFG file contains configuration parameters which are expected to be
updated per phone, such as the registration information.
The following figure shows a portion of the MAC-Oriented CFG file:
7
Yealink IP Phones Auto provisioning Guide
The partial parameters in the MAC-Oriented CFG file are described as follows:
####################################################
##
MAC-Oriented CFG File
##
####################################################
#!version:1.0.0.1
##File header "#!version:1.0.0.1" cannot be edited or deleted, and must be placed in
the first line. This template file is applicable to SIP-T28P/T26P/T22P/T21P/T20P/T19P/
T48G/T46G/T42G/T41P IP phones running firmware version 72 or later. For more
information on configuration parameters, refer to
Yealink_SIP-T2_Series_T19P_T4_Series_IP_Phones_Auto_Provisioning_Guide. ##
######################################################
##
Account1 Basic Settings
##
######################################################
account.1.enable =
account.1.label =
account.1.display_name =
account.1.auth_name =
account.1.user_name =
account.1.password =
account.1.outbound_proxy_enable =
account.1.outbound_host =
account.1.outbound_port =
account.1.sip_listen_port =
account.1.transport =
######################################################
##
Failback
##
######################################################
account.1.reregister_enable =
account.1.naptr_build =
account.1.fallback.redundancy_type =
account.1.fallback.timeout =
account.1.sip_server.1.address =
account.1.sip_server.1.port =
account.1.sip_server.1.expires =
account.1.sip_server.1.retry_counts =
account.1.sip_server.1.failback_mode =
account.1.sip_server.1.failback_timeout =
account.1.sip_server.1.register_on_enable =
account.1.sip_server.2.address =
8
Getting Started
account.1.sip_server.2.port =
account.1.sip_server.2.expires =
account.1.sip_server.2.retry_counts =
account.1.sip_server.2.failback_mode =
account.1.sip_server.2.failback_timeout =
account.1.sip_server.2.register_on_enable =
######################################################
##
Account2 Basic Settings (except SIP-T19P Model)
##
######################################################
account.2.enable =
account.2.label =
account.2.display_name =
account.2.auth_name =
account.2.user_name =
account.2.password =
account.2.outbound_proxy_enable =
account.2.outbound_host =
account.2.outbound_port =
account.2.sip_listen_port =
account.2.transport =
######################################################
##
Failback
##
######################################################
account.2.reregister_enable =
account.2.naptr_build =
account.2.fallback.redundancy_type =
account.2.fallback.timeout =
account.2.sip_server.1.address =
account.2.sip_server.1.port =
account.2.sip_server.1.expires =
account.2.sip_server.1.retry_counts =
account.2.sip_server.1.failback_mode =
account.2.sip_server.1.failback_timeout =
account.2.sip_server.1.register_on_enable =
account.2.sip_server.2.address =
account.2.sip_server.2.port =
account.2.sip_server.2.expires =
account.2.sip_server.2.retry_counts =
9
Yealink IP Phones Auto provisioning Guide
account.2.sip_server.2.failback_mode =
account.2.sip_server.2.failback_timeout =
account.2.sip_server.2.register_on_enable =
######################################################
##
Account3 Basic Settings (except SIP-T21P/T20P/T19P Models)
##
######################################################
account.3.enable =
account.3.label =
account.3.display_name =
account.3.auth_name =
account.3.user_name =
account.3.password =
account.3.outbound_proxy_enable =
account.3.outbound_host =
account.3.outbound_port =
account.3.sip_listen_port =
account.3.transport =
######################################################
##
Failback
##
######################################################
account.3.reregister_enable =
account.3.naptr_build =
account.3.fallback.redundancy_type =
account.3.fallback.timeout =
account.3.sip_server.1.address =
account.3.sip_server.1.port =
account.3.sip_server.1.expires =
account.3.sip_server.1.retry_counts =
account.3.sip_server.1.failback_mode =
account.3.sip_server.1.failback_timeout =
account.3.sip_server.1.register_on_enable =
account.3.sip_server.2.address =
account.3.sip_server.2.port =
account.3.sip_server.2.expires =
account.3.sip_server.2.retry_counts =
account.3.sip_server.2.failback_mode =
account.3.sip_server.2.failback_timeout =
10
Getting Started
account.3.sip_server.2.register_on_enable =
######################################################
##
Account4 Basic Settings (for SIP-T28P/T48G/T46G models)
##
######################################################
account.4.enable =
account.4.label =
account.4.display_name =
account.4.auth_name =
account.4.user_name =
account.4.password =
account.4.outbound_proxy_enable =
account.4.outbound_host =
account.4.outbound_port =
account.4.sip_listen_port =
account.4.transport =
######################################################
##
Failback
##
######################################################
account.4.reregister_enable =
account.4.naptr_build =
account.4.fallback.redundancy_type =
account.4.fallback.timeout =
account.4.sip_server.1.address =
account.4.sip_server.1.port =
account.4.sip_server.1.expires =
account.4.sip_server.1.retry_counts =
account.4.sip_server.1.failback_mode =
account.4.sip_server.1.failback_timeout =
account.4.sip_server.1.register_on_enable =
account.4.sip_server.2.address =
account.4.sip_server.2.port =
account.4.sip_server.2.expires =
account.4.sip_server.2.retry_counts =
account.4.sip_server.2.failback_mode =
account.4.sip_server.2.failback_timeout =
account.4.sip_server.2.register_on_enable =
11
Yealink IP Phones Auto provisioning Guide
######################################################
##
Account5 Basic Settings (for SIP-T28P/T48G/T46G models)
##
######################################################
account.5.enable =
account.5.label =
account.5.display_name =
account.5.auth_name =
account.5.user_name =
account.5.password =
account.5.outbound_proxy_enable =
account.5.outbound_host =
account.5.outbound_port =
account.5.sip_listen_port =
account.5.transport =
######################################################
##
Failback
##
######################################################
account.5.reregister_enable =
account.5.naptr_build =
account.5.fallback.redundancy_type =
account.5.fallback.timeout =
account.5.sip_server.1.address =
account.5.sip_server.1.port =
account.5.sip_server.1.expires =
account.5.sip_server.1.retry_counts =
account.5.sip_server.1.failback_mode =
account.5.sip_server.1.failback_timeout =
account.5.sip_server.1.register_on_enable =
account.5.sip_server.2.address =
account.5.sip_server.2.port =
account.5.sip_server.2.expires =
account.5.sip_server.2.retry_counts =
account.5.sip_server.2.failback_mode =
account.5.sip_server.2.failback_timeout =
account.5.sip_server.2.register_on_enable =
12
Getting Started
######################################################
##
Account6 Basic Settings (for SIP-T28P/T48G/T46G models)
##
######################################################
account.6.enable =
account.6.label =
account.6.display_name =
account.6.auth_name =
account.6.user_name =
account.6.password =
account.6.outbound_proxy_enable =
account.6.outbound_host =
account.6.outbound_port =
account.6.sip_listen_port =
account.6.transport =
######################################################
##
Failback
##
######################################################
account.6.reregister_enable =
account.6.naptr_build =
account.6.fallback.redundancy_type =
account.6.fallback.timeout =
account.6.sip_server.1.address =
account.6.sip_server.1.port =
account.6.sip_server.1.expires =
account.6.sip_server.1.retry_counts =
account.6.sip_server.1.failback_mode =
account.6.sip_server.1.failback_timeout =
account.6.sip_server.1.register_on_enable =
account.6.sip_server.2.address =
account.6.sip_server.2.port =
account.6.sip_server.2.expires =
account.6.sip_server.2.retry_counts =
account.6.sip_server.2.failback_mode =
account.6.sip_server.2.failback_timeout =
account.6.sip_server.2.register_on_enable =
13
Yealink IP Phones Auto provisioning Guide
To protect against unauthorized access and tampering of sensitive information (e.g.,
login password, registration information), you can encrypt configuration files using
Yealink Configuration Encryption Tool. AES keys must be 16 characters and the
supported characters contain: 0 ~ 9, A ~ Z, a ~ z. For more information on how to
encrypt configuration files, refer to Yealink Configuration Encryption Tool User Guide.
When configuring some particular features, you may need to upload resource files to IP
phones, such as personalized ring tone file, language package file and logo file. Yealink
supplies some resource file templates for the particular features. Ask the distributor or
Yealink FAE for resource file templates. The following provides information on how to
customize resource files and specify the access URL for the resource files.
Yealink IP phones have built-in system ring tones. You can change the ring type, or
customize a ring tone and upload it to the phone via auto provisioning.
The ring tone file must meet the following:
Phone Model
File Format
Single File Size
Total Files Size
SIP-T28P/T26P/T22P/T20P
.wav
<=100KB
<=100KB
SIP-T21P/T19P
.wav
<=100KB
<=200KB
SIP-T48G/T46G
.wav
<=8MB
<=20MB
SIP-T42G/T41P
.wav
<=100KB
<=100KB
The ring tone file must be PCMU audio format, mono channel, 8K sample rate and 16 bit
resolution.
For more information on customizing a ring tone file, refer to Customizing a Ring Tone
Using Cool Edit Pro on page 63.
####################################################
##
Configure the access URL of the custom ring tone
##
####################################################
ringtone.url =
For example, enter “tftp://192.168.1.100/Ring1.wav” in the “ringtone.url =” field. During
the auto provisioning process, the phone connects to the provisioning server
“192.168.1.100”, and downloads the ring tone file “Ring1.wav”.
14
Getting Started
#Delete all custom ring tones.
ringtone.delete = http://localhost/all
You can modify the language translation for the phone user interface. For SIP-T4X IP
phones, you can also add a new language to IP phones.
The following table lists available languages and the associated language files for the
phone user interface:
Associated Language
Available
Language
Pack for
Associated Language Pack
SIP-T28P/T26P/T22P/T20P/
for SIP-T21P/T19P/T48G/T46G
T42G/T41P
English
lang+English.txt
lang+English.txt
Chinese_S
/
lang-Chinese_S.txt
Chinese_T
/
lang-Chinese_T.txt
German
lang-German.txt
lang-German.txt
French
lang-French.txt
lang-French.txt
Italian
lang-Italian.txt
lang-Italian.txt
Polish
lang-Polish.txt
lang-Polish.txt
lang-Portuguese.txt
lang-Portuguese.txt
lang-Spanish.txt
lang-Spanish.txt
lang-Turkish.txt
lang-Turkish.txt
Portuguese
Spanish
Turkish
The following figure shows a portion of a txt formatted English language file:
15
Yealink IP Phones Auto provisioning Guide
####################################################
##
Configure the access URL of the LCD language file
##
####################################################
gui_lang.url =
If you want to modify the translation of an existing language, configure the parameter
“gui_lang.url =” in the configuration file, for example:
gui_lang.url = tftp://192.168.1.100/lang+English.txt.
During the auto provisioning process, the phone connects to the provisioning server
“192.168.1.100”, and downloads the language file “lang+English.txt”.
If you want to add a new language “Russian” to SIP-T4X IP phones, configure the
parameter “gui_lang.url =” in the configuration file, for example:
gui_lang.url = tftp://192.168.1.100/lang-Russian.txt
During the auto provisioning process, the phone connects to the provisioning server
“192.168.1.100”, and downloads the language file “lang-Russian.txt”. After update, you
will find a new language selection “Russian” on the phone user interface:
Menu->Basic->Language.
#Delete all custom languages.
gui_lang.delete = http://localhost/all
SIP-T48G/T46G IP phones also support to add a custom or modify an existing LCD
language with an X.GUI.Y.lang (e.g., 0.GUI.English.lang) formatted language file. “X” is
an integer which starts from 0. “Y” means the name of the language. X must start from
10.
Available languages may vary between different firmware versions.
English language file name must be “lang+English.txt”.
To modify translation of an existing language, do not rename the language file.
Yealink IP phones allow you to customize the logo displayed on the LCD screen. SIP-T20P
IP phones only support a text logo. Logo is not applicable to SIP-T48G/T46G IP phones.
These two IP phone models use the wallpaper instead.
The following table lists the supported logo file format and resolution for each phone
model:
16
Phone Model
Logo File Format
Resolution
SIP-T28P
.dob
<=236*82
2 gray scale
SIP-T26P
.dob
<=132*64
2 gray scale
SIP-T22P/T21P/T19P
.dob
<=132*64
2 gray scale
SIP-T42G/T41P
.dob
<=192*64
2 gray scale
Getting Started
For more information on customizing a logo file, refer to Customizing a Logo File Using
PictureExDemo on page 64.
Ask the distributor or Yealink FAE for the logo file, or you can customize a *.dob logo file.
Upload the logo file to the provisioning server and then specify the access URL in
configuration files:
####################################################
##
Configure the access URL of the Logo File
##
####################################################
#(not applicable to SIP-T20P IP phones)
lcd_logo.url =
For example, enter “tftp://192.168.1.100/logo.dob” in the “lcd_logo.url =” field. During
the auto provisioning process, the phone connects to the provisioning server
“192.168.1.100”, and downloads the logo file “logo.dob”.
To use the custom logo, you also need to configure the following parameter:
#Configure the logo mode (not applicable to SIP-T20P IP phones).
#0-Disabled (Except for SIP-T28P IP phones), 1-System logo, 2-Custom logo
phone_setting.lcd_logo.mode = 2
To configure a text logo, you need to configure the following parameter:
#Enable or disable a text logo (only applicable to SIP-T20P IP phones).
#0-Disabled, 1-Enabled
phone_setting.lcd_logo.mode = 1
#Configure a text logo (only applicable to SIP-T20P IP phones).
phone_setting.lcd_logo.text =Yealink
After auto provisioning, you will find that the custom logo or text logo appears on the
LCD screen.
#Delete all custom logo files (not applicable to SIP-T20P IP phones).
lcd_logo.delete = http://localhost/all
Yealink SIP-T48G and SIP-T46G IP phones allow you to customize the wallpaper
displayed on the LCD screen.
The following table lists the supported wallpaper image format and resolution for
SIP-T48G and SIP-T46G IP phones:
Phone Model
Format
Resolution
Single File Size
Total File Size
SIP-T46G
.jpg/.png/.bmp
<=480*272
<=5MB
<=20MB
SIP-T48G
.jpg/.png/.bmp
<=800*480
<=5MB
<=20MB
17
Yealink IP Phones Auto provisioning Guide
Upload the wallpaper image to the provisioning server and then specify the access URL
in configuration files:
####################################################
##
Configure the access URL of the wallpaper
##
####################################################
wallpaper_upload.url =
For example, enter “tftp://192.168.1.100/wallpaper.jpg” in the “wallpaper_upload.url =”
field. During the auto provisioning process, the phone connects to the provisioning
server “192.168.1.100”, and downloads the wallpaper image “wallpaper.jpg”.
To use the custom wallpaper, you also need to configure the following parameter:
#Configure the custom image (e.g., wallpaper.jpg) as phone wallpaper.
phone_setting.backgrounds = Config:wallpaper.jpg
Yealink IP phones allow you to upload contact data in batch via auto provisioning. You
can create multiple contacts using the provided local contact template file. The existing
local contacts on the phones will be overwritten by the downloaded local contacts.
Yealink IP phones support both *.xml and *.csv formats.
When editing the local contact template file, learn the following:

Add groups between <root_group> and </root_group>.

At most 5 groups (including the default groups) can be stored on SIP-T19/T2xP IP
phones.

At most 48 groups (including the default groups) can be stored on SIP-T4X IP
phones.

Add local contacts between <root_contact> and </root_contact>.

At most 1000 local contacts can be added to IP phones.

When specifying a desired line for a contact, valid values are -1~6. This is not
applicable to SIP-T19P IP phones.
(For SIP-T21P/T20P, valid values are 0~2. For SIP-T26P/T22P, valid values are 0~3. For
SIP-T28P, valid values are 0~6. 0 stands for Auto (the first registered line). 1~6 stand
for line1~line6.
For SIP-T42G/T41P, valid values are -1~2. For SIP-T48G/T46G, valid values are -1~5.
-1 stands for Auto (the first registered line). 0~5 stand for line1~line6. Multiple line
IDs are separated by commas.

When specifying a ring tone for a contact, valid values are Auto,
Resource:RingN.wav (system ring tone, integer N ranges from 1 to 5 for
18
Getting Started
SIP-T2xP/T19P/T42G/T41P and from 1 to 8 for SIP-T48G/T46G) and Custom:Name.wav
(custom ring tone).

When specifying a group for a contact, valid values are the group names (built-in
or custom groups).

When specifying an avatar for a contact, valid values are “Default: avatar name”
(for the built-in avatar) and “Config: avatar name” (for the custom avatar). This is
only applicable to SIP-T48G/T46G IP phones.
To customize a local contact file:
1.
Open the template file using an ASCII editor.
2.
For each group that you wish to add, add the following string to the file. Each starts
on a separate line:
<group display_name=”” ring=””/>
Where:
display_name=”” specifies the name of the group.
ring=”” specifies the ring tone for this group.
3.
For each contact that you wish to add, add the following string to the file. Each
starts on a separate line:
<contact display_name=”” office_number=”” mobile_number=”” other_number=””
line=”” ring=”” group_id_name=”” default_photo=””/>
Where:
display_name=”” specifies the name of the contact (This value cannot be blank or
duplicated).
office_number=”” specifies the office number of the contact.
mobile_number=”” specifies the mobile number of the contact.
other_number=”” specifies the other number of the contact.
line=”” specifies the line for the contact.
ring=”” specifies the ring tone for the contact.
group_id_name=”” specifies the group you want to add the contact to.
default_photo=”” specifies the avatar for the contact (for SIP-T48G/T46G IP phones).
4.
Specify the values within double quotes.
5.
Save the change.
After editing the local contact template file, upload it to the provisioning server and
then specify the access URL in configuration files.
19
Yealink IP Phones Auto provisioning Guide
The following shows an example of a local contact file used for SIP-T2xP IP phones:
<root_group>
<group display_name="All Contacts" ring=""/>
<group display_name="Family" ring="Resource:Ring1.wav"/>
<group display_name="Friend" ring="Auto"/>
</root_group>
<root_contact>
<contact display_name="Mary" office_number="123" mobile_number="456"
other_number="2201" line="0" ring="Auto" group_id_name="Family"/>
<contact display_name="Damy" office_number="124" mobile_number="789"
other_number="2202" line="1" ring="Resource:Ring2.wav"
group_id_name=""/>
<contact display_name="Jack" office_number="125" mobile_number="234"
other_number="2203" line="2" ring="Custom:lin.wav"
group_id_name="Family"/>
<contact display_name="Ada" office_number="8800"
mobile_number="1234" other_number="0000" line="0" ring="”
group_id_name="”/>
</root_contact>
####################################################
##
Configure the access URL of the local contact file
##
####################################################
local_contact.data.url =
For example, enter “tftp://192.168.1.100/contact_list.xml” in the “local_contact.data.url =”
field. During the auto provisioning process, the phone connects to the provisioning
server “192.168.1.100”, and downloads the contact file “contact_list.xml”.
####################################################
##
Upload TAR file of local contact file and avatar TAR file
##
####################################################
#All avatars needed for contacts should be tarred in advance.
#(only applicable to SIP-T46G/T48G IP phones)
local_contact.data_photo_tar.url =
For example, enter “tftp://192.168.1.100/Contact.tar” in the
“local_contact.data_photo_tar.url =” field. During the auto provisioning process, the
phone connects to the provisioning server “192.168.1.100”, and downloads the contact
file “Contact.tar”.
20
Getting Started
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.

Create replace rules between <DialRule> and </DialRule>.

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. Specifying the desired line(s) to apply replace rules is not applicable to
SIP-T19P IP phones.

At most 100 replace rules can be added to the IP phone.

For the basic expression syntax of the replace rule, refer to Yealink phone-specific
user guide.
To customize a replace rule file:
1.
Open the template file using an ASCII editor.
2.
For each replace rule you wish to add, add the following string to the file. Each
starts on a separate line:
<Data Prefix=”” Replace=”” LineID=””/>
Where:
Prefix=”” specifies the numbers to be replaced.
Replace=”” specifies the alternate string.
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.
3.
Specify the values within double quotes.
4.
Save the change.
The following shows an example of a replace rule file:
<DialRule>
<Data Prefix="1" Replace="05928665234" LineID=""/>
<Data Prefix="2(xx)" Replace="002$1" LineID="0"/>
</DialRule>
21
Yealink IP Phones Auto provisioning Guide
####################################################
##
Upload replace rule file
##
####################################################
dialplan_replace_rule.url =
For example, enter “tftp://192.168.1.100/DialPlan.xml” in the “dialplan_replace_rule.url =”
field. During the auto provisioning process, the phone connects to the provisioning
server “192.168.1.100”, and downloads the replace rule file “DialPlan.xml”.
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.
When editing a dial-now file, learn the following:

<DialNow> indicates the start of the template file and </DialNow> indicates the
end of the template file.

Create dial-now rules between <DialNow> and </DialNow>.

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.
Specifying the desired line(s) to apply dial-now rules is not applicable to SIP-T19P IP
phones.

At most 100 dial-now rules can be added to the IP phone.

For the basic expression syntax of the dial-now rule, refer to Yealink phone-specific
user guide.
To customize a dial-now file:
1.
Open the template file using an ASCII editor.
2.
For each dial-now rule you wish to add, add the following string to the file. Each
starts on a separate line:
<Data DialNowRule=”” LineID=""/>
Where:
DialNowRule=””/ rule=”” specifies the dial-now rule.
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
3.
Specify the values within double quotes.
4.
Save the change.
Getting Started
The following shows an example of a dial-now file:
<DialNow>
<Data DialNowRule="1234" LineID="1"/>
<Data DialNowRule="52[0-6]" LineID="1"/>
<Data DialNowRule="xxxxxx" LineID=""/>
</DialNow>
####################################################
##
Upload dial-now file
##
####################################################
dialplan_dialnow.url =
For example, enter “tftp://192.168.1.100/DialNow.xml” in the “dialplan_dialnow.url =”
field. During the auto provisioning process, the phone connects to the provisioning
server “192.168.1.100”, and downloads the dial-now file “DialNow.xml”.
Directory provides easy access to frequently used lists. You can access lists by pressing
the Directory soft key when the IP phone is idle. The lists may contain Local Directory,
History, Remote Phone Book and LDAP (LDAP list is not applicable to SIP-T19P IP phones).
You can add the desired list(s) to Directory using the supplied directory template
(favorite_setting.xml). After setup, place the directory template to the provisioning
server and specify the access URL in the configuration files. Directory is not applicable
to SIP-T20P IP phones.
When editing a directory template, learn the following:

Do not rename the directory template.

<root_favorite_set> indicates the start of a template and </root_favorite_set>
indicates the end of a template.

The default display names of directory lists are Local Directory, History, Remote
Phone Book and LDAP.

When specifying the display priority of the directory list, the valid values are 1, 2, 3
and 4. 1 is the highest priority, 4 is the lowest.

When enabling or disabling the desired directory list for Directory, the valid values
are 0 and 1. 0 stands for Disabled, 1 stands for Enabled.
To customize a directory template:
1.
Open the template file using an ASCII editor.
2.
For each directory list that you want to configure, edit the corresponding string in
the file. For example, you want to configure the local directory list, edit the
following strings:
23
Yealink IP Phones Auto provisioning Guide
<item id_name="localdirectory" display_name="Local Directory" priority="1"
enable="1" />
Where:
id_name="" specifies the directory list (id_name = “localdirectory” specifies the
local directory list). Do not edit this field.
display_name="" specifies the display name of the directory list. We recommend
you do not edit this field.
priority="" specifies the display priority of the directory list.
enable="" enables or disables the directory list for Directory.
3.
Edit the values within double quotes.
4.
Place this file to the provisioning server.
The following is an example of a directory template:
<root_favorite_set>
<item id_name="localdirectory" display_name="Local Directory" priority="1"
enable="1" />
<item id_name="history" display_name="History" priority="2" enable="0" />
<item id_name="remotedirectory" display_name="Remote Phone Book"
priority="3" enable="0" />
<item id_name="ldap" display_name="LDAP" priority="4" enable="0" />
</root_favorite_set>
Search source list in dialing allows the IP phone to search for entries from the desired
lists when the phone is in the dialing screen, and then the user can select the desired
entry to dial out quickly. The lists may contain Local Directory, History, Remote Phone
Book and LDAP (LDAP list is not applicable to SIP-T19P IP phones). You can configure the
search source list in dialing using the supplied super search template
(super_search.xml). After setup, place the super search template to the provisioning
server and specify the access URL in the configuration files. Search source list in dialing
is not applicable to SIP-T20P IP phones.
When editing a super search template, learn the following:

Do not rename the super search template.

<root_super_search> indicates the start of a template and </root_super_search>
indicates the end of a template.

The default display names of directory lists are Local Directory, History, Remote
Phone Book and LDAP.

When specifying the priority of search results, the valid values are 1, 2, 3 and 4. 1 is
the highest priority, 4 is the lowest.
24
Getting Started

When enabling or disabling the phone to search the desired directory list, the valid
values are 0 and 1. 0 stands for Disabled, 1 stands for Enabled.
To customize a super search template:
1.
Open the template file using an ASCII editor.
2.
For each directory list that you want to configure, edit the corresponding string in
the file. For example, you want to configure the local directory list, edit the
following strings:
<item id_name="local_directory_search" display_name="Local Directory"
priority="1" enable="1" />
Where:
id_name="" specifies the directory list (id_name = “local_directory_search”
specifies the local directory list). Do not edit this field.
display_name="" specifies the display name of the directory list. We recommend
you do not edit this field.
priority="" specifies the priority of search results.
enable="" enables or disables the phone to search the directory list.
3.
Edit the values within double quotes.
4.
Place this file to the provisioning server.
The following is an example of a super search template:
<root_super_search>
<item id_name="local_directory_search" display_name="Local Directory"
priority="1" enable="1" />
<item id_name="calllog_search" display_name="History" priority="2"
enable="1" />
<item id_name="remote_directory_search" display_name="Remote Phone
Book" priority="3" enable="0" />
<item id_name="ldap_search" display_name="LDAP" priority="4" enable="0" />
</root_super_search>
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):
Phone Model
Firmware Name
SIP-T28P
2.x.x.x.rom
25
Yealink IP Phones Auto provisioning Guide
Phone Model
Firmware Name
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-T48G
35.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
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.
####################################################
##
Configure the access URL of the firmware file
##
####################################################
firmware.url =
For example, enter “tftp://admin:password@192.168.1.100/2.72.0.1.rom” (“admin” is
replaced by the authentication user name and “password” is replaced by the
authentication password) in the “firmware.url =” field. During the auto provisioning
process, the phone connects to the provisioning server “192.168.1.100”, and downloads
the firmware file “2.72.0.1.rom”.
26
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 49 and Configuring an HTTP Server on page 52.
To prepare a root directory:
1.
Create a TFTP root directory on the local system.
2.
Place configuration files to this root directory.
3.
Set security permissions for the TFTP directory folder.
You need to define a user or a group name, and set the permissions: read, write or
modify. Security permissions vary by organizations.
An example of configuration on the Windows platform is shown as below:
27
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.
To configure a TFTP server:
1.
Double click 3CDaemon.exe to start the application. A configuration page is shown
as below:
2.
Select Configure TFTP Server. Click the
button to locate the TFTP root directory
from your local system:
3.
Click the Confirm button to finish configuring the TFTP server.
The server URL “tftp://IP/” (Here “IP” means the IP address of the provisioning
server, for example, ”tftp://192.168.1.100/”) is where the phone downloads
configuration files from.
28
Obtaining the Address of Provisioning Server
Yealink IP phones support obtaining the provisioning server address in the following
ways:

Zero Touch

Plug and Play (PnP) Server

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.
The following sections detail the process of each way (take the SIP-T28P IP phone as an
example).
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.
To configure the Zero Touch via web user interface:
1.
Click on Settings->Auto Provision.
2.
Select Enabled from the pull-down list of Zero Active.
29
Yealink IP Phones Auto provisioning Guide
3.
Configure the wait time in the Wait Time (0~100s) field.
4.
Click Confirm to accept the change.
When Zero Touch is enabled, there will be a configuration wizard during startup:
Press the OK soft key.
The network parameters are configurable via phone user interface:
Press the Next soft key after finishing network setting.
Configure the provisioning server address, authentication user name (optional) and
30
Obtaining the Address of Provisioning Server
password (optional) in the Auto Provision screen.
An example of screenshot is shown as below:
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.
To configure PnP via web user interface:
1.
Click on Settings->Auto Provision.
2.
Mark the On radio box in the PNP Active field.
3.
Click Confirm to accept the change.
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
31
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 55.
To configure the DHCP option via web user interface:
32
1.
Click on Settings->Auto Provision.
2.
Mark the On radio box in the DHCP Active field.
3.
Enter the desired value in the Custom Option (128~254) field.
Obtaining the Address of Provisioning Server
4.
Enter the desired value in the DHCP Option Value field.
The default value is yealink.
5.
Configure the desired update mode.
For more information, refer to Update Mode on page 35.
6.
Click Confirm to accept the change.
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.
To configure the Phone Flash via web user interface:
1.
Click on Settings->Auto Provision.
33
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).
3.
Configure the desired update mode.
For more information, refer to Update Mode on page 35.
4.
34
Click Confirm to accept the change.
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

Auto Provision Now

Multi-mode Mixed

SIP NOTIFY Message
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.
To activate the Power On mode via a web user interface:
1.
Click on Settings->Auto Provision.
35
Yealink IP Phones Auto provisioning Guide
2.
Mark the On radio box in the Power On field.
3.
Click Confirm to accept the change.
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.
To activate the Repeatedly mode via web user interface:
36
1.
Click on Settings->Auto Provision.
2.
Mark the On radio box in the Repeatedly field.
Update Mode
3.
Enter the interval time (in minutes) in the Interval (Minutes) field.
4.
Click Confirm to accept the change.
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.
To activate the Weekly mode via web user interface:
1.
Click on Settings->Auto Provision.
2.
Mark the On radio box in the Weekly field.
3.
Enter the desired time in the Time field.
37
Yealink IP Phones Auto provisioning Guide
4.
Mark one or more checkboxes in the Day of Week field.
5.
Click Confirm to accept the change.
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:
1.
38
Click on Settings->Auto Provision.
Update Mode
2.
Click Autoprovision Now.
The phone will perform the auto provisioning process immediately.
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.
39
Yealink IP Phones Auto provisioning Guide
The following figure shows the message flow:
40
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 the phone decrypts
configuration files, refer to Yealink Configuration Encryption Tool User Guide.
The phone only reboots when there is at least a specific configuration requiring a reboot
during auto provisioning.
For more information on the specific configurations which require a reboot during auto
provisioning, refer to Description of Configuration Parameters in CFG Files on page 65.
41
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.
42
Downloading and Verifying Configurations
Example 3: Yealink SIP-T28P IP phone downloads configuration files from the HTTP server.
43
Yealink IP Phones Auto provisioning Guide
44
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.
Why does the phone fail to download configuration files?

Ensure that auto provisioning feature is configured properly.

Ensure that the provisioning server and network are reachable.

Ensure that authentication credentials configured on the phone are correct.

Ensure that configuration files exist on the provisioning server.
Why does the provisioning server return HTTP 404?

Ensure that the provisioning server is properly set up.

Ensure that the access URL is correct.

Ensure that the requested files exist on the provisioning server.
Why does the phone display "Network Unavailable"?

Ensure that the Ethernet cable is plugged into the Internet port on the phone and
the Ethernet cable is not loose.

Ensure that the switch or hub in your network is operational.

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 settings are correct on the DHCP server.

Ensure that the phone is configured to obtain the IP address from the DHCP server.
45
Yealink IP Phones Auto provisioning Guide
Why doesn’t the phone download the ring tone?

Ensure that the file format of the ring tone is *.wav.

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.
Why doesn’t the phone update configurations?
46

Ensure that the configuration files are different from the last ones.

Ensure that the phone has downloaded the configuration files.

Ensure that the parameters are correctly set in the configuration files.
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.
DHCP: Dynamic Host Configuration Protocol (DHCP) is a network configuration protocol
for hosts on Internet Protocol (IP) networks. Computers that are connected to IP networks
must be configured before they can communicate with other hosts.
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.
HTTPS: Hypertext Transfer Protocol Secure (HTTPS) is a combination of Hypertext
Transfer Protocol (HTTP) with SSL/TLS protocol. It provides encrypted communication
and secure identification of a network web server.
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.
AES: Advanced Encryption Standard (AES) is a specification for the encryption of
electronic data.
URL: A uniform resource locator or universal resource locator (URL) is a specific
character string that constitutes a reference to an Internet resource.
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.
47
Yealink IP Phones Auto provisioning Guide
48
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.
To prepare a root directory:
1.
Create an FTP root directory on the local system.
2.
Place the configuration files to this root directory.
3.
Set the security permissions for the FTP directory folder.
You need to define a user or group name, and set the permissions: read, write, and
modify. Security permissions vary by organizations.
An example of configuration on the Windows platform is shown as below:
49
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.
To configure an FTP server:
1.
Double click the 3CDaemon.exe to start the application.
2.
Click the FTP Server button on the left of the main page.
A configuration page is shown as below:
50
3.
Select Configure FTP Server.
4.
Click the
5.
Enter the new authentication user name in the Profile field.
6.
Click the Set/Change user’s password button to set the password in the pop-up
button to locate the FTP root directory from your local system:
Appendix
dialogue box.
7.
Click the OK button to save.
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.
The server URL “ftp://username:password@IP/” (Here “IP” means the IP address of
the provisioning server, “username” and “password” are the authentication for FTP
download. For example, “ftp://admin:123456@192.168.1.100/”) is where the phone
downloads configuration files from.
51
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.
To prepare a root directory:
1.
Create an HTTP root directory on the local system.
2.
Place configuration files to this root directory.
3.
Set the security permissions for the HTTP directory folder.
You need to define a user or group name and set the permissions: read, write, and
modify. Security permissions vary by organizations.
An example of configuration on the Windows platform is shown as below:
HFS tool is an executable application, so you don’t need to install it.
To configure an HTTP server:
1.
52
Download the application file to your local directory, double click the hfs.exe.
Appendix
The main configuration page is shown as below:
2.
Click Menu in the main page and select the IP address of the PC from IP address.
53
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.
54
Appendix
4.
Locate the root directory from your local system.
5.
Check the server URL (e.g., http:// 10.2.11.101:8088/ProvisioningDir/) by clicking
“Open in browser”.
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.
Before configuring the DHCP Turbo, make sure:

The firewall on the PC is disabled.

There is no DHCP server in your local system.
To configure the DHCP Turbo:
1.
To start the DHCP Turbo application, double click localhost.
55
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.
56
Appendix
4.
Right click Scopes and select New Scope.
5.
Configure the DHCP server name, the DHCP IP range and the subnet mask.
6.
Click OK to accept the change.
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.
57
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
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.
58
to
Appendix
10. Scroll down and double click the custom option 128.
11. Fill the provisioning server address in the input field.
12. Click the OK button to finish setting a custom option.
13. Click
to save the change.
59
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.
60
2.
Select TFTP Options from the pull-down list of Filter.
3.
Scroll down and double click MS option 66.
Appendix
4.
Fill the provisioning server address in the input field.
5.
Click the OK button to finish setting a custom option.
6.
Click
to save the change.
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.
2.
Select the Standard Options from the pull-down list of Filter.
3.
Scroll down and double click 43.
61
Yealink IP Phones Auto provisioning Guide
62
4.
Fill the provisioning server address in the input field.
5.
Click the OK button to finish setting a custom option.
6.
Click
to save the change.
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.
To customize a ring tone using Cool Edit Pro:
1.
Open the Cool Edit Pro application.
2.
Click File to open an audio file.
3.
Locate the ring tone file, click Open, the file is uploaded as follows.
A sample audio file loaded is shown as below:
4.
Select and copy the audio waveform.
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.
6.
Paste the audio waveform to the new file.
7.
Select File->Save as to save the new audio file. On the Save waveform page,
63
Yealink IP Phones Auto provisioning Guide
select the file format as A/mu-law wave.
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.
1.
Double click the PictureExDemo.exe.
2.
Click Add button to open a *.bmp or *.gif file.
You can repeat the second step to add multiple original picture files.
3.
Click the Convert button.
Then you can find the DOB logo files in the adv directory.
64
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”.
Parameter
Permitted
Descriptions
Values
Web Setting Path
It configures the IP address mode.
0-IPv4
network.ip_ad
dress_mode =
0, 1 or 2
1-IPv6
2-IPv4&IPv6
Network->Basic->
Internet Port->
Mode (IPv4/IPv6)
The default value is 0.
It takes effect after a reboot.
It configures the Internet (WAN) port
type for IPv4 when the IP address
mode is configured as IPv4 or
IPv4&IPv6.
network.intern
et_port.type =
0-DHCP
0, 1 or 2
1-PPPoE (not applicable to
Network->Basic->
IPv4 Config
SIP-T42G/T41P IP phones)
2-Static IP Address
The default value is 0.
It takes effect after a reboot.
It enables or disables the phone to use
manually configured static IPv4 DNS
when Internet (WAN) port type for IPv4
is configured as DHCP.
network.static
_dns_enable
0 or 1
=
Network->Basic->
0-Disabled (use the IPv4 DNS obtained
IPv4 Config->Static
by DHCP)
DNS
1-Enabled
The default value is 0.
It takes effect after a reboot.
It configures the IPv4 address when the
network.intern
et_port.ip =
IPv4 address
IP address mode is configured as IPv4
Network->Basic->
or IPv4&IPv6, and the Internet (WAN)
IPv4 Config->Static
port type for IPv4 is configured as
IP Address->IP
Static IP Address.
Address
The default value is blank.
65
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
Web Setting Path
It takes effect after a reboot.
It configures the IPv4 subnet mask
when the IP address mode is
network.intern
et_port.mask
=
Subnet
Mask
configured as IPv4 or IPv4&IPv6, and
the Internet (WAN) port type for IPv4 is
configured as Static IP Address.
The default value is blank.
Network->Basic->
IPv4 Config->Static
IP Address->
Subnet Mask
It takes effect after a reboot.
It configures the IPv4 default gateway
when the IP address mode is
configured as IPv4 or IPv4&IPv6, and
network.intern
et_port.gatew
IPv4 address
the Internet (WAN) port type for IPv4 is
configured as Static IP Address.
ay =
The default value is blank.
Network->Basic->
IPv4 Config->Static
IP Address->
Gateway
It takes effect after a reboot.
It configures the primary IPv4 DNS
server when the IP address mode is
network.prima
ry_dns =
configured as IPv4 or IPv4&IPv6, and
IPv4 address
the Internet (WAN) port type for IPv4 is
configured as Static IP Address.
The default value is blank.
Network->Basic->
IPv4 Config->Static
IP Address->
Primary DNS
It takes effect after a reboot.
It configures the secondary IPv4 DNS
server when the IP address mode is
network.secon
dary_dns =
configured as IPv4 or IPv4&IPv6, and
IPv4 address
the Internet (WAN) port type for IPv4 is
configured as Static IP Address.
The default value is blank.
Network->Basic->
IPv4 Config->Static
IP Address->
Secondary DNS
It takes effect after a reboot.
network.pppo
e.user =
(not
applicable to
SIP-T42G/T41P
String within
32
characters
It configures the user name for PPPoE
Network->Basic->
connection.
IPv4 Config->
The default value is blank.
PPPoE->User
It takes effect after a reboot.
Name
It configures the password for PPPoE
Network->Basic->
connection.
IPv4 Config->
IP phones)
network.pppo
e.password =
66
String within
99
Appendix
Parameter
(not
Permitted
Descriptions
Values
characters
applicable to
The default value is blank.
Web Setting Path
PPPoE->Password
It takes effect after a reboot.
SIP-T42G/T41P
IP phones)
It configures the Internet (WAN) port
type for IPv6 when the IP address
mode is configured as IPv6 or
network.ipv6_i
nternet_port.ty
IPv4&IPv6.
0 or 1
pe =
0-DHCP
Network->Basic->
IPv6 Config
1-Static IP Address
The default value is 0.
It takes effect after a reboot.
It enables or disables the phone to use
manually configured static IPv6 DNS
when Internet (WAN) port type for IPv6
is configured as DHCP.
network.ipv6_
static_dns_en
0 or 1
able =
Network->Basic->
0-Disabled (use the IPv6 DNS obtained
IPv6 Config->IPv6
by DHCP)
Static DNS
1-Enabled
The default value is 0.
It takes effect after a reboot.
It configures the IPv6 prefix when the IP
address mode is configured as IPv6 or
network.ipv6_
prefix =
Integer from
0 to 128
IPv4&IPv6, and the Internet (WAN) port
type for IPv6 is configured as Static IP
Address.
The default value is 64.
Network->Basic->
IPv6 Config->Static
IP Address->IPv6
Prefix (0~128)
It takes effect after a reboot.
It configures the IPv6 address when the
IP address mode is configured as IPv6
or IPv4&IPv6, and the Internet (WAN)
network.ipv6_i
nternet_port.i
IPv6 address
port type for IPv6 is configured as
Static IP Address.
p=
The default value is blank.
Network->Basic->
IPv6 Config->Static
IP Address->IP
Address
It takes effect after a reboot.
network.ipv6_i
nternet_port.g
IPv6 address
It configures the IPv6 default gateway
Network->Basic->
when the IP address mode is
IPv6 Config->Static
67
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
ateway =
Web Setting Path
configured as IPv6 or IPv4&IPv6, and
IP Address->
the Internet (WAN) port type for IPv6 is
Gateway
configured as Static IP Address.
The default value is blank.
It takes effect after a reboot.
It configures the primary IPv6 DNS
server when the IP address mode is
configured as IPv6 or IPv4&IPv6, and
network.ipv6_
primary_dns
IPv6 address
the Internet (WAN) port type for IPv6 is
configured as Static IP Address.
=
The default value is blank.
Network->Basic->
IPv6 Config->Static
IP Address->
Primary DNS
It takes effect after a reboot.
It configures the secondary IPv6 DNS
server when the IP address mode is
configured as IPv6 or IPv4&IPv6, and
network.ipv6_
secondary_dn
IPv6 address
the Internet (WAN) port type for IPv6 is
configured as Static IP Address.
s=
The default value is blank.
Network-> Basic->
IPv6 Config->Static
IP Address->
Secondary DNS
It takes effect after a reboot.
It enables or disables the phone to
network.ipv6_i
obtain IPv6 network settings by
cmp_v6.enabl
ICMPv6.
e=
ed->ICMPv6
applicable to
1-Enabled
Status->Active
SIP-T48G/T46G
The default value is 1.
(only
0 or 1
IP phones)
It takes effect after a reboot.
network.bridg
It configures the PC (LAN) port type.
e_mode =
0-Router
(only
1-Bridge
applicable to
SIP-T28P,
0 or 1
The default value is 1.
It takes effect after a reboot.
SIP-T26P,
SIP-T22P and
Note: SIP-T19P/T21P/T48G/T46G/
SIP-T20P IP
T42G/T41P/ IP phones only support
phones)
bridge mode for PC connection.
network.pc_p
ort.enable =
68
Network->Advanc
0-Disabled
0 or 1
Network->PC Port
->PC Port Config
It enables or disables the PC port.
Network->PC Port
0-Disabled
->PC Port Active
Appendix
Parameter
Permitted
Descriptions
Values
Web Setting Path
1-Auto Negotiation
The default value is 1.
It takes effect after a reboot.
network.pc_p
ort.ip =
It configures the IP address of the PC
(only
(LAN) port when the PC (LAN) port is
applicable to
SIP-T28P,
IP address
configured as Router.
SIP-T26P,
The default value is 10.0.0.1.
SIP-T22P and
It takes effect after a reboot.
Network->PC Port
->PC Port Config
->As Router->IP
Address
SIP-T20P IP
phones)
network.pc_p
ort.mask =
It configures the mask of the PC (LAN)
(only
port when the PC (LAN) port is
applicable to
SIP-T28P,
IP address
configured as Router.
SIP-T26P,
The default value is 255.255.255.0.
SIP-T22P and
It takes effect after a reboot.
Network->PC Port
->PC Port Config
->As Router
->Subnet Mask
SIP-T20P 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)
(only
port is configured as Router.
applicable to
0-Disabled
->As Router
1-Enabled
->Enable DHCP
The default value is 1.
Server
SIP-T28P,
0 or 1
SIP-T26P,
SIP-T22P and
Network->PC Port
->PC Port Config
It takes effect after a reboot.
SIP-T20P IP
phones)
network.dhcp.
start_ip =
(only
applicable to
SIP-T28P,
SIP-T26P,
IP address
It configures the start IP address of the
Network->PC Port
DHCP IP segment.
->PC Port Config
The default value is 10.0.0.10.
->As Router->Start
It takes effect after a reboot.
IP Address
SIP-T22P and
SIP-T20P IP
69
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
Web Setting Path
phones)
network.dhcp.
end_ip =
(only
It configures the end IP address of the
applicable to
Network->PC Port
DHCP IP segment.
->PC Port Config
The default value is 10.0.0.100.
->As Router->End
It takes effect after a reboot.
IP Address
SIP-T28P,
IP address
SIP-T26P,
SIP-T22P and
SIP-T20P IP
phones)
It configures the transmission mode
and speed of the Internet (WAN) port.
0-Auto negotiate
1-Full duplex 10Mbps
network.intern
et_port.speed
_duplex =
2-Full duplex 100Mbps
Network->
0, 1, 2, 3, 4 or
3-Half duplex 10Mbps
Advanced->Port
5
4-Half duplex 100Mbps
Link-> WAN Port
5-Full duplex 1000Mbps (only
Link
applicable to SIP-T48G, SIP-T46G and
SIP-T42G IP phones)
The default value is 0.
It takes effect after a reboot.
It configures the transmission mode
and speed of the PC (LAN) port.
0-Auto negotiate
1-Full duplex 10Mbps
2-Full duplex 100Mbps
network.pc_p
ort.speed_dup
lex =
0, 1, 2, 3, 4 or
3-Half duplex 10Mbps
5
4-Half duplex 100Mbps
Network->
Advanced->Port
Link->PC Port Link
5-Full duplex 1000Mbps (only
applicable to SIP-T48G, T46G and T42G
IP phones)
The default value is 0.
It takes effect after a reboot.
network.vlan.i
nternet_port_e
70
0 or 1
It enables or disables VLAN of the
Internet (WAN) port.
Network->
Advanced->VLAN
->WAN Port->
Appendix
Parameter
Permitted
Descriptions
Values
nable =
0-Disabled
Web Setting Path
Active
1-Enabled
The default value is 0.
It takes effect after a reboot.
network.vlan.i
nternet_port_v
id =
network.vlan.i
nternet_port_p
riority =
Integer from
1 to 4094
Integer from
0 to 7
It configures VLAN ID of the Internet
Network->
(WAN) port.
Advanced->VLAN
The default value is 1.
->WAN Port->VID
It takes effect after a reboot.
(1-4094)
It configures VLAN priority of the
Network->
Internet (WAN) port.
Advanced->VLAN
The default value is 0.
->WAN Port->
It takes effect after a reboot.
Priority
It enables or disables VLAN of the PC
(LAN) port.
network.vlan.
pc_port_enabl
0-Disabled
0 or 1
e=
1-Enabled
The default value is 0.
Network->
Advanced->VLAN
>PC Port->Active
It takes effect after a reboot.
network.vlan.
Integer from
pc_port_vid =
1 to 4094
It configures VLAN ID of the PC (LAN)
Network->
port.
Advanced->VLAN
The default value is 1.
>PC Port->VID
It takes effect after a reboot.
(1-4094)
It configures VLAN priority of the PC
network.vlan.
pc_port_priorit
y=
Integer from
0 to 7
(LAN) port.
The default value is 0.
It takes effect after a reboot.
Network->
Advanced->VLAN
>PC Port->Priority
It configures the way the phone
network.vlan.
processes packets sent from the PC
pc_port_mode
port when VLAN is enabled on the PC
=
port.
(only
0 or 1
0-Forward the packets directly
applicable to
1-Tag and then forward the packets if
SIP-T4X IP
there is no VLAN tag on the packets,
phones)
otherwise, forward the packets
directly.
71
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
Web Setting Path
The default value is 0.
It takes effect after a reboot.
It enables or disables the phone to
obtain VLAN by DHCP.
network.vlan.
dhcp_enable
0 or 1
=
Network->
0-Disabled
Advanced->VLAN
1-Enabled
>DHCP VLAN->
The default value is 1.
Active
It takes effect after a reboot.
It configures the DHCP option from
which the phone will obtain the VLAN
network.vlan.
dhcp_option
=
Integer from
128 to 254
settings. You can configure at most five
DHCP options and separate them by
commas.
The default value is 132.
Network->
Advanced->VLAN
>DHCP VLAN->
Option
It takes effect after a reboot.
It configures the client host name for
DHCP option 12.
For SIP-T28P IP phones:
The default value is SIP-T28P.
For SIP-T26P IP phones:
The default value is SIP-T26P.
For SIP-T22P IP phones:
The default value is SIP-T22P.
For SIP-T21P IP phones:
network.dhcp
_host_name =
String within
99
characters
The default value is SIP-T21P.
For SIP-T20P IP phones:
The default value is SIP-T20P.
For SIP-T19P IP phones:
The default value is SIP-T19P.
For SIP-T48G IP phones:
The default value is SIP-T48G.
For SIP-T46G IP phones:
The default value is SIP-T46G.
For SIP-T42G IP phones:
The default value is SIP-T42G.
72
Features->General
Information->
DHCP Hostname
Appendix
Parameter
Permitted
Descriptions
Values
Web Setting Path
For SIP-T41P IP phones:
The default value is SIP-T41P.
It takes effect after a reboot.
It enables or disables the HTTP
protocol for web server access.
wui.http_enab
le =
0 or 1
0-Disabled
1-Enabled
Network->
Advanced->Web
Server->HTTP
The default value is 1.
It takes effect after a reboot.
It enables or disables the HTTPS
protocol for web server access.
wui.https_ena
ble =
0 or 1
0-Disabled
1-Enabled
Network->
Advanced->Web
Server->HTTPS
The default value is 1.
It takes effect after a reboot.
network.port.h
ttp =
network.port.h
ttps =
network.port.
max_rtpport =
network.port.
min_rtpport =
network.qos.rt
ptos =
Integer from
1 to 65535
Integer from
1 to 65535
Integer from
1024 to
65535
Integer from
1024 to
65535
Integer from
0 to 63
It configures the HTTP port for web
Network->
server access.
Advanced->Web
The default value is 80.
Server->HTTP Port
It takes effect after a reboot.
(1~65535)
It configures the HTTPS port for web
Network->
server access.
Advanced->Web
The default value is 443.
Server->HTTPS Port
It takes effect after a reboot.
(1~65535)
It configures the maximum local RTP
Network->
port.
Advanced->Local
The default value is 11800.
RTP Port-> Max RTP
It takes effect after a reboot.
Port (1024~65535)
It configures the minimum local RTP
Network->
port.
Advanced->Local
The default value is 11780.
RTP Port->Min RTP
It takes effect after a reboot.
Port (1024~65535)
It configures the voice QoS.
Network->
The default value is 46.
Advanced->Voice
It takes effect after a reboot.
QoS (0~63)
73
Yealink IP Phones Auto provisioning Guide
Parameter
network.qos.si
gnaltos =
Permitted
Descriptions
Values
Integer from
0 to 63
Web Setting Path
It configures the SIP QoS.
Network->
The default value is 26.
Advanced->SIP
It takes effect after a reboot.
QoS (0~63)
It configures the 802.1x mode.
0-Disabled
1-EAP-MD5
network.802_1
x.mode =
0, 1, 2, 3 or 4
2-EAP-TLS
3-PEAP-MSCHAPV2
Network->
Advanced->802.1x
->802.1x Mode
4-EAP-TTLS/EAP-MSCHAPv2
The default value is 0.
It takes effect after a reboot.
network.802_1
x.identity =
String within
32
characters
network.802_1
String within
x.md5_passw
32
ord =
characters
It configures the user name for 802.1x
authentication.
The default value is blank.
It takes effect after a reboot.
It configures the password for 802.1x
authentication.
The default value is blank.
It takes effect after a reboot.
Network->
Advanced->802.1x
->Identity
Network->
Advanced->802.1x
->MD5 Password
It configures the access URL of the CA
certificate when the 802.1x mode is
network.802_1
x.root_cert_url
=
URL within
511
characters
configured as EAP-TLS,
Network->
PEAP-MSCHAPV2 or
Advanced->802.1x
EAP-TTLS/EAP-MSCHAPV2.
->CA Certificates
The default value is blank.
It takes effect after a reboot.
It configures the access URL of the
network.802_1
URL within
x.client_cert_u
511
rl =
characters
device certificate when the 802.1x
mode is configured as EAP-TLS.
The default value is blank.
Network->
Advanced->802.1x
->Device
Certificates
It takes effect after a reboot.
It enables or disables OpenVPN
network.vpn_
enable =
74
feature.
0 or 1
(not
0-Disabled
applicable to
1-Enabled
Network->
Advanced->VPN
->Active
Appendix
Parameter
Permitted
Descriptions
Values
SIP-T19P IP
The default value is 0.
phones)
It takes effect after a reboot.
openvpn.url =
(not
applicable to
SIP-T19P IP
URL within
511
characters
It configures the access URL of the *.tar
file for OpenVPN.
The default value is blank.
phones)
Web Setting Path
Network->
Advanced->VPN>Upload VPN
Config
It enables or disables LLDP feature.
network.lldp.e
nable =
0 or 1
0-Disabled
Network->
1-Enabled
Advanced->LLDP-
The default value is 1.
>Active
It takes effect after a reboot.
It configures the interval (in seconds)
network.lldp.p
acket_interval
=
Integer from
1 to 3600
for the phone to broadcast the LLDP
request.
The default value is 60.
Network->
Advanced->LLDP>Packet Interval
(1~3600s)
It takes effect after a reboot.
It enables or disables the phone to
span data packets received in the
WAN port to the PC port. If it is
network.span_
to_pc_port =
0 or 1
enabled, all packets from WAN port
Network->
can be received by PC port.
Advanced->Span
0-Disabled
to PC->Span to PC
1-Enabled
Port
The default value is 0.
It takes effect after a reboot.
It configures the maximum duration (in
sip.reg_surge_
prevention =
Integer from
0 to 60
seconds) for account register after
startup.
The default value is 0.
It takes effect after a reboot.
Network->
Advanced->
Registration
Random->
Registration
Random (0~60s)
It configures from where the phone
sip.send_resp
onse_by_requ
est =
retrieves the destination address for
0 or 1
response. The phone will then send all
SIP response messages to the
destination address.
75
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
Web Setting Path
0-from VIA header in the request
message
1-from source address of the request
message
The default value is 1.
It takes effect after a reboot.
It configures the phone behavior when
receiving a SIP NOTIFY message which
contains the header “Event:
check-sync”.
sip.notify_rebo
ot_enable =
0-The phone will reboot only if the SIP
0, 1or 2
NOTIFY message contains an
additional string “reboot=true”.
1-The phone will be forced to reboot.
2-The phone will ignore the SIP NOTIFY
message.
The default value is 1.
It configures the phone to export log
files to a syslog server or the local
system.
syslog.mode
=
0 or 1
Settings->
0-Local
Configuration->Ex
1-Server
port System Log
The default value is 0.
It takes effect after a reboot.
It configures the IP address or domain
name of the syslog server when
syslog.server
=
IP address
or domain
name
exporting log to the syslog server.
Settings->
It takes effect only if the parameter
Configuration->
“syslog.mode” is configured as Server.
Server Name
The default value is blank.
It takes effect after a reboot.
It configures the detail level of syslog
information to be exported.
syslog.log_lev
el =
Integer from
0 to 6
0 means nothing and 6 means all.
Configuration->
The default value is 3.
System Log Level
It takes effect after a reboot.
76
Settings->
Appendix
Parameter
Permitted
Descriptions
Values
Web Setting Path
It enables or disables the phone to
perform an auto provisioning process
when powered on.
auto_provision
.power_on =
0 or 1
0-Disabled
Settings->Auto
1-Enabled
Provision->Power
The default value is 1.
On
Note: The old parameter
“auto_provision.mode” is also
applicable to IP phones.
It enables or disables Plug and Play
feature. If it is enabled, the phone will
broadcast PnP SUBSCRIBE messages
auto_provision
.pnp_enable
0 or 1
=
to obtain a provisioning server
Settings->Auto
address after startup.
Provision->PNP
0-Disabled
Active
1-Enabled
The default value is 1.
It enables or disables the phone to
check new configuration weekly.
auto_provision
.weekly.enabl
0 or 1
e=
0-Disabled
1-Enabled
Settings->Auto
provision->Weekly
The default value is 0.
It configures the days of the week for
the phone to check new configuration
weekly.
0-Sunday
1-Monday
0,1,2,3,4,5,6
auto_provision
or a
.weekly.dayof
combination
week =
of these
digits
2-Tuesday
3-Wednesday
4-Thursday
Settings->Auto
provision->Day of
week
5-Friday
6-Saturday
Example:
auto_provision.weekly.dayofweek =
01 means the phone will check the
new configuration every Sunday and
77
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
Web Setting Path
Monday.
The default value is 0123456.
Note: The old parameters
“auto_provision.weekly.mask” is also
applicable to SIP-T21P/T19P/T4X IP
phones and
“auto_provision.schedule.dayofweek”.
is also applicable to
SIP-T28P/T26P/T22P/T20P IP phones.
It configures the begin time of the day
for the phone to check new
configuration weekly.
auto_provision
Time from
.weekly.begin
00:00 to
_time =
23:59
The default value is 00:00.
Settings->Auto
Note: The old parameter
provision->Time
“auto_provision.schedule.time_from” is
also applicable to
SIP-T28P/T26P/T22P/T20P IP phones.
It configures the end time of the day
for the phone to check new
auto_provision
Time from
.weekly.end_ti
00:00 to
me =
23:59
configuration weekly.
The default value is 00:00.
Settings->Auto
Note: The old parameter
provision->Time
“auto_provision.schedule.time_to” is
also applicable to
SIP-T28P/T26P/T22P/T20P IP phones.
It enables or disables the phone to
check new configuration repeatedly.
auto_provision
.repeat.enabl
0 or 1
e=
Settings->Auto
0-Disabled
provision->
1-Enabled
Repeatedly
The default value is 0.
It configures the interval (in minutes)
for the phone to check new
configuration repeatedly.
auto_provision
.repeat.minut
es =
Integer from
The default value is 1440.
1 to 43200
Note: The old parameter
“auto_provision.schedule.periodic_min
ute” is also applicable to
SIP-T28P/T26P/T22P/T20P IP phones.
78
Settings->Auto
provision->Interval
(minutes)
Appendix
Parameter
Permitted
Descriptions
Values
Web Setting Path
It enables or disables the phone to
obtain the provisioning server address
auto_provision
.dhcp_option.
by detecting DHCP options.
0 or 1
enable =
0-Disabled
1-Enabled
Settings->Auto
Provision->DHCP
Active
The default value is 1.
auto_provision
.dhcp_option.l
Integer from
ist_user_optio
128 to 254
ns =
auto_provision
.server.url =
URL within
511
characters
auto_provision
String within
.server.userna
32
me =
characters
auto_provision
String within
.server.passw
32
ord =
auto_provision
.dhcp_option.
option60_valu
e=
characters
String within
99
characters
It configures the custom DHCP option
Settings->Auto
for provisioning server address.
Provision->Custom
The default value is blank.
Option (128~254)
It configures the access URL of
Settings->Auto
configuration files.
Provision->Server
The default value is blank.
URL
It configures the user name for
authentication during auto
provisioning.
The default value is blank.
It configures the password for
authentication during auto
provisioning.
The default value is blank.
Settings->Auto
Provision->User
Name
Settings->Auto
Provision->
Password
It configures the value (vendor name
Settings->Auto
of the device) of DHCP option 60.
Provision->DHCP
The default value is yealink.
Option Value
It configures the AES key for
auto_provision
.aes_key_16.c
om =
16
characters
decrypting the Common CFG file.
Settings->Auto
The valid characters contain: 0 ~ 9, A
Provision->
~ Z, a ~ z.
Common AES Key
The default value is blank.
It configures the AES key for
auto_provision
.aes_key_16.m
ac =
16
characters
decrypting the MAC-Oriented CFG
Settings->Auto
file.
Provision->
The valid characters contain: 0 ~ 9, A
MAC-Oriented
~ Z, a ~ z.
AES Key
The default value is blank.
79
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
It enables or disables the phone to
decrypt configuration files using the
encrypted AES keys.
0-Disabled
1-Enabled
If it is set to 1, the phone will download
<y0000000000xx_Security>.enc and
auto_provision
.aes_key_in_fil
0 or 1
<MAC_Security>.enc files during auto
provisioning, and then decrypts these
e=
files into the plaintext keys (e.g., key2,
key3) respectively using the phone
built-in key (e.g., key1). The IP phone
then decrypts the encrypted
configuration files using corresponding
key (e.g., key2, key3).
The default value is 0.
autoprovision.
X.name =
(X ranges
from 1 to 50)
String within
64
characters
It configures the name of the code for
triggering auto provisioning.
The default value is blank.
It takes effect after a reboot.
It configures the code for triggering
auto provisioning.
autoprovision.
X.code =
(X ranges
Valid characters are digits, # and *.
String
Example:
autoprovision.1.code = *99
from 1 to 50)
The default value is blank.
It takes effect after a reboot.
autoprovision.
X.url =
(X ranges
from 1 to 50)
autoprovision.
X.user =
(X ranges
from 1 to 50)
80
URL within
511
characters
It configures the access URL of auto
provisioning server.
The default value is blank.
It takes effect after a reboot.
It configures the user name for
String within
64
characters
authentication during auto
provisioning.
The default value is blank.
It takes effect after a reboot.
Web Setting Path
Appendix
Parameter
autoprovision.
X.password =
(X ranges
from 1 to 50)
Permitted
(X ranges
String within
32
characters
provisioning.
The default value is blank.
It configures the AES key for
16
characters
decrypting the Common CFG file.
The default value is blank.
It takes effect after a reboot.
It configures the AES key for
autoprovision.
(X ranges
authentication during auto
It takes effect after a reboot.
from 1 to 50)
X.mac_aes =
Web Setting Path
It configures the password for
autoprovision.
X.com_aes =
Descriptions
Values
16
characters
from 1 to 50)
decrypting the MAC-Oriented CFG
file.
The default value is blank.
It takes effect after a reboot.
It enables or disables the phone to
reserve the pound sign when dialing
out.
sip.use_23_as
_pound =
0 or 1
0-Disabled (convert the pound sign
into “%23”)
1-Enabled
Features->General
Information->
Reserve # in User
Name
The default value is 1.
It enables or disables the phone to
support RFC 2543 hold (c=0.0.0.0).
sip.rfc2543_ho
ld =
0 or 1
Features->General
0-Disabled
Information->RFC
1-Enabled
2543 Hold
The default value is 0.
It enables or disables the phone to
keep sending SIP requests to the
outbound server in a dialog.
sip.use_out_b
ound_in_dialo
0 or 1
g=
0-Disabled
1-Enabled
The default value is 1.
Features->General
Information->Use
Outbound Proxy In
Dialog
It takes effect after a reboot.
watch_dog.en
able =
0 or 1
It enables or disables Watch Dog
Settings->
feature. If it is enabled, the phone will
Preference->
reboot automatically when the system
Watch Dog
81
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
Web Setting Path
is broken down.
0-Disabled
1-Enabled
The default value is 1.
managements
erver.enable
It enables or disables TR069 feature.
=
(not
applicable to
0 or 1
SIP-T42G and
0-Disabled
Settings->TR069->
1-Enabled
Enable TR069
The default value is 0.
SIP-T41P IP
phones)
managements
erver.usernam
e=
(not
applicable to
SIP-T42G and
String within
128
characters
It configures the user name for the
phone to authenticate with the ACS.
The default value is blank.
Settings->TR069->
ACS Username
SIP-T41P IP
phones)
managements
erver.passwor
d=
(not
applicable to
SIP-T42G and
String within
64
It configures the password for the
phone to authenticate with the ACS.
characters
The default value is blank.
URL within
It configures the access URL of the
Settings->TR069->
ACS Password
SIP-T41P IP
phones)
managements
erver.url =
(not
applicable to
511
SIP-T42G and
characters
ACS.
The default value is blank.
Settings->TR069->
ACS URL
SIP-T41P IP
phones)
managements
erver.periodic
_inform_enabl
82
0 or 1
It enables or disables the phone to
Settings->TR069->
report its configuration to the ACS.
Enable Periodic
0-Disabled
Inform
Appendix
Parameter
Permitted
Descriptions
Values
e=
1-Enabled
(not
The default value is 1.
Web Setting Path
applicable to
SIP-T42G and
SIP-T41P IP
phones)
managements
erver.periodic
_inform_interv
al =
Integer from
(not
5 to
applicable to
4294967295
SIP-T42G and
It configures the interval (in seconds)
for the phone to report its configuration
to the ACS.
The default value is 60.
Settings->TR069->
Periodic Inform
Interval (seconds)
SIP-T41P IP
phones)
managements
erver.connecti
on_request_us
ername =
(not
applicable to
String within
128
characters
SIP-T42G and
It configures the user name for the
phone to authenticate the connection
requests.
The default value is blank.
Settings->TR069->
Connection
Request Username
SIP-T41P IP
phones)
managements
erver.connecti
on_request_p
assword =
(not
applicable to
String within
64
characters
SIP-T42G and
It configures the password for the
phone to authenticate the connection
requests.
The default value is blank.
Settings->TR069->
Connection
Request Password
SIP-T41P IP
phones)
It enables or disables the transferee
party’s phone to prompt a missed call
transfer.semi_
attend_tran_e
nable =
0 or 1
on the LCD screen before displaying
the caller ID when performing a
semi-attended transfer.
Features->Transfer
->Semi-Attend
Transfer
0-Enabled
83
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
Web Setting Path
1-Disabled
The default value is 1.
It enables or disables the phone to
complete the blind transfer through
transfer.blind_
tran_on_hook_
on-hook.
0 or 1
enable =
0-Disabled
1-Enabled
Features->Transfer
->Blind Transfer On
Hook
The default value is 1.
It enables or disables the phone to
complete the attended transfer
transfer.on_ho
ok_trans_ena
through on-hook.
0 or 1
ble =
0-Disabled
1-Enabled
Features->Transfer
->Semi Attend
Transfer On Hook
The default value is 1.
It configures the DSS key behavior
during an active call when user
presses the DSS key and the DSS key is
configured as a speed dial, transfer or
transfer.dsske
y_deal_type =
0, 1 or 2
BLF/BLF list key.
0-New Call
Features->Transfer
->Transfer Mode
Via Dsskey
1-Attended Transfer
2-Blind Transfer
The default value is 2.
transfer.multi_
It enables or disables the phone to
call_trans_ena
enter Transfer to menu during multiple
ble =
(not
applicable to
0 or 1
calls when pressing the transfer soft
Features->General
key or TRAN key.
Information->
0-Disabled
SIP-T20P and
1-Enabled
SIP-T4X IP
It enables or disables the phone to
transfer call to the two parties after a
transfer.tran_o
nf_enable =
0 or 1
local conference call hangs up.
0-Disabled
1-Enabled
84
Call
The default value is 1.
phones)
thers_after_co
Allow Trans Exist
Features->Transfer
->Transfer on
Conference Hang
up
Appendix
Parameter
Permitted
Descriptions
Values
Web Setting Path
The default value is 0.
It enables or disables VAD (Voice
Activity Detection) feature.
voice.vad =
0 or 1
Settings->Voice->
0-Disbaled
Echo Cancellation
1-Enabled
->VAD
The default value is 0.
It enables or disables CNG
(Comfortable Noise Generator)
feature.
voice.cng =
0 or 1
0-Disabled
1-Enabled
Settings->Voice->
Echo Cancellation
->CNG
The default value is 1.
It enables or disables AEC (Acoustic
voice.echo_ca
ncellation =
0 or 1
Echo Canceller) feature.
Settings->Voice->
0-Disabled
Echo Cancellation
1-Enabled
->ECHO
The default value is 1.
It configures the type of jitter buffer.
voice.jib.adap
tive =
0 or 1
0-Fixed
1-Adaptive
Settings->Voice->
JITTER BUFFER->
Type
The default value is 1.
voice.jib.min
=
voice.jib.max
=
voice.jib.norm
al =
Integer from
0 to 400
Integer from
0 to 400
Integer from
0 to 400
It configures the minimum delay (in
Settings->Voice->
milliseconds) of jitter buffer.
JITTER BUFFER->
The default value is 60.
Min Delay
It configures the maximum delay (in
Settings->Voice->
milliseconds) of jitter buffer.
JITTER BUFFER->
The default value is 300.
Max Delay
It configures the normal delay (in
Settings->Voice->
milliseconds) of jitter buffer.
JITTER BUFFER->
The default value is 120.
Normal
Custom,
voice.tone.cou
ntry =
Australia,
Austria,
Brazil,
It configures the country tone for the
phone.
The default value is Custom.
Settings->Tones->
Select Country
Belgium,
85
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
Web Setting Path
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
It customizes the dial tone when the
parameter "voice.tone.country" is set
to Custom.
tonelist = element[,element]
[,element]…
voice.tone.dia
l=
Where
String
element =
[!]Freq1[+Freq2][+Freq3][+Freq4]
/Duration
Freq: the frequency of the tone (ranges
from 200 to 7000 Hz). If it is set to 0Hz, it
means silence. A tone is comprised of
at most four different frequencies.
86
Settings->Tones->
Dial
Appendix
Parameter
Permitted
Descriptions
Values
Web Setting Path
Duration: the duration (in milliseconds)
of the dial tone, ranges from 0 to
30000ms.
You can configure at most eight
different tones for one condition, and
separate them by commas. (e.g.,
250/200, 0/1000, 200+300/500,
600+700+800+1000/2000).
If you want the phone to play tones
once, add an exclamation mark “!”
before tones (e.g., !250/200, 0/1000,
200+300/500,
600+700+800+1000/2000).
The default value is blank.
It customizes the ringback tone when
the parameter "voice.tone.country" is
set to Custom.
voice.tone.rin
g=
String
The value format is Freq/Duration. For
Settings->Tones->
more information on the value format,
Ring Back
refer to the parameter
“voice.tone.dial”.
The default value is blank.
It customizes the busy tone when the
parameter "voice.tone.country" is set
to Custom.
voice.tone.bus
y=
String
The value format is Freq/Duration. For
Settings->Tones->
more information on the value format,
Busy
refer to the parameter
“voice.tone.dial”.
The default value is blank.
It customizes the tone for network
congestion when the parameter
"voice.tone.country" is set to Custom.
voice.tone.con
gestion =
String
The value format is Freq/Duration. For
Settings->Tones->
more information on the value format,
Congestion
refer to the parameter
“voice.tone.dial”.
The default value is blank.
87
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
Web Setting Path
It customizes the call waiting tone
when the parameter
"voice.tone.country" is set to Custom.
voice.tone.call
waiting =
String
The value format is Freq/Duration. For
Settings->Tones->
more information on the value format,
Call Waiting
refer to the parameter
“voice.tone.dial”.
The default value is blank.
It customizes the call back tone when
the parameter "voice.tone.country" is
set to Custom.
voice.tone.dia
lrecall =
String
The value format is Freq/Duration. For
Settings->Tones->
more information on the value format,
Dial Recall
refer to the parameter
“voice.tone.dial”.
The default value is blank.
It customizes the info tone when the
parameter "voice.tone.country" is set
to Custom.
voice.tone.inf
o=
String
The value format is Freq/Duration. For
Settings->Tones->
more information on the value format,
Info
refer to the parameter
“voice.tone.dial”.
The default value is blank.
It customizes the stutter tone when the
parameter "voice.tone.country" is set
to Custom.
voice.tone.stut
ter =
String
The value format is Freq/Duration. For
Settings->Tones->
more information on the value format,
Stutter
refer to the parameter
“voice.tone.dial”.
The default value is blank.
voice.tone.me
It customizes the message tone when
ssage =
the parameter "voice.tone.country" is
set to Custom.
Settings->Tones->
applicable to
The value format is Freq/Duration. For
Message
SIP-T20P,
more information on the value format,
SIP-T42G and
refer to the parameter
(not
88
String
Appendix
Parameter
Permitted
Descriptions
Values
SIP-T41P IP
“voice.tone.dial”.
phones)
The default value is blank.
Web Setting Path
It customizes the warning tone for auto
answer when the parameter
"voice.tone.country" is set to Custom.
voice.tone.aut
oanswer =
String
The value format is Freq/Duration. For
Settings->Tones->
more information on the value format,
Auto Answer
refer to the parameter
“voice.tone.dial”.
The default value is blank.
voice.group_s
pk_vol =
voice.ring_vol
=
Integer from
1 to 15
Integer from
1 to 15
It configures the receiving volume of
the group listening mode.
The default value is 8.
It configures the volume of ringer.
The default value is 8.
It configures the receiving volume of
speaker.
voice.handfre
e.spk_vol =
Integer from
1 to 15
The default value is 8.
It takes effect after a reboot (only for
SIP-T28P/T26P/T22P/T20P IP phones).
It configures the receiving volume of
handset.
voice.handset
.spk_vol =
Integer from
1 to 15
The default value is 8.
It takes effect after a reboot (only for
SIP-T28P/T26P/T22P/T20P IP phones).
It configures the receiving volume of
headset.
voice.headset
.spk_vol =
Integer from
1 to 15
The default value is 8.
It takes effect after a reboot (only for
SIP-T28P/T26P/T22P/T20P IP phones).
It configures the dial tone volume of
speaker.
voice.handfre
Integer from
e.tone_vol =
1 to 15
The default value is 8.
It takes effect after a reboot (only for
SIP-T28P/T26P/T22P/T20P IP phones).
89
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
Web Setting Path
It configures the dial tone volume of
voice.handset
.tone_vol =
Integer from
1 to 15
handset.
The default value is 8.
It takes effect after a reboot (only for
SIP-T28P/T26P/T22P/T20P IP phones).
It configures the dial tone volume of
headset.
voice.headset
.tone_vol =
Integer from
1 to 15
The default value is 8.
It takes effect after a reboot (only for
SIP-T28P/T26P/T22P/T20P IP phones).
voice.handfre
e_send =
(only
It configures the sending volume of
applicable to
Features->
speaker.
Audio->Handfree
The default value is 35.
Send Volume
It takes effect after a reboot.
(1~53)
(only
It configures the sending volume of
applicable to
Features->
handset.
Audio->Handset
The default value is 25.
Send Volume
It takes effect after a reboot.
(1~53)
(only
It configures the sending volume of
applicable to
Features->
headset.
Audio->Headset
The default value is 30.
Send Volume
It takes effect after a reboot.
(1~53)
SIP-T28P,
SIP-T26P,
Integer from
1 to 53
SIP-T22P and
SIP-T20P IP
phones)
voice.handset
_send =
SIP-T28P,
SIP-T26P,
Integer from
1 to 53
SIP-T22P and
SIP-T20P IP
phones)
voice.headset
_send =
SIP-T28P,
SIP-T26P,
SIP-T22P and
SIP-T20P IP
phones)
90
Integer from
1 to 53
Appendix
Parameter
Permitted
Descriptions
Values
Web Setting Path
It enables or disables the phone to
only accept the certificates in the
security.trust_c
ertificates =
0 or 1
Trusted Certificates list.
Security->Trusted
0-Disabled
Certificates->Only
1-Enabled
Accept Trusted
Certificates
The default value is 1.
It takes effect after a reboot.
It configures the source certificates for
the phone to authenticate for TLS
connection.
security.ca_ce
rt =
0-Default certificates
0, 1 or 2
1-Custom certificates
2-All certificates
Security->Trusted
Certificates->CA
Certificates
The default value is 2.
It takes effect after a reboot.
It enables or disables the phone to
mandatorily validate the
CommonName or SubjectAltName of
security.cn_val
idation =
0 or 1
the certificate received from the
Security->Trusted
connecting server.
Certificates->Com
0-Disabled
mon Name
1-Enabled
Validation
The default value is 0.
It takes effect after a reboot.
It configures the device certificates for
the phone to send for TLS
authentication.
security.dev_c
ert =
0 or 1
Security->Server
0-Default certificates
Certificates->Devi
1-Custom certificates
ce Certificates
The default value is 0.
It takes effect after a reboot.
security.user_n
ame.user =
String within
32
characters
security.user_n
String within
ame.admin =
32
It configures the user name of the user
for web server access.
The default value is user.
It configures the user name of the
administrator for web server access.
91
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
characters
security.user_n
ame.var =
Descriptions
Values
String within
Web Setting Path
The default value is admin.
It configures the user name of the var
32
for web server access.
characters
The default value is var.
It configures the password of the user,
var and administrator.
The valid value format is
username:new password.
security.user_
password =
String within
32
characters
Example:
security.user_password =
Security->Passwor
d
admin:password123 means setting the
password of administrator (current
user name is “admin”) to
password123.
The default value is blank.
It enables or disables the 3-level
permissions (admin, user, var).
security.var_e
nable =
0 or 1
0-Disabled
1-Enabled
The default value is 0.
It takes effect after a reboot.
It configures the access URL of the file,
web_item_lev
el.url =
URL within
511
characters
which defines 3-level access
permissions.
The default value is blank.
It takes effect after a reboot.
phone_setting
.custom_softke
It enables or disables customizing the
y_enable =
soft keys layout.
0-Disabled
Layout->Custom
applicable to
1-Enabled
Softkey
SIP-T20P IP
The default value is 0.
(not
0 or 1
phones)
custom_softke
y_call_failed.u
rl =
(not
92
Settings->Softkey
URL within
It configures the access URL of the file
511
for custom soft keys layout on the LCD
characters
screen when Call failed.
Appendix
Parameter
Permitted
Values
Descriptions
Web Setting Path
The default value is blank.
applicable to
SIP-T20P IP
phones)
custom_softke
y_call_in.url =
(not
applicable to
SIP-T20P IP
URL within
511
characters
It configures the access URL of the file
for custom soft keys layout on the LCD
screen when Call in.
The default value is blank.
phones)
custom_softke
y_connecting.
url =
URL within
(not
511
applicable to
characters
SIP-T20P IP
It configures the access URL of the file
for custom soft keys layout on the LCD
screen when Connecting.
The default value is blank.
phones)
custom_softke
y_dialing.url =
(not
applicable to
SIP-T20P IP
URL within
511
characters
It configures the access URL of the file
for custom soft keys layout on the LCD
screen when Dialing.
The default value is blank.
phones)
custom_softke
y_ring_back.ur
l=
URL within
(not
511
applicable to
characters
SIP-T20P IP
It configures the access URL of the file
for custom soft keys layout on the LCD
screen when Ringback.
The default value is blank.
phones)
custom_softke
y_talking.url =
(not
applicable to
SIP-T20P IP
URL within
511
characters
It configures the access URL of the file
for custom soft keys layout on the LCD
screen when Talking.
The default value is blank.
phones)
memorykey.X.
It configures the desired feature for
DSSKey->Memory
type =
memory key X.
Key->Memory
Valid values are:
KeyX->Type
(X ranges
Integer
93
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
from 1 to 10)
0-N/A
(only
1-Conference
applicable to
2-Forward
SIP-T28P and
SIP-T26P IP
phones)
3-Transfer
4-Hold
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
50-Keypad Lock
94
Web Setting Path
Appendix
Parameter
Permitted
Descriptions
Values
Web Setting Path
55-Meet-Me Conference
56-Retrieve Park
57-Hoteling
58-ACD Trace
59-Disp Code
60-Emergency
61-Directory
The default value is 0.
It configures the desired line to apply
memorykey.X.l
the key feature.
ine =
1-Line 1
(X ranges
from 1 to 10)
2-Line 2
Integer from
DSSKey->Memory
3-Line 3
Key->Memory
applicable to
4-Line 4
KeyX->Line
SIP-T28P and
5-Line 5
SIP-T26P IP
6-Line 6
(only
1 to 6
phones)
The default value is 1.
memorykey.X.
value =
It configures the value of the memory
(X ranges
from 1 to 10)
(only
applicable to
key feature.
String within
99
characters
SIP-T28P and
For example, when the key feature is
BLF, it is used to configure the number
of the monitored user.
DSSKey->Memory
Key->Memory
KeyX->Value
The default value is blank.
SIP-T26P IP
phones)
memorykey.X.
pickup_value
It configures the pickup code for BLF
=
(X ranges
from 1 to 10)
(only
applicable to
SIP-T28P and
SIP-T26P IP
feature or conference ID followed by
String within
256
characters
the # sign for Meet-Me conference
DSSKey->Memory
feature.
Key->Memory
It only applies to BLF and Meet-Me
KeyX->Extension
conference features.
The default value is blank.
phones)
95
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
Web Setting Path
It configures the desired local
group/XML group/network group for
the memory key X.
It only applies to the Local Group, XML
Group and Network Group features.
When the key feature is configured as
Local Group, valid values are:
0-All contacts
1-First local group
2-Second local group
3-Third local group
memorykey.X.
4-Fourth local group
xml_phonebo
5-Fifth local group
ok =
When the key feature is configured as
(X ranges
from 1 to 10)
(only
Integer from
0 to 5
XML Group (remote phone book),
DSSKey->Memory
valid values are:
Key->Memory
0-First XML group
applicable to
SIP-T28P and
1-Second XML group
SIP-T26P IP
2-Third XML group
phones)
3-Fourth XML group
KeyX->Line
4-Fifth XML group
When the key feature is configured as
Network Group, valid values are:
0-All contacts
1-Group
2-Enterprise
3-GroupCommon
4-EnterpriseCommon
5-Personal
The default value is 0.
linekey.X.type
It configures the key feature for the line
=
key X.
(SIP-T28P: X
Valid values are:
ranges from 1
96
Integer
0-N/A (only applicable to SIP-T4X IP
to 6.
phones)
SIP-T26P/T22P:
1-Conference
DSSKey->Line
Key->Line
KeyX->Type
Appendix
Parameter
Permitted
Descriptions
Values
X ranges from
2-Forward
1 to 3.
3-Transfer
SIP-T21P/T20P:
4-Hold
X ranges from
1 to 2.
SIP-T48G: X
ranges from 1
to 29.
SIP-T46G: X
ranges from 1
5-DND
7-Call Return
8-SMS (not applicable to SIP-T20P,
SIP-T48G, SIP-T42G and SIP-T41P IP
phones)
9-Directed Pickup
to 27.
10-Call Park
SIP-T42G/T41P:
11-DTMF
X ranges from
12-Voice Mail
1 to 15.)
13-Speed Dial
(not
14-Intercom
applicable to
SIP-T19P IP
phones)
Web Setting Path
15-Line
16-BLF
17-URL (only applicable to SIP-T4X IP
phones)
18-Group Listening
20-Private Hold
22-XML Group (not applicable to
SIP-T20P IP phones)
23-Group Pickup
24-Multicast Paging
25-Record
27-XML Browser
34-Hot Desking
35-URL Record
38-LDAP (not applicable to SIP-T20P IP
phones)
39-BLF List
40-Prefix
41-Zero Touch
42-ACD (not applicable to
SIP-T48G/T46G)
45-Local Group
97
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
Web Setting Path
46-Network Group (not applicable to
SIP-T20P IP phones)
49-Custom Button (not applicable to
SIP-T4X IP phones)
50-Keypad Lock (not applicable to
SIP-T48G IP phones)
55-Meet-Me Conference
56-Retrieve Park
57-Hoteling
58-ACD Trace
59-Disp Code
60-Emergency
61-Directory
62-Network Favorite (only applicable
to SIP-T48G and SIP-T46G IP phones)
63-UC Favorite (only applicable to
SIP-T48G and SIP-T46G IP phones)
64-Buddies (only applicable to
SIP-T48G and SIP-T46G IP phones)
65-My Status (only applicable to
SIP-T48G and SIP-T46G IP phones)
For SIP- T2xP/T19P IP phones:
The default value is 15.
For SIP-T48G IP phones:
The default value of the line key 1-6 is
15, and the default value of the line
keys 7-29 is 0.
For SIP-T46G IP phones:
The default value of the line key 1-6 is
15, and the default value of the line
keys 7-27 is 0.
For SIP-T42G/T41P IP phones:
The default value of the line key 1-3 is
15, and the default value of the line
keys 4-15 is 0.
linekey.X.line
=
98
Integer from
1 to 6
It configures the desired line to apply
DSSKey->Line
the key feature.
Key->Line
Appendix
Parameter
Permitted
Descriptions
Values
(SIP-T28P: X
1-Line 1
ranges from 1
2-Line 2
to 6.
Web Setting Path
KeyX->Line
3-Line 3
SIP-T26P/T22P:
4-Line 4
X ranges from
5-Line 5
1 to 3.
6-Line 6
SIP-T21P/T20P:
X ranges from
When X=1, the default value is 1.
1 to 2.
When X=2, the default value is 2.
SIP-T48G: X
When X=3, the default value is 3.
ranges from 1
When X=4, the default value is 4.
to 29.
When X=5, the default value is 5.
SIP-T46G: X
When X=6, the default value is 6.
ranges from 1
Line 3 is only applicable to SIP-T28P,
to 27.
SIP-T26P, SIP-T22P and SIP-T4X IP phones.
SIP-T42G/T41P:
Lines 4-6 are only applicable to
X ranges from
SIP-T28P, SIP-T48G and SIP-T46G IP
1 to 15.)
phones.
(not
applicable to
SIP-T19P IP
phones)
linekey.X.valu
e=
(SIP-T28P: X
ranges from 1
to 6.
SIP-T26P/T22P:
It configures the value of the line key
X ranges from
1 to 3.
feature.
String within
SIP-T21P/T20P:
99
X ranges from
characters
1 to 2.
SIP-T48G: X
For example, when setting the key
feature to BLF, it configures the number
of the monitored user.
DSSKey->Line
Key->Line
KeyX->Value
The default value is blank.
ranges from 1
to 29.
SIP-T46G: X
ranges from 1
to 27.
99
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
Web Setting Path
SIP-T42G/T41P:
X ranges from
1 to 15.)
(not
applicable to
SIP-T19P IP
phones)
linekey.X.pick
up_value =
(SIP-T28P: X
ranges from 1
to 6.
SIP-T26P/T22P:
X ranges from
1 to 3.
SIP-T21P/T20P:
It configures the pickup code for BLF
X ranges from
1 to 2.
SIP-T48G: X
ranges from 1
to 29.
feature or conference ID followed by
String within
256
characters
the # sign for Meet-Me conference
DSSKey->Line
feature.
Key->Line
It only applies to BLF and Meet-Me
KeyX->Extension
conference features.
SIP-T46G: X
The default value is blank.
ranges from 1
to 27.
SIP-T42G/T41P:
X ranges from
1 to 15.)
(not
applicable to
SIP-T19P IP
phones)
linekey.X.xml_
It configures the desired local
phonebook =
group/XML group/network group for
(SIP-T28P: X
the line key X.
ranges from 1
to 6.
100
Integer from
0 to 48
It only applies to the Local Group, XML
Group and Network Group features.
SIP-T26P/T22P:
XML Group and Network Group
X ranges from
features are not applicable to SIP-T20P
1 to 3.
IP phones.
DSSKey->Line
Key->Line
KeyX->Line
Appendix
Parameter
Permitted
Descriptions
Values
SIP-T21P/T20P:
When the key feature is configured as
X ranges from
Local Group, valid values are:
1 to 2.
0-All contacts
SIP-T48G: X
1-First local group
ranges from 1
Web Setting Path
2-Second local group
to 29.
3-Third local group
SIP-T46G: X
4-Fourth local group
ranges from 1
to 27.
5-Fifth local group
SIP-T42G/T41P:
…
X ranges from
48-Forty-eighth local group
1 to 15.)
Local groups 6-48 are only applicable
(not
to SIP-T4X IP phones.
applicable to
When the key feature is configured as
SIP-T19P IP
XML Group (remote phone book),
phones)
valid values are:
0-First XML group
1-Second XML group
2-Third XML group
3-Fourth XML group
4-Fifth XML group
When the key feature is configured as
Network Group, valid values are:
0-All contacts
1-Group
2-Enterprise
3-GroupCommon
4-EnterpriseCommon
5-Personal
The default value is 0.
linekey.X.label
=
(SIP-T28P: X
ranges from 1
to 6.
String within
99
characters
It configures the label displayed on the
DSSKey->Line
LCD screen for each line key.
Key->Line
The default value is blank.
KeyX->Label
SIP-T26P/T22P:
X ranges from
101
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
Web Setting Path
1 to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T48G: X
ranges from 1
to 29.
SIP-T46G: X
ranges from 1
to 27.
SIP-T42G/T41P:
X ranges from
1 to 15.)
(not
applicable to
SIP-T19P IP
phones)
It configures the key feature for the
programmable key X.
programablek
Valid values are:
ey.X.type =
0-N/A
(SIP-T28/T26P:
2-Forward
X ranges from
1 to 14;
5-DND
SIP-T22P:
7-Call Return
X=1-10, 12-14;
8-SMS (not applicable to SIP-T20P,
SIP-T21P:
SIP-T41P, SIP-T42G and SIP-T48G IP
X=1-10, 14;
phones)
SIP-T20P:
Integer
9-Directed Pickup
X=5-12, 14;
13-Spead Dial
SIP-T19P:
22-XML Group (not applicable to
X=1-9, 13, 14.
SIP-T19P IP phones)
SIP-T48G/
23-Group Pickup
T46G: X=1-10,
27-XML Browser
12-14;
SIP-T42G/T41P:
X=1-10, 13.)
28-History
30-Menu
31-Switch Account (not applicable to
SIP-T19P and SIP-T4X IP phones)
102
DSSKey->
Programmable
Key->Type
Appendix
Parameter
Permitted
Descriptions
Values
Web Setting Path
32-New SMS (not applicable to
SIP-T20P, SIP-T41P, SIP-T42G and SIP-T48G
IP phones)
33-Status
34-Hot Desking (only applicable to
SIP-T19P, SIP-T48G and SIP-T46G IP
phones)
38-LDAP (not applicable to SIP-T19P
and SIP-T20P IP phones)
40-Prefix (not applicable to SIP-T20P IP
phones)
41-Zero Touch (not applicable to
SIP-T4X IP phones)
43-Local Directory
44-Network Directory
45-Local Group
46-Network Group
47-XML Directory (not applicable to
SIP-T20P IP phones)
50-Keypad Lock (not applicable to
SIP-T48G IP phones)
51-Switch Account Up (only applicable
to SIP-T4X IP phones)
52-Switch Account Down (only
applicable to SIP-T4X IP phones)
55-Meet-Me Conference
61-Directory
64-Buddies (only applicable to
SIP-T48G and SIP-T46G IP phones)
65-My Status (only applicable to
SIP-T48G and SIP-T46G IP phones)
It configures the desired line to apply
programablek
the programmable key feature.
ey.X.line =
(SIP-T28/T26P:
Integer from
1-Line 1
X ranges from
1 to 6
2-Line 2
1 to 14;
3-Line 3
SIP-T21P:
4-Line 4
DSSKey->
Programmable
Key->Line
103
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
X=1-10, 14;
5-Line 5
SIP-T20P:
6-Line 6
X=5-12, 14;
Line 3 is only applicable to SIP-T28P,
SIP-T19P:
SIP-T26P, SIP-T22P and SIP-T4X IP phones.
X=1-9, 13, 14.
Lines 4-6 are only applicable to
SIP-T48G/
SIP-T28P, SIP-T48G and SIP-T46G IP
T46G: X=1-10,
phones.
12-14;
The default value is 1.
Web Setting Path
SIP-T42G /T41P:
X=1-10, 13.)
programablek
ey.X.value =
(SIP-T28/T26P:
X ranges from
1 to 14;
SIP-T22P:
X=1-10, 12-14;
SIP-T21P:
X=1-10, 14;
SIP-T20P:
X=5-12, 14;
It configures the value of the
programmable key feature.
String within
99
characters
For example, when configuring the key
feature to be Speed Dial, it is used to
configure the number.
DSSKey->
Programmable
Key->Value
The default value is blank.
SIP-T19P:
X=1-9, 13, 14.
SIP-T48G/
T46G: X=1-10,
12-14;
SIP-T42G /T41P:
X=1-10, 13.)
programablek
It configures the desired local
ey.X.xml_phon
group/XML group/network group for
ebook =
the programmable key.
(SIP-T28/T26P:
It only applies to the Local Group, XML
X ranges from
1 to 14;
104
Integer from
0 to 48
Group and Network Group features.
XML Group and Network Group
SIP-T22P:
features are not applicable to SIP-T20P
X=1-10, 12-14;
IP phones.
SIP-T21P:
When the key feature is configured as
X=1-10, 14;
Local Group, valid values are:
DSSKey->
Programmable
Key->Line
Appendix
Parameter
Permitted
Descriptions
Values
SIP-T20P:
0-All contacts
X=5-12, 14;
1-First local group
SIP-T19P:
2-Second local group
X=1-9, 13, 14.
Web Setting Path
3-Third local group
SIP-T48G/
4-Fourth local group
T46G: X=1-10,
5-Fifth local group
12-14;
…
SIP-T42G/T41P:
48-Forty-eighth local group
X=1-10, 13.)
Local groups 6-48 are only applicable
to SIP-T4X IP phones.
When the key feature is configured as
XML Group (remote phone book),
valid values are:
0-First XML group
1-Second XML group
2-Third XML group
3-Fourth XML group
4-Fifth XML group
When the key feature is configured as
Network Group, valid values are:
0-All contacts
1-Group
2-Enterprise
3-GroupCommon
4-EnterpriseCommon
5-Personal
The default value is 0.
programablek
ey.X.history_ty
It configures the history type of
pe =
programmable key.
(SIP-T28/T26P:
DSSKey->
0-Local History
Programmable
1 to 14;
1-Network History
Key->Line
SIP-T22P:
The default value is 0.
X ranges from
Integer
X=1-10, 12-14;
SIP-T21P:
105
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
Web Setting Path
X=1-10, 14;
SIP-T19P:
X=1-9, 13, 14.
SIP-T48G/
T46G: X=1-10,
12-14;
SIP-T42G /T41P:
X=1-10, 13.)
(not
applicable to
SIP-T20P IP
phones)
programablek
ey.X.label =
(X ranges
from 1 to 4)
(not
String within
99
characters
applicable to
It configures the label displayed on the
DSSKey->
LCD screen for each soft key.
Programmable
The default value is blank.
Key->Label
SIP-T20P IP
phones)
programablek
ey.X.pickup_v
alue =
(SIP-T28/T26P:
X ranges from
1 to 14;
SIP-T22P:
X=1-10, 12-14;
SIP-T21P:
X=1-10, 14;
String within
256
characters
the # sign for Meet-Me conference
feature.
It only applies to Meet-Me conference
SIP-T20P:
feature.
X=5-12, 14;
The default value is blank.
SIP-T19P:
X=1-9, 13, 14.
SIP-T48G/
T46G: X=1-10,
12-14;
SIP-T42G /T41P:
106
It configures conference ID followed by
DSSKey->Program
mable
Key->Extension
Appendix
Parameter
Permitted
Descriptions
Values
Web Setting Path
X=1-10, 13.)
It configures the key feature of the
expansion module X key Y.
Valid values are:
0-NA
1-Conference
2-Forward
3-Transfer
4-Hold
5-DND
expansion_mo
7-Call Return
dule.X.key.Y.ty
8-SMS (not applicable to SIP-T48G IP
pe =
phones)
(SIP-T28P/T48G
9-Directed Pickup
/T46G: X
ranges from 1
10-Call Park
to 6.
11-DTMF
SIP-T26P: X
12-Voice Mail
ranges from 1
to 3.
Y ranges from
1 to 40)
(only
applicable to
Integer
13-Speed Dial
DSSKey->Ext
14-Intercom
Key->Type
15-Line
16-BLF
17-URL
SIP-T28P,
18-Group Listening
SIP-T26P,
20-Private Hold
SIP-T48G and
22-XML Group
SIP-T46G IP
phones)
23-Group Pickup
24-Multicast Paging
25-Record
27-XML Browser
34-Hot Desking
35-URL Record
37-Switch (not applicable to
SIP-T48G/T46G IP phones)
38-LDAP
39-BLF List
107
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
Web Setting Path
40-Prefix
41-Zero Touch
42-ACD (not applicable to
SIP-T48G/T46G)
45-Local Group
46-Network Group
49-Custom Button
50-Keypad Lock (not applicable to
SIP-T48G IP phones)
55-Meet-Me Conference
56-Retrieve Park
57-Hoteling
58-ACD Grace
59-Disp Code
60-Emergency
61-Directory
62-Network Favorite (only applicable
to SIP-T48G and SIP-T46G IP phones)
63-UC Favorite (only applicable to
SIP-T46G IP phones)
64-Buddies (only applicable to
SIP-T48G and SIP-T46G IP phones)
65-My Status (only applicable to
SIP-T48G and SIP-T46G IP phones)
For SIP-T28P/T26P IP phones:
The default value of the expansion
keys 2-20, 22-40 is 0, and the default
value of the expansion keys 1, 21 is 37.
For SIP-T48G/T46G IP phones:
The default value is 0.
expansion_mo
It configures the desired line to apply
dule.X.key.Y.lin
the expansion module key feature.
e=
(SIP-T28P/T48G
/T46G: X
ranges from 1
to 6.
108
Integer from
1-Line 1
DSSKey->Ext
1 to 6
2-Line 2
Key->Line
3-Line 3
4-Line 4
Appendix
Parameter
Permitted
Descriptions
Values
SIP-T26P: X
5-Line 5
ranges from 1
6-Line 6
to 3.
Web Setting Path
Lines 4-6 are only applicable to
Y ranges from
SIP-T28P, SIP-T48G and SIP-T46G IP
1 to 40)
phones.
(only
The default value is 1.
applicable to
SIP-T28P,
SIP-T26P,
SIP-T48G and
SIP-T46G IP
phones)
expansion_mo
dule.X.key.Y.v
alue =
(SIP-T28P/T48G
/T46G: X
ranges from 1
to 6.
SIP-T26P: X
ranges from 1
to 3.
Y ranges from
String within
99
characters
It configures the value of the
expansion module key feature.
The default value is blank.
DSSKey->Ext
Key->Value
1 to 40)
(only
applicable to
SIP-T28P,
SIP-T26P,
SIP-T48G and
SIP-T46G IP
phones)
expansion_mo
It configures the pickup code for BLF
dule.X.key.Y.pi
ckup_value =
(SIP-T28P/T48G
/T46G: X
ranges from 1
to 6.
SIP-T26P: X
feature or conference ID followed by
String within
255
characters
the # sign for Meet-Me conference
feature.
It only applies to BLF and Meet-Me
DSSKey->Ext
Key->Extension
conference features.
The default value is blank.
109
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
Web Setting Path
ranges from 1
to 3.
Y ranges from
1 to 40)
(only
applicable to
SIP-T28P,
SIP-T26P,
SIP-T48G and
SIP-T46G IP
phones)
expansion_mo
dule.X.key.Y.la
bel =
(SIP-T28P/T48G
/T46G: X
ranges from 1
to 6.
SIP-T26P: X
ranges from 1
to 3.
Y ranges from
String within
99
characters
1 to 40)
It configures the label displayed on the
LCD screen of the expansion module
DSSKey->Ext
for each key.
Key->Label
The default value is blank.
(only
applicable to
SIP-T28P,
SIP-T26P,
SIP-T48G 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.
ml_phoneboo
k=
(SIP-T28P/T48G
/T46G: X
ranges from 1
to 6.
SIP-T26P: X
110
When the key feature is configured as
Integer from
0 to 48
Local Group, valid values are:
0-All contacts
1-First local group
2-Second local group
3-Third local group
DSSKey->Ext
Key->Ext
KeyX->Line
Appendix
Parameter
Permitted
Descriptions
Values
ranges from 1
4-Fourth local group
to 3.
5-Fifth local group
Y ranges from
…
1 to 40)
Web Setting Path
48-Forty-eighth local group
(only
Local groups 6-48 are only applicable
applicable to
to SIP-T48G/T46G IP phones.
SIP-T28P,
When the key feature is configured as
SIP-T26P,
XML Group (remote phone book),
SIP-T48G and
valid values are:
SIP-T46G IP
0-First XML group
phones)
1-Second XML group
2-Third XML group
3-Fourth XML group
4-Fifth XML group
When the key feature is configured as
Network Group, valid values are:
0-All contacts
1-Group
2-Enterprise
3-GroupCommon
4-EnterpriseCommon
5-Personal
The default value is 0.
phone_setting
It enables or disables the phone to
.page_tip =
display page icons on LCD screen and
(only
flash page switch key LED to indicate
applicable to
different states of line keys.
SIP-T46G,
0 or 1
0-Disabled
SIP-T42G and
Tips
The default value is 0.
phones)
phone_setting
Resource:X
.backgrounds
(Valid values
(only
key->Enable Page
1-Enabled
SIP-T41P IP
=
DSSKey->Line
of X are:
Default.jpg,
It configures the wallpaper displayed
on the phone.
Example:
To configure a phone built-in picture
applicable to
1.png,
(e.g., 1.png) to be wallpaper, the
SIP-T48G and
2.png,
value format is:
Settings->
Preference->
Wallpaper
111
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
SIP-T46G IP
3.png,
phone_setting.backgrounds =
phones)
4.png,
Resource:1.png
5.png,
To configure a custom picture (e.g.,
6.png,
custom1.png) to be wallpaper, the
7.png,
value format is: Config:custom1.png
8.png or
The default value is
9.png) or
Resource:Default.jpg.
Web Setting Path
Config:wallp
aper name
wallpaper_upl
oad.url =
(only
URL within
It configures the access URL of the
Settings->
Preference->Uploa
d Wallpaper
applicable to
511
custom wallpaper image.
SIP-T48G and
characters
The default value is blank.
SIP-T46G IP
phones)
It enables or disables always forward
feature.
forward.alwa
ys.enable =
0 or 1
Features->Forwar
0-Disabled
d &DND->Always
1-Enabled
Forward->On/Off
The default value is 0.
forward.alwa
ys.target =
forward.alwa
ys.on_code =
forward.alwa
ys.off_code =
String within
32
characters
String within
32
characters
String within
32
characters
It configures the target number the
Features->Forwar
phone forwards all incoming calls to.
d &DND->Always
The default value is blank.
Forward->Target
It configures the always forward on
code.
The default value is blank.
It configures the always forward off
code.
The default value is blank.
Features->Forwar
d &DND->Always
Forward->On
Code
Features->Forwar
d &DND->Always
Forward->Off
Code
It enables or disables busy forward
feature.
forward.busy.
enable =
0 or 1
0-Disabled
d &DND->Busy
1-Enabled
Forward->On/Off
The default value is 0.
112
Features->Forwar
Appendix
Parameter
forward.busy.t
arget =
forward.busy.
on_code =
forward.busy.
off_code =
Permitted
Descriptions
Values
String within
32
characters
String within
32
characters
String within
32
characters
It configures the target number the
phone forwards incoming calls to
when busy.
The default value is blank.
Web Setting Path
Features->Forwar
d &DND->Busy
Forward->Target
Features->Forwar
It configures the busy forward on code.
d &DND->Busy
The default value is blank.
Forward->On
Code
Features->Forwar
It configures the busy forward off code.
d &DND->Busy
The default value is blank.
Forward->Off
Code
It enables or disables no answer
forward feature.
forward.no_a
nswer.enable
0 or 1
=
0-Disabled
1-Enabled
Features->Forwar
d &DND->No
Answer
Forward->On/Off
The default value is 0.
forward.no_a
String within
nswer.target
32
=
forward.no_a
nswer.timeout
=
characters
Integer from
0 to 20
It configures the target number the
Features->Forwar
phone forwards incoming calls to after
d &DND->No
a period of ring time.
Answer
The default value is blank.
Forward->Target
It configures ring times (N) to wait
Features->Forwar
before forwarding incoming calls.
d &DND->No
Incoming calls are forwarded when
Answer
not answered after N*6 seconds.
Forward->After
The default value is 2.
Ring Time (0~120s)
Features->Forwar
forward.no_a
String within
nswer.on_cod
32
e=
characters
It configures the no answer forward on
d &DND->No
code.
Answer
The default value is blank.
Forward->On
Code
Features->Forwar
forward.no_a
nswer.off_cod
e=
String within
32
characters
It configures the no answer forward off
d &DND->No
code.
Answer
The default value is blank.
Forward->Off
Code
forward.intern
0 or 1
It enables or disables the phone to
Features->General
113
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Web Setting Path
ational.enable
forward incoming calls to international
Information->Fwd
=
numbers.
International
Values
0-Disabled
1-Enabled
The default value is 1.
acd.auto_avai
It enables or disables the phone to
lable =
automatically change the status of the
(not
applicable to
ACD agent to available.
0 or 1
0-Disabled
SIP-T48G/T46G
1-Enabled
)
The default value is 0.
Features->ACD->
ACD Auto
Available
acd.auto_avai
lable_timer =
(not
applicable to
Integer from
0 to 120
SIP-T48G/T46G
It configures the interval (in seconds)
Features->ACD->
to automatically change the status of
ACD Auto
the ACD agent to available.
Available Timer
The default value is 60.
(0~120s)
)
It configures the action URL the phone
sends after startup.
The value format is: http(s)://IP address
of server/help.xml? variable
name=variable value.
Valid variable values are:
action_url.setu
p_completed
=

$mac

$ip

$model
511

$firmware
characters

$active_url

$active_user

$active_host

$local

$remote

$display_local

$display_remote

$call_id
URL within
Example:
114
Features->Action
URL->Setup
Completed
Appendix
Parameter
Permitted
Descriptions
Values
Web Setting Path
action_url. setup_completed =
http://192.168.0.20/help.xml?IP=$ip
The default value is blank.
It configures the action URL the phone
sends after account is registered.
Example:
action_url.regi
stered =
URL within
511
characters
action_url.registered =
http://192.168.0.20/help.xml?IP=$ip
The default value is blank.
Features->Action
URL->Registered
Note: The old parameter
“action_url.log_on” is also applicable
to IP phones.
It configures the action URL the phone
sends after account is unregistered.
Example:
action_url.unr
egistered =
URL within
511
characters
action_url.unregistered =
http://192.168.0.20/help.xml?IP=$ip
The default value is blank.
Features->Action
URL->Unregistered
Note: The old parameter
“action_url.log_off” is also applicable
to IP phones.
It configures the action URL the phone
sends after register failed.
action_url.regi
ster_failed =
URL within
511
characters
Example:
action_url.register_failed =
http://192.168.0.20/help.xml?IP=$ip
Features->Action
URL->Register
Failed
The default value is blank.
It configures the action URL the phone
sends when off hook.
action_url.off_
hook =
URL within
511
characters
Example:
Features->Action
action_url.off_hook =
URL->Off Hook
http://192.168.0.20/help.xml?IP=$ip
The default value is blank.
action_url.on_
hook =
URL within
511
characters
It configures the action URL the phone
sends when on hook.
Example:
Features->Action
URL->On Hook
115
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
Web Setting Path
action_url.on_hook =
http://192.168.0.20/help.xml?IP=$ip
The default value is blank.
It configures the action URL the phone
sends when receiving an incoming
action_url.inco
ming_call =
URL within
511
characters
call.
Features->Action
Example:
URL->Incoming
action_url.incoming_call =
Call
http://192.168.0.20/help.xml?IP=$ip
The default value is blank.
It configures the action URL the phone
sends when placing a call.
action_url.out
going_call =
URL within
511
characters
Example:
action_url.outgoing_call =
http://192.168.0.20/help.xml?IP=$ip
Features->Action
URL->Outgoing
Call
The default value is blank.
It configures the action URL the phone
sends when establishing a call.
action_url.call
URL within
_established
511
=
characters
Example:
Features->Action
action_url.call_established =
URL->Established
http://192.168.0.20/help.xml?IP=$ip
The default value is blank.
It configures the action URL the phone
sends when terminating a call.
action_url.call
_terminated =
URL within
511
characters
Example:
Features->Action
action_url.call_terminated =
URL->Terminated
http://192.168.0.20/help.xml?IP=$ip
The default value is blank.
It configures the action URL the phone
sends when DND feature is enabled.
action_url.dnd
_on =
URL within
511
characters
Example:
Features->Action
action_url.dnd_on =
URL->Open DND
http://192.168.0.20/help.xml?IP=$ip
The default value is blank.
action_url.dnd
_off =
116
URL within
It configures the action URL the phone
Features->Action
511
sends when DND feature is disabled.
URL->Close DND
Appendix
Parameter
Permitted
Descriptions
Values
characters
Web Setting Path
Example:
action_url.dnd_off =
http://192.168.0.20/help.xml?IP=$ip
The default value is blank.
It configures the action URL the phone
sends when always forward feature is
action_url.alw
ays_fwd_on =
URL within
511
characters
enabled.
Features->Action
Example:
URL->Open
action_url.always_fwd_on =
Always Forward
http://192.168.0.20/help.xml?IP=$ip
The default value is blank.
It configures the action URL the phone
sends when always forward feature is
action_url.alw
ays_fwd_off =
URL within
511
characters
disabled.
Features->Action
Example:
URL->Close
action_url.always_fwd_off =
Always Forward
http://192.168.0.20/help.xml?IP=$ip
The default value is blank.
It configures the action URL the phone
sends when busy forward feature is
action_url.bus
y_fwd_on =
URL within
511
characters
enabled.
Features->Action
Example:
URL->Open Busy
action_url.busy_fwd_on =
Forward
http://192.168.0.20/help.xml?IP=$ip
The default value is blank.
It configures the action URL the phone
sends when busy forward feature is
action_url.bus
y_fwd_off =
URL within
511
characters
disabled.
Features->Action
Example:
URL->Close Busy
action_url.busy_fwd_off =
Forward
http://192.168.0.20/help.xml?IP=$ip
The default value is blank.
action_url.no_
URL within
answer_fwd_o
511
n=
characters
It configures the action URL the phone
sends when no answer forward
feature is enabled.
Example:
Features->Action
URL->Open No
Answer Forward
117
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
Web Setting Path
action_url.no_answer_fwd_on =
http://192.168.0.20/help.xml?IP=$ip
The default value is blank.
It configures the action URL the phone
sends when no answer forward
action_url.no_
answer_fwd_o
ff =
URL within
511
characters
feature is disabled.
Features->Action
Example:
URL->Close No
action_url.no_answer_fwd_off =
Answer Forward
http://192.168.0.20/help.xml?IP=$ip
The default value is blank.
It configures the action URL the phone
sends when performing a transfer.
action_url.tran
sfer_call =
URL within
511
characters
Example:
Features->Action
action_url.transfer_call =
URL->Transfer Call
http://192.168.0.20/help.xml?IP=$ip
The default value is blank.
It configures the action URL the phone
sends when performing a blind
action_url.blin
d_transfer_call
=
URL within
511
characters
transfer.
Features->Action
Example:
URL->Blind
action_url.blind_transfer_call =
Transfer
http://192.168.0.20/help.xml?IP=$ip
The default value is blank.
It configures the action URL the phone
sends when performing an attended
action_url.atte
nded_transfer
_call =
URL within
511
characters
or a semi-attended transfer.
Features->Action
Example:
URL->Attended
action_url.attended_transfer_call =
Transfer
http://192.168.0.20/help.xml?IP=$ip
The default value is blank.
It configures the action URL the phone
sends when placing a call on hold.
action_url.hol
d=
URL within
511
characters
Example:
Features->Action
action_url.hold =
URL->Hold
http://192.168.0.20/help.xml?IP=$ip
The default value is blank.
118
Appendix
Parameter
Permitted
Descriptions
Values
Web Setting Path
It configures the action URL the phone
sends when resuming a held call.
action_url.unh
old =
URL within
511
characters
Example:
Features->Action
action_url.unhold =
URL->UnHold
http://192.168.0.20/help.xml?IP=$ip
The default value is blank.
It configures the action URL the phone
sends when muting a call.
action_url.mut
e=
URL within
511
characters
Example:
Features->Action
action_url.mute =
URL->Mute
http://192.168.0.20/help.xml?IP=$ip
The default value is blank.
It configures the action URL the phone
sends when un-muting a call.
action_url.unm
ute =
URL within
511
characters
Example:
Features->Action
action_url.unmute =
URL->UnMute
http://192.168.0.20/help.xml?IP=$ip
The default value is blank.
It configures the action URL the phone
sends when missing a call.
action_url.miss
ed_call =
URL within
511
characters
Example:
Features->Action
action_url.missed_call =
URL->Missed Call
http://192.168.0.20/help.xml?IP=$ip
The default value is blank.
It configures the action URL the phone
sends when changing the state of the
action_url.bus
y_to_idle =
URL within
511
characters
phone from busy to idle.
Example:
action_url.busy_to_idle =
Features->Action
URL->Busy To Idle
http://192.168.0.20/help.xml?IP=$ip
The default value is blank.
It configures the action URL the phone
action_url.idle
_to_busy =
URL within
511
characters
sends when changing the state of the
phone from idle to busy.
Example:
Features->Action
URL->Idle To Busy
action_url.idle_to_busy =
119
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
Web Setting Path
http://192.168.0.20/help.xml?IP=$ip
The default value is blank.
It configures the action URL the phone
sends when changing the IP address
action_url.ip_c
hange =
URL within
511
characters
of the phone.
Example:
action_url.ip_change =
Features->Action
URL->IP Changed
http://192.168.0.20/help.xml?IP=$ip
The default value is blank.
It configures the action URL the phone
sends when forwarding an incoming
action_url.for
URL within
ward_incomin
511
g_call =
characters
call.
Features->Action
Example:
URL->Forward
action_url.forward_incoming_call =
Incoming Call
http://192.168.0.20/help.xml?IP=$ip
The default value is blank.
It configures the action URL the phone
sends when rejecting an incoming call.
action_url.reje
URL within
ct_incoming_c
511
all =
characters
Example:
action_url.reject_incoming_call =
http://192.168.0.20/help.xml?IP=$ip
Features->Action
URL->Reject
Incoming Call
The default value is blank.
It configures the action URL the phone
sends when answering a new
action_url.ans
URL within
wer_new_inco
511
ming_call =
characters
incoming call.
Features->Action
Example:
URL->Answer
action_url.answer_new_incoming_call
New-In Call
= http://192.168.0.20/help.xml?IP=$ip
The default value is blank.
It configures the action URL the phone
sends when completing a call transfer.
action_url.tran
sfer_finished
=
URL within
511
characters
Example:
action_url.transfer_finished =
http://192.168.0.20/help.xml?IP=$ip
The default value is blank.
120
Features->Action
URL->Transfer
Finished
Appendix
Parameter
Permitted
Descriptions
Values
Web Setting Path
It configures the action URL the phone
sends when failing to transfer a call.
action_url.tran
sfer_failed =
URL within
511
characters
Example:
action_url.transfer_failed =
http://192.168.0.20/help.xml?IP=$ip
Features->Action
URL->Transfer
Failed
The default value is blank.
It configures the language of the web
English,
Chinese_S,
Chinese_T,
German,
lang.wui =
French,
Italian,
Spanish,
Turkish or
Portuguese
user interface.
Chinese_S is only applicable to
SIP-T21P, SIP-T19P, SIP-T48G and SIP-T46G
IP phones.
Settings->Preferen
Chinese_T is only applicable to
ce->Language
SIP-T48G and SIP-T46G IP phones.
French, Portuguese and Spanish are
not applicable to SIP-T21P and SIP-T19P
IP phones.
English,
Chinese_S,
Chinese_T,
German,
lang.gui =
It configures the language of the
phone user interface.
French,
Chinese_S and Chinese_T are only
Turkish,
applicable to SIP-T21P, SIP-T19P,
Italian,
SIP-T48G and SIP-T46G IP phones.
Polish,
The default value is English.
Spanish or
Portuguese
It configures the time zone.
local_time.tim
e_zone =
-11 to +13
For more available time zones, refer to
Settings->Time &
Time Zones on page 225.
Date->Time Zone
The default value is +8.
It configures the time zone name.
local_time.tim
String within
e_zone_name
32
=
characters
For more available time zone names,
refer to Time Zones on page 225.
Settings->Time &
Date->Time Zone
The default time zone name is
China(Beijing).
local_time.ma
nual_time_en
0 or 1
It configures the phone to obtain time
Settings->Time &
from NTP server or manual settings.
Date->Manual
121
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
able =
0-Manual
Web Setting Path
Time
1-NTP
The default value is 1.
It enables or disables the phone to use
manually configured NTP server
preferentially.
local_time.ma
nual_ntp_srv_
0 or 1
prior =
Settings->Time &
0-Disabled (use the NTP server
Date->NTP By
obtained by DHCP preferentially)
DHCP Priority
1-Enabled
The default value is 0.
local_time.ntp
_server1 =
local_time.ntp
_server2 =
IP address
It configures the IP address or domain
Settings->Time &
or domain
name of the NTP server 1.
Date->Primary
The default value is cn.pool.ntp.org.
Server
IP address
It configures the IP address or domain
Settings->Time &
or domain
name of the NTP server 2.
Date->Secondary
The default value is cn.pool.ntp.org.
Server
It configures the update interval (in
Settings->Time &
seconds) when using the NTP server.
Date->Synchronis
The default value is 1000.
m (15~86400s)
name
name
local_time.inte
Integer from
rval =
15 to 86400
It enables or disables daylight saving
time (DST) feature.
local_time.su
mmer_time =
0-Disabled
0, 1 or 2
1-Enabled
2-Automatic
Settings->Time &
Date-> Daylight
Saving Time
The default value is 2.
It configures the way DST works when
DST feature is enabled.
local_time.dst
_time_type =
0 or 1
0-DST By Date
1-DST By Week
Settings->Time &
Date->Fixed Type
The default value is 0.
local_time.star
t_time =
122
Time
It configures the start time of the DST.
For DST By Date:
Value formats are:
Settings->Time &

Month/Day/Hour (for By Date)
Date->Start Date

Month/ Day of Week/ Day of
For DST By Week:
Week Last in Month/ Hour of Day
Settings->Time &
Appendix
Parameter
Permitted
Descriptions
Values
(for By Week)
The default value is 1/1/0.
Web Setting Path
Date->DST Start
Month/DST Start
Day of Week/DST
Start Day of Week
Last in Month/ Start
Hour of Day
For DST By Date:
It configures the end time of the DST.
Value formats are:
local_time.en
d_time =
Time
Settings->Time &
Date-> End Date
For DST By Week:

Month/Day/Hour (for By Date)

Month/ Day of Week/ Day of
Date->DST Stop
Week Last in Month/ Hour of Day
Month/DST Stop
(for By Week)
Day of Week/DST
The default value is 12/31/23.
Settings ->Time &
Stop Day of Week
Last in Month/Stop
Hour of Day
It enables or disables the phone to
update time with the offset time
obtained from the DHCP server.
local_time.dhc
p_time =
0 or 1
It is only available to offset from GMT
Settings->Time &
0.
Date->DHCP Time
0-Disabled
1-Enabled
The default value is 0.
local_time.offs
et_time =
Integer from
-300 to 300
It configures the offset time (in
Settings->Time &
minutes).
Date->Offset
The default value is blank.
(minutes)
It configures the time format.
local_time.tim
e_format =
0 or 1
0-12 Hour
1-24 Hour
Settings->Time &
Date->Time
Format
The default value is 1.
0, 1, 2, 3, 4, 5
local_time.dat
e_format =
It configures the date format.
For
Settings->Time &
SIP-T19P/T21P
SIP-T19P/SIP-T21P/T22P/T26P/T28P/T4X IP
Date->Date
/T22P/T26P/T
phones:
Format
or 6 (for
28P/T4X)
0-WWW MMM DD
123
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
7, 8 or 9
1-DD-MMM-YY
(for SIP-T20P)
2-YYYY-MM-DD
3-DD/MM/YYYY
4-MM/DD/YY
5-DD MMM YYYY
6-WWW DD MMM
The default value is 0.
For SIP-T20P IP phones:
7-MM DD YY
8-DD MM YY
9-YY MM DD
The default value is 7.
“WWW” represents the abbreviation of
the week, “DD” represents a two-digit
day, “MMM” represents the first three
letters of the month, “YYYY” represents
a four-digit year, and “YY” represents
a two-digit year which is not displayed
on the LCD screen of SIP-T20P IP
phones.
It enables or disables the phone to
provide input field of register name on
hotdesking.st
artup_register
_name_enabl
the hot desking login wizard during
0 or 1
startup.
0-Disabled
e=
1-Enabled
The default value is 0.
It enables or disables the phone to
provide input field of user name on the
hot desking login wizard during
hotdesking.st
artup_userna
0 or 1
startup.
0-Disabled
me_enable =
1-Enabled
The default value is 1.
hotdesking.st
artup_passwo
rd_enable =
124
It enables or disables the phone to
0 or 1
provide input field of password on the
hot desking login wizard during
Web Setting Path
Appendix
Parameter
Permitted
Descriptions
Values
Web Setting Path
startup.
0-Disabled
1-Enabled
The default value is 1.
It enables or disables the phone to
provide input field of SIP server on the
hot desking login wizard during
hotdesking.st
artup_sip_serv
0 or 1
startup.
0-Disabled
er_enable =
1-Enabled
The default value is 0.
It enables or disables the phone to
provide input field of outbound server
on the hot desking login wizard during
hotdesking.st
artup_outboun
0 or 1
startup.
0-Disabled
d_enable =
1-Enabled
The default value is 0.
It enables or disables the phone to
provide input field of register name on
hotdesking.ds
skey_register_
name_enable
the hot desking login wizard when
0 or 1
pressing the Hot Desking key.
0-Disabled
=
1-Enabled
The default value is 0.
It enables or disables the phone to
provide input field of user name on the
hot desking login wizard when
hotdesking.ds
skey_usernam
0 or 1
pressing the Hot Desking key.
0-Disabled
e_enable =
1-Enabled
The default value is 1.
It enables or disables the phone to
hotdesking.ds
skey_passwor
d_enable =
0 or 1
provide input field of password on the
hot desking login wizard when
pressing the Hot Desking key.
125
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
Web Setting Path
0-Disabled
1-Enabled
The default value is 1.
It enables or disables the phone to
provide input field of SIP server on the
hot desking login wizard when
hotdesking.ds
skey_sip_serv
0 or 1
pressing the Hot Desking key.
0-Disabled
er_enable =
1-Enabled
The default value is 0.
It enables or disables the phone to
provide input field of outbound server
on the hot desking login wizard when
hotdesking.ds
skey_outboun
0 or 1
pressing the Hot Desking key.
0-Disabled
d_enable =
1-Enabled
The default value is 0.
It configures the internal ringer text to
the info texts contained in the
distinctive_rin
g_tones.alert_i
nfo.X.text =
(X ranges
String within
32
characters
Alert-Info header.
Example:
distinctive_ring_tones.alert_info.1.text
Settings->Ring->
Internal Ringer Text
= Family
from 1 to 10)
The default value is blank.
It configures the desired ring tones for
each text.
distinctive_rin
g_tones.alert_i
nfo.X.ringer =
(X ranges
Integer from
1 to 8
from 1 to 10)
The value ranges from 1 to 8, the digit
Settings->Ring
stands for the appropriate ring tone.
->Internal Ringer
Ring tones 6-8 are only applicable to
File
SIP-T46G and SIP-T48G IP phones.
The default value is 1.
It enables or disables the phone to
auto_redial.en
able =
0 or 1
automatically redial the called number
Features->General
when the called party is temporarily
Information->Auto
unavailable.
Redial
0-Disabled
126
Appendix
Parameter
Permitted
Descriptions
Values
Web Setting Path
1-Enabled
The default value is 0.
auto_redial.int
erval =
auto_redial.ti
mes =
Integer from
1 to 300
Integer from
1 to 300
It configures the interval (in seconds)
for the phone to wait before redial.
The default value is 10.
Features->General
Information->Auto
Redial Interval
(1~300s)
It configures the auto redial times
Features->General
when the called party is temporarily
Information->Auto
unavailable.
Redial Times
The default value is 10.
(1~300)
It enables or disables zero touch for
the phone to perform provisioning
zero_touch.en
able =
during startup.
0 or 1
0-Disabled
1-Enabled
Settings->Auto
Provision->Zero
Active
The default value is 0.
It configures the duration time (in
zero_touch.wa
it_time =
Integer from
1 to 100
seconds) of the phone displaying the
Settings->Auto
zero-sp-touch configuration screen
Provision->Wait
when powered on.
Time (1~100s)
The default value is 5.
push_xml.serv
er =
IP address
It configures the IP address of the push
Features->Remote
XML server.
Control->Push XML
The default value is blank.
Server IP Address
It enables or disables the phone to
block displaying the push XML screen
push_xml.bloc
k_in_calling =
when in calling status.
0 or 1
0-Disabled
1-Enabled
Features->Remote
Control->Block
XML In Calling
The default value is 0.
It enables or disables the phone to use
the push XML via SIP NOTIFY message.
push_xml.sip_
notify =
0 or 1
0-Disabled
1-Enabled
Features->Remote
Control->SIP Notify
The default value is 0.
127
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
Web Setting Path
It configures the IP address of server
from which the phone receives the
action URI requests.
features.actio
n_uri_limit_ip
=
Multiple IP addresses are separated
IP address
or any
by commas.
If it is set to any, the phone will receive
action URI requests from any server.
Features->Remote
Control->Action
URI allow IP List
If it is left blank, the phone will not
receive action URI requests.
The default value is blank.
dialplan.area
_code.code =
dialplan.area
_code.min_len
=
String within
16
characters
Integer from
1 to 15
It configures the area code.
The default value is blank.
It configures the minimum length of the
number prefixed with the area code.
The default value is 1.
Settings->Dial
Plan->Area
Code->Code
Settings->Dial
Plan->Area
Code->Min Length
(1-15)
It configures the maximum length of
dialplan.area
_code.max_le
n=
Integer from
1 to 15
the number prefixed with the area
Settings->Dial
code.
Plan->Area
The value must be larger than the
Code->Max
minimum length.
Length (1-15)
The default value is 15.
It configures lines applying the area
code.
dialplan.area
0 to 6 (for SIP-T28P/T48G/T46G)
_code.line_id
0 to 3 (for SIP-T26P/T22P/T42G/T41P)
=
(not
Integer
0 to 2 (for SIP-T21P/T20P)
Multiple line IDs are separated by
applicable to
commas. 0 stands for all lines.
SIP-T19P IP
Settings->Dial
Plan->Area
Code->Account
If it is left blank, the area code rule will
phones)
apply to all accounts on the phone.
The default value is blank.
dialplan.block
_out.number.X
=
(X ranges
128
String within
32
characters
Settings->Dial
It configures the block out string.
Plan->Block
The default value is blank.
Out->BlockOut
NumberX
Appendix
Parameter
Permitted
Descriptions
Values
Web Setting Path
from 1 to 10)
It configures lines applying the block
dialplan.block
out rule.
_out.line_id.X
0 to 6 (for SIP-T28P/T48G/T46G)
=
0 to 3 (for SIP-T26P/T22P/T42G/T41P)
(X ranges
from 1 to 10)
Integer
0 to 2 (for SIP-T28P/T48G/T46G)
Multiple line IDs are separated by
(not
commas. 0 stands for all lines.
applicable to
Settings->Dial
Plan->Block
Out->Account
If it is left blank, the block out rule will
SIP-T19P IP
apply to all accounts on the phone.
phones)
The default value is blank.
dialplan.dialn
ow.rule.X =
(X ranges
from 1 to 100)
String within
511
characters
It configures the dial now rule.
The default value is blank.
Settings->Dial
Plan->Dial-now->
Rule
It configures lines applying the
dial-now rule.
dialplan.dialn
ow.line_id.X =
0 to 6 (for SIP-T28P/T48G/T46G)
(X ranges
0 to 3 (for SIP-T26P/T22P/T42G/T41P)
from 1 to 100)
0 to 2 (for SIP-T21P/T20P)
Integer
(not
Multiple line IDs are separated by
applicable to
commas. 0 stands for all lines.
SIP-T19P IP
If it is left blank, the dial-now rule will
phones)
apply to all accounts on the phone.
Settings->Dial
Plan->Dial-now->
Account
The default value is blank.
dialplan_dialn
ow.url =
phone_setting
.dialnow_dela
y=
dialplan.repla
ce.prefix.X =
(X ranges
from 1 to 100)
URL within
511
characters
Integer from
1 to 14
String within
32
characters
It configures the access URL of the
dial-now rule file.
The default value is blank.
It configures the delay time (in
seconds) for the dial-now rule.
The default value is 1.
Features->General
Information->TimeOut for Dial-Now
Rule
It configures the entered number to be
Settings->Dial
replaced.
Plan->Replace
The default value is blank.
Rule->Prefix
129
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Values
Descriptions
Web Setting Path
dialplan.repla
ce.replace.X
=
(X ranges
String within
32
characters
It configures the alternate number to
Settings->Dial
replace the entered number.
Plan->Replace
The default value is blank.
Rule->Replace
from 1 to 100)
It configures lines applying the
dialplan.repla
dial-now rule.
ce.line_id.X =
0 to 6 (for SIP-T28P/T48G/T46G)
(X ranges
from 1 to 100)
Integer
0 to 3 (for SIP-T26P/T22P/T42G/T41P)
(not
0 to 2 (for SIP-T21P/T20P)
applicable to
Multiple line IDs are separated by
SIP-T19P IP
commas. 0 stands for all lines.
phones)
dialplan_repl
ace_rule.url =
Settings->Dial
Plan->Replace
Rule-> Account
The default value is blank.
URL within
511
It configures the access URL of the
replace rule file.
characters
The default value is blank.
URL within
It configures the access URL of the
Directory->Remote
remote phone book.
Phone Book->
The default value is blank.
Remote URL
It configures the display name of the
Directory->Remote
99
remote phone book item.
Phone Book->
characters
The default value is blank.
Display Name
remote_phone
book.data.X.u
rl =
(X ranges
from 1 to 5)
(not
511
characters
applicable to
SIP-T20P IP
phones)
remote_phone
book.data.X.n
ame =
(X ranges
from 1 to 5)
(not
String within
applicable to
SIP-T20P IP
phones)
remote_phone
String within
book.display_
99
name =
130
characters
It configures the display name of the
remote phone book.
If it is left blank, Remote Phone Book is
Appendix
Parameter
Permitted
Descriptions
Values
(not
displayed on the LCD screen at the
applicable to
path Menu->Directory.
SIP-T20P,
The default value is blank.
Web Setting Path
SIP-T42G and
SIP-T41P IP
phones)
ldap.enable =
It enables or disables LDAP feature.
(not
applicable to
SIP-T20P and
0 or 1
SIP-T19P IP
0-Disabled
Directory->LDAP->
1-Enabled
Enable LDAP
The default value is 0.
phones)
ldap.name_filt
It configures the criteria for searching
er =
(not
String within
applicable to
99
SIP-T20P and
characters
SIP-T19P IP
the contact name attributes.
Example:
ldap.name_filter = (|(cn=%)(sn=%))
Directory->LDAP->
LDAP Name Filter
The default value is blank.
phones)
ldap.number_f
It configures the criteria for searching
ilter =
the contact number attributes.
(not
String within
applicable to
99
SIP-T20P and
characters
Example:
ldap.number_filter =
(|(telephoneNumber=%)(mobile=%)(i
SIP-T19P IP
pPhone=%))
phones)
The default value is blank.
Directory->LDAP->
LDAP Number Filter
ldap.host =
(not
applicable to
SIP-T20P and
SIP-T19P IP
IP address
It configures the IP address or domain
or domain
name of the LDAP server.
name
The default value is blank.
Directory->LDAP->
Server Address
phones)
ldap.port =
(not
applicable to
Integer from
SIP-T20P and
1 to 65535
SIP-T19P IP
It configures the port of the LDAP
server.
The default value is 389.
Directory->LDAP->
Port
phones)
131
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
applicable to
SIP-T20P and
SIP-T19P IP
Web Setting Path
It configures the LDAP search base
ldap.base =
(not
Descriptions
Values
which corresponds to the location of
String within
99
characters
phones)
the LDAP phonebook.
Example:
Directory->LDAP->
Base
ldap.base = dc=yealink,dc=cn
The default value is blank.
ldap.user =
(not
applicable to
SIP-T20P and
SIP-T19P IP
String within
It configures the user name for
99
accessing the LDAP server.
characters
The default value is blank.
Directory->LDAP->
Username
phones)
ldap.passwor
d=
(not
String within
It configures the password for
applicable to
99
accessing the LDAP server.
SIP-T20P and
characters
The default value is blank.
Directory->LDAP->
Password
SIP-T19P IP
phones)
ldap.max_hits
=
(not
applicable to
SIP-T20P and
It configures the maximum of the
Integer from
1 to 32000
search results returned by the LDAP
server to be displayed.
The default value is 50.
SIP-T19P IP
Directory->LDAP->
Max. Hits
(1~32000)
phones)
It configures the name attributes of
ldap.name_at
each record to be returned by the
tr =
LDAP server.
(not
String within
applicable to
99
SIP-T20P and
characters
SIP-T19P IP
Multiple attributes are separated by
spaces.
Example:
Directory->LDAP->
LDAP Name
Attributes
ldap.name_attr =sn cn
phones)
The default value is blank.
ldap.numb_at
132
String within
tr =
99
(not
characters
It configures the number attributes of
Directory->LDAP->
each record to be returned by the
LDAP Number
LDAP server.
Attributes
Appendix
Parameter
Permitted
Descriptions
Values
applicable to
Multiple attributes are separated by
SIP-T20P and
spaces.
SIP-T19P IP
Example:
phones)
Web Setting Path
ldap.numb_attr = Mobile ipPhone
The default value is blank.
ldap.display_
It configures the display name of the
name =
contact record displayed on the LCD
(not
String within
applicable to
99
SIP-T20P and
characters
screen. The value of this parameter
must start with “%” symbol.
Example:
SIP-T19P IP
ldap.display_name = %cn
phones)
The default value is blank.
Directory->LDAP->
LDAP Display
Name
ldap.version
=
(not
applicable to
2 or 3
SIP-T20P and
It configures the LDAP version.
Directory->LDAP->
The default value is 3.
Protocol
SIP-T19P IP
phones)
ldap.call_in_lo
It enables or disables the phone to
okup =
perform an LDAP search when
(not
applicable to
receiving an incoming call.
0 or 1
SIP-T20P and
1-Enabled
SIP-T19P IP
LDAP Lookup For
Incoming Call
The default value is 0.
phones)
ldap.ldap_sort
It enables or disables the phone to sort
=
the search results in alphabetical order
(not
applicable to
0-Disabled
Directory->LDAP->
or numerical order.
0 or 1
SIP-T20P and
0-Disabled
1-Enabled
SIP-T19P IP
Directory->LDAP->
LDAP Sorting
Results
The default value is 0.
phones)
It configures the characters the phone
features.call_n
um_filter =
String within
99
characters
filters when dialing.
Features->General
If the dialed number contains
Information->Call
configured characters, the phone will
Number Filter
automatically filter these characters
133
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
Web Setting Path
when dialing.
The default value is “-,”.
It configures a return code and reason
of SIP response messages when
rejecting an incoming call by DND.
features.dnd_r
404, 480 or
efuse_code =
486
404-No Found
480-Temporarily not available
486-Busy here
Features->General
Information->
Return Code When
DND
The default value is 480.
It configures a return code and reason
of SIP response messages when
features.norm
al_refuse_cod
e=
rejecting an incoming call.
404, 480 or
486
404-No Found
480-Temporarily not available
486-Busy here
Features->General
Information->
Return Code When
Refuse
The default value is 486.
It enables or disables call completion
feature.
features.call_c
ompletion_en
0 or 1
able =
Features->General
0-Disabled
Information->Call
1-Enabled
Completion
The default value is 0.
features.fwd_
mode =
It configures the call forward mode.
(not
0-Phone
applicable to
0 or 1
SIP-T19P IP
1-Custom
Features->
Forward&DND->Fo
rward->Mode
The default value is 0.
phones)
features.dnd_
mode =
It configures the DND mode.
(not
0-Phone
applicable to
0 or 1
SIP-T19P IP
1-Custom
Features->
Forward&DND->
DND->Mode
The default value is 0.
phones)
features.dnd.e
nable =
134
0 or 1
It enables or disables DND feature.
Features->
0-Disabled
Forward&DND->
1-Enabled
DND->DND Status
Appendix
Parameter
Permitted
Descriptions
Values
Web Setting Path
The default value is 0.
features.dnd.o
n_code =
features.dnd.o
ff_code =
String within
32
characters
String within
32
characters
It configures the DND on code when
the DND mode is configured as Phone.
The default value is Blank.
It configures the DND off code when
the DND mode is configured as Phone.
The default value is Blank.
Features->
Forward&DND->
DND->DND On
Code
Features->
Forward&DND->
DND->DND Off
Code
It enables or disables the phone to
receive incoming calls from authorized
numbers when DND feature is
features.dnd.e
mergency_en
0 or 1
enabled.
0-Disabled
able =
Features->
Forward&DND->
DND Emergency
1-Enabled
The default value is 0.
It configures the numbers the phone
features.dnd.e
mergency_aut
horized_numb
er =
String within
511
characters
will receive incoming calls from when
Features->
DND feature is enabled.
Forward&DND->
Multiple numbers are separated by
DND Authorized
commas.
Numbers
The default value is blank.
It enables or disables forward
diversion feature.
features.fwd_
diversion_ena
0 or 1
ble =
0- Disabled
1-Enabled
Features->General
Information->
Diversion/History-In
fo
The default value is 1.
It enables or disables call waiting
feature.
call_waiting.e
nable =
0 or 1
Features->General
0-Disabled
Information->Call
1-Enabled
Waiting
The default value is 1.
It enables or disables the phone to
call_waiting.to
ne =
0 or 1
play the call waiting tone.
0-Disabled
Features->Audio> Call Waiting
Tone
1-Enabled
135
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
Web Setting Path
The default value is 1.
call_waiting.o
n_code =
call_waiting.of
f_code =
String within
32
characters
String within
32
characters
It configures the call waiting on code.
The default value is blank.
It configures the call waiting off code.
The default value is blank.
Features->General
Information->Call
Waiting On Code
Features->General
Information->Call
Waiting Off Code
It enables or disables the phone to
automatically answer an incoming
features.interc
om.allow =
intercom call.
0 or 1
0-Disabled
1-Enabled
Features->Interco
m ->Accept
Intercom
The default value is 1.
It enables or disables the phone to
mute the speaker when answering an
features.interc
om.mute =
intercom call.
0 or 1
0-Disabled
Features->Interco
m ->Intercom Mute
1-Enabled
The default value is 0.
It enables or disables the phone to
play a warning tone when answering
features.interc
om.tone =
an intercom call.
0 or 1
0-Disabled
Features->Interco
m ->Intercom Tone
1-Enabled
The default value is 1.
It enables or disables the phone to
barge in an intercom call.
features.interc
om.barge =
0 or 1
Features->Interco
0-Disabled
m ->Intercom
1-Enabled
Barge
The default value is 0.
It enables or disables the phone to
features.remot
perform a remote phone book search
e_phonebook.
enable =
0 or 1
Directory->Remote
Phone Book->
0-Disabled
Search Remote
applicable to
1-Enabled
Phonebook Name
SIP-T20P IP
The default value is 0.
(not
136
when receiving an incoming call.
Appendix
Parameter
Permitted
Descriptions
Values
Web Setting Path
phones)
features.remot
It configures the interval (in seconds)
e_phonebook.
flash_time =
Integer from
for the phone to update the data of the
(not
3600 to
remote phone book from the remote
applicable to
2592000
phone book server.
The default value is 21600.
SIP-T20P IP
Directory->Remote
Phone Book->
Search Flash Time
(Seconds)
phones)
features.hotlin
e_number =
features.hotlin
e_delay =
String within
32
characters
Integer from
0 to 10
It configures the hotline number.
The default value is blank.
Features->General
Information->
Hotline Number
It configures the delay time (in
Features->General
seconds) for the phone to dial out the
Information->
hotline number automatically.
Hotline Delay
The default value of delay time is 4.
(0~10s)
It enables or disables the phone to
suppress the display of DTMF digits.
features.dtmf.
hide =
0 or 1
Features->General
0-Disabled
Information->Supp
1-Enabled
ress DTMF Display
The default value is 0.
It enables or disables the phone to
display the DTMF digits for a short
features.dtmf.
period before displaying as asterisks
hide_delay =
(not
applicable to
0 or 1
SIP-T20P IP
when the parameter
Features->General
“features.dtmf.hide” is set to 1
Information->Supp
(Enabled).
ress DTMF Display
0-Disabled
phones)
Delay
1-Enabled
The default value is 0.
features.dtmf.r
epetition =
1, 2 or 3
It configures the repetition times for
Features->General
sending the DTMF packets.
Information->DTM
The default value is 3.
F Repetition
It enables or disables the phone to
features.dtmf.r
eplace_tran =
0 or 1
send DTMF sequences for transfer
Features->General
function when pressing the transfer
Information->DTM
soft key or the TRAN key.
F Replace Tran
0-Disabled
137
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
Web Setting Path
1-Enabled
The default value is 0.
features.dtmf.t
ransfer =
String within
32
characters
It configures DTMF sequences for
transfer key function to be sent. It
consists of 0-9, A-D, * and #.
The default value is blank.
Features->General
Information->Tran
Send DTMF
It enables or disables headset prior
feature.
features.head
set_prior =
0 or 1
Features->General
0-Disabled
Information->
1-Enabled
Headset Prior
The default value is 0.
features.head
It enables or disables dual headset
set_training =
feature.
(not
Features->General
0-Disabled
Information->Dual-
SIP-T21P and
1-Enabled
Headset
SIP-T19P IP
The default value is 0.
applicable to
0 or 1
phones)
It enables or disables the phone to
play a local DTMF tone.
features.play_
local_dtmf_ton
0 or 1
e_enable=
Features->General
0-Disabled
Information->Play
1-Enabled
Local DTMF Tone
The default value is 1.
features.busy_
tone_delay =
It configures the duration time (in
0, 3 or 5
seconds) for the busy tone.
The default value is 0.
Features->General
Information->Busy
Tone Delay
(Seconds)
It configures whether to send one
pound key by pressing the pound key
twice when the pound key is
features.send
_pound_key =
0 or 1
configured as a send key.
0-Send one pound key
Features->General
Information->Send
Pound Key
1-Do not send any pound key
The default value is 0.
features.key_a
s_send =
138
0, 1 or 2
It configures the "#" or "*" key as a send
Features->General
key.
Information->Key
Appendix
Parameter
Permitted
Descriptions
Values
0-Disabled
Web Setting Path
As Send
1-# key
2-* key
The default value is 1.
Note: The old parameter
“features.pound_key.mode” is also
applicable to IP phones.
It enables or disables the phone to
play key tone when pressing the send
features.send
_key_tone =
key.
0 or 1
0-Disabled
Features->Audio> Send Sound
1-Enabled
The default value is 1.
It enables or disables the phone to
play key tone when pressing any key.
features.key_t
one =
0 or 1
0-Disabled
1-Enabled
Features->Audio> Key Tone
The default value is 1.
It enables or disables the phone to
play a warning tone when there is a
features.play_
hold_tone.ena
call on hold.
0 or 1
ble =
0-Disabled
1-Enabled
Features->General
Information->Play
Hold Tone
The default value is 1.
features.play_
hold_tone.del
ay =
Integer from
3 to 3600
It configures the interval (in seconds)
Features->General
for playing a hold warning tone.
Information->Play
The default value is 30.
Hold Tone Delay
It configures the phone to continue to
play the dial tone after inputting the
preset numbers in the dialing screen.
features.redial
_tone =
Integer
Example:
within 6
features.redial_tone = 125
digits
Features->Audio>Redial Tone
The phone will continue to play the dial
tone after inputting “125” in the dialing
screen.
If it is left blank, the phone will not play
139
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
Web Setting Path
the dial tone after inputting numbers in
the dialing screen.
The default value is blank.
It enables or disables the phone with
active accounts to play tones in the
dialing screen differently from the
features.partiti
on_tone =
0 or 1
phone with no active accounts.
0-Disabled
1-Enbaled
The default value is 0.
It enables or disables password dial
feature for the phone.
features.pass
word_dial.ena
0 or 1
ble =
Features->General
0-Disabled
Information->PswD
1-Enabled
ial
The default value is 0.
It configures the prefix of the
password-dial number.
features.pass
String within
word_dial.pref
32
ix =
characters
For example, set the prefix to 12 and
the length to 3, when you want to dial
the number 123456, the entered
number is displayed as 12***6 on the
Features->General
Information->
PswPrefix
LCD screen.
The default value is blank.
It configures the number of digits to be
features.pass
word_dial.len
gth =
Integer from
0 to 99
hidden.
Features->General
The hidden digits are displayed as
Information->
asterisks on the LCD screen.
PswLength
The default value is blank.
It enables or disables the phone to
save the call history.
features.save_
call_history =
0 or 1
Features->General
0-Disabled
Information->Save
1-Enabled
Call Log
The default value is 1.
phone_setting
It enables or disables the power
Features->Power
.common_po
indicator LED to be turned on.
LED->Common
For SIP-T2xP/T19P IP phones:
Power Light On
wer_led_enab
140
0 or 1
Appendix
Parameter
Permitted
Descriptions
Values
le =
Web Setting Path
0-Disabled (power indicator LED is off)
1-Enabled (power indicator LED is solid
green)
The default value is 1.
For SIP-T4X IP phones:
0-Disabled (power indicator LED is off)
1-Enabled (power indicator LED is solid
red)
The default value is 0.
Note: The old parameter
“features.power_led_on” is also
applicable to IP phones and
“features.idle_talk_power_led_flash_e
nable” is also applicable to
SIP-T21P/T19P/T4X IP phones.
It enables or disables the power
indicator LED to flash when the phone
receives an incoming call.
For SIP-T2xP/T19P IP phones:
0-Disabled (power indicator LED does
not flash)
1-Enabled (power indicator LED fast
flashes (300ms) green)
phone_setting
The default value is 1.
.ring_power_l
For SIP-T4X IP phones:
ed_flash_ena
0 or 1
0-Disabled (power indicator LED does
ble =
Features->Power
LED->Ring Power
Light Flash
not flash)
1-Enabled (power indicator LED fast
flashes (300ms) red)
If it is set to 0, the status of the power
indicator LED is determined by the
value of the parameter
“phone_setting.common_power_led_e
nable”.
The default value is 1.
phone_setting
.mail_power_l
ed_flash_ena
0 or 1
It enables or disables the power
Features->Power
indicator LED to flash when the phone
LED->Voice/Text
receives a voice mail or a text
Mail Power Light
141
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
ble =
message.
Web Setting Path
Flash
For SIP-T2xP/T19P IP phones:
0-Disabled (power indicator LED does
not flash)
1-Enabled (power indicator LED slow
flashes (1000ms) green)
The default value is 0.
For SIP-T4X IP phones:
0-Disabled (power indicator LED does
not flash)
1-Enabled (power indicator LED slow
flashes (1000ms) red)
The default value is 1.
If it is set to 0, the status of the power
indicator LED is determined by the
value of the parameter
“phone_setting.common_power_led_e
nable”.
It enables or disables the power
indicator LED to flash when a call is
mute.
For SIP-T2xP/T19P IP phones:
0-Disabled (power indicator LED does
not flash)
1-Enabled (power indicator LED fast
flashes (300ms) green)
phone_setting
The default value is 1.
.mute_power_l
For SIP-T4X IP phones:
ed_flash_ena
ble =
0 or 1
0-Disabled (power indicator LED does
not flash)
1-Enabled (power indicator LED fast
flashes (300ms) red)
The default value is 0.
If it is set to 0, the status of the power
indicator LED is determined by the
value of the parameter
“phone_setting.common_power_led_e
nable”.
142
Features->Power
LED->Mute Power
Light On
Appendix
Parameter
Permitted
Descriptions
Values
Web Setting Path
It enables or disables the power
indicator LED to flash when a call is
placed on hold or is held.
For SIP-T2xP/T19P IP phones:
0-Disabled (power indicator LED does
not flash)
1-Enabled (power indicator LED fast
flashes (500ms) green)
phone_setting
The default value is 0.
.hold_and_hel
d_power_led_
0 or 1
For SIP-T4X IP phones:
flash_enable
0-Disabled (power indicator LED does
=
not flash)
Features->Power
LED->Hold/Held
Power Light On
1-Enabled ( power indicator LED fast
flashes (500ms) red)
The default value is 0.
If it is set to 0, the status of the power
indicator LED is determined by the
value of the parameter
“phone_setting.common_power_led_e
nable”.
It enables or disables the power
indicator LED to be turned on when the
phone is busy.
For SIP-T2xP/T19P IP phones:
0-Disabled (power indicator LED is off)
1-Enabled ( power indicator LED is
solid green)
phone_setting
.talk_and_dial
_power_led_e
nable =
0 or 1
The default value is 1.
Features->Power
For SIP-T4X IP phones:
LED->Talk/Dial
0-Disabled (power indicator LED is off)
Power Light On
1-Enabled (power indicator LED is solid
red)
The default value is 0.
If it is set to 0, the status of the power
indicator LED is determined by the
value of the parameter
“phone_setting.common_power_led_e
143
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
Web Setting Path
nable”.
features.relog
_offtime =
Integer from
1 to 1000
It configures the web access timeout
Features->General
(in minutes).
Information->Auto-
The default value is 5.
Logout Time
It takes effect after a reboot.
(1~1000min)
It enables or disables the phone to
make an IP call directly.
features.direct
_ip_call_enabl
0 or 1
e=
Features->General
0-Disabled
Information->
1-Enabled
Allow IP Call
The default value is 1.
It enables or disables the phone to
mute an active call.
features.allow
_mute =
0 or 1
Features->General
0-Disabled
Information->Allo
1-Enabled
w Mute
The default value is 1.
It enables or disables the phone to
enter into the group listening mode by
pressing the speakerphone key when
features.grou
p_listen_in_tal
0 or 1
it is in talking using the handset.
0-Disabled
king_enable =
1-Enabled
The default value is 1.
It configures the ringer device for the
phone in the headset mode.
features.ringer
_device.is_use
0-Use Speaker
0, 1 or 2
_headset =
1-Use Headset
2-Use Headset & Speaker
The default value is 0.
It enables or disables the phone to
prompt for the administrator password
when you long press the OK key to
features.factor
y_pwd_enabl
e=
0 or 1
perform factory reset.
0-Disabled
1-Enabled
The default value is 0.
144
Features->Audio> Ringer Device for
Headset
Appendix
Parameter
Permitted
Descriptions
Values
Web Setting Path
It configures the phone to export the
configuration file with what type of
password.
features.expor
t_cfg_erase_p
0 or 1
wd =
0-Encrypted
1-Blank
2-Plaintext
The default value is 1.
features.picku
It enables or disables the phone to
p.group_picku
display the GPickup soft key when the
p_enable =
(not
phone is in the pre-dialing screen.
0 or 1
applicable to
1-Enabled
SIP-T20P IP
p.group_picku
p_code =
String within
32
characters
features.picku
0 or 1
Pickup->Group
The default value is blank.
Call Pickup Code
0-Disabled
1-Enabled
SIP-T20P IP
String within
Pickup->Directed
Call Pickup
32
characters
It configures the directed call pickup
Features->Call
code.
Pickup->Directed
The default value is blank.
Call Pickup Code
features.picku
It enables or disables the phone to
p.blf_visual_e
display a visual alert when the
nable =
monitored user receives an incoming
(not
Features->Call
The default value is 0.
phones)
p_code =
Features->Call
code.
phone is in the pre-dialing screen.
applicable to
p.direct_picku
It configures the group call pickup
display the DPickup soft key when the
p_enable =
features.picku
Call Pickup
It enables or disables the phone to
p.direct_picku
(not
Pickup->Group
The default value is 0.
phones)
features.picku
0-Disabled
Features->Call
0 or 1
call.
Features->Call
Pickup->Visual
applicable to
0-Disabled
SIP-T20P IP
1-Enabled
phones)
The default value is 0.
features.picku
It enables or disables the phone to
Features->Call
play an audio alert when the
Pickup->Audio
monitored user receives an incoming
Alert for BLF Pickup
p.blf_audio_e
nable =
0 or 1
Alert for BLF Pickup
145
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
Web Setting Path
call.
0-Disabled
1-Enabled
The default value is 0.
It configures BLF LED mode and
features.blf_le
provides four kinds of definition for the
d_mode =
BLF/BLF list key LED status.
(not
For more information, refer to BLF LED
Features->General
Mode on page 228.
Information->BLF
SIP-T19P and
The default value is 0.
LED Mode
SIP-T48G IP
Note: The old parameter
phones)
“features.blf_and_callpark_idle_led_e
applicable to
0, 1, 2 or 3
nable” is also applicable to IP phones.
It enables or disables the phone to
deal with the Version header in the BLF
NOTIFY message sent by the server.
features.blf_lis
t_version =
0 or 1
0-Disabled
1-Enabled
The default value is 0.
It takes effect after a reboot.
It enables or disables the phone to
play the warning tone when receiving
features.voice
_mail_tone_en
a voice mail.
0 or 1
able =
0-Disabled
1-Enabled
The default value is 1.
PCMU
PCMA
multicast.code
c=
(not
applicable to
SIP-T19P IP
phones)
G729
G722
G726-16
G726-24
G726-32
G726-40
G723_53
146
It configures the codec of multicast
paging.
Codecs G726-16, G726-24 and
G726-40 are not applicable to SIP-T21P
IP phones.
The default value is G722.
Features->General
Information->
Multicast Codec
Appendix
Parameter
Permitted
Descriptions
Values
Web Setting Path
It enables or disables the phone to
handle the incoming multicast paging
multicast.recei
ve_priority.en
0 or 1
calls when there is a multicast paging
Directory->
call on the phone.
Multicast
0-Disabled
able =
1-Enabled
IP->Paging Priority
Active
The default value is 1.
It configures the priority of multicast
multicast.recei
ve_priority.pri
ority =
Integer from
0 to 10
paging calls.
Directory->
1 is the highest priority, 10 is the lowest
Multicast
priority.
IP->Paging Barge
The default value is 10.
It configures the listening multicast IP
multicast.listen
address and port number for the
_address.X.ip_
phone.
address =
(X ranges
IP address:
port
from 1 to 10)
Directory->
Example:
Multicast IP->
multicast.listen_address.1.ip_address
Listening Address
= 224.5.6.20:10008
The default value is blank.
multicast.listen
_address.X.la
bel =
(X ranges
String within
99
characters
from 1 to 10)
It configures the label displayed on the
LCD screen when receiving the
Directory->
multicast paging.
Multicast IP->Label
The default value is blank.
It enables or disables the phone to
automatically dial out the entered
phone_setting
.predial_auto
digits in the pre-dialing screen.
0 or 1
dial =
0-Disabled
Settings->Preferen
ce->Live Dialpad
1-Enabled
The default value is 0.
It configures the time (in seconds) for
phone_setting
.inter_digit_tim
e=
Integer from
1 to 14
the phone to automatically dial out the
Settings->
entered digits without pressing a send
Preference->Inter
key.
Digit Time (1~14s)
The default value is 4.
147
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
phone_setting
Web Setting Path
It configures the keypad lock type.
.lock =
0-Disabled
(only
applicable to
Descriptions
Values
0, 1, 2 or 3
SIP-T2xP and
1-Menu Key
2-Function Keys
Features->Phone
Lock->Keypad
Lock Type
3-All Keys
SIP-T19P IP
The default value is 0.
phones)
phone_setting
.phone_lock.e
It enables or disables keypad lock
nable =
feature.
(only
Features->Phone
0-Disabled
Lock->Keypad
SIP- T46G,
1-Enabled
Lock Enable
T42G and
The default value is 0.
applicable to
0 or 1
T41P IP
phones)
phone_setting
.phone_lock.lo
It configures the keypad lock type.
ck_key_type =
(only
applicable to
0, 1 or 2
SIP- T46G,
T42G and
0-All Keys
Features->Phone
1-Function Keys
Lock->Keypad
2-Menu Key
Lock Type
The default value is 0.
T41P IP
phones)
phone_setting
.phone_lock.u
nlock_pin =
(not
applicable to
characters
within 15
digits
It configures the password for
unlocking the keypad.
The default value is 123.
SIP-T48G IP
Features->Phone
Lock->Phone
Unlock PIN (0~15
Digit)
phones)
phone_setting
It configures the interval (in seconds)
.phone_lock.lo
ck_time_out =
(not
applicable to
SIP-T48G IP
phones)
148
Integer from
0 to 3600
to automatically lock the keypad.
Features->Phone
The default value is 0 (the keypad is
Lock->Phone Lock
locked only by long pressing the
Time Out
pound key or pressing the keypad lock
(0~3600s)
key)
Appendix
Parameter
Permitted
Descriptions
Values
Web Setting Path
features.bluet
ooth_enable
It enables or disables Bluetooth
=
(only
applicable to
feature.
0 or 1
SIP-48G and
Features->
0-Disabled
Bluetooth->
1-Enabled
Bluetooth Active
The default value is 0.
SIP-T46G IP
phones)
Ring1.wav,
It configures the ring tone for the
Ring2.wav,
phone.
Ring3.wav,
Example:
phone_setting
Ring4.wav,
phone_setting.ring_type = Ring1.wav
Settings->Preferen
.ring_type =
Ring5.wav
The default value is Ring1.wav.
ce->Ring Type
Ring6.wav,
Note: Ring tones 6-8 are only
Ring7.wav,
applicable to SIP-T48G and SIP-T46G IP
Ring8.wav
phones.
phone_setting
It configures the contrast of the LCD
.contrast =
screen.
(only
For SIP-T21P and SIP-T19P IP phones, it
applicable to
configures the LCD’s contrast of the
SIP-T28P,
phone only.
SIP-T21P,
For SIP-T26P IP phones, it configures the
SIP-19P IP
phones, EXP39
connected to
Integer from
1 to 10
SIP-T28P and
For SIP-T28P IP phones, it configures the
Settings->Preferen
ce->Contrast
connected EXP39.
phones, and
For SIP-T48G/T46G IP phones, it
EXP40
configures the LCD’s contrast of the
connected to
connected EXP40 only.
SIP-T48G/T46G
The default value is 6.
IP phones)
It configures the logo mode of the LCD
phone_setting
screen (except for SIP-T20P IP phones).
.lcd_logo.mod
(not
only.
LCD’s contrast of the IP phone and the
SIP-T26P IP
e=
LCD’s contrast of the connected EXP39
0, 1 or 2
For SIP-T26P/T22P/T21P/T19P/ T42G/T41P
IP phones:
applicable to
0-Disabled
SIP-T48G/T46G
1-System logo
Features->General
Information->Use
Logo
149
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
IP phones)
Web Setting Path
2-Custom logo
The default value is 0.
For SIP-T28P IP phones:
1-System logo
2-Custom logo
The default value is 1.
It enables or disables a text logo (for
SIP-T20P IP phones).
0-Disabled
1-Enabled
The default value is 0.
phone_setting
.lcd_logo.text
=
(only
applicable to
String within
15
characters
It configures a text logo.
The default value is Yealink.
Features->General
Information->Text
Logo
SIP-T20P IP
phones)
lcd_logo.url =
(not
applicable to
SIP-T20P and
SIP-T48G/T46G
It configures the access URL of logo
Features->General
file.
Information->
characters
The default value is blank.
Upload Logo
URL within
It deletes all custom logo files.
URL within
511
IP phones)
lcd_logo.delet
e=
(not
applicable to
511
SIP-T20P and
characters
The valid value is: http://localhost/all
The default value is blank.
SIP-T48G/T46G
IP phones)
phone_setting
Integer from
.active_backli
1 to 3 for
ght_level =
(only
applicable to
SIP-T28P IP
150
SIP-T28P and
the
connected
EXP39 IP
It configures the level of the active
backlight intensity.
For SIP-T28P IP phones and the
connected EXP39:
The default value is 2.
For SIP-T48G IP phones and the
Settings->Preferen
ce->Backlight
Active Level
Appendix
Parameter
phones and
the connected
Permitted
Descriptions
Values
phones.
Integer from
connected EXP40:
The default value is 10.
EXP39, and
1 to 10 for
SIP-T48G/T46G
For SIP-T46G IP phones and the
SIP-T48G/
IP phones and
connected EXP40:
T46G IP
the connected
phones and
EXP40)
Web Setting Path
The default value is 8.
the
connected
EXP40
phone_setting
It configures the phone to go out or
.inactive_back
reduce intensity of the backlight on the
light_level =
(only
LCD screen after a period of inactivity.
0 or 1
applicable to
SIP-T48G/T46G
Settings->
Preference->
0-Off
Backlight Inactive
1-Low
Level
The default value is 1.
IP phones)
It configures the backlight time (in
seconds).
For SIP-T28P/T26P/T22P IP phones:
0-Always off
1-Always on
15-15s
30-30s
phone_setting
60-60s
.backlight_tim
120-120s
e=
(not
0, 1, 15, 30,
300-300s
applicable to
60, 120, 300,
600-600s
SIP-T21P,
600 or 1800
1800-1800s
SIP-T20P and
SIP-T19P IP
phones)
Settings->Preferen
ce->Backlight Time
(seconds)
The default value is 30.
For SIP-T4X IP phones:
0-Always on
15-15s
30-30s
60-60s
120-120s
300-300s
600-600s
151
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
Web Setting Path
1800-1800s
The default value is 0.
Ring1.wav
Ring2.wav
Ring3.wav
phone_setting
.ring_for_tranf
ailed =
Ring4.wav
Ring5.wav
Ring6.wav
It configures the ring tone when the
phone fails to transfer a call.
The default value is Ring1.wav.
Note: Ring tones 6-8 are applicable to
SIP-T48G/T46G IP phones only.
Ring7.wav
Ring8.wav
It enables or disables the phone to
provide the logon wizard during
phone_setting
.logon_wizard
startup.
0 or 1
=
0-Disabled
1-Enabled
Features->General
Information->
Logon Wizard
The default value is 0.
It enables or disables the phone to
deal with the 180 SIP message
phone_setting
.is_deal180 =
received after the 183 SIP message.
0 or 1
0-Disabled
1-Enabled
Features->General
Information->180
Ring Workaround
The default value is 1.
It configures headset mode
precedence during a call.
0-Always use (pressing the
phone_setting
.headsetkey_
0 or 1
mode =
Speakerphone key and picking up the
handset are not effective when the
headset mode is activated)
1-Use as normal
The default value is 1.
phone_setting
.emergency.n
umber =
(not
applicable to
SIP-T48G IP
152
String within
99
characters
It configures emergency numbers.
Multiple emergency numbers are
Features->Phone
separated by commas.
Lock->Emergency
The default value is 110,911,120.
Appendix
Parameter
Permitted
Descriptions
Values
Web Setting Path
phones)
It configures the display message on
the LCD screen when receiving a 403
message.
phone_setting
String within
.show_code40
99
3=
characters
If it is left blank, the phone will display
the value sent from the server when
receiving the 403 message.
The default value is blank.
It takes effect after a reboot.
It enables or disables recent call in
super_search.
dialing feature. If it is enabled, you can
recent_call =
(not
applicable to
see the placed calls list when the
0 or 1
phone is in the pre-dialing screen.
0-Disabled
SIP-T20P IP
Directory->
Setting->Recent
Call In Dialing
1-Enabled
phones)
The default value is 0.
directory_setti
ng.url =
(not
applicable to
SIP-T20P IP
URL within
511
It configures the access URL of the
custom directory list file.
characters
The default value is blank.
URL within
It configures the access URL of the
Directory->
Setting->Directory
phones)
super_search.
url =
(not
applicable to
SIP-T20P IP
511
characters
custom search source list in dialing file.
The default value is blank.
Directory->
Setting->Search
Source List In
Dialing
phones)
URL within
firmware.url =
511
characters
URL within
ringtone.url =
511
characters
ringtone.delet
URL within
511
It configures the access URL of the
Settings->
firmware file.
Upgrade->Select
The default value is blank.
and Upgrade
It takes effect after a reboot.
Firmware
It configures the access URL of the
Settings->
custom ring tone file.
Preference->
The default value is blank.
Upload Ringtone
It deletes all custom ring tone files.
153
Yealink IP Phones Auto provisioning Guide
Parameter
e=
Permitted
Descriptions
Values
characters
Web Setting Path
The valid value is: http://localhost/all
The default value is blank.
URL within
gui_lang.url =
gui_lang.delet
e=
trusted_certific
ates.url =
trusted_certific
ates.delete =
511
It configures the access URL of the
custom language file.
characters
The default value is blank.
URL within
It deletes all custom language files.
511
The valid value is: http://localhost/all
characters
The default value is blank.
URL within
It configures the access URL of the
511
characters
URL within
511
characters
custom trusted certificate file.
The default value is blank.
Security->Trusted
Certificates->Load
trusted certificates
file
It deletes all uploaded trusted
certificate files.
The valid value is: http://localhost/all
The default value is blank.
server_certific
ates.url =
URL within
511
characters
It configures the access URL of the
Security->Server
custom server certificate file.
Certificates->Load
The default value is blank.
server cer file
It deletes the uploaded server
server_certific
ates.delete =
local_contact.
data.url =
URL within
511
characters
URL within
511
characters
local_contact.
(only
applicable to
URL within
511
characters
SIP-T48G/T46G
154
The default value is blank.
It configures the access URL of the
Directory->Local
local contact file.
Directory->Import
The default value is blank.
Local Directory File
file compressed from custom contact
file and avatar TAR file.
All avatars needed for contacts should
be tarred in advance.
The default value is blank.
IP phones)
auto_dst.url =
The valid value is: http://localhost/all
It configures the access URL of the TAR
data_photo_t
ar.url =
certificate file.
URL within
511
It configures the access URL of the DST
Time file.
Appendix
Parameter
Permitted
characters
custom_factor
URL within
y_configuratio
511
n.url =
Descriptions
Values
characters
Web Setting Path
The default value is blank.
It configures the access URL of the
custom factory configuration files.
The default value is blank.
It takes effect after a reboot.
It enables or disables Import Factory
Configuration feature.
features.custo
m_factory_con
0 or 1
fig.enable =
0-Disabled
1-Enabled
The default value is 0.
configuration.
url =
custom_mac_
cfg.url =
URL within
511
characters
URL within
511
characters
It configures the access URL for the
Settings->
custom configuration files.
Configuration->
The default value is blank.
Export or Import
It takes effect after a reboot.
Configuration
It configures the access URL of the
custom MAC-Oriented CFG file.
The default value is blank.
account.X.out
_dialog_blf_en
able =
(SIP-T19P: X=1
SIP-T21P/T20P:
It enables or disables the phone to
X ranges from
handle NOTIFY messages out of the
1 to 2.
SIP-T26P/T22P/T
BLF dialog for account X .
0 or 1
42G/T41P: X
0-Disabled
1-Enabled
ranges from 1
The default value is 0.
to 3.
SIP-T28P/T48G/
T46G: X
ranges from 1
to 6)
account.X.ena
It enables or disables the account X.
ble =
(SIP-T28P/T48G
/T46G: X
ranges from 1
0 or 1
0-Disabled
Account->Register
1-Enabled
->Line Active
The default value is 0.
155
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
Web Setting Path
to 6.
SIP-T26P/T22P/
T42G/T41P: X
ranges from 1
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1)
account.X.lab
el =
(SIP-T28P/T48G
/T46G: X
ranges from 1
to 6.
SIP-T26P/T22P/
T42G/T41P: X
ranges from 1
String within
It configures the label displayed on the
99
LCD screen for account X.
characters
The default value is blank.
Account->Register
->Label
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1)
account.X.dis
play_name =
(SIP-T28P/T48G
/T46G: X
ranges from 1
to 6.
SIP-T26P/T22P/
T42G/T41P: X
ranges from 1
String within
99
characters
It configures the display name for
account X.
The default value is blank.
Account->Register
->Display Name
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1)
account.X.aut
156
String within
It configures the user name for register
Account->Register
Appendix
Parameter
h_name =
(SIP-T28P/T48G
Permitted
Descriptions
Values
99
characters
authentication for account X.
Web Setting Path
->Register Name
The default value is blank.
/T46G: X
ranges from 1
to 6.
SIP-T26P/T22P/
T42G/T41P: X
ranges from 1
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1)
account.X.use
r_name =
(SIP-T28P/T48G
/T46G: X
ranges from 1
to 6.
SIP-T26P/T22P/
T42G/T41P: X
ranges from 1
String within
32
characters
It configures the register user name for
account X.
The default value is blank.
Account->Register
->User Name
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1)
account.X.pas
sword =
(SIP-T28P/T48G
/T46G: X
ranges from 1
to 6.
SIP-T26P/T22P/
T42G/T41P: X
String within
99
characters
It configures the password for register
authentication for account X.
The default value is blank.
Account->Register
->Password
ranges from 1
to 3.
SIP-T21P/T20P:
X ranges from
157
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
Web Setting Path
1 to 2.
SIP-T19P: X=1)
account.X.tran
sport =
(SIP-T28P/T48G
/T46G: X
It configures the transport type for
ranges from 1
account X.
to 6.
SIP-T26P/T22P/
T42G/T41P: X
0-UDP
Integer
1-TCP
2-TLS
ranges from 1
3-DNS-NAPTR
to 3.
The default value is 0.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1)
account.X.rere
gister_enable
=
(SIP-T28P/T48G
It configures whether the phone needs
/T46G: X
to re-register the account when
ranges from 1
encountering an INVITE failover, if the
to 6.
SIP-T26P/T22P/
SIP server is configured with a domain
0 or 1
T42G/T41P: X
name for account X.
0-Do not need to re-register
ranges from 1
1-Need to re-register
to 3.
The default value is 0.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1)
account.X.nap
It configures the way of SRV query
tr_build =
when there is no result from the NAPTR
(SIP-T28P/T48G
/T46G: X
ranges from 1
to 6.
SIP-T26P/T22P/
158
query for account X .
0 or 1
0-SRV query using UDP only
1-SRV query using UDP, TCP or TLS.
The default value is 0.
Account->Register
->Transport
Appendix
Parameter
Permitted
Descriptions
Values
Web Setting Path
T42G/T41P: X
ranges from 1
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1)
account.X.fall
back.redunda
ncy_type =
(SIP-T28P/T48G
/T46G: X
ranges from 1
It configures the registration mode for
to 6.
account X.
SIP-T26P/T22P/
0 or 1
0-Concurrent registration
T42G/T41P: X
1-Successive registration
ranges from 1
The default value is 0.
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1)
account.X.fall
back.timeout
=
(SIP-T28P/T48G
It configures the time interval (in
/T46G: X
seconds) for the phone to detect
ranges from 1
to 6.
Integer from
SIP-T26P/T22P/
10 to
T42G/T41P: X
2147483647
ranges from 1
to 3.
SIP-T21P/T20P:
whether the working server is
available by sending the registration
request for account X .
It is only applicable to successive
registration mode.
The default value is 120.
X ranges from
1 to 2.
SIP-T19P: X=1)
159
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
Web Setting Path
account.X.sip_
server.Y.addre
ss =
(SIP-T28P/T48G
/T46G: X
It configures the IP address or domain
ranges from 1
name of the SIP server Y for account X.
to 6.
Example:
SIP-T26P/T22P/
IP address
account.1.sip_server.1.address =
Account->Register
T42G/T41P: X
or domain
10.2.1.128
->SIP Server Y->
ranges from 1
name
The default value is blank.
Server Host
to 3.
Note: The old parameter
SIP-T21P/T20P:
“account.X.sip_server_host” is also
X ranges from
applicable to IP phones.
1 to 2.
SIP-T19P: X=1
Y ranges from
1 to 2.)
account.X.sip_
server.Y.port =
(SIP-T28P/T48G
/T46G: X
ranges from 1
to 6.
It configures the port of SIP server Y for
SIP-T26P/T22P/
account X.
T42G/T41P: X
Integer from
The default value is 5060.
ranges from 1
0 to 65535
Note: The old parameter
to 3.
Account->Register
->SIP Server Y->
Port
“account.X.sip_server_port” is also
SIP-T21P/T20P:
applicable to IP phones.
X ranges from
1 to 2.
SIP-T19P: X=1
Y ranges from
1 to 2)
account.X.sip_
server.Y.expire
s=
(SIP-T19P: X=1
SIP-T20P/T21P:
160
Integer from
30 to
2147483647
It configures the registration expiration
time (in seconds) to SIP server Y for
account X.
The default value is 3600.
Account->Register
->SIP Server Y->
Server Expires
Appendix
Parameter
Permitted
Descriptions
Values
Web Setting Path
X ranges from
1 to 2.
SIP-T22P/T26P/T
41P/T42G: X
ranges from 1
to 3.
SIP-T28P/T46G/
T48G: X
ranges from 1
to 6.
Y ranges from
1 to 2)
account.X.sip_
server.Y.retry_
counts =
(SIP-T28P/T48G
/T46G: X
ranges from 1
It configures the times for the phone to
to 6.
SIP-T26P/T22P/
T42G/T41P: X
ranges from 1
Integer from
0 to 20
to 3.
retransmit the request when the SIP
Account->Register
server Y is unavailable or there is no
->SIP Server Y
response from the SIP server Y for
->Server Retry
account X.
Counts
The default value is 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1
Y ranges from
1 to 2)
account.X.sip_
It configures the mode for the phone to
server.Y.failba
retry the primary server in failover
ck_mode =
mode for account X.
(SIP-T28P/T48G
0-newRequests: all requests are
/T46G: X
ranges from 1
0, 1, 2 or 3
forwarded to the primary server first,
regardless of the last used server.
to 6.
1-DNSTTL: the phone retries to use the
SIP-T26P/T22P/
primary server after the timeout of the
T42G/T41P: X
DNSTTL configured for the SIP server.
ranges from 1
2-Registration: the phone retries to use
161
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
to 3.
the primary server when the SIP
SIP-T21P/T20P:
server’s registration requires renewal.
X ranges from
3-duration: the phone retries to use the
1 to 2.
primary server after the timeout
SIP-T19P: X=1.
defined by the parameter
“account.X.failback_timeout”.
Y ranges from
The default value is 0.
1 to 2)
account.X.sip_
server.Y.failba
ck_timeout =
(SIP-T28P/T48G
It configures the timeout (in seconds)
/T46G: X
for the phone to retry to use the
ranges from 1
primary server after failing over to the
to 6.
SIP-T26P/T22P/
Integer 0,
T42G/T41P: X
from 60 to
ranges from 1
65535
to 3.
current working server for account X
when the parameter
“account.X.sip_server.Y.failback_mode
” is set to 3 (duration).
If you set the parameter between 1
SIP-T21P/T20P:
and 59, the timeout will be 60 seconds.
X ranges from
The default value is 3600.
1 to 2.
SIP-T19P: X=1.
Y ranges from
1 to 2.)
account.X.sip_
server.Y.regist
er_on_enable
=
It enables or disables the phone to
(SIP-T19P: X=1
send registration requests to the
SIP-T20P/T21P:
secondary server for account X when
X ranges from
1 to 2.
SIP-T22P/T26P/T
encountering a failover.
0-Disabled
41P/T42G: X
1-Enabled
ranges from 1
The default value is 0.
to 3.
SIP-T28P/T46G/
T48G: X
ranges from 1
162
0 or 1
Web Setting Path
Appendix
Parameter
Permitted
Descriptions
Values
Web Setting Path
to 6.
Y ranges from
1 to 2.)
account.X.stat
ic_cache_pri
=
(SIP-T28P/T48G
It configures whether preferentially to
/T46G: X
use the DNS static cache for domain
ranges from 1
name resolution of the SIP server for
to 6.
SIP-T26P/T22P/
account X.
0 or 1
T42G/T41P: X
0-Use domain name server
preferentially
ranges from 1
1-Use DNS static cache preferentially
to 3.
The default value is 0.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.)
account.X.dns
_cache_type
=
(SIP-T28P/T48G
It configures the content that the DNS
/T46G: X
static cache records for account X.
ranges from 1
0-Do not use DNS static cache.
to 6.
SIP-T26P/T22P/
0, 1 or 2
T42G/T41P: X
1-Use DNS static cache, but do not
record the additional records.
2-Use DNS static cache and record the
ranges from 1
additional records.
to 3.
The default value is 1.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.)
It configures the domain name of A
account.X.dns
_cache_a.Y.na
me =
Domain
name
record Y in the DNS static cache for
account X.
(SIP-T28P/T48G
The default value is blank.
/T46G: X
It takes effect after a reboot.
163
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
ranges from 1
to 6.
SIP-T26P/T22P/
T42G/T41P: X
ranges from 1
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.
Y ranges from
1 to 2.)
account.X.dns
_cache_a.Y.ip
=
(SIP-T28P/T48G
/T46G: X
ranges from 1
to 6.
It configures the IP address that the
SIP-T26P/T22P/
domain name of A record Y maps to in
T42G/T41P: X
IP address
ranges from 1
the DNS static cache for account X.
The default value is blank.
to 3.
It takes effect after a reboot.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.
Y ranges from
1 to 2.)
account.X.dns
_cache_a.Y.ttl
It configures the time interval that A
=
(SIP-T28P/T48G
/T46G: X
ranges from 1
to 6.
SIP-T26P/T22P/
T42G/T41P: X
ranges from 1
164
Integer from
30 to
2147483647
record Y may be cached before the
record should be consulted again for
account X.
The default value is 300.
It takes effect after a reboot.
Web Setting Path
Appendix
Parameter
Permitted
Descriptions
Values
Web Setting Path
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.
Y ranges from
1 to 2.)
account.X.dns
_cache_srv.Y.n
ame =
(SIP-T28P/T48G
/T46G: X
ranges from 1
to 6.
SIP-T26P/T22P/
T42G/T41P: X
ranges from 1
It configures the domain name of SRV
Domain
name
record Y in the DNS static cache for
account X.
It takes effect after a reboot.
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.
Y ranges from
1 to 2.)
account.X.dns
_cache_srv.Y.p
ort =
((SIP-T28P/T48
G/T46G: X
It configures the port to be used in SRV
ranges from 1
to 6.
SIP-T26P/T22P/
T42G/T41P: X
Integer from
record Y for account X.
0 to 65535
The default value is 0.
It takes effect after a reboot.
ranges from 1
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
165
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Values
Descriptions
SIP-T19P: X=1.
Y ranges from
1 to 2.)
account.X.dns
_cache_srv.Y.p
riority =
(SIP-T28P/T48G
/T46G: X
ranges from 1
to 6.
SIP-T26P/T22P/
T42G/T41P: X
ranges from 1
It configures the priority for the specific
Integer from
0 to 65535
to 3.
host entry in SRV record Y for account
X. Lower priority is more preferred.
The default value is 0.
It takes effect after a reboot.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.
Y ranges from
1 to 2.)
account.X.dns
_cache_srv.Y.t
arget =
(SIP-T28P/T48G
/T46G: X
ranges from 1
to 6.
SIP-T26P/T22P/
T42G/T41P: X
ranges from 1
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.
Y ranges from
1 to 2.)
166
It configures the actual host for an A
Domain
name
query for account X.
The default value is blank.
It takes effect after a reboot.
Web Setting Path
Appendix
Parameter
Permitted
Descriptions
Values
Web Setting Path
account.X.dns
_cache_srv.Y.
weight =
(SIP-T28P/T48G
/T46G: X
ranges from 1
It configures the weight of SRV record Y
to 6.
for account X.
SIP-T26P/T22P/
T42G/T41P: X
ranges from 1
Integer from
0 to 65535
to 3.
When priorities are equal, weight is
used to differentiate the preference.
Higher weight is more preferred.
The default value is 0.
SIP-T21P/T20P:
It takes effect after a reboot.
X ranges from
1 to 2.
SIP-T19P: X=1.
Y ranges from
1 to 2.)
account.X.dns
_cache_srv.Y.tt
l=
(SIP-T28P/T48G
/T46G: X
ranges from 1
It configures the time interval that SRV
to 6.
SIP-T26P/T22P/
Integer from
T42G/T41P: X
30 to
ranges from 1
2147483647
to 3.
record Y may be cached before the
record should be consulted again for
account X.
The default value is 300.
It takes effect after a reboot.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.
Y ranges from
1 to 2.)
account.X.dns
_cache_naptr.
Y.name =
(SIP-T28P/T48G
/T46G: X
It configures the domain name to
Domain
name
which NAPTR record Y refers in the
DNS static cache for account X.
The default value is blank.
167
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Values
Descriptions
It takes effect after a reboot.
ranges from 1
to 6.
SIP-T26P/T22P/
T42G/T41P: X
ranges from 1
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.
Y ranges from
1 to 2.)
account.X.dns
_cache_naptr.
Y.flags =
It configures the flag of NAPTR record Y
(SIP-T28P/T48G
in the DNS static cache for account X.
/T46G: X
(Always “s” for SIP, which means to do
ranges from 1
an SRV lookup on whatever is in the
to 6.
replacement field)
SIP-T26P/T22P/
T42G/T41P: X
S, A, U or P
S-Do an SRV lookup next.
ranges from 1
A-Do an A lookup next.
to 3.
U-No need to do a DNS query next.
SIP-T21P/T20P:
P-Service customized by the user
X ranges from
The default value is blank.
1 to 2.
It takes effect after a reboot.
SIP-T19P: X=1.
Y ranges from
1 to 2.)
account.X.dns
_cache_naptr.
Y.order =
It configures the order of NAPTR record
(SIP-T28P/T48G
/T46G: X
ranges from 1
to 6.
SIP-T26P/T22P/
T42G/T41P: X
ranges from 1
168
Integer from
0 to 65535
Y for account X. NAPTR record with
lower order is more preferred.
The default value is 0.
It takes effect after a reboot.
Web Setting Path
Appendix
Parameter
Permitted
Descriptions
Values
Web Setting Path
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.
Y ranges from
1 to 2.)
account.X.dns
_cache_naptr.
Y.preference
=
(SIP-T28P/T48G
/T46G: X
ranges from 1
It configures the preference of NAPTR
to 6.
record Y for account X. NAPTR record
SIP-T26P/T22P/
Integer from
T42G/T41P: X
0 to 65535
ranges from 1
with lower preference is more
preferred.
The default value is 0.
to 3.
It takes effect after a reboot.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.
Y ranges from
1 to 2.)
account.X.dns
_cache_naptr.
Y.replace =
(SIP-T28P/T48G
/T46G: X
It configures a domain name to be
ranges from 1
to 6.
SIP-T26P/T22P/
T42G/T41P: X
ranges from 1
Domain
name
used for the next SRV query in NAPTR
record Y for account X.
The default value is blank.
It takes effect after a reboot.
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
169
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
SIP-T19P: X=1.
Y ranges from
1 to 2.)
account.X.dns
_cache_naptr.
Y.service =
(SIP-T28P/T48G
/T46G: X
ranges from 1
to 6.
It configures the transport protocol
SIP-T26P/T22P/
String within
T42G/T41P: X
32
ranges from 1
characters
to 3.
available for SIP in NAPTR record Y for
account X.
The default value is blank.
It takes effect after a reboot.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.
Y ranges from
1 to 2.)
account.X.dns
_cache_naptr.
Y.ttl =
(SIP-T28P/T48G
/T46G: X
ranges from 1
It configures the time interval that
to 6.
SIP-T26P/T22P/
Integer from
T42G/T41P: X
30 to
ranges from 1
2147483647
to 3.
NAPTR record Y may be cached before
the record should be consulted again
for account X.
The default value is 300.
It takes effect after a reboot.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.
Y ranges from
1 to 2.)
account.X.srv_
170
0 or 1
It enables or disables the phone to
Web Setting Path
Appendix
Parameter
Permitted
Descriptions
Values
ttl_timer_enab
refresh the DNS-SRV query record at
le =
the regular time for account X.
(SIP-T28P/T48G
0-Disabled
/T46G: X
1-Enabled
ranges from 1
Web Setting Path
The default value is 0.
to 6.
It takes effect after a reboot.
SIP-T26P/T22P/
T42G/T41P: X
ranges from 1
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.)
account.X.out
bound_proxy_
enable =
(SIP-T28P/T48G
/T46G: X
It enables or disables the phone to use
ranges from 1
the outbound proxy server for account
to 6.
SIP-T26P/T22P/
X.
0 or 1
T42G/T41P: X
ranges from 1
Account->Register
->Enable
0-Disabled
Outbound Proxy
1-Enabled
Server
The default value is 0.
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.)
account.X.out
bound_host =
(SIP-T28P/T48G
/T46G: X
ranges from 1
to 6.
SIP-T26P/T22P/
IP address
or domain
name
It configures the IP address or domain
name of the outbound proxy server for
account X.
The default value is blank.
Account->Register
->Outbound Proxy
Server
T42G/T41P: X
ranges from 1
to 3.
171
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
Web Setting Path
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.)
account.X.out
bound_port =
(SIP-T28P/T48G
/T46G: X
ranges from 1
to 6.
SIP-T26P/T22P/
Integer from
T42G/T41P: X
0 to 65535
ranges from 1
It configures the port of the outbound
Account->Register
proxy server for account X.
->Outbound Proxy
The default value is 5060.
Server->Port
It configures the voice mail number for
Account->
account X.
Advanced->Voice
The default value is blank.
Mail
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.)
voice_mail.nu
mber.X =
(SIP-T28P/T48G
/T46G: X
ranges from 1
to 6.
SIP-T26P/T22P/
T42G/T41P: X
ranges from 1
String within
99
characters
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.)
account.X.pro
xy_require =
(SIP-T28P/T48G
/T46G: X
ranges from 1
to 6.
172
String within
256
characters
It configures the proxy server for
account X.
The default value is blank.
Account->Basic->
Proxy Require
Appendix
Parameter
Permitted
Descriptions
Values
Web Setting Path
SIP-T26P/T22P/
T42G/T41P: X
ranges from 1
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.)
account.X.sip_
trust_ctrl =
(SIP-T28P/T48G
/T46G: X
ranges from 1
It enables or disables the phone to
to 6.
only accept the message from the
SIP-T26P/T22P/
T42G/T41P: X
trusted server for account X.
0 or 1
ranges from 1
0-Disabled
1-Enabled
to 3.
The default value is 0.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.)
account.X.ano
nymous_call =
(SIP-T28P/T48G
/T46G: X
ranges from 1
It enables or disables anonymous call
to 6.
SIP-T26P/T22P/
T42G/T41P: X
feature for account X.
0 or 1
0-Disabled
1-Enabled
ranges from 1
Account->Basic->
Local Anonymous
The default value is 0.
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.)
account.X.sen
d_anonymous
0 or 1
It configures the phone to send
Account->Basic->
anonymous on/off code to
Send Anonymous
173
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
_code =
activate/deactivate the server-side
(SIP-T28P/T48G
anonymous call feature for account X.
/T46G: X
0-Off Code
ranges from 1
1-On Code
to 6.
Web Setting Path
Code
The default value is 0.
SIP-T26P/T22P/
T42G/T41P: X
ranges from 1
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.)
account.X.ano
nymous_call_o
ncode =
(SIP-T28P/T48G
/T46G: X
It configures the code for activating the
ranges from 1
to 6.
String within
SIP-T26P/T22P/
32
T42G/T41P: X
characters
ranges from 1
server-side anonymous call feature for
account X when the parameter
“account.X.send_anonymous_code” is
set to 1 (On Code).
Account->Basic->
Anonymous Call->
On Code
The default value is blank.
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.)
account.X.ano
nymous_call_o
ffcode =
It configures the code for deactivating
(SIP-T28P/T48G
/T46G: X
ranges from 1
to 6.
SIP-T26P/T22P/
T42G/T41P: X
ranges from 1
to 3.
174
String within
32
characters
the server-side anonymous call feature
for account X when the parameter
“account.X.send_anonymous_code” is
set to 0 (Off Code).
The default value is blank.
Account->Basic->
Anonymous Call->
Off Code
Appendix
Parameter
Permitted
Descriptions
Values
Web Setting Path
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.)
account.X.reje
ct_anonymous
_call =
(SIP-T28P/T48G
/T46G: X
ranges from 1
It enables or disables anonymous call
to 6.
rejection feature for account X.
SIP-T26P/T22P/
0-Disabled
Anonymous Call
T42G/T41P: X
1-Enabled
Rejection
ranges from 1
The default value is 0.
0 or 1
Account->Basic->
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.)
account.X.ano
nymous_reject
_oncode =
(SIP-T28P/T48G
/T46G: X
ranges from 1
to 6.
String within
SIP-T26P/T22P/
32
T42G/T41P: X
characters
ranges from 1
It configures the code for activating the
Account->Basic->
server-side anonymous call rejection
Anonymous Call
feature for account X.
Rejection->On
The default value is blank.
Code
It configures the code for deactivating
Account->Basic->
the server-side anonymous call
Anonymous Call
rejection feature for account X.
Rejection->Off
The default value is blank.
Code
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.)
account.X.ano
nymous_reject
_offcode =
(SIP-T28P/T48G
String within
32
characters
175
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
Web Setting Path
/T46G: X
ranges from 1
to 6.
SIP-T26P/T22P/
T42G/T41P: X
ranges from 1
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.)
account.X.dnd
.enable =
(SIP-T28P/T48G
/T46G: X
ranges from 1
to 6.
It enables or disables DND feature for
SIP-T26P/T22P/
account X when the DND mode is
T42G/T41P: X
configured as Custom.
ranges from 1
0 or 1
to 3.
0-Disabled
1-Enabled
SIP-T21P/T20P:
Features->Forwar
d& DND->DND
->DND Status
The default value is 0.
X ranges from
1 to 2.)
(not
applicable to
SIP-T19P IP
phones)
account.X.dnd
.on_code =
(SIP-T28P/T48G
/T46G: X
ranges from 1
to 6.
SIP-T26P/T22P/
T42G/T41P: X
ranges from 1
to 3.
SIP-T21P/T20P:
176
String within
32
characters
It configures the DND on code for
account X when the DND mode is
configured as Custom.
The default value is blank.
Features->Forwar
d& DND->DND On
Code
Appendix
Parameter
Permitted
Descriptions
Values
Web Setting Path
X ranges from
1 to 2.)
(not
applicable to
SIP-T19P IP
phones)
account.X.dnd
.off_code =
(SIP-T28P/T48G
/T46G: X
ranges from 1
to 6.
SIP-T26P/T22P/
T42G/T41P: X
ranges from 1
to 3.
String within
32
characters
SIP-T21P/T20P:
It configures the DND off code for
account X when the DND mode is
configured as Custom.
The default value is blank.
Features->Forwar
d& DND->DND Off
Code
X ranges from
1 to 2.)
(not
applicable to
SIP-T19P IP
phones)
account.X.alw
ays_fwd.enab
le =
(SIP-T28P/T48G
/T46G: X
It enables or disables always forward
ranges from 1
feature for account X when the call
to 6.
SIP-T26P/T22P/
T42G/T41P: X
ranges from 1
to 3.
SIP-T21P/T20P:
forward mode is configured as
0 or 1
Custom.
0-Disabled
Features->Forwar
d& DND->Always
Forward->On/Off
1-Enabled
The default value is 0.
X ranges from
1 to 2.)
(not
applicable to
177
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
Web Setting Path
SIP-T19P IP
phones)
account.X.alw
ays_fwd.targe
t=
(SIP-T28P/T48G
/T46G: X
ranges from 1
to 6.
SIP-T26P/T22P/
T42G/T41P: X
ranges from 1
to 3.
It configures the target number the
String within
phone forwards all incoming calls to
Features->Forwar
32
for account X when the call forward
d& DND->Always
mode is configured as Custom.
Forward->Target
characters
The default value is blank.
SIP-T21P/T20P:
X ranges from
1 to 2.)
(not
applicable to
SIP-T19P IP
phones)
account.X.bus
y_fwd.enable
=
(SIP-T28P/T48G
/T46G: X
ranges from 1
It enables or disables busy forward
to 6.
forward mode is configured as
T42G/T41P: X
Custom.
ranges from 1
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.)
(not
applicable to
SIP-T19P IP
phones)
178
feature for account X when the call
SIP-T26P/T22P/
0 or 1
0-Disabled
1-Enabled
The default value is 0.
Features->Forwar
d& DND->Busy
Forward->On/Off
Appendix
Parameter
Permitted
Descriptions
Values
Web Setting Path
account.X.bus
y_fwd.target
=
(SIP-T28P/T48G
/T46G: X
ranges from 1
to 6.
SIP-T26P/T22P/
T42G/T41P: X
ranges from 1
to 3.
It configures the target number the
String within
32
characters
phone forwards incoming calls to
when busy for account X when the call
forward mode is configured as
Custom.
Features->Forwar
d& DND->Busy
Forward->Target
The default value is blank.
SIP-T21P/T20P:
X ranges from
1 to 2.)
(not
applicable to
SIP-T19P IP
phones)
account.X.tim
eout_fwd.ena
ble =
(SIP-T28P/T48G
/T46G: X
ranges from 1
It enables or disables no answer
to 6.
forward feature for account X when
SIP-T26P/T22P/
T42G/T41P: X
ranges from 1
0 or 1
the call forward mode is configured as
Features->Forwar
Custom.
d& DND->No
0-Disabled
to 3.
1-Enabled
SIP-T21P/T20P:
Answer Forward->
On/Off
The default value is 0.
X ranges from
1 to 2.)
(not
applicable to
SIP-T19P IP
phones)
account.X.tim
eout_fwd.targ
et =
String within
32
characters
It configures the target number the
Features->Forwar
phone forwards incoming calls to after
d& DND->No
a period of ring time for account X
Answer Forward->
179
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
(SIP-T28P/T48G
when the call forward mode is
/T46G: X
configured as Custom.
ranges from 1
The default value is blank.
Web Setting Path
Target
to 6.
SIP-T26P/T22P/
T42G/T41P: X
ranges from 1
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.)
(not
applicable to
SIP-T19P IP
phones)
account.X.tim
eout_fwd.time
out =
(SIP-T28P/T48G
/T46G: X
ranges from 1
It configures ring times (N) to wait
to 6.
SIP-T26P/T22P/
T42G/T41P: X
Integer from
ranges from 1
0 to 20
to 3.
SIP-T21P/T20P:
before forwarding incoming calls for
Features->Forwar
account X when the call forward mode
d& DND->No
is configured as Custom.
Answer Forward->
Incoming calls are forwarded when
After Ring Time
not answered after N*6 seconds.
(0~120s)
The default value is 2.
X ranges from
1 to 2.)
(not
applicable to
SIP-T19P IP
phones)
account.X.alw
ays_fwd.off_c
ode =
(SIP-T28P/T48G
/T46G: X
ranges from 1
180
It configures the always forward off
String within
32
characters
code for account X when the call
forward mode is configured as
Custom.
The default value is blank.
Features->Forwar
d& DND->Always
Forward ->Off
Code
Appendix
Parameter
Permitted
Descriptions
Values
Web Setting Path
to 6.
SIP-T26P/T22P/
T42G/T41P: X
ranges from 1
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.)
(not
applicable to
SIP-T19P IP
phones)
account.X.alw
ays_fwd.on_c
ode =
(SIP-T28P/T48G
/T46G: X
ranges from 1
to 6.
SIP-T26P/T22P/
T42G/T41P: X
ranges from 1
to 3.
It configures the always forward on
String within
32
characters
code for account X when the call
forward mode is configured as
Custom.
The default value is blank.
SIP-T21P/T20P:
Features->Forwar
d& DND->Always
Forward->On
Code
X ranges from
1 to 2.)
(not
applicable to
SIP-T19P IP
phones)
account.X.bus
y_fwd.off_cod
e=
(SIP-T28P/T48G
/T46G: X
ranges from 1
to 6.
String within
32
characters
It configures the busy forward off code
Features->Forwar
for account X when the call forward
d& DND->Busy
mode is configured as Custom.
Forward ->Off
The default value is blank.
Code
SIP-T26P/T22P/
T42G/T41P: X
181
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
Web Setting Path
ranges from 1
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.)
(not
applicable to
SIP-T19P IP
phones)
account.X.bus
y_fwd.on_cod
e=
(SIP-T28P/T48G
/T46G: X
ranges from 1
to 6.
SIP-T26P/T22P/
T42G/T41P: X
ranges from 1
to 3.
String within
32
characters
It configures the busy forward on code
Features->Forwar
for account X when the call forward
d& DND->Busy
mode is configured as Custom.
Forward->On
The default value is blank.
Code
SIP-T21P/T20P:
X ranges from
1 to 2.)
(not
applicable to
SIP-T19P IP
phones)
account.X.tim
eout_fwd.off_c
ode =
(SIP-T28P/T48G
/T46G: X
ranges from 1
to 6.
SIP-T26P/T22P/
T42G/T41P: X
ranges from 1
to 3.
SIP-T21P/T20P:
182
It configures the no answer forward off
String within
32
characters
code for account X when the call
forward mode is configured as
Custom.
The default value is blank.
Features->Forwar
d& DND->No
Answer Forward
->Off Code
Appendix
Parameter
Permitted
Descriptions
Values
Web Setting Path
X ranges from
1 to 2.)
(not
applicable to
SIP-T19P IP
phones)
account.X.tim
eout_fwd.on_c
ode =
(SIP-T28P/T48G
/T46G: X
ranges from 1
to 6.
SIP-T26P/T22P/
T42G/T41P: X
ranges from 1
to 3.
It configures the no answer forward on
String within
32
characters
code for account X when the call
forward mode is configured as
Custom.
The default value is blank.
SIP-T21P/T20P:
Features->Forwar
d& DND->No
Answer Forward
->On Code
X ranges from
1 to 2.)
(not
applicable to
SIP-T19P IP
phones)
account.X.sip_
listen_port =
(SIP-T28P/T48G
/T46G: X
ranges from 1
to 6.
SIP-T26P/T22P/
T42G/T41P: X
ranges from 1
Integer from
1024 to
65535
It configures the local SIP port for
Account->
account X.
Advanced->Local
The default value is 5060.
SIP Port
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.)
183
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
Web Setting Path
account.X.100
rel_enable =
(SIP-T28P/T48G
/T46G: X
ranges from 1
It enables or disables the 100 reliable
to 6.
SIP-T26P/T22P/
T42G/T41P: X
retransmission feature for account X.
0 or 1
ranges from 1
Account->
0-Disabled
Advanced->
1-Enabled
Retransmission
The default value is 0.
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.)
account.X.sub
scribe_mwi =
(SIP-T28P/T48G
/T46G: X
ranges from 1
It enables or disables the phone to
to 6.
subscribe the message waiting
SIP-T26P/T22P/
T42G/T41P: X
indicator for account X.
0 or 1
ranges from 1
0-Disabled
1-Enabled
to 3.
Account->
Advanced->
Subscribe for MWI
The default value is 0.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.)
account.X.sub
scribe_mwi_e
xpires =
(SIP-T28P/T48G
/T46G: X
ranges from 1
to 6.
SIP-T26P/T22P/
T42G/T41P: X
ranges from 1
to 3.
184
Integer from
0 to 84600
It configures the interval (in seconds)
of MWI subscription for account X.
The default value is 3600.
Account->
Advanced->MWI
Subscription Period
(Seconds)
Appendix
Parameter
Permitted
Descriptions
Values
Web Setting Path
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.)
account.X.cid_
source =
It configures the source caller identity
(SIP-T28P/T48G
for presentation when receiving an
/T46G: X
incoming call for account X.
ranges from 1
0-FROM
to 6.
SIP-T26P/T22P/
0, 1, 2, 3, 4 or
T42G/T41P: X
5
ranges from 1
1-PAI
2-PAI-FROM
3-PRID-PAI-FROM
to 3.
Account->
Advanced->Caller
ID Source
4-PAI-RPID-FROM,
SIP-T21P/T20P:
5-RPID-FROM
X ranges from
The default value is 0.
1 to 2.
SIP-T19P: X=1.)
account.X.cid_
source_privac
y=
(SIP-T28P/T48G
/T46G: X
It enables or disables the phone to
ranges from 1
deal with PRIVACY header field in the
to 6.
SIP-T26P/T22P/
180 or 200 OK message for account X.
0 or 1
T42G/T41P: X
0-Disabled
1-Enabled
ranges from 1
The default value is 1.
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.)
account.X.cid_
It enables or disables the phone to
source_ppi =
(SIP-T28P/T48G
process the P-Preferred-Identity header
0 or 1
for caller identity presentation when
/T46G: X
receiving an incoming call for account
ranges from 1
X.
185
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
to 6.
0-Disabled
SIP-T26P/T22P/
1-Enabled
T42G/T41P: X
The default value is 1.
Web Setting Path
ranges from 1
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.)
account.X.cp_
source =
(SIP-T28P/T48G
/T46G: X
ranges from 1
It configures the source callee identity
to 6.
for presentation for account X.
SIP-T26P/T22P/
T42G/T41P: X
0, 1 or 2
ranges from 1
0-PAI-RPID
1-Dialed Digits
2-RFC4916
to 3.
The default value is 0.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.)
account.X.ses
sion_timer.ena
ble =
(SIP-T28P/T48G
/T46G: X
ranges from 1
It enables or disables the session timer
to 6.
for account X.
0-Disabled
Advanced->
T42G/T41P: X
1-Enabled
Session Timer
ranges from 1
The default value is 0.
SIP-T26P/T22P/
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.)
186
Account->
0 or 1
Appendix
Parameter
Permitted
Descriptions
Values
Web Setting Path
account.X.ses
sion_timer.exp
ires =
(SIP-T28P/T48G
/T46G: X
ranges from 1
to 6.
SIP-T26P/T22P/
T42G/T41P: X
Integer from
30 to 7200
ranges from 1
It configures the interval (in seconds)
Account->
for refreshing the SIP session for
Advanced->
account X.
Session Expires
The default value is 1800.
(30~7200s)
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.)
account.X.ses
sion_timer.refr
esher =
(SIP-T28P/T48G
/T46G: X
ranges from 1
It configures the refresher of the
to 6.
session timer for account X.
SIP-T26P/T22P/
0-Uac
Advanced->
T42G/T41P: X
1-Uas
Session Refresher
ranges from 1
The default value is 0.
0 or 1
Account->
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.)
account.X.ena
ble_user_equ
It enables or disables the
al_phone =
"user=phone" carried in the INVITE
(SIP-T28P/T48G
/T46G: X
ranges from 1
to 6.
SIP-T26P/T22P/
message for account X.
0 or 1
0-Disabled
1-Enabled
Account->
Advanced->Send
user=phone
The default value is 0.
T42G/T41P: X
187
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
Web Setting Path
ranges from 1
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.)
account.X.srtp
_encryption =
(SIP-T28P/T48G
/T46G: X
ranges from 1
It configures whether to use voice
to 6.
encryption service for account X.
SIP-T26P/T22P/
0-Disabled
T42G/T41P: X
0, 1 or 2
ranges from 1
1-Optional
2-Compulsory
to 3.
Account->
Advanced->RTP
Encryption (SRTP)
The default value is 0.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.)
account.X.pti
me =
(SIP-T28P/T48G
/T46G: X
ranges from 1
to 6.
SIP-T26P/T22P/
T42G/T41P: X
ranges from 1
It configures the RTP packet time for
Account->
account X.
Advanced->PTime
40, 50 or 60
The default value is 20.
(ms)
String within
It configures the BLA number for
Account->
account X.
Advanced->BLA
The default value is blank.
Number
0 (Disabled),
10, 20, 30,
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.)
account.X.bla
_number =
(SIP-T28P/T48G
/T46G: X
188
99
characters
Appendix
Parameter
Permitted
Descriptions
Values
Web Setting Path
ranges from 1
to 6.
SIP-T26P/T22P/
T42G/T41P: X
ranges from 1
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.)
account.X.bla
_subscribe_pe
riod =
(SIP-T28P/T48G
/T46G: X
ranges from 1
to 6.
SIP-T26P/T22P/
T42G/T41P: X
Integer from
60 to 7200
It configures the period (in seconds) of
Account->
BLA subscription for account X.
Advanced->BLA
The default value is 300.
Subscription Period
ranges from 1
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.)
account.X.regi
ster_mac =
(SIP-T28P/T48G
/T46G: X
ranges from 1
It enables or disables the phone to
to 6.
carry the MAC address in the
SIP-T26P/T22P/
T42G/T41P: X
ranges from 1
to 3.
REGISTER message for account X.
0 or 1
0-Disabled
1-Enabled
Account->
Advanced->SIP
Send MAC
The default value is 0.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.)
189
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
Web Setting Path
account.X.regi
ster_line =
(SIP-T28P/T48G
/T46G: X
ranges from 1
It enables or disables the phone to
to 6.
carry the line number in the REGISTER
SIP-T26P/T22P/
T42G/T41P: X
message for account X.
0 or 1
ranges from 1
0-Disabled
1-Enabled
to 3.
Account->
Advanced->SIP
Send Line
The default value is 0.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.)
account.X.dial
oginfo_callpic
kup =
(SIP-T28P/T48G
/T46G: X
ranges from 1
It enables or disables the phone to
to 6.
pick up a call according to the SIP
SIP-T26P/T22P/
T42G/T41P: X
header of dialog-info for account X.
0 or 1
Account->
Advanced->
0-Disabled
Dialog Info Call
to 3.
1-Enabled
Pickup
SIP-T21P/T20P:
The default value is 0.
ranges from 1
X ranges from
1 to 2.)
(not
applicable to
SIP-T19P IP
phones)
account.X.gro
up_pickup_co
de =
(SIP-T28P/T48G
/T46G: X
ranges from 1
to 6.
190
String within
32
characters
It configures the group pickup code for
Account->
account X.
Advanced->Group
The default value is blank.
Call Pickup Code
Appendix
Parameter
Permitted
Descriptions
Values
Web Setting Path
SIP-T26P/T22P/
T42G/T41P: X
ranges from 1
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.)
account.X.dire
ct_pickup_cod
e=
(SIP-T28P/T48G
/T46G: X
ranges from 1
to 6.
String within
SIP-T26P/T22P/
32
T42G/T41P: X
characters
It configures the directed pickup code
for account X.
The default value is blank.
ranges from 1
Account->
Advanced->
Directed Call
Pickup Code
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.)
account.X.aut
o_answer =
(SIP-T28P/T48G
/T46G: X
ranges from 1
It enables or disables auto answer
to 6.
SIP-T26P/T22P/
T42G/T41P: X
ranges from 1
to 3.
feature for account X.
0 or 1
0-Disabled
1-Enabled
Account->Basic->
Auto Answer
The default value is 0.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.)
191
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
Web Setting Path
It configures the delay time (in
features.auto_
answer_delay
=
Integer from
1 to 4
seconds) before the phone
automatically answers an incoming
call.
The default value is 1.
account.X.mis
sed_calllog =
(SIP-T28P/T48G
/T46G: X
ranges from 1
It enables or disables the phone to
to 6.
SIP-T26P/T22P/
T42G/T41P: X
record the missed call of account X.
0 or 1
0-Disabled
1-Enabled
ranges from 1
Account->Basic->
Missed Call Log
The default value is 1.
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.)
account.X.sub
scribe_mwi_to
_vm =
(SIP-T28P/T48G
/T46G: X
It enables or disables the phone to
ranges from 1
subscribe to the voice mail number for
to 6.
the message waiting indicator for
Account->
account X.
Advanced->
SIP-T26P/T22P/
0 or 1
T42G/T41P: X
0-Disabled
ranges from 1
1-Enabled
to 3.
Subscribe MWI To
Voice Mail
The default value is 0.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.)
account.X.reg
It configures the interval (in seconds)
Account->
_fail_retry_inte
for the phone to retry to register
Advanced->SIP
account X when registration fails.
Registration Retry
The default value is 30.
Timer (0~1800s)
rval =
(SIP-T28P/T48G
192
Integer from
0 to 1800
Appendix
Parameter
Permitted
Descriptions
Values
Web Setting Path
/T46G: X
ranges from 1
to 6.
SIP-T26P/T22P/
T42G/T41P: X
ranges from 1
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.)
account.X.con
f_type =
(SIP-T28P/T48G
/T46G: X
ranges from 1
It configures the conference type for
to 6.
SIP-T26P/T22P/
T42G/T41P: X
account X.
0 or 2
ranges from 1
Account->
0-Local Conference
Advanced->
2-Network Conference
Conference Type
The default value is 0.
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.)
account.X.con
f_uri =
(SIP-T28P/T48G
/T46G: X
ranges from 1
to 6.
SIP-T26P/T22P/
T42G/T41P: X
ranges from 1
It configures the network conference
Account->
within 511
URI for account X.
Advanced->
characters
The default value is blank.
Conference URI
SIP URI
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.)
193
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
Web Setting Path
account.X.blf.s
ubscribe_peri
od =
(SIP-T28P/T48G
/T46G: X
ranges from 1
to 6.
Integer from
SIP-T26P/T22P/
30 to
T42G/T41P: X
2147483647
It configures the period (in seconds) of
the BLF subscription for account X.
The default value is 1800.
ranges from 1
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.)
account.X.blf.s
ubscribe_even
t=
(SIP-T28P/T48G
/T46G: X
ranges from 1
It configures the event of the BLF
to 6.
subscription for account X.
SIP-T26P/T22P/
0 or 1
0-Dialog
T42G/T41P: X
1-Presence
ranges from 1
The default value is 0.
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.)
account.X.sip_
It configures the SIP server type for
server_type =
account X.
(SIP-T28P/T48G
0-Default
/T46G: X
2-BroadSoft
Advanced->SIP
to 6.
4-Cosmocom
Server Type
SIP-T26P/T22P/
6-UCAP
T42G/T41P: X
The default value is 0.
ranges from 1
ranges from 1
194
Account->
0, 2, 4 or 6
Appendix
Parameter
Permitted
Descriptions
Values
Web Setting Path
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.)
account.X.mus
ic_server_uri
=
(SIP-T28P/T48G
/T46G: X
ranges from 1
to 6.
SIP URI
It configures the URI of the Music On
Account->
Advanced->Music
Server URI
SIP-T26P/T22P/
within 256
Hold server for account X.
T42G/T41P: X
characters
The default value is blank.
ranges from 1
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.)
account.X.dtm
f.type =
(SIP-T28P/T48G
/T46G: X
It configures the DTMF type for account
ranges from 1
X.
to 6.
SIP-T26P/T22P/
T42G/T41P: X
0-INBAND
0, 1, 2 or 3
ranges from 1
Account->
1-RFC2833
Advanced->DTMF
2-SIP INFO
Type
to 3.
3-AUTO or SIP INFO
SIP-T21P/T20P:
The default value is 1.
X ranges from
1 to 2.
SIP-T19P: X=1.)
account.X.dtm
f.dtmf_payloa
d=
(SIP-T28P/T48G
Integer from
96 to 127
It configures the RFC2833 payload for
account X.
The default value is 101.
Account->
Advanced->DTMF
Payload Type
(96~127)
195
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
Web Setting Path
/T46G: X
ranges from 1
to 6.
SIP-T26P/T22P/
T42G/T41P: X
ranges from 1
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.)
account.X.dtm
f.info_type =
(SIP-T28P/T48G
It configures the DTMF info type when
/T46G: X
the DTMF type is configured as “SIP
ranges from 1
INFO”, “AUTO or SIP INFO” for account
to 6.
X.
SIP-T26P/T22P/
0-Disabled
T42G/T41P: X
1, 2 or 3
1-DTMF-Relay
ranges from 1
Account->
Advanced->DTMF
Info Type
2-DTMF
to 3.
3-Telephone-Event
SIP-T21P/T20P:
The default value is 0.
X ranges from
1 to 2.
SIP-T19P: X=1.)
account.X.nat.
nat_traversal
=
(SIP-T28P/T48G
/T46G: X
It enables or disables the NAT
ranges from 1
to 6.
SIP-T26P/T22P/
T42G/T41P: X
ranges from 1
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
196
traversal for account X.
0 or 1
0-Disabled
1-Enabled
The default value is 0.
Account->Register
->NAT
Appendix
Parameter
Permitted
Descriptions
Values
Web Setting Path
SIP-T19P: X=1.)
account.X.nat.
stun_server =
(SIP-T28P/T48G
/T46G: X
ranges from 1
to 6.
SIP-T26P/T22P/
T42G/T41P: X
ranges from 1
IP address
It configures the IP address or domain
or domain
name of the STUN server for account X.
name
The default value is blank.
Account->Register
->STUN Server
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.)
account.X.nat.
stun_port =
(SIP-T28P/T48G
/T46G: X
ranges from 1
to 6.
SIP-T26P/T22P/
T42G/T41P: X
ranges from 1
Integer from
1024 to
65000
It configures the port of the STUN
Account->Register
server for account X.
->STUN Server
The default value is 3478.
->Port
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.)
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
open so that NAT can continue to
Account->
function for account X.
Advanced->Keep
ranges from 1
0-Dsiabled
Alive Type
to 6.
1-Default: the phone sends UDP
SIP-T26P/T22P/
packets to the server.
T42G/T41P: X
2-Option: the phone sends SIP OPTION
(SIP-T28P/T48G
/T46G: X
0, 1, 2 or 3
197
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
ranges from 1
packets to the server.
to 3.
3-Notify: the phone sends SIP NOTIFY
SIP-T21P/T20P:
packets to the server.
X ranges from
The default value is 1.
Web Setting Path
1 to 2.
SIP-T19P: X=1.)
account.X.nat.
udp_update_ti
me =
(SIP-T28P/T48G
/T46G: X
ranges from 1
to 6.
Integer from
It configures the keep-alive interval (in
SIP-T26P/T22P/
15 to
seconds) for account X.
T42G/T41P: X
2147483647
The default value is 30.
ranges from 1
Account->
Advanced->Keep
Alive Interval
(Seconds)
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.)
account.X.nat.
rport =
(SIP-T28P/T48G
/T46G: X
ranges from 1
It enables or disables NAT Rport
to 6.
SIP-T26P/T22P/
T42G/T41P: X
feature for account X.
0 or 1
0-Disabled
1-Enabled
ranges from 1
Account->
Advanced->RPort
The default value is 0.
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.)
account.X.adv
anced.timer_t
1=
198
Float from
0.5~10s
It configures the session timer T1 (in
Account->
seconds) for account X.
Advanced->SIP
The default value is 0.5.
Session Timer T1
Appendix
Parameter
Permitted
Values
Descriptions
Web Setting Path
(0.5~10s)
(SIP-T28P/T48G
/T46G: X
ranges from 1
to 6.
SIP-T26P/T22P/
T42G/T41P: X
ranges from 1
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.)
account.X.adv
anced.timer_t
2=
(SIP-T28P/T48G
/T46G: X
ranges from 1
to 6.
SIP-T26P/T22P/
T42G/T41P: X
Float from
2~40s
It configures the session timer T2 (in
seconds) for account X.
The default value is 4.
ranges from 1
Account->
Advanced->SIP
Session Timer T2
(2~40s)
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.)
account.X.adv
anced.timer_t
4=
(SIP-T28P/T48G
/T46G: X
ranges from 1
to 6.
SIP-T26P/T22P/
Float from
2.5~60s
It configures the session timer T4 (in
seconds) for account X.
The default value is 5.
Account->
Advanced->SIP
Session Timer T4
(2.5~60s)
T42G/T41P: X
ranges from 1
to 3.
SIP-T21P/T20P:
199
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
Web Setting Path
X ranges from
1 to 2.
SIP-T19P: X=1.)
account.X.aler
t_info_url_ena
ble =
(SIP-T28P/T48G
/T46G: X
It enables or disables the IP phone to
ranges from 1
download the ring tone from the URL
to 6.
contained in the Alert-Info header
Account->
for account X.
Advanced->
SIP-T26P/T22P/
0 or 1
T42G/T41P: X
0-Disabled
ranges from 1
1-Enabled
to 3.
Distinctive Ring
Tones
The default value is 0.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.)
It enables and disables the phone to
map the keywords in the Alert-Info
header to the specified Bellcore ring
features.alert_
info_tone =
0 or 1
tones.
0-Disabled
1-Enabled
The default value is 0.
account.X.ring
tone.ring_type
=
(SIP-T28P/T48G
/T46G: X
ranges from 1
to 6.
SIP-T26P/T22P/
Common,
account.1.ringtone.ring_type =
Ring2.wav,
Ring3.wav means configuring
Ring3.wav
Ring3.wav for account1.
Ring4.wav
account.1.ringtone.ring_type =
Account->Basic->
Common means account1 will use the
Ring Type
Ring5.wav
Ring6.wav,
ranges from 1
Ring7.wav,
SIP-T21P/T20P:
X ranges from
Example:
Ring1.wav,
T42G/T41P: X
to 3.
200
It configures a ring tone for account X.
Ring8.wav
ring tone selected for the phone.
The default value is Common.
Note: Ring tones 6-8 are only
applicable to SIP-T48G/T46G IP
phones.
Appendix
Parameter
Permitted
Descriptions
Values
Web Setting Path
1 to 2.
SIP-T19P: X=1.)
It configures the codec for account X.
Codecs G726-16, G726-24 and
G726-40 are not applicable to SIP-T21P
and SIP-T19P IP phones.
Codec GSM is only applicable to
SIP-T4X IP phones.
account.X.cod
For SIP-T28P/T26P/T22P/T20P/T4X IP
ec.Y.payload_
phones:
type =
When Y=1, the default value is PCMU;
(SIP-T28P/T48G
When Y=2, the default value is PCMA;
/T46G: X
When Y=3, the default value is
ranges from 1
to 6.
PCMU
SIP-T26P/T22P/
PCMA
T42G/T41P: X
G729
ranges from 1
G722
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.
SIP-T28P/T26P/T
22P/T20P: Y
G723_53
G723_63
G726-16
G726-24
G726-32
G726-40
G723_53;
When Y=4, the default value is
G723_63;
When Y=5, the default value is G729;
When Y=6, the default value is G722;
When Y=7, the default value is iLBC;
When Y=8, the default value is
G726-16;
When Y=9, the default value is
G726-24;
When Y=10, the default value is
ranges from 1
iLBC
G726-32;
to 11.
GSM
When Y=11, the default value is
SIP-T21P/T19P:
Y ranges from
1 to 8.
SIP-T4X: Y
ranges from 1
to 12)
Account->Codec
G726-40.
When Y=12, the default value is GSM.
For SIP-T21P/T19P IP phones:
When Y=1, the default value is PCMU;
When Y=2, the default value is PCMA;
When Y=3, the default value is
G723_53;
When Y=4, the default value is
G723_63;
When Y=5, the default value is G729;
When Y=6, the default value is G722;
201
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
Web Setting Path
When Y=7, the default value is iLBC;
When Y=8, the default value is
G726-32.
It enables or disables the specified
codec for account X.
0-Disabled
1-Enabled
Example:
account.X.cod
account.1.codec.1.enable =1
ec.Y.enable =
This means that the codec PCMU is
(SIP-T28P/T48G
enabled on the phone.
/T46G: X
For SIP-T28P/T26P/T22P/T20P/T4X IP
ranges from 1
phones:
to 6.
When Y=1, the default value is 1;
SIP-T26P/T22P/
When Y=2, the default value is 1;
T42G/T41P: X
When Y=3, the default value is 0;
ranges from 1
When Y=4, the default value is 0;
to 3.
When Y=5, the default value is 1;
SIP-T21P/T20P:
X ranges from
1 to 2.
When Y=6, the default value is 1;
0 or 1
When Y=7, the default value is 0;
SIP-T19P: X=1.
When Y=8, the default value is 0;
SIP-T28P/T26P/T
When Y=9, the default value is 0;
22P/T20P: Y
When Y=10, the default value is 0;
ranges from 1
to 11.
SIP-T21P/T19P:
Y ranges from
1 to 8.
SIP-T4X: Y
When Y=11, the default value is 0.
When Y=12, the default value is 0 (only
applicable to SIP-T4X IP phones).
For SIP-T21P/T19P IP phones:
When Y=1, the default value is 1;
ranges from 1
When Y=2, the default value is 1;
to 12)
When Y=3, the default value is 0;
When Y=4, the default value is 0;
When Y=5, the default value is 1;
When Y=6, the default value is 1;
When Y=7, the default value is 0;
When Y=8, the default value is 0.
202
Account->Codec
Appendix
Parameter
Permitted
Descriptions
Values
Web Setting Path
It configures the priority of the enabled
codec for account X.
Example:
account.1.codec.1.priority =1
account.X.cod
For SIP-T28P/T26P/T22P/T20P/T4X IP
ec.Y.priority =
phones:
(SIP-T28P/T48G
/T46G: X
When Y=1, the default value is 1;
ranges from 1
When Y=2, the default value is 2;
to 6.
SIP-T26P/T22P/
T42G/T41P: X
ranges from 1
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.
SIP-T28P/T26P/T
22P/T20P: Y
ranges from 1
to 11.
Integer from
0 to 11 for
When Y=3, the default value is 0;
When Y=4, the default value is 0;
SIP-T4X IP
When Y=5, the default value is 3;
phones
When Y=6, the default value is 4;
Integer from
When Y=7, the default value is 0;
0 to 10 for
SIP-T20P/T22P
/T26P/T28P
IP phones
Integer from
0 to 7 for
SIP-T19P/T21P
IP phones
SIP-T21P/T19P:
When Y=8, the default value is 0;
When Y=9, the default value is 0;
Account->Codec
When Y=10, the default value is 0;
When Y=11, the default value is 0.
When Y=12, the default value is 0.
(only applicable to SIP-T4X IP phones)
For SIP-T21P/T19P IP phones:
When Y=1, the default value is 1;
Y ranges from
When Y=2, the default value is 2;
1 to 8.
When Y=3, the default value is 0;
SIP-T4X: Y
ranges from 1
When Y=4, the default value is 0;
to 12)
When Y=5, the default value is 3;
When Y=6, the default value is 4;
When Y=7, the default value is 0;
When Y=8, the default value is 0.
account.X.cod
It configures rtpmap of the audio
ec.Y.rtpmap =
codec for account X.
(SIP-T28P/T48G
/T46G: X
ranges from 1
to 6.
SIP-T26P/T22P/
T42G/T41P: X
Integer
from 0 to 127
Example:
account.1.codec.1.rtpmap = 0
For SIP-T28P/T26P/T22P/T20P/T4X IP
phones:
When Y=1, the default value is 0;
203
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
ranges from 1
When Y=2, the default value is 8;
to 3.
When Y=3, the default value is 4;
SIP-T21P/T20P:
When Y=4, the default value is 4;
X ranges from
Web Setting Path
When Y=5, the default value is 18;
1 to 2.
When Y=6, the default value is 9;
SIP-T19P: X=1.
When Y=7, the default value is 106;
SIP-T28P/T26P/T
When Y=8, the default value is 103;
22P/T20P: Y
ranges from 1
When Y=9, the default value is 104;
to 11.
When Y=10, the default value is 102;
SIP-T21P/T19P:
When Y=11, the default value is 105.
Y ranges from
When Y=12, the default value is 97.
1 to 8.
(only applicable to SIP-T4X IP phones)
SIP-T4X: Y
For SIP-T21P/T19P IP phones:
ranges from 1
When Y=1, the default value is 0;
to 12)
When Y=2, the default value is 8;
When Y=3, the default value is 4;
When Y=4, the default value is 4;
When Y=5, the default value is 18;
When Y=6, the default value is 9;
When Y=7, the default value is 106;
When Y=8, the default value is 102.
account.X.unr
egister_on_re
boot =
(SIP-T28P/T48G
/T46G: X
ranges from 1
It enables or disables the phone to
to 6.
un-register account X before a reboot.
SIP-T26P/T22P/
0-Disabled
T42G/T41P: X
1-Enabled
ranges from 1
The default value is 0.
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.)
204
0 or 1
Account->
Advanced->
Unregister When
Reboot
Appendix
Parameter
Permitted
Descriptions
Values
Web Setting Path
account.X.pict
ure_info_enab
It enables or disables the phone to
le =
download the picture information for
account X when receiving an incoming
(X ranges
from 1 to 6)
0 or 1
call or during a call.
0-Disabled
(only
applicable to
1-Enabled
SIP-T48G/T46G
The default value is 0.
IP phones)
account.X.co
mpact_heade
r_enable =
(SIP-T28P/T48G
/T46G: X
It enables or disables the phone to
ranges from 1
support compact SIP header for
to 6.
SIP-T26P/T22P/
account X.
0 or 1
T42G/T41P: X
0-Disabled
1-Enabled
ranges from 1
The default value is 0.
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.)
account.X.mus
ic_on_hold_ty
pe =
(SIP-T28P/T48G
It configures the way on how the
/T46G: X
phone processes Music On Hold when
ranges from 1
placing an active call on hold for
to 6.
account X.
SIP-T26P/T22P/
0 or 1
0-Calling the music server before
T42G/T41P: X
holding
ranges from 1
1-Calling the music server after
to 3.
holding
SIP-T21P/T20P:
The default value is 0.
X ranges from
1 to 2.
SIP-T19P: X=1.)
205
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
Web Setting Path
account.X.acd
.enable =
(SIP-T28P: X
ranges from 1
to 6.
SIP-T26P/T22P/
T42G/T41P: X
It enables or disables ACD feature for
ranges from 1
account X.
to 3.
0 or 1
0-Disabled
SIP-T21P/T20P:
1-Enabled
X ranges from
The default value is 0.
1 to 2.
SIP-T19P: X=1.)
(not
applicable to
SIP-T48G/T46G
)
account.X.acd
.available =
(SIP-T28P: X
ranges from 1
to 6.
SIP-T26P/T22P/
It enables or disables the phone to
T42G/T41P: X
display the available and unavailable
ranges from 1
soft keys for account X after the phone
to 3.
0 or 1
logs into the ACD system.
SIP-T21P/T20P:
0-Disabled
X ranges from
1-Enabled
1 to 2.
The default value is 0.
SIP-T19P: X=1.)
(not
applicable to
SIP-T48G/T46G
)
account.X.sub
scribe_acd_ex
pires =
(SIP-T28P: X
ranges from 1
206
Integer from
120 to 3600
It configures the period (in seconds) of
ACD subscription for account X.
The default value is 1800.
Account->
Advanced->ACD
Subscrip Period
(120~3600s)
Appendix
Parameter
Permitted
Values
Descriptions
Web Setting Path
to 6.
SIP-T26P/T22P/
T42G/T41P: X
ranges from 1
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.)
(not
applicable to
SIP-T48G/T46G
)
207
Yealink IP Phones Auto provisioning Guide
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.
Parameter
Permitted
Descriptions
Values
Web Setting Path
It enables or disables BroadSoft
features for IP phones.
0-Disabled
bw.enable =
0 or 1
1-Enabled
The default value is 0.
It takes effect after a reboot.
features.uc_en
It enables or disables UC feature.
able =
0-Disabled
(only
applicable to
0 or 1
1-Enabled
SIP-T48G/
The default value is 1.
T46G IP
It takes effect after a reboot.
phones)
features.uc_us
ername =
(only
applicable to
SIP-T48G/
String within
99
characters
T46G IP
Configures the user name for UC
Directory->
authentication.
Network
The default value is blank.
Directory->UC
It takes effect after a reboot.
Username
It configures the password for UC
Directory->
authentication.
Network
The default value is blank.
Directory->UC
It takes effect after a reboot.
Password
phones)
features.uc_p
assword =
(only
applicable to
SIP-T48G/
String within
32
characters
T46G IP
phones)
features.confi
It enables or disables extended length
g_dsskey_len
of the label displayed on the idle LCD
gth =
(only
applicable to
SIP-T46G IP
phones)
208
screen for the line key.
0 or 1
0-Disabled
1-Enabled
The default value is 0.
Appendix
Parameter
Permitted
Descriptions
Values
Web Setting Path
It enables or disables Auto Favorite
feature.
phone_setting
If enabled, the IP phone will download
.dsskey_direct
information of favorites from the cloud
ory_auto.ena
server and automatically configure UC
ble =
(only
0 or 1
Favorite keys from the first unused line
key (the line key is configured as N/A).
applicable to
If a line key is used, the IP phone will
SIP-T48G/
skip to the next unused line key.
T46G IP
Features->General
Information->Auto
Favorite
0-Disabled
phones)
1-Enabled
The default value is 1.
It configures the IP address or domain
name of the Xtended Services Platform
account.X.xsi.
IP address
host =
or domain
(X=1)
name
server for account X.
Example:
account.1.xsi.host =
xsp1.iop1.broadworks.net
Directory->
Network
Directory->Host
Server
The default value is blank.
It configures the port of the Xtended
account.X.xsi.
port =
(X=1)
Services Platform server for account X.
Integer from
1 to 65535
Directory->
Example:
Network
account.1.xsi.port = 80
Directory->Port
The default value is 80.
It configures the access protocol of the
account.X.xsi.
server_type =
(X=1)
Xtended Services Platform server for
“http” or
“https”
account X.
Directory->
Network
Example:
Directory->XSI
account.1.xsi.server_type = http
Server Type
The default value is http.
It configures the user name for XSI
authentication for account X.
account.X.xsi.
user =
(X=1)
String within
99
characters
Example:
account.1.xsi.user =
3502@as.iop1.broadworks.net
Directory->
Network
Directory->User ID
The default value is blank.
209
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
Web Setting Path
It configures the password for XSI
account.X.xsi.
password =
(X=1)
String within
99
characters
authentication for account X.
Example:
account.1.xsi.password = 123456
Directory->
Network
Directory->
Password
The default value is blank.
bw_phoneboo
k.group_enabl
It enables or disables the phone to
e=
display the group directory.
Directory->
0-Disabled
Network
applicable to
1-Enabled
Directory->Group
SIP-T20P IP
The default value is 1.
(not
0 or 1
phones)
bw_phoneboo
k.group_displ
ayname =
(not
applicable to
String within
99
characters
It configures the display name on the
Directory->
LCD screen for the group directory.
Network
The default value is Group.
Directory->Group
SIP-T20P IP
phones)
bw_phoneboo
k.enterprise_e
It enables or disables the phone to
nable =
display the enterprise directory.
(not
0 or 1
0-Disabled
applicable to
1-Enabled
SIP-T20P IP
The default value is 1.
Directory->
Network
Directory->Enterpri
se
phones)
bw_phoneboo
k.enterprise_d
isplayname =
(not
applicable to
String within
99
characters
It configures the display name on the
LCD screen for the enterprise directory.
The default value is Enterprise.
SIP-T20P IP
Directory->
Network
Directory->Enterpri
se
phones)
bw_phoneboo
k.group_com
mon_enable
=
(not
210
0 or 1
It enables or disables the phone to
Directory->
display the group common directory.
Network
0-Disabled
Directory->Group
1-Enabled
Common
Appendix
Parameter
Permitted
Descriptions
Values
Web Setting Path
The default value is 1.
applicable to
SIP-T20P IP
phones)
bw_phoneboo
k.group_com
mon_displayn
ame =
(not
applicable to
String within
99
characters
It configures the display name on the
Directory->
LCD screen for the group common
Network
directory.
Directory->Group
The default value is GroupCommon.
Common
SIP-T20P IP
phones)
bw_phoneboo
k.enterprise_c
It enables or disables the phone to
ommon_enabl
display the enterprise common
e=
directory.
0 or 1
Directory->
Network
0-Disabled
Directory->Enterpri
applicable to
1-Enabled
se Common
SIP-T20P IP
The default value is 1.
(not
phones)
bw_phoneboo
k.enterprise_c
ommon_displ
ayname =
(not
applicable to
It configures the display name on the
String within
99
characters
LCD screen for the enterprise common
directory.
The default value is
EnterpriseCommon.
SIP-T20P IP
Directory->
Network
Directory->Enterpri
se Common
phones)
bw_phoneboo
k.personal_en
It enables or disables the phone to
able=
display the personal directory.
(not
0 or 1
0-Disabled
applicable to
1-Enabled
SIP-T20P IP
The default value is 1.
Directory->
Network
Directory->Person
al
phones)
bw_phoneboo
k.personal_dis
playname=
(not
String within
It configures the display name on the
99
LCD screen for the personal directory.
characters
The default value is Personal.
Directory->
Network
Directory->Person
al
applicable to
211
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
Web Setting Path
SIP-T20P IP
phones)
bw_phoneboo
It enables or disables custom directory
k.custom =
(not
applicable to
feature.
0 or 1
0-Disabled
1-Enabled
SIP-T20P IP
Directory->
Network
Directory->Enable
Custom Directory
The default value is 0.
phones)
directory.upd
ate_time_inter
val =
(not
applicable to
It configures the interval (in minutes)
Integer from
2 to 43200
for the phone to update the data of the
BroadSoft directory from the BroadSoft
server.
The default value is 60.
SIP-T20P IP
phones)
bw_phoneboo
k.call_log_ena
It enables or disables BroadSoft call
ble =
log feature.
(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=
(not
applicable to
display the Park soft key during a call.
0 or 1
1-Enabled
SIP-T20P IP
call_park.grou
It enables or disables the phone to
p_enable=
display the GPark soft key during a
(not
applicable to
call.
0 or 1
0-Disabled
SIP-T20P IP
1-Enabled
phones)
The default value is 0.
call_park.park
_visual_notify_
enable =
(not
Features->Call
Pickup->Call Park
The default value is 0.
phones)
212
0-Disabled
It enables or disables the phone to
0 or 1
display a parked indicator when a call
is parked against its line.
Features->Call
Pickup->Group
Call Park
Features->Call
Pickup->Visual
Alert for Parked
Call
Appendix
Parameter
Permitted
Descriptions
Values
applicable to
0-Disabled
SIP-T20P IP
1-Enabled
phones)
The default value is 0.
call_park.park
It enables or disables the phone to
_ring=
play a warning tone when a call is
(not
Web Setting Path
parked against its line.
0 or 1
Features->Call
Pickup->Audio
0-Disabled
Alert for Parked
SIP-T20P IP
1-Enabled
Call
phones)
The default value is 0.
applicable to
It enables or disables feature key
synchronization.
bw.feature_ke
y_sync =
0 or 1
0-Disabled
1-Enabled
Features->General
Information->
Feature Key
Synchronization
The default value is 0.
account.X.blf.
blf_list_uri =
(SIP-T28P/T48G
/T46G: X
ranges from 1
to 6.
SIP-T26P/T22P/
T42G/T41P: X
SIP URI
It configures the BLF List URI to monitor
Account->
Advanced->BLF
List URI
ranges from 1
within 256
a list of users for account X.
to 3.
characters
The default value is blank.
SIP-T21P/T20P:
X ranges from
1 to 2.)
(not
applicable to
SIP-T19P IP
phones)
account.X.blf_l
ist_code =
(SIP-T28P/T48G
/T46G: X
ranges from 1
String within
32
characters
It configures the feature access code
for directed call pickup (default: *97)
for account X.
The default value is blank.
Account->
Advanced->BLF
List Code
to 6.
213
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
Web Setting Path
SIP-T26P/T22P/
T42G/T41P: X
ranges from 1
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.)
(not
applicable to
SIP-T19P IP
phones)
account.X.blf_l
ist_barge_in_c
ode =
(SIP-T28P/T48G
/T46G: X
ranges from 1
to 6.
SIP-T26P/T22P/
T42G/T41P: X
ranges from 1
to 3.
String within
32
characters
It configures the feature access code
for directed call pickup with barge-in
(default: *33) for account X.
The default value is blank.
SIP-T21P/T20P:
X ranges from
1 to 2.)
(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 =
(not
keys in order.
0 or 1
applicable to
1-Enabled
SIP-T19P IP
The default value is 1.
phones)
phone_setting
.blf_list_seque
nce_type =
214
0-Disabled
It configures the order of BLF list keys
0 or 1
assigned automatically.
0-Line Keys->Memory
Account->
Advanced->BLF
List Barge In Code
Appendix
Parameter
Permitted
Descriptions
Values
(only
Keys->Extension Keys
applicable to
1-Extension Keys->Memory
SIP-T28P,
Keys->Line Keys
SIP-T26P,
Web Setting Path
Memory keys are not applicable to
SIP-T48G and
SIP-T46G/SIP-T48G IP phones.
SIP-T46G IP
The default value is 0.
phones)
account.X.sha
red_line =
(SIP-T28P/T48G
/T46G: X
ranges from 1
It enables or disables Broadsoft SCA
to 6.
SIP-T26P/T22P/
T42G/T41P: X
feature for account X.
0 or 1
ranges from 1
Account->
0-Disabled
Advanced->Share
1-Broadsoft SCA
d Line
The default value is 0.
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1)
account.X.acd
.initial_state =
(SIP-T28P/T48G
/T46G: X
ranges from 1
It configures the initial agent state for
to 6.
SIP-T26P/T22P/
T42G/T41P: X
account X.
1 or 2
1-Avaliable
2-Unavailable
ranges from 1
The default value is 1.
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1)
account.X.acd
.unavailable_r
eason_enable
=
It enables or disables unavailable
0 or 1
reason code feature for account X.
0-Disabled
215
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
(SIP-T28P/T48G
1-Enabled
/T46G: X
The default value is 0.
ranges from 1
to 6.
SIP-T26P/T22P/
T42G/T41P: X
ranges from 1
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1)
account.X.rea
son_code.Y =
(SIP-T28P/T48G
/T46G: X
ranges from 1
to 6.
SIP-T26P/T22P/
T42G/T41P: X
ranges from 1
to 3.
It configures the unavailable code
Integer from
1 to
2147483647
SIP-T21P/T20P:
which must match one of the codes
configured on BroadWorks for account
X.
The value Y must be continuous.
The default value is blank.
X ranges from
1 to 2.
SIP-T19P: X=1.
Y ranges from
1 to 100)
account.X.rea
son_code_na
me.Y =
It configures the unavailable reason
(SIP-T28P/T48G
/T46G: X
ranges from 1
to 6.
SIP-T26P/T22P/
T42G/T41P: X
ranges from 1
to 3.
216
String within
99
characters
which must match one of the reasons
configured on BroadWorks for account
X.
The value Y must be continuous.
The default value is blank.
Web Setting Path
Appendix
Parameter
Permitted
Descriptions
Values
Web Setting Path
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.
Y ranges from
1 to 100)
account.X.call
_center.call_in
fo_enable =
(SIP-T28P/T48G
/T46G: X
ranges from 1
It enables or disables call center call
to 6.
information feature for account X.
SIP-T26P/T22P/
0 or 1
T42G/T41P: X
0-Disabled
1-Enabled
ranges from 1
The default value is 0.
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.)
account.X.call
_center.show_
call_info_time
=
(SIP-T28P/T48G
/T46G: X
ranges from 1
to 6.
SIP-T26P/T22P/
T42G/T41P: X
It configures the interval (in seconds)
Integer from
1 to 86400
to specify how long the call center call
information displays for account X.
The default value is 30 seconds.
ranges from 1
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.)
217
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
account.X.call
_center.disp_c
ode_enable =
(SIP-T28P/T48G
/T46G: X
ranges from 1
It enables or disables disposition code
to 6.
feature for account X.
SIP-T26P/T22P/
0 or 1
0-Disabled
T42G/T41P: X
1-Enabled
ranges from 1
The default value is 0.
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.)
account.X.bw_
disp_code.Y =
(SIP-T28P/T48G
/T46G: X
ranges from 1
to 6.
SIP-T26P/T22P/
T42G/T41P: X
ranges from 1
to 3.
It configures the disposition code
Integer from
1 to
2147483647
SIP-T21P/T20P:
which must match one of the codes
configured on BroadWorks for account
X.
The value Y must be continuous.
The default value is blank.
X ranges from
1 to 2.
SIP-T19P: X=1.
Y ranges from
1 to 100)
account.X.bw_
It configures the disposition code
disp_code_na
me.Y =
(SIP-T28P/T48G
/T46G: X
ranges from 1
to 6.
SIP-T26P/T22P/
218
String within
99
characters
name which must match one of the
names configured on BroadWorks for
account X.
The value Y must be continuous.
The default value is blank.
Web Setting Path
Appendix
Parameter
Permitted
Descriptions
Values
Web Setting Path
T42G/T41P: X
ranges from 1
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.
Y ranges from
1 to 100)
account.X.call
_center.trace_
enable =
(SIP-T28P/T48G
/T46G: X
ranges from 1
It enables or disables customer
to 6.
originated trace feature for account X.
SIP-T26P/T22P/
0 or 1
T42G/T41P: X
0-Disabled
1-Enabled
ranges from 1
The default value is 0.
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.)
account.X.call
_center.emerg
ency_enable
=
(SIP-T28P/T48G
/T46G: X
It enables or disables the emergency
ranges from 1
escalation feature for account X.
to 6.
0 or 1
0-Disabled
SIP-T26P/T22P/
1-Enabled
T42G/T41P: X
The default value is 0.
ranges from 1
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
219
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
SIP-T19P: X=1.
account.X.sup
ervisor_info_c
ode.Y =
(SIP-T28P/T48G
/T46G: X
ranges from 1
to 6.
SIP-T26P/T22P/
Integer from
T42G/T41P: X
1 to
ranges from 1
2147483647
to 3.
It configures the supervisor number for
account X.
The value Y must be continuous.
The default value is blank.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.
Y ranges from
1 to 100)
account.X.sup
ervisor_info_c
ode_name.Y
=
(SIP-T28P/T48G
/T46G: X
ranges from 1
to 6.
SIP-T26P/T22P/
T42G/T41P: X
ranges from 1
String within
99
characters
It configures the supervisor name for
account X.
The value Y must be continuous.
The default value is blank.
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.
Y ranges from
1 to 100)
account.X.call
_center.queue
220
0 or 1
It enables or disables the queue status
notification feature for account X.
Web Setting Path
Appendix
Parameter
Permitted
Descriptions
Values
_status_enabl
0-Disabled
e=
1-Enabled
(SIP-T28P/T48G
The default value is 0.
Web Setting Path
/T46G: X
ranges from 1
to 6.
SIP-T26P/T22P/
T42G/T41P: X
ranges from 1
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.)
account.X.call
_center.queue
It enables or disables the power
_status_light_e
indicator LED to flash when the ACD
nable =
call queue has reached the maximum
(SIP-T28P/T48G
number of calls for account X.
/T46G: X
0-Disabled (power indicator LED does
ranges from 1
not flash)
to 6.
SIP-T26P/T22P/
0 or 1
1-Enabled (power indicator LED fast
flashes (300ms) green)
T42G/T41P: X
If it is set to 0, the status of the power
ranges from 1
indicator LED is determined by the
to 3.
value of the parameter
SIP-T21P/T20P:
“phone_setting.common_power_led_e
X ranges from
nable”.
1 to 2.
The default value is 0.
SIP-T19P: X=1.)
account.X.hot
eling.enable
It enables or disables hoteling feature
=
for account X.
(SIP-T28P/T48G
/T46G: X
ranges from 1
to 6.
SIP-T26P/T22P/
0-Disabled
0 or 1
1-Enabled
The default value is 0.
It takes effect after a reboot.
T42G/T41P: X
221
Yealink IP Phones Auto provisioning Guide
Parameter
Permitted
Descriptions
Values
ranges from 1
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.)
account.X.hot
eling.auto_log
in_enable =
(SIP-T28P/T48G
/T46G: X
It enables or disables the phone to
ranges from 1
save login credentials automatically
to 6.
when logging into the guest profile for
SIP-T26P/T22P/
0 or 1
account X.
T42G/T41P: X
0-Disabled
ranges from 1
1-Enabled
to 3.
The default value is 0.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.)
account.X.hot
eling.user_id
=
(SIP-T28P/T48G
/T46G: X
ranges from 1
to 6.
String within
It configures the user ID used to log
SIP-T26P/T22P/
99
into the guest profile for account X.
T42G/T41P: X
characters
The default value is blank.
ranges from 1
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.)
222
account.X.hot
String within
eling.passwor
99
It configures the password used to log
into the guest profile for account X.
Web Setting Path
Appendix
Parameter
d=
Permitted
Values
characters
Descriptions
Web Setting Path
The default value is blank.
(SIP-T28P/T48G
/T46G: X
ranges from 1
to 6.
SIP-T26P/T22P/
T42G/T41P: X
ranges from 1
to 3.
SIP-T21P/T20P:
X ranges from
1 to 2.
SIP-T19P: X=1.)
223
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 =
224
Appendix
Time Zone
Time Zone Name
−11:00
Samoa
−10:00
United States-Hawaii-Aleutian
−10:00
United States-Alaska-Aleutian
−09:00
United States-Alaska Time
−08:00
Canada(Vancouver, Whitehorse)
−08:00
Mexico(Tijuana, Mexicali)
−08:00
United States-Pacific Time
−07:00
Canada(Edmonton, Calgary)
−07:00
Mexico(Mazatlan, Chihuahua)
−07:00
United States-Mountain Time
−07:00
United States-MST no DST
−06:00
Canada-Manitoba(Winnipeg)
−06:00
Chile(Easter Islands)
−06:00
Mexico(Mexico City, Acapulco)
−06:00
United States-Central Time
−05:00
Bahamas(Nassau)
−05:00
Canada(Montreal, Ottawa, Quebec)
−05:00
Cuba(Havana)
−05:00
United States-Eastern Time
−04:30
Venezuela(Caracas)
−04:00
Canada(Halifax, Saint John)
−04:00
Chile(Santiago)
−04:00
Paraguay(Asuncion)
−04:00
United Kingdom-Bermuda(Bermuda)
−04:00
United Kingdom(Falkland Islands)
−04:00
Trinidad&Tobago
−03:30
Canada-New Foundland(St.Johns)
−03:00
Denmark-Greenland(Nuuk)
−03:00
Argentina(Buenos Aires)
−03:00
Brazil(no DST)
−03:00
Brazil(DST)
−02:00
Brazil(no DST)
−01:00
Portugal(Azores)
0
GMT
0
Greenland
0
Denmark-Faroe Islands(Torshavn)
0
Ireland(Dublin)
0
Portugal(Lisboa, Porto, Funchal)
0
Spain-Canary Islands(Las Palmas)
225
Yealink IP Phones Auto provisioning Guide
Time Zone
226
Time Zone Name
0
United Kingdom(London)
0
Morocco
+01:00
Albania(Tirane)
+01:00
Austria(Vienna)
+01:00
Belgium(Brussels)
+01:00
Caicos
+01:00
Chad
+01:00
Spain(Madrid)
+01:00
Croatia(Zagreb)
+01:00
Czech Republic(Prague)
+01:00
Denmark(Kopenhagen)
+01:00
France(Paris)
+01:00
Germany(Berlin)
+01:00
Hungary(Budapest)
+01:00
Italy(Rome)
+01:00
Luxembourg(Luxembourg)
+01:00
Macedonia(Skopje)
+01:00
Netherlands(Amsterdam)
+01:00
Namibia(Windhoek)
+02:00
Estonia(Tallinn)
+02:00
Finland(Helsinki)
+02:00
Gaza Strip(Gaza)
+02:00
Greece(Athens)
+02:00
Israel(Tel Aviv)
+02:00
Jordan(Amman)
+02:00
Latvia(Riga)
+02:00
Lebanon(Beirut)
+02:00
Moldova(Kishinev)
+02:00
Russia(Kaliningrad)
+02:00
Romania(Bucharest)
+02:00
Syria(Damascus)
+02:00
Turkey(Ankara)
+02:00
Ukraine(Kyiv, Odessa)
+03:00
East Africa Time
+03:00
Iraq(Baghdad)
+03:00
Russia(Moscow)
+03:30
Iran(Teheran)
+04:00
Armenia(Yerevan)
+04:00
Azerbaijan(Baku)
+04:00
Georgia(Tbilisi)
+04:00
Kazakhstan(Aktau)
+04:00
Russia(Samara)
Appendix
Time Zone
Time Zone Name
+04:30
Afghanistan
+05:00
Kazakhstan(Aqtobe)
+05:00
Kyrgyzstan(Bishkek)
+05:00
Pakistan(Islamabad)
+05:00
Russia(Chelyabinsk)
+05:30
India(Calcutta)
+06:00
Kazakhstan(Astana, Almaty)
+06:00
Russia(Novosibirsk, Omsk)
+07:00
Russia(Krasnoyarsk)
+07:00
Thailand(Bangkok)
+08:00
China(Beijing)
+08:00
Singapore(Singapore)
+08:00
Australia(Perth)
+09:00
Korea(Seoul)
+09:00
Japan(Tokyo)
+09:30
Australia(Adelaide)
+09:30
Australia(Darwin)
+10:00
Australia(Sydney, Melbourne, Canberra)
+10:00
Australia(Brisbane)
+10:00
Australia(Hobart)
+10:00
Russia(Vladivostok)
+10:30
Australia(Lord Howe Islands)
+11:00
New Caledonia(Noumea)
+12:00
New Zealand(Wellington, Auckland)
+12:45
New Zealand(Chatham Islands)
+13:00
Tonga(Nukualofa)
227
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 BL LED Mode is 0. BLF LED Mode is not
applicable to SIP-T48G and SIP-T19PIP phones. BLF/BLF list key LED status for line keys on
T46G/T42G/T41P IP phones are the same as that for memory keys.
Line key LED (configured as a BLF/BLF list key and BLF LED Mode is set to 0)
LED Status
Solid green
Fast flashing green
(200ms)
Slow flashing green
(500ms)
Slow flashing green (1s)
Off
Description
The monitored user is idle.
The monitored user receives an incoming call.
The monitored user is dialing.
The monitored user is talking.
The monitored user’s conversation is placed on hold.
The call is parked against the monitored user’s phone
number.
The monitored user does not exist.
Memory key/Expansion Module key LED (configured as a BLF/BLF list key and BLF LED
Mode is set to 0)
LED Status
Description
Solid green
The monitored user is idle.
Fast flashing red (200ms)
The monitored user receives an incoming call.
Solid red
The monitored user is dialing.
The monitored user is talking.
The call is parked against the monitored user’s phone
Slow flashing red (1s)
number.
The monitored user’s conversation is placed on hold.
Off
The monitored user does not exist.
Line key LED (configured as a BLF/BLF list key and BLF LED Mode is set to 1)
LED Status
Fast flashing green
(200ms)
Solid green
Slow flashing green
(500ms)
228
Description
The monitored user receives an incoming call.
The monitored user is dialing.
The monitored user is talking.
The monitored user’s conversation is placed on hold.
Appendix
Slow flashing green (1s)
The call is parked against the monitored user’s phone
number.
The monitored user is idle.
Off
The monitored user does not exist.
Memory key/Expansion Module key LED (configured as a BLF/BLF list key and BLF LED
Mode is set to 1)
LED Status
Fast flashing red (200ms)
Solid red
Description
The monitored user receives an incoming call.
The monitored user is dialing.
The monitored user is talking.
The call is parked against the monitored user’s phone
Slow flashing red (1s)
number.
The monitored user’s conversation is placed on hold.
The monitored user is idle.
Off
The monitored user does not exist.
Line key LED (configured as a BLF/BLF list key and BLF LED Mode is set to 2)
LED Status
Fast flashing green
(200ms)
Slow flashing green
(500ms)
Slow flashing green (1s)
Description
The monitored user receives an incoming call.
The monitored user is dialing.
The monitored user is talking.
The monitored user’s conversation is placed on hold.
The call is parked against the monitored user’s phone
number.
The monitored user is idle.
Off
The monitored user does not exist.
Memory key/Expansion Module key LED (configured as a BLF/BLF list key and BLF LED
Mode is set to 2)
LED Status
Fast flashing red (200ms)
Solid red
Description
The monitored user receives an incoming call.
The monitored user is dialing.
The monitored user is talking.
The call is parked against the monitored user’s phone
Slow flashing red (1s)
number.
The monitored user’s conversation is placed on hold.
Off
The monitored user is idle.
The monitored user does not exist.
229
Yealink IP Phones Auto provisioning Guide
Line key LED (configured as a BLF/BLF list key and BLF LED Mode is set to 3)
LED Status
Fast flashing green
(200ms)
Description
The monitored user receives an incoming call.
The monitored user is dialing.
Solid green
The monitored user is talking.
The monitored user’s conversation is placed on hold.
Slow flashing green (1s)
The call is parked against the monitored user’s phone
number.
The monitored user is idle.
Off
The monitored user does not exist.
Memory key/Expansion Module key LED (configured as a BLF/BLF list key and BLF LED
Mode is set to 3)
LED Status
Fast flashing red (200ms)
Description
The monitored user receives an incoming call.
The monitored user is dialing.
Solid red
The monitored user is talking.
The monitored user’s conversation is placed on hold.
Slow flashing red (1s)
Off
230
The call is parked against the monitored user’s phone
number.
The monitored user is idle.
The monitored user does not exist.
Appendix
We are striving to improve our documentation quality and we appreciate your feedback.
Email your opinions and comments to DocsFeedback@yealink.com.
231
Was this manual useful for you? yes no
Thank you for your participation!

* Your assessment is very important for improving the work of artificial intelligence, which forms the content of this project

Download PDF

advertising