Yealink Teams MeetingBar A20 Administrator Guide V15.20
Yealink Teams MeetingBar A20 Administrator Guide V15.20
Yealink Teams MeetingBar A20 Administrator Guide V15.20
Contents
Introduction.................................................................................................. 6
Related Documentations..................................................................................................................... 6
Typographic and Writing Conventions.................................................................................................6
Recommended References................................................................................................................. 7
Getting Started.............................................................................................7
Initialization Process Overview............................................................................................................7
Loading the ROM File.............................................................................................................. 7
Configuring the VLAN...............................................................................................................8
Querying the DHCP (Dynamic Host Configuration Protocol) Server....................................... 8
Contacting the Provisioning Server.......................................................................................... 8
Updating Firmware................................................................................................................... 8
Downloading the Resource Files..............................................................................................8
Verifying Startup.................................................................................................................................. 8
Teams Feature License....................................................................................................................... 9
Importing License via the Web User Interface.........................................................................9
Importing License Configuration...............................................................................................9
Device Network.......................................................................................... 10
IPv4 and IPv6 Network Settings....................................................................................................... 10
IP Addressing Mode Configuration.........................................................................................10
IPv4 Configuration.................................................................................................................. 11
IPv6 Configuration.................................................................................................................. 13
DHCP Option for IPv4.......................................................................................................................16
Supported DHCP Option for IPv4.......................................................................................... 16
DHCP Option 160 and Option 161........................................................................................ 17
DHCP Option 66, Option 43 and Custom Option.................................................................. 17
DHCP Option 42 and Option 2.............................................................................................. 18
DHCP Option 12.....................................................................................................................18
DHCP Option 60.....................................................................................................................18
DHCP Option for IPv6.......................................................................................................................19
Supported DHCP Option for IPv6.......................................................................................... 19
VLAN..................................................................................................................................................19
LLDP Configuration.................................................................................................................20
Manual VLAN Configuration................................................................................................... 20
DHCP VLAN Configuration.....................................................................................................21
VLAN Change Configuration.................................................................................................. 22
Wi-Fi...................................................................................................................................................22
Wi-Fi Configuration................................................................................................................. 22
Internet Port.......................................................................................................................................25
Supported Transmission Methods.......................................................................................... 25
Internet Port Configuration..................................................................................................... 25
802.1x Authentication........................................................................................................................ 25
802.1x Authentication Configuration.......................................................................................26
Quality of Service (QoS)................................................................................................................... 27
QoS Configuration.................................................................................................................. 27
Maximum Transmission Unit (MTU).................................................................................................. 28
| Contents | iii
MTU Configuration..................................................................................................................28
Device Provisioning...................................................................................29
Provisioning Points to Consider........................................................................................................ 29
Boot Files, Configuration Files, and Resource Files.........................................................................29
Boot Files................................................................................................................................30
Configuration Files.................................................................................................................. 32
Resource Files........................................................................................................................34
Files Download Process......................................................................................................... 35
Provisioning Methods........................................................................................................................ 36
Provisioning Methods Priority................................................................................................. 36
Manual Provisioning................................................................................................................36
Central Provisioning................................................................................................................39
Setting Up a Provisioning Server......................................................................................................41
Supported Provisioning Protocols.......................................................................................... 41
Supported Provisioning Server Discovery Methods............................................................... 42
Configuring a Provisioning Server..........................................................................................43
Firmware Upgrade..................................................................................... 47
Firmware for Each Device Model......................................................................................................47
Firmware Upgrade Configuration...................................................................................................... 47
Device Customization................................................................................48
Language........................................................................................................................................... 48
Language Display Configuration.............................................................................................49
Language Customization........................................................................................................ 49
Example: Setting a Custom Language for Device Display.....................................................54
Screen Saver..................................................................................................................................... 54
Screensaver Configuration......................................................................................................54
Backlight.............................................................................................................................................56
Backlight Brightness and Time Configuration........................................................................ 57
Time and Date...................................................................................................................................57
Time Zone...............................................................................................................................57
NTP Settings...........................................................................................................................59
DST Settings...........................................................................................................................61
Time and Date Manual Configuration.................................................................................... 65
| Contents | iv
Security Features.......................................................................................66
User and Administrator Identification................................................................................................ 66
User and Administrator Identification Configuration............................................................... 67
Transport Layer Security (TLS)......................................................................................................... 68
Supported Cipher Suites........................................................................................................ 68
Supported Trusted and Server Certificates............................................................................ 69
TLS Configuration................................................................................................................... 71
Encrypting Configuration Files.......................................................................................................... 73
Configuration Files Encryption Tools...................................................................................... 73
Configuration Files Encryption and Decryption...................................................................... 73
Encryption and Decryption Configuration...............................................................................73
Example: Encrypting Configuration Files............................................................................... 75
Troubleshooting Methods......................................................................... 86
Exporting All the Diagnostic Files..................................................................................................... 86
Log Files............................................................................................................................................ 86
Local Log................................................................................................................................ 86
Syslog Log.............................................................................................................................. 90
Packets Capture................................................................................................................................ 93
Capturing the Packets via Web User Interface...................................................................... 93
Ethernet Software Capturing Configuration............................................................................94
Analyzing Configuration Files............................................................................................................94
Exporting BIN Files from the Device......................................................................................94
Importing BIN Files from the Device...................................................................................... 94
Device Status.....................................................................................................................................95
Viewing the Device Status......................................................................................................95
Resetting Device and Configuration..................................................................................................95
Resetting the Device to Default Factory Settings...................................................................96
Resetting the Device to Custom Factory Settings................................................................. 96
Deleting the Custom Factory Settings Files...........................................................................97
Device Reboot................................................................................................................................... 97
Rebooting the Device via Endpoint........................................................................................ 97
| Contents | v
Troubleshooting Solutions........................................................................98
IP Address Issues............................................................................................................................. 98
The device does not get an IP address.................................................................................98
IP Conflict............................................................................................................................... 98
Specific format in configuring IPv6 on Yealink devices.......................................................... 98
Time and Date Issues....................................................................................................................... 99
Display time and date incorrectly........................................................................................... 99
Display Issues....................................................................................................................................99
The device LCD screen blank................................................................................................ 99
The device displays “Offline”.................................................................................................. 99
Firmware and Upgrading Issues....................................................................................................... 99
Fail to upgrade the device firmware.......................................................................................99
The device does not update the configurations..................................................................... 99
System Log Issues..........................................................................................................................100
Fail to export the system log from a provisioning server (FTP/TFTP server)....................... 100
Fail to export the system log from a syslog server.............................................................. 100
Password Issues..............................................................................................................................100
Restore the administrator password.....................................................................................100
| Introduction | 6
Introduction
Yealink administrator guide provides general guidance on setting up device network, provisioning and
managing Teams devices. This guide is not intended for end users, but administrators.
Yealink MeetingBar A20 Microsoft Teams devices are the collaborative devices with Microsoft. As an
administrator, you can do the following with this guide:
• Manage the Teams devices with Microsoft Teams & Skype for Business Admin Center.
• Set up a provisioning server.
• Provision the device with features and settings.
• Troubleshoot, update, and maintain the devices.
The information detailed in this guide applies to the following Yealink devices running firmware:
• Meetingbar A20 Teams video collaboration bar: 133.15.0.20 or later
Read the Yealink Products Regulatory Notices guide for all regulatory and safety guidance.
• Related Documentations
• Typographic and Writing Conventions
• Recommended References
Related Documentations
The following related documents are available:
• Quick Start Guides, describe how to assemble Teams devices and configure the most basic features
available on the devices.
• User Guides, describe how to configure and use the basic and advanced features available on the
devices via the endpoint.
For support or service, please contact your Yealink reseller or go to Yealink Technical Support online: http://
support.yealink.com/.
Convention Description
Bold Highlights the web/endpoint items such as menus, menu selections, soft keys, or
directory names when they are involved in a procedure or user action (for example,
select Settings > Device Settings.
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)://[IPv6address]).
You also need to know the following writing conventions to distinguish conditional information:
| Getting Started | 7
Convention Description
<> Indicates that you must enter specific information. For example, when you see
<MAC>, enter your device’s 12-digit MAC address. If you see <deviceIPAddress>,
enter your device’s IP address.
> Indicates that you need to select an item from a menu. For example, Settings
> Device Settings indicates that you need to select Device Settings from the
Settings menu.
Recommended References
For more information on configuring and administering other Yealink products not included in this guide,
refer to the product support page at Yealink Technical Support.
To access the latest Release Notes or other guides for Yealink devices, refer to the Document Download
page for your device at Yealink Technical Support.
If you want to find Request for Comments (RFC) documents, type http://www.ietf.org/rfc/rfcNNNN.txt (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.
Getting Started
This chapter provides basic initialization instructions for Teams devices.
• Initialization Process Overview
• Verifying Startup
• Teams Feature License
Updating Firmware
If you define the access URL of firmware in the configuration file, the device will download firmware from
the provisioning server. If the MD5 value of the downloaded firmware file differs from the one stored in the
flash memory, the device will perform a firmware update.
You can manually upgrade the firmware if the device does not download firmware from the provisioning
server.
Verifying Startup
After connected to the power and network, the devices begin the initialization process:
The setup wizard appears on the monitor and you can select the language via your remote control or touch
control.
| Getting Started | 9
Procedure
1. On your web user interface, go to Security > License.
2. In the Upload License File block, click the white box to select the license from your local system.
3. Click Upload.
[1]
If you change this parameter, the device will reboot to make the change take effect.
Device Network
Yealink Teams devices operate on an Ethernet local area network (LAN). You can configure the local
area network to accommodate many network designs, which varies by organizations and Yealink Teams
devices.
• IPv4 and IPv6 Network Settings
• DHCP Option for IPv4
• DHCP Option for IPv6
• VLAN
• Wi-Fi
• Internet Port
• 802.1x Authentication
• Quality of Service (QoS)
• Maximum Transmission Unit (MTU)
[1]
Parameter static.network.ip_address_mode <MAC>.cfg
Description It configures the IP addressing mode.
Permitted 0-IPv4
Values
1-IPv6
2-IPv4 & IPv6
Default 0
Web UI Network > LAN Configuration > Internet Port > IPv4/IPv6
Endpoint More > Settings > Device Settings > Network (default password: 0000) > Ethernet >
IP Mode
[1]
If you change this parameter, the device will reboot to make the change take effect.
IPv4 Configuration
The following table lists the parameters you can use to configure IPv4.
[1]
Parameter static.network.internet_port.type <MAC>.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).
2-Static IP
Default 0
Web UI Network > LAN Configuration > IPv4 Config > Configuration Type
Endpoint More > Settings > Device Settings > Network (default password: 0000) >
Ethernet > IPv4 Type > DHCP
[1]
Parameter static.network.internet_port.ip <MAC>.cfg
Description It configures the IPv4 address.
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).
Endpoint More > Settings > Device Settings > Network (default password: 0000) >
Ethernet > IPv4 Type > DHCP (Off) > IP Address
[1]
Parameter static.network.internet_port.mask <MAC>.cfg
| Device Network | 12
Endpoint More > Settings > Device Settings > Network (default password: 0000) >
Ethernet > IPv4 Type > DHCP (Off) > Subnet Mask
[1]
Parameter static.network.internet_port.gateway <MAC>.cfg
Description It configures the IPv4 default gateway.
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).
Endpoint More > Settings > Device Settings > Network (default password: 0000) >
Ethernet > IPv4 Type > DHCP (Off) > Gateway
[1]
Parameter static.network.static_dns_enable <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 device will use the IPv4 DNS obtained from DHCP.
1-On, the device will use manually configured static IPv4 DNS.
Default 0
Web UI Network > LAN Configuration > IPv4 Config > Static DNS
[1]
Parameter static.network.primary_dns <MAC>.cfg
Description It configures the primary IPv4 DNS server.
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).
Web UI Network > LAN Configuration > IPv4 Config > Configuration Type(Static IP) >
Primary DNS
Or Network > LAN Configuration > IPv4 Config > Configuration Type(DHCP) >
Static DNS(On) > Primary DNS
Endpoint More > Settings > Device Settings > Network (default password: 0000) >
Ethernet > IPv4 Type > DHCP(Off) > IPv4 Pri DNS
Or More > Settings > Device Settings > Network (default password: 0000) >
Ethernet > IPv4 Type > IPv4 Static DNS(On) > IPv4 Pri DNS
[1]
Parameter static.network.secondary_dns <MAC>.cfg
Description It configures the secondary IPv4 DNS server.
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).
Endpoint More > Settings > Device Settings > Network (default password: 0000) >
Ethernet > IPv4 Type > DHCP(Off) > IPv4 Sec DNS
Or More > Settings > Device Settings > Network (default password: 0000) >
Ethernet > IPv4 Type > IPv4 Static DNS(On) > IPv4 Sec DNS
[1]
If you change this parameter, the device will reboot to make the change take effect.
IPv6 Configuration
If you configure the network settings on the device for an IPv6 network, you can set up an IP address for
the device 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 device, the server can specify the device to obtain the
IPv6 address and other network settings either from SLAAC or from DHCPv6, if the SLAAC server is not
working, the device 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.
[1]
Parameter static.network.ipv6_internet_port.type <MAC>.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).
| Device Network | 14
Endpoint More > Settings > Device Settings > Network (default password: 0000) >
Ethernet > IPv6 Type
[1]
Parameter static.network.ipv6_internet_port.ip <MAC>.cfg
Description It configures the IPv6 address.
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).
Endpoint More > Settings > Device Settings > Network (default password: 0000) >
Ethernet > IPv6 Type > DHCP (Off) > IP Address
[1]
Parameter static.network.ipv6_prefix <MAC>.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).
Endpoint More > Settings > Device Settings > Network (default password: 0000) >
Ethernet > IPv6 Type > DHCP (Off) > IPv6 IP Prefix
[1]
Parameter static.network.ipv6_internet_port.gateway <MAC>.cfg
Description It configures the IPv6 default gateway.
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).
Endpoint More > Settings > Device Settings > Network (default password: 0000) >
Ethernet > IPv6 Type > DHCP (Off) > Gateway
[1]
Parameter static.network.ipv6_static_dns_enable <MAC>.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 device will use the IPv6 DNS obtained from DHCP.
1-On, the device will use manually configured static IPv6 DNS.
Default 0
Web UI Network > LAN Configuration > IPv6 Config > Static IPv6 DNS
[1]
Parameter static.network.ipv6_primary_dns <MAC>.cfg
Description It configures the primary IPv6 DNS server.
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).
Endpoint More > Settings > Device Settings > Network (default password: 0000) >
Ethernet > IPv6 Type > DHCP(Off) > IPv6 Pri DNS
Or More > Settings > Device Settings > Network (default password: 0000) >
Ethernet > IPv6 Type > DHCP(On) > IPv6 Static DNS(On) > IPv6 Pri DNS
[1]
Parameter static.network.ipv6_secondary_dns <MAC>.cfg
Description It configures the secondary IPv6 DNS server.
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).
Endpoint More > Settings > Device Settings > Network (default password: 0000) >
Ethernet > IPv6 Type > DHCP(Off) > IPv6 Sec DNS
Or More > Settings > Device Settings > Network (default password: 0000) >
Ethernet > IPv6 Type > DHCP(On) > IPv6 Static DNS(On) > IPv6 Sec DNS
[1]
If you change this parameter, the device will reboot to make the change take effect.
Permitted 0-Off
Values
1-On
Default 1
Web UI Setting > Auto Provision > DHCP Active
[1]
Parameter static.auto_provision.dhcp_option.list_user_options <y0000000000xx>.cfg
Description It configures the custom DHCP option for requesting provisioning server address.
Multiple DHCP options are separated by commas.
Note: It works only if “static.auto_provision.dhcp_option.enable” is set to 1 (On).
Permitted Integer from 128 to 254
Values
Default 160,161
Web UI Setting > Auto Provision > Custom Option
[1]
If you change this parameter, the device will reboot to make the change take effect.
The Teams device 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
device. The option must be in accordance with the one defined in the DHCP server.
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 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 until the time is out.
DHCP Option 12
You can specify a hostname for the device 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.
• DHCP Option 12 Hostname Configuration
[1]
If you change this parameter, the device will reboot to make the change take effect.
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. The default vendor class ID is “yealink”.
• DHCP Option 60 Configuration
| Device Network | 19
[1]
If you change this parameter, the device will reboot to make the change take effect.
VLAN
The purpose of VLAN configurations on the device is to insert a tag with VLAN information to the packets
generated by the device. When VLAN is properly configured for the ports on the device, the device will tag
all packets from these ports with the VLAN ID. The switch 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.
In addition to manual configuration, the device also supports the automatic discovery of VLAN via LLDP,
or DHCP. The assignment takes effect in this order: assignment via LLDP, manual configuration, then
assignment via DHCP.
• LLDP Configuration
• Manual VLAN Configuration
• DHCP VLAN Configuration
• VLAN Change Configuration
| Device Network | 20
LLDP Configuration
LLDP (Linker Layer Discovery Protocol) is a vendor-neutral Link Layer protocol, which allows devices 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 the LLDP feature is enabled on the devices, the devices periodically advertise their information
to the directly connected LLDP-enabled switch. The devices can also receive LLDP packets from the
connected switch. When the application type is “voice”, the devices decide whether to update the VLAN
configurations obtained from the LLDP packets. When the VLAN configurations on the devices are different
from the ones sent by the switch, the devices perform an update and reboot. This allows the devices 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.
[1]
Parameter static.network.lldp.enable <y0000000000xx>.cfg
Description It enables or disables the LLDP feature on the device.
Permitted Values 0-Disabled
1-Enabled, the device will attempt to determine its VLAN ID through LLDP.
Default 1
Web UI Network > Advanced > LLDP > Active
Endpoint More > Settings > Device Settings > Network (default password: 0000) >
LLDP protocol > Activated
[1]
Parameter static.network.lldp.packet_interval <y0000000000xx>.cfg
Description It configures the interval (in seconds) that how often the device sends the LLDP
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)
Endpoint More > Settings > Device Settings > Network (default password: 0000) >
LLDP protocol > Contracting interval(1-3600s)
[1]
If you change this parameter, the device will reboot to make the change take effect.
Default 0
Web UI Network > Advanced > VLAN > Internet Port > Active
Endpoint More > Settings > Device Settings > Network (default password: 0000) >
VLAN > Activated
[1]
Parameter static.network.vlan.internet_port_vid <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 > Internet Port > VID(1-4094)
Endpoint More > Settings > Device Settings > Network (default password: 0000) >
VLAN > Activated(On) > VID(1-4094)
[1]
Parameter static.network.vlan.internet_port_priority <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 1
Web UI Network > Advanced > VLAN > Internet Port > Priority
Endpoint More > Settings > Device Settings > Network (default password: 0000) >
VLAN > Activated(On) > Priority
[1]
If you change this parameter, the device will reboot to make the change take effect.
[1]
If you change this parameter, the device will reboot to make the change take effect.
1-Enabled, the device will attempt to use the lower priority method when failing to obtain
the VLAN ID using a higher priority method. If all the methods are attempted, the device will
disable the VLAN feature.
Default 0
[1]
If you change this parameter, the device will reboot to make the change take effect.
Wi-Fi
Wi-Fi feature enables you to connect the devices to the organization’s wireless network.
• Wi-Fi Configuration
Wi-Fi Configuration
The following table lists the parameters you can use to configure the Wi-Fi.
[1]
Parameter static.wifi.function.enable <y0000000000xx>.cfg
Description It enables or disables the Wi-Fi feature.
Permitted Values 0-Disabled
1-Enabled
Default 1
Parameter static.wifi.enable <y0000000000xx>.cfg
| Device Network | 23
Default 0
Web UI Network > Wi-Fi > Wi-Fi
Endpoint More > Settings > Device Settings > Wi-Fi (default password: 0000) > Wi-Fi
[2]
Parameter static.wifi.X.label <y0000000000xx>.cfg
Description It configures the profile name of a specific wireless network.
Note: It works only if "static.wifi.function.enable" and "static.wifi.enable" are set to
1 (Enabled).
[1]
If you change this parameter, the device will reboot to make the change take effect.
[2]
X is the Wi-Fi ID. X=1-5.
| Device Network | 25
Internet Port
You can configure the transmission method for the Internet port.
• Supported Transmission Methods
• Internet Port Configuration
Default 0
Web UI Network > Advanced > Port Link > WAN Port Link
[1]
If you change this parameter, the device will reboot to make the change take effect.
802.1x Authentication
Yealink Teams 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.
• 802.1x Authentication Configuration
| Device Network | 26
Default 0
Web UI Network > Advanced > 802.1x > 802.1x Mode
Endpoint More > Settings > Device Settings > Network(default password: 0000) >
802.1x Mode
[1]
Parameter static.network.802_1x.identity <y0000000000xx>.cfg
Description It configures the user name for 802.1x authentication.
Note: It works only if “static.network.802_1x.mode” is set to 1, 2, 3, 4.
Permitted Values String within 32 characters
Default Blank
Web UI Network > Advanced > 802.1x > Identity
[1]
Parameter static.network.802_1x.md5_password <y0000000000xx>.cfg
Description It configures the password for 802.1x authentication.
Note: It works only if “static.network.802_1x.mode” is set to 1, 3, 4.
Permitted Values String within 32 characters
Default Blank
Web UI Network > Advanced > 802.1x > MD5 Password
[1]
Parameter static.network.802_1x.root_cert_url <y0000000000xx>.cfg
Description It configures the access URL of the CA certificate.
The format of the certificate must be *.pem, *.crt, *.cer or *.der.
Note: It works only if “static.network.802_1x.mode” is set to 2, 3, 4.
Permitted Values URL within 511 characters
Default Blank
Web UI Network > Advanced > 802.1x > CA Certificates
[1]
Parameter static.network.802_1x.client_cert_url <y0000000000xx>.cfg
| Device Network | 27
[1]
If you change this parameter, the device will reboot to make the change take effect.
QoS Configuration
The following table lists the parameter you can use to configure QoS.
[1]
Parameter static.network.qos.enable <y0000000000xx>.cfg
Description It enables or disables the QoS feature.
Permitted 0-Disabled
Values
1-Enabled
Default 1
Web UI Network > Advanced > QoS > QoS Enable
Endpoint More > Settings > Device Settings > Network > QoS > Quality of service
[1]
Parameter static.network.qos.audiotos <y0000000000xx>.cfg
Description It configures the DSCP (Differentiated Services Code Point) for audio packets.
| Device Network | 28
[1]
If you change this parameter, the device will reboot to make the change take effect.
MTU Configuration
The following table lists the parameter you can use to configure MTU.
[1]
Parameter static.network.mtu_value <y0000000000xx>.cfg
Description It configures the MTU (Maximum Transmission Unit) of network interface card.
Permitted Integer from 1000 to 1500
Values
Default 1500
Web UI Network > Advanced > MTU > Network MTU(1000-1500)
| Device Provisioning | 29
[1]
Parameter video.single_packet_mode.enable <y0000000000xx>.cfg
Description It enables or disables the restricted single packet mode.
Note: Some third-party devices only accept the data packets sent by single packet
mode. If local system sends data packets by using multiple packets mode, the video
call may be come with the mosaic. To avoid this situation, enable this Restricted Single
Packet Mode.
Default 1
Web UI Network > Advanced > MTU > Restricted Single Packet Mode
[1]
If you change this parameter, the device will reboot to make the change take effect.
Device Provisioning
This chapter provides basic instructions for setting up your devices with a provisioning server.
• Provisioning Points to Consider
• Boot Files, Configuration Files, and Resource Files
• Provisioning Methods
• Setting Up a Provisioning Server
• Resource Files
• Files Download Process
Boot Files
Teams devices support boot files. The boot files maximize the flexibility to allow you to customize features
and settings for multiple devices.
With the boot file, you can specify which configuration files should be downloaded. It is effective for you to
provision the devices in different deployment scenarios:
• For all devices
• For a group of devices
• For specific device models
• For a single device
Teams devices support two types of boot files: common boot file and MAC-Oriented boot file. You can use
the default boot template file “y000000000000.boot” to create MAC-Oriented boot file by making a copy
and renaming it.
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.
• Common Boot File
• MAC-Oriented Boot File
• Boot File Attributes
• Customizing a Boot File
Attributes Description
#!version:1.0.0.1 It must be placed in the first line. Do not edit and delete.
| Device Provisioning | 31
Attributes Description
include:config <xxx.cfg> Each “include” statement can specify a location of a configuration file. The
configuration file format must be *.cfg.
include:config "xxx.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):
For example, http://10.2.5.258/Teams.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 device model name.
The valid device model name is: MeetingBar A20.
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 the configuration files is left
blank, or if a non-static parameter in the configuration files is deleted or
commented out, the factory default value takes effect.
0-(Disabled) -If the value of a parameter in the 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_mode Enable or disable the exclude mode. The exclude mode applies to the
configuration files specified in the boot file.
0-Disabled (Append Mode), the device downloads its own model-specific
configuration files and downloads other model-unspecified configuration
files.
1-Enabled (Exclude Mode), the device attempts to download its own
model-specific configuration files; if there are 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.
Procedure
1. Open a boot template file.
| Device Provisioning | 32
2. To add a configuration file, add include:config <> or include:config “” to the file. Each starts on a
separate line.
3. Specify a configuration file for downloading.
For example:
• include:config <configure/Teams.cfg>
• include:config “http://10.2.5.206/configure/account.cfg”
• include:config “http://10.2.5.206/configure/screensaver.cfg”
4. Specify the overwrite mode and exclude mode.
For example:
• overwrite_mode = 1
• specific_model.excluded_mode = 1
5. Save the boot file and place it on the provisioning server.
Related information
Boot File Attributes
Configuration Files
Yealink devices support 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.network.lldp.enable .
• Non-static: The parameters do not start with a prefix “static.”.
You can deploy and maintain a mass of devices automatically through configuration files stored in a
provisioning server.
Note: For protecting against unauthorized access, you can encrypt configuration files. For more
information on encrypting configuration files, refer to Encrypting Configuration Files.
• Common CFG File
• MAC CFG File
• Configuration File Customization
Permitted 0-Disabled
Values
1-Enabled, the <MAC>-local.cfg file is generated and personalized non-static settings
configured via the web user interface or endpoint will be kept after auto provisioning.
Default 1
• Via web user interface at the path: Settings > Upgrade > Reset to Factory Setting > Reset User
Settings.
Note: The Reset user settings/Reset Local Settings option appears only if you set
“static.auto_provision.custom.protect = 1”.
Procedure
1. Copy and rename a configuration template file. For example, Teams.cfg.
2. Rearrange the parameters in the Teams.cfg, and set the valid values for them.
For example:
screensaver.wait_time= 60
3. Save the configuration file and place it on the provisioning server.
Attributes Description
#!version:1.0.0.1 It must be placed in the first line. Do not edit and delete.
Configuration Parameter=Valid Specify the parameters and values to apply specific settings to the devices.
Value
• Separate each configuration parameter and value with an equal sign
(screensaver.wait_time =60) • Set only one configuration parameter per line
• Put the configuration parameter and value on the same line, and do not
break the line
Tip: The line beginning with “#” is considered to be a comment. You can use “#” to make any
comment in the boot file.
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 devices request the resource files in addition to
the configuration files during auto provisioning.
Tip: If you want to specify the desired device to use the resource file, the access URL of the
resource file should be specified in the MAC-Oriented CFG file. During auto provisioning, the
devices will request the resource files in addition to the configuration files.
• Supported Resource Files
| Device Provisioning | 35
1.English.js
The parameters in the newly downloaded configuration files will override the same parameters in files
downloaded before.
Note: The parameter “specific_model.excluded_mode” determines which configuration files
referenced in the boot file to be downloaded.
| Device Provisioning | 36
Provisioning Methods
Teams devices can be configured using the following methods with your provisioning server:
• Central Provisioning: configuration files stored on a central provisioning server.
• Manual Provisioning: operations on the web user interface or endpoint.
• Provisioning Methods Priority
• Manual Provisioning
• Central Provisioning
Manual Provisioning
This method enables you to perform configuration changes on a per-device basis.
• Web User Interface Access
• Endpoint
| Device Provisioning | 37
Procedure
1. Go to More > Settings > Device Settings > About > IPv4.
2. Enter the device 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.
Default 1
Web UI Network > Advanced > Web Server > HTTP
Endpoint
More > Settings > Device Settings > Network(default password: 0000) > Web service
type (HTTP&HTTPS or HTTP)
[1]
Parameter static.network.port.http <y0000000000xx>.cfg
Description It configures the HTTP port for the user to access the web user interface of the device
using the HTTP protocol.
Permitted Integer from 1 to 65535
Values
Default 80
Web UI Network > Advanced > Web Server > HTTP Port
[1]
Parameter static.wui.https_enable <y0000000000xx>.cfg
| Device Provisioning | 38
Description It enables or disables the user to access the web user interface of the device using the
HTTPS protocol.
Permitted 0-Disabled
Values
1-Enabled
Default 1
Web UI Network > Advanced > Web Server > HTTPS
Endpoint
More > Settings > Device Settings > Network(default password: 0000) > Web service
type (HTTP&HTTPS or HTTPS)
[1]
Parameter static.network.port.https <y0000000000xx>.cfg
Description It configures the HTTPS port for the user to access the web user interface of the device
using the HTTPS protocol.
Permitted Integer from 1 to 65535
Values
Default 443
Web UI Network > Advanced > Web Server > HTTPS Port
[1]
If you change this parameter, the device will reboot to make the change take effect.
Procedure
1. From the web user interface, go to Setting > Configuration > CFG Configuration.
2. In the Import CFG Configuration File block, click the white box to select a CFG configuration file from
your local system.
3. Click Import.
• <MAC>-non-static.cfg: It contains all changes associated with the non-static parameters made via the
endpoint, web user interface and using configuration files.
• <MAC>-config.cfg: It contains the changes associated with the 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. From the web user interface, go to Setting > Configuration > CFG Configuration.
2. In the Export CFG Configuration File block, click Export to open the file download window, and then
save the file to your local system.
Endpoint
Endpoint makes configurations available to users and administrators, but the More > Settings > Device
Settings > Admin only option is only available to administrators and requires an administrator password
(default: 0000).
You can configure the devices via the endpoint on a per-device basis.
Central Provisioning
Central provisioning enables you to provision multiple devices from a provisioning server that you set up,
and maintain configuration files for all devices in the central provisioning server.
The following figure shows how the device interoperates with provisioning server when you use the
centralized provisioning method:
Using the configuration files to provision the devices and to modify features and configurations is called
the central provisioning method. You can use a text-based editing application to edit configuration files,
and then store configuration files to a provisioning server. Teams devices can be centrally provisioned from
a provisioning server. For more information on the provisioning server, refer to Setting Up a Provisioning
Server.
Teams devices can obtain the provisioning server address during startup. Then devices download
configuration files from the provisioning server, resolve and update the configurations written in
configuration files. This entire process is called auto provisioning.
• Auto Provisioning Settings Configuration
Default 1
Web UI Setting > Auto Provision > Power On
Parameter static.auto_provision.repeat.enable <y0000000000xx>.cfg
Description It triggers the repeatedly feature to on or off.
static.auto_provision.weekly.end_time
Description It configures the start/end time of the day for the device 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 Setting > Auto Provision > Time
[1]
If you change this parameter, the device will reboot to make the change take effect.
The following table lists the parameters you can use to configure static provision.
Procedure
1. Install a provisioning server application or locate a suitable existing server, such as 3CDaemon.
2. Create an account and home directory.
3. Set security permissions for the account.
4. Create boot files and configuration files, and then edit them as desired.
5. Copy the boot files, configuration files, and resource files to the provisioning server.
6. If performing static provisioning, obtain the provisioning server address.
Tip: Typically, all devices are configured with the same server account, but the server account
provides a means of conveniently partitioning the configuration. Give each account a unique
home directory on the server and change the configuration on a per-line basis.
Note: You can only manage the devices that login with the online accounts which has opened
Microsoft Teams & Skype for Business Admin Center services.
• Device Management
• Configuration Profiles Management
Device Management
You can monitor and manage your devices directly on the Microsoft Teams & Skype for Business Admin
Center.
Procedure
1. Go to Device > Manage Devices > All device.
2. Click a desired device in the All devices list.
3. Click Edit at the top left of the device list.
4. Edit device info from the right side of the pop-up menu.
5. Click Save.
Procedure
1. Go to Device > Manage Devices > All device.
2. Click at the top-right of the device list.
3. Turn on or turn off the table elements.
4. Click Save.
Procedure
1. Go to Device > Manage Devices > All device.
| Provisioning Devices on the Microsoft Teams & Skype for Business Admin Center | 45
2. Click the corresponding device name in the All devices list to enter the device details page.
You can click Details to view software update status or click History to view actions you performed for
the device.
Procedure
1. Go to Device > Manage Devices > All device.
2. Click desired devices in the All devices list.
3. Click Assign configuration at the top left of the device list.
4. Search for the configuration profile from the right side of the pop-up menu.
5. Click Save.
The configuration profile will take effect on the devices.
Related tasks
Creating a Configuration Profile
Diagnostic Devices
You can use the diagnostic feature to quickly find the root cause of the problem and troubleshoot the
problem. After diagnostic devices, you should download and check the diagnostics file.
Procedure
1. Go to Device > Manage Devices > All device.
2. Click desired devices in the All devices list.
3. Click Diagnostics at the top of the device list.
It will prompt " Log files will be retrieved from the selected device(s). Would you like to proceed?"
4. Click Proceed.
Log files will be retrieved from the selected device(s) if diagnosing successfully.
5. Click the corresponding device name in the All devices list to enter the device details page.
6. Select History and then click Download to download the log file.
Procedure
1. Go to Device > Manage Devices > All device.
2. Click desired devices in the All devices list.
3. Click Update at the top of the device list.
It will prompt " All software on the selected devices will be updated to the latest versions. Would you like
to proceed?"
4. Click Update anyway.
The current firmware of the devices will be updated automatically after a few minutes.
| Provisioning Devices on the Microsoft Teams & Skype for Business Admin Center | 46
Procedure
1. Go to Device > Manage Devices > All device.
2. Click desired devices in the All devices list.
3. Click Restart at the top of the device list.
It will prompt "The selected devices will be restarted. Would you like to proceed?"
4. Click Restart anyway.
The devices will be restarted.
Procedure
1. Go to Device > Manage Devices > Configuration profiles.
2. Click New configuration profiles at the top left of the configuration profiles list.
3. Edit the configuration profile name and description.
4. Configure the general settings, device settings, or network settings.
5. Click Save.
Procedure
1. Go to Device > Manage Devices > Configuration profiles.
2. Click a desired configuration file in the Configuration file list.
3. Click Edit at the top left of the configuration profiles list.
4. Edit the configuration profile.
5. Click Save.
| Firmware Upgrade | 47
Procedure
1. Go to Device > Manage Devices > Configuration profiles.
2. Click a desired configuration file in the Configuration file list.
3. Click Assigned to devices at the top of the configuration profiles list.
4. Search for the devices from the right side of the pop-up menu.
5. Click Save.
The configuration profile will take effect on the devices.
Firmware Upgrade
There are three methods of firmware upgrade:
• Manually, from the local system for a single device via the web user interface.
• Automatically, from the provisioning server for a mass of devices.
• Upgrade all device software to the latest version with one click on the Microsoft Teams & Skype for
Business Admin Center. It is only applicable to devices running the Teams firmware.
Note: We recommend that devices running the latest firmware should not be downgraded to an
earlier firmware version. The new firmware is compatible with old configuration parameters, but not
vice versa.
It supports the bundle upgrade for audio pack when upgrading the firmware - no need for user to
have a tool to manage CP900. Do not unplug the CP900 USB cable from MeetingBar A20 when the
device is upgrading firmware. If the upgrade fails, please contact the Yealink support team.
• Firmware for Each Device Model
• Firmware Upgrade Configuration
Related tasks
Updating Device Software
The following table lists the parameter you can use to upgrade firmware.
[1]
Parameter static.firmware.url <y0000000000xx>.cfg
Description It configures the access URL of the firmware file.
[1]
If you change this parameter, the device will reboot to make the change take effect.
Device Customization
You can make the Teams device more personalized by customizing various settings.
• Language
• Screen Saver
• Backlight
• Time and Date
Language
Teams devices support multiple languages. Languages used on the endpoint and web user interface can
be specified respectively as required.
You can ask the distributor or Yealink FAE for language packs. You can also obtain the language packs
online: http://support.yealink.com/documentFront/forwardToDocumentFrontDisplayPage.
The following table lists available languages and associated language packs supported by the endpoint
and the web user interface.
Default English
Endpoint More > Settings > Device Settings > Language
Language Customization
You can customize the language file to display on the endpoint or web user interface.
You can ask the distributor or Yealink FAE for language packs. You can also obtain the language packs
online: http://support.yealink.com/documentFront/forwardToDocumentFrontDisplayPage.
Note: The newly added language must be supported by the font library on the device. If the
characters in the custom language file are not supported by the device, the device will display “?”
instead.
• Language for Device Display Customization
• Language for Web Display Customization
| Device Customization | 50
1. Open the desired language template pack (for example, 1.English.js) using an ASCII editor.
| Device Customization | 52
2. Modify the characters within the double quotation marks on the right of the colon. Do not modify the
translation item on the left of the colon.
The following shows a portion of the language pack “1.English.js” for the web user interface:
2. Modify the text of the note field. Do not modify the note name.
The following shows a portion of the note language pack “1.English_note.xml” for the web user
interface:
Default Blank
Parameter wui_lang_note.url <y0000000000xx>.cfg
Description It configures the access URL of the custom note language pack for web user
interface.
Permitted Values URL within 511 characters
For example: http://localhost/X.name_note.xml
X starts from 14, “name” is replaced with the language name
Default Blank
Parameter wui_lang.delete <y0000000000xx>.cfg
| Device Customization | 54
Description It deletes the specified or all custom web language packs and note language
packs of the web user interface.
Permitted Values http://localhost/all or http://localhost/Y.name.js
Default Blank
Screen Saver
The screen saver will automatically start when the device is idle for the preset waiting time.
By default, the device screen displays a built-in picture when the screen saver starts. You can set the
device to display the other built-in screensaver background. You can also set the device to display the
custom screensaver background.
• Screensaver Configuration
Screensaver Configuration
The following table lists the parameters you can use to configure the screensaver.
| Device Customization | 55
Default 30
Web UI Setting > General > Screensaver > Screensaver Wait Time
Endpoint More > Settings > Device Settings > Display > Screensaver Waiting Time
Default Blank
Web UI Setting > General > Screensaver > Screensaver Type
Endpoint
More > Settings > Device Settings > Display > Screen Saver Type
Permitted Default.jpg
Values
01.png
02.png
03.png
04.png
05.png
06.png
07.png
08.png
Default Default.jpg
Web UI Setting > General > Screensaver > Screensaver Type(System) > Screensaver
Background
Setting > General > Screensaver > Screensaver Type(Custom) > Screensaver
Endpoint More > Settings > Device Settings > Display > Screensaver Type(System) >
Screensaver background
Permitted String
Values
Default Blank
Backlight
You can change the brightness of LCD backlight when the device is active (in use). The brightness of LCD
backlight automatically changes when the device is idle for a specified time.
You can change the brightness of LCD backlight and time in the following settings:
Backlight Active Level: The brightness level of the LCD backlight when the device is active.
Backlight Time: The delay time to change the brightness of the LCD backlight when the device is inactive.
Backlight time includes the following settings:
• Always On: Backlight is on permanently.
• 15s, 30s, 1min, 2min, 5min, 10min,30min, 45min or 1h: Backlight is changed when the device is
inactive after the designated time (in seconds).
• Backlight Brightness and Time Configuration
| Device Customization | 57
Default 0
Web UI Setting > General > General Information > Backlight Time
Endpoint More > Settings > Device Settings > Display > Backlight Time
Time Zone
The following table lists the values you can use to set the time zone location.
NTP Settings
You can set an NTP time server for the desired area as required. The NTP time server address can be
offered by the DHCP server or configured manually.
• NTP Configuration
NTP Configuration
The following table lists the parameters you can use to configure the NTP.
Description It enables or disables the device to update time with the offset time offered by the
DHCP server.
Note: It is only available to offset time from Greenwich Mean Time GMT 0.
Permitted 0-Disabled
Values
1-Enabled
Default 0
Web UI Setting > Date&Time > DHCP Time
Endpoint More > Settings > Device Settings > Time & Date > DHCP Time > DHCP Time
Endpoint More > Settings > Device Settings > Time & Date > General > NTP Server1
Endpoint More > Settings > Device Settings > Time & Date > General > NTP Server2
Description It configures the interval (in seconds) at which the device updates time and date from
the NTP server.
Permitted -12 to +14
Values
For available time zones, refer to Time Zone.
Default +8
Web UI Setting > Date&Time > Time Zone
Endpoint More > Settings > Device Settings > Time&Date > General > Time Zone
Parameter local_time.time_zone_name <MAC>.cfg
Description It configures the time zone name.
Note: It works only if “local_time.summer_time” is set to 2 (Automatic) and the
parameter “local_time.time_zone” should be configured in advance.
Permitted String within 32 characters
Values
The available time zone names depend on the time zone configured by
“local_time.time_zone”. For available time zone names, refer to Time Zone.
Default China(Beijing)
Web UI Setting > Date&Time > Location
Endpoint More > Settings > Device Settings > Time & Date > General > Location
DST Settings
You can set DST for the desired area as required. By default, the DST is set to Automatic, so it can be
adjusted automatically from the current time zone configuration.
The time zone and corresponding DST pre-configurations exist in the AutoDST file. If the DST is set to
Automatic, the device obtains the DST configuration from the AutoDST file.
You can customize the AutoDST file if required. The AutoDST file allows you to add or modify the time zone
and DST settings for your area each year.
• Auto DST File Customization
• DST Configuration
Month: 1~12
Day: 1~31
Hour: 0 (midnight)~23
Month/Week of Month/Day of Week/
Hour of Day (for iType=1)
Month: 1~12
Week of Month: 1~5 (the last week)
Day of Week: 1~7
Hour of Day: 0 (midnight)~23
Procedure
1. Open the AutoDST file.
2. To add a new time zone, add <DST szTime="" szZone="" iType="" szStart="" szEnd="" szOffset=""/>
between <DSTData> and </DSTData>.
| Device Customization | 63
Modify the DST settings for the existing time zone “+5 Pakistan(Islamabad)” and add DST settings for
the existing time zone “+5:30 India(Calcutta)”.
DST Configuration
The following table lists the parameters you can use to configure DST.
Default 2
Web UI Setting > Date&Time > Daylight Saving Time
Endpoint More > Settings > Device Settings > Time & Date > General > Daylight Saving
Description It configures the offset time (in minutes) of Daylight Saving Time (DST).
Note: It works only if “local_time.summer_time” is set to 1 (Enabled).
Permitted Values Integer from -300 to 300
Default Blank
Web UI Setting > Date&Time > Offset(minutes)
Default Blank
Default 0
Web UI Setting > Date&Time > Manual Time
Default 1
| Security Features | 66
Endpoint More > Settings > Device Settings > Time&Date > Time & Date Format > Time
Format
Endpoint More > Settings > Device Settings > Time&Date > Time & Date Format > Date
Format
Security Features
When logging into the web user interface or access the advanced settings on the device, as an
administrator, you need an administrator password to access various menu options. The default
administrator name is “admin” and the administrator password is “0000”. The default user name is “user”
and the password is “user”.
For security reasons, you should change the default user or administrator password as soon as possible.
Since the advanced menu options are strictly used by the administrator, users can configure them only if
they have administrator privileges.
• User and Administrator Identification Configuration
Endpoint More > Settings > Device Settings > Admin Password(default
password: 0000)
Note: You cannot change the user password via the endpoint.
| Security Features | 68
• AmazonRootCA2
• AmazonRootCA1
• Yealink Root CA
• Yealink Equipment Issuing CA
• SIP Core
Note: Yealink endeavors to maintain a built-in list of most commonly used CA Certificates. Due to
memory constraints, we cannot ensure a complete set of certificates. If you are using a certificate
from a commercial Certificate Authority but is not in the list above, you can send a request to your
local distributor. At this point, you can upload your particular CA certificate into your device.
TLS Configuration
The following table lists the parameters you can use to configure TLS.
[1]
Parameter static.security.trust_certificates <y0000000000xx>.cfg
Description It enables or disables the device to only trust the server certificates listed in the Trusted
Certificates list.
Permitted Values 0-Disabled, the device will trust the server no matter whether the certificate sent by the
server is valid or not.
1-Enabled, the device will authenticate the server certificate based on the trusted
certificates list. Only when the authentication succeeds, will the device trust the server.
Default 1
Web UI Security > Trusted Certs > Only Accept Trusted Certificates
[1]
Parameter static.security.ca_cert <y0000000000xx>.cfg
Description It configures the type of certificates in the Trusted Certificates list for the device to
authenticate for TLS connection.
Permitted Values 0-Default Certificates
1-Custom Certificates
2-All Certificates
Default 2
Web UI Security > Trusted Certs > CA Certificates
[1]
Parameter static.security.cn_validation <y0000000000xx>.cfg
Description It enables or disables the device to mandatorily validate the CommonName or
SubjectAltName of the certificate sent by the server.
Permitted Values 0-Disabled
1-Enabled
Default 0
Web UI Security > Trusted Certs > Common Name Validation
Parameter static.trusted_certificates.url <y0000000000xx>.cfg
| Security Features | 72
Description It configures the access URL of the custom trusted certificate used to authenticate the
connecting server.
Example:
static.trusted_certificates.url = http://192.168.1.20/tc.crt
Note: The certificate you want to upload must be in *.pem, *.crt, *.cer or *.der format.
Permitted Values URL within 511 characters
Default Blank
Web UI Security > Trusted Certs > Upload Trusted Certificate File
Parameter static.trusted_certificates.delete <y0000000000xx>.cfg
Description It deletes all uploaded trusted certificates.
[1]
If you change this parameter, the device will reboot to make the change take effect.
Description It enables or disables the device only to download the encrypted files.
Permitted Values 0-Disabled, the device will download the configuration files (for example, sip.cfg,
account.cfg, <MAC>-local.cfg) and <MAC>-contact.xml file from the server during
auto provisioning no matter whether the files are encrypted or not. And then the
device resolves these files and updates the settings onto the device system.
1-Enabled, the device will only download the encrypted configuration files (for
example, sip.cfg, account.cfg, <MAC>-local.cfg) or <MAC>-contact.xml file from the
server during auto provisioning, and then resolve these files and update settings onto
the device system.
Default 0
Parameter static.auto_provision.aes_key_in_file <y0000000000xx>.cfg
Description It enables or disables the device to decrypt configuration files using the encrypted
AES keys.
Permitted Values 0-Disabled, the device will decrypt the encrypted configuration files using plaintext
AES keys configured on the device.
1-Enabled, the device will download <xx_Security>.enc files (for example,
<sip_Security>.enc, <account_Security>.enc) during auto provisioning, and then
decrypts these files into the plaintext keys (for example, key2, key3) respectively
using the device built-in key (for example, key1). The device then decrypts the
encrypted configuration files using corresponding key (for example, key2, key3).
Default 0
Parameter static.auto_provision.aes_key_16.com <y0000000000xx>.cfg
Description It configures the plaintext AES key for encrypting/decrypting the Common CFG/
Custom CFG file.
The valid characters contain: 0 ~ 9, A ~ Z, a ~ z and the following special characters
are also supported: # $ % * + , - . : = ? @ [ ] ^ _ { } ~.
Example:
static.auto_provision.aes_key_16.com = 0123456789abcdef
Note: For decrypting, it works only if “static.auto_provision.aes_key_in_file” is set to
0 (Disabled). If the downloaded MAC-Oriented file is encrypted and the parameter
“static.auto_provision.aes_key_16.mac” is left blank, the device will try to encrypt/
decrypt the MAC-Oriented file using the AES key configured by the parameter
“static.auto_provision.aes_key_16.com”.
Permitted Values 16 characters
Default Blank
Web UI Setting > Auto Provision > Common AES Key
Parameter static.auto_provision.aes_key_16.mac <y0000000000xx>.cfg
| Security Features | 75
Description It configures the plaintext AES key for encrypting/decrypting the MAC-Oriented files
(<MAC>.cfg, <MAC>-local.cfg and <MAC>-contact.xml).
The valid characters contain: 0 ~ 9, A ~ Z, a ~ z and the following special characters
are also supported: # $ % * + , - . : = ? @ [ ] ^ _ { } ~.
Example:
static.auto_provision.aes_key_16.mac = 0123456789abmins
Note: For decrypting, it works only if “static.auto_provision.aes_key_in_file” is set to
0 (Disabled). If the downloaded MAC-Oriented file is encrypted and the parameter
“static.auto_provision.aes_key_16.mac” is left blank, the device will try to encrypt/
decrypt the MAC-Oriented file using the AES key configured by the parameter
“static.auto_provision.aes_key_16.com”.
Permitted Values 16 characters
Default Blank
Web UI Setting > Auto Provision > MAC-Oriented AES Key
2. When you start the application tool, a file folder named “Encrypted” is created automatically in the
directory where the application tool is located.
3. Click Browse to locate configuration file(s) (for example, account.cfg) from your local system in the
Select File(s)field.
To select multiple configuration files, you can select the first file and then press and hold the Ctrl key
and select other files.
4. (Optional.) Click Browse to locate the target directory from your local system in the Target Directory
field.
The tool uses the file folder “Encrypted” as the target directory by default.
| Configuring Camera Settings | 76
5. (Optional.) Mark the desired radio box in the AES Model field.
If you mark the Manual radio box, you can enter an AES KEY in the AES KEY field or click Re-
Generate to generate an AES KEY in the AES KEY field. The configuration file(s) will be encrypted
using the AES KEY in the AES KEY field.
If you mark the Auto Generate radio box, the configuration file(s) will be encrypted using random AES
KEY. The AES keys of configuration files are different.
6. Click Encrypt to encrypt the configuration file(s).
7. Click OK.
The target directory will be automatically opened. You can find the encrypted CFG file(s), encrypted key
file(s) and an Aeskey.txt file storing plaintext AES key(s).
Default 0
Web UI Setting > Camera > Camera Mode > Framing mode
Endpoint More > Settings > Device Settings > Others > Framing Mode
Parameter features.video_framing.move_effect_enable <y0000000000xx>.cfg
Description It configures the video switching mode.
Note: It works only if "features.video_framing.mode" is set to 1 (Auto Framing).
Default 0
Web UI Setting > Camera > Camera Mode > Video Switching Mode
Procedure
1. Do one of the following:
• On your web user interface, go to Setting > Camera > White Balance.
• On your MeetingBar A20, go to More > Settings > Device Settings > Camera Settings > White
Balance Settings.
| Configuring Camera Settings | 78
Color Temperature Configure the value of the color temperature. Web user
interface
Note: the value is from 2800K to 6800K. The default
value is the color temperature tested in your current Endpoint
environment. You can set this parameter only when the
white balance mode is configured to Manual Setting.
Procedure
1. Do one of the following:
• On your web user interface, go to Setting > Camera > Exposure.
• On your MeetingBar A20, go to More > Settings > Device Settings > Camera Settings >
Exposure Settings.
2. Select Auto Exposure from the Exposure Mode drop-down menu.
| Configuring Camera Settings | 79
Flicker Configure the value of camera flicker frequency. Web user interface
The supported types are as follows: Endpoint
• 50 Hz
• 60 Hz
The indoor lights powered by a 50Hz or 60Hz power
source may produce a flicker. You can adjust the
camera flicker frequency according to the power source
that the light is powered by.
Default: 50 Hz.
Wide Dynamic Off or Specify the WDR. The value represents the Web user interface
Range compression degree of the dynamic range
Endpoint
Cameras with WDR technology can work perfectly both
in the bright and the dark conditions and present clear
images that balance different lighting, so that you can
identify the details.
• Off- do not use WDR.
• 1~5
Default: Off.
Procedure
1. Do one of the following:
• On your web user interface, go to Setting > Camera > Exposure.
• On your MeetingBar A20, go to More > Settings > Device Settings > Camera Settings >
Exposure Settings.
2. Select Manual Exposure from the Exposure Mode drop-down menu.
3. Configure and save the following settings:
Wide Dynamic Off or Specify the WDR. The value represents the Web user interface
Range compression degree of the dynamic range
Endpoint
Cameras with WDR technology can work perfectly both
in the bright and the dark conditions and present clear
images that balances different lighting, so that you can
identify the details.
• Off- do not use WDR.
• 1~5
Default: Off.
Procedure
1. Do one of the following:
• On your web user interface, go to Setting > Camera > Exposure.
• On your MeetingBar A20, go to More > Settings > Device Settings > Camera Settings >
Exposure Settings.
2. Select Shutter Priority from the Exposure Mode drop-down menu.
| Configuring Camera Settings | 81
Wide Dynamic Off or Specify the WDR. The value represents the Web user interface
Range compression degree of the dynamic range
Endpoint
Cameras with WDR technology can work perfectly both
in the bright and the dark conditions and present clear
images that balance different lighting, so that you can
identify the details.
• Off- do not use WDR.
• 1~5
Default: Off.
Procedure
1. Do one of the following:
• On your web user interface, go to Setting > Camera > Exposure.
• On your MeetingBar A20, go to More > Settings > Device Settings > Camera Settings >
Exposure Settings.
2. Select Brightness Priority from the Exposure Mode drop-down menu.
| Configuring Camera Settings | 82
Wide Dynamic Off or Specify the WDR. The value represents Web user interface
Range the compression degree of the dynamic range
Endpoint
Cameras with WDR technology can work
perfectly both in the bright and the dark
conditions and present clear images that
balances different lighting, so that you can
identify the details.
• Off- do not use WDR.
• 1~5
Default: Off.
Procedure
1. Do one of the following:
• On your web user interface, go to Setting > Camera > Graphics.
• On your MeetingBar A20, go to More > Settings > Device Settings > Camera Settings >
Graphics.
| Configuring Camera Settings | 83
Saturation Configure the image saturation of the camera. Web user interface
The saturation means the maximum intensity of color Endpoint
in the image.
Note: the value is from 0 to 100. The default value is
50.
Sharpness Configure the image sharpness of the camera. Web user interface
The sharpness is an indicator that reflects the Endpoint
definition of the image plane and the sharpness of
image edge. Increasing the sharpness will improve
the definition of the image. However, if the sharpness
is set too high, the image will look distorted and
glaring.
Note: the value is from 0 to 100. The default value is
15.
Brightness Configure the image brightness of the camera. Web user interface
Note: the value is from 0 to 100. The default value is Endpoint
50.
Contrast Configure the image contrast of the camera. Web user interface
Valid value: 0 - 100. The default value is 50. Endpoint
Noise Reduction Specify the noise reduction (2D) mode. Web user interface
(2D)
The available modes are described below: Endpoint
• Off
• Low
• Middle
• High
Default: Middle.
Procedure
1. Do one of the following:
• On your web user interface, go to Setting > Camera > Other Settings.
• On your MeetingBar A20, go to More > Settings > Device Settings > Camera Settings > Others.
2. Configure and save the following settings:
Camera Pan Direction Configure the pan direction of the camera. Web user interface
• Normal Endpoint
• Reversed
If the camera reversed mode is enabled, the
camera pan direction will be reversed when
pressing the left and right navigation keys on
the remote control. In this case, you can set the
camera pan direction to Reversed.
Default: Normal.
Reset Camera
You can reset the camera to factory defaults.
Procedure
1. Do one of the following:
• On your web user interface, go to Setting > Camera > Other Settings.
• On your MeetingBar A20, go to More > Settings > Device Settings > Camera Settings > Others.
2. Select Reset Camera.
The system prompts whether or not you are sure to reset.
3. Confirm the action.
EQ Self Adaption
The EQ self adaption allows the device to optimize the acoustic effect. The EQ self adaption is enabled by
default. System supports manual EQ self adaption adjustment.
• EQ Self Adaption Configuration
Default 1
Web UI Setting > Audio > EQ Self Adaption > EQ Self Adaption
Noise Suppression
The noises in the room may be picked-up, including paper rustling, coffee mugs, coughing, typing and
silverware striking plates. These noises, when transmitted to remote participants, can be very distracting.
You can enable the Transient Noise Suppressor (TNS) to suppress these noises. You can also enable the
Noise Barrier feature to block these noises when there is no speech in a call.
• Noise Suppression Configuration
Default 1
Web UI Setting > Audio > Noise Suppression > Temporal Noise Shaping(TNS)
Parameter voice.ans_nb.enable <y0000000000xx>.cfg
Description It enables or disabled the noise barrier feature.
Permitted 0-Off
Values
1-On, it can block the noise when there is no speech in a call.
Default 0
Web UI Setting > Audio > Noise Suppression > Noise Barrier
| Troubleshooting Methods | 86
Troubleshooting Methods
Yealink devices provide feedback in a variety of forms such as log files, packets, status indicators and so
on, which can help you more easily find the system problem and fix it.
• Exporting All the Diagnostic Files
• Log Files
• Packets Capture
• Analyzing Configuration Files
• Device Status
• Resetting Device and Configuration
• Device Reboot
• Capturing the Current Screen of the Device
Procedure
1. From the web user interface, go to Setting > Configuration.
2. Click Start in the Export All Diagnostic Files field to begin capturing signal traffic.
The system log level will be automatically set to 6.
3. Reproduce the issue.
4. Click Stop in the Export All Diagnostic Files field to stop the capture.
5. Click Export to open the file download window, and then save the diagnostic file to your local system.
A diagnostic file named DiagnoseInfo.tar is successfully exported to your local system.
Note: After exporting the diagnostic files, you can create a ticket and describe your problem at
ticket.yealink.com. After that Yealink support team will help you locate the root cause.
Log Files
Yealink Teams devices can log events into two different log files: boot log and system log. You can choose
to generate the log files locally or sent to the syslog server in real time, and use these log files to generate
informational, analytic, and troubleshoot devices.
• Local Log
• Syslog Log
Local Log
You can enable the local log, specify the severity level, and choose to keep the log locally or upload the
local log files to the provisioning server. The local log files can be exported via the web user interface
simultaneously.
• Local Log Configuration
• Exporting the Log Files to a Local PC
• Viewing the Log Files
| Troubleshooting Methods | 87
Permitted 0-Overwrite
Values
1-Append (not applicable to TFTP Server)
Default 0
Parameter static.auto_provision.local_log.backup.append.limit_mode <y0000000000xx>.cfg
Description It configures the behavior when local log files on the provisioning server or a specific
server reach the maximum file size.
Permitted 0-Append Delete, the server will delete the old log, and the device will continue
Values uploading log.
1-Append Stop, the device will stop uploading log.
Default 0
Parameter static.auto_provision.local_log.backup.append.max_file_size
<y0000000000xx>.cfg
Description It configures the maximum size (in KB) of the local log files can be stored on the
provisioning server or a specific server.
Procedure
1. From the web user interface, go to Setting > Configuration > Local Log.
2. Turn on Enable Local Log
3. Select the desired value from the Local Log Level drop-down menu.
The default local log level is “6”.
4. Enter the limit size of the log files in the Max Log File Size field.
5. Click Confirm to accept the change.
6. Reproduce the issue.
7. Click Export to open the file download window and save the file to your local system.
• <4+warning>
• <5+notice>
• <6+info>
The following figure shows a portion of a boot log file:
Syslog Log
You can also configure the device to send syslog messages to a syslog server in real time.
You can specify syslog details such as IP address or host name, server type, facility, and the severity level
of events you want to log. You can also choose to prepend the device's MAC address to log messages.
• Syslog Logging Configuration
• Viewing the Syslog Messages on Your Syslog Server
| Troubleshooting Methods | 91
Default Blank
Web UI Setting > Configuration > Syslog > Syslog Server
Parameter static.syslog.server_port <y0000000000xx>.cfg
Description It configures the port of the syslog server.
Example:
static.syslog.port = 515
Permitted Values Integer from 1 to 65535
Default 514
Web UI Setting > Configuration > Syslog > Syslog Server > Port
Parameter static.syslog.transport_type <y0000000000xx>.cfg
Description It configures the transport protocol that the device uses when uploading log
messages to the syslog server.
Permitted Values 0-UDP
1-TCP
2-TLS
Default 0
Web UI Setting > Configuration > Syslog > Syslog Transport Type
Parameter static.syslog.level <y0000000000xx>.cfg
Description It configures the lowest level of syslog information that displays in the syslog.
| Troubleshooting Methods | 92
Default 16
Web UI Setting > Configuration > Syslog > Syslog Facility
Parameter static.syslog.prepend_mac_address.enable <y0000000000xx>.cfg
Description It enables or disables the device to prepend the MAC address to the log messages
exported to the syslog server.
Permitted Values 0-Disabled
1-Enabled
Default 0
Web UI Setting > Configuration > Syslog > Syslog Prepend MAC
Packets Capture
You can capture packet in two ways: capturing the packets via web user interface or using the Ethernet
software. You can analyze the captured packets for troubleshooting purposes.
• Capturing the Packets via Web User Interface
• Ethernet Software Capturing Configuration
Procedure
1. From the web user interface, go to Setting > Configuration.
2. Select Normal from the Pcap Type drop-down menu.
3. In the Pcap Feature field, click Start to start capturing signal traffic.
4. Reproduce the issue to get stack traces.
5. Click Stop in the Pcap Feature field to stop capturing.
6. Click Export to open the file download window, and then save the file to your local system.
Procedure
1. From the web user interface, go to Setting > Configuration.
2. Click Start in the Pcap Feature field to start capturing signal traffic.
3. Reproduce the issue to get stack traces.
4. Click Stop in the Pcap Feature field to stop capturing.
Procedure
1. From the web user interface, go to Setting > Configuration > Configuration.
2. In the Export Configuration block, click Export to open the file download window, and then save the
file to your local system.
Procedure
1. From the web user interface, go to Setting > Configuration > Configuration.
2. In the Import Configuration block, click the white box to select a BIN configuration file from your local
system.
| Troubleshooting Methods | 95
[1]
If you change this parameter, the device will reboot to make the change take effect.
Device Status
Available information on device status includes:
•
• Version information ( Firmware Version, Hardware Version, Partner APP Version, Company Portal
Version and Teams Version).
• Network status (IPv4 status or IPv6 status, and IP mode).
• Device Certificate
• Device status (MAC address and device type)
• Viewing the Device Status
Procedure
1. Open a web browser on your computer.
2. Enter the IP address in the browser’s address bar and then press the Enter key.
For example, “http://192.168.0.10” for IPv4 or “http://[2005:1:1:1:215:65ff:fe64:6e0a]” for IPv6.
3. Enter the user name (admin) and password (0000) in the login page.
4. Click Login to login.
The device status is displayed on the first page of the web user interface.
Procedure
1. From the web user interface, click Setting > Upgrade.
2. Click Reset to Factory in the Reset to Factory Setting field.
The web user interface prompts the message “Do you want to reset to factory?”.
3. Click OK to confirm the resetting.
The device will be reset to the factory successfully after startup.
Note: Reset of your device may take a few minutes. Do not power off until the device starts up
successfully.
Procedure
1. From the web user interface, click Setting > Configuration > Factory Configuration.
2. In the Import Factory Configuration field, click the white box to select the custom factory configuration
file from your local system.
3. Click Import.
After the custom factory configuration file is imported successfully, you can reset the device to custom
factory settings.
• Custom Factory Configuration
Procedure
1. From the web user interface, click Setting > Configuration > Factory Configuration.
2. Click Delete from the Delete Factory Configuration field.
The web user interface prompts the message “Are you sure delete user-defined factory configuration?”.
3. Click OK to delete the custom factory configuration files.
The imported custom factory file will be deleted. The device will be reset to default factory settings after
resetting.
Device Reboot
You can reboot the device locally.
• Rebooting the Device via Endpoint
• Rebooting the Device via Web User Interface
Procedure
1. Go to More > Settings > Device Settings > Other Settings > Reboot.
2. Select Reboot phone.
It prompts if you are sure to reboot the device.
3. Select OK.
Procedure
1. Click Setting > Upgrade.
2. Click Reboot to reboot the device.
The web user interface prompts the message “Reboot the system?"
3. Click OK to confirm the rebooting.
The device begins at rebooting. Any reboot of the device may take a few minutes.
Procedure
1. On your web user interface, go to Home > Screenshot.
2. Save the screenshot to your local system.
| Troubleshooting Solutions | 98
Troubleshooting Solutions
This section describes the solutions to common issues that may occur while using the Teams device. Upon
encountering a case not listed in this section, contact your Yealink reseller for further support.
• IP Address Issues
• Time and Date Issues
• Display Issues
• Firmware and Upgrading Issues
• System Log Issues
• Password Issues
IP Address Issues
• The device does not get an IP address
• IP Conflict
• Specific format in configuring IPv6 on Yealink devices
IP Conflict
Do one of the following:
• Reset another available IP address for the device.
• Check network configuration via the endpoint at the path More > Settings > Device Settings >
Network(default password: 0000) > IPv4 Type( or IPv6 Type). If the Static IP is selected, select
DHCP instead.
For example, if the provisioning server address is “2001:250:1801::1”, the access URL of the provisioning
server can be “tftp://[2001:250:1801::1]/”.
Display Issues
• The device LCD screen blank
• The device displays “Offline”
Fail to export the system log from a provisioning server (FTP/TFTP server)
Do one of the following:
• Ensure that the FTP/TFTP server is downloaded and installed on your local system.
• Ensure that you have configured the FTP/TFTP server address correctly via the web user interface on
your device.
• Reboot the device. The configurations require a reboot to take effect.
Password Issues
• Restore the administrator password