Yealink SIP-T20P, SIP-T41P, SIP-T48G, SIP-T46G, SIP-T42G User Manual

...

Table of Contents

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

Summary of Changes.............................................................. vii

Changes for Release 73, Guide Version 73.40 ................................................................. vii

Changes for Release 73, Guide Version 73.16 ................................................................. vii

Changes for Release 72, Guide Version 72.30 ................................................................. vii

Changes for Release 72, Guide Version 72.2 .................................................................. viii

Changes for Release 72, Guide Version 72.1 .................................................................. viii

Changes for Release 71, Guide Version 71.165 .............................................................. viii

Changes for Release 71, Guide Version 71.140 ................................................................ix

Changes for Release 71, Guide Version 71.125 ................................................................ix

Changes for Release 71, Guide Version 71.120 ................................................................ix

Changes for Release 71, Guide Version 71.110 ................................................................ix

Changes for Release 70, Guide Version 1.3 ...................................................................... x

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

Getting Started ......................................................................... 3

Obtaining Configuration Information ................................................................................ 3

Obtaining Configuration Files ......................................................................................... 3

Obtaining Phone Information .......................................................................................... 5

Managing Configuration Files ............................................................................................ 5

Editing Common CFG File ................................................................................................ 5

Editing MAC-Oriented CFG File...................................................................................... 9

Managing MAC-local CFG File..................................................................................... 11

Encrypting Configuration Files ...................................................................................... 14

Customizing Resource Files ............................................................................................ 15

Configuring a TFTP Server ...................................................... 35

Preparing a Root Directory ................................................................................................ 35

Configuring a TFTP Server ................................................................................................. 36

Obtaining the Provisioning Server Address .......................... 37

Zero Touch ........................................................................................................................... 37

iii

Yealink IP Phones Auto Provisioning Guide

Plug and Play (PnP) Server ............................................................................................... 39

DHCP Options ..................................................................................................................... 40

Phone Flash ......................................................................................................................... 42

Configuring Wildcard of the Provisioning Server URL.................................................... 43

Configuring the Update Mode .............................................. 45

Power On ............................................................................................................................. 45

Repeatedly.......................................................................................................................... 46

Weekly ................................................................................................................................. 47

Auto Provision Now ............................................................................................................ 48

Multi-mode Mixed ............................................................................................................. 49

SIP NOTIFY Message ......................................................................................................... 49

Auto Provisioning via Activation Code ............................................................................ 50

Downloading and Verifying Configurations .......................... 53

Downloading Configuration Files ..................................................................................... 53

Resolving and Updating Configurations ......................................................................... 53

Downloading and Updating <MAC>-local.cfg File...................................................... 54

Verifying Configurations .................................................................................................... 54

Specific Scenarios-Protect Personalized Settings ........................................................... 56

Configuration Parameters .............................................................................................. 56

Scenario A Protect personalized settings .................................................................... 57

Scenario B Clear personalized configuration settings ............................................... 61

Scenario C Protect personalized settings after factory reset .................................... 62

Scenario D Import or export the local configuration file ............................................ 64

Troubleshooting ...................................................................... 67

Glossary .................................................................................. 69

Appendix ................................................................................ 71

Configuring an FTP Server ................................................................................................ 71

Preparing a Root Directory ............................................................................................ 71

Configuring an FTP Server ............................................................................................. 72

Configuring an HTTP Server .............................................................................................. 75

Preparing a Root Directory ............................................................................................ 75

Configuring an HTTP Server .......................................................................................... 76

Configuring a DHCP Server .............................................................................................. 79

Table of Contents

Customizing a Ring Tone Using Cool Edit Pro ................................................................. 85

Customizing a Logo File Using PictureExDemo .............................................................. 87

Configurations Defined Never be Saved to <MAC>-local.cfg file ............................. 88

Auto Provisioning Flowchart (Protect personalized configuration settings)................ 96

Description of Configuration Parameters in CFG Files .................................................. 97

Programmable Keys ........................................................................................................ 383

Time Zones ........................................................................................................................ 385

BLF LED Mode ................................................................................................................... 388

Yealink IP Phones Auto Provisioning Guide

Summary of Changes

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

This version is updated to remove SIP-T21P and SIP-T19P IP phones. The following section

is new for this version:

 Configurations Defined Never be Saved to <MAC>-local.cfg file on page 88

Major updates have occurred to the following sections:

 Managing MAC-local CFG File on page 11

 Customizing Resource Files on page 15

 Specific Scenarios on page 56

 Description of Configuration Parameters in CFG Files on page 97

 Programmable Keys on page 383

 Time Zones on page 385

The following sections are new for this version:

 Configuring Wildcard of the Provisioning Server URL on page 43

 Auto Provisioning via Activation Code on page 50

 Downloading and Updating <MAC>-local.cfg File on page 54

Major updates have occurred to the following sections:

 Managing MAC-local CFG File on page 11

 Specific Scenarios on page 56

 Description of Configuration Parameters in CFG Files on page 97

This version is updated to remove SIP-T4X, SIP-T21P and SIP-T19P IP phones. The following

sections are new for this version:

 Managing MAC-local CFG File on page 11

 Specific Scenarios on page 56

vii

Yealink IP Phones Auto Provisioning Guide

 Auto Provisioning Flowchart (Protect personalized configuration settings) on page

Major updates have occurred to the following sections:

 Obtaining Configuration Files on page 3

 Downloading Configuration Files on page 53

 Resolving and Updating Configurations on page 53

 Description of Configuration Parameters in CFG Files on page 97

This version is updated to incorporate SIP-T48G IP phones. The following sections are

new for this version:

 Customizing a Directory Template on page 30

 Customizing a Super Search Template on page 31

Major updates have occurred to the following sections:

 Editing Common CFG File on page 5

 Editing MAC-Oriented CFG File on page 9

 Customizing Resource Files on page 15

 Description of Configuration Parameters in CFG Files on page 97

 BLF LED Mode on page 388

This version is updated to incorporate SIP-T46G, SIP-T42G and SIP-T41P IP phones. The

following sections are new for this version:

 Time Zones on page 385

 BLF LED Mode on page 388

Major updates have occurred to the following sections:

 Editing Common CFG File on page 5

viii

 Editing MAC-Oriented CFG File on page 9

 Customizing Resource Files on page 15

 Description of Configuration Parameters in CFG Files on page 97

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

Summary of Changes

added.

Major updates have occurred to the following sections:

 Editing Common CFG File on page 5

 Editing MAC-Oriented CFG File on page 9

 Encrypting Configuration Files on page 14

 Customizing a Language on page 16

 Customizing a Local Contact File on page 24

 Description of Configuration Parameters in CFG Files on page 97

Major updates have occurred to the following section:

 Customizing a Language on page 16

Major updates have occurred to the following section:

 Description of Configuration Parameters in CFG Files on page 97

The following sections are new for this version:

 Encrypting Configuration Files on page 14

 SIP NOTIFY Message on page 49

 Resolving and Updating Configurations on page 53

 Description of Configuration Parameters in CFG Files on page 97

Major updates have occurred to the following sections:

 Customizing a Local Contact File on page 24

 Customizing a Replace Rule File on page 28

 Customizing a Dial-now File on page 29

Yealink IP Phones Auto Provisioning Guide

The following sections are new for this version:

 Customizing a Replace Rule File on page 28

 Customizing a Dial-now File on page 29

Major updates have occurred to the following sections:

 Customizing a Local Contact File on page 24

 Upgrading Firmware on page 33

Introduction

The auto provisioning process outlined in this guide applies to Yealink SIP-T28P/T26P/T22P/T20P/T4X IP phones running firmware version X.73.0.1 or later. We recommend that IP phones running the latest firmware CANNOT be downgraded to an earlier firmware version. The new firmware is compatible with old configuration parameters, but not vice versa.

Yealink IP phones are full-featured telephones that can be plugged directly into an IP

network and can be used easily without manual configuration.

This guide provides instructions on how to provision Yealink IP phones with the minimum

settings required. Yealink IP phones support FTP, TFTP, HTTP, and HTTPS protocols for auto

provisioning and are configured by default to use the TFTP protocol.

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

phones, including:

 Yealink SIP-T28P

 Yealink SIP-T26P

 Yealink SIP-T22P

 Yealink SIP-T20P

 Yealink SIP-T48G

 Yealink SIP-T46G

 Yealink SIP-T42G

 Yealink SIP-T41P

Yealink IP Phones Auto Provisioning Guide

Getting Started

Phone Model

Common CFG File

SIP-T28P

y000000000000.cfg

SIP-T26P

y000000000004.cfg

SIP-T22P

y000000000005.cfg

SIP-T20P

y000000000007.cfg

SIP-T48G

y000000000035.cfg

This section provides instructions on how to get ready for auto provisioning. The auto

provisioning process discussed in this guide uses the TFTP server as the provisioning

server.

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

 Obtaining Configuration Information

 Managing Configuration Files

Before beginning provisioning, you need to obtain configuration files. There are two

configuration files both of which are CFG-formatted. We call these two files Common

CFG file and MAC-Oriented CFG file. The IP phone tries to download these CFG files

from the server during auto provisioning.

IP phones also support a local configuration file named as <MAC>-local.cfg. When a

user modifies configurations via web user interface or phone user interface, the

configurations will be automatically saved to the MAC-local CFG file on the IP phone.

The MAC-Oriented and MAC-local CFG files are only effectual for the specific phone.

They use the 12-digit MAC address of the IP phone as the file name. For example, if the

MAC address of the IP phone is 0015651130f9, the MAC-Oriented CFG and MAC-local

CFG files have to be named as 0015651130f9.cfg and 0015651130f9-local.cfg

respectively. However, the Common CFG file is effectual for all phones of the same

model. It uses a fixed name “y0000000000XX.cfg” or “y00000000000X.cfg” as the file

name, where "XX" or “X” equals to the first two digits or the first digit (except 0 for

SIP-T28P) of the hardware version of the IP phone model.

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

Yealink IP Phones Auto Provisioning Guide

Phone Model

Common CFG File

SIP-T46G

y000000000028.cfg

SIP-T42G

y000000000029.cfg

SIP-T41P

y000000000036.cfg

The IP phones running firmware version 71 or later can only recognize configuration files

using UTF-8 or ANSI encoding.

The <MAC>-local.cfg can be exported/imported via web user interface. For more

information on how to export/import the <MAC>-local.cfg file, refer to Scenario D

Import or export the local configuration file on page 64.

You can ask the distributor or Yealink FAE for Common CFG and MAC-Oriented files. You

can also obtain the Common CFG file and MAC-Oriented file online:

http://www.yealink.com/DocumentDownload.aspx?CateId=142&flag=142

To download Common CFG and MAC-Oriented files:

1. Go to Yealink Document Download Page and select the desired phone model under

the Documents and Download tab.

2. Download and uncompress the combined configuration files to your local system.

For example, the following illustration shows the template files available for SIP-T2xP

IP phones running different firmware versions.

Getting Started

3. Open the folder you uncompressed to and identify the files you will edit according

to the table introduced above.

Before beginning provisioning, you also need the IP phone information. For example,

MAC address and the SIP account information of the IP phone.

MAC Address: The unique 12-digit serial number of the IP phone. You can obtain it from

the bar code on the back of the IP phone.

SIP Account Information: This may include SIP credentials such as user name, password

and IP address of the SIP server. Ask your system administrator for SIP account

information.

Auto provisioning enables Yealink IP phones to update themselves automatically via

downloading Common CFG and MAC-Oriented CFG files. Before beginning

provisioning, you may need to edit and customize your configuration files. Open each

configuration file with a text editor such as UltraEdit. For more information on

configuration parameters in configuration files, refer to Description of Configuration

Parameters in CFG Files on page 97

Common CFG file contains configuration parameters which apply to phones with the

same model, such as language and volume.

Yealink IP Phones Auto Provisioning Guide

The line beginning with “#” is considered to be a comment.

The file header “#!version:1.0.0.1” is not a comment and must be placed in the first line. It cannot be edited or deleted.

The following figure shows a portion of the common CFG file:

The partial parameters in the Common CFG file are described as follows:

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

## Common CFG File ##

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

#!version:1.0.0.1

##File header "#!version:1.0.0.1" can not be edited or deleted, and must be placed in the first line.##

##This template file is applicable to SIP-T28P/T26P/T22P/T20P/T48G/T46G/T42G/T41P IP phones running firmware version 73 or later.##

##For more information on configuration parameters, refer to Yealink_SIP-T2_Series_T4_Series_IP_Phones_Auto_Provisioning_Guide.##

###################################################### ## Hostname ##

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

network.dhcp_host_name =

Getting Started

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

## PPPoE(Except T41P/T42G Models) ## ######################################################n

etwork.pppoe.user =

network.pppoe.password =

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

## Network Advanced ## ######################################################

##It enables or disables the PC port.0-Disabled,1-Auto Negotiation.

##The default value is 1.It takes effect after a reboot.

network.pc_port.enable =

##It configures the transmission mode and speed of the Internet (WAN) port.

##0-Auto negotiate

##1-Full duplex 10Mbps ##2-Full duplex 100Mbps

##3-Half duplex 10Mbps

##4-Half duplex 100Mbps

##5-Full duplex 1000Mbps (only applicable to SIP-T42G, SIP-T46G and SIP-T48G IP phones)

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

network.internet_port.speed_duplex =

##It configures the transmission mode and speed of the PC (LAN) port.

##0-Auto negotiate

##1-Full duplex 10Mbps

##2-Full duplex 100Mbps ##3-Half duplex 10Mbps

##4-Half duplex 100Mbps

##5-Full duplex 1000Mbps (only applicable to SIP-T42G, SIP-T46G and SIP-T48G IP phones)

##The default value is 0.It takes effect after a reboot. network.pc_port.speed_duplex =

##It enables or disables the phone to use manually configured static IPv4 DNS when Internet (WAN) port type for IPv4 is configured as DHCP.

##0-Disabled (use the IPv4 DNS obtained by DHCP) 1-Enabled

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

network.static_dns_enable =

network.ipv6_static_dns_enable =

###Only T41P/T42G/T46G Models support this parameter

network.vlan.pc_port_mode = ##It enable or disable to use A record of TTL

##The defalue value is 1;0-Disable 1-Enable

network.dns.ttl_enable =

Yealink IP Phones Auto Provisioning Guide

##It configures the LAN MTU

##The default value is 1500,.Integer from 128 to 1500.It takes effect after a reboot. network.mtu_value =

###################################################### ## VLAN ##

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

network.vlan.internet_port_enable =

network.vlan.internet_port_vid = network.vlan.internet_port_priority =

network.vlan.pc_port_enable =

network.vlan.pc_port_vid =

network.vlan.pc_port_priority = network.vlan.dhcp_enable =

network.vlan.dhcp_option =

##It configures LLDP or manually VLAN can't obtain IP, whether to switch to other methods of VLAN or closed VLAN to get IP

##0-Disable 1-Enable network.vlan.vlan_change.enable =

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

## WEB Port ## ######################################################

##It configures the HTTP port for web server access.

##The default value is 80.It takes effect after a reboot.

network.port.http =

##It configures the HTTPS port for web server access.

##The default value is 443.It takes effect after a reboot.

network.port.https =

wui.https_enable =

wui.http_enable =

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

## QoS ##

###################################################### ##It configures the voice QoS.

##The default value is 46.It takes effect after a reboot.Integer from 0 to 63 network.qos.rtptos =

##It configures the SIP QoS.

##The default value is 26.It takes effect after a reboot.Integer from 0 to 63 network.qos.signaltos =

Getting Started

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

updated per phone, such as the registration information.

The following figure shows a portion of the MAC-Oriented CFG file:

The partial parameters in the MAC-Oriented CFG file are described as follows:

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

## MAC-Oriented CFG File ##

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

#!version:1.0.0.1

##File header "#!version:1.0.0.1" can not be edited or deleted, and must be placed in

the first line.##

##This template file is applicable to SIP-T28P/T26P/T22P/T20P/T48G/T46G/T42G/T41P IP

phones running firmware version 73 or later.##

##For more information on configuration parameters, refer to

Yealink_SIP-T2_Series_T4_Series_IP_Phones_Auto_Provisioning_Guide.##

Yealink IP Phones Auto Provisioning Guide

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

## Account1 Basic Settings ##

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

account.1.enable =

account.1.label =

account.1.display_name =

account.1.auth_name =

account.1.user_name =

account.1.password =

account.1.outbound_proxy_enable =

account.1.outbound_host =

account.1.outbound_port =

##It configures the local SIP port for account 1. The default value is 5060.

account.1.sip_listen_port =

##It configures the transport type for account 1. 0-UDP,1-TCP,2-TLS,3-DNS-NAPTR

##The default value is 0.

account.1.transport =

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

## Failback ##

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

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

account.1.reregister_enable =

account.1.naptr_build =

account.1.fallback.redundancy_type =

account.1.fallback.timeout =

account.1.sip_server.1.address =

account.1.sip_server.1.port =

account.1.sip_server.1.expires =

account.1.sip_server.1.retry_counts =

account.1.sip_server.1.failback_mode =

account.1.sip_server.1.failback_timeout =

account.1.sip_server.1.register_on_enable =

account.1.sip_server.2.address =

account.1.sip_server.2.port =

account.1.sip_server.2.expires =

Getting Started

SIP-T48G/T46G IP phones support 16 accounts, SIP-T42G IP phones support 12 accounts, SIP-T41P/T28P IP phones support 6 accounts, SIP-T26P/T22P IP phones support 3 accounts, and SIP-T20P IP phones support 2 accounts

account.1.sip_server.2.retry_counts =

account.1.sip_server.2.failback_mode =

account.1.sip_server.2.failback_timeout =

account.1.sip_server.2.register_on_enable =

MAC-local CFG file is automatically filled with configurations modified via web user

interface or phone user interface. The file is stored locally on the IP phone and can also

be uploaded to the provisioning server.

If your IP phone’s current firmware version doesn’t support generating a

<MAC>-local.cfg file, the IP phone will automatically generate a MAC-local CFG file

after it is upgraded to the latest firmware.

Uploading and downloading the <MAC>-local.cfg file

You can configure whether the IP phone periodically uploads the <MAC>-local.cfg file

to the provisioning server to back up this file, and downloads the <MAC>-local.cfg file

from the provisioning server during auto provisioning to override the one stored on the

phone. This process is controlled by the value of the parameter

“auto_provision.custom.sync”. When the value of the parameter

“auto_provision.custom.sync” is set to 1, the IP phone will periodically upload the

configuration files to the provisioning server, and download the configuration files from

the provisioning server during auto provisioning.

For more information on how to configure this parameter, refer to Configuration

Parameters on page 56.

Updating the <MAC>-local.cfg file

You can configure whether the IP phone updates configurations in the <MAC>-local.cfg

file during auto provisioning. This process is controlled by the value of the parameter

“auto_provision.custom.protect”. When the value of the parameter

“auto_provision.custom.protect” is set to 1, the IP phone will update the configurations in

the <MAC>-local.cfg file during auto provisioning. The configurations in the

<MAC>-local.cfg file take precedence over the ones in the downloaded Common CFG

file or <MAC>.cfg file. As a result, the personalized settings of the phone configured via

the phone or web user interface can be remained after auto provisioning.

For more information on how to configure this parameter, refer to Configuration

Parameters on page 56.

Yealink IP Phones Auto Provisioning Guide

Note: The following configurations are defined never to be saved to the

<MAC>-local.cfg file, even if a user modifies the configurations via web user interface

or phone user interface. For more information on the configurations, refer to

Configurations Defined Never be Saved to <MAC>-local.cfg file on page 88.

 Configurations associated with the password.

For example,

#Configure the password for PPPoE connection.

network.pppoe.password =

For more information on the specific configurations which associated with the

password, refer to Description of Configuration Parameters in CFG Files on page

97.

 Configurations requiring a reboot during auto provisioning.

For example,

#Configure the IP address mode.

network.ip_address_mode=

For more information on the specific configurations which require a reboot during

auto provisioning, refer to Description of Configuration Parameters in CFG Files on

page 97.

 The following configuration parameters.

#Configure always forward feature.

forward.always.enable =

forward.always.target =

forward.always.on_code =

forward.always.off_code =

#Configure busy forward feature.

forward.busy.enable =

forward.busy.target =

forward.busy.on_code =

forward.busy.off_code =

#Configure no answer forward feature.

forward.no_answer.enable =

forward.no_answer.target =

forward.no_answer.timeout =

forward.no_answer.on_code =

forward.no_answer.off_code =

#Configure DND feature.

features.dnd.enable =

features.dnd.on_code =

Getting Started

features.dnd.off_code =

#Configure always forward feature for account X. (X stands for the serial number

of account)

account.X.always_fwd.enable =

account.X.always_fwd.target =

account.X.always_fwd.on_code =

account.X.always_fwd.off_code =

#Configure busy forward feature for account X. (X stands for the serial number of

account)

account.X.busy_fwd.enable =

account.X.busy_fwd.target =

account.X.busy_fwd.on_code =

account.X.busy_fwd.off_code =

#Configure no answer forward feature for account X. (X stands for the serial

number of account)

account.X.timeout_fwd.enable =

account.X.timeout_fwd.target =

account.X.timeout_fwd.timeout =

account.X.timeout_fwd.on_code =

account.X.timeout_fwd.off_code =

#Configure DND feature for account X. (X stands for the serial number of account)

account.X.dnd.enable =

account.X.dnd.on_code =

account.X.dnd.off_code =

#Configure the access URL of the firmware file.

firmware.url =

#Configure the access URL of configuration files.

auto_provision.server.url=

Note: The following configurations are defined to be bundled together. If a user modifies

one of the configurations in a bundled group via web user interface or phone user

interface, the other configurations in this group can also be saved to the

<MAC>-local.cfg file (if the parameter isn't configured, the value of this parameter will

be written by “%NULL%”) in addition to the modified configuration.

#Group1: Configure memory key. (Memory key is only applicable to the SIP-T28P,

SIP-T26P IP phones. X stands for the serial number of line key)

memorykey.X.line =

memorykey.X.value =

memorykey.X.pickup_value =

Yealink IP Phones Auto Provisioning Guide

We recommend you do not edit the MAC-local CFG file. If you really want to edit MAC-local CFG file, you can export and then edit it. For more information on how to export this file, refer to Scenario D Import or export the local configuration file on page 64. For more information on how to edit this file, refer to Editing Common CFG

File on page 5 and Editing MAC-Oriented CFG File on page 9.

memorykey.X.type =

memorykey.X.xml_phonebook =

#Group2: Configure line key. (X stands for the serial number of line key)

linekey.X.line =

linekey.X.value =

linekey.X.pickup_value =

linekey.X.type =

linekey.X.xml_phonebook =

linekey.X.label =

#Group3: Configure programable key. (X stands for the serial number of programable

key)

programablekey.X.type =

programablekey.X.line =

programablekey.X.value =

programablekey.X.xml_phonebook =

programablekey.X.history_type =

programablekey.X.label =

#Group4: Configure expansion module key. (Expansion module key is only applicable

to the SIP-T48G, SIP-T46G, SIP-T28P, SIP-T26P IP phones. X stands for the serial number of

expansion module, Y stands for the serial number of expansion key)

expansion_module.X.key.Y.type =

expansion_module.X.key.Y.line =

expansion_module.X.key.Y.value =

expansion_module.X.key.Y.pickup_value =

expansion_module.X.key.Y.label =

expansion_module.X.key.Y.xml_phonebook =

To protect against unauthorized access and tampering of sensitive information (e.g.,

Yealink Configuration Encryption Tool. AES keys must be 16 characters and the

supported characters contain: 0 ~ 9, A ~ Z, a ~ z and the following special characters

Getting Started

Server

HTTP/HTTPS

TFTP/FTP

Windows

Support: ~ ` ! @ $ ^ ( )

_ - , . ' ; [ ] { } (including

space)

Not Support: | < > : "

/ \ * ? # % & = +

Support: ~ ` ! @ $ ^ ( )

_ - , . ' ; [ ] { } % & = +

(including space)

Not Support: | < > : "

/ \ * ? #

Linux

Support: ~ ` ! @ $ ^ ( )

_ - , . ' ; [ ] { } | < > : "

(including space)

Not Support: / \ * ? #

% & = +

Support: ~ ` ! @ $ ^ ( )

_ - , . ' ; [ ] { } | < > : " %

& = + (including

space)

Not Support: / \ * ? #

Phone Model

File Format

Single File Size

Total Files Size

SIP-T28P/T26P/T22P/T20P

.wav

<=100KB

SIP-T48G/T46G

.wav

<=8MB

<=20MB

SIP-T42G/T41P

.wav

<=100KB

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

Platform

are also supported: # $ % * + , - . : = ? @ [ ] ^ _ { } ~. For more information on how to

encrypt configuration files, refer to

Yealink Configuration Encryption Tool User Guide

When configuring some particular features, you may need to upload resource files to IP

phones, such as personalized ring tone file, language package file and logo file. Yealink

supplies some resource file templates for the particular features. Ask the distributor or

Yealink FAE for resource file templates. The following provides information on how to

customize resource files and specify the access URL for the resource files.

For some features, you can customize the filename as required. The following table lists

the special characters supported by Yealink IP phones:

Yealink IP phones have built-in system ring tones. You can change the ring type, or

customize a ring tone and upload it to the IP phone via auto provisioning.

The ring tone file must meet the following:

Yealink IP Phones Auto Provisioning Guide

Available Language

Associated Language File

for SIP-T28P/T26P/T22P/T20P

Associated Language

File for

SIP-T42G/T41P/T48G/T46G English

000.GUI.English.lang

Chinese Simplified

001.GUI.Chinese_S.lang

For more information on customizing a ring tone file, refer to Customizing a Ring Tone

Using Cool Edit Pro on page 85.

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

## Configure the custom ring tone ##

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

#Specify the access URL of the custom ring tone.

ringtone.url =

For example, enter “tftp://192.168.1.100/Customring.wav” in the “ringtone.url =” field.

During the auto provisioning process, the IP phone connects to the provisioning server

“192.168.1.100”, and downloads the ring tone file “Customring.wav”.

To use the custom ring tone for the IP phone, you also need to configure the following

parameter:

#Configure the custom ring tone (e.g., Customring.wav) for the IP phone.

phone_setting.ring_type = Customring.wav

To use the custom ring tone for the desired account, you also need to configure the

following parameter:

#Configure the custom ring tone (e.g., Customring.wav) for account 1.

account.1.ringtone.ring_type = Customring.wav

#Delete all custom ring tones.

ringtone.delete = http://localhost/all

For more information on these parameters, refer to Description of Configuration

Parameters in CFG Files on page 97.

You can modify the existing language translation for phone and web user interface. You

can also add a new language (not included in the available language list) to IP phones.

The following table lists available languages and the associated language files for

phone user interface:

Getting Started

Available Language

Associated Language File

for SIP-T28P/T26P/T22P/T20P

Associated Language

File for

SIP-T42G/T41P/T48G/T46G Chinese Traditional

002.GUI.Chinese_T.lang

French

001.GUI.French.lang

003.GUI.French.lang

German

002.GUI.German.lang

004.GUI.German.lang

Italian

003.GUI.Italian.lang

005.GUI.Italian.lang

Polish

004.GUI.Polish.lang

006.GUI.Polish.lang

Portuguese

005.GUI.Portuguese.lang

007.GUI.Portuguese.lang

Spanish

006.GUI.Spanish.lang

008.GUI.Spanish.lang

Turkish

007.GUI.Turkish.lang

009.GUI.Turkish.lang

Russian

008.GUI.Russian.lang

010.GUI.Russian.lang

To customize a language file:

1. Open the desired language template file (e.g., 000.GUI.English.lang) using an

ASCII editor.

2. Modify the characters within the double quotation marks on the right of the equal

sign.

Don’t modify the translation item on the left of the equal sign.

Yealink IP Phones Auto Provisioning Guide

The following figure shows a portion of a lang formatted English language file (Take

SIP-T28P IP phones for example):

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

## Configure the custom LCD language file ##

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

#Specify the access URL of the custom LCD language file.

gui_lang.url =

If you want to modify the existing language translation for the IP phone user interface,

edit the language translation and then configure the parameter “gui_lang.url =” in the

configuration file, for example:

gui_lang.url = tftp://192.168.1.100/000.GUI.English.lang

During the auto provisioning process, the IP phone connects to the provisioning server

“192.168.1.100”, and downloads the language file “000.GUI.English.lang”. The

language translation will be changed accordingly.

If you want to add a new language “wuilan” to SIP-T28P IP phones, prepare the

language file named as 009.GUI.wuilan.lang for downloading and configure the

parameter “gui_lang.url =” in the configuration file, for example:

gui_lang.url = tftp://192.168.1.100/009.GUI.wuilan.lang

Getting Started

Available Language

Associated Language Pack

Associated Note Language

Pack

English

1.English.js

1.English_note.xml

Chinese Simplified

2.Chinese_S.js

2.Chinese_S_note.xml

Chinese Traditional

3.Chinese_T.js

3.Chinese_T_note.xml French

4.French.js

4.French_note.xml

German

5.German.js

5.German_note.xml

Italian

6.Italian.js

6.Italian_note.xml

Polish

7.Polish.js

7.Polish_note.xml

Portuguese

8.Portuguese.js

8.Portuguese_note.xml

Spanish

9.Spanish.js

9.Spanish_note.xml

For existing language files, “X” ranges from 000 to 010. For custom language files, X must start from 009 or 011 due to phone models. “Y” means the language name.

Available languages may vary between different firmware versions.

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

During the auto provisioning process, the SIP-T28P IP phone connects to the provisioning

server “192.168.1.100”, and downloads the language file “009.GUI.wuilan.lang”. After

update, you will find a new language selection “wuilan” on the IP phone user interface:

Menu->Settings->Basic Settings->Language.

To use the custom language for the IP phone, you also need to configure the following

parameter:

#Configure the custom language (e.g., English) for the phone user interface.

lang.gui = English

#Delete all custom languages.

gui_lang.delete = http://localhost/all

For more information on these parameters, refer to Description of Configuration

Parameters in CFG Files on page 97.

The note information is integrated in the icon of the web user interface. When you

add a new language for the web user interface, you also need to add the note

language.

The following table lists available languages and the associated language files for web

user interface:

Yealink IP Phones Auto Provisioning Guide

Available Language

Associated Language Pack

Associated Note Language

Pack

Turkish

10.Turkish.js

10.Turkish_note.xml

Russian

11.Russian.js

11.Russian_note.xml

To customize a language file:

1. Open the desired language template file (e.g., 1.English.js) using an ASCII editor.

2. Modify the characters within the double quotation marks on the right of the colon.

Don’t modify the translation item on the left of the colon.

The following figure shows a portion of a js formatted English language file:

+ 371 hidden pages

Yealink SIP-T20P, SIP-T41P, SIP-T48G, SIP-T46G, SIP-T42G User Manual

Specifications and Main Features

Frequently Asked Questions

User Manual

Table of Contents

Summary of Changes

Introduction

Getting Started

 Obtaining Configuration Information