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
.
Page Count: 149
| Download | |
| Open PDF In Browser | View 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 2007EXIF Metadata provided by EXIF.tools