Page 1
BroadSoft Partner Configuration Guide Yealink SIP-T4x IP Phone July 2017 Document Version 1.25 9737 Washingtonian Boulevard, Suite 350 Gaithersburg, MD USA 20878 Tel +1 301.977.9440 WWW.BROADSOFT.COM...
Page 2
Any product names mentioned in this document may be trademarks or registered trademarks of BroadSoft or their respective companies and are hereby acknowledged. This document is printed in the United States of America. BROADSOFT PARTNER CONFIGURATION GUIDE – YEALINK T4X IP PHONE 20-BD5476-00 2017 BROADSOFT INC.
Page 3
Updated with Yealink T4x IP Phone version xx.80.193.70 validation with BroadWorks Release 21.sp1. Also, added newer models. 1.16 Edited changes and published document. 1.17 Updated the document to include the No-Touch Provisioning as supported by Yealink T4x phones. 1.18 Edited changes and published document. 1.19 Updated the DM Supported capability table.
This guide describes the specific configuration items that are important for use with BroadWorks. It does not describe the purpose and use of all configuration items on the T4x IP Phone. For those details, see the Yealink T4x IP Phone User Guide supplied by Yealink.
Interoperability Status This section provides the known interoperability status of the Yealink T4x IP Phone with BroadWorks. This includes the version(s) tested, capabilities supported and known issues. Interoperability testing validates that the device interfaces properly with BroadWorks via the SIP interface. Qualitative aspects of the device or device capabilities not affecting the SIP interface such as display features, performance, and audio qualities are not covered by interoperability testing.
This section identifies interface capabilities that have been verified through testing as supported by Yealink T4x IP Phone. The Supported column in the tables in this section identifies the Yealink T4x IP Phone’s support for each of the items covered in the test plan, with the following designations: Test item is supported ...
Video Only T49G model. Dual Stack with Alternate Connectivity 2.2.2 Other Interface Capabilities The Yealink T4x Series may have implemented support for the following: BroadWorks Xtended Services Interface (Xsi) Extensible Messaging and Presence Protocol (XMPP) (BroadCloud/BroadWorks Collaborate Instant Messaging and Presence [IM&P]) Support for these interfaces is demonstrated by completing the BroadWorks SIP Phone Functional Test Plan [6].
BroadWorks release dependent. The Issue Number is a tracking number for the issue. If it is a Yealink issue, the issue number is from Yealink’s tracking system. If it is a BroadWorks issue, the issue number is from BroadSoft’s tracking system.
Page 17
Call Recording: Mid-Call Change to Call Recording Mode. Server Changes the Call Recording Mode when phone is on talking, phone immediately takes effect on the mode change. Workaround: None. BROADSOFT PARTNER CONFIGURATION GUIDE – YEALINK T4X IP PHONE 20-BD5476-00 2017 BROADSOFT INC. PAGE 17 OF 150...
This section identifies the device profile type to use when deploying the Yealink T4x IP Phone with BroadWorks. Create a device profile type for the Yealink T48G IP Phone as shown in the following example. A separate device profile type should be created for each Yealink T4x IP Phone model.
IP address, TFTP server, and other network settings. The T4x IP Phone should be configured to load the configuration file each time it resets or re-synchronizes. For detailed information on automated provisioning, see the Yealink T4x IP Phone User Guide [1].
The first location to answer the call is connected to the originator. If the line is already active in a call, only the active location is alerted. BROADSOFT PARTNER CONFIGURATION GUIDE – YEALINK T4X IP PHONE 20-BD5476-00 2017 BROADSOFT INC.
The following steps show how to configure both phones for this Shared Call Appearance configuration. For configurations of SCA for the device, see the example in the following section. BROADSOFT PARTNER CONFIGURATION GUIDE – YEALINK T4X IP PHONE 20-BD5476-00 2017 BROADSOFT INC.
Second, on line registration web page, type in the host line and second appearance line as shown in the following figures. Figure 4 Account Register Page BROADSOFT PARTNER CONFIGURATION GUIDE – YEALINK T4X IP PHONE 20-BD5476-00 2017 BROADSOFT INC. PAGE 26 OF 150...
Via above method, you can manually set the DSS keys to shared line keys, but after version 72, Yealink phones support setting the DSS keys to shared line keys auto. If you have configured line key 1 to shared line, we need to configure 1 or 1 more free line keys as shared line keys, then you can do as follows.
On the BroadWorks server, browse to Client Applications → Busy Lamp Field and configure the settings as shown in the following figure. Figure 11 Busy Lamp Field Configuration Page BROADSOFT PARTNER CONFIGURATION GUIDE – YEALINK T4X IP PHONE 20-BD5476-00 2017 BROADSOFT INC.
Browse to the Call Centers configuration page. Figure 13 Call Control → Call Centers Page Register the Call Center line. BROADSOFT PARTNER CONFIGURATION GUIDE – YEALINK T4X IP PHONE 20-BD5476-00 2017 BROADSOFT INC. PAGE 31 OF 150...
The recording files are saved on the server. On the BroadWorks server, browse to Call Control → Call Recording BROADSOFT PARTNER CONFIGURATION GUIDE – YEALINK T4X IP PHONE 20-BD5476-00 2017 BROADSOFT INC.
It enables users to be conscious of the maximum level of classified information that can be exchanged in the conversation. On the BroadWorks server, browse to Utilities → Security Classification. BROADSOFT PARTNER CONFIGURATION GUIDE – YEALINK T4X IP PHONE 20-BD5476-00 2017 BROADSOFT INC.
Figure 18 Emergency Configuration 4.3.8 Advice of Charge Configuration Yealink T4x IP Phone does not support Advice of Charge feature. 4.3.9 Conference Event Configuration Yealink T4x IP Phone does not support Conference Event. 4.3.10 Flexible Seating Flexible seating feature has similar functionality to the BroadWorks Hoteling feature. But it uses a different licensing model and allows the device to be provisioned with the guest’s...
For a phone to access the Xtended Services Interface features including services, directories, call logs, and so on, the SIP phone must first authenticate the user. Currently, the Yealink SIP phone supports two methods to authenticate a user: BroadWorks User Login Credentials and SIP Authentication Credentials.
Type in the related parameters and then click Confirm. SIP Authentication Credentials Browse to the Account → Register, type in the correct account parameters and then click Confirm. BROADSOFT PARTNER CONFIGURATION GUIDE – YEALINK T4X IP PHONE 20-BD5476-00 2017 BROADSOFT INC. PAGE 38 OF 150...
(The uc password) Second, browse to Applications → Broadsoft XMPP and fill in the associated parameter for the UC Username and UC Password fields. BROADSOFT PARTNER CONFIGURATION GUIDE – YEALINK T4X IP PHONE 20-BD5476-00 2017 BROADSOFT INC. PAGE 45 OF 150...
Management interface between the device and BroadWorks with the intent to ensure interoperability. The Supported column in the following table identifies the Yealink T4x IP Phone’s support for each of the items covered in the test plan packages, with the following designations: Test item is supported ...
Yealink T4x phone models only. The Yealink T4x IP Phone makes use of dynamic tags, which may be configured by a BroadWorks administrator as either system default or device type-specific tags. This section identifies the required tags.
Configure the tag set name using the device name appended by Tags: Yealink T4x_Tags. Add the device type-specific tags in the following table to the device tag set. If the tag set already exists, make sure the tags are defined in the following table.
The import method takes a DTAF as input and builds the BroadWorks device profile type(s) automatically. The manual method takes the administrator through the steps to manually add and configure the device profile type(s). BROADSOFT PARTNER CONFIGURATION GUIDE – YEALINK T4X IP PHONE 20-BD5476-00 2017 BROADSOFT INC.
Page 53
Configuration Method 1: Import This section identifies the steps necessary to make use of the Device Management import feature to configure BroadWorks to add the Yealink T4x IP Phone as a Device Management-enabled device type. Also, see the BroadWorks CPE Kit Usage Guide [8].
Click the Files and Authentication link and then select the option to rebuild all the system files. Firmware files must be obtained from Yealink. These files are not included in the import. Complete the steps in section 5.2.2.2.2 Define Device Profile Type Files define the static firmware files and to upload the firmware.
Page 55
Define Device Profile Type Files This section describes the BroadWorks Device Management configuration necessary to identify the configuration files and other files that the Yealink T4x IP Phone downloads. Configuration templates, firmware, and other files the T4x IP Phone uses must be uploaded to BroadWorks.
Page 56
Talking(<Phone Model>).xml talking state. The following table identifies other files that the Yealink T4xG IP Phone downloads from the server or uploads to the server. These files are not provided in the CPE kit and must be obtained from Yealink.
Page 57
5.2.2.2.2.1 System Files This section identifies the system-level files used by Yealink and provides instructions for defining the files and uploading for Device Management. T4x IP Phone model downloads a model-specific system file, named as follows: y0000000000xx.cfg T40P: xx=54 ...
5.2.2.2.2.2 Device-Specific File This section identifies the device-specific files used by Yealink and provides instructions for defining the files and uploading for Device Management. Each T4x phone downloads a phone-specific file based on the phone’s MAC address using the following file name format: <mac-address>.cfg...
Page 60
Settings. After creating the device profile type file, upload static files (extracted from the CPE kit and obtained from Yealink). Use the Browse button on the file definition screen. Be sure to click Apply after uploading the file. BROADSOFT PARTNER CONFIGURATION GUIDE – YEALINK T4X IP PHONE 20-BD5476-00 2017 BROADSOFT INC.
TimeZoneAliasLabels_Yealink_T46G.properties. A space in the device name must be converted to a “+” in the file name. A separate TimeZoneAlias file must be provided for each device profile type, corresponding to each Yealink T4x IP Phone model. The following is an example of the file contents:...
Page 62
BroadWorks Application Server must be mapped to the Yealink language files. To perform the mapping, select the Yealink T4x device profile type and then select the Languages link. The defined BroadWorks languages are listed in a table. If languages other than English do not appear, they have not been defined.
Figure 34 Language Mapping The language applied to an individual phone is determined by the language defined for the user on the BroadWorks User’s Profile page. BROADSOFT PARTNER CONFIGURATION GUIDE – YEALINK T4X IP PHONE 20-BD5476-00 2017 BROADSOFT INC. PAGE 63 OF 150...
BroadWorks interface to an individual Yealink T4x device. Browse to the BroadWorks <group> → Resources → Identity/Device Profiles page and then select Add to add a new Yealink T4x device profile. Configure the device profile as shown in the Figure 36 Device Profile Instance example.
To assign the device profile to the user, browse to the BroadWorks <user> → Addresses. Customize Tags This section identifies custom tags used by the Yealink T4x that may need to be customized at the group or device profile. Customizing a tag at the group level overrides the setting on the device profile type for the device profiles created within the group.
LAN address of the edge device. To do so, perform that following steps. At the Group → Utilities → Configure Device page, select the Yealink device profile (for example, Yealink_T46G). Click on the Custom Tags tab.
66 has been defined on the DHCP server. If the DHCP server returns data set for the Option 66 parameter, then the Yealink phone uses the address defined in this field as the server address to retrieve its configuration data.
Auto Provision username and password fields. The phone resynchronizes with Device Management and downloads the files associated with the credentials supplied via the above step. BROADSOFT PARTNER CONFIGURATION GUIDE – YEALINK T4X IP PHONE 20-BD5476-00 2017 BROADSOFT INC. PAGE 68 OF 150...
The import method is available in BroadWorks Release 17.0 and later. For previous releases, use the manual configuration method described in the next section. Download the Yealink T4x CPE kit from BroadSoft Xchange at www.broadsoft.com/xchange. Extract the DeviceManagementDefaults.DTAF.zip file from the CPE kit.
Create Default Device Profile Type A Device Management default device profile type must be created. This device profile type can be configured to serve default provisioning files to Yealink T4x endpoints, as well as other vendor devices. Create a default device profile type as shown in the following figure. Only the device management settings are important in this context since the profile type is used only to serve default provisioning files.
Define Device Profile Type Files This section describes the BroadWorks Device Management configuration necessary to identify the configuration files used to enable the DeviceManagementDefaults device type for Yealink T4x devices. The files must be defined as described in the following sections: y0000000000xx.cfg T40P: xx=54 ...
Page 74
Yealink T4x starts the provisioning process by following this default BroadWorks Device Management URL to obtain an initial configuration redirect. The following steps detail the phone’s sequence to become fully provisioned on BroadWorks after receiving the redirect from BroadWorks. The phone does initial resynchronization with Device Management and downloads the default file from location specified in DHCP offer.
Upgrade from Previous CPE Kits The previous configuration sections are primarily structured around importing or manually configuring the Yealink T4x device profile types for the first time. Many of the steps are unnecessary when upgrading to a new firmware release or CPE kit version.
NOTE: The following samples are examples and should be used as a reference only. DO NOT CUT AND PASTE THESE EXAMPLES TO GENERATE YOUR CONFIGURATION FILES. Use the configuration files obtained from Yealink with the specific release to generate your configuration files. System Default File: y000000000054.cfg NOTE: This is an example file and it should be used for reference only.
Page 77
= ##It configures the HTTPS port for web server access. ##The default value is 443.It takes effect after a reboot. static.network.port.https = BROADSOFT PARTNER CONFIGURATION GUIDE – YEALINK T4X IP PHONE 20-BD5476-00 2017 BROADSOFT INC. PAGE 77 OF 150...
Page 89
BLF/BLF list key LED status. ##For more information, refer to BLF LED Mode on page 218. ##The default value is 0. features.blf_led_mode = BROADSOFT PARTNER CONFIGURATION GUIDE – YEALINK T4X IP PHONE 20-BD5476-00 2017 BROADSOFT INC. PAGE 89 OF 150...
Page 110
= ##It configures the keep-alive interval (in seconds) for account X. ##The default value is 30.Integer from 15 to 2147483647 account.1.nat.udp_update_time = BROADSOFT PARTNER CONFIGURATION GUIDE – YEALINK T4X IP PHONE 20-BD5476-00 2017 BROADSOFT INC. PAGE 110 OF 150...
Page 112
= ##It configures number of linekey for line. ##The default value is 1,you should enable auto line keys first. account.1.number_of_linekey = %NUM_OF_LINEKEYS% BROADSOFT PARTNER CONFIGURATION GUIDE – YEALINK T4X IP PHONE 20-BD5476-00 2017 BROADSOFT INC. PAGE 112 OF 150...
Page 132
IN-3% ##It configures the period (in seconds) of the BLF subscription for account X. ##The default value is 1800.Integer from 30 to 2147483647. BROADSOFT PARTNER CONFIGURATION GUIDE – YEALINK T4X IP PHONE 20-BD5476-00 2017 BROADSOFT INC. PAGE 132 OF 150...
Page 138
##It configures the server port of the Xtended Services Platform server for account X.Example:account.3.xsi.port = 80. ##The default value is 80.Integer from 1 to 65535 account.3.xsi.port = BROADSOFT PARTNER CONFIGURATION GUIDE – YEALINK T4X IP PHONE 20-BD5476-00 2017 BROADSOFT INC. PAGE 138 OF 150...
Page 143
##The default value is blank.Integer from -300 to 300 local_time.offset_time = ##It configures the time format.0-12 Hour,1-24 Hour. ##The default value is 1. BROADSOFT PARTNER CONFIGURATION GUIDE – YEALINK T4X IP PHONE 20-BD5476-00 2017 BROADSOFT INC. PAGE 143 OF 150...
References [1] Yealink, Inc. 2016. Yealink T4x IP Phone User Guide, Release 81. Available from Yealink at http://www.yealink.com/DocumentDownload.aspx?CateId=142&flag=142. [2] BroadSoft, Inc. 2017. BroadWorks Device Management Configuration Guide, Release 21.0. Available from BroadSoft at xchange.broadsoft.com. [3] BroadSoft, Inc. 2015. BroadWorks Redundancy Guide, Release 21.0. Available from BroadSoft at xchange.broadsoft.com.