0% found this document useful (0 votes)
495 views229 pages

Yealink SIP-T2 Series T19P T4 Series IP Phones Auto Provisioning Guide V72 1 PDF

Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
0% found this document useful (0 votes)
495 views229 pages

Yealink SIP-T2 Series T19P T4 Series IP Phones Auto Provisioning Guide V72 1 PDF

Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 229

Table of Contents

i
Table of Contents

Table of Contents ...................................................................... iii

Summary of Changes............................................................... v
Changes for Release 72, Guide Version 72.1 .................................................................... v
Changes for Release 71, Guide Version 71.165 ................................................................ v
Changes for Release 71, Guide Version 71.140 ................................................................ v
Changes for Release 71, Guide Version 71.125 ................................................................ v
Changes for Release 71, Guide Version 71.120 ............................................................... vi
Changes for Release 71, Guide Version 71.110 ............................................................... vi
Changes for Release 70, Guide Version 1.3 ..................................................................... vi

Introduction ............................................................................... 1

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 ........................................................................................... 17
Customizing a Wallpaper ........................................................................................... 18
Customizing a Local Contact File .............................................................................. 18
Customizing a Replace Rule File ................................................................................ 21
Customizing a Dial-now File ....................................................................................... 22
Upgrading Firmware ................................................................................................... 23

Configuring a TFTP Server ...................................................... 25


Preparing a Root Directory ................................................................................................ 25
Configuring a TFTP Server ................................................................................................. 26

iii
Yealink IP Phones Auto provisioning Guide

Obtaining the Address of Provisioning Server ...................... 27


Zero Touch ........................................................................................................................... 27
Plug and Play (PnP) Server ............................................................................................... 29
DHCP Options ..................................................................................................................... 30
Phone Flash ......................................................................................................................... 31

Update Mode ......................................................................... 33


Power On ............................................................................................................................. 33
Repeatedly.......................................................................................................................... 34
Weekly ................................................................................................................................. 35
Auto Provision Now ............................................................................................................ 36
Multi-mode Mixed ............................................................................................................. 37
SIP NOTIFY Message ......................................................................................................... 37

Downloading and Verifying Configurations .......................... 39


Downloading Configuration Files ..................................................................................... 39
Resolving and Updating Configurations ......................................................................... 39
Verifying Configurations .................................................................................................... 40

Troubleshooting ...................................................................... 43

Glossary .................................................................................. 45

Appendix ................................................................................ 47
Configuring an FTP Server ................................................................................................ 47
Preparing a Root Directory ............................................................................................ 47
Configuring an FTP server .............................................................................................. 48
Configuring an HTTP Server .............................................................................................. 50
Preparing a Root Directory ............................................................................................ 50
Configuring an HTTP Server .......................................................................................... 50
Configuring a DHCP server ............................................................................................... 53
Customizing a Ring Tone Using Cool Edit Pro ................................................................. 61
Customizing a Logo File Using PictureExDemo .............................................................. 62
Description of Configuration Parameters in CFG Files .................................................. 63
Time Zones ........................................................................................................................ 217
BLF LED Mode ................................................................................................................... 220

iv
Summary of Changes

This section describes the changes to this guide for each release and guide version.

This version is updated to incorporate SIP-T46G, SIP-T42G and SIP-T41P IP phones. The
following sections are new for this version:

 Time Zones on page 217

 BLF LED Mode on page 220

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 63

Documentations of the newly released SIP-T21P and SIP-T19P IP phones have also been
added.

Major updates have occurred to the following sections:

 Editing Common CFG File on page 5

 Editing MAC-Oriented CFG File on page 7

 Encrypting Configuration Files on page 14

 Customizing an LCD Logo on page 17

 Customizing a Local Contact File on page 18

 Description of Configuration Parameters in CFG Files on page 63

Major updates have occurred to the following section:

 Customizing an LCD Logo on page 17

v
Yealink IP Phones Auto provisioning Guide

Major updates have occurred to the following section:

 Description of Configuration Parameters in CFG Files on page 63

The following sections are new for this version:

 Encrypting Configuration Files on page 14

 Update Mode on page 33

 SIP NOTIFY Message on page 37

 Resolving and Updating Configurations on page 39

 Description of Configuration Parameters in CFG Files on page 63

Major updates have occurred to the following sections:

 Customizing a Local Contact File on page 18

 Customizing a Replace Rule File on page 21

 Customizing a Dial-now File on page 22

The following sections are new for this version:

 Customizing a Wallpaper on page 18

 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 23

vi
Introduction

Yealink IP phones are full-featured telephones that can be plugged directly into an IP
network and can be used easily without manual configuration.

This guide provides instructions on how to provision Yealink IP phones with the minimum
settings required. Yealink IP phones support FTP, TFTP, HTTP, and HTTPS protocols for auto
provisioning and are configured by default to use the TFTP protocol.

The purpose of this guide is to serve as a basic guidance for provisioning Yealink IP
phones, including:

 Yealink SIP-T28P

 Yealink SIP-T26P

 Yealink SIP-T22P

 Yealink SIP-T21P

 Yealink SIP-T20P

 Yealink SIP-T19P

 Yealink SIP-T46G

 Yealink SIP-T42G

 Yealink SIP-T41P

The auto provisioning process outlined in this guide applies to Yealink IP phones running
firmware V72 or later. We recommend that IP phones running firmware V72 or later
CANNOT be downgraded to an earlier firmware version. The new firmware is compatible
with old configuration parameters, but not vice versa.

This guide is also applicable to SIP-T21, SIP-T20 and SIP-T19 IP phones running firmware V72
or later, which are not PoE-compliant.

1
Yealink IP Phones Auto provisioning Guide

2
Getting Started

This section provides instructions on how to get ready for auto provisioning. The auto
provisioning process discussed in this guide uses the TFTP server as the provisioning
server.

To begin the auto provisioning process, the following steps are required:

 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 of the hardware version
of the phone model (except 0 for SIP-T28P).

The names of the Common CFG file for each phone model are:

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-T46G y000000000028.cfg

SIP-T42G y000000000029.cfg

3
Yealink IP Phones Auto provisioning Guide

Phone Model Common CFG File

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 63.

4
Getting Started

Common CFG file contains configuration parameters which apply to phones with the
same model, such as language, volume.

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 parameters commonly edited 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/T46G/T42G/T41P IP phones running firmware version
72 or later. For more information on configuration parameters, refer to
Yealink_SIP-T2_Series_T19P_T4_Series_IP_Phones_Auto_Provisioning_Guide. ##
######################################################
## Hostname ##
######################################################
network.dhcp_host_name =
######################################################
## PPPOE(Except SIP-T41P/T42G Models) ##
######################################################
network.pppoe.user =

5
Yealink IP Phones Auto provisioning Guide

network.pppoe.password =
######################################################
## PC Port(Only SIP-T28P/T26P/T22P/T20P Models support) ##
######################################################
network.bridge_mode =
network.pc_port.ip =
network.pc_port.mask =
network.dhcp.start_ip =
network.dhcp.end_ip =
######################################################
## Network Advanced ##
######################################################
network.pc_port.enable =
network.internet_port.speed_duplex =
network.pc_port.speed_duplex =
network.pc_port.dhcp_server =
network.static_dns_enable =
network.ipv6_static_dns_enable =
##Only T41P/T42G/T46G Models support this parameter##
network.vlan.pc_port_mode =
######################################################
## VLAN ##
######################################################
network.vlan.internet_port_enable =
network.vlan.internet_port_vid =
network.vlan.internet_port_priority =
network.vlan.pc_port_enable =
network.vlan.pc_port_vid =
network.vlan.pc_port_priority =
network.vlan.dhcp_enable =
network.vlan.dhcp_option =
######################################################
## WEB Port ##
######################################################
network.port.http =
network.port.https =
wui.https_enable =
wui.http_enable =
######################################################
## QOS ##
######################################################
network.qos.rtptos =
network.qos.signaltos =
######################################################
## 802.1X ##
######################################################
network.802_1x.mode =
network.802_1x.identity =
network.802_1x.md5_password =

6
Getting Started

network.802_1x.root_cert_url =
network.802_1x.client_cert_url =
######################################################
## OpenVPN(Except SIP-T19P Model) ##
######################################################
network.vpn_enable =
openvpn.url =
######################################################
## LLDP ##
######################################################
network.lldp.enable =
network.lldp.packet_interval =

MAC-Oriented CFG file contains configuration parameters which are expected to be


updated per phone, such as the registration information.

7
Yealink IP Phones Auto provisioning Guide

The parameters commonly edited 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/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 =

8
Getting Started

account.1.sip_server.2.address =

account.1.sip_server.2.port =

account.1.sip_server.2.expires =

account.1.sip_server.2.retry_counts =

account.1.sip_server.2.failback_mode =

account.1.sip_server.2.failback_timeout =

account.1.sip_server.2.register_on_enable =

######################################################
## Account2 Basic Settings (except SIP-T19P Model) ##
######################################################

account.2.enable =

account.2.label =

account.2.display_name =

account.2.auth_name =

account.2.user_name =

account.2.password =

account.2.outbound_proxy_enable =

account.2.outbound_host =

account.2.outbound_port =

account.2.sip_listen_port =

account.2.transport =

######################################################
## Failback (except SIP-T19P Model) ##

######################################################
account.2.reregister_enable =

account.2.naptr_build =

account.2.fallback.redundancy_type =

account.2.fallback.timeout =

account.2.sip_server.1.address =

account.2.sip_server.1.port =

account.2.sip_server.1.expires =

account.2.sip_server.1.retry_counts =

account.2.sip_server.1.failback_mode =

account.2.sip_server.1.failback_timeout =

account.2.sip_server.1.register_on_enable =

account.2.sip_server.2.address =

account.2.sip_server.2.port =

account.2.sip_server.2.expires =

9
Yealink IP Phones Auto provisioning Guide

account.2.sip_server.2.retry_counts =

account.2.sip_server.2.failback_mode =

account.2.sip_server.2.failback_timeout =

account.2.sip_server.2.register_on_enable =

######################################################

## 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 (except SIP-T21P/T20P/T19P Models) ##

######################################################

account.3.reregister_enable =

account.3.naptr_build =

account.3.fallback.redundancy_type =

account.3.fallback.timeout =

account.3.sip_server.1.address =

account.3.sip_server.1.port =

account.3.sip_server.1.expires =

account.3.sip_server.1.retry_counts =

account.3.sip_server.1.failback_mode =

account.3.sip_server.1.failback_timeout =

account.3.sip_server.1.register_on_enable =

account.3.sip_server.2.address =

account.3.sip_server.2.port =

account.3.sip_server.2.expires =

account.3.sip_server.2.retry_counts =

account.3.sip_server.2.failback_mode =

10
Getting Started

account.3.sip_server.2.failback_timeout =

account.3.sip_server.2.register_on_enable =

######################################################
## Account4 Basic Settings (for SIP-T28P/T46G models) ##
######################################################

account.4.enable =

account.4.label =

account.4.display_name =

account.4.auth_name =

account.4.user_name =

account.4.password =

account.4.outbound_proxy_enable =

account.4.outbound_host =

account.4.outbound_port =

account.4.sip_listen_port =

account.4.transport =

######################################################

## Failback (for SIP-T28P/T46G models) ##

######################################################

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/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 (for SIP-T28P/T46G models) ##


######################################################

account.5.reregister_enable =

account.5.naptr_build =

account.5.fallback.redundancy_type =

account.5.fallback.timeout =

account.5.sip_server.1.address =

account.5.sip_server.1.port =

account.5.sip_server.1.expires =

account.5.sip_server.1.retry_counts =

account.5.sip_server.1.failback_mode =

account.5.sip_server.1.failback_timeout =

account.5.sip_server.1.register_on_enable =

account.5.sip_server.2.address =

account.5.sip_server.2.port =

account.5.sip_server.2.expires =

account.5.sip_server.2.retry_counts =

account.5.sip_server.2.failback_mode =

account.5.sip_server.2.failback_timeout =

account.5.sip_server.2.register_on_enable =

12
Getting Started

######################################################
## Account6 Basic Settings (for SIP-T28P/T46G models) ##
######################################################
account.6.enable =

account.6.label =

account.6.display_name =

account.6.auth_name =

account.6.user_name =

account.6.password =

account.6.outbound_proxy_enable =

account.6.outbound_host =

account.6.outbound_port =

account.6.sip_listen_port =

account.6.transport =

######################################################
## Failback (for SIP-T28P/T46G models) ##
######################################################

account.6.reregister_enable =

account.6.naptr_build =

account.6.fallback.redundancy_type =

account.6.fallback.timeout =

account.6.sip_server.1.address =

account.6.sip_server.1.port =

account.6.sip_server.1.expires =

account.6.sip_server.1.retry_counts =

account.6.sip_server.1.failback_mode =

account.6.sip_server.1.failback_timeout =

account.6.sip_server.1.register_on_enable =

account.6.sip_server.2.address =

account.6.sip_server.2.port =

account.6.sip_server.2.expires =

account.6.sip_server.2.retry_counts =

account.6.sip_server.2.failback_mode =

account.6.sip_server.2.failback_timeout =

account.6.sip_server.2.register_on_enable =

13
Yealink IP Phones Auto provisioning Guide

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
provides some resource file templates for the particular features. Ask the distributor or
Yealink FAE for resource file templates. The following provides information on how to
customize resource files and specify the access URL for the resource files.

Yealink IP phones have built-in system ring tones. You can change the ring type, or
customize a ring tone and upload it to the phone via auto provisioning.

The following table lists the supported ring tone file format, one file size and total file
size for each phone model:

Ring Tone File


Phone Model One File Size Total File Size
Format

SIP-T28P/T26P/T22P/T20P
.wav <=100K <=100K
/T42G/T41P

SIP-T21P/T19P .wav <=100K <=200K

SIP-T46G .wav <=8M <=20M

The ring tone file must be PCMU audio format, mono channel, 8K sample rate and 16 bit
resolution.

####################################################

## 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 the custom ring tones.

ringtone.delete = http://localhost/all

For more information on customizing a ring tone file, refer to Customizing a Ring Tone
Using Cool Edit Pro on page 61.

You can modify the language translation for the phone user interface. For SIP-T4X IP
phones, you can also add a new language to the phones.

The following table lists available languages and the associated language files for the
phone user interface:

Associated Language Pack


Associated Language
Available for
Pack for
Language SIP-T28P/T26P/T22P/T20P/T42G/
SIP-T19P/T21P/T46G
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

Portuguese lang-Portuguese.txt lang-Portuguese.txt

Spanish lang-Spanish.txt lang-Spanish.txt

Turkish lang-Turkish.txt lang-Turkish.txt

15
Yealink IP Phones Auto provisioning Guide

The following figure shows a portion of a txt formatted language file:

####################################################

## 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-T46G IP phones also support adding a custom or modifying an existing LCD language
with an X.GUI.Y.lang (e.g., 0.GUI.English.lang) formatted language file. “X” is an integer
which starts from 0. “Y” means the name of the language. For more information, contact
Yealink FAE.

Available languages may vary between different firmware versions.

To modify translation of an existing language, do not rename the language file.

16
Getting Started

Yealink IP phones allow you to customize the logo displayed on the LCD screen. SIP-T20P
IP phones only support a text logo. SIP-T46G IP phones do not support an LCD logo.

The following table lists the supported logo file format, resolution and total file size for
each phone model:

Phone Model Logo File Format Resolution Total File Size

SIP-T28P .dob <=236*82 2 gray scale <=100K

SIP-T26P/T22P .dob <=132*64 2 gray scale <=100K

SIP-T21P/T19P .dob <=132*64 2 gray scale <=200K

SIP-T42G/T41P .dob <=192*64 2 gray scale <=100K

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

For more information on customizing a logo file, refer to Customizing a Logo File Using

17
Yealink IP Phones Auto provisioning Guide

PictureExDemo on page 62.

Yealink SIP-T46G IP phones allow you to customize the wallpaper displayed on the LCD
screen.

The following table lists the supported wallpaper image format and resolution for
SIP-T46G IP phones:

Wallpaper Image
Phone Model Resolution One File Size Total File Size
Format

SIP-T46G .jpg/.png/.bmp <=480*272 <=5M <=20M

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 supplied 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>.

18
Getting Started

 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-T46G, valid values are -1~5. -1
stands for Auto (the first registered line). 0~5 stand for line1~line6)

 When specifying a ring tone for a contact, valid values are Auto,
Resource:RingN.wav (system ring tone, integer N ranges from 1 to 5 for
SIP-T2xP/T19P/T42G/T41P and from 1 to 8 for SIP-T46G) and Custom:Name.wav
(custom ring tone).

 When specifying a group for a contact, valid values are the group names (built-in
or custom groups).

 When specifying an avatar for a contact, valid values are “Default: avatar name”
(for the built-in avatar) and “Config: avatar name” (for the custom avatar). This is
only applicable to SIP-T46G IP phones.

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.

19
Yealink IP Phones Auto provisioning Guide

group_id_name=”” specifies the group you want to add the contact to.

default_photo=”” specifies the avatar for the contact (for SIP-T46G IP phones).

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.

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"/>

</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”.

20
Getting Started

####################################################

## 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 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”.

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. This 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.

21
Yealink IP Phones Auto provisioning Guide

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>

####################################################

## 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.
This 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
Getting Started

3. Specify the values within double quotes.

4. Save the change.

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”.

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

SIP-T26P 6.x.x.x.rom

SIP-T22P 7.x.x.x.rom

SIP-T21P 34.x.x.x.rom

SIP-T20P 9.x.x.x.rom

SIP-T19P 31.x.x.x.rom

SIP-T46G 28.x.x.x.rom

SIP-T42G 29.x.x.x.rom

SIP-T41P 36.x.x.x.rom

23
Yealink IP Phones Auto provisioning Guide

To upgrade the phones’ firmware in batch via auto provisioning, ask the distributor for
the firmware file, upload it to the provisioning server, and then specify the access URL in
configuration files.

####################################################

## Configure the access URL of the firmware file ##


####################################################

firmware.url =

For example, enter “tftp://admin:[email protected]/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”.

24
Configuring a TFTP Server

Yealink IP phones support using FTP, TFTP, HTTP and HTTPS protocols to download
configuration files. You can use one of these protocols for provisioning. The TFTP protocol
is used by default. The following section provides instructions on how to configure a TFTP
server.

We recommend that you use 3CDaemon or TFTPD32 as a TFTP server. 3CDaemo and
TFTPD32 are free applications for Windows. You can download 3CDaemon online:
http://www.oldversion.com/3Com-Daemon.html and TFTPD32 online:
http://tftpd32.jounin.net/.

For more information on how to configure FTP and HTTP servers, refer to Configuring an
FTP server on page 47 and Configuring an HTTP Server on page 50.

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:

25
Yealink IP Phones Auto provisioning Guide

If you have a 3CDaemon application installed on your local system, use it directly.
Otherwise, download and install it.

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.

26
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.

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.

27
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 (Take
T28P IP phone as an example):

Press the OK soft key.

The network parameters are configurable via phone user interface:

Press the Next soft key after finishing the network parameters.

28
Obtaining the Address of Provisioning Server

Configure the provisioning server address, authentication user name (optional) and
password (optional) in the Auto Provision screen.

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

29
Yealink IP Phones Auto provisioning Guide

can connect to the provisioning server and perform the auto provisioning process.

Yealink IP phones support obtaining the provisioning server address from DHCP options.
You can configure the phone to obtain the provisioning server address from a custom
DHCP option, or the phone will automatically detect the Option 66 and Option 43. The
Option 66 is used to identify the TFTP server. To obtain the provisioning server address
by a custom DHCP option, make sure the DHCP option is set properly.

The custom DHCP option must be in accordance with the one defined in the DHCP
server. For more information on configuring a DHCP server, refer to Configuring a DHCP
server on page 53.

To configure the DHCP option via web user interface:

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.

30
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 33.

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.

31
Yealink IP Phones Auto provisioning Guide

2. Enter the URL, user name and password of the provisioning server in the Server
URL, User Name and Password fields (the user name and password are optional).

3. Configure the desired update mode.

For more information, refer to Update Mode on page 33.

4. Click Confirm to accept the change.

32
Update Mode

The update mode is used to set the desired time for the phone to perform the auto
provisioning process. This chapter introduces the following update modes in detail:

 Power On

 Repeatedly

 Weekly

 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.

33
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:

1. Click on Settings->Auto Provision.

2. Mark the On radio box in the Repeatedly field.

34
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.

35
Yealink IP Phones Auto provisioning Guide

4. Mark one or more radio boxes 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. Click on Settings->Auto Provision.

36
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.

37
Yealink IP Phones Auto provisioning Guide

The following figure shows the message flow:

38
Downloading and Verifying Configurations

Once obtaining a provisioning server address in one of the ways introduced above, the
phone will connect to the provisioning server and download configuration files. During
the auto provisioning process, the phone will try to download the Common CFG file
firstly, and then try to download the MAC-Oriented CFG file from the provisioning server.
If resource files need to be updated and the access URLs have been specified in
configuration files, the phone will then try to download and update the resource files.

After downloading, the phone resolves the configuration files, downloads the resource
files requested in the configuration files, and then updates the configurations and
resource files to the phone flash. Generally, updated configurations will automatically
take effect after the auto provisioning process is completed. For update of some specific
configurations which require a reboot before taking effect, for example, network
configurations, the phone will reboot to make the configurations effective after the auto
provisioning process is completed.

The phone calculates the MD5 values of the downloaded files. If the MD5 values of the
Common and MAC-Oriented configuration files are the same as those of the last
downloaded configuration files, this means these two configuration files on the
provisioning server are not changed. The phone will complete the auto provisioning
without repeated update. This is used to avoid unnecessary restart and impact of
phone use.

If configuration files have been AES-encrypted, the phone will decrypt them after
downloading the configuration files. For more information on how to decrypt
configuration files, refer to Yealink Configuration Encryption Tool User Guide.

The phone only reboots when there is at least a specific configuration requiring reboot
during auto provisioning.

For more information on the specific configurations requiring a reboot during auto
provisioning, refer to Description of Configuration Parameters in CFG Files on page 63.

39
Yealink IP Phones Auto provisioning Guide

After auto provisioning, you can then verify the update via phone user interface, or you
can verify it via web user interface of the phone. For more information, refer to Yealink
phone-specific user guide.

During the auto provisioning process, you can monitor the downloading requests and
response messages by a WinPcap tool. The following shows some examples.

Example1: Yealink SIP-T28P IP phone downloads configuration files from the TFTP server.

Example 2: Yealink SIP-T28P IP phone downloads configuration files from the FTP server.

40
Downloading and Verifying Configurations

Example 3: Yealink SIP-T28P IP phone downloads configuration files from the HTTP server.

41
Yealink IP Phones Auto provisioning Guide

42
Troubleshooting

This chapter provides general troubleshooting information to help you solve problems
you might encounter when deploying phones.

If you require additional information or assistance with the deployment, contact your
system administrator.

Why does the phone fail to download configuration files?

 Ensure that auto provisioning feature is enabled.

 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.

43
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?

 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.

44
Glossary

MAC Address: A Media Access Control address (MAC address) is a unique identifier
assigned to network interfaces for communications on the physical network segment.

MD5: The MD5 Message-Digest Algorithm is a widely used cryptographic hash function
that produces a 128-bit (16-byte) hash value.

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.

45
Yealink IP Phones Auto provisioning Guide

46
Appendix

This section provides instructions on how to configure an FTP server using 3CDaemon.
You can download the 3CDaemon software online:
http://www.oldversion.com/3Com-Daemon.html.

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:

47
Yealink IP Phones Auto provisioning Guide

If you have a 3CDaemon application installed on your local system, use it directly.
Otherwise, download and install it.

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:

3. Select Configure FTP Server.

4. Click the button to locate the FTP root directory from your local system:

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

48
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:[email protected]/”) is where the phone
downloads configuration files from.

49
Yealink IP Phones Auto provisioning Guide

This section provides instructions on how to configure an HTTP server using HFS tool. You
can download the HFS software online: http://www.snapfiles.com/get/hfs.html.

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. Download the application file to your local directory, double click the hfs.exe.

50
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.

51
Yealink IP Phones Auto provisioning Guide

The default HTTP port is 8080. You can also reset the HTTP port (make sure there is no
port conflict).

3. Right click the icon on the left of the main page, select Add folder from disk to
add the HTTP Server root directory.

52
Appendix

4. Locate the root directory from your local system. Select the kind of folder which you
want.

5. Check the server URL “http:// IP:Port/” in the “Open in browser” address bar (For
example, the server URL ”http:// 10.2.11.101:8088/” is shown on the screenshot) . We
recommend that you can fill the server URL in the address bar of the web browser
and then press <Enter> key to check the HTTP server before provisioning.

Yealink IP phones also support the Hypertext Transfer Protocol with SSL/TLS (HTTPS)
protocol for auto provisioning. HTTPS protocol provides the encrypted communication and
secure identification. For more information on installing and configuring an Apache HTTPS
Server, refer to the network resource.

This section provides instructions on how to configure a DHCP server for Windows using
DHCP Turbo. You can download this software online:
http://www.tucows.com/preview/265297 and install it following the setup wizard.

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.

53
Yealink IP Phones Auto provisioning Guide

2. Click the Login button (the login password is blank) to log in.

3. You can then edit the existing DHCP server, or you can right click localhost and
select New Server to add a new DHCP server.

54
Appendix

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.

55
Yealink IP Phones Auto provisioning Guide

8. Set the custom DHCP option (custom DHCP option tag number ranges from 128 to
254) and select the option type (Yealink supports String and IP Address option
types only). Click the OK button to finish setting the option properties. Click to
save the change.

9. Click Named Policies-->Global, right click the blank area on the right of the main
page and then select New Option.

56
Appendix

10. Scroll down and double click the custom option 128.

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.

57
Yealink IP Phones Auto provisioning Guide

You can add the option 66 via DHCP Turbo. The following shows the detailed processes.

1. Click Named Policies-->Global, right click the blank area on the right of the main
page and then select New Option.

2. Select TFTP Options from the pull-down list of Filter.

3. Scroll down and double click MS option 66.

58
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.

59
Yealink IP Phones Auto provisioning Guide

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.

60
Appendix

If you have installed the Cool Edit application, double click to open it. Otherwise, you
can download the installation package online:
http://www.toggle.com/lv/group/view/kl36218/Cool_Edit_Pro.htm and install it.

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,

61
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.

62
Appendix

If you want to reset the configuration of a parameter, set the value of the parameter to !NULL!
or %NULL%. For example, local_time.ntp_server1 = %NULL%. After the auto provisioning
process is completed, the NTP server 1 will be reset to “cn.pool.ntp.org”.

Permitted
Parameter Descriptions Web Setting Path
Values

It configures the IP address mode.

0-IPv4
Network->Basic->
network.ip_ad 1-IPv6
0, 1 or 2 Internet Port->
dress_mode = 2-IPv4&IPv6
Mode (IPv4/IPv6)
The default value is 0.

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.

0-DHCP
network.intern Network->Basic->
0, 1 or 2
et_port.type = 1-PPPoE (not applicable to SIP-T41P and IPv4 Config
SIP-T42G IP phones)

2-Static IP Address

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 Network->Basic->
_dns_enable 0 or 1 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


IP address mode is configured as IPv4 Network->Basic->
network.intern or IPv4&IPv6, and the Internet (WAN) IPv4 Config->Static
IPv4 address
et_port.ip = port type for IPv4 is configured as IP Address->IP
Static IP Address. Address

The default value is blank.

63
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

It takes effect after a reboot.

It configures the IPv4 subnet mask


when the IP address mode is
Network->Basic->
network.intern configured as IPv4 or IPv4&IPv6, and
Subnet IPv4 Config->Static
et_port.mask the Internet (WAN) port type for IPv4 is
Mask IP Address->
= configured as Static IP Address.
Subnet Mask
The default value is blank.

It takes effect after a reboot.

It configures the IPv4 default gateway


when the IP address mode is
Network->Basic->
network.intern configured as IPv4 or IPv4&IPv6, and
IPv4 Config->Static
et_port.gatew IPv4 address the Internet (WAN) port type for IPv4 is
IP Address->
ay = configured as Static IP Address.
Gateway
The default value is blank.

It takes effect after a reboot.

It configures the primary IPv4 DNS


server when the IP address mode is
Network->Basic->
configured as IPv4 or IPv4&IPv6, and
network.prima IPv4 Config->Static
IPv4 address the Internet (WAN) port type for IPv4 is
ry_dns = IP Address->
configured as Static IP Address.
Primary DNS
The default value is blank.

It takes effect after a reboot.

It configures the secondary IPv4 DNS


server when the IP address mode is
Network->Basic->
configured as IPv4 or IPv4&IPv6, and
network.secon IPv4 Config->Static
IPv4 address the Internet (WAN) port type for IPv4 is
dary_dns = IP Address->
configured as Static IP Address.
Secondary DNS
The default value is blank.

It takes effect after a reboot.

network.pppo
e.user =
It configures the user name for PPPoE Network->Basic->
(not String within
connection. IPv4 Config->
applicable to 32
The default value is blank. PPPoE->User
SIP-T41P and characters
It takes effect after a reboot. Name
SIP-T42G IP
phones)

network.pppo String within It configures the password for PPPoE Network->Basic->

64
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

e.password = 99 connection. IPv4 Config->

(not characters The default value is blank. PPPoE->Password

applicable to It takes effect after a reboot.


SIP-T41P and
SIP-T42G IP
phones)

It configures the Internet (WAN) port


type for IPv6 when the IP address
mode is configured as IPv6 or
network.ipv6_i IPv4&IPv6.
Network->Basic->
nternet_port.ty 0 or 1
0-DHCP IPv6 Config
pe =
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_ Network->Basic->
static_dns_en 0 or 1 0-Disabled (use the IPv6 DNS obtained IPv6 Config->IPv6
able = 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->Basic->
IPv4&IPv6, and the Internet (WAN) port
network.ipv6_ Integer from IPv6 Config->Static
type for IPv6 is configured as Static IP
prefix = 0 to 128 IP Address->IPv6
Address.
Prefix (0~128)
The default value is 64.

It takes effect after a reboot.

It configures the IPv6 address when the


IP address mode is configured as IPv6
Network->Basic->
network.ipv6_i or IPv4&IPv6, and the Internet (WAN)
IPv6 Config->Static
nternet_port.i IPv6 address port type for IPv6 is configured as
IP Address->IP
p= Static IP Address.
Address
The default value is blank.

It takes effect after a reboot.

65
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

It configures the IPv6 default gateway


when the IP address mode is
Network->Basic->
network.ipv6_i configured as IPv6 or IPv4&IPv6, and
IPv6 Config->Static
nternet_port.g IPv6 address the Internet (WAN) port type for IPv6 is
IP Address->
ateway = configured as Static IP Address.
Gateway
The default value is blank.

It takes effect after a reboot.

It configures the primary IPv6 DNS


server when the IP address mode is
Network->Basic->
network.ipv6_ configured as IPv6 or IPv4&IPv6, and
IPv6 Config->Static
primary_dns IPv6 address the Internet (WAN) port type for IPv6 is
IP Address->
= configured as Static IP Address.
Primary DNS
The default value is blank.

It takes effect after a reboot.

It configures the secondary IPv6 DNS


server when the IP address mode is
Network-> Basic->
network.ipv6_ configured as IPv6 or IPv4&IPv6, and
IPv6 Config->Static
secondary_dn IPv6 address the Internet (WAN) port type for IPv6 is
IP Address->
s= configured as Static IP Address.
Secondary DNS
The default value is blank.

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= Network->Advanc
0 or 1 0-Disabled ed->ICMPv6
(only
applicable to 1-Enabled Status->Active

SIP-T46G IP The default value is 1.


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
The default value is 1. Network->PC Port
SIP-T20P, 0 or 1
->PC Port Config
It takes effect after a reboot.
SIP-T22P,
SIP-T26P and Note: SIP-T19P/T21P/T41P/T42G/T46G IP

SIP-T28P IP phones only support bridge mode for

phones) PC connection.

66
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

It enables or disables the PC port.

0-Disabled
network.pc_p Network->PC Port
0 or 1 1-Auto Negotiation
ort.enable = ->PC Port Active
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
Network->PC Port
(LAN) port when the PC (LAN) port is
applicable to
->PC Port Config
IP address configured as Router.
SIP-T20P,
->As Router->IP
SIP-T22P, The default value is 10.0.0.1.
Address
SIP-T26P and It takes effect after a reboot.
SIP-T28P IP
phones)

network.pc_p
ort.mask =
It configures the mask of the PC (LAN)
(only
Network->PC Port
port when the PC (LAN) port is
applicable to
->PC Port Config
IP address configured as Router.
SIP-T20P,
->As Router
SIP-T22P, The default value is 255.255.255.0.
->Subnet Mask
SIP-T26P and It takes effect after a reboot.
SIP-T28P IP
phones)

network.pc_p
ort.dhcp_serv It enables or disables the phone to act
er = as a DHCP server when the PC (LAN)
Network->PC Port
(only port is configured as Router.
->PC Port Config
applicable to 0-Disabled
0 or 1 ->As Router
SIP-T20P,
1-Enabled ->Enable DHCP
SIP-T22P,
The default value is 1. Server
SIP-T26P and
SIP-T28P IP It takes effect after a reboot.

phones)

network.dhcp.
It configures the start IP address of the Network->PC Port
start_ip =
DHCP IP segment. ->PC Port Config
(only IP address
The default value is 10.0.0.10. ->As Router->Start
applicable to
It takes effect after a reboot. IP Address
SIP-T20P,

67
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

SIP-T22P,
SIP-T26P and
SIP-T28P IP
phones)

network.dhcp.
end_ip =

(only It configures the end IP address of the Network->PC Port


applicable to DHCP IP segment. ->PC Port Config
SIP-T20P, IP address
The default value is 10.0.0.100. ->As Router->End
SIP-T22P,
It takes effect after a reboot. IP Address
SIP-T26P and
SIP-T28P IP
phones)

It configures the transmission mode


and speed of the Internet (WAN) port.

0-Auto negotiate

1-Full duplex 10Mbps

2-Full duplex 100Mbps Network->


network.intern
0, 1, 2, 3, 4 or 3-Half duplex 10Mbps Advanced->Port
et_port.speed
5 4-Half duplex 100Mbps Link-> WAN Port
_duplex =
Link
5-Full duplex 1000Mbps (only
applicable to SIP-T42G and SIP-T46G 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 Network->
0, 1, 2, 3, 4 or 3-Half duplex 10Mbps
ort.speed_dup Advanced->Port
5 4-Half duplex 100Mbps
lex = Link->PC Port Link
5-Full duplex 1000Mbps (only
applicable to SIP-T42G and SIP-T46G IP
phones)

The default value is 0.

It takes effect after a reboot.

68
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

It enables or disables VLAN of the


Internet (WAN) port.
Network->
network.vlan.i
0-Disabled Advanced->VLAN
nternet_port_e 0 or 1
1-Enabled ->WAN Port->
nable =
The default value is 0. Active

It takes effect after a reboot.

It configures VLAN ID of the Internet Network->


network.vlan.i
Integer from (WAN) port. Advanced->VLAN
nternet_port_v
1 to 4094 The default value is 1. ->WAN Port->VID
id =
It takes effect after a reboot. (1-4094)

It configures VLAN priority of the Network->


network.vlan.i
Integer from Internet (WAN) port. Advanced->VLAN
nternet_port_p
0 to 7 The default value is 0. ->WAN Port->
riority =
It takes effect after a reboot. Priority

It enables or disables VLAN of the PC


(LAN) port.
network.vlan. Network->
0-Disabled
pc_port_enabl 0 or 1 Advanced->VLAN
1-Enabled
e= >PC Port->Active
The default value is 0.

It takes effect after a reboot.

It configures VLAN ID of the PC (LAN) Network->


network.vlan. Integer from port. Advanced->VLAN
pc_port_vid = 1 to 4094 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. Network->
Integer from (LAN) port.
pc_port_priorit Advanced->VLAN
0 to 7 The default value is 0.
y= >PC Port->Priority
It takes effect after a reboot.

network.vlan. It configures the way the phone


pc_port_mode processes packets sent from the PC
= port when VLAN is enabled on the PC

(only 0 or 1 port.

applicable to 0-Forward the packets directly


SIP-T4X IP 1-Tag and then forward the packets if
phones) there is no VLAN tag on the packets,

69
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

otherwise, forward the packets


directly.

The default value is 0.

It takes effect after a reboot.

It enables or disables the phone to


obtain VLAN by DHCP.
Network->
network.vlan.
0-Disabled Advanced->VLAN
dhcp_enable 0 or 1
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->
network.vlan. settings. You can configure at most five
Integer from Advanced->VLAN
dhcp_option DHCP options and separate them by
128 to 254 >DHCP VLAN->
= commas.
Option
The default value is 132.

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.


String within Features->General
network.dhcp For SIP-T21P IP phones:
99 Information->
_host_name = The default value is SIP-T21P.
characters DHCP Hostname
For SIP-T20P IP phones:

The default value is SIP-T20P.

For SIP-T19P IP phones:

The default value is SIP-T19P.

For SIP-T46G IP phones:

The default value is SIP-TT46G.

For SIP-T42G IP phones:

The default value is SIP-T42G.

70
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

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.
Network->
wui.http_enab 0-Disabled
0 or 1 Advanced->Web
le = 1-Enabled
Server->HTTP
The default value is 1.

It takes effect after a reboot.

It enables or disables the HTTPS


protocol for web server access.
Network->
wui.https_ena 0-Disabled
0 or 1 Advanced->Web
ble = 1-Enabled
Server->HTTPS
The default value is 1.

It takes effect after a reboot.

It configures the HTTP port for web Network->


network.port.h Integer from server access. Advanced->Web
ttp = 1 to 65535 The default value is 80. Server->HTTP Port

It takes effect after a reboot. (1~65535)

It configures the HTTPS port for web Network->


network.port.h Integer from server access. Advanced->Web
ttps = 1 to 65535 The default value is 443. Server->HTTPS Port

It takes effect after a reboot. (1~65535)

It configures the maximum local RTP Network->


Integer from
network.port. port. Advanced->Local
1024 to
max_rtpport = The default value is 11800. RTP Port-> Max RTP
65535
It takes effect after a reboot. Port (1024~65535)

It configures the minimum local RTP Network->


Integer from
network.port. port. Advanced->Local
1024 to
min_rtpport = The default value is 11780. RTP Port->Min RTP
65535
It takes effect after a reboot. Port (1024~65535)

It configures the voice QoS. Network->


network.qos.rt Integer from
The default value is 46. Advanced->Voice
ptos = 0 to 63
It takes effect after a reboot. QoS (0~63)

71
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

It configures the SIP QoS. Network->


network.qos.si Integer from
The default value is 26. Advanced->SIP
gnaltos = 0 to 63
It takes effect after a reboot. QoS (0~63)

It configures the 802.1x mode.

0-Disabled

1-EAP-MD5
Network->
network.802_1 2-EAP-TLS
0, 1, 2, 3 or 4 Advanced->802.1x
x.mode = 3-PEAP-MSCHAPV2
->802.1x Mode
4-EAP-TTLS/EAP-MSCHAPv2

The default value is 0.

It takes effect after a reboot.

It configures the user name for 802.1x


String within Network->
network.802_1 authentication.
32 Advanced->802.1x
x.identity = The default value is blank.
characters ->Identity
It takes effect after a reboot.

It configures the password for 802.1x


network.802_1 String within Network->
authentication.
x.md5_passw 32 Advanced->802.1x
The default value is blank.
ord = characters ->MD5 Password
It takes effect after a reboot.

It configures the access URL of the CA


certificate when the 802.1x mode is

network.802_1 URL within configured as EAP-TLS, Network->


x.root_cert_url 511 PEAP-MSCHAPV2 or Advanced->802.1x
= characters 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->
network.802_1 URL within device certificate when the 802.1x
Advanced->802.1x
x.client_cert_u 511 mode is configured as EAP-TLS.
->Device
rl = characters The default value is blank.
Certificates
It takes effect after a reboot.

network.vpn_ It enables or disables OpenVPN


Network->
enable = feature.
0 or 1 Advanced->VPN
(not 0-Disabled
->Active
applicable to 1-Enabled

72
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

SIP-T19P IP The default value is 0.


phones) It takes effect after a reboot.

openvpn.url =
Network->
(not URL within It configures the access URL of the *.tar
Advanced->VPN-
applicable to 511 file for OpenVPN.
>Upload VPN
SIP-T19P IP characters The default value is blank.
Config
phones)

It enables or disables LLDP feature.

0-Disabled Network->
network.lldp.e
0 or 1 1-Enabled Advanced->LLDP-
nable =
The default value is 1. >Active

It takes effect after a reboot.

It configures the interval (in seconds)


Network->
network.lldp.p for the phone to broadcast the LLDP
Integer from Advanced->LLDP-
acket_interval request.
1 to 3600 >Packet Interval
= The default value is 60.
(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
enabled, all packets from WAN port Network->
network.span_ can be received by PC port. Advanced->Span
0 or 1
to_pc_port = to PC->Span to PC
0-Disabled
Port
1-Enabled

The default value is 0.

It takes effect after a reboot.

Network->
It configures the maximum duration (in
Advanced->
seconds) for account register after
sip.reg_surge_ Integer from Registration
startup.
prevention = 0 to 60 Random->
The default value is 0.
Registration
It takes effect after a reboot.
Random (0~60s)

It configures from where the phone


sip.send_resp retrieves the destination address for
onse_by_requ 0 or 1 response. The phone will then send all
est = SIP response messages to the
destination address.

73
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

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”.

0-The phone will reboot only if the SIP


sip.notify_rebo
0, 1or 2 NOTIFY message contains an
ot_enable =
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.
Settings->
syslog.mode
0 or 1 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
exporting log to the syslog server.
IP address Settings->
syslog.server
or domain It takes effect only if the parameter Configuration->
=
name “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.
Settings->
syslog.log_lev Integer from
0 means nothing and 6 means all. Configuration->
el = 0 to 6
The default value is 3. System Log Level

It takes effect after a reboot.

74
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

It enables or disables the phone to


perform an auto provisioning process
when powered on.

0-Disabled Settings->Auto
auto_provision
0 or 1 1-Enabled Provision->Power
.power_on =
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 to obtain a provisioning server Settings->Auto
.pnp_enable 0 or 1 address after startup. Provision->PNP
= Active
0-Disabled

1-Enabled

The default value is 1.

It enables or disables the phone to


check new configuration weekly.
auto_provision
Settings->Auto
.weekly.enabl 0 or 1 0-Disabled
provision->Weekly
e= 1-Enabled

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
2-Tuesday
auto_provision or a Settings->Auto
3-Wednesday
.weekly.dayof combination provision->Day of
4-Thursday
week = of these week
5-Friday
digits
6-Saturday

Example:

auto_provision.weekly.dayofweek =
01 means the phone will check the
new configuration every Sunday and

75
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

Monday.

The default value is 0123456.

Note: The old parameter


“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
The default value is 00:00. Settings->Auto
.weekly.begin 00:00 to
Note: The old parameter provision->Time
_time = 23:59
“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
configuration weekly.
auto_provision Time from
The default value is 00:00. Settings->Auto
.weekly.end_ti 00:00 to
Note: The old parameter provision->Time
me = 23:59
“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 Settings->Auto
.repeat.enabl 0 or 1 0-Disabled provision->
e= 1-Enabled Repeatedly

The default value is 0.

It configures the interval (in minutes)


for the phone to check new
configuration repeatedly.
auto_provision Settings->Auto
Integer from The default value is 1440.
.repeat.minut provision->Interval
1 to 43200 Note: The old parameter
es = (minutes)
“auto_provision.schedule.periodic_min
ute” is also applicable to
SIP-T28P/T26P/T22P/T20P IP phones.

76
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

It enables or disables the phone to


obtain the provisioning server address
auto_provision by detecting DHCP options. Settings->Auto
.dhcp_option. 0 or 1 Provision->DHCP
0-Disabled
enable = Active
1-Enabled

The default value is 1.

auto_provision
It configures the custom DHCP option Settings->Auto
.dhcp_option.l Integer from
for provisioning server address. Provision->Custom
ist_user_optio 128 to 254
The default value is blank. Option (128~254)
ns =

URL within It configures the access URL of Settings->Auto


auto_provision
511 configuration files. Provision->Server
.server.url =
characters The default value is blank. URL

It configures the user name for


auto_provision String within Settings->Auto
authentication during auto
.server.userna 32 Provision->User
provisioning.
me = characters Name
The default value is blank.

It configures the password for


auto_provision String within Settings->Auto
authentication during auto
.server.passw 32 Provision->
provisioning.
ord = characters Password
The default value is blank.

auto_provision
String within It configures the value (vendor name Settings->Auto
.dhcp_option.
99 of the device) of DHCP option 60. Provision->DHCP
option60_valu
characters The default value is yealink. Option Value
e=

It configures the AES key for

auto_provision decrypting the Common CFG file. Settings->Auto


16
.aes_key_16.c The valid characters contain: 0 ~ 9, A Provision->
characters
om = ~ Z, a ~ z. Common AES Key

The default value is blank.

It configures the AES key for


decrypting the MAC-Oriented CFG Settings->Auto
auto_provision
16 file. Provision->
.aes_key_16.m
characters The valid characters contain: 0 ~ 9, A MAC-Oriented
ac =
~ Z, a ~ z. AES Key

The default value is blank.

77
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
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
<MAC_Security>.enc files during auto
.aes_key_in_fil 0 or 1
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. It configures the name of the code for


String within
X.name = triggering auto provisioning.
64
(X ranges The default value is blank.
characters
from 1 to 50) It takes effect after a reboot.

It configures the code for triggering


auto provisioning.
autoprovision.
Valid characters are digits, # and *.
X.code =
String Example:
(X ranges
autoprovision.1.code = *99
from 1 to 50)
The default value is blank.

It takes effect after a reboot.

autoprovision. It configures the access URL of auto


URL within
X.url = provisioning server.
511
(X ranges The default value is blank.
characters
from 1 to 50) It takes effect after a reboot.

It configures the user name for


autoprovision.
String within authentication during auto
X.user =
64 provisioning.
(X ranges
characters The default value is blank.
from 1 to 50)
It takes effect after a reboot.

78
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

It configures the password for


autoprovision.
String within authentication during auto
X.password =
32 provisioning.
(X ranges
characters The default value is blank.
from 1 to 50)
It takes effect after a reboot.

autoprovision. It configures the AES key for

X.com_aes = 16 decrypting the Common CFG file.

(X ranges characters The default value is blank.

from 1 to 50) It takes effect after a reboot.

It configures the AES key for


autoprovision.
decrypting the MAC-Oriented CFG
X.mac_aes = 16
file.
(X ranges characters
The default value is blank.
from 1 to 50)
It takes effect after a reboot.

It enables or disables the phone to


reserve the pound sign when dialing
out. Features->General
sip.use_23_as Information->
0 or 1 0-Disabled (convert the pound sign
_pound = Reserve # in User
into “%23”)
Name
1-Enabled

The default value is 1.

It enables or disables the phone to


support RFC 2543 hold (c=0.0.0.0).
Features->General
sip.rfc2543_ho
0 or 1 0-Disabled Information->RFC
ld =
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. Features->General
sip.use_out_b
Information->Use
ound_in_dialo 0 or 1 0-Disabled
Outbound Proxy In
g= 1-Enabled
Dialog
The default value is 1.

It takes effect after a reboot.

It enables or disables Watch Dog Settings->


watch_dog.en
0 or 1 feature. If it is enabled, the phone will Preference->
able =
reboot automatically when the system Watch Dog

79
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

is broken down.

0-Disabled

1-Enabled

The default value is 1.

managements
erver.enable
= It enables or disables TR069 feature.
0-Disabled Settings->TR069->
(not
0 or 1
applicable to 1-Enabled Enable TR069

SIP-T41P and The default value is 0.


SIP-T42G IP
phones)

managements
erver.usernam
e=
String within It configures the user name for the
(not Settings->TR069->
128 phone to authenticate with the ACS.
applicable to ACS Username
characters The default value is blank.
SIP-T41P and
SIP-T42G IP
phones)

managements
erver.passwor
d=
String within It configures the password for the
(not Settings->TR069->
64 phone to authenticate with the ACS.
applicable to ACS Password
characters The default value is blank.
SIP-T41P and
SIP-T42G IP
phones)

managements
erver.url =

(not URL within It configures the access URL of the


Settings->TR069->
applicable to 511 ACS.
ACS URL
SIP-T41P and characters The default value is blank.
SIP-T42G IP
phones)

managements It enables or disables the phone to Settings->TR069->

erver.periodic 0 or 1 report its configuration to the ACS. Enable Periodic

_inform_enabl 0-Disabled Inform

80
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

e= 1-Enabled

(not The default value is 1.


applicable to
SIP-T41P and
SIP-T42G IP
phones)

managements
erver.periodic
_inform_interv
It configures the interval (in seconds)
al = Integer from Settings->TR069->
for the phone to report its configuration
(not 5 to Periodic Inform
to the ACS.
applicable to 4294967295 Interval (seconds)
The default value is 60.
SIP-T41P and
SIP-T42G IP
phones)

managements
erver.connecti
on_request_us
It configures the user name for the
ername = String within Settings->TR069->
phone to authenticate the connection
(not 128 Connection
requests.
applicable to characters Request Username
The default value is blank.
SIP-T41P and
SIP-T42G IP
phones)

managements
erver.connecti
on_request_p
It configures the password for the
assword = String within Settings->TR069->
phone to authenticate the connection
(not 64 Connection
requests.
applicable to characters Request Password
The default value is blank.
SIP-T41P and
SIP-T42G IP
phones)

It enables or disables the transferee


party’s phone to prompt a missed call
transfer.semi_ Features->Transfer
on the LCD screen before displaying
attend_tran_e 0 or 1 ->Semi-Attend
the caller ID when performing a
nable = Transfer
semi-attended transfer.

0-Enabled

81
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

1-Disabled

The default value is 1.

It enables or disables the phone to


complete the blind transfer through
transfer.blind_ on-hook. Features->Transfer
tran_on_hook_ 0 or 1 ->Blind Transfer On
0-Disabled
enable = Hook
1-Enabled

The default value is 1.

It enables or disables the phone to


complete the attended transfer
transfer.on_ho through on-hook. Features->Transfer
ok_trans_ena 0 or 1 ->Semi Attend
0-Disabled
ble = Transfer On Hook
1-Enabled

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
Features->Transfer
transfer.dsske BLF/BLF list key.
0, 1 or 2 ->Transfer Mode
y_deal_type =
0-New Call 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 = Features->General
calls when pressing the transfer soft
(not key or TRAN key. Information->
0 or 1
applicable to Allow Trans Exist
0-Disabled
SIP-T20P and Call
1-Enabled
SIP-T4X IP
The default value is 1.
phones)

It enables or disables the phone to


Features->Transfer
transfer.tran_o transfer call to the two parties after a
->Transfer on
thers_after_co 0 or 1 local conference call hangs up.
Conference Hang
nf_enable = 0-Disabled
up
1-Enabled

82
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

The default value is 0.

It enables or disables VAD (Voice


Activity Detection) feature.
Settings->Voice->
voice.vad = 0 or 1 0-Disbaled Echo Cancellation
1-Enabled ->VAD

The default value is 0.

It enables or disables CNG


(Comfortable Noise Generator)
feature. Settings->Voice->
voice.cng = 0 or 1 Echo Cancellation
0-Disabled
->CNG
1-Enabled

The default value is 1.

It enables or disables AEC (Acoustic


Echo Canceller) feature. Settings->Voice->
voice.echo_ca
0 or 1 0-Disabled Echo Cancellation
ncellation =
1-Enabled ->ECHO

The default value is 1.

It configures the type of jitter buffer.


Settings->Voice->
voice.jib.adap 0-Fixed
0 or 1 JITTER BUFFER->
tive = 1-Adaptive
Type
The default value is 1.

It configures the minimum delay (in Settings->Voice->


voice.jib.min Integer from
milliseconds) of jitter buffer. JITTER BUFFER->
= 0 to 400
The default value is 60. Min Delay

It configures the maximum delay (in Settings->Voice->


voice.jib.max Integer from
milliseconds) of jitter buffer. JITTER BUFFER->
= 0 to 400
The default value is 240. Max Delay

It configures the normal delay (in Settings->Voice->


voice.jib.norm Integer from
milliseconds) of jitter buffer. JITTER BUFFER->
al = 0 to 400
The default value is 120. Normal

Custom,
It configures the country tone for the
voice.tone.cou Australia, Settings->Tones->
phone.
ntry = Austria, Select Country
The default value is Custom.
Brazil,

83
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

Belgium,
China,
Czech,
Denmark,
Finland,
France,
Germany,
Great
Britain,
Greece,
Hungary,
Lithuania,
India, Italy,
Japan,
Mexico,
New
Zealand,
Netherlands,
Norway,
Portugal,
Spain,
Switzerland,
Sweden,
Russia,
United
States,
Chile, Czech
ETSI

It customizes the dial tone when the


parameter "voice.tone.country" is set
to Custom.

tonelist = element[,element]
[,element]…

voice.tone.dia Where Settings->Tones->


String
l= Dial
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

84
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

at most four different frequencies.

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 The value format is Freq/Duration. For Settings->Tones->


String
g= 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 The value format is Freq/Duration. For Settings->Tones->


String
y= 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 Settings->Tones->
String The value format is Freq/Duration. For
gestion = Congestion
more information on the value format,
refer to the parameter
“voice.tone.dial”.

85
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

The default value is blank.

It customizes the call waiting tone


when the parameter
"voice.tone.country" is set to Custom.

voice.tone.call The value format is Freq/Duration. For Settings->Tones->


String
waiting = 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 The value format is Freq/Duration. For Settings->Tones->


String
lrecall = 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 The value format is Freq/Duration. For Settings->Tones->


String
o= 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 The value format is Freq/Duration. For Settings->Tones->


String
ter = 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
Settings->Tones->
(not String set to Custom.
Message
applicable to The value format is Freq/Duration. For
SIP-T20P, more information on the value format,

86
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

SIP-T41P and refer to the parameter


SIP-T42G IP “voice.tone.dial”.
phones) The default value is blank.

It customizes the warning tone for auto


answer when the parameter
"voice.tone.country" is set to Custom.

voice.tone.aut The value format is Freq/Duration. For Settings->Tones->


String
oanswer = more information on the value format, Auto Answer
refer to the parameter
“voice.tone.dial”.

The default value is blank.

It configures the receiving volume of


voice.group_s Integer from
the group listening mode.
pk_vol = 1 to 15
The default value is 8.

voice.ring_vol Integer from It configures the volume of ringer.

= 1 to 15 The default value is 8.

It configures the receiving volume of


speaker.
voice.handfre Integer from
The default value is 8.
e.spk_vol = 1 to 15
It takes effect after a reboot (only for
SIP-T20P/T22P/T26P/T28P IP phones).

It configures the receiving volume of


handset.
voice.handset Integer from
The default value is 8.
.spk_vol = 1 to 15
It takes effect after a reboot (only for
SIP-T20P/T22P/T26P/T28P IP phones).

It configures the receiving volume of


headset.
voice.headset Integer from
The default value is 8.
.spk_vol = 1 to 15
It takes effect after a reboot (only for
SIP-T20P/T22P/T26P/T28P IP phones).

It configures the dial tone volume of


speaker.
voice.handfre Integer from
The default value is 8.
e.tone_vol = 1 to 15
It takes effect after a reboot (only for
SIP-T20P/T22P/T26P/T28P IP phones).

87
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

It configures the dial tone volume of


handset.
voice.handset Integer from
The default value is 8.
.tone_vol = 1 to 15
It takes effect after a reboot (only for
SIP-T20P/T22P/T26P/T28P IP phones).

It configures the dial tone volume of


headset.
voice.headset Integer from
The default value is 8.
.tone_vol = 1 to 15
It takes effect after a reboot (only for
SIP-T20P/T22P/T26P/T28P IP phones).

voice.handfre
e_send =

(only It configures the sending volume of Features->


applicable to speaker.
Integer from Audio->Handfree
SIP-T20P,
1 to 53 The default value is 35. Send Volume
SIP-T22P,
It takes effect after a reboot. (1~53)
SIP-T26P and
SIP-T28P IP
phones)

voice.handset
_send =

(only It configures the sending volume of Features->


applicable to handset.
Integer from Audio->Handset
SIP-T20P,
1 to 53 The default value is 25. Send Volume
SIP-T22P,
It takes effect after a reboot. (1~53)
SIP-T26P and
SIP-T28P IP
phones)

voice.headset
_send =

(only It configures the sending volume of Features->


applicable to headset.
Integer from Audio->Headset
SIP-T20P,
1 to 53 The default value is 30. Send Volume
SIP-T22P,
It takes effect after a reboot. (1~53)
SIP-T26P and
SIP-T28P IP
phones)

88
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

It enables or disables the phone to


only accept the certificates in the
Trusted Certificates list. Security->Trusted
security.trust_c Certificates->Only
0 or 1 0-Disabled
ertificates = Accept Trusted
1-Enabled
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.

0-Default certificates Security->Trusted


security.ca_ce
0, 1 or 2 Certificates->CA
rt = 1-Custom certificates
Certificates
2-All 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
the certificate received from the Security->Trusted
security.cn_val connecting server. Certificates->Com
0 or 1
idation = mon Name
0-Disabled
Validation
1-Enabled

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->Server
security.dev_c
0 or 1 0-Default certificates Certificates->Devi
ert =
1-Custom certificates ce Certificates

The default value is 0.

It takes effect after a reboot.

String within It configures the user name of the user


security.user_n
32 for web server access.
ame.user =
characters The default value is user.

security.user_n String within It configures the user name of the


ame.admin = 32 administrator for web server access.

89
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

characters The default value is admin.

String within It configures the user name of the var


security.user_n
32 for web server access.
ame.var =
characters The default value is var.

It configures the password of the user,


var and administrator.

The valid value format is


username:new password.

String within Example:


security.user_ Security->Passwor
32 security.user_password =
password = d
characters 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 0-Disabled
0 or 1
nable = 1-Enabled

The default value is 0.

It takes effect after a reboot.

It configures the access URL of the file,

URL within which defines 3-level access


web_item_lev
511 permissions.
el.url =
characters 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.


Settings->Softkey

(not 0 or 1 0-Disabled Layout->Custom

applicable to 1-Enabled Softkey

SIP-T20P IP The default value is 0.


phones)

custom_softke URL within It configures the access URL of the file


y_call_failed.u 511 for custom soft keys layout on the LCD
rl = characters screen when Call failed.

90
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

(not The default value is blank.


applicable to
SIP-T20P IP
phones)

custom_softke
y_call_in.url = It configures the access URL of the file
URL within
(not for custom soft keys layout on the LCD
511
applicable to screen when Call in.
characters
SIP-T20P IP The default value is blank.
phones)

custom_softke
y_connecting.
It configures the access URL of the file
url = URL within
for custom soft keys layout on the LCD
(not 511
screen when Connecting.
applicable to characters
The default value is blank.
SIP-T20P IP
phones)

custom_softke
y_dialing.url = It configures the access URL of the file
URL within
(not for custom soft keys layout on the LCD
511
applicable to screen when Dialing.
characters
SIP-T20P IP The default value is blank.
phones)

custom_softke
y_ring_back.ur
It configures the access URL of the file
l= URL within
for custom soft keys layout on the LCD
(not 511
screen when Ringback.
applicable to characters
The default value is blank.
SIP-T20P IP
phones)

custom_softke
y_talking.url = It configures the access URL of the file
URL within
(not for custom soft keys layout on the LCD
511
applicable to screen when Talking.
characters
SIP-T20P IP The default value is blank.
phones)

memorykey.X. It configures the desired feature for DSSKey->Memory


Integer
type = memory key X. Key->Memory

91
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

(X ranges Valid values are: KeyX->Type


from 1 to 10) 0-N/A
(only 1-Conference
applicable to
2-Forward
SIP-T26P and
3-Transfer
SIP-T28P IP
phones) 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

92
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

50-Keypad Lock

55-Meet-Me Conference

56-Retrieve Park

57-Hoteling

58-ACD Trace

59-Disp Code

60-Emergency

61-Directory

The default value is 0.

It configures the desired line to apply


memorykey.X.l
the key feature.
ine =
1-Line 1
(X ranges
2-Line 2
from 1 to 10) DSSKey->Memory
Integer from
3-Line 3 Key->Memory
(only
1 to 6
applicable to 4-Line 4 KeyX->Line

SIP-T26P and 5-Line 5


SIP-T28P IP
6-Line 6
phones)
The default value is 1.

memorykey.X.
value =
It configures the value of the memory
(X ranges
key feature.
from 1 to 10) String within DSSKey->Memory
For example, when setting the key
(only 99 Key->Memory
feature to BLF, it configures the number
applicable to characters KeyX->Value
of the monitored user.
SIP-T26P and
The default value is blank.
SIP-T28P IP
phones)

memorykey.X.
pickup_value It configures the pickup code for BLF

= feature or conference ID followed by

String within the # sign for Meet-Me conference DSSKey->Memory


(X ranges
256 feature. Key->Memory
from 1 to 10)
characters It only applies to BLF and Meet-Me KeyX->Extension
(only
conference features.
applicable to
SIP-T26P and The default value is blank.

SIP-T28P IP

93
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

phones)

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
XML Group (remote phone book), DSSKey->Memory
from 1 to 10) Integer from
valid values are: Key->Memory
(only 0 to 5
KeyX->Line
0-First XML group
applicable to
SIP-T26P and 1-Second XML group

SIP-T28P IP 2-Third XML group


phones) 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.type It configures the key feature for the line


DSSKey->Line
= key X.
Integer Key->Line
(SIP-T20P/T21P: Valid values are:
KeyX->Type
X ranges from 0-N/A (only applicable to SIP-T4X IP

94
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

1 to 2. phones)

SIP-T22P/T26P: 1-Conference
X ranges from 2-Forward
1 to 3.
3-Transfer
SIP-T28P: X
4-Hold
ranges from 1
5-DND
to 6.
7-Call Return
SIP-T41P/T42G:
X ranges from 8-SMS (not applicable to SIP-T20P,

1 to 15. SIP-T41P and SIP-T42G IP phones)

SIP-T46G: X 9-Directed Pickup

ranges from 1 10-Call Park


to 27) 11-DTMF
(not 12-Voice Mail
applicable to
13-Speed Dial
SIP-T19P IP
14-Intercom
phones)
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

95
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

45-Local Group

46-Network Group (not applicable to


SIP-T20P IP phones)

49-Custom Button (not applicable to


SIP-T4X IP phones)

50-Keypad Lock

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-T46G IP phones)

63-UC Favorite (only applicable to


SIP-T46G IP phones)

64-Buddies (only applicable to


SIP-T46G IP phones)

65-My Status (only applicable to


SIP-T46G IP phones)

For SIP-T19P/T2xP IP phones:

The default value is 15.

For SIP-T41P/T42G 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.

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.

linekey.X.line
It configures the desired line to apply
=
the key feature.
DSSKey->Line
(SIP-T20P/T21P: Integer from
1-Line 1 Key->Line
X ranges from 1 to 6
2-Line 2 KeyX->Line
1 to 2.
3-Line 3
SIP-T22P/T26P:

96
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

X ranges from 4-Line 4


1 to 3. 5-Line 5
SIP-T28P: X 6-Line 6
ranges from 1
When X=1, the default value is 1.
to 6.
When X=2, the default value is 2.
SIP-T41P/T42G:
When X=3, the default value is 3.
X ranges from
1 to 15. When X=4, the default value is 4.

SIP-T46G: X When X=5, the default value is 5.

ranges from 1 When X=6, the default value is 6.


to 27) Line 3 is only applicable to SIP-T22P,
(not SIP-T26P, SIP-T28P and SIP-T4X IP phones.
applicable to Lines 4-6 are only applicable to
SIP-T19P IP SIP-T28P and SIP-T46G IP phones.
phones)

linekey.X.valu
e=

(SIP-T20P/T21P:
X ranges from
1 to 2.

SIP-T22P/T26P:
X ranges from
1 to 3.
It configures the value of the line key
SIP-T28P: X
feature.
ranges from 1 String within DSSKey->Line
For example, when setting the key
to 6. 99 Key->Line
feature to BLF, it configures the number
SIP-T41P/T42G: characters KeyX->Value
of the monitored user.
X ranges from
The default value is blank.
1 to 15.

SIP-T46G: X
ranges from 1
to 27)

(not
applicable to
SIP-T19P IP
phones)

linekey.X.pick String within It configures the pickup code for BLF DSSKey->Line
up_value = 256 feature or conference ID followed by Key->Line

(SIP-T20P/T21P: characters the # sign for Meet-Me conference KeyX->Extension

97
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

X ranges from feature.


1 to 2. It only applies to BLF and Meet-Me
SIP-T22P/T26P: conference features.
X ranges from The default value is blank.
1 to 3.

SIP-T28P: X
ranges from 1
to 6.

SIP-T41P/T42G:
X ranges from
1 to 15.

SIP-T46G: X
ranges from 1
to 27)

(not
applicable to
SIP-T19P IP
phones)

linekey.X.xml_ It configures the desired local


phonebook = group/XML group/network group for
the line key X.
(SIP-T20P/T21P:
X ranges from It only applies to the Local Group, XML

1 to 2. Group and Network Group features.

SIP-T22P/T26P: XML Group and Network Group

X ranges from features are not applicable to SIP-T20P


1 to 3. IP phones.

SIP-T28P: X When the key feature is configured as

ranges from 1 Local Group, valid values are: DSSKey->Line


Integer from
to 6. 0-All contacts Key->Line
0 to 48
SIP-T41P/T42G: KeyX->Line
1-First local group
X ranges from
2-Second local group
1 to 15.
3-Third local group
SIP-T46G: X
4-Fourth local group
ranges from 1
5-Fifth local group
to 27)

(not
applicable to 48-Forty-eighth local group

SIP-T19P IP Local groups 6-48 are only applicable


phones) to SIP-T4X IP phones.

98
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

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.

linekey.X.label
=

(SIP-T20P/T21P:
X ranges from
1 to 2.

SIP-T22P/T26P:
X ranges from
1 to 3.

SIP-T28P: X
String within It configures the label displayed on the DSSKey->Line
ranges from 1
99 LCD screen for each line key. Key->Line
to 6.
characters The default value is blank. KeyX->Label
SIP-T41P/T42G:
X ranges from
1 to 15.

SIP-T46G: X
ranges from 1
to 27)

(not
applicable to
SIP-T19P IP

99
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

phones)

It configures the key feature for the


programmable key X.

Valid values are:

0-N/A

2-Forward

5-DND

7-Call Return

8-SMS (not applicable to SIP-T20P,


SIP-T41P and SIP-T42G IP phones)

programablek 9-Directed Pickup


ey.X.type = 13-Spead Dial
(SIP-T19P: 22-XML Group (not applicable to
X=1-9, 13, 14; SIP-T19P IP phones)
SIP-T20P:
23-Group Pickup
X=5-12, 14;
27-XML Browser
SIP-T21P:
X=1-10, 14; 28-History
DSSKey->
SIP-T22P: Integer 30-Menu Programmable
X=1-10, 12-14. 31-Switch Account (not applicable to Key->Type
SIP-T26/T28P: X SIP-T19P and SIP-T4X IP phones)
ranges from 1 32-New SMS (not applicable to
to 14. SIP-T20P, SIP-T41P and SIP-T42G IP
SIP-T41P/T42G: phones)
X=1-10, 13. 33-Status
SIP-T46G: 34-Hot Desking (only applicable to
X=1-10, 12-14) SIP-T19P 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

100
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

46-Network Group

47-XML Directory (not applicable to


SIP-T20P IP phones)

50-Keypad Lock

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-T46G IP phones)

65-My Status (only applicable to


SIP-T46G IP phones)

programablek
ey.X.line =
It configures the desired line to apply
(SIP-T19P:
the programmable key feature.
X=1-9, 13, 14;
1-Line 1
SIP-T20P:
2-Line 2
X=5-12, 14;
SIP-T21P: 3-Line 3

X=1-10, 14; 4-Line 4 DSSKey->


Integer from
SIP-T22P: Programmable
5-Line 5
1 to 6
X=1-10, 12-14 Key->Line
6-Line 6
SIP-T26/T28P: X
Line 3 is only applicable to SIP-T22P,
ranges from 1
SIP-T26P, SIP-T28P and SIP-T4X IP phones.
to 14.
Lines 4-6 are only applicable to
SIP-T41P/T42G:
SIP-T28P and SIP-T46G IP phones.
X=1-10, 13.
The default value is 1.
SIP-T46G:
X=1-10, 12-14)

programablek
It configures the value of the
ey.X.value =
programmable key feature.
(SIP-T19P: String within DSSKey->
For example, when configuring the key
X=1-9, 13, 14; 99 Programmable
feature to be Speed Dial, it configures
SIP-T20P: characters Key->Value
the number.
X=5-12, 14;
The default value is blank.
SIP-T21P:

101
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

X=1-10, 14;
SIP-T22P:
X=1-10, 12-14

SIP-T26/T28P: X
ranges from 1
to 14.

SIP-T26/T28P: X
ranges from 1
to 14.

SIP-T41P/T42G:
X=1-10, 13.

SIP-T46G:
X=1-10, 12-14)

It configures the desired local


group/XML group/network group for
the programmable key.
programablek
ey.X.xml_phon It only applies to the Local Group, XML

ebook = Group and Network Group features.

(SIP-T19P: XML Group and Network Group

X=1-9, 13, 14; features are not applicable to SIP-T20P

SIP-T20P: IP phones.

X=5-12, 14; When the key feature is configured as


SIP-T21P: Local Group, valid values are:
X=1-10, 14; 0-All contacts
SIP-T22P:
1-First local group DSSKey->
X=1-10, 12-14 Integer from
Programmable
0 to 48 2-Second local group
SIP-T26/T28P: X Key->Line
3-Third local group
ranges from 1
to 14. 4-Fourth local group

SIP-T26/T28P: X 5-Fifth local group

ranges from 1 …
to 14. 48-Forty-eighth local group
SIP-T41P/T42G: Local groups 6-48 are only applicable
X=1-10, 13. to SIP-T4X IP phones.
SIP-T46G: When the key feature is configured as
X=1-10, 12-14) XML Group (remote phone book),
valid values are:

0-First XML group

102
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

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
pe =

(SIP-T19P:
X=1-9, 13, 14;
SIP-T21P:
X=1-10, 14;
SIP-T22P:
It configures the history type of
X=1-10, 12-14
programmable key.
DSSKey->
SIP-T26/T28P: X
Integer 0-Local History Programmable
ranges from 1
1-Network History Key->Line
to 14.
The default value is 0.
SIP-T41P/T42G:
X=1-10, 13.

SIP-T46G:
X=1-10, 12-14)

(not
applicable to
SIP-T20P IP
phones)

programablek
String within It configures the label displayed on the DSSKey->
ey.X.label =
99 LCD screen for each soft key. Programmable
(X ranges
characters The default value is blank. Key->Label
from 1 to 4)

103
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

(not
applicable to
SIP-T20P IP
phones)

programablek
ey.X.pickup_v
alue =

(SIP-T19P:
X=1-9, 13, 14;
SIP-T20P:
X=5-12, 14; It configures conference ID followed by
SIP-T21P: the # sign for Meet-Me conference
String within DSSKey->Program
X=1-10, 14; feature.
256 mable
SIP-T22P: It only applies to Meet-Me conference
characters Key->Extension
X=1-10, 12-14 feature.
SIP-T26/T28P: X The default value is blank.
ranges from 1
to 14.

SIP-T41P/T42G:
X=1-10, 13.

SIP-T46G:
X=1-10, 12-14)

expansion_mo It configures the key feature of the


dule.X.key.Y.ty expansion module X key Y.
pe =
Valid values are:
(SIP-T26P: X
0-NA
ranges from 1
1-Conference
to 3.
2-Forward
SIP-T28P/T46G:
3-Transfer
X ranges from
DSSKey->Ext
1 to 6. Integer 4-Hold
Key->Type
Y ranges from 5-DND

1 to 40) 7-Call Return

(only 8-SMS
applicable to
9-Directed Pickup
SIP-T26P,
10-Call Park
SIP-T28P and
11-DTMF
SIP-T46G IP
phones) 12-Voice Mail

104
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

13-Speed Dial

14-Intercom

15-Line

16-BLF

17-URL

18-Group Listening

20-Private Hold

22-XML Group

23-Group Pickup

24-Multicast Paging

25-Record

27-XML Browser

34-Hot Desking

35-URL Record

37-Switch (not applicable to SIP-T46G


IP phones)

38-LDAP

39-BLF List

40-Prefix

41-Zero Touch

42-ACD

45-Local Group

46-Network Group

49-Custom Button

50-Keypad Lock

55-Meet-Me Conference

56-Retrieve Park

57-Hoteling

58-ACD Grace

59-Disp Code

60-Emergency

61-Directory

62-Network Favorite (only applicable


to SIP-T46G IP phones)

63-UC Favorite (only applicable to

105
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

SIP-T46G IP phones)

64-Buddies (only applicable to


SIP-T46G IP phones)

65-My Status (only applicable to


SIP-T46G IP phones)

For SIP-T26P/T28P 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-T46G IP phones:

The default value is 0.

expansion_mo
dule.X.key.Y.lin
e=
It configures the desired line to apply
(SIP-T26P: X
the expansion module key feature.
ranges from 1
1-Line 1
to 3.
2-Line 2
SIP-T28P/T46G:
X ranges from 3-Line 3
Integer from DSSKey->Ext
1 to 6. 4-Line 4
1 to 6 Key->Line
Y ranges from 5-Line 5
1 to 40) 6-Line 6
(only Lines 4-6 are only applicable to
applicable to SIP-T28P and SIP-T46G IP phones.
SIP-T26P,
The default value is 1.
SIP-T28P and
SIP-T46G IP
phones)

expansion_mo
dule.X.key.Y.v
alue =

(SIP-T26P: X
String within It configures the value of the
ranges from 1 DSSKey->Ext
99 expansion module key feature.
to 3. Key->Value
characters The default value is blank.
SIP-T28P/T46G:
X ranges from
1 to 6.

Y ranges from

106
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

1 to 40)

(only
applicable to
SIP-T26P,
SIP-T28P and
SIP-T46G IP
phones)

expansion_mo
dule.X.key.Y.pi
ckup_value =

(X ranges It configures the pickup code for BLF


from 1 to 6. feature or conference ID followed by

String within the # sign for Meet-Me conference


Y ranges from
DSSKey->Ext
255 feature.
1 to 40)
Key->Extension
characters It only applies to BLF and Meet-Me
(only
conference features.
applicable to
SIP-T26P, The default value is blank.

SIP-T28P and
SIP-T46G IP
phones)

expansion_mo
dule.X.key.Y.la
bel =

(X ranges
from 1 to 6.
It configures the label displayed on the
Y ranges from String within
LCD screen of the expansion module DSSKey->Ext
1 to 40) 99
for each key. Key->Label
characters
(only
The default value is blank.
applicable to
SIP-T26P,
SIP-T28P and
SIP-T46G IP
phones)

expansion_mo
It only applies to the Local Group, XML
dule.X.key.Y.x
Group and Network Group features. DSSKey->Ext
ml_phoneboo Integer from
When the key feature is configured as Key->Ext
k= 0 to 48
Local Group, valid values are: KeyX->Line
(X ranges
0-All contacts
from 1 to 6.

107
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

Y ranges from 1-First local group


1 to 40) 2-Second local group
(only 3-Third local group
applicable to
4-Fourth local group
SIP-T26P,
5-Fifth local group
SIP-T28P and
SIP-T46G IP …

phones) 48-Forty-eighth local group

Local groups 6-48 are only applicable


to SIP-T46G 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.

It enables or disables the phone to


phone_setting
display page icons on LCD screen and
.page_tip =
flash page switch key LED to indicate
DSSKey->Line
(only different states of line keys.
0 or 1 key->Enable Page
applicable to
0-Disabled Tips
SIP-T4X IP
1-Enabled
phones)
The default value is 0.

phone_setting Resource:X It configures the wallpaper displayed Settings->


.backgrounds (Valid values on the phone. Preference->
= of X are: Example: Wallpaper

108
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

(only Default.jpg, To configure a phone built-in picture


applicable to 1.png, (e.g., 1.png) to be wallpaper, the
SIP-T46G IP value format is:
2.png,
phones) phone_setting.backgrounds =
3.png,
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.
Config:wallp
aper name

wallpaper_upl
oad.url = Settings->
URL within It configures the access URL of the
(only Preference->Uploa
511 custom wallpaper image.
applicable to d Wallpaper
characters The default value is blank.
SIP-T46G IP (480*272)

phones)

It enables or disables always forward


feature.
Features->Forwar
forward.alwa
0 or 1 0-Disabled d &DND->Always
ys.enable =
1-Enabled Forward->On/Off

The default value is 0.

String within It configures the target number the Features->Forwar


forward.alwa
32 phone forwards all incoming calls to. d &DND->Always
ys.target =
characters The default value is blank. Forward->Target

Features->Forwar
String within It configures the always forward on
forward.alwa d &DND->Always
32 code.
ys.on_code = Forward->On
characters The default value is blank.
Code

Features->Forwar
String within It configures the always forward off
forward.alwa d &DND->Always
32 code.
ys.off_code = Forward->Off
characters The default value is blank.
Code

It enables or disables busy forward Features->Forwar


forward.busy.
0 or 1 feature. d &DND->Busy
enable =
0-Disabled Forward->On/Off

109
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

1-Enabled

The default value is 0.

It configures the target number the


String within Features->Forwar
forward.busy.t phone forwards incoming calls to
32 d &DND->Busy
arget = when busy.
characters Forward->Target
The default value is blank.

Features->Forwar
String within
forward.busy. It configures the busy forward on code. d &DND->Busy
32
on_code = The default value is blank. Forward->On
characters
Code

Features->Forwar
String within
forward.busy. It configures the busy forward off code. d &DND->Busy
32
off_code = The default value is blank. Forward->Off
characters
Code

It enables or disables no answer


forward feature. Features->Forwar
forward.no_a
d &DND->No
nswer.enable 0 or 1 0-Disabled
Answer
= 1-Enabled
Forward->On/Off
The default value is 0.

It configures the target number the Features->Forwar


forward.no_a String within
phone forwards incoming calls to after d &DND->No
nswer.target 32
a period of ring time. Answer
= characters
The default value is blank. Forward->Target

It configures ring times (N) to wait Features->Forwar


forward.no_a before forwarding incoming calls. d &DND->No
Integer from
nswer.timeout Incoming calls are forwarded when Answer
0 to 20
= not answered after N*6 seconds. Forward->After

The default value is 2. Ring Time (0~120s)

Features->Forwar
forward.no_a String within It configures the no answer forward on d &DND->No
nswer.on_cod 32 code. Answer
e= characters The default value is blank. Forward->On
Code

Features->Forwar
forward.no_a String within It configures the no answer forward off
d &DND->No
nswer.off_cod 32 code.
Answer
e= characters The default value is blank.
Forward->Off

110
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

Code

It enables or disables the phone to


forward incoming calls to international
forward.intern numbers. Features->General
ational.enable 0 or 1 Information->Fwd
0-Disabled
= International
1-Enabled

The default value is 1.

It enables or disables the phone to


automatically change the status of the
ACD agent to available. Features->ACD->
acd.auto_avai
0 or 1 ACD Auto
lable = 0-Disabled
Available
1-Enabled

The default value is 0.

It configures the interval (in seconds) Features->ACD->


acd.auto_avai Integer from to automatically change the status of ACD Auto
lable_timer = 0 to 120 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:

 $mac

 $ip

action_url.setu URL within  $model Features->Action


p_completed 511 URL->Setup
 $firmware
= characters Completed
 $active_url

 $active_user

 $active_host

 $local

 $remote

 $display_local

 $display_remote

 $call_id

111
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

Example:

action_url. setup_completed =
http://192.168.0.20/help.xml?IP=$ip

The default value is blank.

It configures the action URL the phone


sends after account is registered.

Example:

URL within action_url.registered =


action_url.regi Features->Action
511 http://192.168.0.20/help.xml?IP=$ip
stered = URL->Registered
characters The default value is blank.

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:

URL within action_url.unregistered =


action_url.unr Features->Action
511 http://192.168.0.20/help.xml?IP=$ip
egistered = URL->Unregistered
characters The default value is blank.

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.
URL within Features->Action
action_url.regi Example:
511 URL->Register
ster_failed = action_url.register_failed =
characters Failed
http://192.168.0.20/help.xml?IP=$ip

The default value is blank.

It configures the action URL the phone


sends when off hook.
URL within
action_url.off_ Example: Features->Action
511
hook = action_url.off_hook = URL->Off Hook
characters
http://192.168.0.20/help.xml?IP=$ip

The default value is blank.

action_url.on_ URL within It configures the action URL the phone Features->Action
hook = 511 sends when on hook. URL->On Hook

112
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

characters Example:

action_url.on_hook =
http://192.168.0.20/help.xml?IP=$ip

The default value is blank.

It configures the action URL the phone


sends when receiving an incoming
call.
URL within Features->Action
action_url.inco
511 Example: URL->Incoming
ming_call =
characters 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.
URL within Features->Action
action_url.out Example:
511 URL->Outgoing
going_call = action_url.outgoing_call =
characters Call
http://192.168.0.20/help.xml?IP=$ip

The default value is blank.

It configures the action URL the phone


sends when establishing a call.
action_url.call URL within
Example: Features->Action
_established 511
action_url.call_established = URL->Established
= characters
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.
URL within
action_url.call Example: Features->Action
511
_terminated = action_url.call_terminated = URL->Terminated
characters
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.
URL within
action_url.dnd Example: Features->Action
511
_on = action_url.dnd_on = URL->Open DND
characters
http://192.168.0.20/help.xml?IP=$ip

The default value is blank.

113
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

It configures the action URL the phone


sends when DND feature is disabled.
URL within
action_url.dnd Example: Features->Action
511
_off = action_url.dnd_off = URL->Close DND
characters
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
enabled.
URL within Features->Action
action_url.alw
511 Example: URL->Open
ays_fwd_on =
characters 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
disabled.
URL within Features->Action
action_url.alw
511 Example: URL->Close
ays_fwd_off =
characters 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
enabled.
URL within Features->Action
action_url.bus
511 Example: URL->Open Busy
y_fwd_on =
characters 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
disabled.
URL within Features->Action
action_url.bus
511 Example: URL->Close Busy
y_fwd_off =
characters 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 It configures the action URL the phone Features->Action
answer_fwd_o 511 sends when no answer forward URL->Open No

114
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

n= characters feature is enabled. Answer Forward

Example:

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
feature is disabled.
action_url.no_ URL within Features->Action
answer_fwd_o 511 Example: URL->Close No
ff = characters 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.
URL within
action_url.tran Example: Features->Action
511
sfer_call = action_url.transfer_call = URL->Transfer Call
characters
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
transfer.
action_url.blin URL within Features->Action
d_transfer_call 511 Example: URL->Blind
= characters 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
or a semi-attended transfer.
action_url.atte URL within Features->Action
nded_transfer 511 Example: URL->Attended
_call = characters 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


URL within
action_url.hol sends when placing a call on hold. Features->Action
511
d= Example: URL->Hold
characters
action_url.hold =

115
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

http://192.168.0.20/help.xml?IP=$ip

The default value is blank.

It configures the action URL the phone


sends when resuming a held call.
URL within
action_url.unh Example: Features->Action
511
old = action_url.unhold = URL->UnHold
characters
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.
URL within
action_url.mut Example: Features->Action
511
e= action_url.mute = URL->Mute
characters
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.
URL within
action_url.unm Example: Features->Action
511
ute = action_url.unmute = URL->UnMute
characters
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.
URL within
action_url.miss Example: Features->Action
511
ed_call = action_url.missed_call = URL->Missed Call
characters
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
phone from busy to idle.
URL within
action_url.bus Features->Action
511 Example:
y_to_idle = URL->Busy To Idle
characters action_url.busy_to_idle =
http://192.168.0.20/help.xml?IP=$ip

The default value is blank.

URL within It configures the action URL the phone


action_url.idle Features->Action
511 sends when changing the state of the
_to_busy = URL->Idle To Busy
characters phone from idle to busy.

116
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

Example:

action_url.idle_to_busy =
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
of the phone.
URL within
action_url.ip_c Features->Action
511 Example:
hange = URL->IP Changed
characters action_url.ip_change =
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
call.
action_url.for URL within Features->Action
ward_incomin 511 Example: URL->Forward
g_call = characters 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 Features->Action
Example:
ct_incoming_c 511 URL->Reject
action_url.reject_incoming_call =
all = characters 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 answering a new
incoming call.
action_url.ans URL within Features->Action
wer_new_inco 511 Example: URL->Answer
ming_call = characters 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

action_url.tran URL within sends when completing a call transfer. Features->Action


sfer_finished 511 Example: URL->Transfer
= characters action_url.transfer_finished = Finished

http://192.168.0.20/help.xml?IP=$ip

117
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

The default value is blank.

It configures the action URL the phone


sends when failing to transfer a call.
URL within Features->Action
action_url.tran Example:
511 URL->Transfer
sfer_failed = action_url.transfer_failed =
characters Failed
http://192.168.0.20/help.xml?IP=$ip

The default value is blank.

It configures the language of the web


English, user interface.
Chinese_S,
Chinese_S is only applicable to
Chinese_T,
SIP-T19P, SIP-T21P and SIP-T46G IP
German,
phones. Settings->Preferen
lang.wui = French,
Chinese_T is only applicable to ce->Language
Italian,
SIP-T46G IP phones.
Spanish,
Turkish or French, Portuguese and Spanish are

Portuguese not applicable to SIP-T19P and SIP-T21P


IP phones.

English,
Chinese_S,
Chinese_T, It configures the language of the

German, phone user interface.

French, Chinese_S and Chinese_T are only


lang.gui =
Turkish, applicable to SIP-T19P, SIP-T21P and
Italian, SIP-T46G IP phones.
Polish, The default value is English.
Spanish or
Portuguese

It configures the time zone.

local_time.tim For more available time zones, refer to Settings->Time &


-11 to +13
e_zone = Time Zones on page 217. Date->Time Zone

The default value is +8.

It configures the time zone name.

local_time.tim String within For more available time zone names,


Settings->Time &
e_zone_name 32 refer to Time Zones on page 217.
Date->Time Zone
= characters The default time zone name is
China(Beijing).

118
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

It configures the phone to obtain time


from NTP server or manual settings.
local_time.ma Settings->Time &
nual_time_en 0 or 1 0-Manual Date->Manual
able = 1-NTP Time

The default value is 1.

It enables or disables the phone to use


manually configured NTP server
preferentially.
local_time.ma Settings->Time &
nual_ntp_srv_ 0 or 1 0-Disabled (use the NTP server Date->NTP By
prior = obtained by DHCP preferentially) DHCP Priority

1-Enabled

The default value is 0.

IP address It configures the IP address or domain Settings->Time &


local_time.ntp
or domain name of the NTP server 1. Date->Primary
_server1 =
name The default value is cn.pool.ntp.org. Server

IP address It configures the IP address or domain Settings->Time &


local_time.ntp
or domain name of the NTP server 2. Date->Secondary
_server2 =
name The default value is cn.pool.ntp.org. Server

It configures the update interval (in Settings->Time &


local_time.inte Integer from
seconds) when using the NTP server. Date->Synchronis
rval = 15 to 86400
The default value is 1000. m (15~86400s)

It enables or disables daylight saving


time (DST) feature.
Settings->Time &
local_time.su 0-Disabled
0, 1 or 2 Date-> Daylight
mmer_time = 1-Enabled
Saving Time
2-Automatic

The default value is 2.

It configures the way DST works when


DST feature is enabled.
local_time.dst Settings->Time &
0 or 1 0-DST By Date
_time_type = Date->Fixed Type
1-DST By Week

The default value is 0.

It configures the start time of the DST. For DST By Date:


local_time.star
Time Value formats are: Settings->Time &
t_time =
 Month/Day/Hour (for By Date) Date->Start Date

119
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

 Month/ Day of Week/ Day of For DST By Week:


Week Last in Month/ Hour of Day Settings->Time &
(for By Week) Date->DST Start
The default value is 1/1/0. Month/DST Start
Day of Week/DST
Start Day of Week
Last in Month/ Start
Hour of Day

For DST By Date:

Settings->Time &
It configures the end time of the DST.
Date-> End Date
Value formats are:
For DST By Week:
 Month/Day/Hour (for By Date)
local_time.en Settings ->Time &
Time Month/ Day of Week/ Day of
d_time =
 Date->DST Stop
Week Last in Month/ Hour of Day Month/DST Stop
(for By Week) Day of Week/DST

The default value is 12/31/23. 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 It is only available to offset from GMT Settings->Time &


0 or 1
p_time = 0. Date->DHCP Time
0-Disabled

1-Enabled

The default value is 0.

It configures the offset time (in Settings->Time &


local_time.offs Integer from
minutes). Date->Offset
et_time = -300 to 300
The default value is blank. (minutes)

It configures the time format.


Settings->Time &
local_time.tim 0-12 Hour
0 or 1 Date->Time
e_format = 1-24 Hour
Format
The default value is 1.

0, 1, 2, 3, 4, 5 It configures the date format. Settings->Time &


local_time.dat
or 6 (for For Date->Date
e_format =
SIP-T19P/T21P SIP-T19P/SIP-T21P/T22P/T26P/T28P/T4X IP Format

120
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

/T22P/T26P/T phones:
28P/T4X) 0-WWW MMM DD
7, 8 or 9 1-DD-MMM-YY
(for SIP-T20P)
2-YYYY-MM-DD

3-DD/MM/YYYY

4-MM/DD/YY

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 the hot desking login wizard during
artup_register startup.
0 or 1
_name_enabl
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
startup.
artup_userna 0 or 1
me_enable = 0-Disabled

1-Enabled

The default value is 1.

121
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

It enables or disables the phone to


provide input field of password on the
hot desking login wizard during
hotdesking.st
startup.
artup_passwo 0 or 1
rd_enable = 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
startup.
artup_sip_serv 0 or 1
er_enable = 0-Disabled

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
startup.
artup_outboun 0 or 1
d_enable = 0-Disabled

1-Enabled

The default value is 0.

It enables or disables the phone to


provide input field of register name on
hotdesking.ds the hot desking login wizard when
skey_register_ pressing the Hot Desking key.
0 or 1
name_enable
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
pressing the Hot Desking key.
skey_usernam 0 or 1
e_enable = 0-Disabled

1-Enabled

The default value is 1.

122
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

It enables or disables the phone to


provide input field of password on the
hot desking login wizard when
hotdesking.ds
pressing the Hot Desking key.
skey_passwor 0 or 1
d_enable = 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
pressing the Hot Desking key.
skey_sip_serv 0 or 1
er_enable = 0-Disabled

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
pressing the Hot Desking key.
skey_outboun 0 or 1
d_enable = 0-Disabled

1-Enabled

The default value is 0.

It configures the internal ringer text for


distinctive_rin
distinctive ring tone.
g_tones.alert_i String within
Example: Settings->Ring->
nfo.X.text = 32
distinctive_ring_tones.alert_info.1.text Internal Ringer Text
(X ranges characters
= Family
from 1 to 10)
The default value is blank.

It configures the desired ring tones for

distinctive_rin each text.

g_tones.alert_i The value ranges from 1 to 8, the digit Settings->Ring


Integer from
nfo.X.ringer = stands for the appropriate ring tone. ->Internal Ringer
1 to 8
(X ranges Ring tones 6-8 are only applicable to File

from 1 to 10) SIP-T46G IP phones.

The default value is 1.

It enables or disables the phone to


auto_redial.en Features->General
0 or 1 automatically redial the called number
able = Information->Auto
when the called party is temporarily

123
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

unavailable. Redial

0-Disabled

1-Enabled

The default value is 0.

Features->General
It configures the interval (in seconds)
auto_redial.int Integer from Information->Auto
for the phone to wait before redial.
erval = 1 to 300 Redial Interval
The default value is 10.
(1~300s)

It configures the auto redial times Features->General


auto_redial.ti Integer from when the called party is temporarily Information->Auto
mes = 1 to 300 unavailable. Redial Times

The default value is 10. (1~300)

It enables or disables zero touch for


the phone to perform provisioning
during startup. Settings->Auto
zero_touch.en
0 or 1 Provision->Zero
able = 0-Disabled
Active
1-Enabled

The default value is 0.

It configures the duration time (in


seconds) of the phone displaying the Settings->Auto
zero_touch.wa Integer from
zero-sp-touch configuration screen Provision->Wait
it_time = 1 to 100
when powered on. Time (1~100s)

The default value is 5.

It configures the IP address of the push Features->Remote


push_xml.serv
IP address XML server. Control->Push XML
er =
The default value is blank. Server IP Address

It enables or disables the phone to


block displaying the push XML screen
when in calling status. Features->Remote
push_xml.bloc
0 or 1 Control->Block
k_in_calling = 0-Disabled
XML In Calling
1-Enabled

The default value is 0.

It enables or disables the phone to use

push_xml.sip_ the push XML via SIP NOTIFY message. Features->Remote


0 or 1
notify = 0-Disabled Control->SIP Notify

1-Enabled

124
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

The default value is 0.

It configures the IP address of server


from which the phone receives the
action URI requests.

Multiple IP addresses are separated


features.actio Features->Remote
IP address by commas.
n_uri_limit_ip Control->Action
or any If it is set to any, the phone will receive
= URI allow IP List
action URI requests from any server.

If it is left blank, the phone will not


receive action URI requests.

The default value is blank.

String within Settings->Dial


dialplan.area It configures the area code.
16 Plan->Area
_code.code = The default value is blank.
characters Code->Code

Settings->Dial
dialplan.area It configures the minimum length of the
Integer from Plan->Area
_code.min_len number prefixed with the area code.
1 to 15 Code->Min Length
= The default value is 1.
(1-15)

It configures the maximum length of


the number prefixed with the area Settings->Dial
dialplan.area
Integer from code. Plan->Area
_code.max_le
1 to 15 The value must be larger than the Code->Max
n=
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/T46G)
_code.line_id
0 to 3 (for SIP-T26P/T22P/T42G/T41P)
= Settings->Dial
0 to 2 (for SIP-T21P/T20P)
(not Integer Plan->Area
Multiple line IDs are separated by
applicable to Code->Account
commas. 0 stands for all lines.
SIP-T19P IP
phones) If it is left blank, the area code rule will
apply to all accounts on the phone.

The default value is blank.

dialplan.block String within Settings->Dial


It configures the block out string.
_out.number.X 32 Plan->Block

125
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

= characters The default value is blank. Out->BlockOut

(X ranges NumberX

from 1 to 10)

It configures lines applying the block


dialplan.block out rule.
_out.line_id.X
0 to 6 (for SIP-T28P/T46G)
=
0 to 3 (for SIP-T26P/T22P/T42G/T41P)
(X ranges Settings->Dial
0 to 2 (for SIP-T21P/T20P)
from 1 to 10) Integer Plan->Block
Multiple line IDs are separated by
(not Out->Account
commas. 0 stands for all lines.
applicable to
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
String within Settings->Dial
ow.rule.X = It configures the dial now rule.
511 Plan->Dial-now->
(X ranges The default value is blank.
characters Rule
from 1 to 100)

It configures lines applying the


dial-now rule.
dialplan.dialn
ow.line_id.X = 0 to 6 (for SIP-T28P/T46G)

(X ranges 0 to 3 (for SIP-T26P/T22P/T42G/T41P)


Settings->Dial
from 1 to 100) 0 to 2 (for SIP-T21P/T20P)
Integer Plan->Dial-now->
(not Multiple line IDs are separated by
Account
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.

The default value is blank.

URL within It configures the access URL of the


dialplan_dialn
511 dial-now rule file.
ow.url =
characters The default value is blank.

Features->General
phone_setting It configures the delay time (in
Integer from Information->Time-
.dialnow_dela seconds) for the dial-now rule.
1 to 14 Out for Dial-Now
y= The default value is 1.
Rule

dialplan.repla String within It configures the entered number to be Settings->Dial


ce.prefix.X = 32 replaced. Plan->Replace

126
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

(X ranges characters The default value is blank. Rule->Prefix


from 1 to 100)

dialplan.repla
ce.replace.X String within It configures the alternate number to Settings->Dial
= 32 replace the entered number. Plan->Replace

(X ranges characters 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/T46G)
(X ranges
Settings->Dial
from 1 to 100) 0 to 3 (for SIP-T26P/T22P/T42G/T41P)
Integer Plan->Replace
(not 0 to 2 (for SIP-T21P/T20P)
Rule-> Account
applicable to Multiple line IDs are separated by
SIP-T19P IP commas. 0 stands for all lines.
phones)
The default value is blank.

URL within It configures the access URL of the


dialplan_repl
511 replace rule file.
ace_rule.url =
characters The default value is blank.

remote_phone
book.data.X.u
rl =

(X ranges URL within It configures the access URL of the Directory->Remote


from 1 to 5) 511 remote phone book. Phone Book->

(not characters The default value is blank. Remote URL

applicable to
SIP-T20P IP
phones)

remote_phone
book.data.X.n
ame =

(X ranges String within It configures the display name of the Directory->Remote


from 1 to 5) 99 remote phone book item. Phone Book->

(not characters The default value is blank. Display Name

applicable to
SIP-T20P IP
phones)

127
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

remote_phone
book.display_
It configures the display name of the
name =
remote phone book.
(not String within
If it is left blank, Remote Phone Book is
applicable to 99
displayed on the LCD screen at the
SIP-T20P, characters
path Menu->Directory.
SIP-T41P and
The default value is blank.
SIP-T42G IP
phones)

ldap.enable =
It enables or disables LDAP feature.
(not
applicable to 0-Disabled Directory->LDAP->
0 or 1
SIP-T19P and 1-Enabled Enable LDAP

SIP-T20P IP The default value is 0.


phones)

ldap.name_filt
er = It configures the criteria for searching
the contact name attributes.
(not String within
Directory->LDAP->
applicable to 99 Example:
LDAP Name Filter
SIP-T19P and characters ldap.name_filter = (|(cn=%)(sn=%))
SIP-T20P IP The default value is blank.
phones)

ldap.number_f It configures the criteria for searching

ilter = the contact number attributes.

(not String within Example:


Directory->LDAP->
applicable to 99 ldap.number_filter =
LDAP Number Filter
SIP-T19P and characters (|(telephoneNumber=%)(mobile=%)(i
SIP-T20P IP pPhone=%))
phones) The default value is blank.

ldap.host =

(not
IP address It configures the IP address or domain
applicable to Directory->LDAP->
or domain name of the LDAP server.
SIP-T19P and Server Address
name The default value is blank.
SIP-T20P IP
phones)

ldap.port = It configures the port of the LDAP


Integer from Directory->LDAP->
server.
(not
1 to 65535 Port
applicable to The default value is 389.

128
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

SIP-T19P and
SIP-T20P IP
phones)

ldap.base = It configures the LDAP search base


which corresponds to the location of
(not
String within the LDAP phonebook.
applicable to Directory->LDAP->
99
SIP-T19P and Example: Base
characters
SIP-T20P IP ldap.base = dc=yealink,dc=cn
phones) The default value is blank.

ldap.user =

(not
String within It configures the user name for
applicable to Directory->LDAP->
99 accessing the LDAP server.
SIP-T19P and Username
characters The default value is blank.
SIP-T20P IP
phones)

ldap.passwor
d=

(not String within It configures the password for


Directory->LDAP->
applicable to 99 accessing the LDAP server.
Password
SIP-T19P and characters The default value is blank.
SIP-T20P IP
phones)

ldap.max_hits
=
It configures the maximum of the
(not Directory->LDAP->
Integer from search results returned by the LDAP
applicable to Max. Hits
1 to 32000 server to be displayed.
SIP-T19P and (1~32000)
The default value is 50.
SIP-T20P IP
phones)

It configures the name attributes of


ldap.name_at each record to be returned by the
tr = LDAP server.
(not String within Directory->LDAP->
Multiple attributes are separated by
applicable to 99 LDAP Name
spaces.
SIP-T19P and characters Attributes
Example:
SIP-T20P IP
ldap.name_attr =sn cn
phones)
The default value is blank.

129
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

It configures the number attributes of


ldap.numb_at each record to be returned by the
tr = LDAP server.
(not String within Directory->LDAP->
Multiple attributes are separated by
applicable to 99 LDAP Number
spaces.
SIP-T19P and characters Attributes
Example:
SIP-T20P IP
ldap.numb_attr = Mobile ipPhone
phones)
The default value is blank.

ldap.display_ It configures the display name of the

name = contact record displayed on the LCD


screen. The value of this parameter
(not String within Directory->LDAP->
must start with “%” symbol.
applicable to 99 LDAP Display

SIP-T19P and characters Example: Name

SIP-T20P IP ldap.display_name = %cn


phones) The default value is blank.

ldap.version
=

(not
It configures the LDAP version. Directory->LDAP->
applicable to 2 or 3
The default value is 3. Protocol
SIP-T19P and
SIP-T20P IP
phones)

ldap.call_in_lo
It enables or disables the phone to
okup =
perform an LDAP search when
(not receiving an incoming call. Directory->LDAP->

applicable to 0 or 1 LDAP Lookup For


0-Disabled
SIP-T19P and Incoming Call
1-Enabled
SIP-T20P IP
The default value is 0.
phones)

ldap.ldap_sort
It enables or disables the phone to sort
=
the search results in alphabetical order
(not or numerical order. Directory->LDAP->
applicable to 0 or 1 LDAP Sorting
0-Disabled
SIP-T19P and Results
1-Enabled
SIP-T20P IP
The default value is 0.
phones)

130
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

It configures the characters the phone


filters when dialing.

String within If the dialed number contains Features->General


features.call_n
99 configured characters, the phone will Information->Call
um_filter =
characters automatically filter these characters Number Filter
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->General
features.dnd_r 404, 480 or Information->
404-No Found
efuse_code = 486 Return Code When
480-Temporarily not available
DND
486-Busy here

The default value is 480.

It configures a return code and reason


of SIP response messages when
rejecting an incoming call. Features->General
features.norm
404, 480 or Information->
al_refuse_cod 404-No Found
486 Return Code When
e= 480-Temporarily not available
Refuse
486-Busy here

The default value is 486.

It enables or disables call completion


feature.
features.call_c Features->General
ompletion_en 0 or 1 0-Disabled Information->Call
able = 1-Enabled Completion

The default value is 0.

features.fwd_
mode = It configures the call forward mode.
Features->
(not 0-Phone
0 or 1 Forward&DND->Fo
applicable to 1-Custom
rward->Mode
SIP-T19P IP The default value is 0.
phones)

It configures the DND mode.


features.dnd_
Features->
mode = 0-Phone
0 or 1 Forward&DND->
(not 1-Custom
DND->Mode
applicable to The default value is 0.

131
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

SIP-T19P IP
phones)

It enables or disables DND feature.


Features->
features.dnd.e 0-Disabled
0 or 1 Forward&DND->
nable = 1-Enabled
DND->DND Status
The default value is 0.

Features->
String within It configures the DND on code when
features.dnd.o Forward&DND->
32 the DND mode is configured as Phone.
n_code = DND->DND On
characters The default value is Blank.
Code

Features->
String within It configures the DND off code when
features.dnd.o Forward&DND->
32 the DND mode is configured as Phone.
ff_code = DND->DND Off
characters The default value is Blank.
Code

It enables or disables the phone to


receive incoming calls from authorized
numbers when DND feature is
features.dnd.e Features->
enabled.
mergency_en 0 or 1 Forward&DND->
able = 0-Disabled DND Emergency
1-Enabled

The default value is 0.

It configures the numbers the phone

features.dnd.e will receive incoming calls from when Features->


String within
mergency_aut DND feature is enabled. Forward&DND->
511
horized_numb Multiple numbers are separated by DND Authorized
characters
er = commas. Numbers

The default value is blank.

It enables or disables forward


diversion feature. Features->General
features.fwd_
Information->
diversion_ena 0 or 1 0- Disabled
Diversion/History-In
ble = 1-Enabled
fo
The default value is 1.

It enables or disables call waiting


Features->General
call_waiting.e feature.
0 or 1 Information->Call
nable = 0-Disabled
Waiting
1-Enabled

132
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

The default value is 1.

It enables or disables the phone to


play the call waiting tone.
Features->Audio-
call_waiting.to
0 or 1 0-Disabled > Call Waiting
ne =
1-Enabled Tone

The default value is 1.

String within Features->General


call_waiting.o It configures the call waiting on code.
32 Information->Call
n_code = The default value is blank.
characters Waiting On Code

String within Features->General


call_waiting.of It configures the call waiting off code.
32 Information->Call
f_code = The default value is blank.
characters Waiting Off Code

It enables or disables the phone to


automatically answer an incoming
intercom call. Features->Interco
features.interc
0 or 1 m ->Accept
om.allow = 0-Disabled
Intercom
1-Enabled

The default value is 1.

It enables or disables the phone to


mute the speaker when answering an
intercom call.
features.interc Features->Interco
0 or 1
om.mute = 0-Disabled m ->Intercom Mute

1-Enabled

The default value is 0.

It enables or disables the phone to


play a warning tone when answering
an intercom call.
features.interc Features->Interco
0 or 1
om.tone = 0-Disabled m ->Intercom Tone

1-Enabled

The default value is 1.

It enables or disables the phone to


barge in an intercom call.
Features->Interco
features.interc
0 or 1 0-Disabled m ->Intercom
om.barge =
1-Enabled Barge

The default value is 0.

133
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

features.remot
It enables or disables the phone to
e_phonebook.
perform a remote phone book search
Directory->Remote
enable =
when receiving an incoming call.
Phone Book->
(not 0 or 1
0-Disabled Search Remote
applicable to
1-Enabled Phonebook Name
SIP-T20P IP
The default value is 0.
phones)

features.remot
e_phonebook. It configures the interval (in seconds)
Directory->Remote
flash_time = Integer from for the phone to update the data of the
Phone Book->
(not 3600 to remote phone book from the remote
Search Flash Time
applicable to 2592000 phone book server.
(Seconds)
SIP-T20P IP The default value is 21600.
phones)

String within Features->General


features.hotlin It configures the hotline number.
32 Information->
e_number = The default value is blank.
characters Hotline Number

It configures the delay time (in Features->General


features.hotlin Integer from seconds) for the phone to dial out the Information->
e_delay = 0 to 10 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->General
features.dtmf.
0 or 1 0-Disabled Information->Supp
hide =
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 = Features->General
when the parameter
(not “features.dtmf.hide” is set to 1 Information->Supp
0 or 1
applicable to (Enabled). ress DTMF Display

SIP-T20P IP Delay
0-Disabled
phones)
1-Enabled

The default value is 0.

features.dtmf.r It configures the repetition times for Features->General


1, 2 or 3
epetition = sending the DTMF packets. Information->DTM

134
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

The default value is 3. F Repetition

It enables or disables the phone to


send DTMF sequences for transfer
function when pressing the transfer
Features->General
features.dtmf.r soft key or the TRAN key.
0 or 1 Information->DTM
eplace_tran =
0-Disabled F Replace Tran
1-Enabled

The default value is 0.

It configures DTMF sequences for


String within Features->General
features.dtmf.t transfer key function to be sent. It
32 Information->Tran
ransfer = consists of 0-9, A-D, * and #.
characters Send DTMF
The default value is blank.

It enables or disables headset prior


feature.
Features->General
features.head
0 or 1 0-Disabled Information->
set_prior =
1-Enabled Headset Prior

The default value is 0.

features.head
set_training = It enables or disables dual headset
feature.
(not Features->General

applicable to 0 or 1 0-Disabled Information->Dual-

SIP-T19P and 1-Enabled Headset

SIP-T21P IP The default value is 0.


phones)

It enables or disables the phone to


play a local DTMF tone.
features.play_ Features->General
local_dtmf_ton 0 or 1 0-Disabled Information->Play
e_enable= 1-Enabled Local DTMF Tone

The default value is 1.

Features->General
It configures the duration time (in
features.busy_ Information->Busy
0, 3 or 5 seconds) for the busy tone.
tone_delay = Tone Delay
The default value is 0.
(Seconds)

It configures whether to send one


features.send Features->General
0 or 1 pound key by pressing the pound key
_pound_key = Information->Send
twice when the pound key is

135
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

configured as a send key. Pound Key

0-Send one pound key

1-Do not send any pound key

The default value is 0.

It configures the "#" or "*" key as a send


key.

0-Disabled

1-# key Features->General


features.key_a
0, 1 or 2 2-* key Information->Key
s_send =
As Send
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
key.
features.send Features->Audio-
0 or 1
_key_tone = 0-Disabled > 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 Features->Audio-
0 or 1 0-Disabled
one = > Key Tone
1-Enabled

The default value is 1.

It enables or disables the phone to


play a warning tone when there is a
features.play_ call on hold. Features->General
hold_tone.ena 0 or 1 Information->Play
0-Disabled
ble = Hold Tone
1-Enabled

The default value is 1.

features.play_ It configures the interval (in seconds) Features->General


Integer from
hold_tone.del for playing a hold warning tone. Information->Play
3 to 3600
ay = The default value is 30. Hold Tone Delay

features.redial Integer It configures the phone to continue to Features->Audio-


_tone = within 6 play the dial tone after inputting the >Redial Tone

136
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

digits preset numbers in the dialing screen.

Example:

features.redial_tone = 125

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


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 phone with no active accounts.
0 or 1
on_tone =
0-Disabled

1-Enbaled

The default value is 0.

It enables or disables password dial


feature for the phone.
features.pass Features->General
word_dial.ena 0 or 1 0-Disabled Information->PswD
ble = 1-Enabled ial

The default value is 0.

It configures the prefix of the


password-dial number.

For example, set the prefix to 12 and


features.pass String within Features->General
the length to 3, when you want to dial
word_dial.pref 32 Information->
the number 123456, the entered
ix = characters PswPrefix
number is displayed as 12***6 on the
LCD screen.

The default value is blank.

It configures the number of digits to be

features.pass hidden. Features->General


Integer from
word_dial.len The hidden digits are displayed as Information->
0 to 99
gth = asterisks on the LCD screen. PswLength

The default value is blank.

Features->General
features.save_ 0 or 1 It enables or disables the phone to
Information->Save

137
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

call_history = save the call history. Call Log

0-Disabled

1-Enabled

The default value is 1.

It enables or disables the power


indicator LED to be turned on.

For SIP-T19P/T2xP IP phones:

0-Disabled (power indicator LED is off)

1-Enabled (power indicator LED is solid


green)

The default value is 1.

phone_setting For SIP-T4X IP phones:


Features->Power
.common_po
0 or 1 0-Disabled (power indicator LED is off) LED->Common
wer_led_enab
1-Enabled (power indicator LED is solid Power Light On
le =
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-T19P/T2xP IP phones:

0-Disabled (power indicator LED does


not flash)
phone_setting
1-Enabled (power indicator LED fast Features->Power
.ring_power_l
0 or 1 flashes (300ms) green) LED->Ring Power
ed_flash_ena
The default value is 1. Light Flash
ble =
For SIP-T4X IP phones:

0-Disabled (power indicator LED does


not flash)

1-Enabled (power indicator LED fast


flashes (300ms) red)

If it is set to 0, the status of the power

138
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

indicator LED is determined by the


value of the parameter
“phone_setting.common_power_led_e
nable”.

The default value is 1.

It enables or disables the power


indicator LED to flash when the phone
receives a voice mail or a text
message.

For SIP-T19P/T2xP IP phones:

0-Disabled (power indicator LED does


not flash)

1-Enabled (power indicator LED slow


flashes (1000ms) green)
phone_setting Features->Power
The default value is 0.
.mail_power_l LED->Voice/Text
0 or 1 For SIP-T4X IP phones:
ed_flash_ena Mail Power Light
ble = 0-Disabled (power indicator LED does Flash
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-T19P/T2xP IP phones:

phone_setting 0-Disabled (power indicator LED does


Features->Power
.mute_power_l not flash)
0 or 1 LED->Mute Power
ed_flash_ena 1-Enabled (power indicator LED fast
Light On
ble = flashes (300ms) green)

The default value is 1.

For SIP-T4X IP phones:

0-Disabled (power indicator LED does


not flash)

139
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

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”.

It enables or disables the power


indicator LED to flash when a call is
placed on hold or is held.

For SIP-T19P/T2xP 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 Features->Power
For SIP-T4X IP phones:
d_power_led_ 0 or 1 LED->Hold/Held
flash_enable 0-Disabled (power indicator LED does Power Light On
= not flash)

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.
phone_setting For SIP-T19P/T2xP IP phones:
Features->Power
.talk_and_dial
0 or 1 0-Disabled (power indicator LED is off) LED->Talk/Dial
_power_led_e
1-Enabled ( power indicator LED is Power Light On
nable =
solid green)

The default value is 1.

For SIP-T4X IP phones:

140
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

0-Disabled (power indicator LED is off)

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
nable”.

It configures the web access timeout Features->General


features.relog Integer from (in minutes). Information->Auto-
_offtime = 1 to 1000 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 Features->General
_ip_call_enabl 0 or 1 0-Disabled Information->
e= 1-Enabled Allow IP Call

The default value is 1.

It enables or disables the phone to


mute an active call.
Features->General
features.allow
0 or 1 0-Disabled Information->Allo
_mute =
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
it is in talking using the handset.
p_listen_in_tal 0 or 1
king_enable = 0-Disabled

1-Enabled

The default value is 1.

It configures the ringer device for the


phone in the headset mode.
features.ringer Features->Audio-
0-Use Speaker
_device.is_use 0, 1 or 2 > Ringer Device for
1-Use Headset
_headset = Headset
2-Use Headset & Speaker

The default value is 0.

141
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

It enables or disables the phone to


prompt for the administrator password
when you long press the OK key to
features.factor
perform factory reset.
y_pwd_enabl 0 or 1
e= 0-Disabled

1-Enabled

The default value is 0.

It configures the phone to export the


configuration file with what type of
password.
features.expor
t_cfg_erase_p 0 or 1 0-Encrypted

wd = 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 = Features->Call
phone is in the pre-dialing screen.
(not 0 or 1 Pickup->Group
0-Disabled
applicable to Call Pickup
1-Enabled
SIP-T20P IP
The default value is 0.
phones)

features.picku String within It configures the group call pickup Features->Call


p.group_picku 32 code. Pickup->Group
p_code = characters The default value is blank. Call Pickup Code

features.picku
It enables or disables the phone to
p.direct_picku
display the DPickup soft key when the
p_enable = Features->Call
phone is in the pre-dialing screen.
(not 0 or 1 Pickup->Directed
0-Disabled
applicable to Call Pickup
1-Enabled
SIP-T20P IP
The default value is 0.
phones)

features.picku String within It configures the directed call pickup Features->Call


p.direct_picku 32 code. Pickup->Directed
p_code = characters The default value is blank. Call Pickup Code

features.picku It enables or disables the phone to Features->Call


p.blf_visual_e 0 or 1 display a visual alert when the Pickup->Visual
nable = monitored user receives an incoming Alert for BLF Pickup

142
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

(not call.
applicable to 0-Disabled
SIP-T20P IP
1-Enabled
phones)
The default value is 0.

It enables or disables the phone to


play an audio alert when the
monitored user receives an incoming
features.picku Features->Call
call.
p.blf_audio_e 0 or 1 Pickup->Audio
nable = 0-Disabled Alert for BLF Pickup

1-Enabled

The default value is 0.

It configures BLF LED mode and


provides four kinds of definition for the
features.blf_le
BLF/BLF list key LED status.
d_mode =
For more information, refer to BLF LED Features->General
(not
0, 1, 2 or 3 Mode on page 220. Information->BLF
applicable to
The default value is 0. LED Mode
SIP-T19P IP
Note: The old parameter
phones)
“features.blf_and_callpark_idle_led_e
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
0 or 1 0-Disabled
t_version =
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 a voice mail.
_mail_tone_en 0 or 1
0-Disabled
able =
1-Enabled

The default value is 1.

multicast.code PCMU It configures the codec of multicast Features->General


c= PCMA paging. Information->

(not G729 Codecs G726-16, G726-24 and Multicast Codec

143
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

applicable to G722 G726-40 are not applicable to SIP-T21P


SIP-T19P IP G726-16 IP phones.
phones) The default value is G722.
G726-24

G726-32

G726-40

G723_53

It enables or disables the phone to


handle the incoming multicast paging
calls when there is a multicast paging Directory->
multicast.recei
call on the phone. Multicast
ve_priority.en 0 or 1
IP->Paging Priority
able = 0-Disabled
Active
1-Enabled

The default value is 1.

It configures the priority of multicast

multicast.recei paging calls. Directory->


Integer from
ve_priority.pri 1 is the highest priority, 10 is the lowest Multicast
0 to 10
ority = 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.
Directory->
IP address:
address = Example: Multicast IP->
port
(X ranges multicast.listen_address.1.ip_address Listening Address
from 1 to 10) = 224.5.6.20:10008

The default value is blank.

multicast.listen
It configures the label displayed on the
_address.X.la String within
LCD screen when receiving the Directory->
bel = 99
multicast paging. Multicast IP->Label
(X ranges characters
The default value is blank.
from 1 to 10)

It enables or disables the phone to


automatically dial out the entered
phone_setting digits in the pre-dialing screen.
Settings->Preferen
.predial_auto 0 or 1
0-Disabled ce->Live Dialpad
dial =
1-Enabled

The default value is 0.

144
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

It configures the time (in seconds) for

phone_setting the phone to automatically dial out the Settings->


Integer from
.inter_digit_tim entered digits without pressing a send Preference->Inter
1 to 14
e= key. Digit Time (1~14s)

The default value is 4.

phone_setting It configures the keypad lock type.


.lock =
0-Disabled
(only Features->Phone
1-Menu Key
applicable to 0, 1, 2 or 3 Lock->Keypad
2-Function Keys
SIP-T19P and Lock Type
3-All Keys
SIP-T2xP IP
phones) The default value is 0.

phone_setting
.phone_lock.e It enables or disables keypad lock

nable = feature.
Features->Phone

(only 0 or 1 0-Disabled Lock->Keypad

applicable to 1-Enabled Lock Enable

SIP-T4X IP The default value is 0.


phones)

phone_setting
It configures the keypad lock type.
.phone_lock.lo
ck_key_type = 0-All Keys Features->Phone

(only 0, 1 or 2 1-Function Keys Lock->Keypad

applicable to 2-Menu Key Lock Type

SIP-T4X IP
The default value is 0.
phones)

Features->Phone
phone_setting characters It configures the password for
Lock->Phone
.phone_lock.u within 15 unlocking the keypad.
Unlock PIN (0~15
nlock_pin = digits The default value is 123.
Digit)

It configures the interval (in seconds)


to automatically lock the keypad. Features->Phone
phone_setting
Integer from The default value is 0 (the keypad is Lock->Phone Lock
.phone_lock.lo
0 to 3600 locked only by long pressing the Time Out
ck_time_out =
pound key or pressing the keypad lock (0~3600s)

key)

features.bluet It enables or disables Bluetooth Features->


0 or 1
ooth_enable feature. Bluetooth->

145
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

= 0-Disabled Bluetooth Active

(only 1-Enabled
applicable to The default value is 0.
SIP-46G IP
phones)

Ring1.wav,
It configures the ring tone for the
Ring2.wav,
phone.
Ring3.wav,
Example:
phone_setting Ring4.wav, Settings->Preferen
phone_setting.ring_type = Ring1.wav
.ring_type = Ring5.wav ce->Ring Type
The default value is Ring1.wav.
Ring6.wav,
Note: Ring tones 6-8 are only
Ring7.wav,
applicable to SIP-T46G IP phones.
Ring8.wav

phone_setting It configures the contrast of the LCD


.contrast = screen.

(only For SIP-T19P and SIP-T21P IP phones, it


applicable to configures the LCD’s contrast of the
SIP-19P, phone only.
SIP-T21P,
For SIP-T26P IP phones, it configures the
SIP-T28P IP
LCD’s contrast of the connected EXP39
phones, EXP39 Integer from Settings->Preferen
only.
connected to 1 to 10 ce->Contrast
For SIP-T28P IP phones, it configures the
SIP-T26P and
LCD’s contrast of the IP phone and the
SIP-T28P IP
connected EXP39.
phones, and
For SIP-T46G IP phones, it configures
EXP40
the LCD’s contrast of the connected
connected to
EXP40 only.
SIP-T46G IP
phones) The default value is 6.

It configures the logo mode of the LCD


screen (except for SIP-T20P IP phones).
phone_setting
For SIP-T19P/T21P/T22P/T26P/T41P/T42G
.lcd_logo.mod
IP phones:
e= Features->General
0, 1 or 2 0-Disabled Information->Use
(not
applicable to 1-System logo Logo

SIP-T46G IP 2-Custom logo


phones)
The default value is 0.

For SIP-T28P IP phones:

146
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

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
= String within Features->General
It configures a text logo.
(only 15 Information->Text
The default value is Yealink.
applicable to characters Logo

SIP-T20P IP
phones)

lcd_logo.url =

(not
URL within It configures the access URL of logo Features->General
applicable to
511 file. Information->
SIP-T20P and
characters The default value is blank. Upload Logo
SIP-T46G IP
phones)

lcd_logo.delet
e=

URL within It deletes all custom logo files.


(not
applicable to 511 The valid value is: http://localhost/all

SIP-T20P and characters The default value is blank.


SIP-T46G IP
phones)

phone_setting Integer from


It configures the level of the active
.active_backli 1 to 3 for
backlight intensity.
ght_level = SIP-T28P and
the For SIP-T28P IP phones and the
(only
Settings->Preferen
connected connected EXP39:
applicable to
ce->Backlight
SIP-T28P IP EXP39 IP The default value is 2.
Active Level
phones and phones. For SIP-T46G IP phones and the
the connected Integer from connected EXP40:
EXP39, and 1 to 10 for The default value is 8.
SIP-T46G IP SIP-T46G IP

147
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

phones and phones and


the connected the
EXP40) connected
EXP40

phone_setting
It configures the phone to go out or
.inactive_back
reduce intensity of the backlight on the
Settings->
light_level =
LCD screen after a period of inactivity.
Preference->
(only 0 or 1
0-Off Backlight Inactive
applicable to
1-Low Level
SIP-T46G IP
The default value is 1.
phones)

It configures the backlight time (in


seconds).

For SIP-T22P/T26P/T28P IP phones:

0-Always off

1-Always on

15-15s

30-30s

60-60s
phone_setting
120-120s
.backlight_tim
300-300s
e=
600-600s
(not 0, 1, 15, 30, Settings->Preferen

applicable to 60, 120, 300, 1800-1800s ce->Backlight Time

SIP-T19P, 600 or 1800 The default value is 30. (seconds)

SIP-T21P and For SIP-T4X IP phones:


SIP-T20P IP
0-Always on
phones)
15-15s

30-30s

60-60s

120-120s

300-300s

600-600s

1800-1800s

The default value is 0.

phone_setting Ring1.wav It configures the ring tone when the

.ring_for_tranf Ring2.wav phone fails to transfer a call.

148
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

ailed = Ring3.wav The default value is Ring1.wav.

Ring4.wav Note: Ring tones 6-8 are applicable to

Ring5.wav SIP-T46G IP phones only.

Ring6.wav

Ring7.wav

Ring8.wav

It enables or disables the phone to


provide the logon wizard during
phone_setting startup. Features->General
.logon_wizard 0 or 1 Information->
0-Disabled
= Logon Wizard
1-Enabled

The default value is 0.

It enables or disables the phone to


deal with the 180 SIP message
received after the 183 SIP message. Features->General
phone_setting
0 or 1 Information->180
.is_deal180 = 0-Disabled
Ring Workaround
1-Enabled

The default value is 1.

It configures headset mode


precedence during a call.

0-Always use (pressing the


phone_setting
Speakerphone key and picking up the
.headsetkey_ 0 or 1
handset are not effective when the
mode =
headset mode is activated)

1-Use as normal

The default value is 1.

It configures emergency numbers.


phone_setting String within
Multiple emergency numbers are Features->Phone
.emergency.n 99
separated by commas. Lock->Emergency
umber = characters
The default value is 110,911,120.

It configures the display message on


the LCD screen when receiving a 403
phone_setting String within
message.
.show_code40 99
If it is left blank, the phone will display
3= characters
the value sent from the server when
receiving the 403 message.

149
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

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 =
see the placed calls list when the
Directory->
(not phone is in the pre-dialing screen.
0 or 1 Setting->Recent
applicable to
0-Disabled Call In Dialing
SIP-T20P IP
1-Enabled
phones)
The default value is 0.

directory_setti
ng.url =
URL within It configures the access URL of the
(not Directory->
511 custom directory list file.
applicable to Setting->Directory
characters The default value is blank.
SIP-T20P IP
phones)

super_search.
url = Directory->
URL within It configures the access URL of the
(not Setting->Search
511 custom search source list in dialing file.
applicable to Source List In
characters The default value is blank.
SIP-T20P IP Dialing
phones)

It configures the access URL of the Settings->


URL within
firmware file. Upgrade->Select
firmware.url = 511
The default value is blank. and Upgrade
characters
It takes effect after a reboot. Firmware

URL within It configures the access URL of the Settings->


ringtone.url = 511 custom ring tone file. Preference->
characters The default value is blank. Upload Ringtone

URL within It deletes all custom ring tone files.


ringtone.delet
511 The valid value is: http://localhost/all
e=
characters The default value is blank.

URL within It configures the access URL of the

gui_lang.url = 511 custom language file.

characters The default value is blank.

gui_lang.delet URL within It deletes all custom language files.

e= 511 The valid value is: http://localhost/all

150
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

characters The default value is blank.

Security->Trusted
URL within It configures the access URL of the
trusted_certific Certificates->Load
511 custom trusted certificate file.
ates.url = trusted certificates
characters The default value is blank.
file

It deletes all uploaded trusted


URL within
trusted_certific certificate files.
511
ates.delete = The valid value is: http://localhost/all
characters
The default value is blank.

URL within It configures the access URL of the Security->Server


server_certific
511 custom server certificate file. Certificates->Load
ates.url =
characters The default value is blank. server cer file

It deletes the uploaded server


URL within
server_certific certificate file.
511
ates.delete = The valid value is: http://localhost/all
characters
The default value is blank.

URL within It configures the access URL of the Directory->Local


local_contact.
511 local contact file. Directory->Import
data.url =
characters The default value is blank. Local Directory File

local_contact.
It configures the access URL of the TAR
data_photo_t
file compressed from custom contact
ar.url = URL within
file and avatar TAR file.
(only 511
All avatars needed for contacts should
applicable to characters
be tarred in advance.
SIP-T46G IP
The default value is blank.
phones)

URL within It configures the access URL of the DST

auto_dst.url = 511 Time file.

characters The default value is blank.

It configures the access URL of the


custom_factor URL within
custom factory configuration files.
y_configuratio 511
The default value is blank.
n.url = characters
It takes effect after a reboot.

features.custo
It enables or disables Import Factory
m_factory_con 0 or 1
Configuration feature.
fig.enable =

151
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

0-Disabled

1-Enabled

The default value is 0.

It configures the access URL for the Settings->


URL within
configuration. custom configuration files. Configuration->
511
url = The default value is blank. Export or Import
characters
It takes effect after a reboot. Configuration

URL within It configures the access URL of the


custom_mac_
511 custom MAC-Oriented CFG file.
cfg.url =
characters The default value is blank.

account.X.out
_dialog_blf_en
able =

(SIP-T19P: X=1
It enables or disables the phone to
SIP-T20P/T21P:
handle NOTIFY messages out of the
X ranges from
BLF dialog for account X.
1 to 2.
0 or 1
0-Disabled
SIP-T22P/T26P/T
41P/T42G: X 1-Enabled

ranges from 1 The default value is 0.


to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.ena
ble =

(SIP-T19P: X=1

SIP-T20P/T21P:
X ranges from It enables or disables the account X.
1 to 2.
0-Disabled Account->Register
SIP-T22P/T26P/T 0 or 1
1-Enabled ->Line Active
41P/T42G: X
The default value is 0.
ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

152
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

account.X.lab
el =

(SIP-T19P: X=1

SIP-T20P/T21P:
X ranges from
1 to 2. String within It configures the label displayed on the
Account->Register
99 LCD screen for account X.
SIP-T22P/T26P/T
->Label
41P/T42G: X characters The default value is blank.

ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.dis
play_name =

(SIP-T19P: X=1

SIP-T20P/T21P:
X ranges from
1 to 2. String within It configures the display name for
Account->Register
99 account X.
SIP-T22P/T26P/T
->Display Name
41P/T42G: X characters The default value is blank.
ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.aut
h_name =

(SIP-T19P: X=1

SIP-T20P/T21P:
X ranges from
String within It configures the user name for register
1 to 2. Account->Register
99 authentication for account X.
->Register Name
SIP-T22P/T26P/T characters The default value is blank.
41P/T42G: X
ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from

153
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

1 to 6)

account.X.use
r_name =

(SIP-T19P: X=1

SIP-T20P/T21P:
X ranges from
1 to 2. String within It configures the register user name for
Account->Register
32 account X.
SIP-T22P/T26P/T
->User Name
41P/T42G: X characters The default value is blank.

ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.pas
sword =

(SIP-T19P: X=1

SIP-T20P/T21P:
X ranges from
1 to 2. String within It configures the password for register
Account->Register
99 authentication for account X.
SIP-T22P/T26P/T
->Password
41P/T42G: X characters The default value is blank.
ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.tran
sport =

(SIP-T19P: X=1 It configures the transport type for


account X.
SIP-T20P/T21P:
X ranges from 0-UDP
Account->Register
1 to 2. Integer 1-TCP
->Transport
2-TLS
SIP-T22P/T26P/T
41P/T42G: X 3-DNS-NAPTR

ranges from 1 The default value is 0.


to 3.

SIP-T28P/T46G:

154
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

X ranges from
1 to 6)

account.X.rere
gister_enable
=

(SIP-T19P: X=1 It configures whether the phone needs


to re-register the account when
SIP-T20P/T21P:
encountering an INVITE failover, if the
X ranges from
SIP server is configured with a domain
1 to 2.
0 or 1 name for account X.
SIP-T22P/T26P/T
0-Do not need to re-register
41P/T42G: X
ranges from 1 1-Need to re-register

to 3. The default value is 0.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.nap
tr_build =

(SIP-T19P: X=1

SIP-T20P/T21P: It configures the way of SRV query


X ranges from when there is no result from the NAPTR
1 to 2. query for account X.
SIP-T22P/T26P/T 0 or 1
0-SRV query using UDP only
41P/T42G: X
1-SRV query using UDP, TCP or TLS.
ranges from 1
The default value is 0.
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.fall
back.redunda
ncy_type = It configures the registration mode for

(SIP-T19P: X=1
account X.

0 or 1 0-Concurrent registration
SIP-T20P/T21P:
X ranges from 1-Successive registration

1 to 2. The default value is 0.

SIP-T22P/T26P/T
41P/T42G: X

155
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.fall
back.timeout
=

(SIP-T19P: X=1 It configures the time interval (in

SIP-T20P/T21P: seconds) for the phone to detect

X ranges from whether the working server is


Integer from
1 to 2. available by sending the registration
10 to
request for account X.
SIP-T22P/T26P/T
2147483647
41P/T42G: X It is only applicable to successive

ranges from 1 registration mode.

to 3. The default value is 120.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.sip_
server.Y.addre
ss =

(SIP-T19P: X=1
It configures the IP address or domain
SIP-T20P/T21P: name of SIP server Y for account X.
X ranges from
Example:
1 to 2.
IP address account.1.sip_server.1.address = Account->Register
SIP-T22P/T26P/T
or domain 10.2.1.128 ->SIP Server Y->
41P/T42G: X
name The default value is blank. Server Host
ranges from 1
to 3. Note: The old parameter
“account.X.sip_server_host” is also
SIP-T28P/T46G:
applicable to IP phones.
X ranges from
1 to 6.

Y ranges from
1 to 2)

account.X.sip_ It configures the port of SIP server Y for Account->Register


Integer from
server.Y.port = account X. ->SIP Server Y->
0 to 65535
(SIP-T19P: X=1 The default value is 5060. Port

156
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

SIP-T20P/T21P: Note: The old parameter


X ranges from “account.X.sip_server_port” is also
1 to 2. applicable to IP phones.

SIP-T22P/T26P/T
41P/T42G: X
ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6.

Y ranges from
1 to 2)

account.X.sip_
server.Y.expire
s=

(SIP-T19P: X=1

SIP-T20P/T21P:
X ranges from
1 to 2. It configures the registration expiration
Integer from Account->Register
SIP-T22P/T26P/T time (in seconds) to SIP server Y for
30 to ->SIP Server Y->
41P/T42G: X account X.
2147483647 Server Expires
ranges from 1 The default value is 3600.
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6.

Y ranges from
1 to 2)

account.X.sip_
server.Y.retry_
counts =
It configures the times for the phone to
(SIP-T19P: X=1
retransmit the request when the SIP Account->Register
SIP-T20P/T21P:
Integer from server Y is unavailable or there is no ->SIP Server Y
X ranges from
0 to 20 response from the SIP server Y for ->Server Retry
1 to 2.
account X. Counts
SIP-T22P/T26P/T
The default value is 3.
41P/T42G: X
ranges from 1
to 3.

157
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

SIP-T28P/T46G:
X ranges from
1 to 6.

Y ranges from
1 to 2)

It configures the mode for the phone to


account.X.sip_
retry the primary server in failover
server.Y.failba
mode for account X.
ck_mode =
0-newRequests: all requests are
(SIP-T19P: X=1
forwarded to the primary server first,
SIP-T20P/T21P:
regardless of the last used server.
X ranges from
1-DNSTTL: the phone retries to use the
1 to 2.
primary server after the timeout of the
SIP-T22P/T26P/T
0, 1, 2 or 3 DNSTTL configured for the SIP server.
41P/T42G: X
2-Registration: the phone retries to use
ranges from 1
the primary server when the SIP
to 3.
server’s registration requires renewal.
SIP-T28P/T46G:
3-duration: the phone retries to use the
X ranges from
primary server after the timeout
1 to 6.
defined by the parameter
Y ranges from
“account.X.failback_timeout”.
1 to 2)
The default value is 0.

account.X.sip_
server.Y.failba
ck_timeout =

(SIP-T19P: X=1 It configures the timeout (in seconds)

SIP-T20P/T21P: for the phone to retry to use the

X ranges from primary server after failing over to the

1 to 2. current working server for account X


Integer 0,
when the parameter
SIP-T22P/T26P/T
from 60 to
“account.X.sip_server.Y.failback_mode
41P/T42G: X
65535
” is set to 3 (duration).
ranges from 1
to 3. If you set the parameter between 1
and 59, the timeout will be 60 seconds.
SIP-T28P/T46G:
X ranges from The default value is 3600.

1 to 6.

Y ranges from
1 to 2)

158
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

account.X.sip_
server.Y.regist
er_on_enable
=

(SIP-T19P: X=1

SIP-T20P/T21P: It enables or disables the phone to

X ranges from send registration requests to the

1 to 2. secondary server for account X when


encountering a failover.
SIP-T22P/T26P/T 0 or 1

41P/T42G: X 0-Disabled

ranges from 1 1-Enabled


to 3. The default value is 0.
SIP-T28P/T46G:
X ranges from
1 to 6.

Y ranges from
1 to 2)

account.X.stat
ic_cache_pri
=

(SIP-T19P: X=1 It configures whether preferentially to


use the DNS static cache for domain
SIP-T20P/T21P:
name resolution of the SIP server for
X ranges from
account X.
1 to 2.
0 or 1
0-Use domain name server
SIP-T22P/T26P/T
preferentially
41P/T42G: X
ranges from 1 1-Use DNS static cache preferentially

to 3. The default value is 0.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.dns It configures the content that the DNS

_cache_type static cache records for account X.

= 0-Do not use DNS static cache.

(SIP-T19P: X=1 0, 1 or 2 1-Use DNS static cache, but do not

SIP-T20P/T21P: record the additional records.

X ranges from 2-Use DNS static cache and record the


1 to 2. additional records.

159
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

SIP-T22P/T26P/T The default value is 1.


41P/T42G: X
ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.dns
_cache_a.Y.na
me =

(SIP-T19P: X=1

SIP-T20P/T21P:
It configures the domain name of A
X ranges from
record Y in the DNS static cache for
1 to 2. Domain
account X.
SIP-T22P/T26P/T name
The default value is blank.
41P/T42G: X
It takes effect after a reboot.
ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.dns
_cache_a.Y.ip
=

(SIP-T19P: X=1

SIP-T20P/T21P:
It configures the IP address that the
X ranges from
domain name of A record Y maps to in
1 to 2.
IP address the DNS static cache for account X.
SIP-T22P/T26P/T
The default value is blank.
41P/T42G: X
It takes effect after a reboot.
ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.dns Integer from It configures the time interval that A


_cache_a.Y.ttl 30 to record Y may be cached before the
= 2147483647 record should be consulted again for

160
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

(SIP-T19P: X=1 account X.

SIP-T20P/T21P: The default value is 300.


X ranges from It takes effect after a reboot.
1 to 2.

SIP-T22P/T26P/T
41P/T42G: X
ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.dns
_cache_srv.Y.n
ame =

(SIP-T19P: X=1

SIP-T20P/T21P:
X ranges from It configures the domain name of SRV

1 to 2. Domain record Y in the DNS static cache for

name account X.
SIP-T22P/T26P/T
41P/T42G: X It takes effect after a reboot.

ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.dns
_cache_srv.Y.p
ort =

(SIP-T19P: X=1

SIP-T20P/T21P:
X ranges from It configures the port to be used in SRV

1 to 2. Integer from record Y for account X.

SIP-T22P/T26P/T 0 to 65535 The default value is 0.

41P/T42G: X It takes effect after a reboot.


ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

161
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

account.X.dns
_cache_srv.Y.p
riority =

(SIP-T19P: X=1

SIP-T20P/T21P:
It configures the priority for the specific
X ranges from
host entry in SRV record Y for account
1 to 2. Integer from
X. Lower priority is more preferred.
SIP-T22P/T26P/T 0 to 65535
The default value is 0.
41P/T42G: X
It takes effect after a reboot.
ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.dns
_cache_srv.Y.t
arget =

(SIP-T19P: X=1

SIP-T20P/T21P:
X ranges from It configures the actual host for an A

1 to 2. Domain query for account X.

SIP-T22P/T26P/T name The default value is blank.

41P/T42G: X It takes effect after a reboot.


ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.dns
_cache_srv.Y.
It configures the weight of SRV record Y
weight =
for account X.
(SIP-T19P: X=1
When priorities are equal, weight is
SIP-T20P/T21P: Integer from
used to differentiate the preference.
X ranges from 0 to 65535
Higher weight is more preferred.
1 to 2.
The default value is 0.
SIP-T22P/T26P/T
It takes effect after a reboot.
41P/T42G: X
ranges from 1

162
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.dns
_cache_srv.Y.tt
l=

(SIP-T19P: X=1

SIP-T20P/T21P: It configures the time interval that SRV

X ranges from record Y may be cached before the


Integer from
1 to 2. record should be consulted again for
30 to
account X.
SIP-T22P/T26P/T
2147483647
41P/T42G: X The default value is 300.

ranges from 1 It takes effect after a reboot.


to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.dns
_cache_naptr.
Y.name =

(SIP-T19P: X=1

SIP-T20P/T21P:
It configures the domain name to
X ranges from
which NAPTR record Y refers in the
1 to 2. Domain
DNS static cache for account X.
SIP-T22P/T26P/T name
The default value is blank.
41P/T42G: X
It takes effect after a reboot.
ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.dns It configures the flag of NAPTR record Y


_cache_naptr. in the DNS static cache for account X.
Y.flags = (Always “s” for SIP, which means to do
S, A, U or P
(SIP-T19P: X=1 an SRV lookup on whatever is in the
replacement field)
SIP-T20P/T21P:
X ranges from S-Do an SRV lookup next.

163
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

1 to 2. A-Do an A lookup next.

SIP-T22P/T26P/T U-No need to do a DNS query next.


41P/T42G: X P-Service customized by the user
ranges from 1
The default value is blank.
to 3.
It takes effect after a reboot.
SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.dns
_cache_naptr.
Y.order =

(SIP-T19P: X=1

SIP-T20P/T21P:
It configures the order of NAPTR record
X ranges from
Y for account X. NAPTR record with
1 to 2. Integer from
lower order is more preferred.
SIP-T22P/T26P/T 0 to 65535
The default value is 0.
41P/T42G: X
It takes effect after a reboot.
ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.dns
_cache_naptr.
Y.preference
=

(SIP-T19P: X=1
It configures the preference of NAPTR
SIP-T20P/T21P:
record Y for account X. NAPTR record
X ranges from
Integer from with lower preference is more
1 to 2.
0 to 65535 preferred.
SIP-T22P/T26P/T
The default value is 0.
41P/T42G: X
It takes effect after a reboot.
ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

164
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

account.X.dns
_cache_naptr.
Y.replace =

(SIP-T19P: X=1

SIP-T20P/T21P:
It configures a domain name to be
X ranges from
used for the next SRV query in NAPTR
1 to 2. Domain
record Y for account X.
SIP-T22P/T26P/T name
The default value is blank.
41P/T42G: X
It takes effect after a reboot.
ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.dns
_cache_naptr.
Y.service =

(SIP-T19P: X=1

SIP-T20P/T21P:
It configures the transport protocol
X ranges from
String within available for SIP in NAPTR record Y for
1 to 2.
32 account X.
SIP-T22P/T26P/T
characters The default value is blank.
41P/T42G: X
It takes effect after a reboot.
ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.dns
_cache_naptr.
Y.ttl = It configures the time interval that

(SIP-T19P: X=1 NAPTR record Y may be cached before


Integer from
the record should be consulted again
SIP-T20P/T21P:
30 to
for account X.
X ranges from
2147483647
1 to 2. The default value is 300.

SIP-T22P/T26P/T It takes effect after a reboot.

41P/T42G: X
ranges from 1

165
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.srv_
ttl_timer_enab
le =

(SIP-T19P: X=1
It enables or disables the phone to
SIP-T20P/T21P: refresh the DNS-SRV query record at
X ranges from the regular time for account X.
1 to 2.
0 or 1 0-Disabled
SIP-T22P/T26P/T
1-Enabled
41P/T42G: X
The default value is 0.
ranges from 1
It takes effect after a reboot.
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.out
bound_proxy_
enable =

(SIP-T19P: X=1
It enables or disables the phone to use
SIP-T20P/T21P:
the outbound proxy server for account
X ranges from Account->Register
X.
1 to 2. ->Enable
0 or 1
0-Disabled Outbound Proxy
SIP-T22P/T26P/T
41P/T42G: X 1-Enabled Server

ranges from 1 The default value is 0.


to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.out
bound_host = It configures the IP address or domain
IP address Account->Register
(SIP-T19P: X=1 name of the outbound proxy server for
or domain ->Outbound Proxy
account X.
SIP-T20P/T21P:
name Server
X ranges from The default value is blank.

1 to 2.

166
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

SIP-T22P/T26P/T
41P/T42G: X
ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.out
bound_port =

(SIP-T19P: X=1

SIP-T20P/T21P:
X ranges from
1 to 2. It configures the port of the outbound Account->Register
Integer from
proxy server for account X. ->Outbound Proxy
SIP-T22P/T26P/T
0 to 65535
41P/T42G: X The default value is 5060. Server->Port

ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

voice_mail.nu
mber.X =

(SIP-T19P: X=1

SIP-T20P/T21P:
X ranges from
1 to 2. String within It configures the voice mail number for Account->
99 account X. Advanced->Voice
SIP-T22P/T26P/T
41P/T42G: X characters The default value is blank. Mail

ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.pro
xy_require = String within It configures the proxy server for
Account->Basic->
(SIP-T19P: X=1 256 account X.
Proxy Require
characters The default value is blank.
SIP-T20P/T21P:
X ranges from

167
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

1 to 2.

SIP-T22P/T26P/T
41P/T42G: X
ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.sip_
trust_ctrl =

(SIP-T19P: X=1

SIP-T20P/T21P: It enables or disables the phone to


X ranges from only accept the message from the
1 to 2. trusted server for account X.
SIP-T22P/T26P/T 0 or 1
0-Disabled
41P/T42G: X
1-Enabled
ranges from 1
The default value is 0.
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.ano
nymous_call =

(SIP-T19P: X=1

SIP-T20P/T21P:
It enables or disables anonymous call
X ranges from
feature for account X.
1 to 2.
Account->Basic->
0 or 1 0-Disabled
SIP-T22P/T26P/T
Local Anonymous
41P/T42G: X 1-Enabled

ranges from 1 The default value is 0.


to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.sen It configures the phone to send


Account->Basic->
d_anonymous anonymous on/off code to
0 or 1 Send Anonymous
_code = activate/deactivate the server-side
Code
(SIP-T19P: X=1 anonymous call feature for account X.

168
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

SIP-T20P/T21P: 0-Off Code


X ranges from 1-On Code
1 to 2.
The default value is 0.
SIP-T22P/T26P/T
41P/T42G: X
ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.ano
nymous_call_o
ncode =

(SIP-T19P: X=1

SIP-T20P/T21P: It configures the code for activating the

X ranges from server-side anonymous call feature for


String within Account->Basic->
1 to 2. account X when the parameter
32 Anonymous Call->
“account.X.send_anonymous_code” is
SIP-T22P/T26P/T
characters On Code
set to 1 (On Code).
41P/T42G: X
ranges from 1 The default value is blank.

to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.ano
nymous_call_o
ffcode =

(SIP-T19P: X=1

SIP-T20P/T21P: It configures the code for deactivating

X ranges from the server-side anonymous call feature


String within Account->Basic->
1 to 2. for account X when the parameter
32 Anonymous Call->
“account.X.send_anonymous_code” is
SIP-T22P/T26P/T
characters Off Code
set to 0 (Off Code).
41P/T42G: X
ranges from 1 The default value is blank.

to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

169
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

account.X.reje
ct_anonymous
_call =

(SIP-T19P: X=1

SIP-T20P/T21P: It enables or disables anonymous call


X ranges from rejection feature for account X.
Account->Basic->
1 to 2.
0 or 1 0-Disabled Anonymous Call
SIP-T22P/T26P/T
1-Enabled Rejection
41P/T42G: X
The default value is 0.
ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.ano
nymous_reject
_oncode =

(SIP-T19P: X=1

SIP-T20P/T21P:
X ranges from It configures the code for activating the Account->Basic->
String within
1 to 2. server-side anonymous call rejection Anonymous Call
32
feature for account X. Rejection->On
SIP-T22P/T26P/T
characters
41P/T42G: X The default value is blank. Code

ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.ano
nymous_reject
_offcode =

(SIP-T19P: X=1 It configures the code for deactivating Account->Basic->


String within
the server-side anonymous call Anonymous Call
SIP-T20P/T21P:
32
rejection feature for account X. Rejection->Off
X ranges from
characters
1 to 2. The default value is blank. Code

SIP-T22P/T26P/T
41P/T42G: X
ranges from 1

170
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.dnd
.enable =

(SIP-T20P/T21P:
X ranges from
1 to 2.
It enables or disables DND feature for
SIP-T22P/T26P/T
account X when the DND mode is
41P/T42G: X
configured as Custom. Features->Forwar
ranges from 1
0 or 1 d& DND->DND
to 3. 0-Disabled
->DND Status
SIP-T28P/T46G: 1-Enabled

X ranges from The default value is 0.


1 to 6)

(not
applicable to
SIP-T19P IP
phones)

account.X.dnd
.on_code =

(SIP-T20P/T21P:
X ranges from
1 to 2.

SIP-T22P/T26P/T
41P/T42G: X It configures the DND on code for
String within Features->Forwar
ranges from 1 account X when the DND mode is
32 d& DND->DND On
to 3. configured as Custom.
characters Code
SIP-T28P/T46G: The default value is blank.

X ranges from
1 to 6)

(not
applicable to
SIP-T19P IP
phones)

account.X.dnd String within It configures the DND off code for Features->Forwar
.off_code = 32 account X when the DND mode is d& DND->DND Off

171
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

(SIP-T20P/T21P: characters configured as Custom. Code


X ranges from The default value is blank.
1 to 2.

SIP-T22P/T26P/T
41P/T42G: X
ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

(not
applicable to
SIP-T19P IP
phones)

account.X.alw
ays_fwd.enab
le =

(SIP-T20P/T21P:
X ranges from
1 to 2. It enables or disables always forward
feature for account X when the call
SIP-T22P/T26P/T
forward mode is configured as
41P/T42G: X Features->Forwar
Custom.
ranges from 1 0 or 1 d& DND->Always
to 3. 0-Disabled Forward->On/Off

SIP-T28P/T46G: 1-Enabled

X ranges from The default value is 0.


1 to 6)

(not
applicable to
SIP-T19P IP
phones)

account.X.alw
ays_fwd.targe
It configures the target number the
t=
String within phone forwards all incoming calls to Features->Forwar
(SIP-T20P/T21P:
32 for account X when the call forward d& DND->Always
X ranges from
characters mode is configured as Custom. Forward->Target
1 to 2.
The default value is blank.
SIP-T22P/T26P/T
41P/T42G: X

172
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

(not
applicable to
SIP-T19P IP
phones)

account.X.bus
y_fwd.enable
=

(SIP-T20P/T21P:
X ranges from
1 to 2. It enables or disables busy forward
feature for account X when the call
SIP-T22P/T26P/T
forward mode is configured as
41P/T42G: X Features->Forwar
Custom.
ranges from 1 0 or 1 d& DND->Busy
to 3. 0-Disabled Forward->On/Off

SIP-T28P/T46G: 1-Enabled

X ranges from The default value is 0.


1 to 6)

(not
applicable to
SIP-T19P IP
phones)

account.X.bus
y_fwd.target
=

(SIP-T20P/T21P:
It configures the target number the
X ranges from
phone forwards incoming calls to
1 to 2. String within Features->Forwar
when busy for account X when the call
SIP-T22P/T26P/T 32 d& DND->Busy
forward mode is configured as
41P/T42G: X characters Forward->Target
Custom.
ranges from 1
The default value is blank.
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

173
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

(not
applicable to
SIP-T19P IP
phones)

account.X.tim
eout_fwd.ena
ble =

(SIP-T20P/T21P:
X ranges from
1 to 2. It enables or disables no answer
forward feature for account X when
SIP-T22P/T26P/T
the call forward mode is configured as Features->Forwar
41P/T42G: X
Custom. d& DND->No
ranges from 1 0 or 1
Answer Forward->
to 3. 0-Disabled
On/Off
SIP-T28P/T46G: 1-Enabled

X ranges from The default value is 0.


1 to 6)

(not
applicable to
SIP-T19P IP
phones)

account.X.tim
eout_fwd.targ
et =

(SIP-T20P/T21P:
X ranges from
1 to 2.
It configures the target number the
SIP-T22P/T26P/T
phone forwards incoming calls to after Features->Forwar
41P/T42G: X String within
a period of ring time for account X d& DND->No
ranges from 1 32
when the call forward mode is Answer Forward->
to 3. characters
configured as Custom. Target
SIP-T28P/T46G:
The default value is blank.
X ranges from
1 to 6)

(not
applicable to
SIP-T19P IP
phones)

174
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

account.X.tim
eout_fwd.time
out =

(SIP-T20P/T21P:
X ranges from
1 to 2. It configures ring times (N) to wait

SIP-T22P/T26P/T before forwarding incoming calls for Features->Forwar


41P/T42G: X account X when the call forward mode d& DND->No
Integer from
ranges from 1 is configured as Custom. Answer Forward->
0 to 20
to 3. Incoming calls are forwarded when After Ring Time

SIP-T28P/T46G: not answered after N*6 seconds. (0~120s)

X ranges from The default value is 2.


1 to 6)

(not
applicable to
SIP-T19P IP
phones)

account.X.alw
ays_fwd.off_c
ode =

(SIP-T20P/T21P:
X ranges from
1 to 2.

SIP-T22P/T26P/T It configures the always forward off


Features->Forwar
41P/T42G: X String within code for account X when the call
d& DND->Always
ranges from 1 32 forward mode is configured as
Forward ->Off
to 3. characters Custom.
Code
SIP-T28P/T46G: The default value is blank.

X ranges from
1 to 6)

(not
applicable to
SIP-T19P IP
phones)

account.X.alw It configures the always forward on


Features->Forwar
ays_fwd.on_c String within code for account X when the call
d& DND->Always
ode = 32 forward mode is configured as
Forward->On
characters Custom.
(SIP-T20P/T21P:
Code
X ranges from The default value is blank.

175
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

1 to 2.

SIP-T22P/T26P/T
41P/T42G: X
ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

(not
applicable to
SIP-T19P IP
phones)

account.X.bus
y_fwd.off_cod
e=

(SIP-T20P/T21P:
X ranges from
1 to 2.

SIP-T22P/T26P/T
It configures the busy forward off code Features->Forwar
41P/T42G: X String within
for account X when the call forward d& DND->Busy
ranges from 1 32
mode is configured as Custom. Forward ->Off
to 3. characters
The default value is blank. Code
SIP-T28P/T46G:
X ranges from
1 to 6)

(not
applicable to
SIP-T19P IP
phones)

account.X.bus
y_fwd.on_cod
e=

(SIP-T20P/T21P: It configures the busy forward on code Features->Forwar


String within
X ranges from for account X when the call forward d& DND->Busy
32
1 to 2. mode is configured as Custom. Forward->On
characters
SIP-T22P/T26P/T The default value is blank. Code

41P/T42G: X
ranges from 1
to 3.

176
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

SIP-T28P/T46G:
X ranges from
1 to 6)

(not
applicable to
SIP-T19P IP
phones)

account.X.tim
eout_fwd.off_c
ode =

(SIP-T20P/T21P:
X ranges from
1 to 2.

SIP-T22P/T26P/T It configures the no answer forward off


Features->Forwar
41P/T42G: X String within code for account X when the call
d& DND->No
ranges from 1 32 forward mode is configured as
Answer Forward
to 3. characters Custom.
->Off Code
SIP-T28P/T46G: The default value is blank.

X ranges from
1 to 6)

(not
applicable to
SIP-T19P IP
phones)

account.X.tim
eout_fwd.on_c
ode =

(SIP-T20P/T21P:
X ranges from
1 to 2. It configures the no answer forward on
Features->Forwar
SIP-T22P/T26P/T String within code for account X when the call
d& DND->No
41P/T42G: X 32 forward mode is configured as
Answer Forward
ranges from 1 characters Custom.
->On Code
to 3. The default value is blank.

SIP-T28P/T46G:
X ranges from
1 to 6)

(not
applicable to

177
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

SIP-T19P IP
phones)

account.X.sip_
listen_port =

(SIP-T19P: X=1

SIP-T20P/T21P:
X ranges from
1 to 2. Integer from It configures the local SIP port for Account->
1024 to account X. Advanced->Local
SIP-T22P/T26P/T
41P/T42G: X 65535 The default value is 5060. SIP Port

ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.100
rel_enable =

(SIP-T19P: X=1

SIP-T20P/T21P:
It enables or disables 100 reliable
X ranges from
retransmission feature for account X.
1 to 2. Account->
0 or 1 0-Disabled Advanced->
SIP-T22P/T26P/T
41P/T42G: X 1-Enabled Retransmission

ranges from 1 The default value is 0.


to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.sub
scribe_mwi =

(SIP-T19P: X=1 It enables or disables the phone to


subscribe the message waiting
SIP-T20P/T21P:
indicator for account X. Account->
X ranges from
0 or 1 Advanced->
1 to 2. 0-Disabled
Subscribe for MWI
SIP-T22P/T26P/T 1-Enabled

41P/T42G: X The default value is 0.


ranges from 1
to 3.

178
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.sub
scribe_mwi_e
xpires =

(SIP-T19P: X=1

SIP-T20P/T21P:
X ranges from Account->
It configures the interval (in seconds)
1 to 2. Integer from Advanced->MWI
of MWI subscription for account X.
SIP-T22P/T26P/T 0 to 84600 Subscription Period
The default value is 3600.
41P/T42G: X (Seconds)

ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.cid_
source = It configures the source caller identity
(SIP-T19P: X=1 for presentation when receiving an

SIP-T20P/T21P: incoming call for account X.

X ranges from 0-FROM


1 to 2. 1-PAI Account->
0, 1, 2, 3, 4 or
SIP-T22P/T26P/T Advanced->Caller
5 2-PAI-FROM
41P/T42G: X ID Source
3-PRID-PAI-FROM
ranges from 1
4-PAI-RPID-FROM,
to 3.
5-RPID-FROM
SIP-T28P/T46G:
X ranges from The default value is 0.

1 to 6)

account.X.cid_
source_privac It enables or disables the phone to

y= deal with PRIVACY header field in the


180 or 200 OK message for account X.
(SIP-T19P: X=1
0 or 1
0-Disabled
SIP-T20P/T21P:
X ranges from 1-Enabled

1 to 2. The default value is 1.

SIP-T22P/T26P/T

179
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

41P/T42G: X
ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.cid_
source_ppi =

(SIP-T19P: X=1
It enables or disables the phone to
SIP-T20P/T21P: process the P-Preferred-Identity header
X ranges from for caller identity presentation when
1 to 2. receiving an incoming call for account
SIP-T22P/T26P/T 0 or 1 X.
41P/T42G: X 0-Disabled
ranges from 1
1-Enabled
to 3.
The default value is 1.
SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.cp_
source =

(SIP-T19P: X=1

SIP-T20P/T21P: It configures the source callee identity


X ranges from for presentation for account X.
1 to 2.
0-PAI-RPID
SIP-T22P/T26P/T 0, 1 or 2
1-Dialed Digits
41P/T42G: X
2-RFC4916
ranges from 1
The default value is 0.
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.ses
It enables or disables the session timer
sion_timer.ena
for account X.
Account->
ble =
0 or 1 0-Disabled Advanced->
(SIP-T19P: X=1
1-Enabled Session Timer
SIP-T20P/T21P:
The default value is 0.
X ranges from

180
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

1 to 2.

SIP-T22P/T26P/T
41P/T42G: X
ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.ses
sion_timer.exp
ires =

(SIP-T19P: X=1

SIP-T20P/T21P:
X ranges from It configures the interval (in seconds) Account->
1 to 2. Integer from for refreshing the SIP session for Advanced->
30 to 7200 account X. Session Expires
SIP-T22P/T26P/T
41P/T42G: X The default value is 1800. (30~7200s)

ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.ses
sion_timer.refr
esher =

(SIP-T19P: X=1

SIP-T20P/T21P: It configures the refresher of the


X ranges from session timer for account X.
Account->
1 to 2.
0 or 1 0-Uac Advanced->
SIP-T22P/T26P/T
1-Uas Session Refresher
41P/T42G: X
The default value is 0.
ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.ena It enables or disables the Account->


0 or 1
ble_user_equ "user=phone" carried in the INVITE Advanced->Send

181
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

al_phone = message for account X. user=phone

(SIP-T19P: X=1 0-Disabled

SIP-T20P/T21P: 1-Enabled
X ranges from The default value is 0.
1 to 2.

SIP-T22P/T26P/T
41P/T42G: X
ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.srtp
_encryption =

(SIP-T19P: X=1

SIP-T20P/T21P: It configures whether to use voice


X ranges from encryption service for account X.
1 to 2. Account->
0-Disabled
SIP-T22P/T26P/T 0, 1 or 2 Advanced->RTP
1-Optional
41P/T42G: X Encryption (SRTP)
2-Compulsory
ranges from 1
The default value is 0.
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.pti
me =

(SIP-T19P: X=1

SIP-T20P/T21P:
X ranges from
1 to 2. 0 (Disabled), It configures the RTP packet time for Account->
10, 20, 30, account X. Advanced->PTime
SIP-T22P/T26P/T
41P/T42G: X 40, 50 or 60 The default value is 20. (ms)

ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

182
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

account.X.bla
_number =

(SIP-T19P: X=1

SIP-T20P/T21P:
X ranges from
1 to 2. String within It configures the BLA number for Account->
99 account X. Advanced->BLA
SIP-T22P/T26P/T
41P/T42G: X characters The default value is blank. Number

ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.bla
_subscribe_pe
riod =

(SIP-T19P: X=1

SIP-T20P/T21P:
X ranges from
It configures the period (in seconds) of Account->
1 to 2. Integer from
BLA subscription for account X. Advanced->BLA
SIP-T22P/T26P/T 60 to 7200
The default value is 300. Subscription Period
41P/T42G: X
ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.regi
ster_mac =

(SIP-T19P: X=1
It enables or disables the phone to
SIP-T20P/T21P: carry the MAC address in the
X ranges from REGISTER message for account X. Account->

1 to 2. 0 or 1 Advanced->SIP
0-Disabled
Send MAC
SIP-T22P/T26P/T
1-Enabled
41P/T42G: X
The default value is 0.
ranges from 1
to 3.

SIP-T28P/T46G:

183
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

X ranges from
1 to 6)

account.X.regi
ster_line =

(SIP-T19P: X=1

SIP-T20P/T21P: It enables or disables the phone to


X ranges from carry the line number in the REGISTER
1 to 2. message for account X. Account->

SIP-T22P/T26P/T 0 or 1 Advanced->SIP
0-Disabled
41P/T42G: X Send Line
1-Enabled
ranges from 1
The default value is 0.
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.dial
oginfo_callpic
kup =

(SIP-T20P/T21P:
X ranges from
1 to 2.
It enables or disables the phone to
SIP-T22P/T26P/T pick up a call according to the SIP
Account->
41P/T42G: X header of dialog-info for account X.
Advanced->
ranges from 1 0 or 1
0-Disabled Dialog Info Call
to 3.
1-Enabled Pickup
SIP-T28P/T46G:
The default value is 0.
X ranges from
1 to 6)

(not
applicable to
SIP-T19P IP
phones)

account.X.gro
up_pickup_co
String within It configures the group pickup code for Account->
de =
32 account X. Advanced->Group
(SIP-T19P: X=1
characters The default value is blank. Call Pickup Code
SIP-T20P/T21P:
X ranges from

184
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

1 to 2.

SIP-T22P/T26P/T
41P/T42G: X
ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.dire
ct_pickup_cod
e=

(SIP-T19P: X=1

SIP-T20P/T21P:
X ranges from Account->
String within It configures the directed pickup code
1 to 2. Advanced->
32 for account X.
SIP-T22P/T26P/T Directed Call
characters The default value is blank.
41P/T42G: X Pickup Code

ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.aut
o_answer =

(SIP-T19P: X=1

SIP-T20P/T21P:
It enables or disables auto answer
X ranges from
feature for account X.
1 to 2.
Account->Basic->
0 or 1 0-Disabled
SIP-T22P/T26P/T
Auto Answer
41P/T42G: X 1-Enabled

ranges from 1 The default value is 0.


to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

features.auto_ It configures the delay time (in


Integer from
answer_delay seconds) before the phone
1 to 4
= automatically answers an incoming

185
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

call.

The default value is 1.

account.X.mis
sed_calllog =

(SIP-T19P: X=1

SIP-T20P/T21P:
It enables or disables the phone to
X ranges from
record the missed call of account X.
1 to 2.
Account->Basic->
0 or 1 0-Disabled
SIP-T22P/T26P/T
Missed Call Log
41P/T42G: X 1-Enabled

ranges from 1 The default value is 1.


to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.sub
scribe_mwi_to
_vm =

(SIP-T19P: X=1
It enables or disables the phone to
SIP-T20P/T21P: subscribe to the voice mail number for
X ranges from the message waiting indicator for Account->
1 to 2. account X. Advanced->
0 or 1
SIP-T22P/T26P/T Subscribe MWI To
0-Disabled
41P/T42G: X Voice Mail
1-Enabled
ranges from 1
The default value is 0.
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.reg
_fail_retry_inte
rval =
It configures the interval (in seconds) Account->
(SIP-T19P: X=1
Integer from for the phone to retry to register Advanced->SIP
SIP-T20P/T21P: account X when registration fails.
0 to 1800 Registration Retry
X ranges from
The default value is 30. Timer (0~1800s)
1 to 2.

SIP-T22P/T26P/T
41P/T42G: X

186
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.con
f_type =

(SIP-T19P: X=1

SIP-T20P/T21P:
It configures the conference type for
X ranges from
account X.
1 to 2. Account->
0 or 2 0-Local Conference Advanced->
SIP-T22P/T26P/T
41P/T42G: X 2-Network Conference Conference Type

ranges from 1 The default value is 0.


to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.con
f_uri =

(SIP-T19P: X=1

SIP-T20P/T21P:
X ranges from
1 to 2. SIP URI It configures the network conference Account->
within 511 URI for account X. Advanced->
SIP-T22P/T26P/T
41P/T42G: X characters The default value is blank. Conference URI

ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.blf.s
ubscribe_peri
od = Integer from It configures the period (in seconds) of

(SIP-T19P: X=1 30 to the BLF subscription for account X.

SIP-T20P/T21P: 2147483647 The default value is 1800.

X ranges from
1 to 2.

187
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

SIP-T22P/T26P/T
41P/T42G: X
ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.blf.s
ubscribe_even
t=

(SIP-T19P: X=1

SIP-T20P/T21P: It configures the event of the BLF


X ranges from subscription for account X.
1 to 2.
0 or 1 0-Dialog
SIP-T22P/T26P/T
1-Presence
41P/T42G: X
The default value is 0.
ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.sip_
server_type =

(SIP-T19P: X=1
It configures the SIP server type for
SIP-T20P/T21P:
account X.
X ranges from
0-Default
1 to 2. Account->
0, 2, 4 or 6 2-BroadSoft Advanced->SIP
SIP-T22P/T26P/T
41P/T42G: X 4-Cosmocom Server Type

ranges from 1 6-UCAP


to 3.
The default value is 0.
SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.mus
SIP URI It configures the URI of the Music On Account->
ic_server_uri
within 256 Hold server for account X. Advanced->Music
=
characters The default value is blank. Server URI
(SIP-T19P: X=1

188
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

SIP-T20P/T21P:
X ranges from
1 to 2.

SIP-T22P/T26P/T
41P/T42G: X
ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.dtm
f.type =

(SIP-T19P: X=1
It configures the DTMF type for account
SIP-T20P/T21P:
X.
X ranges from
0-INBAND
1 to 2. Account->
0, 1, 2 or 3 1-RFC2833 Advanced->DTMF
SIP-T22P/T26P/T
41P/T42G: X 2-SIP INFO Type

ranges from 1 3-AUTO or SIP INFO


to 3.
The default value is 1.
SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.dtm
f.dtmf_payloa
d=

(SIP-T19P: X=1

SIP-T20P/T21P:
X ranges from Account->
It configures the RFC2833 payload for
1 to 2. Integer from Advanced->DTMF
account X.
SIP-T22P/T26P/T 96 to 127 Payload Type
The default value is 101.
41P/T42G: X (96~127)

ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.dtm 1, 2 or 3 It configures the DTMF info type when Account->

189
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

f.info_type = the DTMF type is configured as “SIP Advanced->DTMF

(SIP-T19P: X=1 INFO”, “AUTO or SIP INFO” for account Info Type
X.
SIP-T20P/T21P:
X ranges from 0-Disabled

1 to 2. 1-DTMF-Relay

SIP-T22P/T26P/T 2-DTMF
41P/T42G: X 3-Telephone-Event
ranges from 1
The default value is 0.
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.nat.
nat_traversal
=

(SIP-T19P: X=1

SIP-T20P/T21P: It enables or disables the NAT


X ranges from traversal for account X.
1 to 2. Account->Register
0 or 1 0-Disabled
SIP-T22P/T26P/T ->NAT
1-Enabled
41P/T42G: X
The default value is 0.
ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.nat.
stun_server =

(SIP-T19P: X=1

SIP-T20P/T21P:
X ranges from
IP address It configures the IP address or domain
1 to 2. Account->Register
or domain name of the STUN server for account X.
->STUN Server
SIP-T22P/T26P/T name The default value is blank.
41P/T42G: X
ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from

190
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

1 to 6)

account.X.nat.
stun_port =

(SIP-T19P: X=1

SIP-T20P/T21P:
X ranges from
1 to 2. Integer from It configures the port of the STUN Account->Register
1024 to server for account X. ->STUN Server
SIP-T22P/T26P/T
41P/T42G: X 65000 The default value is 3478. ->Port

ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.nat.
It configures the type of keep-alive
udp_update_e
packets sent by the phone to the NAT
nable =
device to keep the communication port
(SIP-T19P: X=1 open so that NAT can continue to
SIP-T20P/T21P: function for account X.
X ranges from 0-Dsiabled
Account->
1 to 2.
0, 1, 2 or 3 1-Default: the phone sends UDP Advanced->Keep
SIP-T22P/T26P/T packets to the server. Alive Type
41P/T42G: X
2-Option: the phone sends SIP OPTION
ranges from 1
packets to the server.
to 3.
3-Notify: the phone sends SIP NOTIFY
SIP-T28P/T46G:
packets to the server.
X ranges from
The default value is 1.
1 to 6)

account.X.nat.
udp_update_ti
me =

(SIP-T19P: X=1 Account->


Integer from It configures the keep-alive interval (in
SIP-T20P/T21P: Advanced->Keep
15 to seconds) for account X.
X ranges from Alive Interval
2147483647 The default value is 30.
1 to 2. (Seconds)

SIP-T22P/T26P/T
41P/T42G: X
ranges from 1

191
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.nat.
rport =

(SIP-T19P: X=1

SIP-T20P/T21P:
It enables or disables NAT Rport
X ranges from
feature for account X.
1 to 2.
Account->
0 or 1 0-Disabled
SIP-T22P/T26P/T
Advanced->RPort
41P/T42G: X 1-Enabled

ranges from 1 The default value is 0.


to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.adv
anced.timer_t
1=

(SIP-T19P: X=1

SIP-T20P/T21P:
X ranges from Account->
It configures the session timer T1 (in
1 to 2. Float from Advanced->SIP
seconds) for account X.
SIP-T22P/T26P/T 0.5~10s Session Timer T1
The default value is 0.5.
41P/T42G: X (0.5~10s)

ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.adv
anced.timer_t
Account->
2= It configures the session timer T2 (in
Float from Advanced->SIP
(SIP-T19P: X=1 seconds) for account X.
2~40s Session Timer T2
SIP-T20P/T21P: The default value is 4.
(2~40s)
X ranges from
1 to 2.

192
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

SIP-T22P/T26P/T
41P/T42G: X
ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.adv
anced.timer_t
4=

(SIP-T19P: X=1

SIP-T20P/T21P:
X ranges from Account->
It configures the session timer T4 (in
1 to 2. Float from Advanced->SIP
seconds) for account X.
SIP-T22P/T26P/T 2.5~60s Session Timer T4
The default value is 5.
41P/T42G: X (2.5~60s)

ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.aler
t_info_url_ena
ble =

(SIP-T19P: X=1
It enables or disables the distinctive
SIP-T20P/T21P:
ring tones by the Alert-Info SIP header
X ranges from Account->
for account X.
1 to 2. Advanced->
0 or 1
0-Disabled Distinctive Ring
SIP-T22P/T26P/T
41P/T42G: X 1-Enabled Tones

ranges from 1 The default value is 0.


to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

It enables and disables the phone to


features.alert_
0 or 1 map the keywords in the Alert-info
info_tone =
header to the specified Bellcore ring

193
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

tones.

0-Disabled

1-Enabled

The default value is 0.

account.X.ring
tone.ring_type
It configures a ring tone for account X.
=
Common, Example:
(SIP-T19P: X=1 Ring1.wav,
account.1.ringtone.ring_type =
SIP-T20P/T21P: Ring2.wav,
Ring3.wav means configuring
X ranges from Ring3.wav
Ring3.wav for account1.
1 to 2. Ring4.wav Account->Basic->
account.1.ringtone.ring_type =
SIP-T22P/T26P/T Ring Type
Ring5.wav Common means account1 will use the
41P/T42G: X
Ring6.wav, ring tone selected for the phone.
ranges from 1
Ring7.wav, The default value is Common.
to 3.
Ring8.wav Note: Ring tones 6-8 are only
SIP-T28P/T46G:
applicable to SIP-T46G IP phones.
X ranges from
1 to 6)

account.X.cod It configures the codec for account X.

ec.Y.payload_ Codecs G726-16, G726-24 and


type = G726-40 are not applicable to SIP-T19P

(SIP-T19P: X=1 and SIP-T21P IP phones.


PCMU
SIP-T20P/T21P: Codec GSM is only applicable to
PCMA
X ranges from SIP-T4X IP phones.
G729
1 to 2. For SIP-T20P/T22P/T26P/T28P/T4X IP
G722
SIP-T22P/T26P/T phones:
G723_53
41P/T42G: X When Y=1, the default value is PCMU;
ranges from 1 G723_63
When Y=2, the default value is PCMA; Account->Codec
to 3. G726-16
When Y=3, the default value is
SIP-T28P/T46G: G726-24
G723_53;
X ranges from G726-32
When Y=4, the default value is
1 to 6
G726-40 G723_63;
SIP-T19/T21P: Y
iLBC When Y=5, the default value is G729;
ranges from 1
GSM When Y=6, the default value is G722;
to 8.
When Y=7, the default value is iLBC;
SIP-T20P/T22P/T
26P/T28P: Y When Y=8, the default value is

ranges from 1 G726-16;

194
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

to 11. When Y=9, the default value is

SIP-T4X: Y G726-24;

ranges from 1 When Y=10, the default value is


to 12) G726-32;

When Y=11, the default value is


G726-40.

When Y=12, the default value is GSM.

For SIP-T19P/T21P 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;

When Y=7, the default value is iLBC;

When Y=8, the default value is


G726-32.

account.X.cod It enables or disables the specified


ec.Y.enable = codec for account X.
(SIP-T19P: X=1 0-Disabled
SIP-T20P/T21P: 1-Enabled
X ranges from
Example:
1 to 2.
account.1.codec.1.enable =1
SIP-T22P/T26P/T
This means that the codec PCMU is
41P/T42G: X
enabled on the phone.
ranges from 1
to 3. 0 or 1 For SIP-T20P/T22P/T26P/T28P/T4X IP Account->Codec
phones:
SIP-T28P/T46G:
X ranges from When Y=1, the default value is 1;

1 to 6 When Y=2, the default value is 1;

SIP-T19/T21P: Y When Y=3, the default value is 0;


ranges from 1 When Y=4, the default value is 0;
to 8.
When Y=5, the default value is 1;
SIP-T20P/T22P/T
When Y=6, the default value is 1;
26P/T28P: Y
When Y=7, the default value is 0;
ranges from 1

195
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

to 11. When Y=8, the default value is 0;

SIP-T4X: Y When Y=9, the default value is 0;


ranges from 1 When Y=10, the default value is 0;
to 12)
When Y=11, the default value is 0.

When Y=12, the default value is 0.

For SIP-T19P/T21P IP phones:

When Y=1, the default value is 1;

When Y=2, the default value is 1;

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.

account.X.cod It configures the priority of the enabled

ec.Y.priority = codec for account X.

(SIP-T19P: X=1 Example:

SIP-T20P/T21P: account.1.codec.1.priority =1
X ranges from For SIP-T20P/T22P/T26P/T28P/T4X IP
1 to 2. Integer from phones:

SIP-T22P/T26P/T 0 to 11 for When Y=1, the default value is 1;


41P/T42G: X SIP-T4X IP
When Y=2, the default value is 2;
ranges from 1 phones
When Y=3, the default value is 0;
to 3. Integer from
When Y=4, the default value is 0;
SIP-T28P/T46G: 0 to 10 for
SIP-T20P/T22P When Y=5, the default value is 3; Account->Codec
X ranges from
1 to 6 /T26P/T28P When Y=6, the default value is 4;
IP phones When Y=7, the default value is 0;
SIP-T19/T21P: Y
ranges from 1 Integer from When Y=8, the default value is 0;
to 8. 0 to 7 for
When Y=9, the default value is 0;
SIP-T19P/T21P
SIP-T20P/T22P/T
When Y=10, the default value is 0;
IP phones
26P/T28P: Y
When Y=11, the default value is 0.
ranges from 1
When Y=12, the default value is 0.
to 11.
For SIP-T19P/T21P IP phones:
SIP-T4X: Y
ranges from 1 When Y=1, the default value is 1;

to 12) When Y=2, the default value is 2;

196
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

When Y=3, the default value is 0;

When Y=4, the default value is 0;

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.

It configures rtpmap of the audio


codec for account X.

Example:

account.1.codec.1.rtpmap = 0
account.X.cod
ec.Y.rtpmap = For SIP-T20P/T22P/T26P/T28P/T4X IP
phones:
(SIP-T19P: X=1
When Y=1, the default value is 0;
SIP-T20P/T21P:
X ranges from When Y=2, the default value is 8;

1 to 2. When Y=3, the default value is 4;

SIP-T22P/T26P/T When Y=4, the default value is 4;


41P/T42G: X
When Y=5, the default value is 18;
ranges from 1
When Y=6, the default value is 9;
to 3.
When Y=7, the default value is 106;
SIP-T28P/T46G:
Integer
When Y=8, the default value is 103;
X ranges from
from 0 to 127
1 to 6 When Y=9, the default value is 104;

SIP-T19/T21P: Y When Y=10, the default value is 102;

ranges from 1 When Y=11, the default value is 105.


to 8.
When Y=12, the default value is 97.
SIP-T20P/T22P/T
For SIP-T19P/T21P IP phones:
26P/T28P: Y
When Y=1, the default value is 0;
ranges from 1
When Y=2, the default value is 8;
to 11.
When Y=3, the default value is 4;
SIP-T4X: Y
ranges from 1 When Y=4, the default value is 4;

to 12) 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 It enables or disables the phone to Account->


0 or 1
egister_on_re un-register account X before a reboot. Advanced->

197
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

boot = 0-Disabled Unregister When

(SIP-T19P: X=1 1-Enabled Reboot

SIP-T20P/T21P: The default value is 0.


X ranges from
1 to 2.

SIP-T22P/T26P/T
41P/T42G: X
ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.pict
ure_info_enab
It enables or disables the phone to
le =
download the picture information for
(SIP-T46G: X account X when receiving an incoming
ranges from 1 call or during a call.
0 or 1
to 6)
0-Disabled
(only
1-Enabled
applicable to
The default value is 0.
SIP-T46G IP
phones)

account.X.co
mpact_heade
r_enable =

(SIP-T19P: X=1
It enables or disables the phone to
SIP-T20P/T21P:
support compact SIP header for
X ranges from
account X.
1 to 2.
0 or 1
0-Disabled
SIP-T22P/T26P/T
41P/T42G: X 1-Enabled

ranges from 1 The default value is 0.


to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.mus It configures the way on how the


0 or 1
ic_on_hold_ty phone processes Music On Hold when

198
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

pe = placing an active call on hold for

(SIP-T19P: X=1 account X.

SIP-T20P/T21P: 0-Calling the music server before

X ranges from holding

1 to 2. 1-Calling the music server after

SIP-T22P/T26P/T holding

41P/T42G: X The default value is 0.


ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.acd
.enable =

(SIP-T19P: X=1

SIP-T20P/T21P:
It enables or disables ACD feature for
X ranges from
account X.
1 to 2.
0 or 1 0-Disabled
SIP-T22P/T26P/T
41P/T42G: X 1-Enabled

ranges from 1 The default value is 0.


to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.acd
.available =

(SIP-T19P: X=1
It enables or disables the phone to
SIP-T20P/T21P:
display the available and unavailable
X ranges from
soft keys for account X after the phone
1 to 2.
logs into the ACD system.
SIP-T22P/T26P/T 0 or 1
0-Disabled
41P/T42G: X
ranges from 1 1-Enabled

to 3. The default value is 0.

SIP-T28P/T46G:
X ranges from
1 to 6)

199
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

account.X.sub
scribe_acd_ex
pires =

(SIP-T19P: X=1

SIP-T20P/T21P:
X ranges from Account->
It configures the period (in seconds) of
1 to 2. Integer from Advanced->ACD
ACD subscription for account X.
SIP-T22P/T26P/T 120 to 3600 Subscrip Period
The default value is 1800.
41P/T42G: X (120~3600s)

ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

200
Appendix

The following table lists configuration parameters that are integrated with BroadSoft
platform. For more information on BroadSoft features, refer to
Yealink_IP_Phones_Deployment_Guide_for_BroadSoft_UC-One_Environment.

Permitted
Parameter Descriptions Web Setting Path
Values

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
0 or 1 1-Enabled
applicable to
The default value is 1.
SIP-T46G IP
phones) It takes effect after a reboot.

features.uc_us
ername = Configures the user name for UC Directory->
String within
authentication. Network
(only
99
applicable to The default value is blank. Directory->UC
characters
SIP-T46G IP It takes effect after a reboot. Username
phones)

features.uc_p
assword = It configures the password for UC Directory->
String within
authentication. Network
(only
32
applicable to The default value is blank. Directory->UC
characters
SIP-T46G IP It takes effect after a reboot. Password

phones)

features.confi
It enables or disables extended length
g_dsskey_len
of the label displayed on the idle LCD
gth =
screen for the line key.
(only 0 or 1
0-Disabled
applicable to
1-Enabled
SIP-T46G IP
The default value is 0.
phones)

phone_setting It enables or disables Auto Favorite Features->General

.dsskey_direct 0 or 1 feature. Information->Auto

ory_auto.ena If enabled, the IP phone will download Favorite

201
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

ble = information of favorites from the cloud

(only server and automatically configure UC

applicable to Favorite keys from the first unused line

SIP-T46G IP key (the line key is configured as N/A).

phones) If a line key is used, the IP phone will


skip to the next unused line key.

0-Disabled

1-Enabled

The default value is 1.

It configures the IP address or domain


name of the Xtended Services Platform
server for account X. Directory->
account.X.xsi. IP address
Network
host = or domain Example:
Directory->Host
(X=1) name account.1.xsi.host =
Server
xsp1.iop1.broadworks.net

The default value is blank.

It configures the port of the Xtended

account.X.xsi. Services Platform server for account X.


Directory->
Integer from
port = Example: Network
1 to 65535
(X=1) account.1.xsi.port = 80 Directory->Port

The default value is 80.

It configures the access protocol of the


Xtended Services Platform server for
Directory->
account.X.xsi.
account X.
“http” or Network
server_type =
“https” Example: Directory->XSI
(X=1)
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. String within Directory->
Example:
user = 99 Network
account.1.xsi.user =
(X=1) characters Directory->User ID
[email protected]

The default value is blank.

account.X.xsi. String within It configures the password for XSI Directory->


password = 99 authentication for account X. Network
(X=1) characters Example: Directory->

202
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

account.1.xsi.password = 123456 Password

The default value is blank.

bw_phoneboo
k.group_enabl It enables or disables the phone to

e= display the group directory.


Directory->
(not 0 or 1 0-Disabled Network
applicable to 1-Enabled Directory->Group
SIP-T20P IP The default value is 1.
phones)

bw_phoneboo
k.group_displ
ayname = String within It configures the display name on the Directory->

(not 99 LCD screen for the group directory. Network

applicable to characters The default value is Group. Directory->Group

SIP-T20P IP
phones)

bw_phoneboo
k.enterprise_e It enables or disables the phone to
display the enterprise directory. Directory->
nable =
Network
(not 0 or 1 0-Disabled
Directory->Enterpri
applicable to 1-Enabled
se
SIP-T20P IP The default value is 1.
phones)

bw_phoneboo
k.enterprise_d
Directory->
isplayname = String within It configures the display name on the
Network
(not 99 LCD screen for the enterprise directory.
Directory->Enterpri
applicable to characters The default value is Enterprise.
se
SIP-T20P IP
phones)

bw_phoneboo
k.group_com
It enables or disables the phone to
mon_enable Directory->
display the group common directory.
= Network
0 or 1 0-Disabled
(not Directory->Group
1-Enabled
applicable to Common
The default value is 1.
SIP-T20P IP
phones)

203
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

bw_phoneboo
k.group_com
mon_displayn It configures the display name on the Directory->
String within
ame = LCD screen for the group common Network
99
(not directory. Directory->Group
characters
applicable to The default value is GroupCommon. Common

SIP-T20P IP
phones)

bw_phoneboo
k.enterprise_c It enables or disables the phone to

ommon_enabl display the enterprise common


Directory->
e= directory.
Network
0 or 1
(not 0-Disabled Directory->Enterpri

applicable to 1-Enabled se Common

SIP-T20P IP The default value is 1.


phones)

bw_phoneboo
k.enterprise_c
It configures the display name on the
ommon_displ Directory->
String within LCD screen for the enterprise common
ayname = Network
99 directory.
(not Directory->Enterpri
characters The default value is
applicable to se Common
EnterpriseCommon.
SIP-T20P IP
phones)

bw_phoneboo
k.personal_en It enables or disables the phone to
display the personal directory. Directory->
able=
Network
(not 0 or 1 0-Disabled
Directory->Person
applicable to 1-Enabled
al
SIP-T20P IP The default value is 1.
phones)

bw_phoneboo
k.personal_dis
Directory->
playname= String within It configures the display name on the
Network
(not 99 LCD screen for the personal directory.
Directory->Person
applicable to characters The default value is Personal.
al
SIP-T20P IP
phones)

204
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

bw_phoneboo
It enables or disables custom directory
k.custom = Directory->
feature.
(not Network
0 or 1 0-Disabled
applicable to Directory->Enable
1-Enabled
SIP-T20P IP Custom Directory
The default value is 0.
phones)

directory.upd
ate_time_inter It configures the interval (in minutes)
val = for the phone to update the data of the
Integer from
(not BroadSoft directory from the BroadSoft
2 to 43200
applicable to server.

SIP-T20P IP The default value is 60.


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=
display the Park soft key during a call.
(not Features->Call
0 or 1 0-Disabled
applicable to Pickup->Call Park
1-Enabled
SIP-T20P IP
The default value is 0.
phones)

call_park.grou It enables or disables the phone to

p_enable= display the GPark soft key during a


call. Features->Call
(not
0 or 1 Pickup->Group
applicable to 0-Disabled
Call Park
SIP-T20P IP 1-Enabled
phones) The default value is 0.

call_park.park
It enables or disables the phone to
_visual_notify_ Features->Call
display a parked indicator when a call
enable = Pickup->Visual
0 or 1 is parked against its line.
(not Alert for Parked
0-Disabled
applicable to Call
1-Enabled
SIP-T20P IP

205
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

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


Features->Call
parked against its line.
(not Pickup->Audio
0 or 1
applicable to 0-Disabled Alert for Parked
SIP-T20P IP 1-Enabled Call
phones) The default value is 0.

It enables or disables feature key


synchronization. Features->General
bw.feature_ke Information->
0 or 1 0-Disabled
y_sync = Feature Key
1-Enabled
Synchronization
The default value is 0.

account.X.blf.
blf_list_uri =

(SIP-T20P/T21P:
X ranges from
1 to 2.

SIP-T22P/T26P/T
41P/T42G: X
SIP URI It configures the BLF List URI to monitor Account->
ranges from 1
within 256 a list of users for account X. Advanced->BLF
to 3.
characters The default value is blank. List URI
SIP-T28P/T46G:
X ranges from
1 to 6)

(not
applicable to
SIP-T19P IP
phones)

account.X.blf_l
ist_code =

(SIP-T20P/T21P:
It configures the feature access code
X ranges from String within Account->
for directed call pickup (default: *97)
1 to 2. 32 Advanced->BLF
for account X.
SIP-T22P/T26P/T characters List Code
The default value is blank.
41P/T42G: X
ranges from 1
to 3.

206
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

SIP-T28P/T46G:
X ranges from
1 to 6)

(not
applicable to
SIP-T19P IP
phones)

account.X.blf_l
ist_barge_in_c
ode =

(SIP-T20P/T21P:
X ranges from
1 to 2.

SIP-T22P/T26P/T
It configures the feature access code
41P/T42G: X String within Account->
for directed call pickup with barge-in
ranges from 1 32 Advanced->BLF
(default: *33) for account X.
to 3. characters List Barge In Code
The default value is blank.
SIP-T28P/T46G:
X ranges from
1 to 6)

(not
applicable to
SIP-T19P IP
phones)

phone_setting
It enables or disables the phone to
.auto_blf_list_
automatically configure the BLF list
enable =
keys in order.
(not 0 or 1
0-Disabled
applicable to
1-Enabled
SIP-T19P IP
The default value is 1.
phones)

phone_setting
It configures the order of BLF list keys
.blf_list_seque
assigned automatically.
nce_type =
0-Line Keys->Memory
(only
0 or 1 Keys->Extension Keys
applicable to
1-Extension Keys->Memory
SIP-T26P,
Keys->Line Keys
SIP-T28P and
Memory keys are not applicable to
SIP-T46G IP

207
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

phones) SIP-T46G IP phones.

The default value is 0.

account.X.sha
red_line =

(SIP-T19P: X=1

SIP-T20P/T21P:
It enables or disables Broadsoft SCA
X ranges from
feature for account X.
1 to 2. Account->
0 or 1 0-Disabled Advanced->Share
SIP-T22P/T26P/T
41P/T42G: X 1-Broadsoft SCA d Line

ranges from 1 The default value is 0.


to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.acd
.initial_state =

(SIP-T19P: X=1

SIP-T20P/T21P:
It configures the initial agent state for
X ranges from
account X.
1 to 2.
1 or 2 1-Avaliable
SIP-T22P/T26P/T
41P/T42G: X 2-Unavailable

ranges from 1 The default value is 1.


to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.acd
.unavailable_r
eason_enable
It enables or disables unavailable
=
reason code feature for account X.
(SIP-T19P: X=1
0 or 1 0-Disabled
SIP-T20P/T21P:
1-Enabled
X ranges from
The default value is 0.
1 to 2.

SIP-T22P/T26P/T
41P/T42G: X

208
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.rea
son_code.Y =

(SIP-T19P: X=1

SIP-T20P/T21P:
X ranges from
It configures the unavailable code
1 to 2.
which must match one of the codes
SIP-T22P/T26P/T Integer from
configured on BroadWorks for account
41P/T42G: X 1 to
X.
ranges from 1 2147483647
The value Y must be continuous.
to 3.
The default value is blank.
SIP-T28P/T46G:
X ranges from
1 to 6.

Y ranges from
1 to 100)

account.X.rea
son_code_na
me.Y =

(SIP-T19P: X=1

SIP-T20P/T21P:
X ranges from It configures the unavailable reason

1 to 2. which must match one of the reasons


String within
configured on BroadWorks for account
SIP-T22P/T26P/T
99
X.
41P/T42G: X
characters
ranges from 1 The value Y must be continuous.

to 3. The default value is blank.

SIP-T28P/T46G:
X ranges from
1 to 6.

Y ranges from
1 to 100)

account.X.call It enables or disables call center call


0 or 1
_center.call_in information feature for account X.

209
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

fo_enable = 0-Disabled

(SIP-T19P: X=1 1-Enabled

SIP-T20P/T21P: The default value is 0.


X ranges from
1 to 2.

SIP-T22P/T26P/T
41P/T42G: X
ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.call
_center.show_
call_info_time
=

(SIP-T19P: X=1

SIP-T20P/T21P:
It configures the interval (in seconds)
X ranges from
Integer from to specify how long the call center call
1 to 2.
1 to 86400 information displays for account X.
SIP-T22P/T26P/T
The default value is 30 seconds.
41P/T42G: X
ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.call
_center.disp_c
ode_enable =

(SIP-T19P: X=1
It enables or disables disposition code
SIP-T20P/T21P: feature for account X.
X ranges from
0 or 1 0-Disabled
1 to 2.
1-Enabled
SIP-T22P/T26P/T
The default value is 0.
41P/T42G: X
ranges from 1
to 3.

SIP-T28P/T46G:

210
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

X ranges from
1 to 6)

account.X.bw_
disp_code.Y =

(SIP-T19P: X=1

SIP-T20P/T21P:
X ranges from
It configures the disposition code
1 to 2.
which must match one of the codes
SIP-T22P/T26P/T Integer from
configured on BroadWorks for account
41P/T42G: X 1 to
X.
ranges from 1 2147483647
The value Y must be continuous.
to 3.
The default value is blank.
SIP-T28P/T46G:
X ranges from
1 to 6.

Y ranges from
1 to 100)

account.X.bw_
disp_code_na
me.Y =

(SIP-T19P: X=1

SIP-T20P/T21P:
X ranges from It configures the disposition code

1 to 2. name which must match one of the


String within
names configured on BroadWorks for
SIP-T22P/T26P/T
99
account X.
41P/T42G: X
characters
ranges from 1 The value Y must be continuous.

to 3. The default value is blank.

SIP-T28P/T46G:
X ranges from
1 to 6.

Y ranges from
1 to 100)

account.X.call It enables or disables customer

_center.trace_ originated trace feature for account X.

enable = 0 or 1 0-Disabled

(SIP-T19P: X=1 1-Enabled

SIP-T20P/T21P: The default value is 0.

211
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

X ranges from
1 to 2.

SIP-T22P/T26P/T
41P/T42G: X
ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.call
_center.emerg
ency_enable
=

(SIP-T19P: X=1
It enables or disables the emergency
SIP-T20P/T21P:
escalation feature for account X.
X ranges from
1 to 2. 0 or 1 0-Disabled

SIP-T22P/T26P/T 1-Enabled

41P/T42G: X The default value is 0.


ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.sup
ervisor_info_c
ode.Y =

(SIP-T19P: X=1

SIP-T20P/T21P:
X ranges from
It configures the supervisor number for
1 to 2. Integer from
account X.
SIP-T22P/T26P/T 1 to
The value Y must be continuous.
41P/T42G: X 2147483647
The default value is blank.
ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6.

Y ranges from

212
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

1 to 100)

account.X.sup
ervisor_info_c
ode_name.Y
=

(SIP-T19P: X=1

SIP-T20P/T21P:
X ranges from
It configures the supervisor name for
1 to 2. String within
account X.
SIP-T22P/T26P/T 99
The value Y must be continuous.
41P/T42G: X characters
The default value is blank.
ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6.

Y ranges from
1 to 100)

account.X.call
_center.queue
_status_enabl
e=

(SIP-T19P: X=1
It enables or disables the queue status
SIP-T20P/T21P:
notification feature for account X.
X ranges from
1 to 2. 0 or 1 0-Disabled

SIP-T22P/T26P/T 1-Enabled

41P/T42G: X The default value is 0.


ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.call It enables or disables the power


_center.queue indicator LED to flash when the ACD
_status_light_e 0 or 1 call queue has reached the maximum
nable = number of calls for account X.

(SIP-T19P: X=1 0-Disabled (power indicator LED does

213
Yealink IP Phones Auto provisioning Guide

Permitted
Parameter Descriptions Web Setting Path
Values

SIP-T20P/T21P: not flash)


X ranges from 1-Enabled (power indicator LED fast
1 to 2. flashes (300ms) green)
SIP-T22P/T26P/T If it is set to 0, the status of the power
41P/T42G: X indicator LED is determined by the
ranges from 1 value of the parameter
to 3. “phone_setting.common_power_led_e
SIP-T28P/T46G: nable”.
X ranges from The default value is 0.
1 to 6)

account.X.hot
eling.enable
=

(SIP-T19P: X=1
It enables or disables hoteling feature
SIP-T20P/T21P:
for account X.
X ranges from
1 to 2. 0-Disabled
0 or 1
SIP-T22P/T26P/T 1-Enabled

41P/T42G: X The default value is 0.


ranges from 1 It takes effect after a reboot.
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.hot
eling.auto_log
in_enable =

(SIP-T19P: X=1
It enables or disables the phone to
SIP-T20P/T21P: save login credentials automatically
X ranges from when logging into the guest profile for
1 to 2. account X.
0 or 1
SIP-T22P/T26P/T 0-Disabled
41P/T42G: X
1-Enabled
ranges from 1
The default value is 0.
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

214
Appendix

Permitted
Parameter Descriptions Web Setting Path
Values

account.X.hot
eling.user_id
=

(SIP-T19P: X=1

SIP-T20P/T21P:
X ranges from
String within It configures the user ID used to log
1 to 2.
99 into the guest profile for account X.
SIP-T22P/T26P/T
characters The default value is blank.
41P/T42G: X
ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

account.X.hot
eling.passwor
d=

(SIP-T19P: X=1

SIP-T20P/T21P:
X ranges from
String within It configures the password used to log
1 to 2.
99 into the guest profile for account X.
SIP-T22P/T26P/T
characters The default value is blank.
41P/T42G: X
ranges from 1
to 3.

SIP-T28P/T46G:
X ranges from
1 to 6)

215
Yealink IP Phones Auto provisioning Guide

The following parameters are not applicable to IP phones running firmware version 72
or later, so the description of these parameters has been deleted in this guide.

account.X.bw_acd_reason_code.Y =

account.X.dns_query_timeout=

account.X.failback_mode =

account.X.failback_timeout =

account.X.retry_counts =

acd.bw =

bw.calllog_and_dir =

bw_phonebook.server_search_enable =

directory.incoming_call_match_enable =

features.action_uri_reboot_now =

features.auto_release_bla_line =

features.dsskey_blind_tran =

features.hold_trans_delay =

features.ldap.input_type =

ldap.dial_lookup =

network.snmp.enable =

network.snmp.port =

network.snmp.trust_ip =

phone_setting.blf_list_enable =

phone_setting.sms_popup_enable =

voice.call_preview_mode=

voice.tone.record =

features.hoteling.enable =

action_url.call_interrupt =

action_url.setup_autop_finish =

features.blf_pickup_only_send_code =

216
Appendix

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)

217
Yealink IP Phones Auto provisioning Guide

Time Zone 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)

218
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)

219
Yealink IP Phones Auto provisioning Guide

BLF LED Mode provides four kinds of definition for the BLF/BLF list key LED status. The
following tables list the LED statuses of the BLF/BLF list key when BLF LED Mode is set to 0,
1, 2 or 3 respectively. The default value of the BLF LED mode is 0.

Line key LED (configured as a BLF/BLF list key and BLF LED Mode is set to 0)

LED Status Description

Solid green The monitored user is idle.

Fast flashing green


The monitored user receives an incoming call.
(200ms)
The monitored user is dialing.
Slow flashing green
The monitored user is talking.
(500ms)
The monitored user’s conversation is placed on hold.
The call is parked against the monitored user’s phone
Slow flashing green (1s)
number.

Off The monitored user does not exist.

Memory 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.

The monitored user is dialing.


Solid red
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 Description

Fast flashing green


The monitored user receives an incoming call.
(200ms)
The monitored user is dialing.
Solid green
The monitored user is talking.
Slow flashing green
The monitored user’s conversation is placed on hold.
(500ms)
The call is parked against the monitored user’s phone
Slow flashing green (1s)
number.

Off The monitored user is idle.

220
Appendix

LED Status Description

The monitored user does not exist.

Memory key LED (configured as a BLF/BLF list key and BLF LED Mode is set to 1)

LED Status Description

Fast flashing red (200ms) The monitored user receives an incoming call.

The monitored user is dialing.


Solid red
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 Description

Fast flashing green


The monitored user receives an incoming call.
(200ms)
The monitored user is dialing.
Slow flashing green
The monitored user is talking.
(500ms)
The monitored user’s conversation is placed on hold.
The call is parked against the monitored user’s phone
Slow flashing green (1s)
number.
The monitored user is idle.
Off
The monitored user does not exist.

Memory key LED (configured as a BLF/BLF list key and BLF LED Mode is set to 2)

LED Status Description

Fast flashing red (200ms) The monitored user receives an incoming call.

The monitored user is dialing.


Solid red
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 3)

LED Status Description

Fast flashing green


The monitored user receives an incoming call.
(200ms)

221
Yealink IP Phones Auto provisioning Guide

LED Status Description

The monitored user is dialing.


Solid green The monitored user is talking.
The monitored user’s conversation is placed on hold.
The call is parked against the monitored user’s phone
Slow flashing green (1s)
number.
The monitored user is idle.
Off
The monitored user does not exist.

Memory key LED (configured as a BLF/BLF list key and BLF LED Mode is set to 3)

LED Status Description

Fast flashing red (200ms) 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.
The call is parked against the monitored user’s phone
Slow flashing red (1s)
number.
The monitored user is idle.
Off
The monitored user does not exist.

222
Appendix

We are striving to improve our documentation quality and we appreciate your feedback.
Email your opinions and comments to [email protected].

223

You might also like