1. Manuals
  2. Brands
  3. Yealink Manuals
  4. IP Phone
  5. SIP-T2 Series
  6. Provisioning manual

Yealink SIP-T2 Series Provisioning Manual

Auto provisioning guide
Hide thumbs Also See for SIP-T2 Series:
Table of Contents

Advertisement

Quick Links

Download this manual See also: Administrator's Manual
Table of Contents
i

Advertisement

Table of Contents
loading

Related Manuals for Yealink SIP-T2 Series

Summary of Contents for Yealink SIP-T2 Series

  • Page 1 Table of Contents...
  • Page 3 Table of Contents Table of Contents ..............iii Summary of Changes.............. vii Changes for Release 72, Guide Version 72.30 ..............vii Changes for Release 72, Guide Version 72.2 ..............vii Changes for Release 72, Guide Version 72.1 ..............viii Changes for Release 71, Guide Version 71.165 .............. viii Changes for Release 71, Guide Version 71.140 ..............

  • Page 4: Table Of Contents

    Yealink IP Phones Auto provisioning Guide Configuring a TFTP Server ............29 Preparing a Root Directory ....................29 Configuring a TFTP Server ....................30 Obtaining the Address of Provisioning Server ...... 31 Zero Touch ........................... 31 Plug and Play (PnP) Server ....................33 DHCP Options ........................
  • Page 5 Table of Contents Preparing a Root Directory .................... 63 Configuring an FTP Server ..................... 64 Configuring an HTTP Server ....................66 Preparing a Root Directory .................... 66 Configuring an HTTP Server ..................66 Configuring a DHCP Server ....................69 Customizing a Ring Tone Using Cool Edit Pro ..............77 Customizing a Logo File Using PictureExDemo ..............
  • Page 6 Yealink IP Phones Auto provisioning Guide...
  • Page 7 Summary of Changes This section describes the changes to this guide for each release and guide version. This version is updated to remove SIP-T4X, SIP-T21P and SIP-T19P IP phones. The following sections are new for this version: Managing MAC-local CFG File on page ...
  • Page 8 Yealink IP Phones Auto provisioning Guide This version is updated to incorporate SIP-T46G, SIP-T42G and SIP-T41P IP phones. The following sections are new for this version: Time Zones on page  BLF LED Mode on page  Major updates have occurred to the following sections:...
  • Page 9 Summary of Changes The following sections are new for this version: Encrypting Configuration Files on page  Update Mode on page  SIP NOTIFY Message on page  Resolving and Updating Configurations on page  Description of Configuration Parameters in CFG Files on page ...

  • Page 11: Introduction

    This guide provides instructions on how to provision Yealink IP phones with the minimum settings required. Yealink IP phones support FTP , TFTP , HTTP , and HTTPS protocols for auto provisioning and are configured by default to use the TFTP protocol.
  • Page 12 Yealink IP Phones Auto provisioning Guide...

  • Page 13: Getting Started

    Getting Started This section provides instructions on how to get ready for auto provisioning. The auto provisioning process discussed in this guide uses the TFTP server as the provisioning server. To begin the auto provisioning process, the following steps are required: Obtaining Configuration Information ...
  • Page 14 Yealink IP Phones Auto provisioning Guide You can ask the distributor or Yealink FAE for configuration files. The IP phones running firmware version 71 or later can only recognize configuration files using UTF-8 or ANSI encoding. The local configuration file can also be exported via web user interface. For...
  • Page 15 Getting Started Common CFG file contains configuration parameters which apply to phones with the same model, such as language and volume. The following figure shows a portion of the common CFG file: The line beginning with “#” is considered to be a comment. The file header “#!version:1.0.0.1”...
  • Page 16 Yealink IP Phones Auto provisioning Guide ###################################################### PC Port ###################################################### network.bridge_mode = network.pc_port.ip = network.pc_port.mask = network.dhcp.start_ip = network.dhcp.end_ip = ###################################################### Network Advanced ###################################################### network.pc_port.enable = network.internet_port.speed_duplex = network.pc_port.speed_duplex = network.pc_port.dhcp_server = network.static_dns_enable = ###################################################### VLAN ###################################################### network.vlan.internet_port_enable = network.vlan.internet_port_vid = network.vlan.internet_port_priority =...
  • Page 17 Getting Started ###################################################### OpenVPN ###################################################### network.vpn_enable = openvpn.url = ###################################################### LLDP ###################################################### network.lldp.enable = network.lldp.packet_interval = MAC-Oriented CFG file contains configuration parameters which are expected to be updated per phone, such as the registration information. The following figure shows a portion of the MAC-Oriented CFG file: The partial parameters in the MAC-Oriented CFG file are described as follows: #################################################### MAC-Oriented CFG File...
  • Page 18 Yealink IP Phones Auto provisioning Guide ###################################################### Account1 Basic Settings ###################################################### account.1.enable = account.1.label = account.1.display_name = account.1.auth_name = account.1.user_name = account.1.password = account.1.outbound_proxy_enable = account.1.outbound_host = account.1.outbound_port = account.1.sip_listen_port = account.1.transport = ###################################################### Failback ###################################################### account.1.reregister_enable = account.1.naptr_build = account.1.fallback.redundancy_type =...
  • Page 19 Getting Started ###################################################### Account2 Basic Settings ###################################################### account.2.enable = account.2.label = account.2.display_name = account.2.auth_name = account.2.user_name = account.2.password = account.2.outbound_proxy_enable = account.2.outbound_host = account.2.outbound_port = account.2.sip_listen_port = account.2.transport = ###################################################### Failback ###################################################### account.2.reregister_enable = account.2.naptr_build = account.2.fallback.redundancy_type = account.2.fallback.timeout = account.2.sip_server.1.address = account.2.sip_server.1.port = account.2.sip_server.1.expires =...
  • Page 20 Yealink IP Phones Auto provisioning Guide ###################################################### Account3 Basic Settings (except SIP-T20P Model) ###################################################### account.3.enable = account.3.label = account.3.display_name = account.3.auth_name = account.3.user_name = account.3.password = account.3.outbound_proxy_enable = account.3.outbound_host = account.3.outbound_port = account.3.sip_listen_port = account.3.transport = ###################################################### Failback ###################################################### account.3.reregister_enable = account.3.naptr_build =...
  • Page 21 Getting Started ###################################################### Account4 Basic Settings (except SIP-T20P Model) ###################################################### account.4.enable = account.4.label = account.4.display_name = account.4.auth_name = account.4.user_name = account.4.password = account.4.outbound_proxy_enable = account.4.outbound_host = account.4.outbound_port = account.4.sip_listen_port = account.4.transport = ###################################################### Failback ###################################################### account.4.reregister_enable = account.4.naptr_build = account.4.fallback.redundancy_type = account.4.fallback.timeout = account.4.sip_server.1.address = account.4.sip_server.1.port =...
  • Page 22 Yealink IP Phones Auto provisioning Guide ###################################################### Account5 Basic Settings (except SIP-T20P Model) ###################################################### account.5.enable = account.5.label = account.5.display_name = account.5.auth_name = account.5.user_name = account.5.password = account.5.outbound_proxy_enable = account.5.outbound_host = account.5.outbound_port = account.5.sip_listen_port = account.5.transport = ###################################################### Failback ###################################################### account.5.reregister_enable = account.5.naptr_build =...
  • Page 23 Getting Started ###################################################### Account6 Basic Settings (except SIP-T20P Model) ###################################################### account.6.enable = account.6.label = account.6.display_name = account.6.auth_name = account.6.user_name = account.6.password = account.6.outbound_proxy_enable = account.6.outbound_host = account.6.outbound_port = account.6.sip_listen_port = account.6.transport = ###################################################### Failback ###################################################### account.6.reregister_enable = account.6.naptr_build = account.6.fallback.redundancy_type = account.6.fallback.timeout = account.6.sip_server.1.address = account.6.sip_server.1.port =...
  • Page 24 Yealink IP Phones Auto provisioning Guide MAC-local CFG file is automatically filled with configurations modified via web user interface or phone user interface. The file is stored locally on the phone and can also be uploaded to the provisioning server.
  • Page 25 Getting Started forward.always.off_code = #Configure busy forward feature. forward.busy.enable = forward.busy.target = forward.busy.on_code = forward.busy.off_code = #Configure no answer forward feature. forward.no_answer.enable = forward.no_answer.target = forward.no_answer.timeout = forward.no_answer.on_code = forward.no_answer.off_code = #Configure DND feature. features.dnd.enable = features.dnd.on_code = features.dnd.off_code = #Configure always forward feature for account X.
  • Page 26 Yealink IP Phones Auto provisioning Guide #Configure the access URL of the firmware file. firmware.url = #Configure the access URL of configuration files. auto_provision.server.url= Note: The following configurations are defined to be bundled together. If a user modifies one of the configurations in a group via web user interface or phone user interface, the other configurations in the group can also be saved to the MAC-local.cfg file(if the...

  • Page 27: Editing Mac-Oriented Cfg File

    URL for the resource files. Yealink IP phones have built-in system ring tones. You can change the ring type, or customize a ring tone and upload it to the phone via auto provisioning.

  • Page 28: Customizing A Ring Tone

    Yealink IP Phones Auto provisioning Guide For more information on customizing a ring tone file, refer to Customizing a Ring Tone Using Cool Edit Pro on page 77. #################################################### Configure the access URL of the custom ring tone #################################################### ringtone.url = For example, enter “tftp://192.168.1.100/Ring1.wav”...
  • Page 29 To modify translation of an existing language, do not rename the language file. Yealink IP phones allow you to customize the logo displayed on the LCD screen. SIP-T20P IP phones only support a text logo. These two IP phone models use the wallpaper...
  • Page 30 Customizing a Logo File Using PictureExDemo on page 78. Ask the distributor or Yealink FAE for the logo file, or you can customize a *.dob logo file. Upload the logo file to the provisioning server and then specify the access URL in configuration files:...
  • Page 31 Getting Started Yealink IP phones allow you to upload contact data in batch via auto provisioning. You can create multiple contacts using the provided local contact template file. The existing local contacts on the phones will be overwritten by the downloaded local contacts.
  • Page 32 Yealink IP Phones Auto provisioning Guide office_number=”” specifies the office number of the contact. mobile_number=”” specifies the mobile number of the contact. other_number=”” specifies the other number of the contact. line=”” specifies the line for the contact. ring=”” specifies the ring tone for the contact.
  • Page 33 ID. The digit 0 stands for all lines. Multiple line IDs are separated by commas. At most 100 replace rules can be added to the IP phone.  For the basic expression syntax of the replace rule, refer to Yealink phone-specific  user guide. To customize a replace rule file: Open the template file using an ASCII editor.
  • Page 34 ID. The digit 0 stands for all lines. Multiple line IDs are separated by commas. At most 100 dial-now rules can be added to the IP phone.  For the basic expression syntax of the dial-now rule, refer to Yealink phone-specific  user guide.
  • Page 35 Getting Started The following shows an example of a dial-now file: <DialNow> <Data DialNowRule="1234" LineID="1"/> <Data DialNowRule="52[0-6]" LineID="1"/> <Data DialNowRule="xxxxxx" LineID=""/> </DialNow> #################################################### Upload dial-now file #################################################### dialplan_dialnow.url = For example, enter “tftp://192.168.1.100/DialNow.xml” in the “dialplan_dialnow.url =” field. During the auto provisioning process, the phone connects to the provisioning server “192.168.1.100”, and downloads the dial-now file “DialNow.xml”.
  • Page 36 Yealink IP Phones Auto provisioning Guide enable="1" /> Where: id_name="" specifies the directory list (id_name = “localdirectory” specifies the local directory list). Do not edit this field. display_name="" specifies the display name of the directory list. We recommend you do not edit this field.
  • Page 37 <item id_name="ldap_search" display_name="LDAP" priority="4" enable="0" /> </root_super_search> Yealink IP phones allow you to upgrade firmware manually via web user interface, or upgrade firmware in batch via auto provisioning. The following table lists the firmware name for each phone model (X is replaced by the...
  • Page 38 Yealink IP Phones Auto provisioning Guide Phone Model Firmware Name SIP-T20P 9.x.x.x.rom To upgrade the phones’ firmware in batch via auto provisioning, ask the distributor for the firmware file, upload it to the provisioning server, and then specify the access URL in configuration files.

  • Page 39: Configuring A Tftp Server

    Configuring a TFTP Server Yealink IP phones support using FTP , TFTP , HTTP and HTTPS protocols to download configuration files. You can use one of these protocols for provisioning. The TFTP protocol is used by default. The following section provides instructions on how to configure a TFTP server.
  • Page 40 Yealink IP Phones Auto provisioning Guide If you have a 3CDaemon application installed on your local system, use it directly. Otherwise, download and install it. To configure a TFTP server: Double click 3CDaemon.exe to start the application. A configuration page is shown as below: Select Configure TFTP Server.

  • Page 41: Obtaining The Address Of Provisioning Server

    Obtaining the Address of Provisioning Server Yealink IP phones support obtaining the provisioning server address in the following ways: Zero Touch  Plug and Play (PnP) Server  DHCP Options  Phone Flash  The priority of obtaining the provisioning server address is as follows: Zero Touch-->PnP Server-->DHCP Options (Custom option-->option 66-->option 43) -->Phone Flash.
  • Page 42 Yealink IP Phones Auto provisioning Guide Configure the wait time in the Wait Time (0~100s) field. Click Confirm to accept the change. When Zero Touch is enabled, there will be a configuration wizard during startup: Press the OK soft key.
  • Page 43 (optional) in the Auto Provision screen. An example of screenshot is shown as below: Yealink IP phones support obtaining the provisioning server address from the PnP server. The phone broadcasts the PnP SUBSCRIBE message to obtain the provisioning server address during startup.
  • Page 44 Yealink IP Phones Auto provisioning Guide can connect to the provisioning server and perform the auto provisioning process. Yealink IP phones support obtaining the provisioning server address from DHCP options. You can configure the phone to obtain the provisioning server address from a custom DHCP option, or the phone will automatically detect the Option 66 and Option 43.
  • Page 45 37. Click Confirm to accept the change. Yealink IP phones support obtaining the provisioning server address from the phone flash. To obtain the provisioning server address by reading the phone flash, make sure the configuration is set properly.

  • Page 46: Update Mode

    Yealink IP Phones Auto provisioning Guide Enter the URL, user name and password of the provisioning server in the Server URL, User Name and Password fields (the user name and password are optional). Configure the desired update mode. For more information, refer to Update Mode on page 37.

  • Page 47: Power On

    Update Mode The update mode is used to set the desired time for the phone to perform the auto provisioning process. This chapter introduces the following update modes in detail: Power On  Repeatedly  Weekly  Auto Provision Now ...
  • Page 48 Yealink IP Phones Auto provisioning Guide Mark the On radio box in the Power On field. Click Confirm to accept the change. The phone performs the auto provisioning process at regular intervals. You can configure the interval for the Repeatedly mode. The default interval is 1440 minutes.
  • Page 49 Update Mode Enter the interval time (in minutes) in the Interval (Minutes) field. Click Confirm to accept the change. The phone performs the auto provisioning process at the fixed time every week. You can configure what time of the day and which day of the week to trigger the phone to perform the auto provisioning process.
  • Page 50 Yealink IP Phones Auto provisioning Guide Mark one or more checkboxes in the Day of Week field. Click Confirm to accept the change. You can use Auto Provision Now mode to manually trigger the phone to perform the auto provisioning process immediately.
  • Page 51 Update Mode Click Autoprovision Now. The phone will perform the auto provisioning process immediately. You can activate more than one update mode for auto provisioning. For example, you can activate the “Power On” and “Repeatedly” modes simultaneously. The phone will perform the auto provisioning process when it is powered on and at a specified interval.
  • Page 52 Yealink IP Phones Auto provisioning Guide The following figure shows the message flow:...

  • Page 53: Downloading And Verifying Configurations

    If configuration files have been AES-encrypted, the phone will decrypt them after downloading the configuration files. For more information on how the phone decrypts Yealink Configuration Encryption Tool User Guide configuration files, refer to The phone only reboots when there is at least a specific configuration requiring a reboot during auto provisioning.
  • Page 54 Yealink IP Phones Auto provisioning Guide After auto provisioning, you can then verify the update via phone user interface, or you can verify it via web user interface of the phone. For more information, refer to Yealink phone-specific user guide.

  • Page 55: Verifying Configurations

    DSS keys), even after auto provisioning, so several specific scenarios are demonstrated as follows: Yealink IP phones support FTP , TFTP , HTTP and HTTPS protocols for uploading the MAC-local CFG file. This section takes the TFTP protocol as an example. Before performing the following, make sure the provisioning server supports upload.
  • Page 56 Yealink IP Phones Auto provisioning Guide a MAC-local CFG file to keep personalized configuration settings. SIP-T28P IP phone MAC: 001565221229  Provisioning server URL: tftp://192.168.1.211  Place the target firmware to the root directory of the provisioning server.  Create a new directory "ProvisioningDir_new" under the root directory of the ...
  • Page 57 Downloading and Verifying Configurations Create a blank configuration file “y000000000000.cfg” on the root directory of the provisioning server and add the following parameters to this file. #Configure the access URL of the firmware file. firmware.url = tftp://192.168.1.211/2.72.0.30.rom #Configure the access URL of configuration files. auto_provision.server.url = tftp://192.168.1.211/ProvisioningDir_new If your IP phone is running firmware version prior to 61, the phone can only recognize the old (M1) configuration file for auto provisioning, so the blank configuration file created...
  • Page 58 Yealink IP Phones Auto provisioning Guide Scenario Operations II: Add/Edit the following parameters in the y000000000000.cfg file or 001565221229.cfg file you want the phone to download: #Enable or disable the phone to protect personalized configuration settings even #after auto provisioning.
  • Page 59 Downloading and Verifying Configurations During auto provisioning, the phone requests to download the y000000000000.cfg file and then download firmware from the provisioning server. Then the phone requests the new URL “tftp://192.168.1.211/ProvisioningDir_new” to download configuration files. Then the phone will automatically generate a 001565221229-local.cfg file where the personalized configuration settings are written, and this file will not be uploaded to the provisioning server.
  • Page 60 Yealink IP Phones Auto provisioning Guide Do one of the following operations: Scenario Operations I: Add/Edit the following parameters in the y000000000000.cfg file or 001565221229.cfg file you want the phone to download: #Enable or disable the phone to protect personalized configuration settings even #after auto provisioning.
  • Page 61 Downloading and Verifying Configurations After auto provisioning, the phone starts up successfully and personalized configuration settings are protected. When a user customizes feature configurations via web/phone user interface, the phone will save the personalized configuration settings to the 001565221229-local.cfg file on the phone, and then synchronize the personalized configuration settings by uploading this file to the provisioning server.
  • Page 62 Yealink IP Phones Auto provisioning Guide #Configure the access URL of the firmware file. firmware.url = tftp://192.168.1.211/2.72.0.50.rom Reboot the phone to trigger auto provisioning process. For more information on how to trigger auto provisioning process, refer to Update Mode on Page 37.
  • Page 63 Downloading and Verifying Configurations Scenario Operations: To clear personalized configuration settings via phone user interface: Press Menu->Settings->Advanced Settings (password: admin). Select Reset Local Configuration. The LCD screen prompts “Delete Default Setting?”. Press the OK soft key. The LCD screen prompts “Delete default…Please Wait!”. Configuration settings in the 001565221229-local.cfg file on the phone will be cleared and the ones in the 001565221229-local.cfg file on the server (tftp://192.168.1.211) will also be cleared.
  • Page 64 Yealink IP Phones Auto provisioning Guide Configuration settings in the 001565221229-local.cfg file on the phone will be cleared and the ones in the 001565221229-local.cfg file on the server (tftp://192.168.1.211) will also be cleared. The Reset Local Configuration option is available only if auto_provision.custom.protect=1.
  • Page 65 Downloading and Verifying Configurations After startup, configuration settings in the 001565221229-local.cfg file on the phone will be cleared, all configurations will be reset to factory settings and the value of parameter “auto_provision.custom.sync” will be set to 0. Because the value of parameter “auto_provision.custom.sync”...
  • Page 66 Yealink IP Phones Auto provisioning Guide To import local configuration file via web user interface: Click on Settings->Configuration. In the Local Configuration field, click Browse to locate the 001565221229-local.cfg file from your local system. Click Import. The web user interface prompts “Upload local configuration success! Rebooting...
  • Page 67 Downloading and Verifying Configurations The existing local configuration file will be replaced by the imported one after importing. If the administrator or user modifies the configuration settings in the 001565221229-local.cfg file after exporting, the settings will be saved to the phone flash and take effect after importing the new 001565221229-local.cfg file.
  • Page 68 Yealink IP Phones Auto provisioning Guide...

  • Page 69: Troubleshooting

    Troubleshooting This chapter provides general troubleshooting information to help you solve problems you might encounter when deploying phones. If you require additional information or assistance with the deployment, contact your system administrator. Why does the phone fail to download configuration files? Ensure that auto provisioning feature is configured properly.
  • Page 70 Yealink IP Phones Auto provisioning Guide Why doesn’t the phone download the ring tone? Ensure that the file format of the ring tone is *.wav.  Ensure that the size of the ring tone file is no larger than that the phone supports.

  • Page 71: Glossary

    Glossary MAC Address: A Media Access Control address (MAC address) is a unique identifier assigned to network interfaces for communications on the physical network segment. MD5: The MD5 Message-Digest Algorithm is a widely used cryptographic hash function that produces a 128-bit (16-byte) hash value. DHCP: Dynamic Host Configuration Protocol (DHCP) is a network configuration protocol for hosts on Internet Protocol (IP) networks.
  • Page 72 Yealink IP Phones Auto provisioning Guide...

  • Page 73: Appendix

    Appendix This section provides instructions on how to configure an FTP server using 3CDaemon. You can download the 3CDaemon software online: http://www.oldversion.com/3Com-Daemon.html. To prepare a root directory: Create an FTP root directory on the local system. Place the configuration files to this root directory. Set the security permissions for the FTP directory folder.
  • Page 74 Yealink IP Phones Auto provisioning Guide If you have a 3CDaemon application installed on your local system, use it directly. Otherwise, download and install it. To configure an FTP server: Double click the 3CDaemon.exe to start the application. Click the FTP Server button on the left of the main page.
  • Page 75 Appendix dialogue box. Click the OK button to save. Mark the check boxes of Login, Download and Upload to make sure the FTP user has the login, download and upload permission. Click the Save Profile button to save the settings and finish the configurations. 10.
  • Page 76 Yealink IP Phones Auto provisioning Guide This section provides instructions on how to configure an HTTP server using HFS tool. You can download the HFS software online: http://www.snapfiles.com/get/hfs.html. To prepare a root directory: Create an HTTP root directory on the local system.
  • Page 77 Appendix The main configuration page is shown as below: Click Menu in the main page and select the IP address of the PC from IP address.
  • Page 78 Yealink IP Phones Auto provisioning Guide The default HTTP port is 8080. You can also reset the HTTP port (make sure there is no port conflict). Right click the icon on the left of the main page, select Add folder from disk to...
  • Page 79 Check the server URL (e.g., http:// 10.2.11.101:8088/ProvisioningDir) by clicking “Open in browser”. Yealink IP phones also support the Hypertext Transfer Protocol with SSL/TLS (HTTPS) protocol for auto provisioning. HTTPS protocol provides the encrypted communication and secure identification. For more information on installing and configuring an Apache HTTPS Server, refer t the network resource.
  • Page 80 Yealink IP Phones Auto provisioning Guide Click the Login button (the login password is blank) to log in. You can then edit the existing DHCP server, or you can right click localhost and select New Server to add a new DHCP server.
  • Page 81 Appendix Right click Scopes and select New Scope. Configure the DHCP server name, the DHCP IP range and the subnet mask. Click OK to accept the change. You can add a custom option via DHCP Turbo. Select Option Types, right click one of the options on the right of the main page, and then select New Option Type.
  • Page 82 Set the custom DHCP option (custom DHCP option tag number ranges from 128 to 254) and select the option type (Yealink supports String and IP Address option types only). Click the OK button to finish setting the option properties. Click save the change.
  • Page 83 Appendix 10. Scroll down and double click the custom option 128. 11. Fill the provisioning server address in the input field. 12. Click the OK button to finish setting a custom option. 13. Click to save the change.
  • Page 84 Yealink IP Phones Auto provisioning Guide You can add the option 66 via DHCP Turbo. The following shows the detailed processes. Click Named Policies-->Global, right click the blank area on the right of the main page and then select New Option.
  • Page 85 Appendix Fill the provisioning server address in the input field. Click the OK button to finish setting a custom option. Click to save the change. You can also add the option 43. The following shows the detailed processes. Click Named Policies-->Global, right click the blank area on the right of the main page and then select New Option.
  • Page 86 Yealink IP Phones Auto provisioning Guide Fill the provisioning server address in the input field. Click the OK button to finish setting a custom option. Click to save the change.
  • Page 87 Appendix If you have installed the Cool Edit application, double click to open it. Otherwise, you can download the installation package online: http://www.toggle.com/lv/group/view/kl36218/Cool_Edit_Pro.htm and install it. To customize a ring tone using Cool Edit Pro: Open the Cool Edit Pro application. Click File to open an audio file.
  • Page 88 Yealink IP Phones Auto provisioning Guide select the file format as A/mu-law wave. The original picture format must be *.bmp or *.gif. We recommend placing all files and the PictureExDemo application to the root directory of the PC. Double click the PictureExDemo.exe.
  • Page 89 Appendix The following shows auto provisioning flowchart for Yealink IP phones when a user wishes to protect personalized configuration settings.
  • Page 90 Yealink IP Phones Auto provisioning Guide The following shows a flowchart on how to generate a MAC-local CFG file when the administrator upgrades the firmware from the old version (prior to X.72.0.30) to latest version. Some configurations are never saved to the MAC-local.cfg file and some configurations are saved to the MAC-local.cfg file together.
  • Page 91 Appendix If you want to reset the configuration of a parameter, set the value of the parameter to !NULL! or %NULL%. For example, local_time.ntp_server1 = %NULL%. After the auto provisioning process is completed, the NTP server 1 will be reset to “cn.pool.ntp.org”. Permitted Parameter Descriptions...
  • Page 92 Yealink IP Phones Auto provisioning Guide Permitted Parameter Descriptions Web Setting Path Values It configures the IPv4 subnet mask when the IP address mode is Network->Basic-> configured as IPv4 or IPv4&IPv6, and network.intern Subnet IPv4 Config->Static the Internet (WAN) port type for IPv4 is et_port.mask...
  • Page 93 Appendix Permitted Parameter Descriptions Web Setting Path Values It configures the Internet (WAN) port type for IPv6 when the IP address mode is configured as IPv6 or network.ipv6_i IPv4&IPv6. Network->Basic-> nternet_port.ty 0 or 1 0-DHCP IPv6 Config pe = 1-Static IP Address The default value is 0.
  • Page 94 Yealink IP Phones Auto provisioning Guide Permitted Parameter Descriptions Web Setting Path Values It takes effect after a reboot. It configures the primary IPv6 DNS server when the IP address mode is Network->Basic-> configured as IPv6 or IPv4&IPv6, and network.ipv6_ IPv6 Config->Static...
  • Page 95 Appendix Permitted Parameter Descriptions Web Setting Path Values It enables or disables the phone to act as a DHCP server when the PC (LAN) Network->PC Port port is configured as Router. network.pc_p ->PC Port Config 0-Disabled ort.dhcp_serv 0 or 1 ->As Router er = 1-Enabled...
  • Page 96 Yealink IP Phones Auto provisioning Guide Permitted Parameter Descriptions Web Setting Path Values nable = 0-Disabled ->WAN Port-> Active 1-Enabled The default value is 0. It takes effect after a reboot. It configures VLAN ID of the Internet Network-> network.vlan.i (WAN) port.
  • Page 97 Appendix Permitted Parameter Descriptions Web Setting Path Values DHCP options and separate them by Option commas. The default value is 132. It takes effect after a reboot. It configures the client host name for DHCP option 12. For SIP-T28P IP phones: The default value is SIP-T28P .
  • Page 98 Yealink IP Phones Auto provisioning Guide Permitted Parameter Descriptions Web Setting Path Values It configures the maximum local RTP Network-> Integer from port. network.port. Advanced->Local 1024 to max_rtpport = The default value is 11800. RTP Port-> Max RTP 65535 Port (1024~65535) It takes effect after a reboot.
  • Page 99 Appendix Permitted Parameter Descriptions Web Setting Path Values The default value is blank. It takes effect after a reboot. It configures the access URL of the Network-> device certificate when the 802.1x network.802_1 URL within Advanced->802.1x mode is configured as EAP-TLS. x.client_cert_u ->Device rl =...
  • Page 100 Yealink IP Phones Auto provisioning Guide Permitted Parameter Descriptions Web Setting Path Values Network-> It configures the maximum duration (in Advanced-> seconds) for account register after sip.reg_surge_ Integer from Registration startup. prevention = 0 to 60 Random-> The default value is 0.
  • Page 101 Appendix Permitted Parameter Descriptions Web Setting Path Values name exporting log to the syslog server. Server Name It takes effect only if the parameter “syslog.mode” is configured as Server. The default value is blank. It takes effect after a reboot. It configures the detail level of syslog information to be exported.
  • Page 102 Yealink IP Phones Auto provisioning Guide Permitted Parameter Descriptions Web Setting Path Values It configures the way the phone uploads the MAC-local.cfg file to provisioning server when the parameter auto_provision “auto_provision.custom.sync” is set to .custom.uploa 0 or 1 1 (Enabled).
  • Page 103 Appendix Permitted Parameter Descriptions Web Setting Path Values 2-Tuesday 3-Wednesday 4-Thursday 5-Friday 6-Saturday Example: auto_provision.weekly.dayofweek = 01 means the phone will check the new configuration every Sunday and Monday. The default value is 0123456. Note: The old parameter “auto_provision.schedule.dayofweek” is also applicable to IP phones. It configures the begin time of the day for the phone to check new configuration weekly.
  • Page 104 Yealink IP Phones Auto provisioning Guide Permitted Parameter Descriptions Web Setting Path Values Note: The old parameter “auto_provision.schedule.periodic_min ute” is also applicable to IP phones. It enables or disables the phone to obtain the provisioning server address auto_provision Settings->Auto by detecting DHCP options.
  • Page 105 Appendix Permitted Parameter Descriptions Web Setting Path Values ~ Z, a ~ z. The default value is blank. It enables or disables the phone to decrypt configuration files using the encrypted AES keys. 0-Disabled 1-Enabled If it is set to 1, the phone will download <y0000000000xx_Security>.enc and auto_provision <MAC_Security>.enc files during auto...
  • Page 106 Yealink IP Phones Auto provisioning Guide Permitted Parameter Descriptions Web Setting Path Values from 1 to 50) The default value is blank. It takes effect after a reboot. It configures the password for autoprovision. authentication during auto String within X.password = provisioning.
  • Page 107 Appendix Permitted Parameter Descriptions Web Setting Path Values It enables or disables Watch Dog feature. If it is enabled, the phone will reboot automatically when the system Settings-> watch_dog.en is broken down. 0 or 1 Preference-> able = 0-Disabled Watch Dog 1-Enabled The default value is 1.
  • Page 108 Yealink IP Phones Auto provisioning Guide Permitted Parameter Descriptions Web Setting Path Values assword = The default value is blank. It enables or disables the transferee party’s phone to prompt a missed call on the LCD screen before displaying transfer.semi_ Features->Transfer...
  • Page 109 Appendix Permitted Parameter Descriptions Web Setting Path Values phones) 1-Enabled The default value is 1. It enables or disables the phone to transfer call to the two parties after a Features->Transfer transfer.tran_o local conference call hangs up. ->Transfer on thers_after_co 0 or 1 0-Disabled Conference Hang...
  • Page 110 Yealink IP Phones Auto provisioning Guide Permitted Parameter Descriptions Web Setting Path Values It configures the normal delay (in Settings->Voice-> voice.jib.norm Integer from milliseconds) of jitter buffer. JITTER BUFFER-> al = 0 to 400 Normal The default value is 120.
  • Page 111 Appendix Permitted Parameter Descriptions Web Setting Path Values Where element = [!]Freq1[+Freq2][+Freq3][+Freq4] /Duration Freq: the frequency of the tone (ranges from 200 to 7000 Hz). If it is set to 0Hz, it means silence. A tone is comprised of at most four different frequencies. Duration: the duration (in milliseconds) of the dial tone, ranges from 0 to 30000ms.
  • Page 112 Yealink IP Phones Auto provisioning Guide Permitted Parameter Descriptions Web Setting Path Values It customizes the tone for network congestion when the parameter "voice.tone.country" is set to Custom. voice.tone.con The value format is Freq/Duration. For Settings->Tones-> String gestion = more information on the value format,...
  • Page 113 Appendix Permitted Parameter Descriptions Web Setting Path Values “voice.tone.dial”. The default value is blank. It customizes the message tone when the parameter "voice.tone.country" is voice.tone.me set to Custom. ssage = The value format is Freq/Duration. For Settings->Tones-> (not String more information on the value format, Message applicable to refer to the parameter...
  • Page 114 Yealink IP Phones Auto provisioning Guide Permitted Parameter Descriptions Web Setting Path Values It takes effect after a reboot (only for SIP-T28P/T26P/T22P/T20P IP phones). It configures the dial tone volume of speaker. voice.handfre Integer from The default value is 8.
  • Page 115 Appendix Permitted Parameter Descriptions Web Setting Path Values It takes effect after a reboot. It configures the source certificates for the phone to authenticate for TLS connection. Security->Trusted 0-Default certificates security.ca_ce 0, 1 or 2 Certificates->CA 1-Custom certificates rt = Certificates 2-All certificates The default value is 2.
  • Page 116 Yealink IP Phones Auto provisioning Guide Permitted Parameter Descriptions Web Setting Path Values It configures the password of the user, var and administrator. The valid value format is username:new password. String within Example: security.user_ Security->Passwor security.user_password = password = characters...
  • Page 117 Appendix Permitted Parameter Descriptions Web Setting Path Values custom_softke y_call_in.url = It configures the access URL of the file URL within for custom soft keys layout on the LCD (not screen when Call in. applicable to characters SIP-T20P IP The default value is blank. phones) custom_softke y_connecting.
  • Page 118 Yealink IP Phones Auto provisioning Guide Permitted Parameter Descriptions Web Setting Path Values SIP-T28P and 2-Forward SIP-T26P IP 3-Transfer phones) 4-Hold 5-DND 7-Call Return 8-SMS 9-Directed Pickup 10-Call Park 11-DTMF 12-Voice Mail 13-Speed Dial 14-Intercom 15-Line 16-BLF 17-URL 18-Group Listening...
  • Page 119 Appendix Permitted Parameter Descriptions Web Setting Path Values 57-Hoteling 58-ACD Trace 59-Disp Code 60-Emergency 61-Directory The default value is 0. It configures the desired line to apply memorykey.X.l the key feature. ine = 1-Line 1 (X ranges 2-Line 2 from 1 to 10) DSSKey->Memory Integer from 3-Line 3...
  • Page 120 Yealink IP Phones Auto provisioning Guide Permitted Parameter Descriptions Web Setting Path Values (X ranges It only applies to the Local Group, XML from 1 to 10) Group and Network Group features. (only When the key feature is configured as...
  • Page 121 Appendix Permitted Parameter Descriptions Web Setting Path Values to 2. 8-SMS (not applicable to SIP-T20P IP phones) 9-Directed Pickup 10-Call Park 11-DTMF 12-Voice Mail 13-Speed Dial 14-Intercom 15-Line 16-BLF 18-Group Listening 20-Private Hold 22-XML Group (not applicable to SIP-T20P IP phones) 23-Group Pickup 24-Multicast Paging 25-Record...
  • Page 122 Yealink IP Phones Auto provisioning Guide Permitted Parameter Descriptions Web Setting Path Values 59-Disp Code 60-Emergency 61-Directory The default value is 15. It configures the desired line to apply the key feature. 1-Line 1 2-Line 2 linekey.X.line 3-Line 3 4-Line 4...
  • Page 123 Appendix Permitted Parameter Descriptions Web Setting Path Values ranges from 1 feature. to 6. It only applies to BLF and Meet-Me SIP-T26P/T22P: conference features. X ranges from The default value is blank. 1 to 3. SIP-T20P: X ranges from 1 to 2) It configures the desired local group/XML group/network group for...
  • Page 124 Yealink IP Phones Auto provisioning Guide Permitted Parameter Descriptions Web Setting Path Values 3-GroupCommon 4-EnterpriseCommon 5-Personal The default value is 0. linekey.X.label (SIP-T28P: X ranges from 1 to 6. It configures the label displayed on the String within DSSKey->Line LCD screen for each line key.
  • Page 125 Appendix Permitted Parameter Descriptions Web Setting Path Values phones) 40-Prefix (not applicable to SIP-T20P IP phones) 41-Zero Touch 43-Local Directory 44-Network Directory 45-Local Group 46-Network Group 47-XML Directory (not applicable to SIP-T20P IP phones) 50-Keypad Lock 55-Meet-Me Conference 61-Directory It configures the desired line to apply the programmable key feature.
  • Page 126 Yealink IP Phones Auto provisioning Guide Permitted Parameter Descriptions Web Setting Path Values It configures the desired local group/XML group/network group for the programmable key. It only applies to the Local Group, XML Group and Network Group features. XML Group and Network Group features are not applicable to SIP-T20P IP phones.
  • Page 127 Appendix Permitted Parameter Descriptions Web Setting Path Values (SIP-T28/T26P: 1-Network History X ranges from The default value is 0. 1 to 14; SIP-T22P: X=1-10, 12-14) (not applicable to SIP-T20P IP phones) programablek ey.X.label = (X ranges It configures the label displayed on the String within DSSKey->...
  • Page 128 Yealink IP Phones Auto provisioning Guide Permitted Parameter Descriptions Web Setting Path Values (only 8-SMS applicable to 9-Directed Pickup SIP-T28P and 10-Call Park SIP-T26P IP 11-DTMF phones) 12-Voice Mail 13-Speed Dial 14-Intercom 15-Line 16-BLF 17-URL 18-Group Listening 20-Private Hold 22-XML Group...
  • Page 129 Appendix Permitted Parameter Descriptions Web Setting Path Values 61-Directory The default value of the expansion keys 2-20, 22-40 is 0, and the default value of the expansion keys 1, 21 is 37. expansion_mo dule.X.key.Y.lin It configures the desired line to apply the expansion module key feature.
  • Page 130 Yealink IP Phones Auto provisioning Guide Permitted Parameter Descriptions Web Setting Path Values ckup_value = characters feature. (SIP-T28P: X It only applies to BLF and Meet-Me ranges from 1 conference features. to 6. The default value is blank. SIP-T26P: X ranges from 1 to 3.
  • Page 131 Appendix Permitted Parameter Descriptions Web Setting Path Values to 3. 4-Fourth local group Y ranges from 5-Fifth local group 1 to 40) When the key feature is configured as (only XML Group (remote phone book), applicable to valid values are: SIP-T28P and 0-First XML group SIP-T26P IP...
  • Page 132 Yealink IP Phones Auto provisioning Guide Permitted Parameter Descriptions Web Setting Path Values It enables or disables busy forward feature. Features->Forwar forward.busy. 0-Disabled 0 or 1 d &DND->Busy enable = Forward->On/Off 1-Enabled The default value is 0. It configures the target number the String within Features->Forwar...
  • Page 133 Appendix Permitted Parameter Descriptions Web Setting Path Values Features->Forwar It configures the no answer forward off forward.no_a String within d &DND->No code. nswer.off_cod Answer characters Forward->Off The default value is blank. Code It enables or disables the phone to forward incoming calls to international forward.intern Features->General numbers.
  • Page 134 Yealink IP Phones Auto provisioning Guide Permitted Parameter Descriptions Web Setting Path Values $display_local  $display_remote  $call_id  Example: action_url. setup_completed = http://192.168.0.20/help.xml?IP=$ip The default value is blank. It configures the action URL the phone sends after account is registered.
  • Page 135 Appendix Permitted Parameter Descriptions Web Setting Path Values The default value is blank. It configures the action URL the phone sends when on hook. URL within Example: action_url.on_ Features->Action hook = URL->On Hook action_url.on_hook = characters http://192.168.0.20/help.xml?IP=$ip The default value is blank. It configures the action URL the phone sends when receiving an incoming call.
  • Page 136 Yealink IP Phones Auto provisioning Guide Permitted Parameter Descriptions Web Setting Path Values action_url.dnd_on = http://192.168.0.20/help.xml?IP=$ip The default value is blank. It configures the action URL the phone sends when DND feature is disabled. URL within Example: action_url.dnd Features->Action _off = URL->Close DND...
  • Page 137 Appendix Permitted Parameter Descriptions Web Setting Path Values The default value is blank. It configures the action URL the phone sends when no answer forward feature is enabled. action_url.no_ URL within Features->Action Example: answer_fwd_o URL->Open No characters Answer Forward action_url.no_answer_fwd_on = http://192.168.0.20/help.xml?IP=$ip The default value is blank.
  • Page 138 Yealink IP Phones Auto provisioning Guide Permitted Parameter Descriptions Web Setting Path Values It configures the action URL the phone sends when placing a call on hold. URL within Example: action_url.hol Features->Action URL->Hold action_url.hold = characters http://192.168.0.20/help.xml?IP=$ip The default value is blank.
  • Page 139 Appendix Permitted Parameter Descriptions Web Setting Path Values The default value is blank. It configures the action URL the phone sends when changing the state of the phone from idle to busy. URL within action_url.idle Features->Action Example: _to_busy = URL->Idle To Busy characters action_url.idle_to_busy = http://192.168.0.20/help.xml?IP=$ip...

  • Page 140: Time Zones

    Yealink IP Phones Auto provisioning Guide Permitted Parameter Descriptions Web Setting Path Values It configures the action URL the phone sends when completing a call transfer. action_url.tran URL within Features->Action Example: sfer_finished URL->Transfer action_url.transfer_finished = characters Finished http://192.168.0.20/help.xml?IP=$ip The default value is blank.
  • Page 141 Appendix Permitted Parameter Descriptions Web Setting Path Values It configures the phone to obtain time from NTP server or manual settings. local_time.ma Settings->Time & 0-Manual nual_time_en 0 or 1 Date->Manual able = Time 1-NTP The default value is 1. It enables or disables the phone to use manually configured NTP server preferentially.
  • Page 142 Yealink IP Phones Auto provisioning Guide Permitted Parameter Descriptions Web Setting Path Values Month/ Day of Week/ Day of For DST By Week:  Week Last in Month/ Hour of Day Settings->Time & (for By Week) Date->DST Start The default value is 1/1/0.
  • Page 143 Appendix Permitted Parameter Descriptions Web Setting Path Values /T28P) 1-DD-MMM-YY 7, 8 or 9 2-YYYY-MM-DD (for SIP-T20P) 3-DD/MM/YYYY 4-MM/DD/YY 5-DD MMM YYYY 6-WWW DD MMM The default value is 0. For SIP-T20P IP phones: 7-MM DD YY 8-DD MM YY 9-YY MM DD The default value is 7.
  • Page 144 Yealink IP Phones Auto provisioning Guide Permitted Parameter Descriptions Web Setting Path Values startup. 0-Disabled 1-Enabled The default value is 1. It enables or disables the phone to provide input field of SIP server on the hot desking login wizard during hotdesking.st...
  • Page 145 Appendix Permitted Parameter Descriptions Web Setting Path Values 0-Disabled 1-Enabled The default value is 1. It enables or disables the phone to provide input field of SIP server on the hot desking login wizard when hotdesking.ds pressing the Hot Desking key. skey_sip_serv 0 or 1 0-Disabled...
  • Page 146 Yealink IP Phones Auto provisioning Guide Permitted Parameter Descriptions Web Setting Path Values Features->General It configures the interval (in seconds) auto_redial.int Integer from Information->Auto for the phone to wait before redial. erval = 1 to 300 Redial Interval The default value is 10.
  • Page 147 Appendix Permitted Parameter Descriptions Web Setting Path Values Multiple IP addresses are separated by commas. If it is set to any, the phone will receive action URI requests from any server. If it is left blank, the phone will not receive action URI requests.
  • Page 148 Yealink IP Phones Auto provisioning Guide Permitted Parameter Descriptions Web Setting Path Values 0 to 6 (for SIP-T28P) Out->Account (X ranges 0 to 3 (for SIP-T26P/T22P) from 1 to 10) 0 to 2 (for SIP-T20P) Multiple line IDs are separated by commas.
  • Page 149 Appendix Permitted Parameter Descriptions Web Setting Path Values (X ranges from 1 to 100) It configures lines applying the dial-now rule. 0 to 6 (for SIP-T28P) dialplan.repla Settings->Dial ce.line_id.X = 0 to 3 (for SIP-T26P/T22P) Integer Plan->Replace (X ranges 0 to 2 (for SIP-T20P) Rule->...
  • Page 150 Yealink IP Phones Auto provisioning Guide Permitted Parameter Descriptions Web Setting Path Values phones) features.remot It enables or disables the phone to e_phonebook. perform a remote phone book search Directory->Remote enable = for an incoming or outgoing call. Phone Book->...
  • Page 151 String within (not the LDAP phonebook. Directory->LDAP-> applicable to Example: Base characters SIP-T20P IP ldap.base = dc=yealink,dc=cn phones) The default value is blank. ldap.user = It configures the user name for String within (not Directory->LDAP-> accessing the LDAP server. applicable to...
  • Page 152 Yealink IP Phones Auto provisioning Guide Permitted Parameter Descriptions Web Setting Path Values phones) It configures the name attributes of each record to be returned by the ldap.name_at LDAP server. tr = String within Directory->LDAP-> Multiple attributes are separated by...
  • Page 153 Appendix Permitted Parameter Descriptions Web Setting Path Values It enables or disables the phone to sort ldap.ldap_sort the search results in alphabetical order Directory->LDAP-> or numerical order. (not 0 or 1 LDAP Sorting 0-Disabled applicable to Results SIP-T20P IP 1-Enabled phones) The default value is 0.
  • Page 154 Yealink IP Phones Auto provisioning Guide Permitted Parameter Descriptions Web Setting Path Values The default value is 0. It configures the DND mode. Features-> 0-Phone features.dnd_ 0 or 1 Forward&DND-> mode = 1-Custom DND->Mode The default value is 0. It enables or disables DND feature.
  • Page 155 Appendix Permitted Parameter Descriptions Web Setting Path Values It enables or disables call waiting feature. Features->General call_waiting.e 0-Disabled 0 or 1 Information->Call nable = Waiting 1-Enabled The default value is 1. It enables or disables the phone to play the call waiting tone. Features->Audio- call_waiting.to 0-Disabled...
  • Page 156 Yealink IP Phones Auto provisioning Guide Permitted Parameter Descriptions Web Setting Path Values om.barge = barge in an intercom call. Barge 0-Disabled 1-Enabled The default value is 0. String within Features->General It configures the hotline number. features.hotlin Information-> e_number = The default value is blank.
  • Page 157 Appendix Permitted Parameter Descriptions Web Setting Path Values It configures DTMF sequences for String within Features->General transfer key function to be sent. It features.dtmf.t Information->Tran consists of 0-9, A-D, * and #. ransfer = characters Send DTMF The default value is blank. It enables or disables headset prior feature.
  • Page 158 Yealink IP Phones Auto provisioning Guide Permitted Parameter Descriptions Web Setting Path Values The default value is 1. Note: The old parameter “features.pound_key.mode” is also applicable to IP phones. It enables or disables the phone to play key tone when pressing the send key.
  • Page 159 Appendix Permitted Parameter Descriptions Web Setting Path Values It enables or disables the phone with active accounts to play tones in the dialing screen differently from the features.partiti phone with no active accounts. 0 or 1 on_tone = 0-Disabled 1-Enbaled The default value is 0.
  • Page 160 Yealink IP Phones Auto provisioning Guide Permitted Parameter Descriptions Web Setting Path Values Note: The old parameter “features.power_led_on” is also applicable to IP phones. It enables or disables the power indicator LED to flash when the phone receives an incoming call.
  • Page 161 Appendix Permitted Parameter Descriptions Web Setting Path Values If it is set to 0, the status of the power indicator LED is determined by the value of the parameter “phone_setting.common_power_led_e nable”. It enables or disables the power indicator LED to flash when a call is placed on hold or is held.
  • Page 162 Yealink IP Phones Auto provisioning Guide Permitted Parameter Descriptions Web Setting Path Values 1-Enabled The default value is 1. It enables or disables the phone to mute an active call. Features->General features.allow 0-Disabled 0 or 1 Information->Allo _mute = w Mute 1-Enabled The default value is 1.
  • Page 163 Appendix Permitted Parameter Descriptions Web Setting Path Values p_enable = phone is in the pre-dialing screen. Call Pickup (not 0-Disabled applicable to 1-Enabled SIP-T20P IP The default value is 0. phones) It configures the group call pickup features.picku String within Features->Call code.
  • Page 164 Yealink IP Phones Auto provisioning Guide Permitted Parameter Descriptions Web Setting Path Values The default value is 0. Note: The old parameter “features.blf_and_callpark_idle_led_e nable” is also applicable to IP phones. It enables or disables the phone to deal with the Version header in the BLF NOTIFY message sent by the server.
  • Page 165 Appendix Permitted Parameter Descriptions Web Setting Path Values priority. The default value is 10. It configures the listening multicast IP address and port number for the multicast.listen phone. _address.X.ip_ Directory-> IP address: address = Example: Multicast IP-> port Listening Address (X ranges multicast.listen_address.1.ip_address from 1 to 10)
  • Page 166 Yealink IP Phones Auto provisioning Guide Permitted Parameter Descriptions Web Setting Path Values It configures the interval (in seconds) phone_setting to automatically lock the keypad. Features->Phone .phone_lock.lo Integer from Lock->Phone Lock The default value is 0 (the keypad is ck_time_out =...
  • Page 167 The default value is 0. phone_setting .lcd_logo.text String within Features->General It configures a text logo. Information->Text (only The default value is Yealink. characters Logo applicable to SIP-T20P IP phones) lcd_logo.url = It configures the access URL of logo URL within Features->General...
  • Page 168 Yealink IP Phones Auto provisioning Guide Permitted Parameter Descriptions Web Setting Path Values 600-600s 1800-1800s The default value is 30. Ring1.wav Ring2.wav It configures the ring tone when the phone_setting phone fails to transfer a call. .ring_for_tranf Ring3.wav ailed = The default value is Ring1.wav.
  • Page 169 Appendix Permitted Parameter Descriptions Web Setting Path Values the value sent from the server when receiving the 403 message. The default value is blank. It takes effect after a reboot. It enables or disables recent call in super_search. dialing feature. If it is enabled, you can recent_call = see the placed calls list when the Directory->...
  • Page 170 Yealink IP Phones Auto provisioning Guide Permitted Parameter Descriptions Web Setting Path Values It deletes all custom language files. URL within gui_lang.delet The valid value is: http://localhost/all characters The default value is blank. Security->Trusted It configures the access URL of the...
  • Page 171 Appendix Permitted Parameter Descriptions Web Setting Path Values characters The default value is blank. Export or Import Configuration It takes effect after a reboot. It configures the access URL of the URL within custom_mac_ custom MAC-Oriented CFG file. cfg.url = characters The default value is blank.
  • Page 172 Yealink IP Phones Auto provisioning Guide Permitted Parameter Descriptions Web Setting Path Values to 2) account.X.dis play_name = (SIP-T28P: X ranges from 1 to 6. It configures the display name for String within Account->Register account X. SIP-T26P/T22P: ->Display Name characters X ranges from The default value is blank.
  • Page 173 Appendix Permitted Parameter Descriptions Web Setting Path Values ranges from 1 to 6. SIP-T26P/T22P: X ranges from 1 to 3. SIP-T20P: X ranges from 1 to 2) account.X.tran sport = It configures the transport type for (SIP-T28P: X account X. ranges from 1 to 6.
  • Page 174 Yealink IP Phones Auto provisioning Guide Permitted Parameter Descriptions Web Setting Path Values 1 to 3. SIP-T20P: X ranges from 1 to 2) account.X.fall back.redunda ncy_type = (SIP-T28P: X It configures the registration mode ranges from 1 account X to 6.
  • Page 175 Appendix Permitted Parameter Descriptions Web Setting Path Values ranges from 1 to 2. Y ranges from 1 to 2) account.X.sip_ server.Y.port = (SIP-T28P: X ranges from 1 It configures the port of SIP server Y for to 6. account X. SIP-T26P/T22P: Account->Register Integer from...
  • Page 176 Yealink IP Phones Auto provisioning Guide Permitted Parameter Descriptions Web Setting Path Values X ranges from 1 to 3. SIP-T20P: X ranges from 1 to 2. Y ranges from 1 to 2) It configures the mode for the phone to retry the primary server in failover account.X.sip_...
  • Page 177 Appendix Permitted Parameter Descriptions Web Setting Path Values account.X.sip_ server.Y.regist er_on_enable It enables or disables the phone to (SIP-T28P: X send registration requests to the ranges from 1 secondary server for account X when to 6. encountering a failover. SIP-T26P/T22P: 0 or 1 0-Disabled X ranges from...
  • Page 178 Yealink IP Phones Auto provisioning Guide Permitted Parameter Descriptions Web Setting Path Values account.X.dns _cache_a.Y.na me = (SIP-T28P: X ranges from 1 to 6. It configures the domain name in A record Y for account X. SIP-T26P/T22P: Domain X ranges from name The default value is blank.
  • Page 179 Appendix Permitted Parameter Descriptions Web Setting Path Values to 2. Y ranges from 1 to 12) account.X.dns _cache_srv.Y.n ame = (SIP-T28P: X ranges from 1 to 6. It configures the domain name in SRV SIP-T26P/T22P: Domain record Y for account X. X ranges from name It takes effect after a reboot.
  • Page 180 Yealink IP Phones Auto provisioning Guide Permitted Parameter Descriptions Web Setting Path Values X ranges from 1 to 3. SIP-T20P: X ranges from 1 to 2. Y ranges from 1 to 12) account.X.dns _cache_srv.Y.t arget = (SIP-T28P: X ranges from 1 It configures the domain name of the to 6.
  • Page 181 Appendix Permitted Parameter Descriptions Web Setting Path Values (SIP-T28P: X account X. ranges from 1 The default value is 300. to 6. It takes effect after a reboot. SIP-T26P/T22P: X ranges from 1 to 3. SIP-T20P: X ranges from 1 to 2.
  • Page 182 Yealink IP Phones Auto provisioning Guide Permitted Parameter Descriptions Web Setting Path Values account.X.dns _cache_naptr. Y.order = (SIP-T28P: X ranges from 1 It configures the order of NAPTR record to 6. Y for account X. NAPTR record with SIP-T26P/T22P: Integer from lower order is more preferred.
  • Page 183 Appendix Permitted Parameter Descriptions Web Setting Path Values ranges from 1 to 2. Y ranges from 1 to 12) account.X.dns _cache_naptr. Y.service = (SIP-T28P: X ranges from 1 It configures the transport protocol to 6. available for SIP server in NAPTR String within SIP-T26P/T22P: record Y for account X.
  • Page 184 Yealink IP Phones Auto provisioning Guide Permitted Parameter Descriptions Web Setting Path Values SIP-T26P/T22P: It takes effect after a reboot. X ranges from 1 to 3. SIP-T20P: X ranges from 1 to 2) account.X.out bound_proxy_ enable = It enables or disables the phone to use...
  • Page 185 Appendix Permitted Parameter Descriptions Web Setting Path Values ranges from 1 to 2) voice_mail.nu mber.X = (SIP-T28P: X ranges from 1 to 6. It configures the voice mail number for String within Account-> account X. Advanced->Voice SIP-T26P/T22P: characters Mail X ranges from The default value is blank.
  • Page 186 Yealink IP Phones Auto provisioning Guide Permitted Parameter Descriptions Web Setting Path Values ranges from 1 1-Enabled to 6. The default value is 0. SIP-T26P/T22P: X ranges from 1 to 3. SIP-T20P: X ranges from 1 to 2) account.X.sen d_anonymous...
  • Page 187 Appendix Permitted Parameter Descriptions Web Setting Path Values SIP-T26P/T22P: X ranges from 1 to 3. SIP-T20P: X ranges from 1 to 2) account.X.reje ct_anonymous _call = (SIP-T28P: X It enables or disables anonymous call ranges from 1 rejection feature for account X. Account->Basic->...
  • Page 188 Yealink IP Phones Auto provisioning Guide Permitted Parameter Descriptions Web Setting Path Values 1 to 3. SIP-T20P: X ranges from 1 to 2) account.X.dnd .enable = (SIP-T28P: X It enables or disables DND feature for ranges from 1 account X when the DND mode is to 6.
  • Page 189 Appendix Permitted Parameter Descriptions Web Setting Path Values account.X.alw ays_fwd.enab le = It enables or disables always forward (SIP-T28P: X feature for account X when the call ranges from 1 forward mode is configured as Features->Forwar to 6. Custom. 0 or 1 d&...
  • Page 190 Yealink IP Phones Auto provisioning Guide Permitted Parameter Descriptions Web Setting Path Values characters when busy for account X when the call Forward->Target forward mode is configured as (SIP-T28P: X Custom. ranges from 1 to 6. The default value is blank.
  • Page 191 Appendix Permitted Parameter Descriptions Web Setting Path Values ranges from 1 Incoming calls are forwarded when (0~120s) to 6. not answered after N*6 seconds. SIP-T26P/T22P: The default value is 2. X ranges from 1 to 3. SIP-T20P: X ranges from 1 to 2) account.X.alw ays_fwd.off_c...
  • Page 192 Yealink IP Phones Auto provisioning Guide Permitted Parameter Descriptions Web Setting Path Values SIP-T26P/T22P: X ranges from 1 to 3. SIP-T20P: X ranges from 1 to 2) account.X.bus y_fwd.on_cod (SIP-T28P: X ranges from 1 It configures the busy forward on code Features->Forwar...
  • Page 193 Appendix Permitted Parameter Descriptions Web Setting Path Values 1 to 3. SIP-T20P: X ranges from 1 to 2) account.X.sip_ listen_port = (SIP-T28P: X ranges from 1 to 6. It configures the local SIP port for Integer from Account-> account X. 1024 to Advanced->Local SIP-T26P/T22P:...
  • Page 194 Yealink IP Phones Auto provisioning Guide Permitted Parameter Descriptions Web Setting Path Values scribe_mwi_e 0 to 84600 of MWI subscription for account X. Advanced->MWI xpires = Subscription Period The default value is 3600. (Seconds) (SIP-T28P: X ranges from 1 to 6.
  • Page 195 Appendix Permitted Parameter Descriptions Web Setting Path Values to 6. SIP-T26P/T22P: 0-Disabled X ranges from 1-Enabled 1 to 3. The default value is 1. SIP-T20P: X ranges from 1 to 2) account.X.cp_ source = (SIP-T28P: X It configures the source callee identity ranges from 1 for presentation for account X.
  • Page 196 Yealink IP Phones Auto provisioning Guide Permitted Parameter Descriptions Web Setting Path Values 1 to 3. SIP-T20P: X ranges from 1 to 2) account.X.ses sion_timer.refr esher = (SIP-T28P: X It configures the refresher of the ranges from 1 session timer for account X.
  • Page 197 Appendix Permitted Parameter Descriptions Web Setting Path Values to 2) account.X.pti me = (SIP-T28P: X ranges from 1 to 6. It configures the RTP packet time for 0 (Disabled), Account-> account X. 10, 20, 30, Advanced->PTime SIP-T26P/T22P: 40, 50 or 60 (ms) X ranges from The default value is 20.
  • Page 198 Yealink IP Phones Auto provisioning Guide Permitted Parameter Descriptions Web Setting Path Values ranges from 1 0-Disabled to 6. 1-Enabled SIP-T26P/T22P: The default value is 0. X ranges from 1 to 3. SIP-T20P: X ranges from 1 to 2) account.X.regi...
  • Page 199 Appendix Permitted Parameter Descriptions Web Setting Path Values X ranges from 1 to 3. SIP-T20P: X ranges from 1 to 2) account.X.dire ct_pickup_cod (SIP-T28P: X ranges from 1 Account-> It configures the directed pickup code String within to 6. Advanced-> for account X.
  • Page 200 Yealink IP Phones Auto provisioning Guide Permitted Parameter Descriptions Web Setting Path Values SIP-T26P/T22P: X ranges from 1 to 3. SIP-T20P: X ranges from 1 to 2) account.X.sub scribe_mwi_to _vm = It enables or disables the phone to (SIP-T28P: X...
  • Page 201 Appendix Permitted Parameter Descriptions Web Setting Path Values SIP-T20P: X ranges from 1 to 2) account.X.con f_uri = (SIP-T28P: X ranges from 1 to 6. It configures the network conference SIP URI Account-> URI for account X. within 511 Advanced-> SIP-T26P/T22P: characters Conference URI...
  • Page 202 Yealink IP Phones Auto provisioning Guide Permitted Parameter Descriptions Web Setting Path Values account.X.sip_ server_type = It configures the SIP server type for (SIP-T28P: X account X. ranges from 1 0-Default to 6. Account-> 2-BroadSoft 0, 2, 4 or 6 Advanced->SIP...
  • Page 203 Appendix Permitted Parameter Descriptions Web Setting Path Values ranges from 1 to 6. SIP-T26P/T22P: X ranges from 1 to 3. SIP-T20P: X ranges from 1 to 2) account.X.dtm It configures the DTMF info type when f.info_type = the DTMF type is configured as “SIP (SIP-T28P: X INFO”, “AUTO or SIP INFO”...
  • Page 204 Yealink IP Phones Auto provisioning Guide Permitted Parameter Descriptions Web Setting Path Values 1 to 3. SIP-T20P: X ranges from 1 to 2) account.X.nat. stun_port = (SIP-T28P: X ranges from 1 to 6. It configures the port of the STUN Integer from Account->Register...
  • Page 205 Appendix Permitted Parameter Descriptions Web Setting Path Values ranges from 1 to 2) account.X.nat. rport = (SIP-T28P: X It enables or disables NAT Rport ranges from 1 feature for account X. to 6. Account-> 0-Disabled 0 or 1 SIP-T26P/T22P: Advanced->RPort X ranges from 1-Enabled 1 to 3.
  • Page 206 Yealink IP Phones Auto provisioning Guide Permitted Parameter Descriptions Web Setting Path Values account.X.adv anced.timer_t (SIP-T28P: X ranges from 1 Account-> It configures the session timer T4 (in to 6. Float from Advanced->SIP seconds) for account X. 2.5~60s Session Timer T4 SIP-T26P/T22P: The default value is 5.
  • Page 207 Appendix Permitted Parameter Descriptions Web Setting Path Values X ranges from ring tone selected for the phone. 1 to 3. The default value is Common. SIP-T20P: X ranges from 1 to 2) It configures the codec for account X. When Y=1, the default value is PCMU; When Y=2, the default value is PCMA;...
  • Page 208 Yealink IP Phones Auto provisioning Guide Permitted Parameter Descriptions Web Setting Path Values When Y=6, the default value is 1; When Y=7, the default value is 0; When Y=8, the default value is 0; When Y=9, the default value is 0;...
  • Page 209 Appendix Permitted Parameter Descriptions Web Setting Path Values When Y=11, the default value is 105. account.X.unr egister_on_re boot = (SIP-T28: X It enables or disables the phone to ranges from 1 Account-> un-register account X before a reboot. to 6. Advanced->...
  • Page 210 Yealink IP Phones Auto provisioning Guide Permitted Parameter Descriptions Web Setting Path Values account.X.acd .enable = (SIP-T28: X It enables or disables ACD feature for ranges from 1 account X. to 6. 0-Disabled 0 or 1 SIP-T26P/T22P: X ranges from 1-Enabled 1 to 3.
  • Page 211 Appendix The following table lists configuration parameters that are integrated with BroadSoft platform. For more information on BroadSoft features, refer to Yealink_IP_Phones_Deployment_Guide_for_BroadSoft_UC-One_Environment Permitted Parameter Descriptions Web Setting Path Values It enables or disables BroadSoft features for IP phones. 0-Disabled bw.enable = 0 or 1 1-Enabled The default value is 0.
  • Page 212 Yealink IP Phones Auto provisioning Guide Permitted Parameter Descriptions Web Setting Path Values (X=1) Example: Password account.1.xsi.password = 123456 The default value is blank. bw_phoneboo It enables or disables the phone to k.group_enabl display the group directory. Directory-> 0-Disabled 0 or 1...
  • Page 213 Appendix Permitted Parameter Descriptions Web Setting Path Values phones) bw_phoneboo k.group_com mon_displayn It configures the display name on the Directory-> String within ame = LCD screen for the group common Network directory. Directory->Group (not characters Common applicable to The default value is GroupCommon. SIP-T20P IP phones) bw_phoneboo...
  • Page 214 Yealink IP Phones Auto provisioning Guide Permitted Parameter Descriptions Web Setting Path Values phones) bw_phoneboo It enables or disables custom directory k.custom = Directory-> feature. Network (not 0-Disabled 0 or 1 Directory->Enable applicable to 1-Enabled Custom Directory SIP-T20P IP The default value is 0.
  • Page 215 Appendix Permitted Parameter Descriptions Web Setting Path Values SIP-T20P IP 1-Enabled phones) The default value is 0. It enables or disables the phone to call_park.park play a warning tone when a call is _ring= Features->Call parked against its line. Pickup->Audio (not 0 or 1 0-Disabled...
  • Page 216 Yealink IP Phones Auto provisioning Guide Permitted Parameter Descriptions Web Setting Path Values ode = characters (default: *33) for account X. List Barge In Code (SIP-T28: X The default value is blank. ranges from 1 to 6. SIP-T26P/T22P: X ranges from 1 to 3.
  • Page 217 Appendix Permitted Parameter Descriptions Web Setting Path Values ranges from 1 2-Unavailable to 6. The default value is 1. SIP-T26P/T22P: X ranges from 1 to 3. SIP-T20P: X ranges from 1 to 2) account.X.acd .unavailable_r eason_enable It enables or disables unavailable (SIP-T28: X reason code feature for account X.
  • Page 218 Yealink IP Phones Auto provisioning Guide Permitted Parameter Descriptions Web Setting Path Values ranges from 1 The value Y must be continuous. to 6. The default value is blank. SIP-T26P/T22P: X ranges from 1 to 3. SIP-T20P: X ranges from 1 to 2.
  • Page 219 Appendix Permitted Parameter Descriptions Web Setting Path Values (SIP-T28: X 1-Enabled ranges from 1 The default value is 0. to 6. SIP-T26P/T22P: X ranges from 1 to 3. SIP-T20P: X ranges from 1 to 2) account.X.bw_ disp_code.Y = (SIP-T28: X ranges from 1 It configures the disposition code to 6.
  • Page 220 Yealink IP Phones Auto provisioning Guide Permitted Parameter Descriptions Web Setting Path Values enable = 0-Disabled (SIP-T28: X 1-Enabled ranges from 1 The default value is 0. to 6. SIP-T26P/T22P: X ranges from 1 to 3. SIP-T20P: X ranges from 1 to 2) account.X.call...
  • Page 221 Appendix Permitted Parameter Descriptions Web Setting Path Values account.X.sup ervisor_info_c ode_name.Y (SIP-T28: X ranges from 1 It configures the supervisor name for to 6. String within account X. SIP-T26P/T22P: The value Y must be continuous. X ranges from characters The default value is blank. 1 to 3.
  • Page 222 Yealink IP Phones Auto provisioning Guide Permitted Parameter Descriptions Web Setting Path Values ranges from 1 “phone_setting.common_power_led_e to 2) nable”. The default value is 0. account.X.hot eling.enable It enables or disables hoteling feature (SIP-T28: X for account X. ranges from 1 0-Disabled to 6.
  • Page 223 Appendix Permitted Parameter Descriptions Web Setting Path Values to 2) account.X.hot eling.passwor (SIP-T28: X ranges from 1 It configures the password used to log String within to 6. into the guest profile for account X. SIP-T26P/T22P: characters The default value is blank. X ranges from 1 to 3.
  • Page 224 Yealink IP Phones Auto provisioning Guide The following parameters are not applicable to IP phones running firmware version 72 or later, so the description of these parameters has been deleted in this guide. account.X.bw_acd_reason_code.Y = account.X.dns_query_timeout= account.X.failback_mode = account.X.failback_timeout = account.X.retry_counts =...
  • Page 225 Appendix Time Zone Time Zone Name −11:00 Samoa −10:00 United States-Hawaii-Aleutian −10:00 United States-Alaska-Aleutian −09:00 United States-Alaska Time −08:00 Canada(Vancouver, Whitehorse) −08:00 Mexico(Tijuana, Mexicali) −08:00 United States-Pacific Time −07:00 Canada(Edmonton, Calgary) −07:00 Mexico(Mazatlan, Chihuahua) −07:00 United States-Mountain Time −07:00 United States-MST no DST −06:00 Canada-Manitoba(Winnipeg) −06:00...
  • Page 226 Yealink IP Phones Auto provisioning Guide Time Zone Time Zone Name United Kingdom(London) Morocco +01:00 Albania(Tirane) +01:00 Austria(Vienna) +01:00 Belgium(Brussels) +01:00 Caicos +01:00 Chad +01:00 Spain(Madrid) +01:00 Croatia(Zagreb) +01:00 Czech Republic(Prague) +01:00 Denmark(Kopenhagen) +01:00 France(Paris) +01:00 Germany(Berlin) +01:00 Hungary(Budapest) +01:00...
  • Page 227 Appendix Time Zone Time Zone Name +04:30 Afghanistan +05:00 Kazakhstan(Aqtobe) +05:00 Kyrgyzstan(Bishkek) +05:00 Pakistan(Islamabad) +05:00 Russia(Chelyabinsk) +05:30 India(Calcutta) +06:00 Kazakhstan(Astana, Almaty) +06:00 Russia(Novosibirsk, Omsk) +07:00 Russia(Krasnoyarsk) +07:00 Thailand(Bangkok) +08:00 China(Beijing) +08:00 Singapore(Singapore) +08:00 Australia(Perth) +09:00 Korea(Seoul) +09:00 Japan(Tokyo) +09:30 Australia(Adelaide) +09:30 Australia(Darwin) +10:00...
  • Page 228 Yealink IP Phones Auto provisioning Guide BLF LED Mode provides four kinds of definition for the BLF/BLF list key LED status. The following tables list the LED statuses of the BLF/BLF list key when BLF LED Mode is set to 0, 1, 2 or 3 respectively.
  • Page 229 Appendix The monitored user is idle. The monitored user does not exist. Memory key/Expansion Module key LED (configured as a BLF/BLF list key and BLF LED Mode is set to 1) LED Status Description Fast flashing red (200ms) The monitored user receives an incoming call. The monitored user is dialing.
  • Page 230 Yealink IP Phones Auto provisioning Guide Line key LED (configured as a BLF/BLF list key and BLF LED Mode is set to 3) LED Status Description Fast flashing green The monitored user receives an incoming call. (200ms) The monitored user is dialing.
  • Page 231 Appendix We are striving to improve our documentation quality and we appreciate your feedback. Email your opinions and comments to DocsFeedback@yealink.com.

Table of Contents