Yealink SIP-T2 Series Auto Provisioning Manual
Yealink SIP-T2 Series Auto Provisioning Manual

Yealink SIP-T2 Series Auto Provisioning Manual

Ip phone
Hide thumbs Also See for SIP-T2 Series:

Advertisement

Table of Contents
i

Advertisement

Table of Contents
loading

Summary of Contents for Yealink SIP-T2 Series

  • Page 1 Table of Contents...
  • Page 3: Table Of Contents

    Table of Contents Table of Contents ..............iii Summary of Changes............... v Changes for Release 71, Guide Version 71.126 ..............v Changes for Release 71, Guide Version 71.125 ..............v Changes for Release 71, Guide Version 71.120 ..............v Changes for Release 71, Guide Version 71.110 ..............v Changes for Release 70, Guide Version 1.3 ..............
  • Page 4 Yealink Auto provisioning User Guide Zero Touch ........................... 25 Plug and Play (PnP) Server ....................27 DHCP Options ........................28 Phone Flash ......................... 29 Update Mode ................. 31 Power On ..........................31 Repeatedly.......................... 32 Weekly ..........................33 Auto Provision Now ......................34 Multi-mode Mixed ......................
  • Page 5 Summary of Changes This section describes the changes to this guide for each release and guide version. Major updates have occurred to the following sections: Customizing a Local Contact File on page  Description of Configuration Parameters in CFG Files on page ...
  • Page 6 Yealink Auto provisioning User Guide Description of Configuration Parameters in CFG Files on page  Major updates have occurred to the following sections: Customizing a Local Contact File on page  Customizing a Replace Rule File on page  Customizing a Dial-now File on page ...
  • Page 7 Summary of Changes...
  • Page 9: 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 10 Yealink Auto provisioning User Guide...
  • Page 11: 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 12 Yealink Auto provisioning User Guide You can ask the distributor or Yealink FAE for configuration files. The IP phones running firmware version 71 can only recognize configuration files using UTF-8 or ANSI encoding. Before beginning provisioning, you also need the phone information. For example, MAC address and the SIP account information of the phone.
  • Page 13 Getting Started Common CFG file contains configuration parameters which apply to phones with the same model, such as language, time and date. The line beginning with “#” is considered to be a comment. The file header “#!version:1.0.0.1” is not a comment and must be placed in the first line. It cannot be edited or deleted.
  • Page 14 Yealink Auto provisioning User Guide #Require reboot network.pppoe.user = network.pppoe.password = #Enable or disable the PC port; 0-Disabled, 1-Auto-Negotiation (default); #Require reboot network.PC_port.enable = #Configure the PC port type; 0-Router, 1-Bridge (default) #Require reboot network.bridge_mode = #Configure the IP address and mask when the PC port is configured as Router.
  • Page 15 Getting Started #Configure the end time of the day for the phone to check new configuration files. The default time is 00:00. #It is only applicable to "Weekly" and "Power on + Weekly" modes. #If the desired end time of the day is seven forty-five p.m., the value format is 19:45. auto_provision.schedule.time_to = #Configure the day of week for the phone to check new configuration files.
  • Page 16 Yealink Auto provisioning User Guide #The available values are: English (default), Chinese_S (only applicable to the T21P IP phone), Chinese_T (only applicable to the T21P IP phone), German, French, Turkish, Italian, Polish, Spanish and Portuguese lang.gui = English #Enable or disable the IP phone to access its web user interface using the HTTP protocol;...
  • Page 17 Getting Started MAC-Oriented CFG file contains configuration parameters which are expected to be updated per phone, such as the registration information. The parameters commonly edited in the MAC-Oriented CFG file (Take T2xP IP phones as an example) are described as follows: #################################################### MAC-Oriented CFG File ####################################################...
  • Page 18 Yealink Auto provisioning User Guide #Configure the user name and password for register authentication account.1.auth_name = account.1.password = #Configure the register user name account.1.user_name = #Configure the SIP server address and port (5060 by default) account.1.sip_server.1.address = account.1.sip_server.1.port = account.1.sip_server.2.address = account.1.sip_server.2.port...
  • Page 19 Getting Started account.3.password = #Configure the register user name account.3.user_name = #Configure the SIP server address and port (5060 by default) account.3.sip_server.1.address = account.3.sip_server.1.port = account.3.sip_server.2.address = account.3.sip_server.2.port # Account4 settings (For the T28P IP phone only) #Enable or disable the account4, 0-Disabled (Default), 1-Enabled account.4.enable = #Configure the label displayed on the LCD screen for account4 account.4.label =...
  • Page 20 Yealink Auto provisioning User Guide account.5.user_name = #Configure the SIP server address and port (5060 by default) account.5.sip_server.1.address = account.5.sip_server.1.port = account.5.sip_server.2.address = account.5.sip_server.2.port # Account6 settings (For the T28P IP phone only) #Enable or disable the account6, 0-Disabled (Default), 1-Enabled account.6.enable =...
  • Page 21: Customizing A Ringtone

    Yealink FAE for resource file templates. The following provides information on how to customize resource files and specify the access URL for the resource files. Yealink IP phones have built-in system ringtones. You can change the ring type, or customize a ringtone and upload it to the phone via auto provisioning.
  • Page 22 “192.168.1.100”, and downloads the language file “lang+English.txt”. Available languages may vary between different firmware versions. Do not rename the language file. Yealink SIP-T2xP IP phones allow you to customize the logo displayed on the LCD screen. The SIP-T20P IP phone only supports a text logo.
  • Page 23 .dob <=132*64 2 gray scale 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 the configuration file:...
  • Page 24 Yealink Auto provisioning User Guide Yealink SIP-T3xG and VP530 IP phones allow you to customize the wallpaper displayed on the LCD screen. The following table lists the wallpaper image format and resolution for each phone model: Phone Model Wallpaper Image Format...
  • Page 25 During the auto provisioning process, the phone connects to the provisioning server “192.168.1.100”, and downloads the screensaver image “screensaver.jpg”. Yealink IP phones allow you to upload contact data in batch via auto provisioning. You can create multiple contacts using the supplied local contact template file.
  • Page 26 Yealink Auto provisioning User Guide Where: display_name=”” specifies the name of the contact (This value cannot be blank or duplicated). 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.
  • Page 27 ID. The digit 0 stands for all lines. Multiple line IDs are separated by comma. 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 28 ID. The digit 0 stands for all lines. Multiple line IDs are separated by comma. 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 29 During the auto provisioning process, the phone connects to the provisioning server “192.168.1.100”, and downloads the dial-now file “DialNow.xml”. Yealink IP Phones allow you to update firmware manually via web user interface, or update firmware in batch via auto provisioning.
  • Page 30 Yealink Auto provisioning User Guide To update 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 the configuration files. #################################################### Configure the access URL of the firmware file #################################################### firmware.url =...
  • Page 31: Configuring A Tftp Server

    Configuring a TFTP Server Yealink IP Phones support to use 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 32: Configuring A Tftp Server

    Yealink Auto provisioning User 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 33: Obtaining The Address Of Provisioning Server

    Obtaining the Address of Provisioning Server Yealink IP phones support to obtain 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 34 Yealink Auto provisioning User 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 (Take T28P IP phone as an example): Press the OK soft key.
  • Page 35 (optional) in the Auto Provision screen. An example of screenshot is shown as below: Yealink IP phones support to obtain the provisioning server address from the PnP server. The phone broadcasts the PnP SUBCRIBE message to obtain the provisioning server address during startup.
  • Page 36 Yealink Auto provisioning User Guide can connect to the provisioning server and perform the auto provisioning process. Yealink IP phones support to obtain 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 37 The default value is yealink. Click Confirm to accept the change. Yealink IP phones support to obtain 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 38 Yealink Auto provisioning User 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). Click Confirm to accept the change.
  • Page 39: Update Mode

    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 40 Yealink Auto provisioning User 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 41 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 42: Auto Provision Now

    Yealink Auto provisioning User Guide Mark one or more radio boxes 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 43 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 44 Yealink Auto provisioning User Guide The following figure shows the message flow:...
  • Page 45: Downloading And Verifying Configurations

    Downloading and Verifying Configurations Once obtaining a provisioning server address in one of the ways introduced above, the phone will connect to the provisioning server and download the configuration files. During the auto provisioning process, the phone will try to download the Common CFG file firstly, and then try to download the MAC-Oriented CFG file from the provisioning server.
  • Page 46 Yealink Auto provisioning User 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. During the auto provisioning process, you can monitor the downloading requests and response messages by a WinPcap tool.
  • Page 47: Verifying Configurations

    Downloading and Verifying Configurations Example 3: Yealink SIP-T28P IP phone downloads configuration files from the HTTP server.
  • Page 48 Yealink Auto provisioning User Guide...
  • Page 49: 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 enabled.
  • Page 50 Yealink Auto provisioning User Guide Ensure that the size of the ringtone file is no larger than that the phone supports.  Ensure that the properties of the ringtone for the phone are correct.  Ensure that the network is available and the root directory is right for downloading.
  • Page 51: 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 52 Yealink Auto provisioning User Guide...
  • Page 53: 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 54 Yealink Auto provisioning User 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 55 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 56 Yealink Auto provisioning User 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 57 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 58 Yealink Auto provisioning User 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 59 URL in the address bar of the web browser and then press <Enter> key to check the HTTP server before provisioning. 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.
  • Page 60 Yealink Auto provisioning User 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 61 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 62 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 63 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 64 Yealink Auto provisioning User 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 65 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 also can 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 66 Yealink Auto provisioning User 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 67 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 ringtone using Cool Edit Pro: Open the Cool Edit Pro application. Click File to open an audio file.
  • Page 68 Yealink Auto provisioning User 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 69 Appendix If you want to reset the configuration of a parameter, set the value of the parameter to be !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 70 Yealink Auto provisioning User Guide Permitted Parameter Descriptions Web Setting Path Values ay = configured as IPv4 or IPv4&IPv6, and IP Address-> the Internet (WAN) port type for IPv4 is Gateway configured as Static IP Address. The default value is blank.
  • Page 71 Appendix Permitted Parameter Descriptions Web Setting Path Values IPv4&IPv6. 0-DHCP 1-Static IP Address The default value is 0. It takes effect after reboot. It configures the IPv6 prefix when the IP address mode is configured as IPv6 or Network->Basic-> IPv4&IPv6, and the Internet (WAN) port network.ipv6_ Integer from IPv6 Config->Static...
  • Page 72 Yealink Auto provisioning User Guide Permitted Parameter Descriptions Web Setting Path Values configured as Static IP Address. The default value is blank. It takes effect after reboot. It defines the PC (LAN) port type. 0-Router network.bridg 1-Bridge Network->PC Port e_mode =...
  • Page 73 Appendix Permitted Parameter Descriptions Web Setting Path Values (not The default value is 10.0.0.10. ->As Router->Start applicable to IP Address T19P and T20P IP phones) network.dhcp. end_ip = Network->PC Port It configures the end IP address of the ->PC Port Config (not DHCP IP segment.
  • Page 74 Yealink Auto provisioning User Guide Permitted Parameter Descriptions Web Setting Path Values It takes effect after reboot. (1-4094) It configures VLAN priority of the Network-> network.vlan.i Internet (WAN) port. Integer from Advanced->VLAN nternet_port_p 0 to 7 The default value is 0.
  • Page 75 Appendix Permitted Parameter Descriptions Web Setting Path Values For T2xP IP phones: DHCP Hostname The default value is SIP-T2xP (X=0,2,6,8) For T19P IP phone: The default value is SIP-T19P . For T21P IP phone: The default value is SIP-T21P . It enables or disables the HTTP protocol for web server access.
  • Page 76 Yealink Auto provisioning User Guide Permitted Parameter Descriptions Web Setting Path Values It configures the voice QoS. Network-> network.qos.rt Integer from The default value is 46. Advanced->Voice ptos = 0 to 63 QoS (0~63) It takes effect after reboot. It configures the SIP QoS.
  • Page 77 Appendix Permitted Parameter Descriptions Web Setting Path Values T19P IP phone) It takes effect after reboot. It enables or disables LLDP feature. 0-Disabled Network-> network.lldp.e 0 or 1 1-Enabled Advanced->LLDP- nable = >Active The default value is 1. It takes effect after reboot. It configures the interval (in seconds) Network->...
  • Page 78 Yealink Auto provisioning User Guide Permitted Parameter Descriptions Web Setting Path Values It takes effect after reboot. It enables or disables the phone to span data packets received in the WAN port to the PC port. If it is Network->...
  • Page 79 Appendix Permitted Parameter Descriptions Web Setting Path Values 7-Power on + Weekly For T19P and T21P IP phones: It enables or disables the “Power On” mode for triggering the auto provisioning process. 0-Disabled 1-Enabled The default value is 1. It enables or disables Plug and Play feature.
  • Page 80 Yealink Auto provisioning User Guide Permitted Parameter Descriptions Web Setting Path Values T22P and T28P IP phones) It configures the days of week for the auto_provision phone to check the new configuration .schedule.day weekly. 0,1,2,3,4,5,6 ofweek = The default value is 0123456.
  • Page 81 Appendix Permitted Parameter Descriptions Web Setting Path Values applicable to T19P and T21P IP phones) auto_provision It enables or disables the .repeat.enabl “Repeatedly” mode for triggering the Settings->Auto auto provisioning process. 0 or 1 provision-> (only 0-Disabled Repeatedly applicable to 1-Enabled T19P and T21P The default value is 0.
  • Page 82 Yealink Auto provisioning User Guide Permitted Parameter Descriptions Web Setting Path Values The default value is yealink. For T19P and T21P IP phones: The default value is Yealink. auto_provision It configures the custom DHCP option Settings->Auto Integer from .dhcp_option.l for provisioning server address.
  • Page 83 Appendix Permitted Parameter Descriptions Web Setting Path Values (X ranges The default value is blank. from 1 to 50.) It takes effect after reboot. It configures the user name for autoprovision. authentication during auto X.user = provisioning. String (X ranges The default value is blank.
  • Page 84 Yealink Auto provisioning User Guide Permitted Parameter Descriptions Web Setting Path Values It enables or disables the phone to deal with the Version header in the BLF NOTIFY message sent by the server. features.blf_lis 0 or 1 0-Disabled t_version = 1-Enabled The default value is 0.
  • Page 85 Appendix Permitted Parameter Descriptions Web Setting Path Values 0-Disabled 1-Enabled The default value is 0. It enables or disables TR069 feature. 0-Disabled managements Settings->TR069-> 1-Enabled erver.enable 0 or 1 Enable TR069 The default value is 0. It takes effect after reboot. It configures the user name for the managements Settings->TR069->...
  • Page 86 Yealink Auto provisioning User Guide Permitted Parameter Descriptions Web Setting Path Values assword = It enables or disables the transferee party’s phone to prompt a missed call on the LCD screen before displaying transfer.semi_ Features->Transfer the caller ID. attend_tran_e 0 or 1 ->Semi-Attend...
  • Page 87 Appendix Permitted Parameter Descriptions Web Setting Path Values It enables or disables the phone to transfer call to the two parties after a Features->Transfer transfer.tran_o local conference call hangup. ->Transfer on thers_after_co 0 or 1 0-Disabled Conference Hang nf_enable = 1-Enabled The default value is 0.
  • Page 88 Yealink Auto provisioning User Guide Permitted Parameter Descriptions Web Setting Path Values It configures the maximum delay (in Settings->Voice-> voice.jib.max Integer from milliseconds) of jitter buffer. JITTER BUFFER-> 60 to 300 Max Delay The default value is 300. It configures the normal delay (in milliseconds) of jitter buffer.
  • Page 89 Appendix Permitted Parameter Descriptions Web Setting Path Values ETSI It customizes the dial tone when the "voice.tone.country" is configured as Custom. tonelist = element[,element] [,element]… Where element = !F1+F2+F3+F4/Duration F: the frequency of the tone (ranges from 200 to 7000 Hz). If set to 0Hz, it means silence.
  • Page 90 Yealink Auto provisioning User Guide Permitted Parameter Descriptions Web Setting Path Values Custom. The value format is F/D or !F/D. For more information on the value format, refer to the parameter “voice.tone.dial”. The default value is blank. It customizes the tone for network congestion when the "voice.tone.country"...
  • Page 91 Appendix Permitted Parameter Descriptions Web Setting Path Values The default value is blank. It customizes the stutter tone when the "voice.tone.country" is configured as Custom. voice.tone.stut The value format is F/D or !F/D. For Settings->Tones-> String ter = more information on the value format, Stutter refer to the parameter “voice.tone.dial”.
  • Page 92 Yealink Auto provisioning User Guide Permitted Parameter Descriptions Web Setting Path Values The default value is 8. It configures the receiving volume of voice.headset Integer from headset. .spk_vol = 0 to 15 The default value is 8. It configures the dial tone volume of voice.handfre...
  • Page 93 Appendix Permitted Parameter Descriptions Web Setting Path Values 1-Custom certificates 2-All certificates The default value is 0. It takes effect after reboot. It enables or disables the phone to mandatorily validate the CommonName or SubjectAltName of Security->Trusted the certificate received from the security.cn_val Certificates->Com connecting server.
  • Page 94 Yealink Auto provisioning User Guide Permitted Parameter Descriptions Web Setting Path Values It takes effect after reboot. custom_softke y_call_failed.u It configures the access URL of the file rl = Settings->Softkey for custom soft key layout on the LCD Layout (not screen when Call failed.
  • Page 95 Appendix Permitted Parameter Descriptions Web Setting Path Values (X ranges 0-Line 1 KeyX->Line from 1 to 10.) 1-Line 1 (not 2-Line 2 applicable to … T19P , T20P and 6-Line 6 T22P IP phones) memorykey.X. value = It configures the value of the memory (X ranges key feature.
  • Page 96 Yealink Auto provisioning User Guide Permitted Parameter Descriptions Web Setting Path Values 9-Directed Pickup 10-Call Park 11-DTMF 12-Voice Mail 13-Speed Dial 14-Intercom 15-Line(default for line key) 16-BLF 17-URL 18-Group Listening 22-XML Group 23-Group Pickup 24-Multicast Paging 25-Record 27-XML Browser 34-Hot Desking...
  • Page 97 Appendix Permitted Parameter Descriptions Web Setting Path Values from 1 to 6.) 1-Line 1 (not … applicable to 6-Line 6 T19P IP phone) linekey.X.valu It configures the value of the line key (X ranges DSSKey->Line feature. from 1 to 6.) String Key->Line KeyX->Value...
  • Page 98 Yealink Auto provisioning User Guide Permitted Parameter Descriptions Web Setting Path Values 16-BLF 17-URL 18-Group Listening 22-XML Group 23-Group Pickup 24-Paging 25-Record 27-XML Browser 34-Hot Desking 35-URL Record 38-LDAP 40-Prefix 41-Zero Touch 42-ACD 45-Local Group 48-Custom Button 50-Keypad Lock 61-Directory linekey.X.xml_...
  • Page 99 Appendix Permitted Parameter Descriptions Web Setting Path Values 2-Forward 5-DND 7-Call Return 8-SMS 9-Directed Pickup 13-Spead Dial 22-XML Group 23-Group Pickup 27-XML Browser 28-History 30-Menu 31-Switch Account 32-New SMS 33-Status 38-LDAP 40-Prefix 41-Zero Touch 43-Local Directory 45-Local Group 47-XML Directory 50-Keypad Lock 61-Directory It configures the desired line to apply...
  • Page 100 Yealink Auto provisioning User Guide Permitted Parameter Descriptions Web Setting Path Values (X ranges from 1 to 14.) programablek ey.X.history_ty DSSKey-> It configures the history type of pe = Integer Programmable programmable key. Key->Line (X ranges from 1 to 14.)
  • Page 101 Appendix Permitted Parameter Descriptions Web Setting Path Values Y ranges from 1 to 39.) (only applicable to T26P and T28P IP phones) expansion_mo dule.X.key.Y.pi ckup_value = (X ranges from 1 to 6. It configures the directed call pickup DSSKey->Ext code. String Y ranges from Key->Extension...
  • Page 102 Yealink Auto provisioning User Guide Permitted Parameter Descriptions Web Setting Path Values T26P and T28P IP phones) It enables or disables always forward feature. Features->Forwar forward.alwa 0-Disabled 0 or 1 d &DND->Always ys.enable = Forward->On/Off 1-Enabled The default value is 0.
  • Page 103 Appendix Permitted Parameter Descriptions Web Setting Path Values 0-Disabled Forward->On/Off 1-Enabled The default value is 0. Features->Forwar forward.no_a It configures the target number the d &DND->No nswer.target String phone forwards incoming calls to after Answer a period of ring time. Forward->Target Features->Forwar It configures the waiting ring time (n*6)
  • Page 104 Yealink Auto provisioning User Guide Permitted Parameter Descriptions Web Setting Path Values The default value is 60. (0~120s) It configures the action URL the phone sends after startup. The value format is: http(s)://IP address of server/help.xml? variable name=variable value. Valid variable values are: $mac ...
  • Page 105 Appendix Permitted Parameter Descriptions Web Setting Path Values action_url.register_failed = http://192.168.0.20/help.xml?IP=$ip It configures the action URL the phone sends when off hook. action_url.off_ Features->Action Example: hook = URL->Off Hook action_url.off_hook = http://192.168.0.20/help.xml?IP=$ip It configures the action URL the phone sends when on hook. action_url.on_ Features->Action Example:...
  • Page 106 Yealink Auto provisioning User Guide Permitted Parameter Descriptions Web Setting Path Values action_url.dnd_on = http://192.168.0.20/help.xml?IP=$ip It configures the action URL the phone sends when DND feature is disabled. action_url.dnd Features->Action Example: _off = URL->Close DND action_url.dnd_off = http://192.168.0.20/help.xml?IP=$ip It configures the action URL the phone sends when always forward feature is Features->Action...
  • Page 107 Appendix Permitted Parameter Descriptions Web Setting Path Values It configures the action URL the phone sends when no answer forward action_url.no_ Features->Action feature is disabled. answer_fwd_o URL->Close No Example: ff = Answer Forward action_url.no_answer_fwd_off = http://192.168.0.20/help.xml?IP=$ip It configures the action URL the phone sends when performing a transfer.
  • Page 108 Yealink Auto provisioning User Guide Permitted Parameter Descriptions Web Setting Path Values action_url.mute = http://192.168.0.20/help.xml?IP=$ip It configures the action URL the phone sends when un-muting a call. action_url.unm Features->Action Example: ute = URL->UnMute action_url.unmute = http://192.168.0.20/help.xml?IP=$ip It configures the action URL the phone sends when missing a call.
  • Page 109 Appendix Permitted Parameter Descriptions Web Setting Path Values It configures the action URL the phone sends when rejecting an incoming call. action_url.reje Features->Action ct_incoming_c Example: URL->Reject all = Incoming Call action_url.reject_incoming_call = http://192.168.0.20/help.xml?IP=$ip It configures the action URL the phone sends when answering a new action_url.ans Features->Action...
  • Page 110 Yealink Auto provisioning User Guide Permitted Parameter Descriptions Web Setting Path Values Spanish or Portuguese It configures the time zone. local_time.tim Settings->Time & String e_zone = Date->Time Zone The default value is +8. It configures the time zone name. local_time.tim Settings->Time &...
  • Page 111 Appendix Permitted Parameter Descriptions Web Setting Path Values Start Day of Week Last in Month/ Start Hour of Day For DST By Date: Settings->Time & It configures the end time of the DST. Date-> End Date Value formats are: For DST By Week: Month/Day/Hour (for By Date) ...
  • Page 112 Yealink Auto provisioning User Guide Permitted Parameter Descriptions Web Setting Path Values The default value is 0. It enables or disables the phone to update time with the offset time obtained from the DHCP server. local_time.dhc Settings->Time & It is only available to the time zone 0.
  • Page 113 Appendix Permitted Parameter Descriptions Web Setting Path Values The default value is 1. It enables or disables the phone to provide input field of outbound server on the hot desking login wizard during hotdesking.st startup. artup_outboun 0 or 1 0-Disabled d_enable = 1-Enabled The default value is 0.
  • Page 114 Yealink Auto provisioning User Guide Permitted Parameter Descriptions Web Setting Path Values The default value is 1. It enables or disables the phone to provide input field of outbound server on the hot desking login wizard when hotdesking.ds pressing the Hot Desking key.
  • Page 115 Appendix Permitted Parameter Descriptions Web Setting Path Values 0-Disabled 1-Enabled The default value is 0. It configures the duration time (in seconds) of the phone displaying the Settings->Auto zero_touch.wa Integer from zero-sp-touch configuration interface Provision->Wait it_time = 0 to 100 when powered on.
  • Page 116 Yealink Auto provisioning User Guide Permitted Parameter Descriptions Web Setting Path Values The default value is 1. (1-15) It configures the maximum length of the number prefixed with the area Settings->Dial dialplan.area code. Integer from Plan->Area _code.max_le 1 to 15 The value must be larger than the Code->Max...
  • Page 117 Appendix Permitted Parameter Descriptions Web Setting Path Values from 1 to 5.) The default value is blank. (not applicable to T20P IP phone) remote_phone book.data.X.n ame = It configures the display name of the remote phone book item. (X ranges Directory->Remote from 1 to 5.) String...
  • Page 118 Yealink Auto provisioning User Guide Permitted Parameter Descriptions Web Setting Path Values It configures the LDAP search base ldap.base = which corresponds to the location of (not the LDAP phonebook. Directory->LDAP-> String applicable to Example: Base T19P and T20P ldap.base = dc=yealink,dc=cn IP phones) The default value is blank.
  • Page 119 Appendix Permitted Parameter Descriptions Web Setting Path Values The default value is blank. It configures the display name of the ldap.display_ contact record displayed on the LCD name = screen. The value of this parameter Directory->LDAP-> (not must start with “%” symbol. String LDAP Display applicable to...
  • Page 120 Yealink Auto provisioning User Guide Permitted Parameter Descriptions Web Setting Path Values 404-No Found Return Code When 480-Temporarily not available 486-Busy here The default value is 480. It configures the return code when refusing a call. Features->General features.norm 404-No Found 404, 480 or Information->...
  • Page 121 Appendix Permitted Parameter Descriptions Web Setting Path Values The default value is 0. It configures the numbers the phone will receive incoming calls from when features.dnd.e Features->Forwar DND feature is enabled. mergency_aut d&DND->DND Number horized_numb Multiple numbers are separated by Authorized er = comma.
  • Page 122 Yealink Auto provisioning User Guide Permitted Parameter Descriptions Web Setting Path Values om.mute = intercom call. m ->Intercom Mute 0-Disabled 1-Enabled The default value is 0. It enables or disables the phone to play a warning tone when answering an intercom call.
  • Page 123 Appendix Permitted Parameter Descriptions Web Setting Path Values It enables or disables the phone to suppress the display of DTMF digits. Features->General features.dtmf. 0-Disabled 0 or 1 Information->Supp hide = ress DTMF Display 1-Enabled The default value is 0. It enables or disables the IP phone to display the DTMF digits for a short Features->General period before displaying as asterisks.
  • Page 124 Yealink Auto provisioning User Guide Permitted Parameter Descriptions Web Setting Path Values 1-Enabled The default value is 1. It enables or disables the server to release the BLA line automatically. features.auto_ 0-Disabled release_bla_li 0 or 1 ne = 1-Enabled The default value is 0.
  • Page 125 Appendix Permitted Parameter Descriptions Web Setting Path Values It enables or disables the phone to play key tone when pressing any key. features.key_t Features->Audio- 0-Disabled 0 or 1 one = > Key Tone 1-Enabled The default value is 1. It enables or disables the phone to play a warning tone when there is a features.play_ Features->General...
  • Page 126 Yealink Auto provisioning User Guide Permitted Parameter Descriptions Web Setting Path Values 1-Enabled The default value is 0. features.pass Features->General It configures the prefix numbers word_dial.pref String Information-> displayed before the encrypted digits. ix = PswPrefix It configures the length of digits to be features.pass...
  • Page 127 Appendix Permitted Parameter Descriptions Web Setting Path Values 1-Enabled The default value is 1. It enables or disables the phone to during an active call. Features->General features.allow 0-Disabled 0 or 1 Information->Allo _mute = w Mute 1-Enabled The default value is 1. It configures the ringer device for the phone in the headset mode.
  • Page 128 Yealink Auto provisioning User Guide Permitted Parameter Descriptions Web Setting Path Values features.picku Features->Call It configures the directed call pickup p.direct_picku String Pickup->Directed code. p_code = Call Pickup Code It enables or disables the phone to features.picku display a visual alert when the p.blf_visual_e...
  • Page 129 Appendix Permitted Parameter Descriptions Web Setting Path Values able = calls when there is a multicast paging IP->Paging Priority call on the phone. Active 0-Disabled 1-Enabled The default value is 1. multicast.recei Directory-> Integer from It configures the priority of multicast ve_priority.pri Multicast 0 to 10...
  • Page 130 Yealink Auto provisioning User Guide Permitted Parameter Descriptions Web Setting Path Values It configures the keypad lock type. phone_setting 0-Disabled .lock = Features->Phone 1-Menu Key (applicable to 0, 1, 2 or 3 Lock->Keypad T20P , T22P , 2-Function Key Lock Type...
  • Page 131 Features->General The maximum length of the value is 15 String Information->Text characters. (only Logo applicable to The default value is Yealink. T20P IP phone) phone_setting .active_backli It configures the level of the active Settings->Preferen ght_level = Integer from backlight intensity.
  • Page 132 Yealink Auto provisioning User Guide Permitted Parameter Descriptions Web Setting Path Values phone_setting Ring1.wav..It configures the ringtone when the .ring_for_tranf Ring5.wav phone fails to transfer a call. ailed = It enables or disables the phone to provide the logon wizard during phone_setting Features->General...
  • Page 133 Appendix Permitted Parameter Descriptions Web Setting Path Values The default value is 112,911,110. It configures the phone whether to end phone_setting the call when the network is .end_call_net_ unavailable. 0 or 1 disconnect.en 0-End the call able = 1-Do not end the call It configures the display message on the LCD screen when receiving a 403 message.
  • Page 134 Yealink Auto provisioning User Guide Permitted Parameter Descriptions Web Setting Path Values gui_lang.delet It deletes all customized language files. lcd_logo.url = (not It configures the access URL of logo applicable to file. T19P and T20P IP phones) lcd_logo.delet (not It deletes all customized logo files.
  • Page 135 Appendix Permitted Parameter Descriptions Web Setting Path Values It configures the access URL of the call list file. call_list.url = It takes effect after reboot. openvpn.url = It configures the access URL of the (not openVPN *.tar file. applicable to T19P IP phone) custom_mac_ It configures the access URL of the...
  • Page 136 Yealink Auto provisioning User Guide Permitted Parameter Descriptions Web Setting Path Values lay_name = account x. ->Display Name (X ranges The default value is blank. from 1 to 6.) account.x.aut It configures the user name for register h_name = Account->Register authentication for account x.
  • Page 137 Appendix Permitted Parameter Descriptions Web Setting Path Values from 1 to 6.) 0- Not need to re-register 1-Need to re-register The default value is 0. account.x.retr It configures retry times for the phone y_counts = after the server has no response to the Integer from phone’s request for account x.
  • Page 138 Yealink Auto provisioning User Guide Permitted Parameter Descriptions Web Setting Path Values ss = name name of server y for account x. Server Host (X ranges Example: from 1 to 6. Y account.1.sip_server.1.address = ranges from 1 10.2.1.128 to 2.) account.x.sip_...
  • Page 139 Appendix Permitted Parameter Descriptions Web Setting Path Values (X ranges working server when the from 1 to 6. Y “account.x.sip_server.Y.failback_mode ranges from 1 ” is set to 3 (duration). to 2.) If you set the parameter between 1 and 59, the timeout will be 60 seconds. The default value is 3600.
  • Page 140 Yealink Auto provisioning User Guide Permitted Parameter Descriptions Web Setting Path Values (X ranges from 1 to 6.) account.x.dns It specifies the time interval that A _cache_a.y.ttl record Y may be cached before the Integer from record should be consulted again for 300 to account x.
  • Page 141 Appendix Permitted Parameter Descriptions Web Setting Path Values from 1 to 6.) The default value is 300. account.x.dns _cache_naptr. It specifies the domain name to which Domain y.name = NAPTR record Y refers in the DNS name cache for account x. (X ranges from 1 to 6.) It specifies the flag of NAPTR record Y...
  • Page 142 Yealink Auto provisioning User Guide Permitted Parameter Descriptions Web Setting Path Values y.ttl = 2147483647 record should be consulted again for account x. (X ranges from 1 to 6.) The default value is 300. It enables or disables the phone to refresh the DNS-SRV query record at account.x.srv_...
  • Page 143 Appendix Permitted Parameter Descriptions Web Setting Path Values account.x.pro It configures the proxy server for xy_require = Account->Basic-> account x. String Proxy Require (X ranges The default value is blank. from 1 to 6.) It enables or disables the phone to only accept the message from the account.x.sip_ trusted server for account x.
  • Page 144 Yealink Auto provisioning User Guide Permitted Parameter Descriptions Web Setting Path Values account.x.ano It configures the code for deactivating Account->Basic-> nymous_reject anonymous call rejection feature for Anonymous Call _offcode = String account x. Rejection->Off (X ranges Code The default value is blank.
  • Page 145 Appendix Permitted Parameter Descriptions Web Setting Path Values account.x.bus It configures the target number the y_fwd.target Features->Forwar phone forwards incoming calls to String d& DND->Busy when busy for account x when the Forward->Target (X ranges DND mode is configured as Custom. from 1 to 6.) It enables or disables no answer account.x.time...
  • Page 146 Yealink Auto provisioning User Guide Permitted Parameter Descriptions Web Setting Path Values account.x.bus Features->Forwar y_fwd.on_cod It configures the busy forward on code d& DND->Busy String for account x when the DND mode is Forward->On configured as Custom. (X ranges Code from 1 to 6.)
  • Page 147 Appendix Permitted Parameter Descriptions Web Setting Path Values from 1 to 6.) It configures the source caller identity for presentation when receiving an incoming call for account x. 0-FROM account.x.cid_ Account-> 1-PAI source = 0, 1, 2, 3, 4 or Advanced->Caller 2-PAI-FROM (X ranges...
  • Page 148 Yealink Auto provisioning User Guide Permitted Parameter Descriptions Web Setting Path Values The default value is 0. account.x.sess It configures the interval (in seconds) Account-> ion_timer.expir for refreshing the SIP session for Integer from Advanced-> es = account x. 300 to 7200...
  • Page 149 Appendix Permitted Parameter Descriptions Web Setting Path Values from 1 to 6.) account.x.dial It enables or disables the phone to oginfo_callpic pick up a call according to the SIP kup = Account-> header of dialog-info for account x. (X ranges Advanced->...
  • Page 150 Yealink Auto provisioning User Guide Permitted Parameter Descriptions Web Setting Path Values _vm = message waiting indicator for account Subscribe MWI To Voice Mail (X ranges from 1 to 6.) 0-Disabled 1-Enabled The default value is 0. It enables or disables the phone to carry the MAC address in the account.x.regi...
  • Page 151 Appendix Permitted Parameter Descriptions Web Setting Path Values It configures the type of the BLF account.x.blf.s subscription for account x. ubscribe_even 0-Dialog 0 or 1 (X ranges 1-Presence from 1 to 6.) The default value is 0. account.x.sub Account-> scribe_acd_ex It configures the period (in seconds) of Integer from Advanced->ACD...
  • Page 152 Yealink Auto provisioning User Guide Permitted Parameter Descriptions Web Setting Path Values It configures the DTMF info type when the DTMF type is configured as “SIP INFO” or “AUTO+SIP INFO” for account.x.dtm Account-> account x. f.info_type = 1, 2 or 3 Advanced->DTMF...
  • Page 153 Appendix Permitted Parameter Descriptions Web Setting Path Values account.x.adv Account-> anced.timer_t It configures the session timer T1 (in Advanced->SIP seconds) for account x. Float Session Timer T1 (X ranges The default value is 0.5. (0.5~10s) from 1 to 6.) account.x.adv Account->...
  • Page 154 Yealink Auto provisioning User Guide Permitted Parameter Descriptions Web Setting Path Values (X ranges 0-Disabled from 1 to 6. 1-Enabled Y ranges from Example: 1 to 11.) account.1.codec.1.enable =1 PCMU PCMA G729 It configures the codec for account x. account.x.cod G722 ec.y.payload_...
  • Page 155 Appendix Permitted Parameter Descriptions Web Setting Path Values (X ranges The default value is 0. from 1 to 6.) It configures the way on how the phone processes Music On Hold when placing an active call on hold for account.x.mus account x.

This manual is also suitable for:

Sip-t19pSip-vp530Sip-t3 series

Table of Contents