Yealink_SIP T4X_IP_Phones_Auto_Provisioning_Guide_V71_171 Yealink SIP T4X IP Phones Auto Provisioning Guide V71 171

User Manual: Yealink_SIP-T4X_IP_Phones_Auto_Provisioning_Guide_V71_171 Alloy Computer Products - Australia - s

Open the PDF directly: View PDF PDF.
Page Count: 149

DownloadYealink_SIP-T4X_IP_Phones_Auto_Provisioning_Guide_V71_171 Yealink SIP-T4X IP Phones Auto Provisioning Guide V71 171
Open PDF In BrowserView PDF
Table of Contents

i

Table of Contents

Table of Contents.................................................................. iii
Summary of Changes ............................................................v
Changes for Release 71, Guide Version 71.171.............................................................. v
Changes for Release 71, Guide Version 71.170.............................................................. v
Changes for Release 71, Guide Version 71.150.............................................................. v
Changes for Release 71, Guide Version 71.90 ............................................................... v
Changes for Release 71, Guide Version 71.80 ............................................................... v

Introduction ...........................................................................1
Getting Started .....................................................................3
Obtaining Configuration Information ............................................................................. 3
Obtaining Configuration Files ...................................................................................... 3
Obtaining Phone Information ....................................................................................... 3
Managing Configuration Files ........................................................................................ 4
Editing Common CFG File ............................................................................................ 4
Editing MAC-Oriented CFG File .................................................................................. 7
Encrypting Configuration Files ................................................................................... 11
Customizing Resource Files ........................................................................................ 11
Customizing a Ringtone .......................................................................................... 12
Customizing an LCD Language .............................................................................. 12
Customizing an LCD Logo ....................................................................................... 15
Customizing a Wallpaper ........................................................................................ 15
Customizing a Local Contact File ............................................................................ 16
Customizing a Replace Rule File ............................................................................. 18
Customizing a Dial-now File .................................................................................... 19
Updating Firmware ................................................................................................. 20

Configuring a TFTP Server ................................................... 21
Preparing a Root Directory ............................................................................................ 21
Configuring a TFTP Server ............................................................................................. 22

Obtaining the Provisioning Server Address ......................... 23
Zero Touch ...................................................................................................................... 23
iii

Yealink SIP-T4X IP Phones Auto Provisioning Guide

Plug and Play (PnP) Server ............................................................................................ 24
DHCP Options ................................................................................................................ 25
Phone Flash .................................................................................................................... 26

Update Mode ..................................................................... 29
Power On ........................................................................................................................ 29
Repeatedly ..................................................................................................................... 30
Weekly ............................................................................................................................ 30
Auto Provision Now ........................................................................................................ 31
Multi-mode Mixed ......................................................................................................... 32
SIP NOTIFY Message ..................................................................................................... 32

Downloading Configuration Files......................................... 35
Troubleshooting ................................................................... 37
Glossary .............................................................................. 39
Appendix ............................................................................ 41
Configuring an FTP Server ............................................................................................. 41
Preparing a Root Directory ......................................................................................... 41
Configuring an FTP Server.......................................................................................... 42
Configuring an HTTP Server .......................................................................................... 44
Preparing a Root Directory ......................................................................................... 44
Configuring an HTTP Server ....................................................................................... 44
Configuring a DHCP Server........................................................................................... 47
Customizing a Ringtone Using Cool Edit Pro ................................................................ 54
Customizing a Logo File Using PictureExDemo ............................................................ 55
Description of Configuration Parameters in CFG Files ................................................. 57

iv

Summary of Changes

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

Major updates have occurred to the following section:


Customizing an LCD Language on page 12



Customizing an LCD Logo on page 15



Description of Configuration Parameters in CFG Files on page 57

Major updates have occurred to the following section:


Customizing an LCD Language on page 12



Description of Configuration Parameters in CFG Files on page 57

This version is updated to incorporate SIP-T41P as one of the SIP-T4X device models. The
following section is new for this version:


Customizing an LCD Logo on page 15



Customizing a Logo File Using PictureExDemo on page 55

Major updates have occurred to the following section:


Description of Configuration Parameters in CFG Files on page 57

Major updates have occurred to the following section:


Description of Configuration Parameters in CFG Files on page 57

This version is updated to incorporate SIP-T42G as one of the SIP-T4X device models.
Major updates have occurred to the following sections:
v

Yealink SIP-T4X IP Phones Auto Provisioning Guide

vi



Obtaining Configuration Files on page 3



Customizing Resource Files on page 11



Description of Configuration Parameters in CFG Files on page 57

Summary of Changes

vii

Introduction

Yealink SIP-T4X 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 SIP-T4X IP phones with the
minimum settings required. Yealink SIP-T4X 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 SIP-T4X
IP phones, including:


SIP-T46G



SIP-T42G



SIP-T41P
The auto provisioning process outlined in this guide applies to Yealink SIP-T4X IP phones
running firmware version 71 or later.

1

Yealink SIP-T4X 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 2
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 of the same model. It uses
a fixed name “y0000000000XX.cfg” as the file name, where "XX" equals to the hardware
version of the phone model.
The names of the Common CFG file for SIP-T4X IP phones are:
Phone Model

Common Configuration File

SIP-T46G

y000000000028.cfg

SIP-T42G

y000000000029.cfg

SIP-T41P

y000000000036.cfg

You can ask the distributor or Yealink FAE for configuration files. The IP phones 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.
3

Yealink SIP-T4X IP Phones Auto Provisioning Guide

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 address of the registration server. Ask your system administrator for SIP account
information.

Auto provisioning enables 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 57.

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

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.

4

Getting Started

The parameters commonly edited in the Common CFG file are described as follows
(take the SIP-T46G IP phone as an example):
####################################################
##

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.
#Configure the transmission mode and the speed of the WAN port.
#0-Auto negotiate (default), 1-Full duplex 10Mbps, 2-Full duplex 100Mbps, 3-Half
duplex 10Mbps, 4-Half duplex 100Mbps, 5-Full duplex 1000Mbps (not applicable to
SIP-T41P);
network.internet_port.speed_duplex =
#Enable or disable Plug and Play feature; 0-Disabled, 1-Enabled (default)
auto_provision.pnp_enable =
#Configure the domain name of the PnP server.
auto_provision.pnp_domain_name =
#Configure the value (manufacturer of the device) of the PnP subscribe message.
auto_provision.pnp_event_vendor =
#Enable or disable the Power On mode for auto provisioning;
#0-Disabled, 1-Enabled (default);
auto_provision.mode =
#Enable or disable the IP phone to check the new configuration repeatedly.
auto_provision.repeat.enable =
#Configure the interval (in minutes) for the phone to check new configuration files. It
ranges from 1 to 43200, the default value is 1440.
auto_provision.repeat.minutes =
# Enable or disable the IP phone to check the new configuration weekly.
#0-Disabled (default), 1-Enabled;
auto_provision.weekly.enable =
#Configure the start time of the day for the phone to check new configuration files. The
default value is 00:00.
#If the desired start time of the day is seven forty-five a.m., the value format is 07:45.
auto_provision.weekly.begin_time =
#Configure the end time of the day for the phone to check new configuration files. The
5

Yealink SIP-T4X IP Phones Auto Provisioning Guide

default time is 00:00.
#If the desired end time of the day is seven forty-five p.m., the value format is 19:45.
auto_provision.weekly.end_time =
#Configure the day of the week for the phone to check new configuration files. The
default value is 0123456.
#0-Sunday,1-Monday,2-Tuesday,3-Wednesday,4-Thursday,5-Friday,6-Saturday;
#If the desired week is Monday, Tuesday and Wednesday, the value format is 012.
auto_provision.weekly.mask =
#Configure the URL of the auto provisioning server.
auto_provision.server.url =
#Configure the user name and password for authentication.
auto_provision.server.username =
auto_provision.server.password =
#Enable or disable DHCP option mode; 0-Disabled, 1-Enabled (default);
auto_provision.dhcp_option.enable =
#Configure the value (manufacturer of the device) of DHCP option 60.
auto_provision.dhcp_option.option60_value =
#Configure the custom DHCP option value. It ranges from 128 to 254.
auto_provision.dhcp_option.list_user_options =
#Set the AES key used for decrypting the Common CFG file
auto_provision.aes_key_16.com =
#Set the AES key used for decrypting MAC-Oriented CFG file
auto_provision.aes_key_16.mac =
#Set the language used on the web user interface
#The valid values are: English, Chinese_S, Chinese_T, German, Turkish, Portuguese,
Spanish, Italian, and French. Chinese_S and Chinese_T are applicable to the SIP-T46G IP
phone only.
lang.wui =
#Set the language used on the LCD screen
#The valid values are: English (default), Chinese_S, Chinese_T, Deutsch, French, Turkish,
#Italian, Polish, Spanish and Portuguese. Chinese_S and Chinese_T are applicable to
the SIP-T46G IP phone only.
lang.gui = English
# Enable or disable the web server access for HTTPS; 0-Disabled, 1-Enabled (default);
6

Getting Started

#Require reboot
wui.https_enable =
# Enable or disable the web server access for HTTP; 0-Disabled, 1-Enabled (default);
#Require reboot
wui.http_enable =
#Set the HTTP port (80 by default)
#Require reboot
network.port.http =
#Set the HTTPS port (443 by default)
#Require reboot
network.port.https =

MAC-Oriented CFG file contains configuration parameters which are expected to be
updated per phone, such as the registration information.

7

Yealink SIP-T4X 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
##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.
#Account 1 settings
#Enable or disable the account1, 0-Disabled (Default), 1-Enabled
account.1.enable =
#Configure the label displayed on the LCD screen for account1
account.1.label =
#Configure the display name of account 1
account.1.display_name =
#Configure the user name and password for register authentication
account.1.auth_name =
account.1.password =
#Configure the register user name
account.1.user_name =
#Configure the SIP server 1 address and port (5060 by default)
account.1.sip_server.1.address =
account.1.sip_server.1.port =
#Configure the SIP server 2 address and port (5060 by default)
account.1.sip_server.2.address =
account.1.sip_server.2.port =
# Account 2 settings
#Enable or disable the account2, 0-Disabled (Default), 1-Enabled
account.2.enable =
#Configure the label displayed on the LCD screen for account 2
account.2.label =
#Configure the display name of account2
account.2.display_name =
#Configure the user name and password for register authentication
account.2.auth_name =
account.2.password =
#Configure the register user name

8

Getting Started

account.2.user_name =
#Configure the SIP server 1 address and port (5060 by default)
account.2.sip_server.1.address =
account.2.sip_server.1.port =
#Configure the SIP server 2 address and port (5060 by default)
account.2.sip_server.2.address =
account.2.sip_server.2.port =
# Account 3 settings
#Enable or disable the account3, 0-Disabled (Default), 1-Enabled
account.3.enable =
#Configure the label displayed on the LCD screen for account 3
account.3.label =
#Configure the display name of account3
account.3.display_name =
#Configure the user name and password for register authentication
account.3.auth_name =
account.3.password =
#Configure the register user name
account.3.user_name =
#Configure the SIP server 1 address and port (5060 by default)
account.3.sip_server.1.address =
account.3.sip_server.1.port =
#Configure the SIP server 2 address and port (5060 by default)
account.3.sip_server.2.address =
account.3.sip_server.2.port =
#Account 4-6 is for the SIP-T46G IP phone only.
# Account 4 settings
#Enable or disable the account4, 0-Disabled (Default), 1-Enabled
account.4.enable =
#Configure the label displayed on the LCD screen for account 4
account.4.label =
#Configure the display name of account4
account.4.display_name =
#Configure the user name and password for register authentication
account.4.auth_name =
account.4.password =
9

Yealink SIP-T4X IP Phones Auto Provisioning Guide

#Configure the register user name
account.4.user_name =
#Configure the SIP server 1 address and port (5060 by default)
account.4.sip_server.1.address =
account.4.sip_server.1.port =
#Configure the SIP server 2 address and port (5060 by default)
account.4.sip_server.2.address =
account.4.sip_server.2.port =
# Account 5 settings
#Enable or disable the account5, 0-Disabled (Default) 1-Enabled
account.5.enable =
# Configure the label displayed on the LCD screen for account 5
account.5.label =
#Configure the display name of account5
account.5.display_name =
#Configure the user name and password for register authentication
account.5.auth_name =
account.5.password =
#Configure the register user name
account.5.user_name =
#Configure the SIP server 1 address and port (5060 by default)
account.5.sip_server.1.address =
account.5.sip_server.1.port =
#Configure the SIP server 2 address and port (5060 by default)
account.5.sip_server.2.address =
account.5.sip_server.2.port =
# Account 6 settings
#Enable or disable the account6, 0-Disabled (Default), 1-Enabled
account.6.enable =
#Configure the label displayed on the LCD screen for account 6
account.6.label =
#Configure the display name of account6
account.6.display_name =
#Configure the user name and password for register authentication
account.6.auth_name =
account.6.password =

10

Getting Started

#Configure the register user name
account.6.user_name =
#Configure the SIP server 1 address and port (5060 by default)
account.6.sip_server.1.address =
account.6.sip_server.1.port =
#Configure the SIP server 2 address and port (5060 by default)
account.6.sip_server.2.address =
account.6.sip_server.2.port =
#Configure the WAN port type; 0-DHCP (default), 1-PPPoE (for SIP-T46G only), 2-Static IP
Address
#Require reboot
network.internet_port.type = 0
#Configure the static IP address, submask, gateway address and DNS server address.
#Require reboot
network.internet_port.ip = 192.168.1.10
network.internet_port.mask = 255.255.255.0
network.internet_port.gateway =192.168.1.1
network.primary_ dns= 202.101.103.55
network.secondary_dns = 202.101.103.54

To protect against unauthorized access and tampering of sensitive information (e.g.,
login passwords, registration information), you can encrypt configuration files using
Yealink Configuration Conversion Tool. AES keys must be 16 characters and the
supported characters contain: 0 ~ 9, A ~ Z, a ~ z, and the special characters # $ % * +,
- . : = ? @ [ ] ^ _ { } ~. For more information on how to encrypt configuration files, refer
to Yealink Configuration Conversion Tool User Guide.
AES keys must be configured on the phone before the auto provisioning process. AES
keys are configurable via web user interface at the path: Settings->Auto
Provision->Common AES Key (and MAC-Oriented AES Key).

When configuring some particular features, you may need to upload resource files to IP
phones, such as personalized ringtone file, language package. 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.

11

Yealink SIP-T4X IP Phones Auto Provisioning Guide

The IP phones have built-in system ringtones. You can change the ring type, or customize
a ringtone and upload it to the phone via auto provisioning.
The ringtone file must be PCMU audio format, mono channel, 8K sample rate and 16 bit
resolution.
The ringtone file format must be *.wav.
The ringtone file uploaded must be within 100KB.

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

Configure the access URL of the customized ringtone

##

####################################################
ringtone.url =
#Delete all the custom ringtones uploaded through auto provisioning
ringtone.delete = http://localhost/all
For example, enter “tftp://192.168.1.100/Ring9.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 ringtone file “Ring9.wav”.
For more information on customizing a ringtone file, refer to Customizing a Ringtone
Using Cool Edit Pro on page 54.

You can modify the language translation for the phone user interface, and add a new
language to the phone. To modify or add a language, you need to edit the language
file, upload it to the provisioning server, and then specify the access URL in the
configuration file.
The following table lists available languages and the associated language files for the
phone user interface:
Available

Associated Language Pack

Associated Language Pack

Language

for SIP-T42G/T41P

for SIP-T46G

English

0.GUI.English.lang

Chinese_S

/

1.GUI.Chinese_S.lang

Chinese_T

/

2.GUI.Chinese_T.lang

Deutsch

12

lang+English.txt

lang-Deutsch.txt

3.GUI.Deutsch.lang

French

lang-French.txt

4.GUI.French.lang

Italian

lang-Italian.txt

5.GUI.Italian.lang

Polish

lang-Polish.txt

6.GUI.Polish.lang

Getting Started

Available

Associated Language Pack

Associated Language Pack

Language

for SIP-T42G/T41P

for SIP-T46G

Portuguese
Spanish
Turkish

lang-Portuguese.txt

7.GUI.Portuguese.lang

lang-Spanish.txt

8.GUI.Spanish.lang

lang-Turkish.txt

9.GUI.Turkish.lang

To update translation of a built-in language, you should modify translation items in the
language file, upload the file to the root directory of the provisioning server, and trigger
an auto provisioning process for update. The file name of the language file cannot be
changed.
To add a new translation language, you should add and edit a new language file
named as “X.GUI.Y.lang” for SIP-T46G IP phones or “lang-Y.txt” for SIP-T42G/T41P IP
phones, upload the file to the directory of the provisioning server, and trigger an auto
provisioning process for update. “X” in the language file name is an integer which starts
from 10. “Y” in the language file name means the name of the new added language.
For example, you want to add a new translation language “Korean” for SIP-T46G IP
phones. The file name of the new added language file is “10.GUI.Korean.lang”. After
update, you will find a new language selection named as “Korean” on the phone user
interface: Menu->Basic->Language.
The following figure shows a portion of the SIP-T46G English language file:

You can also define the name of the new added language by editing the parameter
“Name=” in the language file for SIP-T46G IP phones. For example, edit the value of the
parameter “Name=” to be “en-us” in the “0.GUI.English.lang” language file. After
update, you will find the English language selection on the phone user interface is
“en-us”.

13

Yealink SIP-T4X IP Phones Auto Provisioning Guide

The following figure shows a portion of the SIP-T42G English language file:

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

Configure the access URL of the LCD language file

##

####################################################
gui_lang.url =
#Delete all custom languages through auto provision
gui_lang.delete = http://localhost/all
If you want to add a new language Russian to the phone, configure the parameter
“gui_lang.url =” in the configuration file, for example:
gui_lang.url = tftp://192.168.1.100/10.GUI.Russian.lang
gui_lang.url = tftp://192.168.1.100/lang-Russian.txt

## For SIP-T46G##
##For SIP-T42G/T41P##

During the auto provisioning process, the phone connects to the provisioning server
“192.168.1.100”, and downloads the language file. After update, you will find a new
language selection “Russian” on the phone user interface.
Available languages may vary between different firmware versions.
Do not rename the language file.

14

Getting Started

Logo customization allows unifying the IP phone appearance or displaying a custom
image on the idle screen such as a company logo, instead of the default system logo.
Logo is applicable to SIP-T42G and SIP-T41P IP phones only. The logo file format must
be .dob, and the resolution of the SIP-T42G/T41P IP phones is 192*64 graphic.
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 the
configuration file:
####################################################
##

Configure the access URL of the Logo File

##

####################################################
#(For SIP-T42G and SIP-T41P IP phones only)
lcd_logo.url =
#lcd_logo.delete = =http://localhost/all
#Delete all custom logo files
lcd_logo.delete =
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 (For SIP-T42G and SIP-T41P IP phones only).
#0-Disabled, 1-System logo (default), 2-Custom logo
phone_setting.lcd_logo.mode = 2
After auto provisioning, you will find that the custom logo appears on the LCD screen.
For more information on customizing a logo file, refer to Customizing a Logo File Using
PictureExDemo on page 55.

Yealink SIP-T46G IP phones allow you to customize the wallpaper displayed on the LCD
screen. Wallpaper feature is applicable to the SIP-T46G IP phone only.
The following table lists the wallpaper image format and resolution for the SIP-T46G IP
phone:
Phone Model

Wallpaper Image Format

Resolution

Size

SIP-T46G

.jpg/.png/.bmp

<=480*272

<=5Mbs

Upload the wallpaper image to the provisioning server and then specify the access URL
in the configuration file:

15

Yealink SIP-T4X IP Phones Auto Provisioning Guide

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

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

The 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.
When editing the local contact template file, learn the following:


Add groups between  and .



Add local contacts between  and .



When specifying the desired line for the contact, valid values are -1 and 0~5, -1
stands for Auto, and 0~5 stand for line1~line6.



When specifying a ringtone for the contact and the group, valid values are Auto,
Resource:RingN.wav (system ringtone, integer N ranges from 1 to 8) and
Custom:Name.wav (customized ringtone).



When specifying the group for the contact, valid values are the group names
(existing or added groups).

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:

Where:
display_name=”” specifies the name of the group.
ring=”” specifies the ringtone 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:


16

Getting Started

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 ringtone for the contact.
group_id_name=”” specifies the group you want to add the contact to.
default_photo=”” specifies the photo for the contact (for SIP-T46G IP phone).
4.

Specify the values within double quotes.

5.

Save the change.

After editing the local contact template file, upload the file to the provisioning server
and then specify the access URL in the configuration file.
The following shows an example of a local contact file used for SIP-T4X IP phones:












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

Upload local contact file

##

####################################################
local_contact.data.url =
17

Yealink SIP-T4X IP Phones Auto Provisioning Guide

For example, enter “tftp://192.168.1.100/contact.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.xml”.
Yealink IP phones support both *.xml and *.csv formats.

You can create replace rules directly in the 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:


 indicates the start of the template file and  indicates the
end of the template file.



Create replace rules between  and .



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



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:

Where:
Prefix=”” specifies the numbers to be replaced.
Replace=”” specifies the alternate string.
LineID=”” specifies the desired line(s) for this rule. When you leave it blank or enter
0, this replace rule will apply to all lines.

3.

Specify the values within double quotes.

4.

Save the change.

The following shows an example of the replace rule file:




18

Getting Started

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

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 multiple dial-now rules using the supplied dial-now template file. After
customizing the dial-now rules, place the dial-now file to the provisioning server and
specify the access URL in the configuration files.
When editing a dial-now file, learn the following:


 indicates the start of the template file and  indicates the
end of the template file.



Create dial-now rules between  and .



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



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:

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.

3.

Specify the values within double quotes.

4.

Save the change.

The following shows an example of a dial-now file:




19

Yealink SIP-T4X IP Phones Auto Provisioning Guide



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

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

The IP Phones allow you to update firmware manually via web user interface, or update
firmware in batch via auto provisioning. The firmware names of the SIP-T46G, SIP-T42G
and SIP-T41P IP phones are 28.x.x.x.rom, 29.x.x.x.rom and 36.x.x.x.rom (x is replaced by
the actual firmware version).
To update 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 the
configuration files.
####################################################
##

Configure the access URL of the firmware file

##

####################################################
firmware.url =
For example, enter “tftp://admin:password@192.168.1.100/28.71.0.50.rom” in the
“firmware.url =” field. During the auto provisioning process, the phone connects to the
provisioning server “192.168.1.100” (“admin” is replaced by the authentication user
name and “password” is replaced by the authentication password), and downloads
the firmware file “28.71.0.50.rom”.

20

Configuring a TFTP Server

Yealink SIP-T4X IP Phones support to use 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 instructions on how to configure FTP and HTTP servers, refer to Configuring an
FTP Server on page 41 and Configuring an HTTP Server on page 44.

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:

21

Yealink SIP-T4X 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 the 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.

22

Obtaining the Provisioning Server Address

Yealink SIP-T4X IP phones support to obtain the provisioning server address in the
following ways:


Zero Touch



Plug and Play (PnP) Server



DHCP Options



Phone Flash

The priority of obtaining the provisioning server address is as follows: Zero Touch-->PnP
Server-->DHCP Options (Custom option-->option 66-->option 43) -->Phone Flash.
The following sections detail the process of each way (take the SIP-T46G IP phone as an
example).

Zero Touch allows you to configure the network parameters and provisioning server
address via phone user interface during startup. This feature is helpful when there is a
system failure on the phone. To use Zero Touch, make sure this feature is enabled.
To enable the Zero Touch via web user interface:
1.

Click on Settings->Auto Provision.

2.

Select Enabled from the pull-down list of Zero Active.

3.

Configure the waiting time (in seconds) in the Wait Time field.

4.

Click Confirm to accept the change.
23

Yealink SIP-T4X IP Phones Auto Provisioning Guide

When Zero Touch is enabled, there will be a configuration wizard during the startup:

Press the OK soft key.
The network parameters are configurable via phone user interface:

Press the Next soft key after finishing the network parameters.
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:

The IP phones support to obtain the provisioning server address from the PnP server. The
phone broadcasts the PnP SUBCRIBE message to obtain the provisioning server address
during startup. To use Plug and Play, make sure this feature is enabled.

24

Obtaining the Provisioning Server Address

To enable 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
can connect to the provisioning server and perform the auto provisioning process.

Yealink IP phones support to obtain 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 by a

25

Yealink SIP-T4X IP Phones Auto Provisioning Guide

custom DHCP option, make sure the DHCP option is set properly.
The custom option must be in accordance with the one defined in the DHCP server. For
more information on configuring a DHCP server, refer to Configuring an HTTP Server on
page 44.
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.

4.

Enter the desired value in the DHCP Option Value field.
The default value is yealink.

5.

Click Confirm to accept the change.

Yealink IP phones support to obtain 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.

26

Click on Settings->Auto Provision.

Obtaining the Provisioning Server Address

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.

Click Confirm to accept the change.

27

Yealink SIP-T4X IP Phones Auto Provisioning Guide

28

Update Mode

The update mode is used to set the desired time for the IP 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 in 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 web user interface:
1.

Click on Settings->Auto Provision.

2.

Mark the On radio box in the Power On field.

3.

Click Confirm to accept the change.

29

Yealink SIP-T4X IP Phones Auto Provisioning Guide

The phone performs the auto provisioning process at regular intervals. You can
configure the interval for the Repeatedly mode. The default interval is 1440 minutes.
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.

3.

Enter the interval time 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:

30

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.

Update Mode
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.

31

Yealink SIP-T4X IP Phones Auto Provisioning Guide

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

32

Update Mode
The following figure shows the message flow:

33

Yealink SIP-T4X IP Phones Auto Provisioning Guide

34

Downloading Configurations Files

Downloading Configuration Files from the Provisioning Server
Once obtaining a provisioning server address in one of the ways introduced above, the
phone will connect to the provisioning server and download the configuration files. The
phone will try to download the Common CFG file first from the provisioning server, and
then download the MAC-Oriented CFG file. If resource files need to be updated and
the access URLs has been specified in the configuration files, the phone will then try to
download and update the resource files.

Resolving and Updating the Configurations
After downloading, the phone resolves the configuration files, 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 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
process without repeated update. This is used to avoid unnecessary restart and impact
of phone use.
If the configuration files have been AES-encrypted, the phone uses the Common AES
key to decrypt the Common CFG file and the MAC-Oriented AES key to decrypt the
CFG file after downloading the configuration files.
The phone only reboots when there is at least a specific configuration requiring reboot
need to be updated during auto provisioning.
For more information on the specific configurations which require reboot during
provisioning, refer to the section Description of Configuration Parameters in CFG Files on
page 57.

Verifying Configurations
After auto provisioning, you can verify the update via phone user interface or web user
interface. 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 during the auto provisioning process. The
following shows some examples.
35

Yealink SIP-T4X IP Phones Auto Provisioning Guide

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

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

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

36

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 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 an FTP server?


Ensure that the complete path to the root directory of the FTP server is authorized.



On the provisioning server, check the file permissions, if necessary, change the file
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.

Why doesn’t the phone download the ringtone?


Ensure that the file format of the ringtone is *.wav

37

Yealink SIP-T4X IP Phones Auto Provisioning Guide



Ensure that the size of the ringtone file is no larger than that the phone supports.



Ensure that the properties of the ringtone for the phone are correct.



Ensure that the network is available and the root directory is right for downloading.



Ensure that the ringtone file exists on the provisioning server.

Why doesn’t the phone update configurations?

38



Ensure that the configuration files are different from the last ones.



Ensure that the phone has downloaded the configuration files.



Ensure that the parameters are correctly set in the configuration files.

Glossary

MAC Address: A Media Access Control address (MAC address) is a unique identifier
assigned to network interfaces for communications on the physical network segment.
MD5: The MD5 Message-Digest Algorithm is a widely used cryptographic hash function
that produces a 128-bit (16-byte) hash value.
DHCP: Dynamic Host Configuration Protocol (DHCP) is a network configuration protocol
for hosts on Internet Protocol (IP) networks. Computers that are connected to IP networks
must be configured before they can communicate with other hosts.
FTP: File Transfer Protocol (FTP) is a standard network protocol used to transfer files from
one host to another host over a TCP-based network, such as the Internet. It is often used
to upload web pages and other documents from a private development machine to a
public web-hosting server.
HTTP: The Hypertext Transfer Protocol (HTTP) is an application protocol for distributed,
collaborative, hypermedia information systems. HTTP is the foundation of data
communication for the World Wide Web.
HTTPS: Hypertext Transfer Protocol Secure (HTTPS) is a combination of Hypertext
Transfer Protocol (HTTP) with SSL/TLS protocol. It provides encrypted communication
and secure identification of a network web server.
TFTP: Trivial File Transfer Protocol (TFTP) is a simple protocol to transfer files. It has been
implemented on top of the User Datagram Protocol (UDP) using port number 69.
AES: Advanced Encryption Standard (AES) is a specification for the encryption of
electronic data.
URL: A uniform resource locator or universal resource locator (URL) is a specific
character string that constitutes a reference to an Internet resource.
XML: Extensible Markup Language (XML) is a markup language that defines a set of
rules for encoding documents in a format that is both human-readable and
machine-readable.

39

Yealink SIP-T4X IP Phones Auto Provisioning Guide

40

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:

41

Yealink SIP-T4X 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 shows as below:

42

3.

Select Configure FTP Server.

4.

Click the

5.

Enter the new authentication user name in the Profile field.

6.

Click the Set/Change user’s password button to set the password in the pop-up

button to locate the FTP root directory from the local system:

Appendix

dialogue box.
7.

Click the OK button to save.

8.

Mark the check boxes of Login, Download and Upload to make sure the FTP user
has the login, download and upload permission.

9.

Click the Save Profile button to save the settings and finish the configurations.

10. Click the Confirm button to finish configuring the FTP server.
The server URL “ftp://username:password@IP/” (Here “IP” means the IP address of
the provisioning server, “username” and “password” are the authentication for FTP
download. For example, “ftp://admin:123456@192.168.1.100/”) is where the phone
downloads configuration files from.

43

Yealink SIP-T4X 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 the 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.

44

Download the application file to your local directory, double click the hfs.exe.

Appendix

The main configuration page is shown as below:

2.

Click Menu in the main page and select the IP address of the PC from IP address.

45

Yealink SIP-T4X 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.

46

Appendix

4.

Locate the root directory from the 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  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 that:


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.

47

Yealink SIP-T4X 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.

48

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.

49

Yealink SIP-T4X 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.

50

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.

51

Yealink SIP-T4X 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.

52

2.

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

3.

Scroll down and double click MS option 66.

Appendix

4.

Fill the provisioning server address in the input field.

5.

Click the OK button to finish setting a custom option.

6.

Click

to save the change.

You also can add the option 43. The following shows the detailed processes.
1.

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

2.

Select Standard Options from the pull-down list of Filter.

3.

Scroll down and double click 43.

53

Yealink SIP-T4X 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.

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 ringtone using Cool Edit Pro:

54

1.

Open the Cool Edit Pro application.

2.

Click File to open an audio file.

3.

Locate the ringtone file, click Open, the file is uploaded as follows.

Appendix

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

55

Yealink SIP-T4X IP Phones Auto Provisioning Guide

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.

56

Appendix

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

Parameter

Permitted

Descriptions

Values

Web Setting Path

It configures the IP address mode.
0-IPv4
network.ip_ad
dress_mode =

0, 1 or 2

1-IPv6
2-IPv4&IPv6

Network->Internet
Port->Mode(IPv4/IP
v6)

The default value is 0.
It takes effect after reboot.
It configures the internet port type for
IPv4 when the IP address mode is
configured as IPv4 or IPv4&IPv6.
network.intern
et_port.type =

0-DHCP
0, 1 or 2

1-PPPoE

Network->IPv4
Config

2-Static IP Address
The default value is 0.
It takes effect after reboot.
It configures the IPv4 address when the
IP address mode is defined as IPv4 or
network.intern
et_port.ip =

IPv4&IPv6, and the Internet (WAN) port
IP address

type for IPv4 is configured as Static IP
Address.
The default value is blank.

Network->IPv4
Config->Static IP
Address->IP
Address

It takes effect after reboot.
It configures the IPv4 subnet mask
when the IP address mode is defined
as IPv4 or IPv4&IPv6, and the Internet

network.intern
et_port.mask

IP address

(WAN) port type for IPv4 is configured
as Static IP Address.

=

The default value is blank.

Network->IPv4
Config->Static IP
Address->Subnet
Mask

It takes effect after reboot.
network.intern
et_port.gatew

IP address

It configures the IPv4 default gateway

Network->IPv4

when the IP address mode is

Config->Static IP

configured as IPv4 or IPv4&IPv6, and

Address->
57

Yealink SIP-T4X IP Phones Auto Provisioning Guide
ay =

the Internet (WAN) port type for IPv4 is

Gateway

configured as Static IP Address.
The default value is blank.
It takes effect after reboot.
It configures the primary IPv4 DNS
server when the IP address mode is
network.prima
ry_dns =

defined as IPv4 or IPv4&IPv6, and the
IP address

Internet (WAN) port type for IPv4 is
configured as Static IP Address.
The default value is blank.

Network->IPv4
Config->Static IP
Address->Primary
DNS

It takes effect after reboot.
It configures the secondary IPv4 DNS
server when the IP address mode is
network.secon
dary_dns =

configured as IPv4 or IPv4&IPv6, and
IP address

the Internet (WAN) port type for IPv4 is
configured as Static IP Address.
The default value is blank.

Network->IPv4
Config->Static IP
Address->
Secondary DNS

It takes effect after reboot.
network.pppo

It configures the user name for PPPoE

e.user =

connection.

(for SIP-T46G

String

The default value is blank.

only)

It takes effect after reboot.

network.pppo

It configures the password for PPPoE

e.password =

connection.

(for SIP-T46G

String

only)

The default value is blank.
It takes effect after reboot.

Network->IPv4
Config->PPPoE->
User Name

Network->IPv4
Config->PPPoE->
Password

It configures the Internet (WAN) port
type for IPv6 when the IP address
mode is configured as IPv6 or
network.ipv6_i
nternet_port.ty

IPv4&IPv6.
0 or 1

pe =

0-DHCP

Network->IPv6
Config

1-Static IP Address
The default value is 0.
It takes effect after reboot.
It configures the IPv6 prefix when the IP

network.ipv6_
prefix =

Integer
from 0 to 128

address mode is configured as IPv6 or
IPv4&IPv6, and the Internet (WAN) port
type for IPv6 is configured as Static IP
Address.

58

Network->IPv6
Config->Static IP
Address->IPv6
Prefix (0~128)

Appendix
The default value is 64.
It takes effect after reboot.
It configures the IPv6 address when the
IP address mode is configured as IPv6
or IPv4&IPv6, and the Internet (WAN)

network.ipv6_i
nternet_port.i

IP address

port type for IPv6 is configured as
Static IP Address.

p=

The default value is blank.

Network->IPv6
Config->Static IP
Address->IP
Address

It takes effect after reboot.
It configures the IPv6 default gateway
when the IP address mode is
configured as IPv6 or IPv4&IPv6, and

network.ipv6_i
nternet_port.g

IP address

the Internet (WAN) port type for IPv6 is
configured as Static IP Address.

ateway =

The default value is blank.

Network->IPv6
Config->Static IP
Address->
Gateway

It takes effect after reboot.
It configures the primary IPv6 DNS
server when the IP address mode is
configured as IPv6 or IPv4&IPv6, and

network.ipv6_
primary_dns

IP address

the Internet (WAN) port type for IPv6 is
configured as Static IP Address.

=

The default value is blank.

Network->IPv6
Config->Static IP
Address->Primary
DNS

It takes effect after reboot.
It configures the secondary IPv6 DNS
server when the IP address mode is
configured as IPv6 or IPv4&IPv6, and

network.ipv6_
secondary_dn

IP address

the Internet (WAN) port type for IPv6 is
configured as Static IP Address.

s=

The default value is blank.

Network->IPv6
Config->Static IP
Address->
Secondary DNS

It takes effect after reboot.
It enables or disables the phone to
obtain the IPv6 network settings from
network.ipv6_i
cmp_v6.enabl

the ICMPv6.
0 or 1

e=

0-Disabled
1-Enabled

Network->Advanc
ed->ICMPv6
Status->Active

The default value is 1.
network.dhcp
_host_name =

String

It specifies the host name the phone

Features->General

sends via the DHCP option 12.

Information->DHCP

The default value is:

Hostname

59

Yealink SIP-T4X IP Phones Auto Provisioning Guide
SIP-T46G (for SIP-T46G)
SIP-T42G (for SIP-T42G)
SIP-T41P (for SIP-T41P)
It enables or disables the PC port.
network.pc_p
ort.enable =

0 or 1

0-Disabled
1-Enabled
The default value is 1.
It configures the transmission mode
and transmission speed of the Internet
(WAN) port.
0-Auto negotiate

network.intern
et_port.speed
_duplex =

1-Full duplex 10Mbps
0, 1, 2, 3, 4 or
5

Network->Advanc

2-Full duplex 100Mbps

ed->Port Link->

3-Half duplex 10Mbps

WAN Port Link

4-Half duplex 100Mbps
5-Full duplex 1000Mbps (not
applicable to SIP-T41P)
The default value is 0.
It configures the transmission mode
and transmission speed of the PC
(LAN) port when configured as Router.
0-Auto negotiate
network.pc_p
ort.speed_dup
lex =

1-Full duplex 10Mbps
0, 1, 2, 3, 4 or
5

Network->

2-Full duplex 100Mbps

Advanced->Port

3-Half duplex 10Mbps

Link->PC Port Link

4-Half duplex 100Mbps
5-Full duplex 1000Mbps (not
applicable to SIP-T41P)
The default value is 0.
It enables or disables VLAN of the
Internet (WAN) port.
network.vlan.i
nternet_port_e

0 or 1

nable =

Network->

0-Disabled

Advanced->VLAN

1-Enabled

->WAN Port

The default value is 0.

->Active

It takes effect after reboot.
network.vlan.i
nternet_port_v

60

Integer
from 1 to

It configures VLAN ID of the Internet

Network->

(WAN) port.

Advanced->VLAN

Appendix
id =

network.vlan.i
nternet_port_p
riority =

4094

Integer
from 0 to 7

The default value is 1.

->WAN Port->VID

It takes effect after reboot.

(1-4094)

It configures VLAN priority of the

Network->

Internet (WAN) port.

Advanced->VLAN

The default value is 0.

->WAN Port->

It takes effect after reboot.

Priority

It enables or disables VLAN of the PC
(LAN) port.
network.vlan.
pc_port_enabl

0 or 1

e=

0-Disabled
1-Enabled

Network->
Advanced->VLAN
->PC Port->Active

The default value is 0.
It takes effect after reboot.

network.vlan.
pc_port_vid =

network.vlan.
pc_port_priorit
y=

Integer
from 1 to
4094

It configures VLAN ID of the PC (LAN)

Network->

port.

Advanced->VLAN

The default value is 1.

->PC Port->VID

It takes effect after reboot.

(1-4094)

It configures VLAN priority of the PC
Integer
from 0 to 7

(LAN) port.
The default value is 0.
It takes effect after reboot.

Network->
Advanced->VLAN
->PC Port-> Priority

It enables or disables the phone to
obtain VLAN settings from the DHCP
network.vlan.
dhcp_enable

0 or 1

=

server.

Network->

0-Disabled

Advanced->VLAN

1-Enabled
The default value is 1.

->DHCP VLAN->
Active

It takes effect after reboot.
It configures the DHCP option from
which the phone will obtain the VLAN
network.vlan.

Integer

dhcp_option

from 128 to

=

254

settings. You can configure at most five
DHCP options, and separate options
by comma.
The default value is 132.

Network->
Advanced->VLAN
->DHCP VLAN->
Option

It takes effect after reboot.
wui.http_enab
le =

0 or 1

It enables or disables the HTTP

Network->

protocol for web server access.

Advanced->Web

0-Disabled

Server->HTTP

61

Yealink SIP-T4X IP Phones Auto Provisioning Guide
1-Enabled
The default value is 1.
It takes effect after reboot.
It enables or disables the HTTPS
protocol for web server access.
wui.https_ena
ble =

0-Disabled
0 or 1

1-Enabled
The default value is 1.

Network->
Advanced->Web
Server->HTTPS

It takes effect after reboot.

network.port.h
ttp =

network.port.h
ttps =

network.port.
max_rtpport =

network.port.
min_rtpport =

network.qos.rt
ptos =

network.qos.si
gnaltos =

Integer
from 1 to
65535

Integer
from 1 to
65535

Integer
from 1024
to 65535

Integer
from 1024 to
65535

Integer
from 0 to 63

Integer
from 0 to 63

It configures the HTTP port for web

Network->

server access.

Advanced->Web

The default value is 80.

Server->HTTP Port

It takes effect after reboot.

(1~65535)

It configures the HTTPS port for web

Network->

server access.

Advanced->Web

The default value is 443.

Server->HTTPS Port

It takes effect after reboot.

(1~65535)

It configures the maximum local RTP

Network->

port.

Advanced->Local

The default value is 11800.

RTP Port-> Max RTP

It takes effect after reboot.

Port (1~65535)

It configures the minimum local RTP

Network->

port.

Advanced->Local

The default value is 11780.

RTP Port->Min RTP

It takes effect after reboot.

Port (1~65535)

It configures the voice QoS.
The default value is 46.
It takes effect after reboot.
It configures the SIP message QoS.
The default value is 26.
It takes effect after reboot.

Network->
Advanced->Voice
QoS->Voice QoS
(0~63)
Network->
Advanced->Voice
QoS->SIP Qos
(0~63)

It configures the 802.1x mode.
network.802_1
x.mode =

0, 1, 2, 3 or 4

0-Disabled
1-EAP-MD5
2-EAP-TLS

62

Network->
Advanced->802.1x
->Mode 802.1x

Appendix
3-PEAP-MSCHAPv2
4-EAP-TTLS/EAP-MSCHAPv2
The default value is 0.
It takes effect after reboot.
It configures the user name for 802.1x
network.802_1
x.identity =

authentication.
String

The default value is blank.
It takes effect after reboot.
It configures the password for 802.1x

network.802_1
x.md5_passw

String

ord =

authentication.
The default value is blank.

Network->
Advanced->802.1x
->Identity

Network->
Advanced->802.1x
->MD5 Password

It takes effect after reboot.
It configures the access URL of the root
network.802_1
x.root_cert_url

URL

=

certificates when the 802.1x mode is

Network->

configured as EAP-TLS,

Advanced->802.1x

PEAP-MSCHAPV2 or

->CA Certificates

EAP-TTLS/EAP-MSCHAPV2.
network.802_1
x.client_cert_u

It configures the access URL of the
URL

rl =

client certificates when the 802.1x
mode is configured as EAP-TLS.

Network->
Advanced->802.1x
->Device
Certificates

It enables or disables VPN feature.
0-Disabled
network.vpn_
enable =

0 or 1

Network->

1-Enabled

Advanced->VPN->

The default value is 0.

Active

It takes effect after reboot.
It enables or disables LLDP feature.
network.lldp.e
nable =

0 or 1

0-Disabled

Network->

1-Enabled

Advanced->LLDP->

The default value is 1.

Active

It takes effect after reboot.
It configures the interval (in seconds)
network.lldp.p

Integer

acket_interval

from 1 to

=

3600

for the phone to broadcast the LLDP
request.
The default value is 60.
It takes effect after reboot.

network.snmp

0 or 1

It enables or disables SNMP feature.

Network->
Advanced->LLDP->
Packet Interval
(1~3600s)

Network->
Advanced->SNMP
63

Yealink SIP-T4X IP Phones Auto Provisioning Guide
.enable =

0-Disabled

->Active

1-Enabled
The default value is 1.
It takes effect after reboot.

network.snmp
.port =

Integer
from 1 to
65535

It configures the SNMP port.

Network->

The default value is 161.

Advanced->SNMP

It takes effect after reboot.

->Port (0~65535)

It configures the IP address(es) of the
trusted SNMP server.
Multiple IP addresses are separated
network.snmp
.trust_ip =

IP address

by space.

Network->

The default value is 0.0.0.0.

Advanced->SNMP

If the value is set to “0.0.0.0”, the

->Trusted Address

phone can accept and handle GET
requests from any IP address.
It takes effect after reboot.
It enables or disables the phone to
span data packets received in the
WAN port to the PC port. If it is
network.span_
to_pc_port =

0 or 1

enabled, all packets from WAN port

Network->

can be received by PC port.

Advanced->Span

0-Disabled

to PC->Span to PC

1-Enabled

Port

The default value is 0.
It takes effect after reboot.
Network->
sip.reg_surge_
prevention =

Integer
from 0 to 60

It configures the maximum duration (in

Advanced->

seconds) for account register after

Registration

startup.

Random->

The default value is 0.

Registration
Random (0~60s)

It enables or disables the phone to
add the MAC address to the
User-Agent header.

network.sip.ta
g_mac_to_ua.
enable =

0 or 1

0-Disabled
1-Enabled
The default value is 0.
It takes effect after reboot.

64

Appendix

It configures the phone to export log
files to a syslog server or the local
system.
syslog.mode

1 or 2

1-Local
2-Server

Settings->
Configuration->Exp
ort System Log

The default value is 1.
It configures the IP address or domain
syslog.server
=

IP address

name of the syslog server when the

Settings->

syslog mode is configured as server.

Configuration->

The default value is blank.

Server Name

It takes effect after reboot.
It configures the syslog level used to
specify the type of syslog information
syslog.log_lev
el =

Integer
from 0 to 6

to be exported.

Settings->

0 means no syslog information, and 6

Configuration->Sys

means all.

tem Log Level

The default value is 3.
It takes effect after reboot.
It enables or disables the power on
mode for triggering the auto
auto_provision
.mode =

provisioning process.
0 or 1

0-Disabled
1-Enabled

Settings->Auto
Provision->Power
On

The default value is 1.
It enables or disables Plug and Play
feature. If it is enabled, the phone will
broadcast PnP SUBSCRIBE messages
auto_provision
.pnp_enable

0 or 1

=

to obtain a provisioning server

Settings->Auto

address after startup.

Provision->PNP

0-Disabled

Active

1-Enabled
The default value is 1.
It configures the domain name of the

auto_provision
.pnp_domain_

String

PnP server.

name =

The default value is 224.0.1.75.

auto_provision

It configures the vendor name of the

.pnp_event_v
endor =

String

device.
The default value is yealink.

65

Yealink SIP-T4X IP Phones Auto Provisioning Guide

It enables or disables the phone to
check the new configuration
auto_provision
.repeat.enabl

repeatedly.
0 or 1

e=

0-Disabled
1-Enabled

Settings->Auto
Provision->
Repeatedly

The default value is 0.
auto_provision
.repeat.minut
es =

Integer
from 1 to
43200

It configures the interval (in minutes)
for the phone to check the new
configuration repeatedly.
The default value is 1440.

Settings->Auto
Provision->Interval
(Minutes)

It enables or disables the phone to
check the new configuration weekly.

auto_provision
.weekly.enabl

0 or 1

e=

0-Disabled
1-Enabled

Settings->Auto
Provision->Weekly

The default value is 0.
It configures the begin time of the day

auto_provision
.weekly.begin

Time Format

_time =

Settings->Auto

configuration weekly.

Provision->Time

The default value is 00:00.
It configures the end time of day for

auto_provision
.weekly.end_ti

for the phone to check the new

Time Format

me =

the phone to check the new

Settings->Auto

configuration weekly.

Provision->Time

The default value is 00:00.
It configures the days of the week for
the phone to check new configuration
0,1,2,3,4,5,6

auto_provision
.weekly.mask
=

weekly.
Example:

Settings->Auto

auto_provision.weekly.mask = 01

Provision->Day of

of these

This means that the phone will check

Week

digits

new configuration every Sunday and

or a
combination

Monday.
The default value is 0123456.
auto_provision
.server.url =

URL

auto_provision
.server.userna
me =

66

String

It configures the URL of the auto

Settings->Auto

provisioning server.

Provision->Server

The default value is blank.

URL

It configures the user name for

Settings->Auto

authentication during auto

Provision->User

provisioning.

Name

Appendix
The default value is blank.
It configures the password for

auto_provision
.server.passw

String

ord =

authentication during auto
provisioning.
The default value is blank.

Settings->Auto
Provision->
Password

It enables or disables the phone to
obtain the provisioning server address
auto_provision
.dhcp_option.

by detecting DHCP options.
0 or 1

enable =

0-Disabled
1-Enabled

Settings->Auto
Provision->DHCP
Active

The default value is 1.
auto_provision
.dhcp_option.
option60_valu

String

e=
auto_provision
.dhcp_option.l
ist_user_optio
ns =

Integer
from 128 to
254

It configures the value (vendor name

Settings->Auto

of the device) of DHCP option 60.

Provision->DHCP

The default value is yealink.

Option Value

It configures the custom DHCP option

Settings->Auto

for the provisioning server address.

Provision->Custom

The default value is blank.

Option (128~254)

It configures the AES key (16
characters) for decrypting the

auto_provision
.aes_key_16.c

Common CFG file.
String

om =

The valid characters contain: 0 ~ 9, A
~ Z, a ~ z,#$%*+,-.:=?@[]^_{}~.

Settings->Auto
Provision->
Common AES Key

The default value is blank.
It configures the AES key (16
auto_provision
.aes_key_16.m

String

ac =

characters) for decrypting the

Settings->Auto

MAC-Oriented CFG file. The valid

Provision->

characters contain: 0 ~ 9, A ~ Z, a ~

MAC-Oriented AES

z,#$%*+,-.:=?@[]^_{}~.

Key

The default value is blank.
autoprovision.

It configures the name for the auto

X.name =

provisioning.

(X ranges
from 1 to 50.)

String

The maximum length of the name is
100 characters.

(for SIP-T46G

The default value is blank.

only)

It takes effect after reboot.

autoprovision.
X.code =

String

It configures the code to trigger auto
provisioning.
67

Yealink SIP-T4X IP Phones Auto Provisioning Guide
(X ranges

The maximum length of the code is 100

from 1 to 50.)

characters. Valid characters are digits,

(for SIP-T46G

# and *.

only)

Example:
autoprovision.1.code = *99
The default value is blank.
It takes effect after reboot.

autoprovision.
X.url =
(X ranges
from 1 to 50.)

It configures the URL of auto
provisioning server.
URL

The default value is blank.
It takes effect after reboot.

(for SIP-T46G
only)
autoprovision.

It configures the user name for

X.user =
(X ranges
from 1 to 50.)

authentication during auto
String

The default value is blank.

(for SIP-T46G

It takes effect after reboot.

only)
autoprovision.

It configures the password for

X.password =
(X ranges
from 1 to 50.)

authentication during auto
String

It takes effect after reboot.

only)
autoprovision.

It configures the AES key (16

X.com_aes =

from 1 to 50.)

characters) for decrypting the
String

It takes effect after reboot.

only)
autoprovision.

It configures the AES key (16

X.mac_aes =

from 1 to 50.)

characters) for decrypting the
String

It takes effect after reboot.

only)

_pound =
68

MAC-Oriented CFG file.
The default value is blank.

(for SIP-T46G

sip.use_23_as

Common CFG file.
The default value is blank.

(for SIP-T46G

(X ranges

provisioning.
The default value is blank.

(for SIP-T46G

(X ranges

provisioning.

0 or 1

It enables or disables the phone to

Features->General

reserve the pound sign when dialing

Information->

Appendix
out.

Reserve # in User

0-Disabled (convert the pound sign

Name

into “%23”)
1-Enabled
The default value is 1.
It enables or disables the phone to
support RFC 2543 hold (c=0.0.0.0).
sip.rfc2543_ho
ld =

0 or 1

Features->General

0-Disabled

Information->RFC

1-Enabled

2543 Hold

The default value is 0.
It enables or disables the phone to
keep sending SIP messages to the
sip.use_out_b
ound_in_dialo

outbound server in a dialog.
0 or 1

g=

Features->General
Information->Use

0-Disabled

Outbound Proxy In

1-Enabled

Dialog

The default value is 1.
It enables or disables Watch Dog
feature.
If it is enabled, the phone will reboot
watch_dog.en
able =

0 or 1

automatically when the system is
broken down.
0-Disabled

Settings->
Preference->Watch
Dog

1-Enabled
The default value is 1.
It enables or disables redirection
feature.
If it is enabled, the IP phone will be
redirect.enabl
e=

redirected to the pre-assigned server
0 or 1

for configuration updating during initial
bootup.
0-Disabled
1-Enabled
The default value is 0.

managements

It enables or disables TR069 feature.

erver.enable

0-Disabled

=

0 or 1

1-Enabled

(for SIP-T46G

The default value is 0.

only)

It takes effect after reboot.

Settings->TR069->
Enable TR069

69

Yealink SIP-T4X IP Phones Auto Provisioning Guide

managements
erver.usernam
e=

It configures the user name for the
String

phone to authenticate with the ACS.
It takes effect after reboot.

(for SIP-T46G

Settings->TR069->
ACS Username

only)
managements
erver.passwor
d=

It configures the password for the
String

phone to authenticate with the ACS.
It takes effect after reboot.

(for SIP-T46G

Settings->TR069->
ACS Password

only)
managements
erver.url =
(for SIP-T46G

It configures the access URL of the
URL

ACS.
It takes effect after reboot.

only)

Settings->TR069->
ACS URL

managements
erver.connecti

It configures the user name for the

on_request_us

phone to authenticate the connection

ername =

String

requests.
It takes effect after reboot.

(for SIP-T46G

Settings->TR069->
Connection
Request Username

only)
managements
erver.connecti
on_request_p
assword =

String

(for SIP-T46G

It configures the password for the

Settings->TR069->

phone to authenticate the connection

Connection

requests.

Request Password

only)
managements

It enables or disables the phone to

erver.periodic

report its configuration to the ACS.

_inform_enabl

0-Disabled

e=

0 or 1

(for SIP-T46G

The default value is 1.

only)

It takes effect after reboot.

managements
erver.periodic
_inform_interv
al =
(for SIP-T46G
only)

70

1-Enabled

Settings->TR069->
Enable Periodic
Inform

It configures the interval (in seconds)
Integer
from 5 to
42946967295

for the phone to report its configuration

Settings->TR069->

to the ACS.

Periodic Inform

The default value is 60.

Interval (seconds)

It takes effect after reboot.

Appendix

It enables or disables the transferee
party’s phone to prompt a missed call
on the LCD screen before displaying

transfer.semi_
attend_tran_e

0 or 1

the caller ID.
0-Disabled

nable =

Features->Transfer
->Semi-Attend
Transfer

1-Enabled
The default value is 1.
It enables or disables the phone to
complete the blind transfer through
transfer.blind_
tran_on_hook_

on-hook.
0 or 1

enable =

0-Disabled
1-Enabled

Features->Transfer
->Blind Transfer On
Hook

The default value is 1.
It enables or disables the phone to
complete the attended transfer
transfer.on_ho
ok_trans_ena

through on-hook.
0 or 1

ble =

0-Disabled
1-Enabled

Features->Transfer
->Semi Attend
Transfer On Hook

The default value is 1.
It defines the line key behavior during
an active call when user presses the
line key and the line key is configured
transfer.dsske
y_deal_type =

0,1 or 2

as a transfer or BLF key.

Features->Transfer

0-New Call

->Transfer Mode

1-Attended Transfer

Via Dsskey

2-Blind Transfer
The default value is 2.
It enables or disables the phone to
transfer call to the two parties after a
transfer.tran_o
thers_after_co

local conference call hangup.
0 or 1

nf_enable =

Features->Transfer
->Transfer on

0-Disabled

Conference Hang

1-Enabled

up

The default value is 0.
It enables or disables the voice activity
detection.
voice.vad =

0 or 1

Settings->Voice->

0-Disbaled

Echo Cancellation

1-Enabled

->VAD

The default value is 0.

71

Yealink SIP-T4X IP Phones Auto Provisioning Guide

It enables or disables the comfortable
noise generator.
voice.cng =

0 or 1

Settings->Voice->

0-Disabled

Echo Cancellation

1-Enabled

->CNG

The default value is 1.
It enables or disables the echo
voice.echo_ca
ncellation =

0 or 1

canceller.

Settings->Voice->

0-Disabled

Echo Cancellation

1-Enabled

->ECHO

The default value is 1.
It configures the type of jitter buffer.
voice.jib.adap
tive =

0 or 1

0-Fixed
1-Adaptive

Settings->Voice->
JITTER BUFFER
->Type

The default value is 1.
voice.jib.min
=

voice.jib.max
=

voice.jib.norm
al =

Integer
from 60 to
300
Integer
from 60 to
300
Integer
from 60 to
300

It configures the minimum delay (in

Settings->Voice->

milliseconds) of jitter buffer.

JITTER BUFFER ->

The default value is 60.

Min Delay

It configures the maximum delay (in

Settings->Voice->

milliseconds) of jitter buffer.

JITTER BUFFER

The default value is 300.

->Max Delay

It configures the normal delay (in

Settings->Voice->

milliseconds) of jitter buffer.

JITTER BUFFER ->

The default value is 120.

Normal

Custom,
Australia,
Austria,
Brazil,
Belgium,
China,
Czech,
voice.tone.cou
ntry =

Denmark,
Finland,
France,
Germany,
Great
Britain,
Greece,
Hungary,
Lithuania,

72

It configures the tone type for the
phone.
The default value is Custom.

Settings->Tones->
Select Country

Appendix
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
configured as Custom.
tonelist = element[,element]
[,element]…
Where
element =
[!]freq1[+freq2][+freq3][+freq4]
/duration
Freq: the frequency of the tone (ranges
from 200 to 7000 Hz). If the frequency is
voice.tone.dia
l=

String

set to 0Hz, it means silence. A tone can

Settings->Tones->

be composited at most four different

Dial

frequencies.
Duration: the duration (in milliseconds)
of the ring tone, ranges from 0 to
30000ms.
The exclamation point (!) can be
added optionally, which means the
custom tone will be only played once.
You can configure at most eight
different tones for one condition. Tones
are separated by comma (e.g.,
250/200, !0/1000, 200+300/500,
600+700+800+1000/2000).
voice.tone.rin
g=

String

It customizes the ring-back tone when

Settings->Tones->

the parameter "voice.tone.country" is

Ring Back

73

Yealink SIP-T4X IP Phones Auto Provisioning Guide
configured as Custom.
The value format is F/D or !F/D. For
more information on the value format,
refer to the parameter
“voice.tone.dial”.
The default value is blank.
It customizes the busy tone when the
parameter "voice.tone.country" is
configured as Custom.
voice.tone.bus
y=

String

The value format is F/D or !F/D. For

Settings->Tones->

more information on the value format,

Busy

refer to the parameter
“voice.tone.dial”.
The default value is blank.
It customizes the tone for network
congestion when the parameter
"voice.tone.country" is configured as
voice.tone.con
gestion =

Custom.
String

The value format is F/D or !F/D. For
more information on the value format,

Settings->Tones->
Congestion

refer to the parameter
“voice.tone.dial”.
The default value is blank.
It customizes the call waiting tone
when the parameter
"voice.tone.country" is configured as
voice.tone.call
waiting =

Custom.
String

The value format is F/D or !F/D. For
more information on the value format,

Settings->Tones->
Call Waiting

refer to the parameter
“voice.tone.dial”.
The default value is blank.
It customizes the redial tone when the
parameter "voice.tone.country" is
configured as Custom.
voice.tone.dia
lrecall =

String

The value format is F/D or !F/D. For

Settings->Tones->

more information on the value format,

Dial Recall

refer to the parameter
“voice.tone.dial”.
The default value is blank.

74

Appendix

It customizes the tone for call recording
when the parameter
“voice.tone.country” is configured as
Custom.
voice.tone.rec
ord =

String

The value format is F/D or !F/D. For
more information on the value format,

Settings->Tones->
Record

refer to the parameter
“voice.tone.dial”.
The default value is blank.
It customizes the info tone when the
parameter “voice.tone.country” is
configured as Custom.
voice.tone.inf
o=

String

The value format is F/D or !F/D. For

Settings->Tones->

more information on the value format,

Info

refer to the parameter
“voice.tone.dial”.
The default value is blank.
It customizes the stutter tone when the
parameter “voice.tone.country” is
configured as Custom.
voice.tone.stut
ter =

String

The value format is F/D or !F/D. For

Settings->Tones->

more information on the value format,

Stutter

refer to the parameter
“voice.tone.dial”.
The default value is blank.
It customizes the message tone when
the parameter “voice.tone.country” is
configured as Custom.

voice.tone.me
ssage =
(for SIP-T46G

String

The value format is F/D or !F/D. For

Settings->Tones->

more information on the value format,

Message

refer to the parameter

only)

“voice.tone.dial”.
The default value is blank.
It customizes the auto answer tone
when the parameter
voice.tone.aut
oanswer =

“voice.tone.country” is configured as
String

Custom.

Settings->Tones->
Auto Answer

The value format is F/D or !F/D. For
more information on the value format,
refer to the parameter

75

Yealink SIP-T4X IP Phones Auto Provisioning Guide
“voice.tone.dial”.
The default value is blank.
voice.handfre
e.spk_vol =

voice.handset
.spk_vol =

voice.headset
.spk_vol =

Integer
from 0 to 15

Integer
from 0 to 15

Integer
from 0 to 15

voice.handfre

Integer

e.tone_vol =

from 0 to 15

voice.handset
.tone_vol =

voice.headset
.tone_vol =

voice.side_ton
e=

voice.ring_vol
=

voice.group_s
pk_vol =

Integer
from 0 to 15

Integer
from 0 to 15

Integer
from -48 to 0
Integer
from 0 to 15
Integer
from 0 to 15

It configures the receiving volume of
speaker.
The default value is 8.
It configures the receiving volume of
handset.
The default value is 8.
It configures the receiving volume of
headset.
The default value is 8.
It configures the dial tone volume of
speaker.
The default value is 8.
It configures the dial tone volume of
handset.
The default value is 8.
It configures the dial tone volume of
headset.
The default value is 8.
It configures the volume of the side
tone.
The default value is -3.
It configures the volume of ringer.
The default value is 8.
It configures the receiving volume of
the group listening mode.
The default value is 8.
It configures the strategy for ring-back
tone.
1-Ignore: the phone plays the mix of

voice.call_pre
view_mode =

defined tone and received RTP for
1, 2 or 3

ring-back tone
2-Force: the phone discards the
received RTP and plays the defined
tone for ring-back tone.
3-Skip: the phone skips the defined

76

Appendix
tone and plays received RTP for
ring-back tone.
The default value is 1.
It configures the source certificates for
the phone to authenticate the TLS
security.trust_c
ertificates =

connection.
0 or 1

Security->Trusted
Certificates->Only

0-Disabled

Accept Trusted

1-Enabled

Certificates

The default value is 1.
It specifies the type of certificates the
phone used to authenticate the
connecting server.
security.ca_ce
rt =

0, 1 or 2

0-Default certificates
1-Custom certificates
2-All certificates

Security->Trusted
Certificates->CA
Certificates

The default value is 0.
It takes effect after reboot.
It enables or disables the phone to
mandatorily validate the
CommonName or SubjectAltName of
security.cn_val
idation =

0 or 1

the certificate received from the

Security->Trusted

connecting server.

Certificates->

0-Disabled

Common Name

1-Enabled

Validation

The default value is 0.
It takes effect after reboot.
It specifies the type of certificates for
the phone to send for TLS
authentication.
security.dev_c
ert =

0 or 1

Security->Server

0-Default certificates

Certificates->

1-Custom certificates

Device Certificates

The default value is 0.
It takes effect after reboot.
security.user_n
ame.user =
security.user_n
ame.admin =

String

String

It configures the user name for web
server access.
It configures the administrator name
for web server access.

77

Yealink SIP-T4X IP Phones Auto Provisioning Guide

security.user_n
ame.var =

String

It configures the var name for web
server access.
It configures the password of the user,

security.user_
password =

var and administrator.
String

The valid value format is user

Security->Password

name:password (e.g.,
admin:admin123).
It enables or disables the 3-level
permissions (admin, var, user).

security.var_e
nable =

0-Disabled
0 or 1

1-Enabled
The default value is 0.
It takes effect after reboot.

custom_softke
y_call_failed.u

It configures the access URL of the file
URL

rl =
custom_softke
y_call_in.url =

on the LCD screen when Call failed.
It configures the access URL of the file
URL

It configures the access URL of the file
URL

url =
custom_softke
y_dialing.url =

for custom soft key layout presented
on the LCD screen when Connecting.
It configures the access URL of the file

URL

for custom soft key layout presented
on the LCD screen when Dialing.

custom_softke
y_ring_back.ur

for custom soft key layout presented
on the LCD screen when Call in.

custom_softke
y_connecting.

for custom soft key layout presented

It configures the access URL of the file
URL

l=

for custom soft key layout presented
on the LCD screen when Ringback.

Settings->Softkey
Layout

Settings->Softkey
Layout

Settings->Softkey
Layout

Settings->Softkey
Layout

Settings->Softkey
Layout

It configures the access URL of the
custom_softke
y_talking.url =

URL

customized file for the soft key

Settings->Softkey

presented on the LCD screen when

Layout

Talking.
linekey.X.type

It configures the desired feature for

=

line key X.

(SIP-T46G: X
ranges from 1
to 27.
SIP-T42G/T41P:
X ranges from
78

Integer

Valid values are:

DSSKey->Line

0-N/A (defaults to line key 7-27 for

Key->Type

SIP-T46G and line key 4-15 for
SIP-T42G/T41P)

Appendix
1 to 15.)

1-Conference
2-Forward
3-Transfer
4-Hold
5-DND
7-Call Return
8-SMS (for SIP-T46G only)
9-Directed Pickup
10-Call Park
11-DTMF
12-Voice Mail
13-Speed Dial
14-Intercom
15-Line (defaults to line key 1-6 for
SIP-T46G and line key 1-3 for
SIP-T42G/T41P)
16-BLF
17-URL
18-Group Listening
22-XML Group
23-Group Pickup
24-Paging
25-Record
27-XML Browser
34-Hot Desking
35-URL Record
38-LDAP
40-Prefix
41-Zero Touch
42-ACD
45-Local Group
50-Keyboard Lock
61-Directory
It configures the desired line to apply

linekey.X.line
=
(SIP-T46G: X
ranges from 1

Integer
from 1 to 6

the key feature.
When the key feature is configured to

DSSKey->Line
Key->Line

Local Group or XML Group, this
parameter is used to specify the
79

Yealink SIP-T4X IP Phones Auto Provisioning Guide
to 27.

desired phone book (or group) when

SIP-T42G/T41P:

multiple phone books (or groups) are

X ranges from

configured on the IP phone.

1 to 15.)

When specifying the line, valid values
are:
1-Line 1
2-Line 2
3-Line 3
4-Line 4
5-Line 5
6-Line 6
Line 4-6 are applicable to the SIP-T46G
IP phone only.
For local group and XML group, valid
values are:
1 stands for the first phone book (or
group), 2 stands for the second phone
book (or group) and so on.

linekey.X.valu
e=

It configures the value of the key

(SIP-T46G: X
ranges from 1
to 27.

feature.
String

For example, when configuring the key
feature to be BLF, it configures the

SIP-T42G/T41P:

DSSKey->Line
Key->Value

number of the monitored user.

X ranges from
1 to 15.)
linekey.X.exte
nsion =
(SIP-T46G: X
ranges from 1
to 27.

It configures the pickup code for BLF
String

feature.
The default value is blank.

SIP-T42G/T41P:

DSSKey->Line
Key->Extension

X ranges from
1 to 15.)
linekey.X.label
=
(SIP-T46G: X
ranges from 1
to 27.
SIP-T42G/T41P:
80

It configures the label displaying on
String

the LCD screen for each line key.
The default value is blank.

DSSKey->Line
Key->Label

Appendix
X ranges from
1 to 15.)
It configures the key feature for the
programmable key X.
Valid values are:
0-N/A
2-Forward
5-DND
6-Redial
7-Call Return
8-SMS (for SIP-T46G only)
programablek

9-Call Pickup

ey.X.type =

13-Spead Dial

(SIP-T46G: X

22-XML Group

ranges from 1
to 13.

Integer

SIP-T42G/T41P:

DSSKey->

23-Group Pickup

Programmable

27-XML Browser

Key->Type

28-History

X ranges from

29-Directory

1 to 11.)

30-Menu
31-Switch Account
32-New SMS (for SIP-T46G only)
33-Status
34-Hot Desking
40-PTT
43-Local Phone Book
45-Local Group
47-XML Directory
It configures the desired line to apply
the programmable key feature.

programablek

When the key feature is configured to

ey.X.line =

Local Group or XML Group, this

(SIP-T46G: X
ranges from 1
to 13.
SIP-T42G/T41P:
X ranges from
1 to 11.)

Integer
from 1 to 6

parameter is used to specify the

DSSKey->

desired phone book (or group) when

Programmable

multiple phone books (or groups) are

Key->Line

configured on the IP phone.
For more information on valid values,
refer to the parameter “linekey.X.line”.
When the key feature is configured to

81

Yealink SIP-T4X IP Phones Auto Provisioning Guide
History, this parameter is used to
specify the type of call history to be
displayed. 1 stands for the local call
history, and 2 stands for the network
history.
programablek
ey.X.value =

It configures the value of the

(SIP-T46G: X
ranges from 1
to 13.

String

SIP-T42G/T41P:

programmable key.

DSSKey->

For example, when configuring the key

Programmable

feature to be Speed Dial, it configures

Key->Value

the number.

X ranges from
1 to 11.)
programablek
ey.X.label =
(X ranges

String

from 1 to 4.)

It configures the label displaying on

DSSKey->

the LCD screen for the soft key.

Programmable

The default value is blank.

Key->Label

expansion_mo
dule.X.key.Y.ty
pe =
(X ranges

Number

from 1 to 6.

It configures the key feature of the
expansion module X key Y.

DSSKey-> Ext Key

Y ranges from
1 to 40.)
expansion_mo
dule.X.key.Y.lin
e=
(X ranges
from 1 to 6.

It configures the desired line to apply
Integer
from 1 to 6

the expansion module key feature.
Valid values are the same as those of

DSSKey->Ext Key

the parameter “linekey.X.line”.

Y ranges from
1 to 40.)
expansion_mo
dule.X.key.Y.v
alue =
(X ranges
from 1 to 6.
Y ranges from
1 to 40.)
(for SIP-T46G
only)

82

String

It configures the value of the
expansion module key.

DSSKey->Ext Key

Appendix

expansion_mo
dule.X.key.Y.e
xtension =
It configures the pickup code for BLF

(X ranges
from 1 to 6.

String

feature.

DSSKey->Ext Key

The default value is blank.

Y ranges from
1 to 40.)
(for SIP-T46G
only)
expansion_mo
dule.X.key.Y.la
bel =

It configures the label displaying on

(X ranges
from 1 to 6.

String

Y ranges from

the LCD screen of the expansion
module for each key.

DSSKey->Ext Key

The default value is blank.

1 to 40.)
(for SIP-T46G
only)

It enables or disables the page icon
and page switch key LED to indicate
phone_setting
.page_tip =

different states of line keys.
0 or 1

0-Disabled
1-Enabled

DSSKey->Line
key->Enable Page
Tips

The default value is 0.
Default.jpg,
1.png,
2.png,
phone_setting
.backgrounds
=

3.png,

It configures the wallpaper displayed
on the phone.
Example:

4.png,

phone_setting.backgrounds = 1.png

Settings->Preferenc

5.png,

To configure a custom picture (e.g.,

e->Wallpaper

6.png,

custom1.png) to be wallpaper, the

7.png,

value format is: Resource:custom1.png

8.png, or

The default value is Default.jpg.

9.png
It configures the display message on
the LCD screen when receiving a 403

phone_setting
.show_code40
3=

String

message.
If leaving the field blank, the phone
will display the value sent from the
server when receiving the 403
83

Yealink SIP-T4X IP Phones Auto Provisioning Guide
message.
The default value is blank.
It enables or disables always forward
feature.
forward.alwa
ys.enable =

0 or 1

Features->Forward

0-Disabled

&DND->Always

1-Enabled

Forward->On/Off

The default value is 0.
forward.alwa
ys.target =

String

It configures the target number the
phone forwards all incoming calls to.

Features->Forward
&DND->Always
Forward->Target
Features->Forward

forward.alwa
ys.on_code =

String

It configures the always forward on

&DND->Always

code.

Forward->On
Code
Features->Forward

forward.alwa
ys.off_code =

String

It configures the always forward off

&DND->Always

code.

Forward->Off
Code

It enables or disables busy forward
feature.
forward.busy.
enable =

0 or 1

Features->Forward

0-Disabled

&DND->Busy

1-Enabled

Forward->On/Off

The default value is 0.
forward.busy.t
arget =

String

It configures the target number the

Features->Forward

phone forwards incoming calls to

&DND->Busy

when busy.

Forward->Target
Features->Forward

forward.busy.
on_code =

String

It configures the busy forward on code.

&DND->Busy
Forward->On
Code
Features->Forward

forward.busy.
off_code =

String

It configures the busy forward off code.

&DND->Busy
Forward->Off
Code

It enables or disables no answer

forward.no_a
nswer.enable
=

0 or 1

forward feature.
0-Disabled
1-Enabled

84

Features->Forward
&DND->No Answer
Forward->On/Off

Appendix
The default value is 0.
forward.no_a

It configures the target number the

Features->Forward

phone forwards incoming calls to after

&DND->No Answer

=

a period of ring time.

Forward->Target

forward.no_a

It configures the waiting ring time

nswer.target

nswer.timeout
=

String

Integer
from 0 to 20

String

e=

Forward->After
Ring Times

It configures the no answer forward on

&DND->No Answer

code.

Forward->On
Code
Features->Forward

forward.no_a
nswer.off_cod

The default value is 2.

&DND->No Answer

Features->Forward

forward.no_a
nswer.on_cod

before forwarding.

Features->Forward

String

e=

It configures the no answer forward off

&DND->No Answer

code.

Forward->Off
Code

It enables or disables the phone to
forward incoming calls to the
forward.intern
ational.enable

international number.
0 or 1

=

0-Disabled
1-Enabled

Features->General
Information->Fwd
International

The default value is 1.
It enables or disables the phone to
automatically change the status of the
acd.auto_avai
lable =

ACD agent to available.
0 or 1

0-Disabled

Features->ACD->
ACD Auto Available

1-Enabled
The default value is 0.
It configures the interval (in seconds)
acd.auto_avai

Integer

lable_timer =

from 0 to 120

to automatically change the status of
the ACD agent to available.
The default value is 60.

Features->ACD->
ACD Auto Available
Timer (0~120s)

It configures the action URL the phone
sends after startup.
action_url.setu
p_completed
=

URL

The value format is: http(s)://IP address

Features->Action

of server/help.xml? variable

URL->Setup

name=variable value.

Completed

Valid variable values are:


$mac
85

Yealink SIP-T4X IP Phones Auto Provisioning Guide



$ip



$model



$firmware



$active_url



$active_user



$active_host



$local



$remote



$display_local



$display_remote



$call_id

Example:
action_url. setup_completed =
http://192.168.0.20/help.xml?model=$
model
It configures the action URL the phone
action_url.log_
on =

sends after account register.
URL

Example:

Features->Action
URL->Registered

action_url.log_on =
http://192.168.0.20/help.xml?ip=$ip
It configures the action URL the phone
sends after account unregister.
action_url.log_
off =

URL

Example:

Features->Action

action_url.log_off =

URL->Unregistered

http://192.168.0.20/help.xml?model=$
model
It configures the action URL the phone
sends after register failed.
action_url.regi
ster_failed =

URL

Example:
action_url.register_failed =

Features->Action
URL->Register
Failed

http://192.168.0.20/help.xml?model=$
model
It configures the action URL the phone
sends when off hook.
action_url.off_
hook =

URL

Example:

Features->Action

action_url.off_hook =

URL->Off Hook

http://192.168.0.20/help.xml?model=$
model

86

Appendix

It configures the action URL the phone
sends when on hook.
action_url.on_
hook =

URL

Example:

Features->Action

action_url.on_hook =

URL->On Hook

http://192.168.0.20/help.xml?model=$
model
It configures the action URL the phone
sends when receiving an incoming
action_url.inco
ming_call =

URL

call.

Features->Action

Example:

URL->Incoming

action_url.incoming_call =

Call

http://192.168.0.20/help.xml?model=$
model
It configures the action URL the phone
sends when placing a call.
action_url.out
going_call =

URL

Example:
action_url.outgoing_call =

Features->Action
URL->Outgoing
Call

http://192.168.0.20/help.xml?model=$
model
It configures the action URL the phone
sends when establishing a call.
action_url.call
_established

URL

=

Example:

Features->Action

action_url.call_established =

URL->Established

http://192.168.0.20/help.xml?model=$
model
It configures the action URL the phone
sends when DND feature is enabled.
action_url.dnd
_on =

URL

Example:

Features->Action

action_url.dnd_on =

URL->Open DND

http://192.168.0.20/help.xml?model=$
model
It configures the action URL the phone
sends when DND feature is disabled.
action_url.dnd
_off =

URL

Example:

Features->Action

action_url.dnd_off =

URL->Close DND

http://192.168.0.20/help.xml?model=$
model
action_url.alw
ays_fwd_on =

URL

It configures the action URL the phone

Features->Action

sends when always forward feature is

URL->Open Always
87

Yealink SIP-T4X IP Phones Auto Provisioning Guide
enabled.

Forward

Example:
action_url.always_fwd_on =
http://192.168.0.20/help.xml?model=$
model
It configures the action URL the phone
sends when always forward feature is
action_url.alw
ays_fwd_off =

URL

disabled.

Features->Action

Example:

URL->Close Always

action_url.always_fwd_off =

Forward

http://192.168.0.20/help.xml?model=$
model
It configures the action URL the phone
sends when busy forward feature is
action_url.bus
y_fwd_on =

URL

enabled.

Features->Action

Example:

URL->Open Busy

action_url.busy_fwd_on =

Forward

http://192.168.0.20/help.xml?model=$
model
It configures the action URL the phone
sends when busy forward feature is
action_url.bus
y_fwd_off =

URL

disabled.

Features->Action

Example:

URL->Close Busy

action_url.busy_fwd_off =

Forward

http://192.168.0.20/help.xml?model=$
model
It configures the action URL the phone
sends when no answer forward
action_url.no_
answer_fwd_o

URL

n=

feature is enabled.

Features->Action

Example:

URL->Open No

action_url.no_answer_fwd_on =

Answer Forward

http://192.168.0.20/help.xml?model=$
model
It configures the action URL the phone
sends when no answer forward

action_url.no_
answer_fwd_o
ff =

URL

feature is disabled.
Example:
action_url.no_answer_fwd_off =
http://192.168.0.20/help.xml?model=$

88

Features->Action
URL->Close No
Answer Forward

Appendix
model
It configures the action URL the phone
sends when performing a transfer.
action_url.tran
sfer_call =

URL

Example:

Features->Action

action_url.transfer_call =

URL->Transfer Call

http://192.168.0.20/help.xml?model=$
model
It configures the action URL the phone
sends when performing a blind
transfer.

action_url.blin
d_transfer_call

URL

=

Example:

Features->Action
URL->Blind Transfer

action_url.blind_transfer_call =
http://192.168.0.20/help.xml?model=$
model
It configures the action URL the phone
sends when performing an attended

action_url.atte
nded_transfer

URL

_call =

or a semi-attended transfer.

Features->Action

Example:

URL->Attended

action_url.attended_transfer_call =

Transfer

http://192.168.0.20/help.xml?model=$
model
It configures the action URL the phone
sends when placing a call on hold.
action_url.hol
d=

URL

Example:

Features->Action

action_url.hold =

URL->Hold

http://192.168.0.20/help.xml?model=$
model
It configures the action URL the phone
sends when resuming a held call.
action_url.unh
old =

URL

Example:

Features->Action

action_url.unhold =

URL->UnHold

http://192.168.0.20/help.xml?model=$
model
It configures the action URL the phone
sends when muting a call.
action_url.mut
e=

URL

Example:

Features->Action

action_url.mute =

URL->Mute

http://192.168.0.20/help.xml?model=$
model

89

Yealink SIP-T4X IP Phones Auto Provisioning Guide

It configures the action URL the phone
sends when un-muting a call.
action_url.unm
ute =

URL

Example:

Features->Action

action_url.unmute =

URL->UnMute

http://192.168.0.20/help.xml?model=$
model
It configures the action URL the phone
sends when missing a call.
action_url.miss
ed_call =

URL

Example:

Features->Action

action_url.missed_call =

URL->Missed Call

http://192.168.0.20/help.xml?model=$
model
It configures the action URL the phone
sends when terminating a call.
action_url.call
_terminated =

URL

Example:

Features->Action

action_url.call_terminated =

URL->Terminated

http://192.168.0.20/help.xml?model=$
model
It configures the action URL the phone
sends when changing the state of the
phone from busy to idle.
action_url.bus
y_to_idle =

URL

Example:

Features->Action
URL->Busy to Idle

action_url.busy_to_idle =
http://192.168.0.20/help.xml?model=$
model
It configures the action URL the phone
sends when changing the state of the
phone from idle to busy.
action_url.idle
_to_busy =

URL

Example:

Features->Action
URL->Idle to Busy

action_url.idle_to_busy =
http://192.168.0.20/help.xml?model=$
model
It configures the action URL the phone
sends when changing the IP address
of the phone.
action_url.ip_c
hange =

URL

Example:
action_url.ip_change =
http://192.168.0.20/help.xml?model=$
model

90

Features->Action
URL->IP Changed

Appendix

It configures the action URL the phone
sends when forwarding an incoming
action_url.for
ward_incomin

URL

g_call =

call.

Features->Action

Example:

URL->Forward

action_url.forward_incoming_call =

Incoming Call

http://192.168.0.20/help.xml?model=$
model
It configures the action URL the phone
sends when rejecting an incoming call.
action_url.reje
ct_incoming_c

URL

Example:
action_url.reject_incoming_call =

all =

Features->Action
URL->Reject
Incoming Call

http://192.168.0.20/help.xml?model=$
model
It configures the action URL the phone
sends when answering a new
incoming call.

action_url.ans
wer_new_inco

URL

Example:
action_url.answer_new_incoming_call

ming_call =

Features->Action
URL->Answer
New-In Call

=
http://192.168.0.20/help.xml?model=$
model
It configures the action URL the phone
sends when finishing transferring a
action_url.tran
sfer_finished

URL

=

call.

Features->Action

Example:

URL->Transfer

action_url.transfer_finished =

Finished

http://192.168.0.20/help.xml?model=$
model
It configures the action URL the phone
sends when failing to transfer a call.
action_url.tran
sfer_failed =

URL

Example:
action_url. transfer_failed =

Features->Action
URL->Transfer
Failed

http://192.168.0.20/help.xml?model=$
model
English,
Chinese_S,
lang.wui =

Chinese_T,
German,
French,
Italian,

It configures the language of the web
user interface.

Settings->

Note: Chinese_S and Chinese_T are

Preference->

applicable to the SIP-T46G IP phone

Language

only.

91

Yealink SIP-T4X IP Phones Auto Provisioning Guide
Spanish,
Turkish or
Portuguese
English,
Chinese_S,
Chinese_T,

lang.gui =

It configures the language of the

Deutsch,

phone user interface.

French,

The default value is English.

Turkish,

Note: Chinese_S and Chinese_T are

Italian,

applicable to the SIP-T46G IP phone

Polish,

only.

Spanish or
Portuguese
local_time.tim
e_zone =

String

String

=

local_time.ntp
_server1 =

local_time.ntp
_server2 =

local_time.inte
rval =

Settings-> Time &

The default value is +8.

Date-> Time Zone

It configures the time zone name.

local_time.tim
e_zone_name

It configures the time zone.

The default time value is
China(Beijing).

Settings ->Time &
Date-> Time Zone

IP address

It configures the domain name or IP

Settings ->Time &

or domain

address of the NTP server 1.

Date-> Primary

name

The default value is cn.pool.ntp.org.

Server

IP address

It configures the domain name or IP

Settings ->Time &

or domain

address of the NTP server 2.

Date-> Secondary

The default value is cn.pool.ntp.org.

Server

It configures the interval (in seconds)

Settings ->Time &

for the phone to synchronize local time

Date->

with the NTP server.

Synchronism

The default value is 1000.

(1~86400s)

name
Integer
from 15 to
86400

It enables or disables daylight saving
time (DST) feature.
local_time.su
mmer_time =

0-Disabled
0, 1 or 2

1-Enabled
2-Automatic

Settings ->Time &
Date-> Daylight
Saving Time

The default value is 2.
It configures the way DST works when
local_time.dst
_time_type =

0 or 1

DST feature is enabled.

Settings ->Time &

0-DST By Date

Date-> Fixed Type

1-DST By Week

92

Appendix
The default value is 0.
For DST By Date:
Settings ->Time &

local_time.star
t_time =

Time

It configures the time to start DST.

Date-> Start Date

Value formats are:

For DST By Week:



Month/Day/Hour (for By Date)

Settings ->Time &



Month/ Day of Week/ Day of

Date-> DST Start

Week Last in Month/ Hour of Day

Month/DST Start

(for By Week)

Day of Week/ DST

The default value is 1/1/0.

Start Day of Week
Last in Month/ Start
Hour of Day
Settings ->Time &

It configures the time to end DST.
Value formats are:
local_time.en
d_time =

Time

Date-> End Date
(for DST By Date)
Settings ->Time &



Month/Day/Hour (for By Date)

Date-> DST Stop



Month/ Day of Week/ Day of

Month/DST Stop

Week Last in Month/ Hour of Day

Day of Week/DST

(for By Week)

Stop Day of Week

The default value is 12/31/23.

Last in Month/Stop
Hour of Day (for
DST By Week)

local_time.offs
et_time =

Integer
from -300 to
300

It configures the offset time (in

Settings ->Time &

minutes).

Date->Offset

The default value is blank.

(minutes)

It configures the phone to obtain time
from NTP server or manual settings.

local_time.ma
nual_time_en

0 or 1

able =

Settings ->Time &

0- NTP

Date->Manual

1- Manual

Time

The default value is 0.
It configures the time format.
local_time.tim
e_format =

0 or 1

0-12 Hour

Settings ->Time &

1-24 Hour

Date->Time Format

The default value is 1.
It configures the date format.
local_time.dat
e_format =

0, 1, 2, 3, 4, 5
or 6

Valid values are:
0-WWW MMM DD

Settings ->Time &
Date-> Date
Format

1-DD-MMM-YY

93

Yealink SIP-T4X IP Phones Auto Provisioning Guide
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.
It enables or disables the phone to
update time with the offset time
obtained from the DHCP server.
local_time.dhc
p_time =

0 or 1

It is only available to the time zone 0.
0-Disabled
1-Enabled
The default value is 0.
It enables or disables the phone to
provide input field of register name on

hotdesking.st
artup_register
_name_enabl

the hot desking login wizard during
0 or 1

startup.
0-Disabled

e=

1-Enabled
The default value is 1.
It enables or disables the phone to
show the user name item on the login

hotdesking.st
artup_userna

wizard during startup.
0 or 1

me_enable =

0-Disabled
1-Enabled
The default value is 1.
It enables or disables the phone to
show the password item on the login

hotdesking.st
artup_passwo

wizard during startup.
0 or 1

rd_enable =

0-Disabled
1-Enabled
The default value is 1.
It enables or disables the phone to
show the SIP server item on the login

hotdesking.st
artup_sip_serv
er_enable =

wizard during startup.
0 or 1

0-Disabled
1-Enabled
The default value is 1.

94

Settings ->Time &
Date-> DHCP Time

Appendix

It enables or disables the phone to
show the outbound server item on the
hotdesking.st
artup_outboun

login wizard during startup.
0 or 1

d_enable =

0-Disabled
1-Enabled
The default value is 0.
It enables or disables the phone to
show the register name item on the

hotdesking.ds
skey_register_
name_enable

login wizard when pressing the Hot
0 or 1

Desking key.
0-Disabled

=

1-Enabled
The default value is 0.
It enables or disables the phone to
show the user name item on the login
wizard when pressing the Hot Desking

hotdesking.ds
skey_usernam

0 or 1

key.
0-Disabled

e_enable =

1-Enabled
The default value is 1.
It enables or disables the phone to
show the password item on the login
wizard when pressing the Hot Desking

hotdesking.ds
skey_passwor

0 or 1

key.
0-Disabled

d_enable =

1-Enabled
The default value is 1.
It enables or disables the phone to
show the SIP server item on the login
wizard when pressing the Hot Desking

hotdesking.ds
skey_sip_serv

0 or 1

key.
0-Disabled

er_enable =

1-Enabled
The default value is 1.
It enables or disables the phone to

hotdesking.ds
skey_outboun
d_enable =

0 or 1

show the outbound server item on the
login wizard when pressing the Hot
Desking key.

95

Yealink SIP-T4X IP Phones Auto Provisioning Guide
0-Disabled
1-Enabled
The default value is 0.
distinctive_rin
g_tones.alert_i
nfo.X.text =

String

(X ranges

It configures the internal ringer text for

Settings->Ring->

distinctive ringtone.

Internal Ringer Text

from 1 to 10.)
distinctive_rin
g_tones.alert_i
nfo.X.ringer =
(X ranges

It configures the desired ring tone for
Integer
from 1 to 8

from 1 to 10.)

each text.
The value ranges from 1 to 8, each

Settings->Ring->
Internal Ringer File

digit stands for an appropriate
ringtone.
It enables or disables the phone to
automatically redial the called number
when the called party is temporarily

auto_redial.en
able =

0 or 1

unavailable.
0-Disabled

Features->General
Information->Auto
Redial

1-Enabled
The default value is 0.

auto_redial.int
erval =

auto_redial.ti
mes =

Integer
from 1 to 300

Integer
from 1 to 300

It configures the interval (in seconds)
for the phone to wait before redial.
The default value is 10.

Features->General
Information->Auto
Redial Interval
(1~300s)

It configures the auto redial times

Features->General

when the called party is temporarily

Information->Auto

unavailable.

Redial Times

The default value is 10.

(1~300)

It enables or disables the zero touch
for the phone to perform provisioning
zero_touch.en
able =

during startup.
0 or 1

0-Disabled
1-Enabled

Settings->Auto
Provision->Zero
Active

The default value is 0.
It configures the duration time (in
zero_touch.wa
it_time =

Integer
from 0 to 100

seconds) of the phone displaying the

Settings->Auto

zero-sp-touch configuration interface

Provision->Wait

when powered on.

Time

The default value is 5.
96

Appendix

push_xml.serv
er =

URL

It configures the URL of the push XML
server.

Features->Remote
Control-> Push XML
Server IP Address

It enables or disables the phone to
block displaying the push XML
push_xml.bloc
k_in_calling =

interface when in calling status.
0 or 1

0-Disabled
1-Enabled

Features->Remote
Control->Block
XML In Calling

The default value is 0.
It enables or disables the phone to use
the push XML via SIP NOTIFY message.
push_xml.sip_
notify =

0 or 1

0-Disabled
1-Enabled

Features-> Remote
Control->SIP Notify

The default value is 0.
It configures the IP address of server
from which the phone receives the
features.actio
n_uri_limit_ip
=

action URI requests. Multiple IP
IP addresses
or any

addresses are separated by comma.
If the value of this parameter is
configured as “any”, the phone will

Features-> Remote
Control->Action
URI allow IP List

receive action URI requests from any IP
server.
It enables or disables the phone to
perform reboot during a call when
receiving a specific action URI request

features.actio
n_uri_reboot_

0 or 1

about reboot.
0-Disabled

now =

1-Enabled
The default value is 0.
dialplan.area
_code.code =

dialplan.area
_code.min_len
=
dialplan.area
_code.max_le
n=

Number

Integer
from 1 to 15

Integer
from 1 to 15

It configures the area code.
The default value is blank.

It configures the minimum length of the
number prefixed with the area code.
The default value is 1.

Settings->Dial
Plan->Area
Code->Code
Settings->Dial
Plan->Area
Code->Min Length
(1-15)

It configures the maximum length of

Settings->Dial

the number prefixed with the area

Plan->Area

code.

Code->Max Length
97

Yealink SIP-T4X IP Phones Auto Provisioning Guide
The value must be larger than the

(1-15)

minimum length.
The default value is 15.
dialplan.area
_code.line_id
=

It configures lines applying the area

(SIP-T46G: X
ranges from 1

Number

to 6.

code. Line IDs are separated by
comma.
The default value is blank.

SIP-T42G/T41P:

Settings->Dial
Plan->Area
Code->Account

X ranges from
1 to 3.)
dialplan.block

Settings->Dial

_out.number.X
=

String

(X ranges

It configures the block out number.

Plan->Block

The default value is blank.

Out->BlockOut
Number X

from 1 to 10.)
dialplan.block

It configures lines applying the block

_out.line_id.X
=

Number

(X ranges

out rule. Line IDs are separated by
comma.
The default value is blank.

from 1 to 10.)
dialplan.dialn
ow.rule.X =
(X ranges

String

It configures the dial now rule.
The default value is blank.

from 1 to 100.)
dialplan.dialn

It configures lines applying the dial

ow.line_id.X =

now rule. Line IDs are separated by

(X ranges

Number

from 1 to 100.)

The default value is blank.

dialplan.repla
ce.prefix.X =
(X ranges

comma.

String

from 1 to 100.)

Settings->Dial
Plan->Block
Out->Account

Settings->Dial
Plan->Dial-now->
Rule

Settings->Dial
Plan->Dial-now->
Account

It configures the entered number to be

Settings->Dial

replaced.

Plan->Replace

The default value is blank.

Rule->Prefix

It configures the alternate number to

Settings->Dial

replace the entered number.

Plan->Replace

The default value is blank.

Rule->Replace

dialplan.repla
ce.replace.X
=
(X ranges
from 1 to 100.)

98

String

Appendix

It configures lines applying the replace
dialplan.repla
ce.line_id.X =

Number

rule. Line IDs are separated by
comma.
The default value is blank.

remote_phone

It configures the access URL of the

book.data.X.u
rl =

URL

(X ranges

remote phone book.
The URL cannot contain the character
<>'" \.

from 1 to 5.)

Settings->Dial
Plan->Replace
Rule->Account

Directory->Remote
Phone Book->
Remote URL

remote_phone
book.data.X.n
ame =

String

(X ranges

It configures the display name of the
remote phone book item.

Directory->Remote
Phone Book->
Display Name

from 1 to 5.)
It enables or disables LDAP feature for
the phone.
ldap.enable

0 or 1

0-Disabled
1-Enabled

Directory->LDAP->
Enable LDAP

The default value is 0.
It configures the criteria for searching
the contact name attributes.
ldap.name_filt
er =

String

Example:
ldap.name_filter = (|(cn=%)(sn=%))

Directory->LDAP->
LDAP Name Filter

The default value is blank.
It configures the criteria for searching
the contact number attributes.
ldap.number_f
ilter =

Example:
String

ldap.number_filter =
(|(telephoneNumber=%)(mobile=%)(i

Directory->LDAP->
LDAP Number Filter

pPhone=%))
The default value is blank.

ldap.host =

IP address

It configures the IP address or domain

or domain

name of the LDAP server.

name

The default value is blank.

Integer
ldap.port =

ldap.base =

from 1 to

It configures the port of the LDAP
server.

65535

The default value is 389.

String

It configures the LDAP search base

Directory->LDAP->
Server Address

Directory->LDAP->
Port

Directory->LDAP->
99

Yealink SIP-T4X IP Phones Auto Provisioning Guide
which corresponds to the location of

Base

the LDAP phone book.
Example:
ldap.base = dc=yealink,dc=cn
The default value is blank.
It configures the user name for
ldap.user =

String

accessing the LDAP server.
The default value is blank.

ldap.passwor
d=

ldap.max_hits
=

It configures the password for
String

accessing the LDAP server.
The default value is blank.

Integer
from 1 to
32000

Directory->LDAP->
User Name

Directory->LDAP->
Password

It configures the maximum of the
search results returned by the LDAP

Directory->LDAP->

server.

Max Hits (1~32000)

The default value is 50.
It configures the name attributes of
each record to be returned by the
LDAP server.

ldap.name_at
tr =

String

Directory->LDAP->

Attributes are separated by space.

LDAP Name

Example:

Attributes

ldap.name_attr =sn cn
The default value is blank.
It configures the number attributes of
each record to be returned by the
LDAP server.
ldap.numb_at
tr =

String

Directory->LDAP->

Attributes are separated by space.

LDAP Number

Example:

Attributes

ldap.numb_attr = Mobile ipPhone
The default value is blank.
It configures the display name of the
contact record displayed on the LCD
screen.
ldap.display_
name =

String

The value of this parameter must start

Directory->LDAP->

with “%” symbol.

LDAP Display Name

Example:
ldap.display_name =%cn
The default value is blank.

100

Appendix

ldap.version
=

2 or 3

It configures the LDAP version.

Directory->LDAP->

The default value is 3.

Protocol

It enables or disables the phone to
perform an LDAP search when
ldap.call_in_lo
okup =

receiving an incoming call.
0 or 1

0-Disabled
1-Enabled

Directory->LDAP->
LDAP Lookup For
Incoming Call

The default value is 0.
It enables or disables the phone to sort
the search results in alphabetical order
ldap.ldap_sort
=

or numerical order.
0 or 1

0-Disabled
1-Enabled

Directory->LDAP->
LDAP Sorting
Results

The default value is 0.
It configures the return code when
DND mode is activated.
features.dnd_r

404, 480 or

efuse_code =

486

Features->General

404-Not Found

Information->

480-Temporarily Not Available

Return Code When

486-Busy Here

DND

The default value is 480.
It configures the return code when
refusing a call.
features.norm
al_refuse_cod
e=

404, 480 or
486

Features->General

404-Not Found

Information->

480-Temporarily Not Available

Return Code When

486-Busy Here

Refuse

The default value is 486.
features.call_c

It enables or disables call completion

ompletion_en

feature.

able =

0-Disabled

Information->Call

(for SIP-T46G

1-Enabled

Completion

only)

The default value is 0.

0 or 1

Features->General

It configures the call forward mode.
features.fwd_
mode =

0 or 1

0-Phone
1-Custom

Features->Forward
& DND->Forward
->Mode

The default value is 0.
features.dnd_
mode =

0 or 1

It configures the DND mode.

Features->Forward
& DND->DND->
101

Yealink SIP-T4X IP Phones Auto Provisioning Guide
0-Phone

Mode

1-Custom
The default value is 0.
features.dnd.o
n_code =

features.dnd.o
ff_code =

String

String

It configures the DND on code when
the DND mode is configured as Phone.

It configures the DND off code when
the DND mode is configured as Phone.

Features->Forward
& DND->DND->
DND On Code
Features->Forward
& DND->DND->
DND Off Code

It enables or disables the phone to
receive the calls from the authorized
features.dnd.e
mergency_en

number when the DND is enabled.
0 or 1

able =

0-Disabled
1-Enabled

Features->Forward
& DND->DND->
DND Emergency

The default value is 0.
It configures the authorized number
features.dnd.e
mergency_aut
horized_numb

when the DND is enabled.
String

Multiple numbers are separated by
comma.

er =

The default value is blank.

Features->Forward
&DND->DND->
DND Authorized
Number

It enables or disables call waiting
feature.
call_waiting.e
nable =

0 or 1

Features->General

0-Disabled

Information->Call

1-Enabled

Waiting

The default value is 1.
It configures the call waiting on code
call_waiting.o
n_code =

String

to activate the server-side call waiting
feature.
The default value is blank.
It configures the call waiting off code

call_waiting.of
f_code =

String

to deactivate the server-side call
waiting feature.
The default value is blank.
It enables or disables the phone to
play the call waiting tone.

call_waiting.to
ne =

0 or 1

0-Disabled
1-Enabled
The default value is 1.

102

Features->Audio->
Call Waiting Tone

Appendix

It enables or disables the phone to
automatically answer an incoming
features.interc
om.allow =

intercom call.
0 or 1

0-Disabled

Features->Intercom
->Accept Intercom

1-Enabled
The default value is 1.
It enables or disables the phone to
mute the speaker when answering an
features.interc
om.mute =

intercom call.
0 or 1

0-Disabled

Features->Intercom
->Intercom Mute

1-Enabled
The default value is 0.
It enables or disables the phone to
play a warning tone when answering
features.interc
om.tone =

an intercom call.
0 or 1

0-Disabled

Features->Intercom
->Intercom Tone

1-Enabled
The default value is 1.
It enables or disables the phone to
barge in an intercom call.
features.interc
om.barge =

0 or 1

0-Disabled
1-Enabled

Features->Intercom
->Intercom Barge

The default value is 1.
It enables and disables the IP phone to
map the keywords in the Alert-info
header to the specified Bellcore ring
features.alert_
info_tone =

0 or 1

tones.
0-Disabled
1-Enabled
The default value is 0.
It enables or disables the phone to
perform a remote phone book search

features.remot
e_phonebook.

when receiving an incoming call.
0 or 1

enable =

Directory->Remote
Phone Book->

0-Disabled

Search Remote

1-Enabled

Phonebook Name

The default value is 0.
features.remot

Integer

e_phonebook.

from 120 to

It configures the interval (in seconds)

Directory->Remote

for the phone to update the data of the

Phone Book->
103

Yealink SIP-T4X IP Phones Auto Provisioning Guide
flash_time =

2592000

remote phone book from the remote

Search Flash Time

phone book server.

(Seconds)

The default value is 21600.
features.hotlin
e_number =

features.hotlin
e_delay =

number

Integer
from 0 to 10

It configures the hotline number.
The default value is blank.

Features->General
Information->
Hotline Number

It configures the delay time (in

Features->General

seconds) for the phone to dial out the

Information->

hotline number automatically.

Hotline Delay

The default value of delay time is 4.

(0~10s)

It enables or disables the phone to
suppress the display of DTMF digits.
features.dtmf.
hide =

0 or 1

0-Disabled
1-Enabled

Features->General
Information->
Suppress DTMF
Display

The default value is 0.
It enables or disables the IP phone to

features.dtmf.
hide_delay =

0 or 1

display the DTMF digits for a short

Features->General

period before displaying as asterisks.

Information->

0-Disabled

Suppress DTMF

1-Enabled

Display Delay

The default value is 0.
features.dtmf.r
epetition =

Integer
from 1 to 3

It configures the repetition times for

Features->General

sending the DTMF packets.

Information->DTMF

The default value is 3.

Repetition

It enables or disables the phone to
send DTMF sequences for transfer
function when pressing the transfer
features.dtmf.r
eplace_tran =

0 or 1

soft key or the transfer key.
0-Disabled

Features->General
Information->DTMF
Replace Tran

1-Enabled
The default value is 0.
It configures DTMF sequences to be
features.dtmf.t
ransfer =

sent for transfer key.
String

It can be consisted of 0-9, A-D, * and #.
The default value is blank.

Information->Tran
Send DTMF

features.play_

It enables or disables the phone to

Features->General

local_dtmf_ton

play a local DTMF tone.

Information->Play

0-Disabled

Local DTMF Tone

e_enable=

104

Features->General

0 or 1

Appendix
1-Enabled
The default value is 1.
It enables or disables headset prior
feature.
features.head
set_prior =

0 or 1

Features->General

0-Disabled

Information->

1-Enabled

Headset Prior

The default value is 0.
It enables or disables dual headset
feature.
features.head
set_training =

0 or 1

Features->General

0-Disabled

Information->

1-Enabled

Dual-Headset

The default value is 0.

features.busy_
tone_delay =

It configures the duration time (in
0, 3 or 5

seconds) for the busy tone.
The default value is 0.

Features->General
Information->Busy
Tone Delay
(Seconds)

It enables or disables the phone to
send double pound keys by pressing
the pound key twice when the pound
features.send
_pound_key =

0 or 1

key is configured as a send key.
0-Disabled

Features->General
Information->Send
Pound Key

1-Enabled
The default value is 0.
It configures the "#" or "*" key as a send
key.
features.poun
d_key.mode =

0-Disabled
0, 1 or 2

1-# key
2-* key

Features->General
Information->Key
As Send

The default value is 1.
It enables or disables the phone to
play key tone when pressing the send
features.send
_key_tone =

key.
0 or 1

0-Disabled

Features->Audio->
Send Sound

1-Enabled
The default value is 1.
features.key_t
one =

0 or 1

It enables or disables the phone to

Features->Audio->

play key tone when pressing any key.

Key Tone

105

Yealink SIP-T4X IP Phones Auto Provisioning Guide
0-Disabled
1-Enabled
The default value is 1.
It enables or disables the phone to
play a warning tone when there is a
features.play_
hold_tone.ena

call on hold.
0 or 1

ble =

0-Disabled
1-Enabled

Features->General
Information->Play
Hold Tone

The default value is 1.
features.play_
hold_tone.del
ay =

Integer
from 1 to 60

It configures the interval (in seconds)

Features->General

for playing a hold warning tone.

Information->Play

The default value is 30.

Hold Tone Delay

It configures the phone to continue to
play the dial tone after inputting the
preset numbers in the dialing
interface.
Example:
features.redial
_tone =

Integer

features.redial_tone =125

Features->Audio->

The phone will continue to play dial

Redial Tone

tone after you enter “125” in the
dialing interface.
If you leave it blank, the phone will not
play dial tone after you enter numbers
in the dialing interface.
It enables or disables password dial
feature for the IP phone.

features.pass
word_dial.ena

0 or 1

ble =

Features->General

0-Disabled

Information->

1-Enabled

PswDial

The default value is 0.
It configures the length of digits to be

features.pass
word_dial.len

Integer

gth =

hidden.
The hidden digits are displayed as
asterisks on the LCD screen.

Features->General
Information->
PswLength

It configures the prefix of the
password-dial number.

features.pass
word_dial.pref
ix =

String

For example, configure the prefix to be
12 and the length to be 3, when you
want to dial the number 123456, the
entered number displays as 12***6 on

106

Features->General
Information->
PswPrefix

Appendix
the LCD screen.
It enables or disables the phone to
save the call history.
features.save_
call_history =

0 or 1

Features->General

0-Disabled

Information->Save

1-Enabled

Call log

The default value is 1.

It enables or disables the IP phone to
display the Save Call Log option on
features.histo
ry_save_displ

the web user interface.
0 or 1

ay =

0-Disabled
1-Enabled
The default value is 1.
It enable or disables the IP phone to
turn off the power Indicator LED when

features.powe
r_led_on =

it is idle.
0 or 1

0-Disabled
1-Enabled

Features->General
Information->Close
Power Light

The default value is 1.
features.auto_
answer_delay
=

Integer
from 1 to 4

It configures the delay time (in
seconds) of auto answer.
The default value is 3.
It enables or disables the phone to
perform a blind transfer by pressing

features.dsske
y_blind_tran =

the predefined transfer DSS key.
0 or 1

0-Disabled
1-Enabled
The default value is 1.

features.relog
_offtime =

Integer
from 1 to
1000

It configures the web login timeout (in
minutes).
The default value is 5.

Features->General
Information->AutoLogout Time
(1~1000min)

It enables or disables the phone to
make an IP call directly.

features.direct
_ip_call_enabl

0 or 1

e=

Features->General

0-Disabled

Information->Allow

1-Enabled

IP Call

The default value is 1.
features.allow

0 or 1

It enables or disables the phone to

Features->General
Information->Allow
107

Yealink SIP-T4X IP Phones Auto Provisioning Guide
_mute =

mute an active call.

Mute

0-Disabled
1-Enabled
The default value is 1.
It configures the ringer device when
the phone receiving an incoming call.
features.ringer
_device.is_use

0-Use Speaker
0, 1 or 2

_headset =

1-Use Headset
2-Use Headset & Speaker

Features->Audio->
Ringer Device for
Headset

The default value is 0.
It enables or disables the phone to
prompt for the administrator password
when you long press the OK key to

features.factor
y_pwd_enabl

0 or 1

reset the phone to factory defaults.
0-Disabled

e=

1-Enabled
The default value is 0.
It enables or disables the phone to
display the GPickup soft key when the
features.picku
p.group_picku

phone is in the pre-dialing interface.
0 or 1

p_enable =

0-Disabled
1-Enabled

Features->Call
Pickup->Group Call
Pickup

The default value is 0.
features.picku
p.group_picku

String

p_code =

It configures the group call pickup

Features->Call

code.

Pickup->Group Call

The default value is blank.

Pickup Code

It enables or disables the phone to
display the DPickup soft key when the
features.picku
p.direct_picku

phone is in the pre-dialing interface.
0 or 1

p_enable =

0-Disabled
1-Enabled

Features->Call
Pickup->Directed
Call Pickup

The default value is 0.
features.picku

It configures the directed call pickup

Features->Call

p.direct_picku

code.

Pickup->Directed

The default value is blank.

Call Pickup Code

String

p_code =
features.picku
p.blf_visual_e

108

It enables or disables the phone to
0 or 1

display a visual alert when the
monitored user receives an incoming

Features->Call
Pickup->Visual

Appendix
nable =

call.

Alert for BLF Pickup

0-Disabled
1-Enabled
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
p.blf_audio_e

0 or 1

call.
0-Disabled

nable =

Features->Call
Pickup->Audio
Alert for BLF Pickup

1-Enabled
The default value is 0.
It enables or disables the phone to turn
off the BLF key LED when the

features.blf_a
nd_callpark_i
dle_led_enabl

monitored user is idle.
0 or 1

e=

0-Disabled
1-Enabled

Features->General
Information->LED
Off in Idle

The default value is 0.
It enables or disables the power LED
indicator when the phone is idle, in the

features.idle_t
alk_power_le
d_flash_enabl

pre-dialing screen or during a call.
0 or 1

e=

0-Disabled
1-Enabled
The default value is 0.
It enables or disables the phone to
play the warning tone when receiving

features.voice
_mail_tone_en

a voice mail.
0 or 1

able =

0-Disabled
1-Enabled
The default value is 1.
It enables or disables the phone to
enter into the group listening mode by
pressing the speakerphone key when

features.grou
p_listen_in_tal

0 or 1

it is in talking using the handset.
0-Disabled

king_enable =

1-Enabled
The default value is 1.
features.blf_fil
ter_value =

0 or 1

It enables or disables the phone to
filter the value configured for the BLF
109

Yealink SIP-T4X IP Phones Auto Provisioning Guide
key.
0-Disabled
1-Enabled
The default value is 0.
It enables or disables the phone to
deal with the Version header in the BLF
features.blf_lis
t_version =

NOTIFY message sent by the server.
0 or 1

0-Disabled
1-Enabled
The default value is 0.
It enables or disables the server to
release the BLA line automatically.

features.auto_
release_bla_li

0 or 1

ne =

0-Disabled
1-Enabled
The default value is 0.
It enables or disables the phone with
active accounts to play tones in the
dialing interface differently from the

features.partiti
on_tone =

0 or 1

phone with no active accounts.
0-Disabled
1-Enbaled
The default value is 0.
It enables or disables forward
diversion feature.

features.fwd_
diversion_ena

0 or 1

ble =

Features->General

0- Disabled

Information->Diver

1-Enabled

sion/History-Info

The default value is 1.
features.hold_

Integer

trans_delay =

from 0 to 60

It configures the delay time (in
milliseconds) before transferring a call.
The default value is 0.

PCMU
PCMA
multicast.code
c=

G729

It configures the codec of multicast

Features->General

G722

paging.

Information->

The default value is G722.

Multicast Codec

G723_53
G726_16
G726_24

110

Appendix
G726_32
G726_40
It enables or disables the phone to
handle the incoming multicast paging
multicast.recei
ve_priority.en

0 or 1

calls when there is a multicast paging

Directory->

call on the phone.

Multicast IP->

0-Disabled

able =

1-Enabled

Paging Priority
Active

The default value is 1.
multicast.recei
ve_priority.pri
ority =

Integer
from 0 to 10

It configures the priority of multicast

Directory->

paging calls.

Multicast IP->

The default value is 10.

Paging Barge

It configures the listening multicast IP
multicast.listen

address and port number for the

_address.X.ip_

phone.

address =

Directory->

The default value is blank.

Multicast IP->

(X ranges

Example:

Listening Address

from 1 to 10.)

multicast.listen_address.1.ip_address

String

= 224.5.6.20:10008
multicast.listen

It configures the label displayed on the

_address.X.la
bel =

String

(X ranges

LCD screen when receiving the

Directory->

multicast paging.

Multicast IP->Label

The default value is blank.

from 1 to 10)

It enables or disables the phone to
automatically dial out the entered
phone_setting
.predial_auto

digits in the pre-dialing interface.
0 or 1

dial =

0-Disabled
1-Enabled

Settings->
Preference->Live
Dialpad

The default value is 0.
It configures the time (in seconds) for
phone_setting
.inter_digit_tim
e=

Integer
from 1 to 14

the phone to automatically dial out the

Settings->

entered digits without pressing the

Preference->Inter

send key.

Digit Time (1~14s)

The default value is 4.
phone_setting
.lock =

0 or 1

It enables or disables keypad lock

Features->Phone

feature.

Lock->Keypad Lock

0-Disabled

Enable

111

Yealink SIP-T4X IP Phones Auto Provisioning Guide
1-Enabled
The default value is 0.
It configures the keypad lock type.
phone_setting
.phone_lock .l
ock_key_type

0, 1 or 2

=

0- All Keys

Features->Phone

1-Function Key

Lock-> Keypad

2- Menu Key

Lock Type

The default value is 0.
It configures the password for

phone_setting
.phone_lock.u

Integer

nlock_pin =

unlocking the keypad.
The default value is 123.

Features->Phone
Lock->Phone
Unlock PIN (0~15
Digital)

It configures the interval (in seconds)
to automatically lock the keypad.

Features->Phone

from 0 to

The default value is 0 (the keypad can

Lock->Phone Lock

3600

be locked only by pressing the keypad

Time Out (0~3600s)

phone_setting

Integer

.phone_lock.lo
ck_time_out =

lock key).
It configures the ringtone for the
phone.
Ring1.wav,
phone_setting
.ring_type =

Ring2.wav,
……
Ring8.wav

Example:

Settings->

phone_setting.ring_type = Ring1.wav

Preference->Ring

The default value is Ring1.wav.

Type

Note: Ring 6-8 are applicable to the
SIP-T46G IP phone only.
phone_setting
.active_backli
ght_level =
(for SIP-T46G

Integer
from 1 to 10

It configures the level of the active
backlight intensity.
The default value is 8.

only)

Settings->
Preference->
Backlight On
Intensity

It configures the phone to go out or
phone_setting

reduce intensity of the backlight on the

.inactive_back
light_level =

LCD screen after a period of inactivity.
0 or 1

(for SIP-T46G
only)

Settings->
Preference->

0-Off

Backlight Idle

1-Low

Intensity

The default value is 1.
phone_setting

0, 60, 120,

.backlight_tim

300, 600 or

e=

1800

It configures the backlight time (in
seconds).
0-Always on
60-1min

112

Settings->
Preference->
Backlight Time

Appendix
120-2min
300-5min
600-10min
1800-30min
The default value is 0.
phone_setting
.ring_for_tranf
ailed =

Ring1.wav

It configures the ringtone when the

Ring2.wav

phone fails to transfer a call.

....
Ring8.wav

Note: Ring 6-8 are applicable to the
SIP-T46G IP phone only.
It enables or disables the phone to
show the logon wizard during startup.

phone_setting
.logon_wizard

0 or 1

=

Features->General

0-Disabled

Information->

1-Enabled

Logon Wizard

The default value is 0.
It enables or disables the phone to
deal with the 180 SIP message
phone_setting
.is_deal180 =

received after the 183 SIP message.
0 or 1

0-Disabled
1-Enabled

Features->General
Information->180
Ring Workaround

The default value is 1.
phone_setting
.dialnow_dela
y=

Integer
from 1 to 14

It configures the delay time (in
seconds) for the dial-now rule.
The default value is 1.

Features->General
Information->
Time-Out For
Dial-Now Rule.

It enables or disables customizing the
softkey layout.

phone_setting
.custom_softke

0 or 1

y_enable =

Settings->Softkey

0-Disabled

Layout->Custom

1-Enabled

Softkey

The default value is 0.
It configures headset mode
precedence during a call.
0-Always use (pressing the

phone_setting
.headsetkey_
mode =

0 or 1

speakerphone key and picking up the
handset are not effective when the
headset mode is activated)
1-Use as normal
The default value is 1.

113

Yealink SIP-T4X IP Phones Auto Provisioning Guide

It configures emergency numbers.
phone_setting
.emergency.n
umber =

Phone
number

Emergency numbers are separated by

Features->Phone

comma.

Lock->Emergency

The default value is 120, 911 and 110.
It enables or disables T9 predictive

phone_setting
.search_when
_dialing_enab

text in the dialing screen.
0 or 1

0-Disabled
1-Enabled

le =

The default value is 0.
It enables or disables recent call in
dialing feature.
If it is enabled, you can view the
super_search.
recent_call =

0 or 1

placed calls list when the phone is in
the pre-dialing screen.
0-Disabled
1-Enabled
The default value is 0.

Enables or disables the downgrade
of phone firmware from provisioning
server.
auto_provision
.downgrade_

0 or 1

enable =

0-Disabled
1-Enabled
If it is enabled, you can downgrade
phone firmware from the provisioning
server.

firmware.url =

URL

ringtone.url =

URL

ringtone.delet
e=
gui_lang.url =

gui_lang.delet
e=

114

URL

URL

It configures the access URL of
firmware file.
It configures the access URL of the
customized ringtone file.
It deletes all customized ringtone files.
The valid value is: http://localhost/all.
It configures the access URL of the
language file.
It deletes all customized language

URL

files.
The valid value is: http://localhost/all.

Directory->
Setting->Recent
Call In Dialing

Appendix

lcd_logo.url =
(for
SIP-T42G/T41P

URL

It configures the access URL of
customized logo file.

only)
lcd_logo.dele
te =
(for

URL

SIP-T42G/T41P

It deletes all customized logo files.
The valid value is: http://localhost/all.

only)
wallpaper_upl
oad.url =
(for SIP-T46G

URL

It configures the access URL of the
wallpaper image.

only)
trusted_certific
ates.url =
trusted_certific
ates.delete =
server_certific
ates.url =
server_certific
ates.delete =
local_contact.
data.url =
auto_dst.url =
dialplan_dialn
ow.url =
dialplan_repl
ace_rule.url =

URL

URL

url =

certificate files.
The valid value is: http://localhost/all.

URL

It configures the access URL of the
server certificate file.
It deletes all uploaded server

URL

certificate files.
The valid value is: http://localhost/all.

URL

URL

URL

URL

URL

n.url =
configuration.

trusted certificate file.
It deletes all uploaded trusted

custom_factor
y_configuratio

It configures the access URL of the

URL

It configures the access URL of the
local contact file.
It configures the access URL of the DST
Time file.
It configures the access URL of the
dial-now rule file.
It configures the access URL of the
replace rule file.
It configures the access URL of the
customized factory configuration file.
It configures the access URL of the
customized configuration file.

115

Yealink SIP-T4X IP Phones Auto Provisioning Guide

It configures the access URL of the call
call_list.url =

URL

list.
It takes effect after reboot.

openvpn.url =
custom_mac_
cfg.url =

URL

URL

It configures the access URL of the
openVPN *.tar file.
It configures the access URL of the
custom MAC-Oriented CFG file.

local_contact.
data_photo_t
ar.url =

URL

(for SIP-T46G

It configures the access URL of the
local contact photo.

only)
It configures the access URL of the file,
web_item_lev
el.url =

URL

which defines 3-level access
permissions for web user interface.
It takes effect after reboot.

directory_setti
ng.url =
super_search.
url =

URL

URL

It configures the access URL of the
directory setting file.
It configures the access URL of the
Search Source List setting file.

account.X.ena
ble =
It enables or disables the account X.

(SIP-T46G: X
ranges from 1
to 6.

0 or 1

SIP-T42G/T41P:

0-Disabled

Account->Register

1-Enabled

->Line Active

The default value is 0.

X ranges from
1 to 3.)
account.X.lab
el =
(SIP-T46G: X
ranges from 1
to 6.

It configures the label displayed on the
String

LCD screen for account X.
The default value is blank.

SIP-T42G/T41P:

Account->Register
->Label

X ranges from
1 to 3.)
account.X.dis
play_name =
(SIP-T46G: X
116

String

It configures the display name for

Account->Register

account X.

->Display Name

Appendix
The default value is blank.

ranges from 1
to 6.
SIP-T42G/T41P:
X ranges from
1 to 3.)
account.X.aut
h_name =
(SIP-T46G: X
ranges from 1
to 6.

It configures the user name for register
String

authentication for account X.
The default value is blank.

SIP-T42G/T41P:

Account->Register
-> Register Name

X ranges from
1 to 3.)
account.X.pas
sword =
(SIP-T46G: X
ranges from 1
to 6.

It configures the password for register
String

authentication for account X.
The default value is blank.

SIP-T42G/T41P:

Account->Register
->Password

X ranges from
1 to 3.)
account.X.use
r_name =
(SIP-T46G: X
ranges from 1
to 6.

It configures the register user name for
String

account X.
The default value is blank.

SIP-T42G/T41P:

Account->Register
-> User Name

X ranges from
1 to 3.)
account.X.sip_
server.Y.addre
ss =
(SIP-T46G: X
ranges from 1

IP address

to 6.

or domain

SIP-T42G/T41P:

name

It configures the IP address or domain
name of server Y for account X.

Account->Register
->SIP Server Y
->Server Host

X ranges from
1 to 3.
Y ranges from
1 to 2.)

117

Yealink SIP-T4X IP Phones Auto Provisioning Guide

account.X.sip_
server.Y.port =
(SIP-T46G: X
ranges from 1
to 6.
SIP-T42G/T41P:
X ranges from

Integer
from 1 to
65535

It configures the port of server Y for

Account->Register

account X.

->SIP Server Y

The default value is 5060.

->Port

1 to 3.
Y ranges from
1 to 2.)
account.X.sip_
server.Y.expire
s=
(SIP-T46G: X
ranges from 1
to 6.
SIP-T42G/T41P:

Integer
from 30 to
2147483647

X ranges from

It configures the registration expiration
time (in seconds) to SIP server Y for
account X.
The default value is 3600.

Account->Register
->SIP Server Y
->Server Expires

1 to 3.
Y ranges from
1 to 2.)
account.X.sip_
server.Y.retry_
counts =

It configures the times for the phone to

(SIP-T46G: X
ranges from 1
to 6.
SIP-T42G/T41P:

Integer
from 0 to 20

X ranges from

retransmit the request when the SIP

Account->Register

server Y is unavailable or there is no

->SIP Server Y

respond from the SIP server Y for

->Server Retry

account X.

Counts

The default value is 3.

1 to 3.
Y ranges from
1 to 2.)

It configures the transport type for

account.X.tran

account X.

sport =

0-UDP

(SIP-T46G: X
ranges from 1
to 6.
SIP-T42G/T41P:
X ranges from
1 to 3.)

118

1-TCP
0, 1, 2 or 3

2-TLS
3-DNS-NAPTR
If it is set to 3 (DNS-NAPTR) and no
server port is given, the phone
performs the DNS NAPTR and SRV

Account->Register
->Transport

Appendix
queries for the transport protocol, port
and IP address.
The default value is 0.
account.X.nap
I t specifies the transport protocol the

tr_build =

phone constructs the SRV query for

(SIP-T46G: X
ranges from 1
to 6.

when no NAPTR records are returned.
0 or 1

0-UDP

SIP-T42G/T41P:

1-Multiple Types

X ranges from

The default value is 0.

1 to 3.)
It configures the registration mode for

account.X.fall

the phone in fallback mode.

back.redunda

0-Concurrent registration: the phone

ncy_type =

registers to the working server and

(SIP-T46G: X
ranges from 1

0 or 1

to 6.

fallback server at the same time.
1-Successive registration: the phone
registers to the working server first.

SIP-T42G/T41P:

When the working server fails, the

X ranges from

phone registers to the fallback server.

1 to 3.)

The default value is 0.

account.X.fall

It configures the time interval (in

back.timeout

seconds) for the phone to detect

=

whether the working server is

(SIP-T46G: X
ranges from 1
to 6.

Integer
from 10 to
2147483647

available by sending the registration
request after the fallback server takes
over the call control.

SIP-T42G/T41P:

It is only applicable to the successive

X ranges from

registration mode.

1 to 3.)

The default value is 120.

account.X.sip_

It configures the way in which the

server.Y.failba

phone fails back to the primary server

ck_mode =

for call control when in the failover

(SIP-T46G: X

mode.

ranges from 1
to 6.

0, 1, 2, or 3

0-newRequests: all requests are
forwarded to the primary server first,

SIP-T42G/T41P:

regardless of the secondary server

X ranges from

that was used.

1 to 3.

1-DNSTTL: the phone will retry to use

Y ranges from

the primary server after the timeout of

119

Yealink SIP-T4X IP Phones Auto Provisioning Guide
1 to 2.)

the DNSTTL configured for the SIP
server.
2-registration: the phone will retry to
use the primary server when the SIP
server’s registration requires renewal.
3-duration: the phone will retry to use
the primary server after the timeout
defined by the parameter
“account.x.failback_timeout”.
The default value is 0.
It configures the time interval (in
seconds) for the phone to detect
whether the primary server is

account.X.sip_

available by sending the registration

server.Y.failba

request after the secondary server

ck_timeout =

takes over the call control.

(SIP-T46G: X

If the value is configured to 0, the IP

ranges from 1

Integer

to 6.

from 0 to

SIP-T42G/T41P:

65535

phone does not detect the primary
server until a failover occurs.
When the value is configured between

X ranges from

1 and 59, the phone automatically sets

1 to 3.

the time interval to 60.

Y ranges from

Note: This parameter is only valid

1 to 2.)

when the parameter
“account.X.sip_server.Y.failback_mode
” is configured to 3.
The default value is 3600.

account.x.sip_
server.y.regist
er_on_enable

It enables or disables the IP phone to

=

register to the secondary server before

(SIP-T46G: X
ranges from 1
to 6.

sending requests to the secondary
0 or 1

server in the failover mode.
0-Disabled

SIP-T42G/T41P:

1-Enabled

X ranges from

The default value is 0.

1 to 3.
Y ranges from
1 to 2.)
account.X.out
bound_proxy_
120

0 or 1

It enables or disables the phone to use

Account->Register

the outbound proxy server for account

->Enable

Appendix
enable =

X.

Outbound Proxy

(SIP-T46G: X

0-Disabled

Server

ranges from 1

1-Enabled

to 6.

The default value is 0.

SIP-T42G/T41P:
X ranges from
1 to 3.)
account.X.out
bound_host =
(SIP-T46G: X
ranges from 1
to 6.

IP address
or domain
name

SIP-T42G/T41P:

It configures the domain name or IP
address of the outbound proxy server
for account X.
The default value is blank.

Account->Register
->Outbound Proxy
Server

X ranges from
1 to 3.)
account.X.out
bound_port =
(SIP-T46G: X
ranges from 1
to 6.
SIP-T42G/T41P:

Integer
from 1 to
65535

It configures the port of the outbound

Account->Register

proxy server for account X.

->Outbound Proxy

The default value is 5060.

Server->Port

It configures the voice mail number for

Account->

account X.

Advanced->Voice

The default value is blank.

Mail

X ranges from
1 to 3.)
voice_mail.nu
mber.X =
(SIP-T46G: X
ranges from 1
to 6.

String

SIP-T42G/T41P:
X ranges from
1 to 3.)
account.X.pro
xy_require =
(SIP-T46G: X
ranges from 1
to 6.

It configures the proxy server for
String

account X.
The default value is blank.

SIP-T42G/T41P:

Account->Basic->
Proxy Require

X ranges from
1 to 3.)
account.X.sip_

0 or 1

It enables or disables the phone to
121

Yealink SIP-T4X IP Phones Auto Provisioning Guide
trust_ctrl =

only accept the message from the

(SIP-T46G: X

trusted server for account X.

ranges from 1

0-Disabled

to 6.

1-Enabled

SIP-T42G/T41P:

The default value is 0.

X ranges from
1 to 3.)
account.X.ano
nymous_call =

It enables or disables anonymous call

(SIP-T46G: X
ranges from 1
to 6.

feature for account X.
0 or 1

0-Disabled
1-Enabled

SIP-T42G/T41P:

Account->Basic->
Anonymous Call

The default value is 0.

X ranges from
1 to 3.)
account.X.sen
d_anonymous

Enables or disables anonymous

_code =

code feature for account x.

(SIP-T46G: X
ranges from 1

0 or 1

to 6.

If set to 1 (Enabled), the IP phone

Account->Basic->

sends anonymous code to

Anonymous Code

activate/deactivate the server-side

SIP-T42G/T41P:

anonymous call feature.

X ranges from
1 to 3.)
account.X.ano
nymous_call_o
ncode =
(SIP-T46G: X
ranges from 1

String

to 6.

It configures the code for activating

Account->Basic->

anonymous call feature for account X.

Anonymous

The default value is blank.

Call->On Code

It configures the code for deactivating

Account->Basic->

anonymous call feature for account X.

Anonymous

The default value is blank.

Call->Off Code

SIP-T42G/T41P:
X ranges from
1 to 3.)
account.X.ano
nymous_call_o
ffcode =
(SIP-T46G: X
ranges from 1
to 6.
SIP-T42G/T41P:

122

String

Appendix
X ranges from
1 to 3.)
account.X.reje
ct_anonymous
It enables or disables anonymous call

_call =

rejection feature for account X.

(SIP-T46G: X

Account->Basic->

0-Disabled

Anonymous Call

to 6.

1-Enabled

Rejection

SIP-T42G/T41P:

The default value is 0.

ranges from 1

0 or 1

X ranges from
1 to 3.)
account.X.ano
nymous_reject
_oncode =
(SIP-T46G: X
ranges from 1

String

to 6.
SIP-T42G/T41P:

It configures the code for activating

Account->Basic->

anonymous call rejection feature for

Anonymous Call

account X.

Rejection->On

The default value is blank.

Code

It configures the code for deactivating

Account->Basic->

anonymous call rejection feature for

Anonymous Call

account X.

Rejection->Off

The default value is blank.

Code

X ranges from
1 to 3.)
account.X.ano
nymous_reject
_offcode =
(SIP-T46G: X
ranges from 1

String

to 6.
SIP-T42G/T41P:
X ranges from
1 to 3.)
account.X.dnd
.enable =

It enables or disables DND feature for

(SIP-T46G: X

account X when the DND mode is

ranges from 1

configured to “custom”.
0 or 1

Features->Forward
& DND->DND

0-Enabled

->Account->DND

SIP-T42G/T41P:

1-Disabled

Status

X ranges from

The default value is 0.

to 6.

1 to 3.)
account.X.dnd
.on_code =
(SIP-T46G: X

String

It configures the DND on code for

Features->Forward

account X when the DND mode is

& DND->DND->

configured to “custom”.

DND On Code

123

Yealink SIP-T4X IP Phones Auto Provisioning Guide
The default value is blank.

ranges from 1
to 6.
SIP-T42G/T41P:
X ranges from
1 to 3.)
account.X.dnd
.off_code =
(SIP-T46G: X

It configures the DND off code for

ranges from 1

account X when the DND mode is

to 6.

String

configured to “custom”.
The default value is blank.

SIP-T42G/T41P:

Features->Forward
& DND->DND
->DND Off Code

X ranges from
1 to 3.
account.X.alw
ays_fwd.enab

It enables or disables always forward

le =

feature for account X when the call
forward mode is configured to

(SIP-T46G: X
ranges from 1

0 or 1

“custom”.

to 6.

0-Enabled

SIP-T42G/T41P:

1-Disabled

X ranges from

The default value is 0.

Features->Forward
& DND->Always
Forward->On/Off

1 to 3. )
account.X.alw
ays_fwd.targe
t=

It configures the target number the

(SIP-T46G: X
ranges from 1

String

to 6.

phone forwards all incoming calls to
for account X.
The default value is blank.

SIP-T42G/T41P:

Features->Forward
& DND->Always
Forward->Target

X ranges from
1 to 3. )
account.X.bus
y_fwd.enable

It enables or disables busy forward

=

feature for account X when the call
forward mode is configured to

(SIP-T46G: X
ranges from 1
to 6.

0-Disabled

SIP-T42G/T41P:

1-Enabled

X ranges from

The default value is 0.

1 to 3. )

124

0 or 1

“custom”.

Features->Forward
& DND->Busy
Forward->On/Off

Appendix

account.X.bus
y_fwd.target

It configures the target number the

=

phone forwards incoming calls to

(SIP-T46G: X
ranges from 1

String

to 6.

when busy for account X when the call
forward mode is configured to
“custom”.

SIP-T42G/T41P:

Features->Forward
& DND->Busy
Forward->Target

The default value is blank.

X ranges from
1 to 3. )
account.X.tim
eout_fwd.ena

It enables or disables no answer

ble =

forward feature for account X when

(SIP-T46G: X

the call forward mode is configured to

Features->Forward

“custom”.

& DND->No

ranges from 1

0 or 1

to 6.

0-Disabled

SIP-T42G/T41P:

1-Enabled

X ranges from

The default value is 0.

Answer Forward->
On/Off

1 to 3. )
account.X.tim
eout_fwd.targ

It configures the target number the

et =
(SIP-T46G: X
ranges from 1

String

to 6.
SIP-T42G/T41P:

phone forwards incoming calls to after

Features->Forward

a period of ring time for account X

& DND->No

when the call forward mode is

Answer Forward->

configured to “custom”.

Target

The default value is blank.

X ranges from
1 to 3. )
account.X.tim
eout_fwd.time
out =
(SIP-T46G: X
ranges from 1
to 6.

It configures the waiting ring time
Integer
from 0 to 20

before forwarding for account X when
the call forward mode is configured to
“custom”.
The default value is 2.

SIP-T42G/T41P:

Features->Forward
& DND->No
Answer Forward->
After Ring Times

X ranges from
1 to 3. )
account.X.alw

It configures the always forward off

Features->Forward

ays_fwd.off_c

code for account X when the call

& DND->Always

forward mode is configured to

Forward ->Off

“custom”.

Code

ode =
(SIP-T46G: X

String

125

Yealink SIP-T4X IP Phones Auto Provisioning Guide
The default value is blank.

ranges from 1
to 6.
SIP-T42G/T41P:
X ranges from
1 to 3. )
account.X.alw
ays_fwd.on_c
ode =

It configures the always forward on

(SIP-T46G: X

code for account X when the call

ranges from 1

String

forward mode is configured to

to 6.

“custom”.

SIP-T42G/T41P:

The default value is blank.

Features->Forward
& DND->Always
Forward->On
Code

X ranges from
1 to 3. )
account.X.bus
y_fwd.off_cod
e=
(SIP-T46G: X
ranges from 1

String

to 6.
SIP-T42G/T41P:

It configures the busy forward off code

Features->Forward

for account X when the call forward

& DND->Busy

mode is configured to “custom”.

Forward ->Off

The default value is blank.

Code

X ranges from
1 to 3. )
account.X.bus
y_fwd.on_cod
e=

It configures the busy forward on code

(SIP-T46G: X
ranges from 1

String

to 6.

for account X when the call forward
mode is configured to “custom”.
The default value is blank.

SIP-T42G/T41P:

Features->Forward
& DND->Busy
Forward->On Call

X ranges from
1 to 3. )
account.X.tim
eout_fwd.off_c

It configures the no answer forward off

ode =
(SIP-T46G: X
ranges from 1
to 6.
SIP-T42G/T41P:
X ranges from

126

code for account X when the call
String

forward mode is configured to
“custom”.
The default value is blank.

Features->Forward
& DND->No
Answer Forward
->Off Code

Appendix
1 to 3. )
account.X.tim
eout_fwd.on_c
ode =

It configures the no answer forward on

(SIP-T46G: X

code for account X when the call

ranges from 1

String

forward mode is configured to

to 6.

“custom”.

SIP-T42G/T41P:

The default value is blank.

Features->Forward
& DND->No
Answer Forward
->On Code

X ranges from
1 to 3. )
account.X.sip_
listen_port =
(SIP-T46G: X
ranges from 1
to 6.
SIP-T42G/T41P:

Integer
from 1024 to
65535

It configures the local SIP port for

Account->

account X.

Advanced->Local

The default value is 5060.

SIP Port

X ranges from
1 to 3. )
account.X.100
rel_enable =

It enables or disables 100 reliable

(SIP-T46G: X
ranges from 1
to 6.

retransmission feature for account X.
0 or 1

SIP-T42G/T41P:

Account->

0-Disabled

Advanced->

1-Enabled

Retransmission

The default value is 0.

X ranges from
1 to 3.)
account.X.sub
scribe_mwi =

It enables or disables the phone to

(SIP-T46G: X

subscribe the message waiting

ranges from 1
to 6.

indicator for account X.
0 or 1

0-Disabled

SIP-T42G/T41P:

1-Enabled

X ranges from

The default value is 0.

Account->
Advanced->
Subscribe for MWI

1 to 3.)
account.X.sub
scribe_mwi_e
xpires =
(SIP-T46G: X
ranges from 1

Integer
from 0 to
84600

It configures the interval (in seconds)
of MWI subscription for account X.
The default value is 3600.

Account->
Advanced->MWI
Subscription Period
(Seconds)

to 6.

127

Yealink SIP-T4X IP Phones Auto Provisioning Guide
SIP-T42G/T41P:
X ranges from
1 to 3. )
It configures the source caller identity
for presentation when receiving an

account.X.cid_

incoming call for account X.

source =

0-FROM

(SIP-T46G: X
ranges from 1
to 6.

0, 1, 2, 3, 4 or
5

1-PAI
2-PAI-FROM

SIP-T42G/T41P:

3-PRID-PAI-FROM

X ranges from

4-PAI-RPID-FROM

1 to 3. )

Account->
Advanced->Caller
ID Source

5-RPID-FROM
The default value is 0.
It enables or disables the phone to
process the Privacy header in the 180

account.X.cid_
source_privac

or 200 OK message.
0 or 1

y=

0-Disabled
1-Enabled
The default value is 1.
It enables or disables the phone to
process the P-Preferred-Identity

account.X.cid_
source_ppi =

header.
0 or 1

0-Disabled
1-Enabled
The default value is 1.

account.X.cp_
It configures the source callee identity

source =

for presentation for account X.

(SIP-T46G: X
ranges from 1
to 6.

0-RPID-FROM
0, 1 or 2

1-Dialed Digits

SIP-T42G/T41P:

2-RFC4916

X ranges from

The default value is 1.

1 to 3. )
account.X.ses

It enables or disables the session timer

sion_timer.ena
ble =
(SIP-T46G: X
ranges from 1
to 6.
128

for account X.
0 or 1

Account->

0-Disabled

Advanced->

1-Enabled

Session Timer

The default value is 0.

Appendix
SIP-T42G/T41P:
X ranges from
1 to 3. )
account.X.ses
sion_timer.exp
ires =
(SIP-T46G: X
ranges from 1
to 6.

Integer
from 30 to
7200

SIP-T42G/T41P:

It configures the interval (in seconds)

Account->

for refreshing the SIP session for

Advanced->

account X.

Session Expires

The default value is 1800.

(30~7200s)

X ranges from
1 to 3. )
account.X.ses
sion_timer.refr
It configures the refresher of the

esher =

session timer for account X.

(SIP-T46G: X

Account->

0-Uac

Advanced->

to 6.

1-Uas

Session Refresher

SIP-T42G/T41P:

The default value is 0.

ranges from 1

0 or 1

X ranges from
1 to 3. )
account.X.ena
ble_user_equ

It enables or disables the

al_phone =

"user=phone" carried in the INVITE

(SIP-T46G: X
ranges from 1

message for account X.
0 or 1

to 6.

0-Disabled
1-Enabled

SIP-T42G/T41P:

Account->
Advanced->Send
user=phone

The default value is 0.

X ranges from
1 to 3. )
account.X.srtp

It configures whether to use voice

_encryption =

encryption service for account X.

(SIP-T46G: X
ranges from 1
to 6.

0-Disabled
0, 1 or 2

1-Optional

SIP-T42G/T41P:

2-Compulsory

X ranges from

The default value is 0.

Account->
Advanced->RTP
Encryption (SRTP)

1 to 3. )
account.X.pti
me =

0 (Disabled),
10, 20, 30,

It configures the RTP packet time (in

Account->

milliseconds) for account X.

Advanced->PTime

129

Yealink SIP-T4X IP Phones Auto Provisioning Guide
(SIP-T46G: X

40, 50 or 60.

The default value is 20.

(ms)

It configures the BLA number for

Account->

account X.

Advanced->BLA

The default value is blank.

Number

It configures the period (in seconds) of

Account->

BLA subscription for account X.

Advanced->BLA

The default value is 300.

Subscription Period

ranges from 1
to 6.
SIP-T42G/T41P:
X ranges from
1 to 3. )
account.X.bla
_number =
(SIP-T46G: X
ranges from 1
to 6.

String

SIP-T42G/T41P:
X ranges from
1 to 3. )
account.X.bla
_subscribe_pe
riod =
(SIP-T46G: X
ranges from 1
to 6.

Integer
from 60 to
7200

SIP-T42G/T41P:
X ranges from
1 to 3. )
account.X.dial
oginfo_callpic

It enables or disables the phone to

kup =

pick up a call according to the SIP

(SIP-T46G: X
ranges from 1

header of dialog-info for account X.
0 or 1

to 6.
SIP-T42G/T41P:

Account->
Advanced->

0-Disabled

Dialog Info Call

1-Enabled

Pickup

The default value is 0.

X ranges from
1 to 3. )
account.X.gro
up_pickup_co
de =
(SIP-T46G: X
ranges from 1
to 6.
SIP-T42G/T41P:
X ranges from

130

String

It configures the group pickup code for

Account->

account X.

Advanced->Group

The default value is blank.

Call Pickup Code

Appendix
1 to 3. )
account.X.dire
ct_pickup_cod
e=
It configures the directed pickup code

(SIP-T46G: X
ranges from 1

String

to 6.

for account X.
The default value is blank.

Account->
Advanced->
Directed Call
Pickup Code

SIP-T42G/T41P:
X ranges from
1 to 3.)
account.X.aut
o_answer =

It enables or disables auto answer

(SIP-T46G: X
ranges from 1
to 6.

feature for account X.
0 or 1

0-Disabled
1-Enabled

SIP-T42G/T41P:

Account->Basic->
Auto Answer

The default value is 0.

X ranges from
1 to 3.)
account.X.mis
sed_calllog =

It enables or disables the phone to

(SIP-T46G: X
ranges from 1
to 6.

record the missed calls of account X.
0 or 1

0-Disabled
1-Enabled

SIP-T42G/T41P:

Account->Basic->
Missed Call Log

The default value is 1.

X ranges from
1 to 3.)
account.X.sub
scribe_mwi_to

It enables or disables the phone to

_vm =

subscribe to the voice mail for the

(SIP-T46G: X
ranges from 1

0 or 1

message waiting indicator for account

Account->

X.

Advanced->

to 6.

0-Disabled

SIP-T42G/T41P:

1-Enabled

X ranges from

The default value is 0.

Subscribe MWI To
Voice Mail

1 to 3.)
account.X.regi

It enables or disables the phone to

ster_mac =

carry the MAC address in the

Account->

REGISTER message for account X.

Advanced->SIP

ranges from 1

0-Disabled

Send MAC

to 6.

1-Enabled

(SIP-T46G: X

0 or 1

131

Yealink SIP-T4X IP Phones Auto Provisioning Guide
The default value is 0.

SIP-T42G/T41P:
X ranges from
1 to 3.)
account.X.regi

It enables or disables the phone to

ster_line =

carry the line number in the REGISTER

(SIP-T46G: X
ranges from 1
to 6.

message for account X.
0 or 1

0-Disabled

SIP-T42G/T41P:

1-Enabled

X ranges from

The default value is 0.

Account->
Advanced->SIP
Send Line

1 to 3.)
account.X.reg
_fail_retry_inte
rval =
(SIP-T46G: X
ranges from 1
to 6.

Integer
from 0 to
1800

SIP-T42G/T41P:

It configures the interval (in seconds)

Account->

for the phone to retry to register

Advanced->SIP

account X when registration fails.

Registration Retry

The default value is 30.

Timer (0~1800s)

X ranges from
1 to 3.)
account.X.con
f_type =

It configures the conference type for

(SIP-T46G: X
ranges from 1
to 6.

account X.
0 or 2

SIP-T42G/T41P:

Account->

0-Local Conference

Advanced->

2-Network Conference

Conference Type

The default value is 0.

X ranges from
1 to 3.)
account.X.con
f_uri =
(SIP-T46G: X
ranges from 1
to 6.

String

SIP-T42G/T41P:

It configures the network conference

Account->

URI for account X.

Advanced->

The default value is blank.

Conference URI

X ranges from
1 to 3.)
account.X.blf.s
ubscribe_peri
od =
(SIP-T46G: X

132

Integer
from 30 to
2147483647

It configures the period (in seconds) of
the BLF subscription for account X.
The default value is 1800.

Appendix
ranges from 1
to 6.
SIP-T42G/T41P:
X ranges from
1 to 3.)
account.X.blf.s
ubscribe_even
t=

It specifies the BLF subscription type.

(SIP-T46G: X
ranges from 1

0 or 1

to 6.

0-Dialog
1-Presence
The default value is 0.

SIP-T42G/T41P:
X ranges from
1 to 3.)
account.X.out
_dialog_blf_en

It enables or disables the phone to

able =

handle NOTIFY messages outside the

(SIP-T46G: X
ranges from 1

BLF dialog.
0 or 1

to 6.

0-Disabled
1-Enabled

SIP-T42G/T41P:

The default value is 0.

X ranges from
1 to 3.)
account.X.sub
scribe_acd_ex
pires =
(SIP-T46G: X
ranges from 1
to 6.

Integer
from 12 to
3600

It configures the period (in seconds) of
ACD subscription for account X.
The default value is 3600.

Account->
Advanced->ACD
Subscrip Period
(120~3600s)

SIP-T42G/T41P:
X ranges from
1 to 3.)
account.X.sip_

It configures the SIP server type for

server_type =

account X.

(SIP-T46G: X

0-Default

ranges from 1
to 6.
SIP-T42G/T41P:
X ranges from
1 to 3.)

0, 2, 4 or 6

Account->

2-BroadSoft

Advanced->SIP

4-Cosmocom

Server Type

6-UCAP
The default value is 0.

133

Yealink SIP-T4X IP Phones Auto Provisioning Guide

account.X.mus
ic_server_uri
=
(SIP-T46G: X
ranges from 1

String

to 6.

It configures the URI of the Music On
Hold server for account X.

Account->
Advanced->Music
Server URI

SIP-T42G/T41P:
X ranges from
1 to 3.)
account.X.dtm

It configures the DTMF type for account

f.type =

X.

(SIP-T46G: X

0-INBAND

ranges from 1
to 6.

0, 1, 2 or 3

SIP-T42G/T41P:

Account->

1-RFC2833

Advanced->DTMF

2-SIP INFO

Type

3-AUTO or SIP INFO

X ranges from

The default value is 1.

1 to 3.)
account.X.dtm
f.dtmf_payloa
d=
(SIP-T46G: X
ranges from 1
to 6.

Integer
from 96 to
127

It configures the RFC2833 payload for
account X.
The default value is 101.

Account->
Advanced->DTMF
Payload Type
(96~127)

SIP-T42G/T41P:
X ranges from
1 to 3.)
account.X.dtm

It configures the DTMF info type when

f.info_type =

the DTMF type is configured as “SIP
INFO” or “AUTO or SIP INFO” for

(SIP-T46G: X
ranges from 1
to 6.

1, 2 or 3

Account->

1-DTMF-Relay

Advanced->DTMF

SIP-T42G/T41P:

2-DTMF

X ranges from

3-Telephone-Event

1 to 3.)

The default value is 1.

account.X.nat.
=
(SIP-T46G: X
ranges from 1
to 6.

Info Type

It enables or disables the NAT

nat_traversal

134

account X.

traversal for account X.
0 or 1

0-Disabled
1-STUN
The default value is 0.

Account->Register
->NAT

Appendix
SIP-T42G/T41P:
X ranges from
1 to 3. )
account.X.nat.
stun_server =
(SIP-T46G: X
ranges from 1
to 6.

IP address
or domain
name

SIP-T42G/T41P:

It configures the domain name or IP
address of the STUN server for account

Account->Register

X.

->STUN Server

The default value is blank.

X ranges from
1 to 3.)
account.X.nat.
stun_port =
(SIP-T46G: X
ranges from 1
to 6.
SIP-T42G/T41P:

Integer
from 1 to
65535

It configures the port of the STUN

Account->Register

server for account X.

->STUN Server

The default value is 3478.

->Port

X ranges from
1 to 3.)
account.X.nat.
It enables or disables NAT keep-alive

udp_update_e

for account X.

nable =

0-Disabled

(SIP-T46G: X

Account->

1-Default

Advanced->Keep

to 6.

2-Options

Alive Type

SIP-T42G/T41P:

3-Notify

X ranges from

The default value is 1.

ranges from 1

0, 1, 2 or 3

1 to 3.)
account.X.nat.
udp_update_ti
me =
(SIP-T46G: X
ranges from 1
to 6.

Integer

It configures the keep-alive interval (in

from 15 to

seconds) for account X.

2147483647

The default value is 30.

Account->
Advanced->Keep
Alive Interval
(Seconds)

SIP-T42G/T41P:
X ranges from
1 to 3.)
It enables or disables NAT Rport

account.X.nat.
rport =
(SIP-T46G: X

0 or 1

feature for account X.
0-Disabled

Account->
Advanced->Rport

135

Yealink SIP-T4X IP Phones Auto Provisioning Guide
ranges from 1

1-Enabled

to 6.

The default value is 0.

SIP-T42G/T41P:
X ranges from
1 to 3. )
account.X.adv
anced.timer_t
1=
It configures the session timer T1 (in

(SIP-T46G: X
ranges from 1

Float

to 6.

seconds) for account X.
The default value is 0.5.

Account->
Advanced->SIP
Session Timer T1
(0.5~10s)

SIP-T42G/T41P:
X ranges from
1 to 3. )
account.X.adv
anced.timer_t
2=
It configures the session timer T2 (in

(SIP-T46G: X
ranges from 1

Float

to 6.

seconds) for account X.
The default value is 4.

Account->
Advanced->SIP
Session Timer T2
(2~40s)

SIP-T42G/T41P:
X ranges from
1 to 3. )
account.X.adv
anced.timer_t
4=
It configures the session timer T4 (in

(SIP-T46G: X
ranges from 1

Float

to 6.

seconds) for account X.
The default value is 5.

Account->
Advanced->SIP
Session Timer T4
(2.5~60s)

SIP-T42G/T41P:
X ranges from
1 to 3.)
account.X.aler
t_info_url_ena

It enables or disables the distinctive

ble =
(SIP-T46G: X
ranges from 1
to 6.
SIP-T42G/T41P:
X ranges from

136

ring tones by the Alert-Info SIP header.
0 or 1

0-Disabled
1-Enabled
The default value is 1.

Account->
Advanced->
Distinctive Ring
Tones

Appendix
1 to 3.)
account.X.ring

It configures a ringtone for account X.

tone.ring_type
=

Common,

(SIP-T46G: X

Ring1.wav,

ranges from 1

Ring2.wav,

to 6.
SIP-T42G/T41P:

…
Ring8.wav

Example (configure Ring3.wav for
account 1):
account.1.ringtone.ring_type =

Account->Basic->

Ring3.wav

Ring Type

The default value is common.
Note: Ring 6-8 are applicable to the

X ranges from

SIP-T46G IP phone only.

1 to 3.)

It configures the codec for account X.
The default value is:
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;
PCMU
account.X.cod
ec.Y.payload_
type =
(SIP-T46G: X
ranges from 1

PCMA
G729
G722
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

to 6. Y ranges

G723_63

G726_16;

from 1 to 12.

G726_16

When Y=9, the default value is

SIP-T42G/T41P:

G726_24

G726_24;

X ranges from

G726_32

When Y=10, the default value is

1 to 3. Y
ranges from 1
to 14.)

G726_40
iLBC
GSM

Account->Codecs

G726_32;
When Y=11, the default value is
G726_40;
For T46G:
When Y=12, the default value is GSM.
For T42G and T41P:
When Y=14, the default value is GSM.
Example:
account.1.codec.2.payload_type =
PCMA
It enables or disables the specified

account.X.cod
ec.Y.enable =
(SIP-T46G: X

0 or 1

codec for account X.

Account->Codecs

0-Disabled
137

Yealink SIP-T4X IP Phones Auto Provisioning Guide
ranges from 1

1-Enabled

to 6. Y ranges

Example:

from 1 to 12.

account.1.codec.2.enable = 1

SIP-T42G/T41P:

This means that the codec PCMA is

X ranges from

enabled on the phone.

1 to 3. Y
ranges from 1
to 14.)
account.X.cod
ec.Y.priority =
(SIP-T46G: X

It configures the priority of the enabled

ranges from 1

codec for account X.

to 6. Y ranges
from 1 to 12.
SIP-T42G/T41P:

Integer
from 0 to 13

Example:
account.1.codec.2.priority = 2

Account->Codecs

This means that the priority of the

X ranges from

codec PCMA is 2.

1 to 3. Y
ranges from 1
to 14.)
account.X.cod
ec.Y.rtpmap =
(SIP-T46G: X
ranges from 1
to 6. Y ranges
from 1 to 12.
SIP-T42G/T41P:

Integer
from 0 to 127

It configures rtpmap of the audio
codec for account X.

X ranges from
1 to 3. Y
ranges from 1
to 14.)
account.X.unr
egister_on_re
It enables or disables the phone to

boot =

de-register account X before reboot.

(SIP-T46G: X
ranges from 1

0 or 1

0-Disabled

to 6.

1-Enabled

SIP-T42G/T41P:

The default value is 0.

X ranges from
1 to 3.)
account.X.co
mpact_heade

138

0 or 1

It enables or disables the phone to
support compact SIP header for

Account->
Advanced->
Unregister When
Reboot

Appendix
r_enable =

account X.

(SIP-T46G: X

The default value is 0.

ranges from 1
to 6.
SIP-T42G/T41P:
X ranges from
1 to 3.)
account.X.mus

It configures the way on how the

ic_on_hold_ty

phone processes Music On Hold when

pe =

placing an active call on hold.

(SIP-T46G: X
ranges from 1

0 or 1

to 6.

0-Calling the music server before
holding
1- Calling the music server after

SIP-T42G/T41P:

holding

X ranges from

The default value is 1.

1 to 3.)
account.X.acd
.enable =

It enables or disables ACD feature for

(SIP-T46G: X
ranges from 1
to 6.

account X.
0 or 1

0-Disabled
1-Enabled

SIP-T42G/T41P:

The default value is 0.

X ranges from
1 to 3.)
account.X.acd

It enables or disables the phone to

.available =

display the available and unavailable

(SIP-T46G: X
ranges from 1
to 6.

soft keys after the phone logs into the
0 or 1

ACD system.
0-Disabled

SIP-T42G/T41P:

1-Enabled

X ranges from

The default value is 0.

1 to 3.)
account.X.acd
.unavailable_r

It enables or disables the call center

eason_enable
=
(SIP-T46G: X
ranges from 1
to 6.

unavailable reason code feature.
0 or 1

0-Disabled
1-Enabled
The default value is 0.

SIP-T42G/T41P:

139

Yealink SIP-T4X IP Phones Auto Provisioning Guide
X ranges from
1 to 3.)
account.X.acd
.initial_state =

It specifies the initial call center agent

(SIP-T46G: X
ranges from 1
to 6.

state.
1 or 2

1-Avaliable
2-Unavailable

SIP-T42G/T41P:

The default value is 1.

X ranges from
1 to 3.)
account.X.stat
ic_cache_pri

It configures whether preferentially to

=

use the DNS cache for domain name
resolution of the SIP server.

(SIP-T46G: X
ranges from 1

0 or 1

0-Use Domain name server

to 6.

preferentially

SIP-T42G/T41P:

1-Use DNS cache preferentially

X ranges from

The default value is 1.

1 to 3.)
account.X.pict
ure_info_enab

It enables or disables the phone to

le =

download the picture information.

(SIP-T46G: X

0-Disabled

ranges from 1

0 or 1

1-Enabled

to 6.

The default value is 0.

SIP-T42G/T41P:

It is applicable to the SIP-T46G IP

X ranges from

phone only.

1 to 3.)
account.X.init_
register_auth_

It enables or disables the phone to

enable =

carry the authentication header in the

(SIP-T46G: X

first REGISTER message when

ranges from 1

registering an account.

to 6.

0-Disabled

SIP-T42G/T41P:

1-Enabled

X ranges from

The default value is 0.

1 to 3.)

140

0 or 1

Appendix

We are striving to improve our documentation quality and we appreciate your feedback. Email your
opinions and comments to DocsFeedback@yealink.com.

141



Source Exif Data:
File Type                       : PDF
File Type Extension             : pdf
MIME Type                       : application/pdf
PDF Version                     : 1.5
Linearized                      : No
Page Count                      : 149
Language                        : zh-CN
Tagged PDF                      : Yes
Author                          : 微软用户
Creator                         : Microsoft® Office Word 2007
Create Date                     : 2013:10:14 10:08:10+08:00
Modify Date                     : 2013:10:14 10:08:10+08:00
Producer                        : Microsoft® Office Word 2007
EXIF Metadata provided by EXIF.tools

Navigation menu