Yealink T48S, T42G, T41S, T41P, T48G Administrator's Manual

linekey.X.pickup_value

Copyright

Copyright © 2018 YEALINK(XIAMEN) NETWORK TECHNOLOGY

Copyright © 2018 Yealink (Xiamen) Network Technology CO., LTD. All rights reserved. No parts of this

publication may be reproduced or transmitted in any form or by any means, electronic or mechanical,

photocopying, recording, or otherwise, for any purpose, without the express written permission of

Yealink (Xiamen) Network Technology CO., LTD. Under the law, reproducing includes translating into

another language or format.

When this publication is made available on media, Yealink (Xiamen) Network Technology CO., LTD. gives

its consent to downloading and printing copies of the content provided in this file only for private use

but not for redistribution. No parts of this publication may be subject to alteration, modification or

commercial use. Yealink (Xiamen) Network Technology CO., LTD. will not be liable for any damages

arising from use of an illegally modified or altered publication.

Trademarks

Yealink®, the logo and the name and marks is trademark of Yealink (Xiamen) Network Technology CO.,

LTD, which are registered legally in China, the United States, EU (European Union) and other countries.

All other trademarks belong to their respective owners. Without Yealink’s express written permission,

recipient shall not reproduce or transmit any portion hereof in any form or by any means, with any

purpose other than personal use.

Warranty

(1) Warranty

THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS GUIDE ARE SUBJECT TO

CHANGE WITHOUT NOTICE. ALL STATEMENTS, INFORMATION, AND RECOMMENDATIONS IN THIS

GUIDE ARE BELIEVED TO BE ACCURATE AND PRESENTED WITHOUT WARRANTY OF ANY KIND, EXPRESS

OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF PRODUCTS.

(2) Disclaimer

YEALINK (XIAMEN) NETWORK TECHNOLOGY CO., LTD. MAKES NO WARRANTY OF ANY KIND WITH

REGARD TO THIS GUIDE, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF

MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. Yealink (Xiamen) Network Technology

CO., LTD. shall not be liable for errors contained herein nor for incidental or consequential damages in

connection with the furnishing, performance, or use of this guide.

(3) Limitation of Liability

Yealink and/or its respective suppliers are not responsible for the suitability of the information contained

in this document for any reason. The information is provided “as is”, and Yealink does not provide any

ii

warranty and is subject to change without notice. All risks other than risks caused by use of the

information are borne by the recipient. In no event, even if Yealink has been suggested the occurrence of

damages that are direct, consequential, incidental, special, punitive or whatsoever (Including but not

limited to loss of business profit, business interruption or loss of business information), shall not be liable

for these damages.

End User License Agreement

This End User License Agreement ("EULA") is a legal agreement between you and Yealink. By installing,

copying or otherwise using the Products, you: (1) agree to be bounded by the terms of this EULA, (2) you

are the owner or an authorized user of the device, and (3) you represent and warrant that you have the

right, authority and capacity to enter into this agreement and to abide by all its terms and conditions, just

as if you had signed it. The EULA for this product is available on the Yealink Support page for the product.

Patent Information

China, the United States, EU (European Union) and other countries are protecting one or more patents of

accompanying products and/or patents being applied by Yealink.

Customer Feedback

We are striving to improve our documentation quality and we appreciate your feedback. Email your

opinions and comments to [e-mail].

Technical Support

Visit Yealink WIKI (http://support.yealink.com/) for the latest firmware, guides, FAQ, Product documents,

and more. For better service, we sincerely recommend you to use Yealink Ticketing system

(https://ticket.yealink.com) to submit all your technical issues.

iii

GNU GPL INFORMATION

Yealink IP phone firmware contains third-party software under the GNU General Public License (GPL).

Yealink uses software under the specific terms of the GPL. Please refer to the GPL for the exact terms and

conditions of the license.

The original GPL license, source code of components licensed under GPL and used in Yealink products

can be downloaded from Yealink web site: http://www.yealink.com/onepage_83.html.

iv

Introduction

Introduction

Yealink administrator guide provides general guidance on setting up phone network, provisioning and

managing phones.

This guide is not intended for end users, but for administrators with experience in networking who

understand the basic of open SIP networks and VoIP endpoint environments.

As an administrator, you can do the following with this guide:

 Set up a VoIP network and provisioning server.

 Provision the phone with features and settings.

 Troubleshoot, update and maintain phones.

The information detailed in this guide is applicable to the following Yealink devices running firmware

version 83 or higher:

 T5 series IP phones, including T54S and T52S.

 T4 series IP phones, including T48S/G, T46S/G, T42S/G, T41S/P and T40P/G.

 T2 series IP phones, including T29G, T27P/G, T23P/G, T21(P) E2 and T19(P) E2.

 Expansion modules, including EXP20, EXP40 and EXP50.

Read the Yealink Products Regulatory Notices guide for all regulatory and safety guidance.

Related Documentations

The following related documents are available:

 Quick Start Guides, describe how to assemble IP phones and configure the most basic features

available on IP phones.

 User Guides, describe how to configure and use the basic and advanced features available on IP

phones via phone user interface or via web user interface.

 Auto Provisioning Guide, describes how to provision IP phones using the boot file and configuration

files.

The

Auto Provisioning Guide

a provisioning server. If you are novice, this guide is helpful for you.

is to serve as a basic guidance for provisioning Yealink IP phones with

 Using features integrated with Broadsoft UC-One, refer to the following two guides to have a better

knowledge of BroadSoft features.

IP Phones Deployment Guide for BroadSoft UC-One Environments, describes how to configure

BroadSoft features on the BroadWorks web portal and IP phones.

IP Phone Features Integrated with BroadSoft UC-One User Guide, describes how to configure and

i

Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones

Convention

Description

Bold

Highlight the web/phone user interface items such as menus, menu

selections, soft keys, or directory names when they are involved in a

procedure or user action (for example, click Settings->Upgrade.).

Also used to emphasize text (for example, Important!).

Italics

Used to emphasize text, to show the example values or inputs (format of

examples:

http(s)://[IPv6 address]

).

Blue Text

Used for cross references to other topics related to this topic (for example,

Ring Tones), for hyperlinks to external sites and documents, for example, RFC

3315 or Yealink_SIP_IP_Phones_Auto_Provisioning_Guide.

Convention

Description

<>

Indicate that you must enter information specific to phone or network. For

example, when you see <MAC>, enter your phone’s 12-digit MAC address. If

you see <phoneIPAddress>, enter your phone’s IP address.

use IP phone features integrated with BroadSoft UC-One on Yealink IP phones.

For support or service, please contact your Yealink reseller or go to Yealink Technical Support online:

http://support.yealink.com/.

Recommended References

For more information on configuring and administering other Yealink products not included in this guide,

refer to product support page at Yealink Technical Support.

To access the latest Release Notes or other guides for Yealink IP phones, refer to the Document

Download page for your phone at Yealink Technical Support.

If you want to find Request for Comments (RFC) documents, type

(NNNN is the RFC number) into the location field of your browser.

For other references, look for the hyperlink or web info throughout this administrator guide.

http://www.ietf.org/rfc/rfcNNNN.txt

Typographic and Writing Conventions

Yealink documentations contain a few typographic conventions and writing conventions.

You need to know the following basic typographic conventions to distinguish types of in-text

information:

You also need to know the following writing conventions to distinguish conditional information:

ii

Convention

Description

->

Indicate that you need to select an item from a menu. For example,

Settings->Basic Settings indicates that you need to select Basic Settings

from the Settings menu.

Introduction

iii

Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones

iv

Table of Contents

Table of Contents

Introduction..................................................................................... i

Related Documentations ......................................................................................................................................................... i

Recommended References .................................................................................................................................................... ii

Typographic and Writing Conventions ............................................................................................................................. ii

Table of Contents ........................................................................... v

Getting Started ............................................................................... 1

Requirements ............................................................................................................................................................................... 1

Yealink IP Phones in a Network ........................................................................................................................................... 1

Initialization Process Overview ............................................................................................................................................. 2

Loading the ROM File ..................................................................................................................................................... 3

Configuring the VLAN .................................................................................................................................................... 3

Querying the DHCP (Dynamic Host Configuration Protocol) Server .......................................................... 3

Contacting the Provisioning Server .......................................................................................................................... 3

Updating Firmware .......................................................................................................................................................... 4

Downloading the Resource Files ................................................................................................................................ 4

Verifying Startup ........................................................................................................................................................................ 4

Phone Network .............................................................................. 5

IPv4 and IPv6 Network Settings ........................................................................................................................................... 5

IP Addressing Mode Configuration .......................................................................................................................... 6

IPv4 Configuration............................................................................................................................................................ 7

IPv6 Configuration......................................................................................................................................................... 10

DHCP Option for IPv4 ........................................................................................................................................................... 14

Supported DHCP Option for IPv4 ........................................................................................................................... 14

DHCP Option 66, Option 43 and Custom Option ............................................................................................ 15

DHCP Option 42, Option 2 and Option 100....................................................................................................... 16

DHCP Option 12 ............................................................................................................................................................. 16

DHCP Option 120 .......................................................................................................................................................... 17

DHCP Option 60 ............................................................................................................................................................. 18

DHCP Option for IPv6 ........................................................................................................................................................... 19

Supported DHCP Option for IPv6 ........................................................................................................................... 19

DHCP Option 59 and Custom Option ................................................................................................................... 19

VLAN ............................................................................................................................................................................................. 19

LLDP Configuration ....................................................................................................................................................... 20

v

Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones

CDP Configuration ........................................................................................................................................................ 21

Manual VLAN Configuration ..................................................................................................................................... 22

DHCP VLAN ...................................................................................................................................................................... 25

VLAN Setting Configuration ...................................................................................................................................... 26

Wi-Fi ............................................................................................................................................................................................. 26

Wi-Fi Configuration ...................................................................................................................................................... 26

Real-Time Transport Protocol (RTP) Ports .................................................................................................................... 33

RTP Ports Configuration ............................................................................................................................................. 33

Network Address Translation (NAT) ................................................................................................................................ 34

NAT Traversal Configuration ..................................................................................................................................... 34

Keep Alive Configuration............................................................................................................................................ 38

Rport Configuration ...................................................................................................................................................... 39

SIP Port and TLS Port Configuration...................................................................................................................... 39

Internet Port and PC Port .................................................................................................................................................... 40

Supported Transmission Methods ......................................................................................................................... 40

Internet Port and PC Port Configuration ............................................................................................................. 40

VPN ............................................................................................................................................................................................... 42

VPN Related Files ........................................................................................................................................................... 42

VPN Configuration ........................................................................................................................................................ 43

Quality of Service (QoS) ....................................................................................................................................................... 43

Voice and SIP QoS Configuration ........................................................................................................................... 44

802.1x Authentication ........................................................................................................................................................... 45

802.1x Authentication Configuration .................................................................................................................... 45

TR-069 Device Management .............................................................................................................................................. 48

Supported RPC Methods ............................................................................................................................................ 48

TR069 Configuration .................................................................................................................................................... 49

Phone Provisioning ...................................................................... 53

Boot Files, Configuration Files and Resource Files .................................................................................................... 53

Boot Files ........................................................................................................................................................................... 53

Configuration Files ........................................................................................................................................................ 56

Resource Files .................................................................................................................................................................. 62

Files Download Process ............................................................................................................................................... 63

Provisioning Methods ........................................................................................................................................................... 64

Provisioning Methods Priority .................................................................................................................................. 65

Manual Provisioning ..................................................................................................................................................... 65

Central Provisioning ..................................................................................................................................................... 71

Setting Up a Provisioning Server ...................................................................................................................................... 80

Supported Provisioning Protocols .......................................................................................................................... 81

Supported Provisioning Server Discovery Methods ....................................................................................... 82

Configuring a Provisioning Server .......................................................................................................................... 86

Keeping User’s Personalized Settings after Auto Provisioning ............................................................................ 87

Auto Provisioning Flowchart for Keep User’s Personalized Configuration Settings ......................... 88

vi

Table of Contents

Example: Deploying Phones from the Provisioning Server ................................................................................... 89

Firmware Upgrade ....................................................................... 91

Firmware for Each Phone Model ...................................................................................................................................... 91

Firmware Upgrade Configuration .................................................................................................................................... 92

Phone Customization................................................................... 93

Language .................................................................................................................................................................................... 94

Supported Languages.................................................................................................................................................. 94

Language Display Configuration ............................................................................................................................. 95

Language Customization ............................................................................................................................................ 96

Example: Setting a Custom Language for Phone Display .......................................................................... 101

Contrast ..................................................................................................................................................................................... 101

Contrast Configuration .............................................................................................................................................. 101

Wallpaper ................................................................................................................................................................................. 102

Wallpaper Configuration .......................................................................................................................................... 102

Wallpaper Customization ......................................................................................................................................... 104

Adding a Wallpaper from a USB Flash Drive .................................................................................................... 105

Example: Setting a Custom Picture as Wallpaper .......................................................................................... 105

Transparency ........................................................................................................................................................................... 105

Transparency Configuration .................................................................................................................................... 106

Screen Saver ............................................................................................................................................................................ 106

Screensaver Display Customization ..................................................................................................................... 107

Custom Screensaver Picture Limit ........................................................................................................................ 109

Screensaver Configuration ....................................................................................................................................... 110

Adding a Screensaver Picture from a USB Flash Drive ................................................................................ 113

Deleting a Screensaver Picture .............................................................................................................................. 113

Backlight ................................................................................................................................................................................... 113

Supported Backlight Options ................................................................................................................................. 114

Backlight Brightness and Time Configuration ................................................................................................. 114

Label Length for Line Key Display .................................................................................................................................. 116

Label Length Display Configuration .................................................................................................................... 117

Label Alignment for Line/Ext Key Display ................................................................................................................... 117

Label Alignment Display Configuration ............................................................................................................. 118

Linekey Length in Short ...................................................................................................................................................... 118

Linekey Length Shorten Rules ................................................................................................................................ 119

Linekey Length in Short Configuration ............................................................................................................... 119

Page Switch Key ..................................................................................................................................................................... 120

Page Switch Key Configuration.............................................................................................................................. 120

Page Tips .................................................................................................................................................................................. 120

Phone Page Tips ........................................................................................................................................................... 121

Expansion Module Page Tips .................................................................................................................................. 122

vii

Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones

Time and Date ........................................................................................................................................................................ 123

Time Zone ....................................................................................................................................................................... 124

NTP Settings .................................................................................................................................................................. 127

DST Settings ................................................................................................................................................................... 130

Time and Date Manually Configuration ............................................................................................................. 134

Time and Date Format Configuration ................................................................................................................. 135

Date Customization Rule .......................................................................................................................................... 136

Idle Clock Display .................................................................................................................................................................. 137

Idle Clock Display Configuration ........................................................................................................................... 137

Logo Customization ............................................................................................................................................................. 137

Custom Logo Picture Limit ...................................................................................................................................... 138

Customizing a Logo Picture .................................................................................................................................... 138

Custom Logo Configuration.................................................................................................................................... 139

Example: Setting a Custom Logo Display .......................................................................................................... 140

Call Display .............................................................................................................................................................................. 140

Call Display Configuration ....................................................................................................................................... 141

Display Method on Dialing ............................................................................................................................................... 143

Display Method on Dialing Configuration ........................................................................................................ 143

Key As Send ............................................................................................................................................................................. 144

Key As Send Configuration ...................................................................................................................................... 144

Softkey Layout ........................................................................................................................................................................ 145

Supported Call States and Soft Keys ................................................................................................................... 145

Softkey Layout File Customization ....................................................................................................................... 149

Softkey Layout Configuration ................................................................................................................................. 150

Example: Setting the Soft Keys Layout in Talking State .............................................................................. 153

Input Method .......................................................................................................................................................................... 154

Input Method File Customization ......................................................................................................................... 154

Input Method Configuration ................................................................................................................................... 155

Notification Popups ............................................................................................................................................................. 157

Notification Popups Configuration ...................................................................................................................... 158

Power LED Indicator ............................................................................................................................................................. 159

Power LED Indicator Configuration ...................................................................................................................... 159

Bluetooth .................................................................................................................................................................................. 162

Bluetooth Configuration ........................................................................................................................................... 162

Handset/Headset/Speakerphone Mode ..................................................................................................................... 164

Handset/Headset/Speakerphone Mode Configuration .............................................................................. 164

DSS Keys ................................................................................................................................................................................... 165

Supported DSS Keys ................................................................................................................................................... 165

Supported Dsskey Types .......................................................................................................................................... 166

Line Keys .......................................................................................................................................................................... 167

Programmable Keys .................................................................................................................................................... 175

Ext Keys ............................................................................................................................................................................ 180

Enhanced DSS Keys .............................................................................................................................................................. 183

Some Guidelines for Configuring Enhanced DSS Keys ................................................................................ 183

viii

Table of Contents

Macro Action Strings .................................................................................................................................................. 184

EDK Configuration ....................................................................................................................................................... 188

EDK List Configuration ............................................................................................................................................... 189

EDK Prompt Configuration ...................................................................................................................................... 190

EDK Soft Keys Configuration .................................................................................................................................. 192

Example: Configuring EDK List for a Line Key .................................................................................................. 197

Power Saving .......................................................................................................................................................................... 197

Power Saving Configuration ................................................................................................................................... 198

USB Port Lock ......................................................................................................................................................................... 201

USB Port Lock Configuration .................................................................................................................................. 201

Search Source List in Dialing ............................................................................................................................................ 201

Search Source File Customization ........................................................................................................................ 202

Search Source List Configuration .......................................................................................................................... 203

Recent Call Display in Dialing .......................................................................................................................................... 205

Recent Call in Dialing Configuration ................................................................................................................... 206

Account Settings ........................................................................ 207

Account Registration ........................................................................................................................................................... 207

Supported Accounts ................................................................................................................................................... 207

Accounts Registration Configuration .................................................................................................................. 208

Registration Settings Configuration .................................................................................................................... 212

Outbound Proxy in Dialog ................................................................................................................................................ 215

Outbound Proxy in Dialog Configuration ......................................................................................................... 215

Server Redundancy............................................................................................................................................................... 216

Behaviors When Working Server Connection Fails ....................................................................................... 217

Registration Method of the Failover/Fallback Mode .................................................................................... 218

Fallback Server Redundancy Configuration...................................................................................................... 218

Failover Server Redundancy Configuration ...................................................................................................... 220

SIP Server Name Resolution ............................................................................................................................................. 225

SIP Server Name Resolution Configuration ...................................................................................................... 225

Static DNS Cache................................................................................................................................................................... 226

Behave with a Configured DNS Server ............................................................................................................... 226

Static DNS Cache Configuration ........................................................................................................................... 227

Logon Wizard ......................................................................................................................................................................... 231

Logon Wizard Configuration .................................................................................................................................. 231

Multiple Line Keys per Account ...................................................................................................................................... 233

Multiple Line Keys per Account Configuration ............................................................................................... 233

Auto Line Labels Rule Configuration ................................................................................................................... 235

Default Account ............................................................................................................................................................ 236

Call Log ....................................................................................... 239

Call Log Display ..................................................................................................................................................................... 239

ix

Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones

Call Log Configuration ........................................................................................................................................................ 240

Call Logs Backup ................................................................................................................................................................... 241

Directory ..................................................................................... 245

Local Directory ....................................................................................................................................................................... 245

Contact Avatars and Icons Picture Limit ............................................................................................................ 245

Preparing the Tar Formatted File .......................................................................................................................... 246

Local Contact File Customization .......................................................................................................................... 247

Local Contact Files and Resource Upload ......................................................................................................... 249

Example: Adding Contacts Using a Contact File ............................................................................................. 252

Local Contacts Backup ........................................................................................................................................................ 252

Favorite Contacts................................................................................................................................................................... 254

Favorites Configuration ............................................................................................................................................. 255

Lightweight Directory Access Protocol (LDAP) ......................................................................................................... 255

LDAP Attributes ............................................................................................................................................................ 256

LDAP Configuration .................................................................................................................................................... 256

Remote Phone Book ............................................................................................................................................................ 262

Remote Phone Book File Customization ........................................................................................................... 263

Remote Phone Book Configuration ..................................................................................................................... 265

Example: Configuring a Remote Phone Book.................................................................................................. 266

Directory List for Directory/Dir Soft Key ...................................................................................................................... 267

Directory List File Customization ........................................................................................................................... 267

Directory List Configuration .................................................................................................................................... 269

Example: Configuring a Directory List ................................................................................................................. 271

Directory Search Settings .................................................................................................................................................. 271

Directory Search Settings Configuraion ............................................................................................................. 271

Call Features ............................................................................... 273

Dial Plan .................................................................................................................................................................................... 274

Dial Plan Defined by Four Patterns ...................................................................................................................... 274

Dial Plan Defined by Digit Map ............................................................................................................................. 283

Emergency Dialplan and Enhanced 911 ...................................................................................................................... 293

Emergency Dialplan and Enhanced 911 Configuration ............................................................................... 294

Hotline ....................................................................................................................................................................................... 298

Hotline Configuration ................................................................................................................................................ 299

Off Hook Hot Line Dialing ................................................................................................................................................. 300

Off Hook Hot Line Dialing Configuration .......................................................................................................... 300

Live Dialpad ............................................................................................................................................................................. 301

Live Dialpad Configuration ...................................................................................................................................... 301

Auto Redial .............................................................................................................................................................................. 302

Auto Redial Configuration ....................................................................................................................................... 302

ReCall Configuration ............................................................................................................................................................ 303

x

Table of Contents

Speed Dial ................................................................................................................................................................................ 304

Speed Dial Key Configuration ................................................................................................................................ 304

Password Dial.......................................................................................................................................................................... 304

Password Dial Configuration .................................................................................................................................. 305

Call Timeout ............................................................................................................................................................................ 306

Call Timeout Configuration ..................................................................................................................................... 306

Anonymous Call ..................................................................................................................................................................... 306

Anonymous Call Configuration.............................................................................................................................. 307

Call Number Filter ................................................................................................................................................................. 309

Call Number Filter Configuration .......................................................................................................................... 309

IP Address Call ........................................................................................................................................................................ 309

IP Address Call Configuration................................................................................................................................. 309

Ignoring Incoming Calls ..................................................................................................................................................... 310

Ignoring Incoming Calls Configuration .............................................................................................................. 311

Off Hook Answering ............................................................................................................................................................ 311

Off Hook Answering Configuration ..................................................................................................................... 311

Auto Answer ............................................................................................................................................................................ 311

Auto Answer Configuration ..................................................................................................................................... 312

Anonymous Call Rejection ................................................................................................................................................ 314

Anonymous Call Rejection Configuration ......................................................................................................... 314

Call Waiting ............................................................................................................................................................................. 316

Call Waiting Configuration ...................................................................................................................................... 316

Do Not Disturb (DND) ......................................................................................................................................................... 318

DND Settings Configuration ................................................................................................................................... 318

DND Feature Configuration .................................................................................................................................... 320

DND Synchronization for Server-side Configuration ................................................................................... 323

Multiple Call Appearances ................................................................................................................................................ 324

Multiple Call Appearances Configuration ......................................................................................................... 324

Call Hold ................................................................................................................................................................................... 325

Call Hold Configuration ............................................................................................................................................ 326

Music on Hold (MoH) Configuration ................................................................................................................... 328

Call Mute................................................................................................................................................................................... 329

Microphone Mute Configuration .......................................................................................................................... 330

Keep Mute ...................................................................................................................................................................... 330

Call Forward ............................................................................................................................................................................. 331

Call Forward Settings Configuration.................................................................................................................... 331

Call Forward Feature Configuration ..................................................................................................................... 333

Call Forward Synchronization for Server-side Configuration .................................................................... 343

Call Transfer ............................................................................................................................................................................. 345

Call Transfer Configuration ...................................................................................................................................... 345

Transfer Mode for Dsskey Configuration .......................................................................................................... 347

Conference ............................................................................................................................................................................... 347

Conference Type Configuration ............................................................................................................................ 347

Local Conference Configuration ............................................................................................................................ 348

xi

Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones

Network Conference Configuration ..................................................................................................................... 349

USB Recording ....................................................................................................................................................................... 350

USB Recording Configuration ................................................................................................................................ 350

Multicast Paging .................................................................................................................................................................... 351

Multicast Paging Group Configuration .............................................................................................................. 351

Multicast Listening Group Configuration .......................................................................................................... 353

Multicast Paging Settings......................................................................................................................................... 354

Audio Features ........................................................................... 359

Alert Tone ................................................................................................................................................................................. 359

Alert Tone Configuration .......................................................................................................................................... 360

Ring Tones ............................................................................................................................................................................... 361

Custom Ringtone Limit.............................................................................................................................................. 362

Ringtone Configuration ............................................................................................................................................ 362

Distinctive Ring Tones ......................................................................................................................................................... 364

Supported Alert-Info Headers Format ................................................................................................................ 364

Distinctive Ring Tones Configuration .................................................................................................................. 368

Ringer Device .......................................................................................................................................................................... 370

Ringer Device Configuration ................................................................................................................................... 370

Audio Volume ......................................................................................................................................................................... 370

Ringer Volume Configuration................................................................................................................................. 371

Sending Volume Configuration ............................................................................................................................. 371

Tones .......................................................................................................................................................................................... 373

Supported Tones ......................................................................................................................................................... 373

Tones Configuration ................................................................................................................................................... 374

Audio Codecs .......................................................................................................................................................................... 379

Supported Audio Codecs ......................................................................................................................................... 379

Audio Codecs Configuration................................................................................................................................... 381

Packetization Time (PTime) ............................................................................................................................................... 383

Supported PTime of Audio Codec ........................................................................................................................ 383

PTime Configuration .................................................................................................................................................. 384

Early Media .............................................................................................................................................................................. 384

Early Media Configuration ....................................................................................................................................... 385

Headset Prior .......................................................................................................................................................................... 385

Headset Prior Configuration ................................................................................................................................... 386

Dual Headset ........................................................................................................................................................................... 386

Dual Headset Configuration ................................................................................................................................... 387

Acoustic Clarity Technology ............................................................................................................................................. 387

Acoustic Echo Cancellation (AEC) ......................................................................................................................... 387

Background Noise Suppression (BNS) ................................................................................................................ 388

Automatic Gain Control (AGC) ............................................................................................................................... 388

Voice Activity Detection (VAD) .............................................................................................................................. 388

Comfort Noise Generation (CNG) ......................................................................................................................... 389

xii

Table of Contents

Jitter Buffer ..................................................................................................................................................................... 389

DTMF .......................................................................................................................................................................................... 392

DTMF Keypad ................................................................................................................................................................ 392

Transmitting DTMF Digit .......................................................................................................................................... 393

Suppress DTMF Display ............................................................................................................................................ 395

Transfer via DTMF ........................................................................................................................................................ 396

Local DTMF Tone ......................................................................................................................................................... 397

Voice Quality Monitoring (VQM) .................................................................................................................................... 397

RTCP-XR ........................................................................................................................................................................... 397

VQ-RTCPXR .................................................................................................................................................................... 398

Security Features ........................................................................ 407

User and Administrator Identification .......................................................................................................................... 407

User and Administrator Identification Configuration ................................................................................... 407

User Access Level Configuration ........................................................................................................................... 409

Auto Logout Time ................................................................................................................................................................. 409

Auto Logout Time Configuration .......................................................................................................................... 410

Phone Lock .............................................................................................................................................................................. 410

Operation Behaviors on Lock Phone ................................................................................................................... 411

Phone Lock Configuration ....................................................................................................................................... 412

Transport Layer Security (TLS) ......................................................................................................................................... 414

Supported Cipher Suites ........................................................................................................................................... 414

Supported Trusted and Server Certificates ....................................................................................................... 415

TLS Configuration ........................................................................................................................................................ 418

Secure Real-Time Transport Protocol (SRTP) ............................................................................................................ 421

SRTP Configuration ..................................................................................................................................................... 423

Encrypting and Decrypting Files ..................................................................................................................................... 424

Configuration Files Encryption Tools ................................................................................................................... 425

Configuration Files Encryption and Decryption .............................................................................................. 425

Contact Files Encryption and Decryption .......................................................................................................... 425

Encryption and Decryption Configuration ........................................................................................................ 426

Example: Encrypting Configuration Files ........................................................................................................... 429

Incoming Signaling Validation ........................................................................................................................................ 431

Incoming Signaling Validation Configuration ................................................................................................. 431

Advanced Features ..................................................................... 433

Call Pickup ................................................................................................................................................................................ 433

Directed Call Pickup .................................................................................................................................................... 433

Group Call Pickup ........................................................................................................................................................ 437

Call Completion ..................................................................................................................................................................... 438

Call Completion Configuration .............................................................................................................................. 441

Example: Using Call Completion ........................................................................................................................... 441

xiii

Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones

Call Park and Retrieve ......................................................................................................................................................... 441

Call Park and Retrieve Configuration .................................................................................................................. 442

Example: Setting Call Park and Retrieve in FAC Mode ................................................................................ 443

Example: Setting Call Park and Retrieve in Transfer Mode ........................................................................ 444

Automatic Call Distribution (ACD) ................................................................................................................................. 444

ACD Key Configuration ............................................................................................................................................. 445

ACD Configuration ...................................................................................................................................................... 445

Example: Setting ACD ................................................................................................................................................ 447

Busy Lamp Field ..................................................................................................................................................................... 447

BLF Key Configuration ............................................................................................................................................... 448

BLF List Configuration ................................................................................................................................................ 448

State Indicator of Remote Line .............................................................................................................................. 451

BLF/BLF List Subscription.......................................................................................................................................... 451

Visual and Audio Alert for Monitor Lines .......................................................................................................... 454

LED Mode for BLF/BLF List Key .............................................................................................................................. 456

BLF/BLF List Key LED Status and Behavior Configuration ........................................................................... 459

BLF Key for Intercom Configuration .................................................................................................................... 468

Shared Line .............................................................................................................................................................................. 469

State Indicator of Shared Line ................................................................................................................................ 469

Shared Call Appearance (SCA) Configuration.................................................................................................. 470

Bridge Lines Appearance (BLA) .............................................................................................................................. 472

Intercom .................................................................................................................................................................................... 473

Intercom Key Configuration .................................................................................................................................... 474

State Monitor for Intercom Contact .................................................................................................................... 474

Outgoing Intercom Configuration........................................................................................................................ 475

Incoming Intercom Configuration ........................................................................................................................ 476

CSTA Control ........................................................................................................................................................................... 478

CSTA Control Configuration .................................................................................................................................... 479

Action URL ............................................................................................................................................................................... 479

Pre-defined Events List .............................................................................................................................................. 479

Variable Values List ..................................................................................................................................................... 481

Action URL Configuration ........................................................................................................................................ 482

Action URI ................................................................................................................................................................................ 496

Supported HTTP/HTTPS GET Request ................................................................................................................ 497

Supported SIP Notify Message .............................................................................................................................. 498

Variable Values List ..................................................................................................................................................... 499

Action URI Configuration ......................................................................................................................................... 502

Example: Capturing the Current Screen of the Phone ................................................................................. 503

Example: Placing a Call via Web User Interface .............................................................................................. 504

Voice Mail ................................................................................................................................................................................. 505

MWI for Voice Mail Configuration ....................................................................................................................... 505

Short Message Service (SMS) .......................................................................................................................................... 507

SMS Configuration ...................................................................................................................................................... 508

XML Browser ........................................................................................................................................................................... 508

xiv

Table of Contents

XML Browser Configuration .................................................................................................................................... 508

Hot Desking ............................................................................................................................................................................. 510

Hot Desking Key Configuration ............................................................................................................................. 511

Hot Desking Configuration ...................................................................................................................................... 511

General Features ........................................................................ 513

Line Identification Presentation ...................................................................................................................................... 513

CLIP and COLP Configuration................................................................................................................................. 514

Return Code for Refused Call........................................................................................................................................... 515

Return Code for Refused Call Configuration ................................................................................................... 515

Hide Feature Access Codes ............................................................................................................................................... 516

Hide Feature Access Codes Configuration........................................................................................................ 516

Accept SIP Trust Server Only ............................................................................................................................................ 517

Accept SIP Trust Server Only Configuration ..................................................................................................... 517

100 Reliable Retransmission ............................................................................................................................................. 517

100 Reliable Retransmission Configuration ...................................................................................................... 518

SIP Session Timer .................................................................................................................................................................. 519

SIP Session Timer Configuration ........................................................................................................................... 519

Session Timer .......................................................................................................................................................................... 520

Session Timer Configuration ................................................................................................................................... 521

Reboot in Talking .................................................................................................................................................................. 522

Reboot in Talking Configuration ........................................................................................................................... 522

Reserve # in User Name ..................................................................................................................................................... 522

Reserve # in User Name Configuration .............................................................................................................. 523

Busy Tone Delay .................................................................................................................................................................... 523

Busy Tone Delay Configuration ............................................................................................................................. 524

CFG File Version Information ........................................................................................................................................... 524

CFG File Version Information Configuration .................................................................................................... 524

Media Loopback .................................................................................................................................................................... 524

Media Loopback Configuration ............................................................................................................................. 525

Configuration Parameters ......................................................... 527

BroadSoft Parameters ......................................................................................................................................................... 527

BroadSoft Settings ...................................................................................................................................................... 527

Broadsoft UC ................................................................................................................................................................. 527

Broadsoft XSI ................................................................................................................................................................. 531

Broadsoft ACD .............................................................................................................................................................. 534

Broadsoft Centralized Call Recording ................................................................................................................. 536

Broadsoft Security Classification ........................................................................................................................... 537

Broadsoft Hoteling ...................................................................................................................................................... 537

Broadsoft Flexible Seating ....................................................................................................................................... 539

Broadsoft Call Decline ............................................................................................................................................... 540

xv

Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones

Broadsoft Network Directory .................................................................................................................................. 540

Broadsoft Visual Voice Mail ..................................................................................................................................... 546

Broadsoft SCA ............................................................................................................................................................... 546

Broadsoft Call Park ...................................................................................................................................................... 548

Broadsoft Emergency Call ........................................................................................................................................ 549

Call Waiting Sync ......................................................................................................................................................... 549

Start2Start ACD Parameters ............................................................................................................................................. 550

Ethernet Interface MTU Parameter ................................................................................................................................ 551

SIP Settings Parameters...................................................................................................................................................... 551

Call Settings Parameters .................................................................................................................................................... 555

Troubleshooting ......................................................................... 557

Troubleshooting Methods ................................................................................................................................................ 557

Log Files ........................................................................................................................................................................... 557

Resetting Phone and Configuration .................................................................................................................... 566

Packets Capture ............................................................................................................................................................ 569

Watch Dog ...................................................................................................................................................................... 571

Network Diagnostics .................................................................................................................................................. 572

Analyzing Configuration Files ................................................................................................................................. 573

Exporting All the Diagnostic Files ......................................................................................................................... 574

Phone Status .................................................................................................................................................................. 575

Phone Reboot ............................................................................................................................................................... 575

Troubleshooting Solutions ................................................................................................................................................ 577

IP Address Issues.......................................................................................................................................................... 577

Time and Date Issues ................................................................................................................................................. 578

Display Issues ................................................................................................................................................................ 579

Phone Book Issues ...................................................................................................................................................... 579

Audio Issues ................................................................................................................................................................... 579

Wi-Fi and Bluetooth Issues ...................................................................................................................................... 580

Firmware and Upgrading Issues ............................................................................................................................ 581

System Log Issues ....................................................................................................................................................... 582

Password Issues ............................................................................................................................................................ 583

Logo Issues ..................................................................................................................................................................... 583

Power and Startup Issues ......................................................................................................................................... 583

Other Issues ................................................................................................................................................................... 584

Appendix..................................................................................... 586

RFC and Internet Draft Support ...................................................................................................................................... 586

Reading Icons ......................................................................................................................................................................... 591

xvi

Getting Started

Getting Started

This chapter describes where Yealink IP phones fit in your network and provides basic initialization

instructions of IP phones.

Topics

Requirements

Yealink IP Phones in a Network

Initialization Process Overview

Verifying Startup

Requirements

In order to perform as SIP endpoints in your network successfully, you need the following in

deployments:

 A working IP network is established.

 VoIP gateways configured for SIP.

 The latest (or compatible) firmware of IP phones is available.

 A call server is active and configured to receive and send SIP messages.

 A text editor, such as UltraEdit, to create and edit boot files, configuration files and resource files.

Yealink IP Phones in a Network

Most Yealink IP phones are connected physically through a Category 5E (CAT5E) cable to a

10/100/1000Mbps Ethernet LAN, and send and receive all data using the same packet-based technology.

Some phones support wireless network.

Since the IP phone is a data terminal, digitized audio being just another type of data from its perspective,

the phone is capable of vastly more than traditional business phones. Moreover, Yealink IP phones run

the same protocols as your office personal computer, which means that you can develop many innovative

applications without resorting to specialized technology.

1

Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones

There are many ways to set up a phone network using Yealink IP phones. The following shows an

example of a network setup:

Initialization Process Overview

The initialization process of the IP phone is responsible for network connectivity and operation of the IP

phone in your local network. Once you connect your IP phone to the network and to an electrical supply,

the IP phone begins its initialization process.

Topics

Loading the ROM File

Configuring the VLAN

Querying the DHCP (Dynamic Host Configuration Protocol) Server

Contacting the Provisioning Server

2

Getting Started

Updating Firmware

Downloading the Resource Files

Loading the ROM File

The ROM file resides in the flash memory of the IP phone. The IP phone comes from the factory with a

ROM file preloaded. During initialization, the IP phone runs a bootstrap loader that loads and executes

the ROM file.

Configuring the VLAN

If you connect the IP phone to a switch, the switch notifies the IP phone of the VLAN information defined

on the switch (if using LLDP or CDP). The IP phone can then proceed with the DHCP request for its

network settings (if using DHCP).

Querying the DHCP (Dynamic Host Configuration Protocol)

Server

The IP phone is capable of querying a DHCP server.

After establishing network connectivity, the IP phone can obtain the following network parameters from

the DHCP server during initialization:

 IP Address

 Subnet Mask

 Default Gateway

 Primary DNS (Domain Name Server)

 Secondary DNS

By default, the IP phones obtain these parameters from a DHCPv4. You can configure network

parameters of the IP phone manually if any of them are not supplied by the DHCP server.

Contacting the Provisioning Server

If you configure the IP phone to obtain configurations from the provisioning server, it will be connected

to the provisioning server, and then download the boot file and configuration file(s) during startup. The

IP phone will be able to resolve and update configurations written in the configuration file(s). If the IP

phone does not obtain configurations from the provisioning server, the IP phone will use the

configurations stored in the flash memory.

3

Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones

Updating Firmware

If you define the access URL of firmware in the configuration file, the IP phone will download firmware

from the provisioning server. If the MD5 value of the downloaded firmware file differs from that stored in

the flash memory, the IP phone will perform a firmware update.

You can manually upgrade firmware if the IP phone does not download firmware from the provisioning

server.

Downloading the Resource Files

In addition to configuration file(s), the IP phone may require resource files before it provides service.

These resource files are optional, but if you deploy some particular features, these files are required.

Verifying Startup

After connected to the power and network, the IP phone begins the initialization process by cycling

through the following steps:

1. The power LED indicator glows red.

2. The message “Welcome Initializing… please wait” appears on the LCD screen when the IP phone

starts up.

3. The main LCD screen displays the following:

 Time and date

 Soft key labels

4. Press the OK/√ key or press Menu->Status to check the IP phone status, the LCD screen displays

the valid IP address, MAC address, firmware version, and so on.

If the IP phone has successfully passed through these steps, it starts up properly and is ready for

use.

4

Phone Network

Note

Yealink IP phones comply with the DHCPv4 specifications documented in RFC 2131, and DHCPv6
specifications documented in RFC 3315.

Phone Network

Yealink IP phones operate on an Ethernet local area network (LAN) or wireless network. You can

configure the local area network to accommodate a number of network designs, which varies by

organization and Yealink IP phones.

Topics

IPv4 and IPv6 Network Settings

DHCP Option for IPv4

DHCP Option for IPv6

VLAN

Wi-Fi

Real-Time Transport Protocol (RTP) Ports

Network Address Translation (NAT)

Internet Port and PC Port

VPN

Quality of Service (QoS)

802.1x Authentication

TR-069 Device Management

IPv4 and IPv6 Network Settings

Yealink IP Phones support IPv4 addressing mode, IPv6 addressing mode, as well as an IPv4&IPv6

dual-stack addressing mode.

After connected to the wired network, the phones can obtain the IPv4 or IPv6 network settings from a

Dynamic Host Configuration Protocol (DHCP) server if your network supports it. To make it easier to

manage IP settings, we recommend using automated DHCP which is possible to eliminate repetitive

manually data entry.

You can also configure IPv4 or IPv6 network settings manually.

Topics

IP Addressing Mode Configuration

IPv4 Configuration

5

Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones

Parameter

static.network.ip_address_mode

[1]

<y0000000000xx>.cfg

Description

It configures the IP addressing mode.

Permitted

Values

0-IPv4

1-IPv6

2-IPv4 & IPv6

Default

0

Web UI

Network->Basic->Internet Port->Mode(IPv4/IPv6)

Phone UI

T54S/T52S/T48S/T48G/T46S/T46G/T29G:

Menu->Advanced (default password: admin)->Network->WAN Port->IP Mode

T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2:

Menu->Settings->Advanced Settings (default password: admin)->Network->WAN

Port->IP Mode

Parameter

static.network.preference

[1]

<y0000000000xx>.cfg

Description

It specifies IPv4 or IPv6 as the preferred network in a Dual Stack mode.

Note: It works only if “static.network.ip_address_mode” is set to 2 (IPv4 & IPv6).

Permitted

Values

0-IPv6

1-IPv4

Default

0

Web UI

Network->Basic->Internet Port->Preference(IPv4/IPv6)

Phone UI

T54S/T52S/T48S/T48G/T46S/T46G/T29G:

Menu->Advanced (default password: admin) ->Network->WAN Port->Preference

T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2:

Menu->Settings->Advanced Settings (default password: admin)->Network->WAN

Port->Preference

Parameter

account.X.sip_server_mode

[2]

<MAC>.cfg

Description

It specifies the preferred network and query mode in a Dual Stack mode, when a

domain name is configured for a SIP server.

Note: It works only if “static.network.ip_address_mode” is set to 2 (IPv4 & IPv6).

Permitted

0-Specify IPv4 as the preferred network, and A query will be performed preferentially.

IPv6 Configuration

IP Addressing Mode Configuration

The following table lists the parameters you can use to configure IP addressing mode.

6

Phone Network

Values

1-Specify IPv6 as the preferred network, and AAAA query will be performed

preferentially.

2-The preferred network is configured by “static.network.preference”.

Default

0

Parameter

static.network.internet_port.type

[1]

<y0000000000xx>.cfg

Description

It configures the Internet port type for IPv4.

Note: It works only if “static.network.ip_address_mode” is set to 0 (IPv4) or 2 (IPv4 &

IPv6).

Permitted

Values

0-DHCP

2-Static IP Address

Default

0

Web UI

Network->Basic->IPv4 Config

Phone UI

T54S/T52S/T48S/T48G/T46S/T46G/T29G:

Menu->Advanced (default password: admin)->Network->WAN Port->IPv4

T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2:

Menu->Settings->Advanced Settings (default password: admin)->Network->WAN

Port->IPv4

Parameter

static.network.internet_port.ip

[1]

<y0000000000xx>.cfg

Description

It configures the IPv4 address.

Example:

static.network.internet_port.ip = 192.168.1.20

Note: It works only if “static.network.ip_address_mode” is set to 0 (IPv4) or 2 (IPv4 &
IPv6), and "static.network.internet_port.type" is set to 2 (Static IP Address).

Permitted

Values

IPv4 Address

Default

Blank

Web UI

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

[1]

If you change this parameter, the IP phone will reboot to make the change take effect.

[2]

X is the account ID. For T54S/T48S/T48G/T46S/T46G/T29G, X=1-16; for T52S/T42G/T42S, X=1-12; for

T41P/T41S/T27P/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2; for T19(P) E2, X=1.

IPv4 Configuration

The following table lists the parameters you can use to configure IPv4.

7

Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones

Phone UI

T54S/T52S/T48S/T48G/T46S/T46G/T29G:

Menu->Advanced (default password: admin)->Network->WAN Port->IPv4->Static

IP->IP Address

T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2:

Menu->Settings->Advanced Settings (default password: admin)->Network->WAN

Port->IPv4->Static IPv4 Client->IP Address

Parameter

static.network.internet_port.mask

[1]

<y0000000000xx>.cfg

Description

It configures the IPv4 subnet mask.

Example:

static.network.internet_port.mask = 255.255.255.0

Note: It works only if “static.network.ip_address_mode” is set to 0 (IPv4) or 2 (IPv4 &

IPv6), and "static.network.internet_port.type" is set to 2 (Static IP Address).

Permitted

Values

Subnet Mask

Default

Blank

Web UI

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

Phone UI

T54S/T52S/T48S/T48G/T46S/T46G/T29G:

Menu->Advanced (default password: admin)->Network->WAN Port->IPv4->Static

IP->Subnet Mask

T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2:

Menu->Settings->Advanced Settings (default password: admin)->Network->WAN

Port->IPv4->Static IPv4 Client->Subnet Mask

Parameter

static.network.internet_port.gateway

[1]

<y0000000000xx>.cfg

Description

It configures the IPv4 default gateway.

Example:

static.network.internet_port.gateway = 192.168.1.254

Note: It works only if “static.network.ip_address_mode” is set to 0 (IPv4) or 2 (IPv4 &

IPv6), and "static.network.internet_port.type" is set to 2 (Static IP Address).

Permitted

Values

IPv4 Address

Default

Blank

Web UI

Network->Basic->IPv4 Config->Static IP Address->Default Gateway

Phone UI

T54S/T52S/T48S/T48G/T46S/T46G/T29G:

Menu->Advanced (default password: admin)->Network->WAN Port->IPv4->Static

IP->Default Gateway

8

Phone Network

T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2:

Menu->Settings->Advanced Settings (default password: admin)->Network->WAN

Port->IPv4->Static IPv4 Client->Default Gateway

Parameter

static.network.static_dns_enable

[1]

<y0000000000xx>.cfg

Description

It triggers the static DNS feature to on or off.

Note: It works only if “static.network.internet_port.type” is set to 0 (DHCP).

Permitted

Values

0-Off, the IP phone will use the IPv4 DNS obtained from DHCP.

1-On, the IP phone will use manually configured static IPv4 DNS.

Default

0

Web UI

Network->Basic->IPv4 Config->Static DNS

Phone UI

T54S/T52S/T48S/T48G/T46S/T46G/T29G:

Menu->Advanced (default password: admin) ->Network->WAN

Port->IPv4->Type(DHCP)->Static DNS

T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2:

Menu->Settings->Advanced Settings (default password: admin) ->Network->WAN

Port->IPv4->DHCP IPv4 Client->Static DNS

Parameter

static.network.primary_dns

[1]

<y0000000000xx>.cfg

Description

It configures the primary IPv4 DNS server.

Example:

static.network.primary_dns = 202.101.103.55

Note: It works only if “static.network.ip_address_mode” is set to 0 (IPv4) or 2 (IPv4 &

IPv6). In DHCP environment, you also need to make sure

“static.network.static_dns_enable" is set to 1 (On).

Permitted

Values

IPv4 Address

Default

Blank

Web UI

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

Phone UI

T54S/T52S/T48S/T48G/T46S/T46G/T29G:

Menu->Advanced (default password: admin)->Network->WAN Port->IPv4->Static

IP->Primary DNS

Or Menu->Settings->Advanced (default password: admin)->Network->WAN

Port->IPv4->DHCP->Static DNS (Enabled) ->Primary DNS

T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2:

Menu->Settings->Advanced Settings (default password: admin)->Network->WAN

Port->IPv4->Static IPv4 Client->Pri.DNS

Or Menu->Settings->Advanced Settings (default password: admin)->Network->WAN

9

Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones

Port->IPv4->DHCP IPv4 Client->Static DNS (Enabled) ->Pri.DNS

Parameter

static.network.secondary_dns

[1]

<y0000000000xx>.cfg

Description

It configures the secondary IPv4 DNS server.

Example:

static.network.secondary_dns = 202.101.103.54

Note: It works only if “static.network.ip_address_mode” is set to 0 (IPv4) or 2 (IPv4 &

IPv6). In DHCP environment, you also need to make sure

“static.network.static_dns_enable" is set to 1 (On).

Permitted

Values

IPv4 Address

Default

Blank

Web UI

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

Phone UI

T54S/T52S/T48S/T48G/T46S/T46G/T29G:

Menu->Advanced (default password: admin)->Network->WAN Port->IPv4->Static

IP->Secondary DNS

Or Menu->Advanced (default password: admin)->Network->WAN

Port->IPv4->DHCP->Static DNS (Enabled) ->Secondary DNS

T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2:

Menu->Settings->Advanced Settings (default password: admin)->Network->WAN

Port->IPv4->Static IPv4 Client->Sec.DNS

Or Menu->Settings->Advanced Settings (default password: admin)->Network->WAN

Port->IPv4->DHCP IPv4 Client->Static DNS (Enabled) ->Sec.DNS

Parameter

static.network.ipv6_internet_port.type

[1]

<y0000000000xx>.cfg

Description

It configures the Internet port type for IPv6.

Note: It works only if “static.network.ip_address_mode” is set to 1 (IPv6) or 2 (IPv4 &

IPv6).

[1]

If you change this parameter, the IP phone will reboot to make the change take effect.

IPv6 Configuration

If you configure the network settings on the phone for an IPv6 network, you can set up an IP address for

the phone by using SLAAC (ICMPv6), DHCPv6 or by manually entering an IP address. Ensure that your

network environment supports IPv6. Contact your ISP for more information.

When you enable both SLAAC and DHCPv6 on the phone, the server can specify the IP phone to obtain

the IPv6 address and other network settings either from SLAAC or from DHCPv6, if the SLAAC server is

not working, the IP phone will try to obtain the IPv6 address and other network settings via DHCPv6.

The following table lists the parameters you can use to configure IPv6.

10

Phone Network

Permitted

Values

0-DHCP

1-Static IP Address

Default

0

Web UI

Network->Basic->IPv6 Config

Phone UI

T54S/T52S/T48S/T48G/T46S/T46G/T29G:

Menu->Advanced (default password: admin)->Network->WAN Port->IPv6

T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2:

Menu->Settings->Advanced Settings (default password: admin)->Network->WAN

Port->IPv6

Parameter

static.network.ipv6_internet_port.ip

[1]

<y0000000000xx>.cfg

Description

It configures the IPv6 address.

Example:

static.network.ipv6_internet_port.ip = 2026:1234:1:1:215:65ff:fe1f:caa

Note: It works only if “static.network.ip_address_mode” is set to 1 (IPv6) or 2 ( IPv4 &
IPv6), and "static.network.ipv6_internet_port.type" is set to 1 (Static IP Address).

Permitted

Values

IPv6 Address

Default

Blank

Web UI

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

Phone UI

T54S/T52S/T48S/T48G/T46S/T46G/T29G:

Menu->Advanced (default password: admin)->Network->WAN Port->IPv6->Static

IP->IP Address

T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2:

Menu->Settings->Advanced Settings (default password: admin)->Network->WAN

Port->IPv6->Static IPv6 Client->IP Address

Parameter

static.network.ipv6_prefix

[1]

<y0000000000xx>.cfg

Description

It configures the IPv6 prefix.

Note: It works only if “static.network.ip_address_mode” is set to 1 (IPv6) or 2 (IPv4 &
IPv6), and "static.network.ipv6_internet_port.type" is set to 1 (Static IP Address).

Permitted

Values

Integer from 0 to 128

Default

64

Web UI

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

Phone UI

T54S/T52S/T48S/T48G/T46S/T46G/T29G:

Menu->Advanced (default password: admin)->Network->WAN Port->IPv6->Static

11

Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones

IP->IPv6 IP Prefix

T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2:

Menu->Settings->Advanced Settings (default password: admin)->Network->WAN

Port->IPv6->Static IPv6 Client->IPv6 IP Prefix

Parameter

static.network.ipv6_internet_port.gateway

[1]

<y0000000000xx>.cfg

Description

It configures the IPv6 default gateway.

Example:

static.network.ipv6_internet_port.gateway = 3036:1:1:c3c7:c11c:5447:23a6:255

Note: It works only if “static.network.ip_address_mode” is set to 1 (IPv6) or 2 ( IPv4 &

IPv6), and "static.network.ipv6_internet_port.type" is set to 1 (Static IP Address).

Permitted

Values

IPv6 Address

Default

Blank

Web UI

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

Phone UI

T54S/T52S/T48S/T48G/T46S/T46G/T29G:

Menu->Advanced (default password: admin)->Network->WAN Port->IPv6->Static

IP->Default Gateway

T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2:

Menu->Settings->Advanced Settings (default password: admin)->Network->WAN

Port->IPv6->Static IPv6 Client->Default Gateway

Parameter

static.network.ipv6_static_dns_enable

[1]

<y0000000000xx>.cfg

Description

It triggers the static IPv6 DNS feature to on or off.

Note: It works only if “static.network.ipv6_internet_port.type” is set to 0 (DHCP).

Permitted

Values

0-Off, the IP phone will use the IPv6 DNS obtained from DHCP.

1-On, the IP phone will use manually configured static IPv6 DNS.

Default

0

Web UI

Network->Basic->IPv6 Config->IPv6 Static DNS

Phone UI

T54S/T52S/T48S/T48G/T46S/T46G/T29G:

Menu->Advanced (default password: admin) ->Network->WAN

Port->IPv6->Type(DHCP)->Static DNS

T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2:

Menu->Settings->Advanced Settings (default password: admin) ->Network->WAN

Port->IPv6->DHCP IPv6 Client->Static DNS

Parameter

static.network.ipv6_primary_dns

[1]

<y0000000000xx>.cfg

Description

It configures the primary IPv6 DNS server.

12

Phone Network

Example:

static.network.ipv6_primary_dns = 3036:1:1:c3c7:c11c:5447:23a6:256

Note: It works only if “static.network.ip_address_mode" is set to 1 (IPv6) or 2 (IPv4 &

IPv6). In DHCP environment, you also need to make sure
“static.network.ipv6_static_dns_enable" is set to 1 (On).

Permitted

Values

IPv6 Address

Default

Blank

Web UI

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

Phone UI

T54S/T52S/T48S/T48G/T46S/T46G/T29G:

Menu->Advanced (default password: admin)->Network->WAN Port->IPv6->Static

IP->Primary DNS

Or Menu->Advanced (default password: admin)->Network->WAN

Port->IPv6->DHCP->Static DNS(Enabled) ->Primary DNS

T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2:

Menu->Settings->Advanced Settings (default password: admin)->Network->WAN

Port->IPv6->Static IPv6 Client->Pri.DNS

Or Menu->Settings->Advanced Settings (default password: admin)->Network->WAN

Port->IPv6->DHCP IPv6 Client->Static DNS(Enabled) ->Pri.DNS

Parameter

static.network.ipv6_secondary_dns

[1]

<y0000000000xx>.cfg

Description

It configures the secondary IPv6 DNS server.

Example:

static.network.ipv6_secondary_dns = 2026:1234:1:1:c3c7:c11c:5447:23a6

Note: It works only if “static.network.ip_address_mode" is set to 1 (IPv6) or 2 (IPv4 &

IPv6). In DHCP environment, you also need to make sure
“static.network.ipv6_static_dns_enable" is set to 1 (On).

Permitted

Values

IPv6 Address

Default

Blank

Web UI

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

Phone UI

T54S/T52S/T48S/T48G/T46S/T46G/T29G:

Menu->Advanced (default password: admin)->Network->WAN Port->IPv6->Static

IP->Secondary DNS

Or Menu->Advanced (default password: admin)->Network->WAN

Port->IPv6->DHCP->Static DNS(Enabled) ->Secondary DNS

T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2:

Menu->Settings->Advanced Settings (default password: admin)->Network->WAN

13

Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones

Port->IPv6->Static IPv6 Client->Sec.DNS

Or Menu->Settings->Advanced Settings (default password: admin)->Network->WAN

Port->IPv6->DHCP IPv6 Client->Static DNS(Enabled) ->Sec.DNS

Parameter

static.network.ipv6_icmp_v6.enable

[1]

<y0000000000xx>.cfg

Description

It enables or disables the IP phone to obtain IPv6 network settings via SLAAC

(Stateless Address Autoconfiguration).

Note: It works only if “static.network.ipv6_internet_port.type” is set to 0 (DHCP). It is

only applicable to T54S/T52S/T48S/T48G/T46S/T46G/T29G IP phones. SLAAC is

enabled on T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P)

E2/T19(P) E2 IP phones by default. You are not allowed to configure this parameter for

these IP phones.

Permitted

Values

0-Disabled

1-Enabled

Default

1

Web UI

Network->Advanced->ICMPv6 Status->Active

Note

For more information on DHCP options, refer to RFC 2131 or RFC 2132.

Parameters

DHCP Option

Description

Subnet Mask

1

Specify the client’s subnet mask.

[1]

If you change this parameter, the IP phone will reboot to make the change take effect.

DHCP Option for IPv4

The IP phone can obtain IPv4-related parameters in an IPv4 network via DHCP option.

Topics

Supported DHCP Option for IPv4

DHCP Option 66, Option 43 and Custom Option

DHCP Option 42, Option 2 and Option 100

DHCP Option 12

DHCP Option 120

DHCP Option 60

Supported DHCP Option for IPv4

The following table lists common DHCP options for IPv4 supported by Yealink IP phones.

14

Phone Network

Parameters

DHCP Option

Description

Time Offset

2

Specify the offset of the client's subnet in seconds

from Coordinated Universal Time (UTC).

Router

3

Specify a list of IP addresses for routers on the

client’s subnet.

Time Server

4

Specify a list of time servers available to the client.

Domain Name

Server

6

Specify a list of domain name servers available to

the client.

Host Name

12

Specify the name of the client.

Domain Server

15

Specify the domain name that client should use

when resolving hostnames via DNS.

Network Time

Protocol Servers

42

Specify a list of NTP servers available to the client

by IP address.

Vendor-Specific

Information

43

Identify the vendor-specific information.

Vendor Class

Identifier

60

Identify the vendor type.

TFTP Server Name

66

Identify a TFTP server when the 'sname' field in

the DHCP header has been used for DHCP

options.

Timezone/DST

100

Specify a POSIX timezone string.

SIP

Server/outbound

proxy server

120

Convey a SIP server’s or outbound proxy server’s

location to the client.

Note

If you fail to configure the DHCP options for discovering the provisioning server on the DHCP server, an
alternate method of automatically discovering the provisioning server address is required. One possibility is

DHCP Option 66, Option 43 and Custom Option

During the startup, the phone will automatically detect the custom option, option 66, or option 43 for

obtaining the provisioning server address. The priority of obtaining the provisioning server address is as

follows: custom option>option 66 (identify the TFTP server)>option 43.

The IP phone can obtain the Auto Configuration Server (ACS) address by detecting option 43 during

startup.

To obtain the server address via DHCP option, make sure you have configured the DHCP option on the

phone. The option must be in accordance with the one defined in the DHCP server.

15

Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones

Note

that connecting to the secondary DHCP server that responds to DHCP INFORM queries with a requested
provisioning server address. For more information, refer to RFC 3925. If a single alternate DHCP server
responds, this is functionally equivalent to the scenario where the primary DHCP server responds with a
valid provisioning server address. If no DHCP server responds, the INFORM query process will retry and
eventually time out.

Parameter

static.network.dhcp_host_name

[1]

<y0000000000xx>.cfg

Description

It configures the DHCP Option 12 Hostname on the IP phone.

Permitted

Values

String within 99 characters

Default

For T54S IP phones: SIP-T54S.

Related Topic

DHCP Provision Configuration

DHCP Option 42, Option 2 and Option 100

Yealink IP phones support using the NTP server address offered by DHCP.

DHCP option 42 is used to specify a list of NTP servers available to the client by IP address. NTP servers

should be listed in order of preference.

DHCP option 2 is used to specify the offset of the client’s subnet in seconds from Coordinated Universal

Time (UTC).

DHCP option 100 is used to specify the timezone information (time zone and daylight-saving offset). The

priority is as follows: option 100>option 2.

Related Topic

NTP Settings

DHCP Option 12

You can specify a hostname for the phone when using DHCP. The DHCP client uses option 12 to send a

predefined hostname to the DHCP registration server. The name may or may not be qualified with the

local domain name (based on RFC 2132). See RFC 1035 for character restrictions.

Topic

DHCP Option 12 Hostname Configuration

DHCP Option 12 Hostname Configuration

The following table lists the parameter you can use to configure DHCP option 12 hostname.

16

Phone Network

For T52S IP phones: SIP-T52S.

For T48G IP phones: SIP-T48G.

For T48S IP phones: SIP-T48S.

For T46G IP phones: SIP-T46G.

For T46S IP phones: SIP-T46S.

For T42G IP phones: SIP-T42G.

For T42S IP phones: SIP-T42S.

For T41P IP phones: SIP-T41P.

For T41S IP phones: SIP-T41S.

For T40P IP phones: SIP-T40P.

For T40G IP phones: SIP-T40G.

For T29G IP phones: SIP-T29G.

For T27P IP phones: SIP-T27P.

For T27G IP phones: SIP-T27G.

For T23P IP phones: SIP-T23P.

For T23G IP phones: SIP-T23G.

For T21(P) E2 IP phones: SIP-T21P_E2.

For T19(P) E2 IP phones: SIP-T19P_E2.

Web UI

Features->General Information->DHCP Hostname

Parameter

sip.dhcp.option120.mode

<y0000000000xx>.cfg

Description

It configures whether to use DHCP option 120 for obtaining the outbound proxy

server IP address.

Permitted

Values

0-Do not check with the DHCP server for the outbound proxy server IP address.

1-The value obtained from DHCP option 120 is used as outbound proxy server IP

address (can resolve up to two domain names or IPv4 addresses). If

[1]

If you change this parameter, the IP phone will reboot to make the change take effect.

DHCP Option 120

The DHCP option 120 is used by the SIP client to locate a local outbound proxy server.

Topic

DHCP Option 120 Configuration

DHCP Option 120 Configuration

The following table lists the parameter you can use to configure DHCP option 120.

17

Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones

“account.X.outbound_proxy_enable = 1”, and primary outbound proxy server is

configured, the address from DHCP option 120 is used as secondary one; if primary

outbound proxy server is not configured, the address from DHCP option 120 is used

as primary one.

2-The value obtained from DHCP option 120 is used as SIP server IP address (can

resolve up to only one IPv4 address). If primary SIP server is configured, the address

from DHCP option 120 is used as secondary one; if primary SIP server is not

configured, the address from DHCP option 120 is used as primary one.

Default

0

Note

The default vendor class ID is “yealink”.

Parameter

static.network.dhcp.option60type

<y0000000000xx>.cfg

Description

It configures the DHCP option 60 type.

Permitted

Values

0-ASCII

1-Binary (RFC 3925)

Default

0

Parameter

static.auto_provision.dhcp_option.option60_value

<y0000000000xx>.cfg

Description

It configures the value (vendor name of the device) of DHCP option 60.

Permitted

Values

String within 99 characters

Default

yealink

Web UI

Settings->Auto Provision->IPv4 DHCP Option Value

DHCP Option 60

DHCP option 60 is used to identify the vendor and functionality of a DHCP client. You can set the format

for option 60.

Topic

DHCP Option 60 Configuration

DHCP Option 60 Configuration

The following table lists the parameter you can use to configure DHCP option 60.

18

DHCP Option for IPv6

Parameters

DHCP Option

Description

DNS Server

23

Specify a list of DNS servers available to the

client.

DNS Domain Search List

24

Specify a domain search list to a client.

SNTP Server

31

Specify a list of Simple Network Time

Protocol (SNTP) servers available to the

client.

Information Refresh Time

32

Specify an upper bound for how long a

client should wait before refreshing

information retrieved from DHCPv6.

Boot File URL

59

Specify a URL for the boot file to be

downloaded by the client.

The IP phone can obtain IPv6-related parameters in an IPv6 network via DHCP option.

Topics

Supported DHCP Option for IPv6

DHCP Option 59 and Custom Option

Supported DHCP Option for IPv6

The following table lists common DHCP options for IPv6 supported by Yealink IP phones.

Phone Network

DHCP Option 59 and Custom Option

During the startup, the phone will automatically detect the custom option or option 59 for obtaining the

provisioning server address. The priority of obtaining the provisioning server address is as follows:

custom option>option 59.

Related Topic

DHCP Provision Configuration

VLAN

The purpose of VLAN configurations on the IP phone is to insert tag with VLAN information to the

packets generated by the IP phone. When VLAN is properly configured for the ports (Internet port and PC

port) on the IP phone, the IP phone will tag all packets from these ports with the VLAN ID. The switch

19

Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones

Parameter

static.network.lldp.enable

[1]

<y0000000000xx>.cfg

Description

It enables or disables the LLDP (Linker Layer Discovery Protocol) feature on the IP

phone.

Permitted

Values

0-Disabled

1-Enabled, the IP phone will attempt to determine its VLAN ID through LLDP.

Default

1

Web UI

Network->Advanced->LLDP->Active

Phone UI

T54S/T52S/T48S/T48G/T46S/T46G/T29G:

receives and forwards the tagged packets to the corresponding VLAN according to the VLAN ID in the

tag as described in IEEE Std 802.3.

VLAN on IP phones allows simultaneous access to a regular PC. This feature allows a PC to be daisy

chained to an IP phone and the connection for both PC and IP phone to be trunked through the same

physical Ethernet cable.

In addition to manual configuration, the IP phone also supports automatic discovery of VLAN via LLDP,

CDP or DHCP. The assignment takes effect in this order: assignment via LLDP/CDP, manual configuration,

then assignment via DHCP.

For more information on VLAN, refer to VLAN Feature on Yealink IP Phones.

Topics

LLDP Configuration

CDP Configuration

Manual VLAN Configuration

DHCP VLAN

VLAN Setting Configuration

LLDP Configuration

LLDP (Linker Layer Discovery Protocol) is a vendor-neutral Link Layer protocol, which allows IP phones to

receive and/or transmit device-related information from/to directly connected devices on the network

that are also using the protocol, and store the information about other devices.

When LLDP feature is enabled on IP phones, the IP phones periodically advertise their own information to

the directly connected LLDP-enabled switch. The IP phones can also receive LLDP packets from the

connected switch. When the application type is “voice”, the IP phones decide whether to update the

VLAN configurations obtained from the LLDP packets. When the VLAN configurations on the IP phones

are different from the ones sent by the switch, the IP phones perform an update and reboot. This allows

the IP phones to plug into any switch, obtain their VLAN IDs, and then start communications with the call

control.

The following table lists the parameters you can use to configure LLDP.

20

Phone Network

Menu->Advanced (default password: admin) ->Network->LLDP->LLDP Status

T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2:

Menu->Settings->Advanced Settings (default password: admin)

->Network->LLDP->LLDP Status

Parameter

static.network.lldp.packet_interval

[1]

<y0000000000xx>.cfg

Description

It configures the interval (in seconds) that how often the IP phone sends the LLDP

(Linker Layer Discovery Protocol) request.

Note: It works only if “static.network.lldp.enable” is set to 1 (Enabled).

Permitted

Values

Integer from 1 to 3600

Default

60

Web UI

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

Phone UI

T54S/T52S/T48S/T48G/T46S/T46G/T29G:

Menu->Advanced (default password: admin) ->Network->LLDP->Packet Interval

T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2:

Menu->Settings->Advanced Settings (default password: admin)

->Network->LLDP->Packet Interval

Parameter

static.network.cdp.enable

[1]

<y0000000000xx>.cfg

Description

It enables or disables the CDP (Cisco Discovery Protocol) feature on the IP phone.

Permitted

Values

0-Disabled

1-Enabled, the IP phone will attempt to determine its VLAN ID through CDP.

Default

1

Web UI

Network->Advanced->CDP->Active

[1]

If you change this parameter, the IP phone will reboot to make the change take effect.

CDP Configuration

CDP (Cisco Discovery Protocol) allows IP phones to receive and/or transmit device-related information

from/to directly connected devices on the network that are also using the protocol, and store the

information about other devices.

If the CDP feature is enabled on IP phones, the IP phones will periodically advertise their own information

to the directly connected CDP-enabled switch. The IP phones can also receive CDP packets from the

connected switch. If the VLAN configurations on the IP phones are different from the ones sent by the

switch, the IP phones will perform an update and reboot. This allows you to connect the IP phones into

any switch, obtain their VLAN IDs, and then start communications with the call control.

The following table lists the parameters you can use to configure CDP.

21

Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones

Phone UI

T54S/T52S/T48S/T48G/T46S/T46G/T29G:

Menu->Advanced (default password: admin) ->Network->CDP->CDP Status

T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2:

Menu->Settings->Advanced Settings (default password: admin)

->Network->CDP->CDP Status

Parameter

static.network.cdp.packet_interval

[1]

<y0000000000xx>.cfg

Description

It configures the interval (in seconds) at which the IP phone sends the CDP (Cisco

Discovery Protocol) request.

Note: It works only if “static.network.cdp.enable” is set to 1 (Enabled).

Permitted

Values

Integer from 1 to 3600

Default

60

Web UI

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

Phone UI

T54S/T52S/T48S/T48G/T46S/T46G/T29G:

Menu->Advanced (default password: admin) ->Network->CDP->CDP Interval

T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2:

Menu->Settings->Advanced Settings (default password: admin)

->Network->CDP->CDP Interval

Parameter

static.network.vlan.internet_port_enable

[1]

<y0000000000xx>.cfg

Description

It enables or disables the VLAN for the Internet port.

Permitted

Values

0-Disabled

1-Enabled

Default

0

Web UI

Network->Advanced->VLAN->WAN Port->Active

Phone UI

T54S/T52S/T48S/T48G/T46S/T46G/T29G:

Menu->Advanced (default password: admin) ->Network->VLAN->WAN Port->VLAN

Status

T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2:

Manual VLAN Configuration

VLAN is disabled on IP phones by default. You can configure VLAN for the Internet port and PC port

manually. Before configuring VLAN on the IP phone, you need to obtain the VLAN ID from your network

administrator.

The following table lists the parameters you can use to configure VLAN manually.

22

Phone Network

Menu->Settings->Advanced Settings (default password: admin)

->Network->VLAN->WAN Port->VLAN Status

Parameter

static.network.vlan.internet_port_vid

[1]

<y0000000000xx>.cfg

Description

It configures the VLAN ID for the Internet port.

Note: It works only if “static.network.vlan.internet_port_enable” is set to 1 (Enabled).

Permitted

Values

Integer from 1 to 4094

Default

1

Web UI

Network->Advanced->VLAN->WAN Port->VID (1-4094)

Phone UI

T54S/T52S/T48S/T48G/T46S/T46G/T29G:

Menu->Advanced (default password: admin) ->Network->VLAN->WAN Port->VID

Number

T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2:

Menu->Settings->Advanced Settings (default password: admin)

->Network->VLAN->WAN Port->VID Number

Parameter

static.network.vlan.internet_port_priority

[1]

<y0000000000xx>.cfg

Description

It configures the VLAN priority for the Internet port.

7 is the highest priority, 0 is the lowest priority.

Note: It works only if “static.network.vlan.internet_port_enable” is set to 1 (Enabled).

Permitted

Values

Integer from 0 to 7

Default

0

Web UI

Network->Advanced->VLAN->WAN Port->Priority

Phone UI

T54S/T52S/T48S/T48G/T46S/T46G/T29G:

Menu->Advanced (default password: admin) ->Network->VLAN->WAN

Port->Priority

T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2:

Menu->Settings->Advanced Settings (default password: admin)

->Network->VLAN->WAN Port->Priority

Parameter

static.network.vlan.pc_port_enable

[1]

<y0000000000xx>.cfg

Description

It enables or disables the VLAN for the PC port.

Note: It works only if “static.network.pc_port.enable” is set to 1 (Auto Negotiation).

Permitted

Values

0-Disabled

1-Enabled

23

Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones

Default

0

Web UI

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

Phone UI

T54S/T52S/T48S/T48G/T46S/T46G/T29G:

Menu-> Advanced (default password: admin) ->Network->VLAN->PC Port->VLAN

Status

T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2:

Menu->Settings->Advanced Settings (default password: admin)

->Network->VLAN->PC Port->VLAN Status

Parameter

static.network.vlan.pc_port_vid

[1]

<y0000000000xx>.cfg

Description

It configures the VLAN ID for the PC port.

Note: It works only if “static.network.pc_port.enable” is set to 1 (Auto Negotiation)

and “static.network.vlan.pc_port_enable” is set to 1 (Enabled).

Permitted

Values

Integer from 1 to 4094

Default

1

Web UI

Network->Advanced->VLAN->PC Port->VID (1-4094)

Phone UI

T54S/T52S/T48S/T48G/T46S/T46G/T29G:

Menu->Advanced (default password: admin) ->Network->VLAN->PC Port->VID

Number

T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2:

Menu->Settings->Advanced Settings (default password: admin)

->Network->VLAN->PC Port->VID Number

Parameter

static.network.vlan.pc_port_priority

[1]

<y0000000000xx>.cfg

Description

It configures the VLAN priority for the PC port.

7 is the highest priority, 0 is the lowest priority.

Note: It works only if “static.network.pc_port.enable” is set to 1 (Auto Negotiation)
and “static.network.vlan.pc_port_enable” is set to 1 (Enabled).

Permitted

Values

Integer from 0 to 7

Default

0

Web UI

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

Phone UI

T54S/T52S/T48S/T48G/T46S/T46G/T29G:

Menu->Advanced (default password: admin) ->Network->VLAN->PC Port->Priority

T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2:

Menu->Settings->Advanced Settings (default password: admin)

24

Phone Network

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

Parameter

static.network.vlan.dhcp_enable

[1]

<y0000000000xx>.cfg

Description

It enables or disables the DHCP VLAN discovery feature on the IP phone.

Permitted

Values

0-Disabled

1-Enabled

Default

1

Web UI

Network->Advanced->VLAN->DHCP VLAN->Active

Phone UI

T54S/T52S/T48S/T48G/T46S/T46G/T29G:

Menu->Advanced (default password: admin) ->Network->VLAN->DHCP

VLAN->DHCP VLAN

T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2:

Menu->Settings->Advanced Settings (default password: admin)

->Network->VLAN->DHCP VLAN->DHCP VLAN

Parameter

static.network.vlan.dhcp_option

[1]

<y0000000000xx>.cfg

Description

It configures the DHCP option from which the IP phone will obtain the VLAN settings.

You can configure at most five DHCP options and separate them by commas.

Permitted

Values

Integer from 1 to 255

Default

132

Web UI

Network->Advanced->VLAN->DHCP VLAN->Option (1-255)

Phone UI

T54S/T52S/T48S/T48G/T46S/T46G/T29G:

Menu->Advanced (default password: admin) ->Network->VLAN->DHCP

VLAN->Option

T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2:

Menu->Settings->Advanced Settings (default password: admin)

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

[1]

If you change this parameter, the IP phone will reboot to make the change take effect.

DHCP VLAN

Yealink IP phones support VLAN discovery via DHCP. When the VLAN discovery method is set to DHCP,

the IP phone will examine DHCP option for a valid VLAN ID. The predefined option 132 is used to supply

the VLAN ID by default. You can customize the DHCP option used to request the VLAN ID.

The following table lists the parameters you can use to configure DHCP VLAN discovery.

[1]

If you change this parameter, the IP phone will reboot to make the change take effect.

25

Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones

Parameter

static.network.vlan.vlan_change.enable

[1]

<y0000000000xx>.cfg

Description

It enables or disables the IP phone to obtain VLAN ID using lower preference of VLAN

assignment method or to close the VLAN feature when the IP phone cannot obtain

VLAN ID using the current VLAN assignment method.

The priority of each method is: LLDP/CDP>Manual>DHCP VLAN.

Permitted

Values

0-Disabled

1-Enabled, the IP phone will attempt to use the lower priority method when failing to

obtain the VLAN ID using higher priority method. If all the methods are attempted, the

phone will disable VLAN feature.

Default

0

Note

To use Wi-Fi feature, make sure the Wi-Fi USB dongle is properly connected to the USB port on the back of
the phone. The Wi-Fi USB dongle should be purchased separately.

Parameter

static.wifi.function.enable

[1]

<y0000000000xx>.cfg

VLAN Setting Configuration

The following table lists the parameter you can use to configure VLAN setting.

[1]

If you change this parameter, the IP phone will reboot to make the change take effect.

Wi-Fi

Wi-Fi feature enables you to connect the phones to the organization’s wireless network. The wireless

network is more convenient and cost-effective than wired network. Wi-Fi feature is only applicable to

T54S/T52S/T48S/T48G/T46S/T46G/T42S/T41S/T29G/T27G IP phones.

When the Wi-Fi feature is enabled, the IP phone will automatically scan the available wireless networks.

All the available wireless networks will display in scanning list on the LCD screen. You can store up to 5

frequently used wireless networks on your phone and specify the priority for them.

You can check the Wi-Fi dongle MAC address at the path: Menu->Status->Wi-Fi MAC (phone user

interface) or Status->Status->Network Common->Wi-Fi MAC (web user interface).

Topic

Wi-Fi Configuration

Wi-Fi Configuration

The following table lists the parameters you can use to configure Wi-Fi.

26

Phone Network

Description

It enables or disables the Wi-Fi feature.

Note: It is only applicable to

T54S/T52S/T48S/T48G/T46S/T46G/T42S/T41S/T29G/T27G IP phones.

Permitted

Values

0-Disabled

1-Enabled

Default

1

Parameter

static.network.redundancy.mode

[1]

<y0000000000xx>.cfg

Description

It configures the network connection mode to be used preferentially.

Note: It is only applicable to

T54S/T52S/T48S/T48G/T46S/T46G/T42S/T41S/T29G/T27G IP phones.

Permitted

Values

0-If Wi-Fi mode is activated, the wired network is unavailable; Wi-Fi mode must be

deactivated if you want to use the wired network.

1-Use wireless network preferentially.

2-Use wired network preferentially.

Default

0

Parameter

static.network.redundancy.failback.timeout

[1]

<y0000000000xx>.cfg

Description

It configures the time to wait (minutes) for the IP phone to switch to the preferred

network (configured by “static.network.redundancy.mode”).

Note: It works only if “static.network.redundancy.mode” is set to 1 or 2. It is only

applicable to T54S/T52S/T48S/T48G/T46S/T46G/T42S/T41S/T29G/T27G IP phones.

Permitted

Values

Integer from 0 to 1440

0-The phone will not switch as long as the current network is available.

1 to 1440–The phone will keep using the current network for the specified time after

the preferentially used network becomes available. If the preferentially used network

is still available after the specified time, the phone performs a network switch while

the phone is not in use.

Default

55

Parameter

static.wifi.enable

<y0000000000xx>.cfg

Description

It activates or deactivates the Wi-Fi mode.

Note: It is only applicable to

T54S/T52S/T48S/T48G/T46S/T46G/T42S/T41S/T29G/T27G IP phones. It works only if

“static.wifi.function.enable” is set to 1 (Enabled).

Permitted

Values

0-Disabled

1-Enabled

Default

0

27

Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones

Web UI

Network->Wi-Fi->Wi-Fi Active

Phone UI

T54S/T52S/T48S/T48G/T46S/T46G/T29G:

Menu->Basic->Wi-Fi->Wi-Fi

T42S/T41S/T27G:

Menu->Settings->Basic Settings->Wi-Fi

Parameter

static.wifi.X.label

[2]

<y0000000000xx>.cfg

Description

It configures the profile name of the wireless network X for the IP phone.

Note: It works only if “static.wifi.enable” is set to 1 (Enabled). It is only applicable to

T54S/T52S/T48S/T48G/T46S/T46G/T42S/T41S/T29G/T27G IP phones.

Permitted

Values

String within 32 characters

Default

Blank

Web UI

Network->Wi-Fi->Profile Name

Phone UI

T54S/T52S/T48S/T48G/T46S/T46G/T29G:

Menu->Basic->Wi-Fi->Wi-Fi (On)->Known Network (press Add)->Profile Name

or

Menu->Basic->Wi-Fi->Wi-Fi (On)->Known Network->Option->Edit->Profile Name

T42S/T41S/T27G:

Menu->Settings->Basic Settings->Wi-Fi (On)->Known Network (press Add)->Profile

Name

or

Menu->Settings->Basic Settings->Wi-Fi->Wi-Fi (On)->Known

Network->Option->Edit->Profile Name

Parameter

static.wifi.X.ssid

[2]

<y0000000000xx>.cfg

Description

It configures the Service Set Identifier (SSID) of the wireless network X.

SSID is a unique identifier for accessing wireless access points.

Note: It works only if “static.wifi.enable” is set to 1 (Enabled). It is only applicable to

T54S/T52S/T48S/T48G/T46S/T46G/T42S/T41S/T29G/T27G IP phones.

Permitted

Values

String within 32 characters

Default

Blank

Web UI

Network->Wi-Fi->SSID

Phone UI

T54S/T52S/T48S/T48G/T46S/T46G/T29G:

Menu->Basic->Wi-Fi->Wi-Fi (On)->Known Network (press Add)->SSID

or

28

Phone Network

Menu->Basic->Wi-Fi->Wi-Fi (On)->Known Network->Option->Edit->SSID

T42S/T41S/T27G:

Menu->Settings->Basic Settings->Wi-Fi (On)->Known Network (press Add)->SSID

or

Menu->Settings->Basic Settings->Wi-Fi->Wi-Fi (On)->Known

Network->Option->Edit->SSID

Parameter

static.wifi.X.priority

[2]

<y0000000000xx>.cfg

Description

It configures the priority for the wireless network X for the IP phone.

5 is the highest priority, 1 is the lowest priority.

Note: It works only if “static.wifi.enable” is set to 1 (Enabled). It is only applicable to

T54S/T52S/T48S/T48G/T46S/T46G/T42S/T41S/T29G/T27G IP phones.

Permitted

Values

Integer from 1 to 5

Default

1

Web UI

Network->Wi-Fi->Change Priority

Phone UI

T54S/T52S/T48S/T48G/T46S/T46G/T29G:

Menu->Basic->Wi-Fi->Wi-Fi (On)->Known Network->Option->Move Up/Move

Down

T42S/T41S/T27G:

Menu->Settings->Basic Settings->Wi-Fi->Wi-Fi (On)->Known

Network->Option->Move Up/Move Down

Parameter

static.wifi.X.security_mode

[2]

<y0000000000xx>.cfg

Description

It configures the security mode of the wireless network X.

Note: It works only if “static.wifi.enable” is set to 1 (Enabled). It is only applicable to

T54S/T52S/T48S/T48G/T46S/T46G/T42S/T41S/T29G/T27G IP phones.

Permitted

Values

NONE, WEP, WPA-PSK, WPA2-PSK, WPA-EAP or WPA2-EAP

Default

NONE

Web UI

Network->Wi-Fi->Secure Mode

Phone UI

T54S/T52S/T48S/T48G/T46S/T46G/T29G:

Menu->Basic->Wi-Fi->Wi-Fi (On)->Known Network (press Add)->Security Mode

or

Menu->Basic->Wi-Fi->Wi-Fi (On)->Known Network->Option->Edit->Security Mode

T42S/T41S/T27G:

Menu->Settings->Basic Settings->Wi-Fi (On)->Known Network (press Add)->Security

Mode

29

Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones

or

Menu->Settings->Basic Settings->Wi-Fi->Wi-Fi (On)->Known

Network->Option->Edit->Security Mode

Parameter

static.wifi.X.cipher_type

[2]

<y0000000000xx>.cfg

Description

It configures the encryption type of the wireless network X.

If “static.wifi.X.security_mode” is set to NONE, the permitted value of this parameter is

NONE.

If “static.wifi.X.security_mode” is set to WEP, the permitted value of this parameter is

WEP.

If “static.wifi.X.security_mode” is set to other values, the permitted values of this

parameter are TKIP, AES or TKIP AES.

Note: It works only if “static.wifi.enable” is set to 1 (Enabled). It is only applicable to
T54S/T52S/T48S/T48G/T46S/T46G/T42S/T41S/T29G/T27G IP phones.

Permitted

Values

NONE, WEP, TKIP, AES or TKIP AES

Default

NONE

Web UI

Network->Wi-Fi->Cipher Type

Phone UI

T54S/T52S/T48S/T48G/T46S/T46G/T29G:

Menu->Basic->Wi-Fi->Wi-Fi (On)->Known Network (press Add)->Cipher Type

or

Menu->Basic->Wi-Fi->Wi-Fi (On)->Known Network->Option->Edit->Cipher Type

T42S/T41S/T27G:

Menu->Settings->Basic Settings->Wi-Fi (On)->Known Network (press Add)->Cipher

Type

or

Menu->Settings->Basic Settings->Wi-Fi->Wi-Fi (On)->Known

Network->Option->Edit->Cipher Type

Parameter

static.wifi.X.password

[2]

<y0000000000xx>.cfg

Description

It configures the password of the wireless network X.

Note: It works only if “static.wifi.enable” is set to 1 (Enabled) and

“static.wifi.X.security_mode” is set to WEP, WPA-PSK or WPA2-PSK. It is only

applicable to T54S/T52S/T48S/T48G/T46S/T46G/T42S/T41S/T29G/T27G IP phones.

Permitted

Values

String within 64 characters

Default

Blank

Web UI

Network->Wi-Fi->PSK

30

Phone Network

Phone UI

T54S/T52S/T48S/T48G/T46S/T46G/T29G:

Menu->Basic->Wi-Fi->Wi-Fi (On)->Known Network (press Add)->WPA Shared Key

or

Menu->Basic->Wi-Fi->Wi-Fi (On)->Known Network->Option->Edit->WPA Shared

Key

T42S/T41S/T27G:

Menu->Settings->Basic Settings->Wi-Fi (On)->Known Network (press Add)->WPA

Shared Key

or

Menu->Settings->Basic Settings->Wi-Fi->Wi-Fi (On)->Known

Network->Option->Edit->WPA Shared Key

Parameter

static.wifi.X.eap_type

[2]

<y0000000000xx>.cfg

Description

It configures the EAP authentication mode of the wireless network X.

Note: It works only if “static.wifi.enable” is set to 1 (Enabled) and

“static.wifi.X.security_mode” is set to WPA-EAP or WPA2-EAP. It is only applicable to

T54S/T52S/T48S/T48G/T46S/T46G/T42S/T41S/T29G/T27G IP phones.

Permitted

Values

TTLS, PEAP or TLS

Default

Blank

Parameter

static.wifi.X.eap_user_name

[2]

<y0000000000xx>.cfg

Description

It configures the EAP authentication username of the wireless network X.

Note: It works only if “static.wifi.enable” is set to 1 (Enabled),

“static.wifi.X.security_mode” is set to WPA-EAP or WPA2-EAP and

“static.wifi.X.eap_type” is set to TTLS or PEAP. It is only applicable to

T54S/T52S/T48S/T48G/T46S/T46G/T42S/T41S/T29G/T27G IP phones.

Permitted

Values

String within 32 characters

Default

Blank

Web UI

Network->Wi-Fi->User Name

Phone UI

T54S/T52S/T48S/T48G/T46S/T46G/T29G:

Menu->Basic->Wi-Fi->Wi-Fi (On)->Known Network (press Add) ->User Name

or

Menu->Basic->Wi-Fi->Wi-Fi (On)->Known Network->Option->Edit->User Name

T42S/T41S/T27G:

Menu->Settings->Basic Settings->Wi-Fi->Wi-Fi (On)->Known Network (press Add)

->User Name

31

Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones

or

Menu->Settings->Basic Settings->Wi-Fi->Wi-Fi (On)->Known

Network->Option->Edit->User Name

Parameter

static.wifi.X.eap_password

[2]

<y0000000000xx>.cfg

Description

It configures the EAP authentication password of the wireless network X.

Note: It works only if “static.wifi.enable” is set to 1 (Enabled) and

“static.wifi.X.security_mode” is set to WPA-EAP or WPA2-EAP. It is only applicable to

T54S/T52S/T48S/T48G/T46S/T46G/T42S/T41S/T29G/T27G IP phones.

Permitted

Values

String within 64 characters

Default

Blank

Web UI

Network->Wi-Fi->PSK

Phone UI

T54S/T52S/T48S/T48G/T46S/T46G/T29G:

Menu->Basic->Wi-Fi->Wi-Fi (On)->Known Network (press Add) ->WPA Shared Key

or

Menu->Basic->Wi-Fi->Wi-Fi (On)->Known Network->Option->Edit->WPA Shared

Key

T42S/T41S/T27G:

Menu->Settings->Basic Settings->Wi-Fi->Wi-Fi (On)->Known Network (press Add)

->WPA Shared Key

or

Menu->Settings->Basic Settings->Wi-Fi->Wi-Fi (On)->Known

Network->Option->Edit->WPA Shared Key

Parameter

static.wifi.show_scan_prompt

<y0000000000xx>.cfg

Description

It enables or disables the IP phone to prompt you whether to scan Wi-Fi or not after

connecting Wi-Fi USB dongle WF40 to the IP phone.

Note: It is only applicable to

T54S/T52S/T48S/T48G/T46S/T46G/T42S/T41S/T29G/T27G IP phones.

Permitted

Values

0-Disabled, the IP phone will enable the Wi-Fi feature and try to connect to the known

wireless network (according to the priority) automatically. But if the IP phone fails to

connect to any known wireless network, the IP phone will still display the Wi-Fi

scanning prompt when connecting WF40 to the IP phone.

1-Enabled

Default

1

[1]

If you change this parameter, the IP phone will reboot to make the change take effect.

[2]

X is Wi-Fi ID. X=1-5.

32

Phone Network

Parameter

static.network.port.min_rtpport

[1]

<y0000000000xx>.cfg

Description

It configures the minimum local RTP port.

Permitted

Values

Integer from 1024 to 65535

Default

11780

Web UI

Network->Advanced->Local RTP Port->Min RTP Port (1024~65535)

Parameter

static.network.port.max_rtpport

[1]

<y0000000000xx>.cfg

Description

It configures the maximum local RTP port.

Note: The value of the maximum local RTP port cannot be less than that of the

minimum local RTP port.

Permitted

Values

Integer from 1024 to 65535

Default

12780

Web UI

Network->Advanced->Local RTP Port->Max RTP Port (1024~65535)

Parameter

features.rtp_symmetric.enable

[1]

<y0000000000xx>.cfg

Description

It configures the symmetrical RTP (Real-Time Transport Protocol) feature on the IP

phone.

Note: IP address and port can be negotiated through the SDP protocol.

Permitted

Values

0-Disabled

1-reject RTP packets arriving from a non-negotiated IP address

Real-Time Transport Protocol (RTP) Ports

You can specify the IP phone’s RTP port range. Since the IP phone supports conferencing and multiple

RTP streams, it can use several ports concurrently. The UDP port used for RTP streams is traditionally an

even-numbered port. For example, the default RTP min port on the IP phones is 11780. The first voice

session sends RTP using port 11780. Additional calls would then use ports 11782, 11784, 11786, and so

on. The phone is compatible with RFC 1889 - RTP: A Transport Protocol for Real-Time Applications - and

the updated RFC 3550.

Topic

RTP Ports Configuration

RTP Ports Configuration

The following table lists the parameters you can use to configure RTP ports.

33

Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones

2-reject RTP packets arriving from a non-negotiated port

3-reject RTP packets arriving from a non-negotiated IP address or a non-negotiated

port

Default

0

Parameter

account.X.nat.nat_traversal

[1]

<MAC>.cfg

Description

It enables or disables the NAT traversal.

Note: If it is set to 1 (STUN), it works only if “static.sip.nat_stun.enable” is set to 1

(Enabled); if it is set to 2 (Manual NAT), it works only if “network.static_nat.enable” is

set to 1 (Enabled).

Permitted

Values

0-Disabled

1-STUN

2-Manual NAT

Default

0

[1]

If you change this parameter, the IP phone will reboot to make the change take effect.

Network Address Translation (NAT)

Network Address Translation (NAT) is a function that allows multiple devices to share the same public,

routable IP address to establish connections over the Internet. NAT is present in many broadband access

devices to translate public and private IP address.

Yealink IP phones can work with certain types of NAT.

Topics

NAT Traversal Configuration

Keep Alive Configuration

Rport Configuration

SIP Port and TLS Port Configuration

NAT Traversal Configuration

In the VoIP environment, NAT breaks end-to-end connectivity. NAT traversal is a general term for

techniques that establish and maintain IP connections traversing NAT gateways, typically required for

client-to-client networking applications, especially for VoIP deployments.

Yealink IP phones support three NAT traversal techniques: manual NAT, STUN and ICE. If you enable

manual NAT and STUN, the IP phone will use the manually-configured external IP address for NAT

traversal. The TURN protocol is used as part of the ICE approach to NAT traversal.

The following table lists the parameters you can use to configure NAT traversal.

34

Phone Network

Web UI

Account->Register->NAT

Phone UI

T54S/T52S/T48S/T48G/T46S/T46G/T29G:

Menu->Advanced (default password: admin)->Accounts->Account X->NAT Status

T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2:

Menu->Settings->Advanced Settings (default password:

admin)->Accounts->AccountX->NAT Status

Note: Manual NAT cannot be configured via phone user interface.

Parameter

static.network.static_nat.enable

[2]

<y0000000000xx>.cfg

Description

It enables or disables the manual NAT feature on the IP phone.

Permitted

Values

0-Disabled

1-Enabled

Default

0

Web UI

Network->NAT->Nat Manual->Active

Parameter

static.network.static_nat.addr

[2]

<y0000000000xx>.cfg

Description

It configures the IP address to be advertised in SIP signaling.

It should match the external IP address used by the NAT device.

Example:

static.network.static_nat.addr = 10.3.5.33

Note: It works only if “static.network.static_nat.enable” is set to 1 (Enabled).

Permitted

Values

IP Address

Default

Blank

Web UI

Network->NAT->Nat Manual->IP Address

Parameter

static.sip.nat_stun.enable

[2]

<y0000000000xx>.cfg

Description

It enables or disables the STUN (Simple Traversal of UDP over NATs) feature on the IP

phone.

Permitted

Values

0-Disabled

1-Enabled

Default

0

Web UI

Network->NAT->STUN->Active

Phone UI

T54S/T52S/T48S/T48G/T46S/T46G/T29G:

Menu->Advanced (default password: admin) ->Network->NAT->NAT Status

T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2:

Menu->Settings->Advanced Settings (default password: admin)

35

Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones

->Network->NAT->NAT Status

Parameter

static.sip.nat_stun.server

[2]

<y0000000000xx>.cfg

Description

It configures the IP address or domain name of the STUN (Simple Traversal of UDP

over NATs) server.

Example:

static.sip.nat_stun.server = 218.107.220.201

Note: It works only if “static.sip.nat_stun.enable” is set to 1 (Enabled).

Permitted

Values

IP Address or Domain Name

Default

Blank

Web UI

Network->NAT->STUN->STUN Server

Phone UI

T54S/T52S/T48S/T48G/T46S/T46G/T29G:

Menu->Advanced (default password: admin) ->Network->NAT->STUN Server

T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2:

Menu->Settings->Advanced Settings (default password: admin)

->Network->NAT->STUN Server

Parameter

static.sip.nat_stun.port

[2]

<y0000000000xx>.cfg

Description

It configures the port of the STUN (Simple Traversal of UDP over NATs) server.

Example:

static.sip.nat_stun.port = 3478

Note: It works only if “static.sip.nat_stun.enable” is set to 1 (Enabled).

Permitted

Values

Integer from 1024 to 65000

Default

3478

Web UI

Network->NAT->STUN->STUN Port (1024~65000)

Phone UI

T54S/T52S/T48S/T48G/T46S/T46G/T29G:

Menu->Advanced (default password: admin) ->Network->NAT->STUN Port

T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2:

Menu->Settings->Advanced Settings (default password: admin)

->Network->NAT->STUN Port

Parameter

static.ice.enable

[2]

<y0000000000xx>.cfg

Description

It enables or disables the ICE (Interactive Connectivity Establishment) feature on the IP

phone.

Permitted

Values

0-Disabled

36

Phone Network

1-Enabled

Default

0

Web UI

Network->NAT->ICE->Active

Parameter

static.sip.nat_turn.enable

[2]

<y0000000000xx>.cfg

Description

It enables or disables the TURN (Traversal Using Relays around NAT) feature on the IP
phone.

Permitted

Values

0-Disabled

1-Enabled

Default

0

Web UI

Network->NAT->TURN->Active

Parameter

static.sip.nat_turn.server

[2]

<y0000000000xx>.cfg

Description

It configures the IP address or the domain name of the TURN (Traversal Using Relays

around NAT) server.

Example:

static.sip.nat_turn.server = 218.107.220.202

Note: It works only if “static.sip.nat_turn.enable” is set to 1 (Enabled).

Permitted

Values

IP Address or Domain Name

Default

Blank

Web UI

Network->NAT->TURN->TURN Server

Parameter

static.sip.nat_turn.port

[2]

<y0000000000xx>.cfg

Description

It configures the port of the TURN (Traversal Using Relays around NAT) server.

Example:

static.sip.nat_turn.port = 3478

Note: It works only if “static.sip.nat_turn.enable” is set to 1 (Enabled).

Permitted

Values

Integer from 1024 to 65535

Default

3478

Web UI

Network->NAT->TURN->TURN Port (1~65535)

Parameter

static.sip.nat_turn.username

[2]

<y0000000000xx>.cfg

Description

It configures the user name to authenticate to TURN (Traversal Using Relays around

NAT) server.

Example:

37

Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones

static.sip.nat_turn.username = admin

Note: It works only if “static.sip.nat_turn.enable” is set to 1 (Enabled).

Permitted

Values

String

Default

Blank

Web UI

Network->NAT->TURN->User Name

Parameter

static.sip.nat_turn.password

[2]

<y0000000000xx>.cfg

Description

It configures the password to authenticate to the TURN (Traversal Using Relays around

NAT) server.

Example:

static.sip.nat_turn.password = yealink1105

Note: It works only if “static.sip.nat_turn.enable” is set to 1 (Enabled).

Permitted

Values

String

Default

Blank

Web UI

Network->NAT->TURN->Password

Parameter

account.X.nat.udp_update_enable

[1]

<MAC>.cfg

Description

It configures the type of keep-alive packets sent by the IP phone to the NAT device to

keep the communication port open so that NAT can continue to function.

Permitted

Values

0-Disabled

1-Default (the IP phone sends UDP packets to the server).

2-Options (the IP phone sends SIP OPTIONS packets to the server).

3-Notify (the IP phone sends SIP NOTIFY packets to the server).

Default

1

Web UI

Account->Advanced->Keep Alive Type

[1]

X is the account ID. For T54S/T48S/T48G/T46S/T46G/T29G, X=1-16; for T52S/T42G/T42S, X=1-12; for

T41P/T41S/T27P/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2; for T19(P) E2, X=1.

[2]

If you change this parameter, the IP phone will reboot to make the change take effect.

Keep Alive Configuration

Yealink IP phones can send keep-alive packets to the NAT device for keeping the communication port

open.

The following table lists the parameters you can use to configure keep alive.

38

Phone Network

Parameter

account.X.nat.udp_update_time

[1]

<MAC>.cfg

Description

It configures the keep-alive interval (in seconds).

Example:

account.1.nat.udp_update_time = 30

Note: It works only if “account.X.nat.udp_update_enable” is set to 1, 2 or 3.

Permitted

Values

Integer from 15 to 2147483647

Default

30

Web UI

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

Parameter

account.X.nat.rport

[1]

<MAC>.cfg

Description

It enables or disables the NAT Rport feature.

Permitted

Values

0-Disabled

1-Enabled

2-Enable Direct Process

Default

0

Web UI

Account->Advanced->RPort

[1]

X is the account ID. For T54S/T48S/T48G/T46S/T46G/T29G, X=1-16; for T52S/T42G/T42S, X=1-12; for

T41P/T41S/T27P/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2; for T19(P) E2, X=1.

Rport Configuration

Yealink IP phones support rport described in RFC 3581. It allows a client to request that the server sends

the response back to the source port from which the request came.

Rport feature depends on support from a SIP server.

The following table lists the parameter you can use to configure rport.

[1]

X is the account ID. For T54S/T48S/T48G/T46S/T46G/T29G, X=1-16; for T52S/T42G/T42S, X=1-12; for

T41P/T41S/T27P/T27G, X=1-6; for T40P/T40G/T23P/T23G, X=1-3; for T21(P) E2, X=1-2; for T19(P) E2, X=1.

SIP Port and TLS Port Configuration

You can configure the SIP and TLS source ports on the IP Phone. Otherwise, the IP phone uses default

values (5060 for UDP/TCP and 5061 for TLS).

If NAT is disabled, the port number shows in the Via and Contact SIP headers of SIP messages. If NAT is

enabled, the phone uses the NAT port number (and NAT IP address) in the Via and Contact SIP headers

of SIP messages, but still use the configured source port.

The following table lists the parameters you can use to configure SIP port and TLS port.

39

Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones

Parameter

sip.listen_port

<y0000000000xx>.cfg

Description

It configures the local SIP port.

Permitted

Values

Integer from 1024 to 65535

Default

5060

Web UI

Settings->SIP->Local SIP Port

Parameter

sip.tls_listen_port

<y0000000000xx>.cfg

Description

It configures the local TLS listen port.

If it is set to 0, the IP phone will not listen the TLS service.

Permitted

Values

Integer from 1024 to 65535

Default

5061

Web UI

Settings->SIP->TLS SIP Port

Internet Port and PC Port

Yealink IP phones support two Ethernet ports: Internet port and PC port. You can enable or disable the PC

port on the IP phones.

Topics

Supported Transmission Methods

Internet Port and PC Port Configuration

Supported Transmission Methods

Three optional methods of transmission configuration for IP phone Internet port and PC port:

 Auto-negotiate

 Half-duplex (transmit in 10Mbps or 100Mbps)

 Full-duplex (transmit in 10Mbps, 100Mbps or 1000Mbps (1000Mbps is only applicable to

T54S/T52S/T48S/T48G/T46S/T46G/T42G/T42S/T40G/T29G/T27G/T23G IP phones))

Auto-negotiate is configured for both Internet and PC ports on the IP phone by default.

Internet Port and PC Port Configuration

The following table lists the parameters you can use to configure Internet port and PC port.

40

Phone Network

Parameter

static.network.pc_port.enable

[1]

<y0000000000xx>.cfg

Description

It enables or disables the PC port.

Permitted

Values

0-Disabled

1-Auto Negotiation

Default

1

Web UI

Network->PC Port->PC Port Active

Parameter

static.network.internet_port.speed_duplex

[1]

<y0000000000xx>.cfg

Description

It configures the transmission method of the Internet port.

Note: For T54S/T52S/T48S/T48G/T46S/T46G/T42G/T42S/T40G/T29G/T27G/T23G IP

phones, you can set the transmission speed to 1000Mbps/Auto Negotiation to

transmit in 1000Mbps if the IP phone is connected to the switch supports Gigabit

Ethernet. We recommend that you do not change this parameter.

Permitted

Values

0-Auto Negotiation

1-Full Duplex 10Mbps

2-Full Duplex 100Mbps

3-Half Duplex 10Mbps

4-Half Duplex 100Mbps

5-Full Duplex 1000Mbps (only applicable to

T54S/T52S/T48S/T48G/T46S/T46G/T42G/T42S/T40G/T29G/T27G/T23G IP phones)

Default

0

Web UI

Network->Advanced->Port Link->WAN Port Link

Parameter

static.network.pc_port.speed_duplex

[1]

<y0000000000xx>.cfg

Description

It configures the transmission method of the PC port.

Note: It works only if “static.network.pc_port.enable” is set to 1 (Auto Negotiation). For

T54S/T52S/T48S/T48G/T46S/T46G/T42G/T42S/T40G/T29G/T27G/T23G IP phones, you

can set the transmission speed to 1000Mbps/ Auto Negotiation to transmit in

1000Mbps if the IP phone is connected to the switch supports Gigabit Ethernet. We

recommend that you do not change this parameter.

Permitted

Values

0-Auto Negotiation

1-Full Duplex 10Mbps

2-Full Duplex 100Mbps

3-Half Duplex 10Mbps

4-Half Duplex 100Mbps

5-Full Duplex 1000Mbps (only applicable to

T54S/T52S/T48S/T48G/T46S/T46G/T42G/T42S/T40G/T29G/T27G/T23G IP phones)

41

Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones

Default

0

Web UI

Network->Advanced->Port Link->PC Port Link

Parameter

static.network.vlan.pc_port_mode

[1]

<y0000000000xx>.cfg

Description

It configures the way the IP phone processes packets for the PC port when VLAN is

enabled on the PC port.

Note: When packets are sent from the Internet port to the PC port, remove the

packet’s tag if it is the same as the configured tag for the PC port, else forward the

packets directly.

Permitted

Values

0-when packets are sent from the PC port to the Internet port, the IP phone will

forward the packets directly.

1-when packets are sent from the PC port to the Internet port, and there is no VLAN

tag in the packet, the IP phone will tag the packet with the configured tag for the PC

port and then forward it.

Default

1

VPN Files

Description

Unified Directories

ca.crt

CA certificate

/config/openvpn/keys/ca.crt

[1]

If you change this parameter, the IP phone will reboot to make the change take effect.

VPN

Yealink IP phones use OpenVPN to achieve VPN feature. To prevent disclosure of private information,

tunnel endpoints must authenticate each other before secure VPN tunnel is established. After you

configure VPN feature on the IP phone, the IP phone will act as a VPN client and uses the certificates to

authenticate with the VPN server.

For more information, refer to OpenVPN Feature on Yealink IP phones.

Topics

VPN Related Files

VPN Configuration

VPN Related Files

To use VPN, you should collect all VPN-related files into one archive file in .tar format and then upload

this tar file. The related VPN files include certificates (ca.crt and client.crt), key (client.key) and the

configuration file (vpn.cnf) of the VPN client.

The following table lists the unified directories of the OpenVPN certificates and key in the configuration

file (vpn.cnf) for Yealink IP phones:

42

VPN Files

Description

Unified Directories

client.crt

Client certificate

/config/openvpn/keys/client.crt

client.key

Private key of the client

/config/openvpn/keys/client.key

VPN Configuration

Parameter

static.network.vpn_enable

[1]

<y0000000000xx>.cfg

Description

It enables or disables the OpenVPN feature on the IP phone.

Permitted

Values

0-Disabled

1-Enabled

Default

0

Web UI

Network->Advanced->VPN->Active

Phone UI

T54S/T52S/T48S/T48G/T46S/T46G/T29G:

Menu->Advanced (default password: admin) ->Network->VPN->VPN Active

T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2:

Menu->Settings->Advanced Settings (default password: admin)

->Network->VPN->VPN Active

Parameter

static.openvpn.url

<y0000000000xx>.cfg

Description

It configures the access URL of the *.tar file for OpenVPN.

Example:

static.openvpn.url = http://192.168.10.25/OpenVPN.tar

Permitted

Values

URL within 511 characters

Default

Blank

Web UI

Network->Advanced->VPN->Upload VPN Config

The following table lists the parameters you can use to configure VPN.

Phone Network

[1]

If you change this parameter, the IP phone will reboot to make the change take effect.

Quality of Service (QoS)

VoIP is extremely bandwidth and delay-sensitive. QoS is a major issue in VoIP implementations,

regarding how to guarantee that packet traffic not be delayed or dropped due to interference from other

lower priority traffic. VoIP can guarantee high-quality QoS only if the voice and the SIP packets are given

priority over other kinds of network traffic. IP phones support the DiffServ model of QoS.

43

Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones

Note

For voice and SIP packets, the IP phone obtains DSCP info from the network policy if LLDP feature is
enabled, which takes precedence over manual settings. For more information on LLDP, refer to LLDP

Configuration.

Parameter

static.network.qos.audiotos

[1]

<y0000000000xx>.cfg

Description

It configures the DSCP (Differentiated Services Code Point) for voice packets.

The default DSCP value for RTP packets is 46 (Expedited Forwarding).

Permitted

Values

Integer from 0 to 63

Default

46

Web UI

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

Parameter

static.network.qos.signaltos

[1]

<y0000000000xx>.cfg

Description

It configures the DSCP (Differentiated Services Code Point) for SIP packets.

The default DSCP value for SIP packets is 26 (Assured Forwarding).

Permitted

Values

Integer from 0 to 63

Default

26

Web UI

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

Voice QoS

In order to make VoIP transmissions intelligible to receivers, voice packets should not be dropped,

excessively delayed, or made to suffer varying delay. DiffServ model can guarantee high-quality voice

transmission when the voice packets are configured to a higher DSCP value.

SIP QoS

SIP protocol is used for creating, modifying, and terminating two-party or multi-party sessions. To ensure

good voice quality, SIP packets emanated from IP phones should be configured with a high transmission

priority.

DSCPs for voice and SIP packets can be specified respectively.

Topic

Voice and SIP QoS Configuration

Voice and SIP QoS Configuration

The following table lists the parameters you can use to configure voice voice and SIP QoS.

[1]

If you change this parameter, the IP phone will reboot to make the change take effect.

44

Phone Network

Parameter

static.network.802_1x.mode

[1]

<y0000000000xx>.cfg

Description

It configures the 802.1x authentication method.

Permitted

Values

0-EAP-None, 802.1x authentication is not required.

1-EAP-MD5

2-EAP-TLS

3-EAP-PEAP/MSCHAPv2

4-EAP-TTLS/EAP-MSCHAPv2

5-EAP-PEAP/GTC

6-EAP-TTLS/EAP-GTC

7-EAP-FAST

Default

0

Web UI

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

Phone UI

T54S/T52S/T48S/T48G/T46S/T46G/T29G:

Menu->Advanced (default password: admin) ->Network->802.1x->802.1x Mode

T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2:

Menu->Settings->Advanced Settings (default password: admin)

802.1x Authentication

Yealink IP phones support the following protocols for 802.1X authentication:

 EAP-MD5

 EAP-TLS (requires Device and CA certificates, requires no password)

 EAP-PEAP/MSCHAPv2 (requires CA certificates)

 EAP-TTLS/EAP-MSCHAPv2 (requires CA certificates)

 EAP-PEAP/GTC (requires CA certificates)

 EAP-TTLS/EAP-GTC (requires CA certificates)

 EAP-FAST (supports EAP In-Band provisioning, requires CA certificates if the provisioning method is

Authenticated Provisioning)

For more information on 802.1X authentication, refer to Yealink 802.1X Authentication.

Topic

802.1x Authentication Configuration

802.1x Authentication Configuration

The following table lists the parameters you can use to configure 802.1x authentication.

45

Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones

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

Parameter

static.network.802_1x.eap_fast_provision_mode

[1]

<y0000000000xx>.cfg

Description

It configures the EAP In-Band provisioning method for EAP-FAST.

Note: It works only if “static.network.802_1x.mode” is set to 7 (EAP-FAST).

Permitted

Values

0-Unauthenticated Provisioning, EAP In-Band provisioning is enabled by server

unauthenticated PAC (Protected Access Credential) provisioning using anonymous

Diffie-Hellman key exchange.

1-Authenticated Provisioning, EAP In-Band provisioning is enabled by server

authenticated PAC provisioning using certificate based server authentication.

Default

0

Web UI

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

Parameter

static.network.802_1x.anonymous_identity

[1]

<y0000000000xx>.cfg

Description

It configures the anonymous identity (user name) for 802.1X authentication.

It is used for constructing a secure tunnel for 802.1X authentication.

Example:

static.network.802_1x.anonymous_identity = [e-mail]

Note: It works only if “static.network.802_1x.mode” is set to 2, 3, 4, 5, 6 or 7.

Permitted

Values

String within 512 characters

Default

Blank

Web UI

Network->Advanced->802.1x->Anonymous Identity

Parameter

static.network.802_1x.identity

[1]

<y0000000000xx>.cfg

Description

It configures the user name for 802.1x authentication.

Example:

static.network.802_1x.identity = yealink

Note: It works only if “static.network.802_1x.mode” is set to 1, 2, 3, 4, 5, 6 or 7.

Permitted

Values

String within 32 characters

Default

Blank

Web UI

Network->Advanced->802.1x->Identity

Phone UI

T54S/T52S/T48S/T48G/T46S/T46G/T29G:

Menu->Advanced (default password: admin) ->Network->802.1x->Identity

T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2:

Menu->Settings->Advanced Settings (default password: admin)

46

Phone Network

->Network->802.1x->Identity

Parameter

static.network.802_1x.md5_password

[1]

<y0000000000xx>.cfg

Description

It configures the password for 802.1x authentication.

Example:

static.network.802_1x.md5_password = admin123

Note: It works only if “static.network.802_1x.mode” is set to 1, 3, 4, 5, 6 or 7.

Permitted

Values

String within 32 characters

Default

Blank

Web UI

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

Phone UI

T54S/T52S/T48S/T48G/T46S/T46G/T29G:

Menu->Advanced (default password: admin) ->Network->802.1x->MD5 Password

T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2:

Menu->Settings->Advanced Settings (default password: admin)

->Network->802.1x->MD5 Password

Parameter

static.network.802_1x.root_cert_url

<y0000000000xx>.cfg

Description

It configures the access URL of the CA certificate.

Example:

static.network.802_1x.root_cert_url = http://192.168.1.10/ca.pem

Note: It works only if “static.network.802_1x.mode” is set to 2, 3, 4, 5, 6 or 7. If the

authentication method is EAP-FAST, you also need to set

“static.network.802_1x.eap_fast_provision_mode” to 1 (Authenticated Provisioning).

The format of the certificate must be *.pem, *.crt, *.cer or *.der.

Permitted

Values

URL within 511 characters

Default

Blank

Web UI

Network->Advanced->802.1x->CA Certificates

Parameter

static.network.802_1x.client_cert_url

<y0000000000xx>.cfg

Description

It configures the access URL of the device certificate.

Example:

static.network.802_1x.client_cert_url = http://192.168.1.10/client.pem

Note: It works only if “static.network.802_1x.mode” is set to 2 (EAP-TLS). The format of
the certificate must be *.pem.

Permitted

Values

URL within 511 characters

47

Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones

Default

Blank

Web UI

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

Parameter

static.network.802_1x.proxy_eap_logoff.enable

[1]

<y0000000000xx>.cfg

Description

It enables or disables the 802.1x-logoff feature for the PC port.

Permitted

Values

0-Disabled

1-Enabled, the 802.1x logoff message is sent to the authenticator when the PC is

disconnected.

Default

0

RPC Method

Description

GetRPCMethods

This method is used to discover the set of methods

supported by the CPE.

SetParameterValues

This method is used to modify the value of one or more

CPE parameters.

GetParameterValues

This method is used to obtain the value of one or more

CPE parameters.

GetParameterNames

This method is used to discover the parameters accessible

on a particular CPE.

[1]

If you change this parameter, the IP phone will reboot to make the change take effect.

TR-069 Device Management

TR-069 is a technical specification defined by the Broadband Forum, which defines a mechanism that

encompasses secure auto-configuration of a CPE (Customer-Premises Equipment), and incorporates

other CPE management functions into a common framework. TR-069 uses common transport

mechanisms (HTTP and HTTPS) for communication between CPE and ACS (Auto Configuration Servers).

The HTTP(S) messages contain XML-RPC methods defined in the standard for configuration and

management of the CPE.

For more information on TR-069, refer to Yealink TR-069 Technote.

Topics

Supported RPC Methods

TR069 Configuration

Supported RPC Methods

The following table provides a description of RPC methods supported by IP phones.

48

Phone Network

RPC Method

Description

GetParameterAttributes

This method is used to read the attributes associated with

one or more CPE parameters.

SetParameterAttributes

This method is used to modify attributes associated with

one or more CPE parameters.

Reboot

This method causes the CPE to reboot.

Download

This method is used to cause the CPE to download a

specified file from the designated location.

File types supported by IP phones are:

 Firmware Image

 Configuration File

Upload

This method is used to cause the CPE to upload a

specified file to the designated location.

File types supported by IP phones are:

 Configuration File

 Log File

ScheduleInform

This method is used to request the CPE to schedule a

one-time Inform method call (separate from its periodic

Inform method calls) sometime in the future.

FactoryReset

This method resets the CPE to its factory default state.

TransferComplete

This method informs the ACS of the completion (either

successful or unsuccessful) of a file transfer initiated by an

earlier Download or Upload method call.

AddObject

This method is used to add a new instance of an object

defined on the CPE.

DeleteObject

This method is used to remove a particular instance of an

object.

Parameter

static.managementserver.enable

<y0000000000xx>.cfg

Description

It enables or disables the TR069 feature.

Permitted

Values

0-Disabled

1-Enabled

TR069 Configuration

The following table lists the parameters you can use to configure TR069.

49

Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones

Default

0

Web UI

Settings->TR069->Enable TR069

Parameter

static.managementserver.username

<y0000000000xx>.cfg

Description

It configures the user name for the IP phone to authenticate with the ACS (Auto

Configuration Servers).

Leave it blank if no authentication is required.

Example:

static.managementserver.username = tr69

Permitted

Values

String within 128 characters

Default

Blank

Web UI

Settings->TR069->ACS Username

Parameter

static.managementserver.password

<y0000000000xx>.cfg

Description

It configures the password for the IP phone to authenticate with the ACS (Auto

Configuration Servers).

Leave it blank if no authentication is required.

Example:

static.managementserver.password = tr69

Permitted

Values

String within 64 characters

Default

Blank

Web UI

Settings->TR069->ACS Password

Parameter

static.managementserver.url

<y0000000000xx>.cfg

Description

It configures the access URL of the ACS (Auto Configuration Servers).

Example:

static.managementserver.url =

http://officetelprov.orangero.net:8080/ftacs-digest/ACS

Permitted

Values

URL within 511 characters

Default

Blank

Web UI

Settings->TR069->ACS URL

Parameter

static.managementserver.connection_request_username

<y0000000000xx>.cfg

Description

It configures the user name for the IP phone to authenticate the incoming connection

requests.

50

Phone Network

Example:

static.managementserver.connection_request_username = accuser

Permitted

Values

String within 128 characters

Default

Blank

Web UI

Settings->TR069->Connection Request Username

Parameter

static.managementserver.connection_request_password

<y0000000000xx>.cfg

Description

It configures the password for the IP phone to authenticate the incoming connection

requests.

Example:

static.managementserver.connection_request_password = acspwd

Permitted

Values

String within 64 characters

Default

Blank

Web UI

Settings->TR069->Connection Request Password

Parameter

static.managementserver.periodic_inform_enable

<y0000000000xx>.cfg

Description

It enables or disables the IP phone to periodically report its configuration information

to the ACS (Auto Configuration Servers).

Permitted

Values

0-Disabled

1-Enabled

Default

1

Web UI

Settings->TR069->Enable Periodic Inform

Parameter

static.managementserver.periodic_inform_interval

<y0000000000xx>.cfg

Description

It configures the interval (in seconds) at which the IP phone reports its configuration

to the ACS (Auto Configuration Servers).

Note: It works only if “static.managementserver.periodic_inform_enable” is set to 1
(Enabled).

Permitted

Values

Integer from 5 to 4294967295

Default

60

Web UI

Settings->TR069->Periodic Inform Interval (seconds)

51

Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones

52

Phone Provisioning

Phone Provisioning

This chapter provides basic instructions for setting up your IP phones with a provisioning server.

For more information, refer to Yealink_SIP_IP_Phones_Auto_Provisioning_Guide.

Topics

Boot Files, Configuration Files and Resource Files

Provisioning Methods

Setting Up a Provisioning Server

Keeping User’s Personalized Settings after Auto Provisioning

Example: Deploying Phones from the Provisioning Server

Boot Files, Configuration Files and Resource Files

You can use boot files, configuration files and resource files to configure phone features and apply

feature settings to phones. You can create or edit these files using a text editor such as UltraEdit.

You can ask the distributor or Yealink FAE for template files. You can also obtain the template files online:

http://support.yealink.com/documentFront/forwardToDocumentFrontDisplayPage.

Topics

Boot Files

Configuration Files

Resource Files

Files Download Process

Boot Files

Yealink IP phones support boot files. The boot files maximize the flexibility to allow you to customize

features and settings for multiple phones.

With the boot file, you can specify which configuration files should be downloaded. It is effective for you

to provision the IP phones in different deployment scenarios:

 For all phones

 For a group of phones

 For specific phone models

 For a single phone

Yealink IP phones support two types of boot files: common boot file and MAC-Oriented boot file. You

53

Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones

Note

You can select whether to use the boot file or not according to your deployment scenario. If you do not
want to use the boot file, please go to Configuration Files.

Tip

MAC address, a unique 12-digit serial number is assigned to each phone. You can obtain it from the bar
code on the back of the IP phone.

Attributes

Description

#!version:1.0.0.1

It must be placed in the first line. Do not edit and delete.

include:config <xxx.cfg>

include:config "xxx.cfg"

Each “include” statement can specify a location of a configuration file.

The configuration file format must be *.cfg.

The locations in the angle brackets or double quotation marks support

two forms:

 Relative path (relative to the boot file):

For example, sip.cfg, HTTP Directory/sip.cfg

 Absolute path (or URL):

can use the default boot template file “y000000000000.boot” to create MAC-Oriented boot file by

making a copy and renaming it.

Topics

Common Boot File

MAC-Oriented Boot File

Boot File Attributes

Customizing a Boot File

Common Boot File

Common boot file, named y000000000000.boot, is effective for all phones. You can use a common boot

file to apply common feature settings to all of the phones rather than a single phone.

MAC-Oriented Boot File

MAC-Oriented boot file, named <MAC>.boot. It will only be effective for a specific IP phone. In this way,

you have a high permission to control over each phone by making changes on a per-phone basis.

You can create a MAC-Oriented boot file for each phone by making a copy and renaming the boot

template file (y000000000000.boot). For example, if your phone MAC address is 00156574B150, rename

the template file as 00156574b150.boot (lowercase).

Boot File Attributes

The following table lists the attributes you need to know in the boot template file.

54

Phone Provisioning

Attributes

Description

For example,

http://10.2.5.258/HTTP Directory/sip.cfg

The location must point to a specific CFG file.

[$MODEL]

The [$MODEL] can be added to specify settings for specific phone

models. $MODEL represents the phone model name.

The valid phone model names are: T54S, T52S, T48S, T48G, T46S, T46G,

T42S, T42G, T41P, T41S, T40P, T40G, T29G, T27P, T27G, T23P, T23G,

T21P E2, T21 E2, T19P E2 and T19 E2.

Multiple phone models are separated by commas. For example, [T46S,

T23G].

overwrite_mode

Enable or disable the overwrite mode. The overwrite mode applies to

the configuration files specified in the boot file. Note that it only

affects the parameters pre-provisioned via central provisioning.

1-(Enabled) - If the value of a parameter in configuration files is left

blank, or if a non-static parameter in configuration files is deleted or

commented out, the factory default value takes effect.

0-(Disabled) - If the value of a parameter in configuration files is left

blank, deleted or commented out, the pre-configured value is kept.

Note: Overwrite mode can only be used in boot files. If a boot file is

used but the value of the parameter “overwrite_mode” is not

configured, the overwrite mode is enabled by default.

specific_model.excluded_m

ode

Enable or disable the exclude mode. The exclude mode applies to the

configuration files specified in the boot file.
0-Disabled (Append Mode), the phone downloads its own

model-specific configuration files, and downloads other
model-unspecified configuration files.

1-Enabled (Exclude Mode), the phone attempts to download its own

model-specific configuration files; if there is no own model-specific

configuration files found on the server, it downloads

model-unspecified configuration files.

Note: Exclude mode can only be used in boot files. If a boot file is used

but the value of the parameter “specific_model.excluded_mode” is not

configured, the exclude mode is disabled by default.

Tip

The line beginning with “#” is considered to be a comment. You can use “#” to make any comment in the
boot file.

55

Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones

Customizing a Boot File

Procedure

1. Open a boot template file.

2. To add a configuration file, add

separate line.

3. Specify a configuration file for downloading.

For example:

include:config <configure/sip.cfg>

include:config “http://10.2.5.206/configure/account.cfg”

include:config “http://10.2.5.206/configure/dialplan.cfg”

4. To specify configuration files for specific phone models, add specific phone models

include:config <>

For example:

[T46S, T48S]include:config <configure/sip.cfg>

[T23G]include:config “http://10.2.5.206/configure/account.cfg”

## file

sip.cfg

5. Specify the overwrite mode and exclude mode.

For example:

or

include:config “”

only applies to T46S and T48S phones, file

include:config <>

. Multiple phone model names are separated by commas.

or

include:config “”

account.cfg

to the file. Each starts on a

only applies to T23G phones

in front of

overwrite_mode = 1

specific_model.excluded_mode = 1

6. Save the boot file and place it on the provisioning server.

Related Topic

Boot File Attributes

Configuration Files

Yealink supports two configuration template files: Common CFG file and MAC-Oriented CFG file.

These configuration files contain two kinds of parameters:

 Static: The parameters start with a prefix “static.”, for example, static.auto_provision.custom.protect.

 Non-static: The parameters do not start with a prefix “static.”, for example,

phone_setting.backgrounds.

56

Phone Provisioning

Note

For protecting against unauthorized access, you can encrypt configuration files. For more information on
encrypting configuration files, refer to Encrypting and Decrypting Files.

Phone Model

Common CFG file

T54S

y000000000070.cfg

T52S

y000000000074.cfg

T48G

y000000000035.cfg

T48S

y000000000065.cfg

T46G

y000000000028.cfg

T46S

y000000000066.cfg

T42G

y000000000029.cfg

T42S

y000000000067.cfg

T41P

y000000000036.cfg

T41S

y000000000068.cfg

T40P

y000000000054.cfg

T40G

y000000000076.cfg

T29G

y000000000046.cfg

T27P

y000000000045.cfg

T27G

y000000000069.cfg

You can deploy and maintain a mass of Yealink IP phones automatically through configuration files

stored in a provisioning server.

Topics

Common CFG File

MAC CFG File

Configuration File Customization

Configuration File Attributes

Common CFG File

Common CFG file, named <y0000000000xx>.cfg, contains parameters that affect the basic operation of

the IP phone, such as language and volume. It will be effective for all IP phones in the same model. The

common CFG file has a fixed name for each phone model.

The following table lists the name of the common CFG file for each IP phone model:

57

Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones

Phone Model

Common CFG file

T23P/G

y000000000044.cfg

T21(P) E2

y000000000052.cfg

T19(P) E2

y000000000053.cfg

Tip

MAC address, a unique 12-digit serial number is assigned to each phone. You can obtain it from the bar
code on the back of the IP phone.

Note

The non-static changes that you made before enabling the provisioning priority mechanism are not saved in
the generated MAC-local file, but the previous settings still take effect on the phone. The static changes are
never be saved to the <MAC>-local.cfg file.

The provisioning priority mechanism is enabled by the parameter “static.auto_provision.custom.protect”.

MAC CFG File

Yealink supports two MAC CFG file: MAC-Oriented file and MAC-local CFG file, which are both named

after the MAC address of the IP phone. For example, if the MAC address of an IP phone is 00156574B150,

the name of MAC-Oriented CFG file is 00156574b150.cfg (lowercase), and the name of MAC-local CFG

file is 00156574b150-local.cfg (lowercase).

Topics

MAC-Oriented CFG File

MAC-local CFG File

MAC-Oriented CFG File

MAC-Oriented CFG file, named <MAC>.cfg, contains parameters unique to a particular phone, such as

account registration. It will only be effective for a MAC-specific IP phone.

MAC-local CFG File

MAC-local CFG file, named <MAC>-local.cfg, contains changes associated with non-static parameter that

you make via web user interface or phone user interface (for example, changes for time and date formats,

ring tones, and DSS keys).

This file generates only if you enable the provisioning priority mechanism. It is stored locally on the IP

phone and you can upload it to the provisioning server each time the file updates. This file enables the

users to keep their personalized configuration settings, even though the IP phone performs auto

provisioning.

58

Phone Provisioning

Parameter

static.auto_provision.custom.protect

<y0000000000xx>.cfg

Description

It enables or disables the IP phone to keep user’s personalized settings after auto

provisioning.

Note: The provisioning priority mechanism (phone/web user interface >central

provisioning >factory defaults) takes effect only if the value of this parameter is set to

1 (Enabled). If “overwrite_mode” is set to 1 in the boot file, the value of this parameter

will be set to 1 (Enabled).

Permitted

Values

0-Disabled

1-Enabled, <MAC>-local.cfg file generates and personalized non-static settings

configured via web or phone user interface will be kept after auto provisioning.

Default

0

Parameter

static.auto_provision.custom.sync

<y0000000000xx>.cfg

Description

It enables or disables the IP phone to upload the <MAC>-local.cfg file to the server

each time the file updates, and to download the <MAC>-local.cfg file from the server

during auto provisioning.

Note: It works only if “static.auto_provision.custom.protect” is set to 1 (Enabled). The

upload/download path is configured by the parameter

“static.auto_provision.custom.sync.path”.

Permitted

Values

0-Disabled

1-Enabled

Default

0

Parameter

static.auto_provision.custom.sync.path

<y0000000000xx>.cfg

Description

It configures the URL for uploading/downloading the <MAC>-local.cfg file.

If it is left blank, the IP phone will try to upload/download the <MAC>-local.cfg file

to/from the provisioning server.

Note: It works only if “static.auto_provision.custom.sync" is set to 1 (Enabled).

Permitted

Values

URL

Topics

MAC-local CFG File Configuration

Clearing MAC-local CFG File

MAC-local CFG File Configuration

By default, the MAC-local.cfg file is stored on the IP phone. You can configure the phone to upload this

file to the provisioning server each time the file updates.

The following table lists the parameters you can use to generate and upload the MAC-local CFG file.

59

Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones

Default

Blank

Parameter

static.auto_provision.custom.upload_method

[1]

<y0000000000xx>.cfg

Description

It configures the way the IP phone uploads the <MAC>-local.cfg file,

<MAC>-calllog.xml file or <MAC>-contact.xml file to the provisioning server (for

HTTP/HTTPS server only).

Permitted

Values

0-PUT

1-POST

Default

0

Note

The Reset local settings option on the web/phone user interface appears only if you set

“static.auto_provision.custom.protect = 1”.

If you set “static.auto_provision.custom.sync = 1”, the MAC-local.cfg file on the provisioning server will be
cleared too. If not, the MAC-local.cfg file is kept on the provisioning server, and the IP phone could

download it and update the configurations to the phone after the next auto provisioning.

Clearing MAC-local CFG File

When the IP phone is given to a new user but many personalized configurations settings of the last user

are saved on the phone; or when the end user encounters some problems because of the wrong

configurations, you can clear user’s personalized configuration settings.

 Via phone user interface at the path: Menu->Advanced (default password: admin) ->Reset

Config->Reset local settings.

 Via web user interface at the path: Settings->Upgrade->Reset Local Settings.

Configuration File Customization

You can create some new CFG files by making a copy and renaming the configuration template file (for

example, sip.cfg, account.cfg). You can rearrange the parameters in the configuration template file and

create your own configuration files with parameters you want. This flexibility is especially useful when you

want to apply specific settings to a group of phones.

Topic

Customizing a Configuration File

Customizing a Configuration File

1. Copy and rename a configuration template file. For example,

2. Rearrange the parameters in the

sip.cfg

, and set the valid values for them.

For example:

phone_setting.contrast = 7

sip.cfg

.

60

Phone Provisioning

Attributes

Description

#!version:1.0.0.1

It must be placed in the first line. Do not edit and delete.

Configuration

Parameter=Valid Value

(for example,

features.dnd_mode = 1)

Specify the parameters and values to apply specific settings to the

phones.
 Separate each configuration parameter and value with an equal

sign

 Set only one configuration parameter per line
 Put the configuration parameter and value on the same line, and

do not break the line

[$MODEL]

The [$MODEL] can be added in front of configuration parameter to

specify the value for specific phone models. $MODEL represents the

phone model.

The valid phone model names are: T54S, T52S, T48S, T48G, T46S, T46G,

T42S, T42G, T41P, T41S, T40P, T40G, T29G, T27P, T27G, T23P, T23G,

T21P E2, T21 E2, T19P E2 and T19 E2.

Multiple phone models are separated by commas. For example, [T46S,

T23G].

Note: The phone updates model-specific configurations and those

local_time.time_format = 1

account.1.dnd.enable = 1

account.2.dnd.enable = 1

features.dnd.enable = 0

3. To specify parameters for specific phone models, add specific phone models in the front of the

corresponding parameters. Multiple phone model names are separated by commas.

For example:

[T46S,T48S]voice_mail.number.1 = *5

[T27G]account.1.dnd.enable = 1

[T46S]account.2.dnd.enable = 1

[T48S]features.dnd.enable = 0

## These parameters only apply to their own specific phone models.

4. Save the configuration file and place it on the provisioning server.

Related Topic

Configuration File Attributes

Configuration File Attributes

The following table lists the attributes you need to know in the configuration template file.

61

Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones

Attributes

Description

model-unspecified configurations.

Tip

The line beginning with “#” is considered to be a comment. You can use “#” to make any comment in the
boot file.

Tip

If you want to specify the desired phone to use the resource file, the access URL of resource file should be
specified in the MAC-Oriented CFG file. During auto provisioning, the IP phones will request the resource
files in addition to the configuration files.

Template File

File Name

Description

Reference in Section

AutoDST Template

AutoDST.xml

Add or modify time

zone and DST settings.

DST Settings

Language Packs

For example,

000.GUI.English.lang

1.English_note.xml

1.English.js

Customize the

translation of the

existing language on

the phone/web user

interface.

Language

Customization

Keypad Input

Method File

ime.txt

Russian_ime.txt

Hebrew_ime.txt

Customize the existing

input method.

Input Method File

Customization

Replace Rule

Template

DialPlan.xml

Customize replace

rules for dial plan.

Replace Rule File

Customization

Dial Now Template

DialNow.xml

Customize dial now

rules for dial plan.

Dial Now File

Customization

Resource Files

Resource files are optional, but if the particular feature is being employed, these files are required. You

need to place resource files on the provisioning server. The IP phones request the resource files in

addition to the configuration files during auto provisioning.

Topic

Supported Resource Files

Supported Resource Files

Yealink supplies some template of resource files for you, so you can directly edit the files as required.

The following table lists the resource files Yealink supplies:

62

Phone Provisioning

Template File

File Name

Description

Reference in Section

Softkey Layout

Template

CallFailed.xml

CallIn.xml

Connecting.xml

Dialing.xml

RingBack.xml

Talking.xml

Customize soft key

layout for different call

states.

Softkey Layout File

Customization

Directory Template

favorite_setting.xml

Customize the

directory list.

Directory List File

Customization

Super Search

Template

super_search.xml

Customize the search

source list.

Search Source File

Customization

Local Contact File

contact.xml

Add or modify multiple

local contacts.

Local Contact File

Customization

Remote Phone Book

Template

Department.xml

Menu.xml

Add or modify multiple

remote contacts.

Remote Phone Book

File Customization

Screen Saver

Template

CustomScreenSaver.xml

Customize the XML

items (for example,

notifications, company

logo) which will be

displayed on screen

saver.

Screensaver Display

Customization

Files Download Process

When you provision the IP phones, the phones will request to download the boot files, configuration files

and resource files from the provisioning server according to the following flowchart:

63

Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones

Note

For the phone running firmware version 82 or earlier, it downloads configuration files referenced in the boot
file in sequence.

For the phone running firmware version 83 or later, “specific_model.excluded_mode” determines which
configuration files referenced in the boot file to be downloaded.

The parameters in the new downloaded configuration files will override the same parameters in files

downloaded earlier.

Provisioning Methods

Yealink provides two ways to provision your phones:

 Manual Provisioning: provisioning via the local phone user interface or web user interface.

 Central Provisioning: provisioning through configuration files stored in a central provisioning server.

The method you use depends on how many phones need to be deployed and what features and settings

to be configured. Manual provisioning on web or phone user interface does not contain all of the phone

settings available with centralized method. You can use the web user interface method in conjunction

with central provisioning method and phone user interface method. We recommend using centralized

provisioning as your primary provisioning method when provisioning multiple phones.

Topics

Provisioning Methods Priority

64

Phone Provisioning

Note

The provisioning priority mechanism takes effect only if “static.auto_provision.custom.protect” is set to 1.
For more information on this parameter, refer to MAC-local CFG File Configuration.

Static parameters have no priority. They take effect no matter what method (web user interface or phone
user interface or configuration files) you are using for provisioning.

Static parameters are the parameters that start with a prefix “static.”, for example, the parameters associated
with auto provisioning/network/syslog, TR069 settings and internal settings (the temporary configurations
to be used for program running).

Note

When you manually configure a phone via web user interface or phone user interface, the changes
associated with non-static parameters you make will be stored in the MAC-local CFG file. For more
information on MAC-local CFG file, refer to MAC-local CFG File.

Manual Provisioning

Central Provisioning

Provisioning Methods Priority

There is a priority for configuration among the provisioning methods - settings you make using a higher

priority provisioning method override settings made using a lower priority provisioning method.

The precedence order for configuration parameter changes is as follows (highest to lowest):

Manual Provisioning

This method enables you to perform configuration changes on a per-phone basis.

Topics

Web User Interface

Phone User Interface

Web User Interface

You can configure IP phones via web user interface, a web-based interface that is especially useful for

remote configuration. You can either import a configuration file to the phone or export a configuration

65

Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones

file containing phone’s current settings to your computer to make changes.

Because features and configurations vary by phone models and firmware versions, options available on

each page of the web user interface can vary as well. Note that the features configured via web user

interface are limited. Therefore, you can use the web user interface in conjunction with central

provisioning method and phone user interface.

Topics

Web User Interface Access

Navigating the Web User Interface

Importing CFG Configuration Files to Phone

Exporting CFG Configuration Files from Phone

Web User Interface Access

When configuring IP phones via web user interface, you require a user name and password for access. For

a user, the default user name and password are “user” (case-sensitive). For an administrator, the default

user name and password are “admin” (case-sensitive).

Topics

Accessing the Web User Interface

Quick Login Configuration

Web Server Type Configuration

Accessing the Web User Interface

Procedure

1. Find the phone IP address. Press the OK key when the phone is idle or navigate to Menu->Status

on the phone.

2. Enter the IP address in the address bar of a web browser on your PC.

For example, for IPv4: http://192.168.0.10 or 192.168.0.10; for IPv6:

http://[2005:1:1:1:215:65ff:fe64:6e0a] or [2005:1:1:1:215:65ff:fe64:6e0a]

3. Enter the user name and password.

4. Click Login.

Related Topics

Web Server Type Configuration

User and Administrator Identification

66

Phone Provisioning

Note

Accessing the web user interface by request URI may be restricted by the web explorer (e.g., Internet
Explorer).

For security purposes, we recommend you to use this feature in a secure network environment.

Parameter

wui.quick_login

<y0000000000xx>.cfg

Description

It enables or disables the quick login feature.

Note: It works only if “static.wui.https_enable” is set to 1 (Enabled).

Permitted

Values

0-Disabled

1-Enabled, you can quickly log into the web user interface using a request URI (for

example, https://admin:admin@192.168.0.10).

Default

0

Parameter

wui.secure_domain_list

<y0000000000xx>.cfg

Description

It configures the valid domain name to access the web user interface of the IP phone.

Multiple domain names are separated by semicolons.

Example:

wui.secure_domain_list = test.yealink.com

You are only allowed to use test.yealink.com or IP address to access the web user

interface of the IP phone.

Note: To use a domain name to access the web user interface of the IP phone, make

sure your DNS server can resolve the domain name to the IP address of the IP phone.

Permitted

Values

String

If it is left blank, you are only allowed to use IP address to access the web user

interface of the IP phone.

If it is set to “any”, you can use IP address or any domain name to access the web user

interface of the IP phone.

Default

any

Quick Login Configuration

You can access to web user interface quickly using the request URI

“https://username:password@phoneIPAddress” (for example, https://admin:admin@192.168.0.10). It will

locate you in the Status web page after accessing the web user interface. It is helpful to quickly log into

the web user interface without entering the username and password in the login page.

Yealink IP phones support domain name customization. You can use a custom domain name to access

the web user interface.

The following table lists the parameter you can use to configure quick login.

67

Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones

Parameter

static.wui.http_enable

[1]

<y0000000000xx>.cfg

Description

It enables or disables the user to access the web user interface of the IP phone using

the HTTP protocol.

Permitted

Values

0-Disabled

1-Enabled

Default

1

Web UI

Network->Advanced->Web Server->HTTP

Phone UI

T54S/T52S/T48S/T48G/T46S/T46G/T29G:

Menu->Advanced (default password: admin) ->Network->Web Server->HTTP Status

T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2:

Menu->Settings->Advanced Settings (default password: admin) ->Network->Web

Server->HTTP Status

Parameter

static.network.port.http

[1]

<y0000000000xx>.cfg

Description

It configures the HTTP port for the user to access the web user interface of the IP

phone using the HTTP protocol.

Permitted

Values

Integer from 1 to 65535

Default

80

Web UI

Network->Advanced->Web Server->HTTP Port (1~65535)

Phone UI

T54S/T52S/T48S/T48G/T46S/T46G/T29G:

Menu->Advanced (default password: admin) ->Network->Web Server->HTTP Port

T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2:

Menu->Settings->Advanced Settings (default password: admin) ->Network->Web

Server->HTTP Port

Parameter

static.wui.https_enable

[1]

<y0000000000xx>.cfg

Description

It enables or disables the user to access the web user interface of the IP phone using

the HTTPS protocol.

Permitted

0-Disabled

Web Server Type Configuration

Yealink IP phones support both HTTP and HTTPS protocols for accessing the web user interface. You can

configure the web server type. Web server type determines access protocol of the web user interface. If

you disable to access web user interface using the HTTP/HTTPS protocol, both you and the user cannot

access the web user interface.

The following table lists the parameters you can use to configure web server type.

68

Phone Provisioning

Values

1-Enabled

Default

1

Web UI

Network->Advanced->Web Server->HTTPS

Phone UI

T54S/T52S/T48S/T48G/T46S/T46G/T29G:

Menu->Advanced (default password: admin) ->Network->Web Server->HTTPS Status

T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2:

Menu->Settings->Advanced Settings (default password: admin) ->Network->Web

Server->HTTPS Status

Parameter

static.network.port.https

[1]

<y0000000000xx>.cfg

Description

It configures the HTTPS port for the user to access the web user interface of the IP

phone using the HTTPS protocol.

Permitted

Values

Integer from 1 to 65535

Default

443

Web UI

Network->Advanced->Web Server->HTTPS Port (1~65535)

Phone UI

T54S/T52S/T48S/T48G/T46S/T46G/T29G:

Menu->Advanced (default password: admin) ->Network->Web Server->HTTPS Port

T42G/T42S/T41P/T41S/T40P/T40G/T27P/T27G/T23P/T23G/T21(P) E2/T19(P) E2:

Menu->Settings->Advanced Settings (default password: admin) ->Network->Web

Server->HTTPS Port

[1]

If you change this parameter, the IP phone will reboot to make the change take effect.

Navigating the Web User Interface

When you log into the web user interface successfully, the phone status is displayed on the first page of

the web user interface. You can click the navigation bar to customize or click Log Out to log out of the

web user interface.

The following figure is an example when you navigate to Settings->Preference:

69

Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones

Parameter

static.custom_mac_cfg.url

<y0000000000xx>.cfg

Description

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

Permitted

Values

URL within 511 characters

Default

Blank

Importing CFG Configuration Files to Phone

You can import the configuration files from local to the IP phones via the web user interface. The

configuration files contain the changes for phone features, and these changes will take effect after

importing.

Procedure

1. Navigate to Settings->Configuration.

2. In the Import CFG Configuration File block, click Browse to locate a CFG configuration file in your

local system.

3. Click Import to import the configuration file.

Topic

Configuration Files Import URL Configuration

Configuration Files Import URL Configuration

The following table lists the parameters you can use to configure the configuration files import URL.

70

Phone Provisioning

Exporting CFG Configuration Files from Phone

You can export the phone’s configuration file to local and make changes to the phone’s current feature

settings. You can apply these changes to any phone by importing the configuration files via the web user

interface.

You can export five types of CFG configuration files to local system:



<MAC>-local.cfg: It contains changes associated with non-static parameters made via phone user

interface and web user interface. It can be exported only if “static.auto_provision.custom.protect” is

set to 1 (Enabled).



<MAC>-all.cfg: It contains all changes made via phone user interface, web user interface and using

configuration files.



<MAC>-static.cfg: It contains all changes associated with static parameters (for example, network

settings) made via phone user interface, web user interface and using configuration files.



<MAC>-non-static.cfg: It contains all changes associated with non-static parameters made via

phone user interface, web user interface and using configuration files.



<MAC>-config.cfg: It contains changes associated with non-static parameters made using

configuration files. It can be exported only if “static.auto_provision.custom.protect” is set to 1

(Enabled).

Procedure

1. Navigate to Settings->Configuration.

2. In the Export or Import Configuration block, click Export to open the file download window, and

then save the file to your local system.

Phone User Interface

Phone user interface makes configurations available to users and administrators; but the

Advanced/Advanced Settings option is only available to administrators and requires an administrator

password (default: admin).

You can configure IP phones via phone user interface on a per-phone basis.

Related Topic

User and Administrator Identification

Central Provisioning

Central provisioning enables you to provision multiple phones from a provisioning server that you set up,

and maintain a set of boot files, configuration files and resource files for all phones in the central

provisioning server.

The following figure shows how the phone interoperates with provisioning server when you use the

71

Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones

Parameter

static.auto_provision.attempt_expired_time

<y0000000000xx>.cfg

Description

It configures the timeout interval (in seconds) to transfer a file via auto provisioning.

Note: It has a higher priority than the value defined by the parameter

“static.network.attempt_expired_time”.

centralized provisioning method:

Yealink IP phones can obtain the provisioning server address during startup. Then IP phones first

download boot files and configuration files from the provisioning server, and then resolve and update

the configurations written in configuration files. This entire process is called auto provisioning. For more

information on auto provisioning, refer to Yealink_SIP_IP_Phones_Auto_Provisioning_Guide.

The IP phones can be configured to upload log files (log files provide a history of phone events), call log

files and contact files to the provisioning server. You can also configure a directory for each of these three

files respectively.

Topics

Auto Provisioning Settings Configuration

User-Triggered Provisioning Settings Configuration

Auto Provisioning Settings Configuration

The following table lists the parameters you can use to configure settings for auto provisioning.

72

Phone Provisioning

Permitted

Values

Integer from 1 to 300

Default

5

Web UI

Settings->Auto Provision->Attempt Expired Time(s)

Parameter

static.network.attempt_expired_time

[1]

<y0000000000xx>.cfg

Description

It configures the timeout interval (in seconds) to transfer a file for HTTP/HTTPS

connection.

Note: It has a lower priority than the value defined by the parameter

“static.auto_provision.attempt_expired_time”.

Permitted

Values

Integer from 1 to 20

Default

10

Parameter

static.auto_provision.attempt_before_failed

<y0000000000xx>.cfg

Description

It configures the maximum number of attempts to transfer a file before the transfer

fails.

Example:

static.auto_provision.attempt_before_failed = 5

Permitted

Values

Integer from 1 to 10

Default

3

Parameter

static.auto_provision.retry_delay_after_file_transfer_failed

<y0000000000xx>.cfg

Description

It configures the time (in seconds) to wait after a file transfer fails before retrying the

transfer via auto provisioning.

Example:

static.auto_provision.retry_delay_after_file_transfer_failed = 5

Permitted

Values

Integer from 0 to 300

Default

5

Parameter

static.auto_provision.reboot_force.enable

[1]

<y0000000000xx>.cfg

Description

It enables or disables the IP phone to reboot after auto provisioning, even if there is

no specific configuration requiring a reboot. It is especially useful when there is no

specific configuration requiring reboot in the configuration files, but you want the IP

phone to reboot after auto provisioning.

Note: It works only for the current auto provisioning process. If you want the IP phone

to reboot after every auto provisioning process, the parameter must be always

73

Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones

contained in the configuration file and set to 1.

If the IP phone reboots repeatedly after it is set to 1, you can try to set

“static.auto_provision.power_on" to 0 (Off).

Permitted

Values

0-Disabled

1-Enabled

Default

Blank

Parameter

features.action_uri_force_autop

<y0000000000xx>.cfg

Description

It enables or disables the IP phone to end the call for triggering auto provisioning

immediately when receiving an HTTP or HTTPS GET request with variable value set to

AutoP during a call.

Note: It works only if “features.action_uri.enable” is set to 1 (Enabled).

Permitted

Values

0-Disabled, the IP phone will trigger auto provisioning after the call.

1-Enabled

Default

0

Parameter

static.auto_provision.power_on

<y0000000000xx>.cfg

Description

It triggers the power on feature to on or off.

Permitted

Values

0-Off

1-On, the IP phone will perform auto provisioning when powered on.

Default

1

Web UI

Settings->Auto Provision->Power On

Parameter

static.auto_provision.repeat.enable

<y0000000000xx>.cfg

Description

It triggers the repeatedly feature to on or off.

Permitted

Values

0-Off

1-On

Default

0

Web UI

Settings->Auto Provision->Repeatedly

Parameter

static.auto_provision.repeat.minutes

<y0000000000xx>.cfg

Description

It configures the interval (in minutes) for the IP phone to perform auto provisioning

repeatedly.

Note: It works only if “static.auto_provision.repeat.enable” is set to 1 (On).

Permitted

Values

Integer from 1 to 43200

Default

1440

74

Phone Provisioning

Web UI

Settings->Auto Provision->Interval(Minutes)

Parameter

static.auto_provision.weekly.enable

<y0000000000xx>.cfg

Description

It triggers the weekly feature to on or off.

Permitted

Values

0-Off

1-On, the IP phone will perform an auto provisioning process weekly.

Default

0

Web UI

Settings->Auto Provision->Weekly

Parameter

static.auto_provision.weekly_upgrade_interval

<y0000000000xx>.cfg

Description

It configures the time interval (in weeks) for the IP phone to perform auto

provisioning.

If it is set to 0, the IP phone will perform auto provisioning at the specific day(s)

configured by the parameter “static.auto_provision.weekly.dayofweek” every week.

If it is set to other values (for example, 3), the IP phone will perform auto provisioning

at a random day between the specific day(s) configured by the parameter

“static.auto_provision.weekly.dayofweek” every three weeks.

Note: It works only if “static.auto_provision.weekly.enable” is set to 1 (On).

Permitted

Values

Integer from 0 to 12

Default

0

Web UI

Settings->Auto Provision->Weekly Upgrade Interval(0~12week)

Parameter

static.auto_provision.inactivity_time_expire

<y0000000000xx>.cfg

Description

It configures the delay time (in minutes) to perform auto provisioning when the IP

phone is inactive at regular week.

If it is set to 0, the IP phone will perform auto provisioning at random between a

starting time configured by the parameter “static.auto_provision.weekly.begin_time”

and an ending time configured by the parameter

“static.auto_provision.weekly.end_time”.

If it is set to other values (for example, 60), the IP phone will perform auto provisioning

only when the IP phone has been inactivated for 60 minutes (1 hour) between the

starting time and ending time.

Note: The IP phone may perform auto provisioning when you are using the IP phone

on office hour. It works only if “static.auto_provision.weekly.enable” is set to 1 (On).

Permitted

Values

Integer from 0 to 120

Default

0

75

Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones

Web UI

Settings->Auto Provision->Inactivity Time Expire(0~120min)

Parameter

static.auto_provision.weekly.dayofweek

<y0000000000xx>.cfg

Description

It configures the days of the week for the IP phone to perform auto provisioning

weekly.

Example:

static.auto_provision.weekly.dayofweek = 01

If “static.auto_provision.weekly_upgrade_interval” is set to 0, it means the IP phone will

perform auto provisioning every Sunday and Monday.

If “static.auto_provision.weekly_upgrade_interval” is set to other value (for example, 3),

it means the IP phone will perform auto provisioning by randomly selecting a day

from Sunday and Monday every three weeks.

Note: It works only if “static.auto_provision.weekly.enable” is set to 1 (On).

Permitted

Values

0,1,2,3,4,5,6 or a combination of these digits

0-Sunday

1-Monday

2-Tuesday

3-Wednesday

4-Thursday

5-Friday

6-Saturday

Default

0123456

Web UI

Settings->Auto Provision->Day of Week

Parameter

static.auto_provision.weekly.begin_time

static.auto_provision.weekly.end_time

<y0000000000xx>.cfg

Description

It configures the starting/ending time of the day for the IP phone to perform auto

provisioning weekly.

Note: It works only if “static.auto_provision.weekly.enable” is set to 1 (On).

Permitted

Values

Time from 00:00 to 23:59

Default

00:00

Web UI

Settings->Auto Provision->Time

Parameter

static.auto_provision.flexible.enable

<y0000000000xx>.cfg

Description

It triggers the flexible feature to on or off.

Note: The day within the period is based upon the phone's MAC address and does

not change with a reboot whereas the time within the start and end is calculated again

76

Phone Provisioning

with every reboot.

Permitted

Values

0-Off

1-On, the IP phone will perform auto provisioning at random between a starting time

configured by the parameter "static.auto_provision.flexible.begin_time" and an ending

time configured by the parameter "static.auto_provision.flexible.end_time" on a

random day within the period configured by the parameter

"static.auto_provision.flexible.interval".

Default

0

Web UI

Settings->Auto Provision->Flexible Auto Provision

Parameter

static.auto_provision.flexible.interval

<y0000000000xx>.cfg

Description

It configures the interval (in days) for the IP phone to perform auto provisioning.

The auto provisioning occurs on a random day within this period based on the

phone's MAC address.

Example:

static.auto_provision.flexible.interval = 30

The IP phone will perform auto provisioning on a random day (for example, 18) based

on the phone's MAC address.

Note: It works only if “static.auto_provision.flexible.enable” is set to 1 (On).

Permitted

Values

Integer from 1 to 1000

Default

30

Web UI

Settings->Auto Provision->Flexible Interval Days

Parameter

static.auto_provision.flexible.begin_time

<y0000000000xx>.cfg

Description

It configures the starting time of the day for the IP phone to perform auto

provisioning at random.

Note: It works only if “static.auto_provision.flexible.enable” is set to 1 (On).

Permitted

Values

Time from 00:00 to 23:59

Default

02:00

Web UI

Settings->Auto Provision->Flexible Time

Parameter

static.auto_provision.flexible.end_time

<y0000000000xx>.cfg

Description

It configures the ending time of the day for the IP phone to perform auto provisioning

at random.

If it is left blank or set to a specific value equal to starting time configured by the

parameter “static.auto_provision.weekly.begin_time”, the IP phone will perform auto

77

Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones

provisioning at the starting time.

If it is set to a specific value greater than starting time configured by the parameter

“static.auto_provision.weekly.begin_time”, the IP phone will perform auto provisioning

at random between the starting time and ending time.

If it is set to a specific value less than starting time configured by the parameter

“static.auto_provision.weekly.begin_time”, the IP phone will perform auto provisioning

at random between the starting time on that day and ending time in the next day.

Note: It works only if “static.auto_provision.flexible.enable” is set to 1 (On).

Permitted

Values

Time from 00:00 to 23:59

Default

Blank

Web UI

Settings->Auto Provision->Flexible Time

Parameter

static.auto_provision.prompt.enable

<y0000000000xx>.cfg

Description

It enables or disables the IP phone to prompt you for the configuration update and

the result (if any configuration changes) during auto provisioning.

Note: If the IP phone performs auto provisioning when receiving a SIP NOTIFY

message which contains the header “Event: check-sync”, the IP phone will display the

prompt message no matter whether the configuration is updated.

Permitted

Values

0-Disabled

1-Enabled

Default

0

Parameter

static.auto_provision.connect.keep_alive

<y0000000000xx>.cfg

Description

It enables or disables the long connection for downloading files via auto provisioning.

Permitted

Values

0-Disabled, the IP phone uses short connection for downloading files via auto

provisioning

1-Enabled

Default

0

Parameter

static.autoprovision.X.name

[1][2]

<y0000000000xx>.cfg

Description

It configures the code name to trigger auto provisioning.

[1]

If you change this parameter, the IP phone will reboot to make the change take effect.

User-Triggered Provisioning Settings Configuration

You can enable the users to trigger IP phones to perform provisioning by dialing an activation code. This

method works only if there is no registered account on the IP phone.

The following table lists the parameters you can use to configure settings for user-triggered provisioning.

78

Phone Provisioning

Permitted

Values

String within 64 characters

Default

Blank

Parameter

static.autoprovision.X.code

[1][2]

<y0000000000xx>.cfg

Description

It configures the activation code to trigger auto provisioning.

The activation code can be numeric characters, special characters # * or a combination

of them.

Example:

static.autoprovision.1.code = 123

static.autoprovision.2.code = **

static.autoprovision.3.code = *123

Permitted

Values

String

Default

Blank

Parameter

static.autoprovision.X.url

[1][2]

<y0000000000xx>.cfg

Description

It configures the access URL of the provisioning server for the IP phone to perform

auto provisioning which is triggered by activation code.

Permitted

Values

URL within 511 characters

Default

Blank

Parameter

static.autoprovision.X.user

[1][2]

<y0000000000xx>.cfg

Description

It configures the user name for authentication during auto provisioning which is

triggered by activation code.

Permitted

Values

String within 64 characters

Default

Blank

Parameter

static.autoprovision.X.password

[1][2]

<y0000000000xx>.cfg

Description

It configures the password for authentication during auto provisioning which is

triggered by activation code.

Permitted

Values

String within 32 characters

Default

Blank

Parameter

static.auto_provision.dns_resolv_nosys

<y0000000000xx>.cfg

Description

It enables or disables the IP phone to resolve the access URL of the provisioning server

79

Administrator’s Guide for SIP-T2 Series/T4 Series/T5 Series IP Phones

using download libraries mechanism.

Note: It is only applicable to T41P/T42G IP phones.

Permitted

Values

0-Disabled, the IP phone resolves the access URL of the provisioning server using

system mechanism.

1-Enabled

Default

1

Parameter

static.auto_provision.dns_resolv_nretry

<y0000000000xx>.cfg

Description

It configures the retry times when the IP phone fails to resolve the access URL of the

provisioning server.

Note: For each different DNS server, it works only if

“static.auto_provision.dns_resolv_nosys" is set to 1 (Enabled).

Permitted

Values

Integer from 1 to 10

Default

2

Parameter

static.auto_provision.dns_resolv_timeout

<y0000000000xx>.cfg

Description

It configures the timeout (in seconds) for the phone to retry to resolve the access URL

of the provisioning server.

Note: For each different DNS server, it works only if

“static.auto_provision.dns_resolv_nosys" is set to 1 (Enabled).

Permitted

Values

Integer from 1 to 60

Default

5

[1]

X is activation code ID. For all IP phones, X=1-50.

[2]

If you change this parameter, the IP phone will reboot to make the change take effect.

Setting Up a Provisioning Server

You can use a provisioning server to configure your IP phones. A provisioning server allows for flexibility

in upgrading, maintaining and configuring the phone. Boot files, configuration files and resource files are

normally located on this server.

Topics

Supported Provisioning Protocols

Supported Provisioning Server Discovery Methods

Configuring a Provisioning Server

80