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

Yealink SIP-T4X Provisioning Manual

Ip phone
Hide thumbs Also See for SIP-T4X:
Table of Contents

Advertisement

Quick Links

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

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the SIP-T4X and is the answer not in the manual?

Questions and answers

Related Manuals for Yealink SIP-T4X

Summary of Contents for Yealink SIP-T4X

  • 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.181.............. v Changes for Release 71, Guide Version 71.180.............. v Changes for Release 71, Guide Version 71.171.............. v Changes for Release 71, Guide Version 71.170.............. v Changes for Release 71, Guide Version 71.150..............
  • Page 4 Yealink SIP-T4X IP Phones Auto Provisioning Guide Obtaining the Provisioning Server Address ......23 Zero Touch ........................23 Plug and Play (PnP) Server .................... 24 DHCP Options ........................ 25 Phone Flash ........................26 Update Mode ..............29 Power On ........................29 Repeatedly ........................
  • Page 5  Description of Configuration Parameters in CFG Files on page  This version is updated to incorporate SIP-T41P as one of the SIP-T4X device models. The following section is new for this version: Customizing an LCD Logo on page ...
  • Page 6 Major updates have occurred to the following section: Description of Configuration Parameters in CFG Files on page  This version is updated to incorporate SIP-T42G as one of the SIP-T4X device models. Major updates have occurred to the following sections: Obtaining Configuration Files on page ...

  • Page 7: Introduction

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

  • Page 9: Getting Started

    SIP-T41P y000000000036.cfg You can ask the distributor or Yealink FAE for configuration files. The IP phones 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 10 Yealink SIP-T4X IP Phones Auto Provisioning Guide MAC Address: The unique 12-digit serial number of the phone. You can obtain it from the bar code on the back of the phone. SIP Account Information: This may include SIP credentials such as user name, password and address of the registration server.
  • Page 11 Getting Started The parameters commonly edited in the Common CFG file are described as follows (take the SIP-T46G IP phone as an example): #################################################### Common CFG File #################################################### #!version:1.0.0.1 ##File header "#!version:1.0.0.1" cannot be edited or deleted, and must be placed in the first line.
  • Page 12 Yealink SIP-T4X IP Phones Auto Provisioning Guide default time is 00:00. #If the desired end time of the day is seven forty-five p.m., the value format is 19:45. auto_provision.weekly.end_time = #Configure the day of the week for the phone to check new configuration files. The default value is 0123456.

  • Page 13: Editing Mac-Oriented Cfg File

    Getting Started #Require reboot wui.https_enable = # Enable or disable the web server access for HTTP; 0-Disabled, 1-Enabled (default); #Require reboot wui.http_enable = #Set the HTTP port (80 by default) #Require reboot network.port.http = #Set the HTTPS port (443 by default) #Require reboot network.port.https = MAC-Oriented CFG file contains configuration parameters which are expected to be...
  • Page 14 Yealink SIP-T4X IP Phones Auto Provisioning Guide The parameters commonly edited in the MAC-Oriented CFG file are described as follows: #################################################### MAC-Oriented CFG File #################################################### #!version:1.0.0.1 ##The file header “#!version:1.0.0.1” is not a comment and must be placed in the first line.
  • Page 15 Getting Started account.2.user_name = #Configure the SIP server 1 address and port (5060 by default) account.2.sip_server.1.address = account.2.sip_server.1.port = #Configure the SIP server 2 address and port (5060 by default) account.2.sip_server.2.address = account.2.sip_server.2.port = # Account 3 settings #Enable or disable the account3, 0-Disabled (Default), 1-Enabled account.3.enable = #Configure the label displayed on the LCD screen for account 3 account.3.label =...
  • Page 16 Yealink SIP-T4X IP Phones Auto Provisioning Guide #Configure the register user name account.4.user_name = #Configure the SIP server 1 address and port (5060 by default) account.4.sip_server.1.address = account.4.sip_server.1.port = #Configure the SIP server 2 address and port (5060 by default) account.4.sip_server.2.address =...
  • Page 17 When configuring some particular features, you may need to upload resource files to IP phones, such as personalized ringtone file, language package. Yealink provides some resource file templates for the particular features. Ask the distributor or Yealink FAE for resource file templates. The following provides information on how to customize...

  • Page 18: Customizing A Ringtone

    Yealink SIP-T4X IP Phones Auto Provisioning Guide The 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. The ringtone file must be PCMU audio format, mono channel, 8K sample rate and 16 bit resolution.
  • Page 19 Getting Started Associated Language Pack Associated Language Pack Available Language for SIP-T42G/T41P for SIP-T46G Portuguese lang-Portuguese.txt 7.GUI.Portuguese.lang Spanish lang-Spanish.txt 8.GUI.Spanish.lang Turkish lang-Turkish.txt 9.GUI.Turkish.lang SIP-T46G IP phones also support to add a custom or modify an existing LCD language with a txt formatted file. The txt formatted language file name must be “lang-Y.txt”, where “Y”...
  • Page 20 “Name=” to be “en-us” in the “0.GUI.English.lang” language file. After update, you will find the English language selection on the phone user interface is “en-us”. The following figure shows a portion of a txt formatted language file for SIP-T4X IP phones: ####################################################...

  • Page 21: Customizing Wallpaper

    .dob, and the resolution of the SIP-T42G/T41P IP phones is 192*64 graphic. 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...

  • Page 22: Customizing Local Contact File

    Yealink SIP-T4X IP Phones Auto Provisioning Guide Upload the wallpaper image to the provisioning server and then specify the access URL in the configuration file: #################################################### Configure the access URL of the wallpaper #################################################### wallpaper_upload.url = For example, enter “tftp://192.168.1.100/wallpaper.jpg” in the “wallpaper_upload.url =”...
  • Page 23 After editing the local contact template file, upload the file to the provisioning server and then specify the access URL in the configuration file. The following shows an example of a local contact file used for SIP-T4X IP phones: <root_group>...
  • Page 24 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 25 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 26 Yealink SIP-T4X IP Phones Auto Provisioning Guide Save the change. 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 =”...

  • Page 27: Configuring A Tftp Server

    Configuring a TFTP Server Yealink SIP-T4X 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 28 Yealink SIP-T4X 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 29: Obtaining The Provisioning Server Address

    Obtaining the Provisioning Server Address Yealink SIP-T4X 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 30 Yealink SIP-T4X IP Phones Auto Provisioning Guide When Zero Touch is enabled, there will be a configuration wizard during the startup: Press the OK soft key. The network parameters are configurable via phone user interface: Press the Next soft key after finishing the network parameters.
  • Page 31 Then the phone 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 32 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 33 Obtaining the Provisioning Server Address 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 34 Yealink SIP-T4X IP Phones Auto Provisioning Guide...

  • Page 35: Update Mode

    Update Mode The update mode is used to set the desired time for the IP phone to perform auto provisioning. This chapter introduces the following update modes in detail: Power On  Repeatedly  Weekly  Auto Provision Now  Multi-mode Mixed ...
  • Page 36 Yealink SIP-T4X IP Phones Auto Provisioning Guide 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. To activate the Repeatedly mode via web user interface: Click on Settings->Auto Provision.
  • Page 37 Update Mode 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. To use the Auto Provision Now mode via web user interface: Click on Settings->Auto Provision.
  • Page 38 Yealink SIP-T4X IP Phones Auto Provisioning Guide 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 performs the auto provisioning process when it is powered on and at a specified interval.
  • Page 39 Update Mode The following figure shows the message flow:...
  • Page 40 Yealink SIP-T4X IP Phones Auto Provisioning Guide...

  • Page 41: Downloading Configuration Files

    Verifying Configurations After auto provisioning, you can verify the update via phone user interface or web user interface. 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 during the auto provisioning process. The...
  • Page 42 Yealink SIP-T4X IP Phones Auto Provisioning Guide Example1: Yealink SIP-T46G IP phone downloads configuration files from the TFTP server. Example 2: Yealink SIP-T46G IP phone downloads configuration files from the FTP server. Example 3: Yealink SIP-T46G IP phone downloads configuration files from the HTTP...

  • Page 43: 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 44 Yealink SIP-T4X IP Phones Auto Provisioning 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 45: 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 46 Yealink SIP-T4X IP Phones Auto Provisioning Guide...

  • Page 47: 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 48 Yealink SIP-T4X 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 49 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 50 Yealink SIP-T4X 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 51 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 52 Yealink SIP-T4X 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 53: Configuring Dhcp Server

    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 54 Yealink SIP-T4X 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 55 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 56 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 57 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 58 Yealink SIP-T4X 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 59 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 60: Customizing Ringtone Using Cool Edit Pro

    Yealink SIP-T4X 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. 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...
  • Page 61 Appendix A sample audio file loaded is shown as below: Select and copy the audio waveform. Select File->New to create a new file, set the channels as Mono, the sample rate as 8000 and the resolution as 16-bit. Paste the audio waveform to the new file. Select File->Save as to save the new audio file.
  • Page 62 Yealink SIP-T4X IP Phones Auto Provisioning Guide Double click the PictureExDemo.exe. Click Add button to open a *.bmp or *.gif file. You can repeat the second step to add multiple original picture files. Click the Convert button. Then you can find the DOB logo files in the adv directory.

  • Page 63: Description Of Configuration Parameters In Cfg Files

    Appendix If you want to reset the configuration of a parameter to factory setting, 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 64 Yealink SIP-T4X IP Phones Auto Provisioning Guide ay = Gateway the Internet (WAN) port type for IPv4 is configured as Static IP Address. The default value is blank. It takes effect after reboot. It configures the primary IPv4 DNS server when the IP address mode is Network->IPv4...
  • Page 65 Appendix The default value is 64. It takes effect after reboot. It configures the IPv6 address when the IP address mode is configured as IPv6 Network->IPv6 or IPv4&IPv6, and the Internet (WAN) network.ipv6_i Config->Static IP port type for IPv6 is configured as IP address nternet_port.i Address->IP...
  • Page 66 Yealink SIP-T4X IP Phones Auto Provisioning Guide SIP-T46G (for SIP-T46G) SIP-T42G (for SIP-T42G) SIP-T41P (for SIP-T41P) It enables or disables the PC port. 0-Disabled network.pc_p 0 or 1 ort.enable = 1-Enabled The default value is 1. It configures the transmission mode and transmission speed of the Internet (WAN) port.
  • Page 67 Appendix id = 4094 The default value is 1. ->WAN Port->VID (1-4094) It takes effect after reboot. It configures VLAN priority of the Network-> network.vlan.i Internet (WAN) port. Integer Advanced->VLAN nternet_port_p The default value is 0. ->WAN Port-> from 0 to 7 riority = Priority It takes effect after reboot.
  • Page 68 Yealink SIP-T4X IP Phones Auto Provisioning Guide 1-Enabled The default value is 1. It takes effect after reboot. It enables or disables the HTTPS protocol for web server access. Network-> 0-Disabled wui.https_ena 0 or 1 Advanced->Web ble = 1-Enabled Server->HTTPS The default value is 1.
  • Page 69 Appendix 3-PEAP-MSCHAPv2 4-EAP-TTLS/EAP-MSCHAPv2 The default value is 0. It takes effect after reboot. It configures the user name for 802.1x Network-> authentication. network.802_1 String Advanced->802.1x x.identity = The default value is blank. ->Identity It takes effect after reboot. It configures the password for 802.1x network.802_1 Network->...
  • Page 70 Yealink SIP-T4X IP Phones Auto Provisioning Guide .enable = 0-Disabled ->Active 1-Enabled (for SIP-T46G only) The default value is 0. It takes effect after reboot. network.snmp It configures the SNMP port. Integer Network-> .port = The default value is 161.
  • Page 71 The default value is 1. It configures the domain name of the auto_provision PnP server. String .pnp_domain_ name = The default value is 224.0.1.75. It configures the vendor name of the auto_provision device. .pnp_event_v String endor = The default value is yealink.
  • Page 72 Yealink SIP-T4X IP Phones Auto Provisioning Guide It enables or disables the phone to check the new configuration auto_provision Settings->Auto repeatedly. .repeat.enabl 0 or 1 Provision-> 0-Disabled Repeatedly 1-Enabled The default value is 0. It configures the interval (in minutes)
  • Page 73 It configures the value (vendor name Settings->Auto .dhcp_option. of the device) of DHCP option 60. String Provision->DHCP option60_valu Option Value The default value is yealink. auto_provision Integer It configures the custom DHCP option Settings->Auto .dhcp_option.l for the provisioning server address. Provision->Custom...
  • Page 74 Yealink SIP-T4X IP Phones Auto Provisioning Guide from 1 to 50.) characters. Valid characters are digits, # and *. (for SIP-T46G only) Example: autoprovision.1.code = *99 The default value is blank. It takes effect after reboot. autoprovision. X.url = It configures the URL of auto provisioning server.
  • Page 75 Appendix Name 0-Disabled (convert the pound sign into “%23”) 1-Enabled The default value is 1. It enables or disables the phone to support RFC 2543 hold (c=0.0.0.0). Features->General sip.rfc2543_ho 0-Disabled 0 or 1 Information->RFC ld = 2543 Hold 1-Enabled The default value is 0. It enables or disables the phone to keep sending SIP messages to the Features->General...
  • Page 76 Yealink SIP-T4X IP Phones Auto Provisioning Guide phone to authenticate with the ACS. ACS Username erver.usernam It takes effect after reboot. (for SIP-T46G only) managements erver.passwor It configures the password for the Settings->TR069-> phone to authenticate with the ACS. String ACS Password It takes effect after reboot.
  • Page 77 Appendix nable = Transfer on the LCD screen before displaying the caller ID. 0-Disabled 1-Enabled The default value is 1. It enables or disables the phone to complete the blind transfer through transfer.blind_ Features->Transfer on-hook. 0 or 1 tran_on_hook_ ->Blind Transfer On 0-Disabled enable = Hook...
  • Page 78 Yealink SIP-T4X IP Phones Auto Provisioning Guide 0-Disabled ->CNG 1-Enabled The default value is 1. It enables or disables the echo canceller. Settings->Voice-> voice.echo_ca 0-Disabled Echo Cancellation 0 or 1 ncellation = 1-Enabled ->ECHO The default value is 1. It configures the type of jitter buffer.
  • Page 79 Appendix Japan, Mexico, Zealand, Netherlands, Norway, Portugal, Spain, Switzerland, Sweden, Russia, United States, Chile, Czech ETSI It customizes the dial tone when the parameter "voice.tone.country" is configured as Custom. tonelist = element[,element] [,element]… Where element = [!]freq1[+freq2][+freq3][+freq4] /duration Freq: the frequency of the tone (ranges from 200 to 7000 Hz).
  • Page 80 Yealink SIP-T4X IP Phones Auto Provisioning Guide configured as 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 busy tone when the parameter "voice.tone.country"...
  • Page 81 Appendix It customizes the tone for call recording when the parameter “voice.tone.country” is configured as Custom. voice.tone.rec Settings->Tones-> String The value format is F/D or !F/D. For ord = Record more information on the value format, refer to the parameter “voice.tone.dial”.
  • Page 82 Yealink SIP-T4X IP Phones Auto Provisioning Guide “voice.tone.dial”. The default value is blank. It configures the receiving volume of Integer voice.handfre speaker. e.spk_vol = from 0 to 15 The default value is 8. It configures the receiving volume of Integer voice.handset...
  • Page 83 Appendix tone and plays received RTP for ring-back tone. The default value is 1. It configures the source certificates for the phone to authenticate the TLS Security->Trusted connection. security.trust_c Certificates->Only 0 or 1 0-Disabled ertificates = Accept Trusted Certificates 1-Enabled The default value is 1.
  • Page 84 Yealink SIP-T4X IP Phones Auto Provisioning Guide security.user_n It configures the var name for web String ame.var = server access. It configures the password of the user, var and administrator. security.user_ String Security->Password The valid value format is user password = name:password (e.g.,...
  • Page 85 Appendix 1 to 15.) 1-Conference 2-Forward 3-Transfer 4-Hold 5-DND 7-Call Return 8-SMS (for SIP-T46G only) 9-Directed Pickup 10-Call Park 11-DTMF 12-Voice Mail 13-Speed Dial 14-Intercom 15-Line (defaults to line key 1-6 for SIP-T46G and line key 1-3 for SIP-T42G/T41P) 16-BLF 17-URL 18-Group Listening 22-XML Group...
  • Page 86 Yealink SIP-T4X IP Phones Auto Provisioning Guide to 27. desired phone book (or group) when multiple phone books (or groups) are SIP-T42G/T41P: configured on the IP phone. X ranges from 1 to 15.) When specifying the line, valid values are:...
  • Page 87 Appendix X ranges from 1 to 15.) It configures the key feature for the programmable key X. Valid values are: 0-N/A 2-Forward 5-DND 6-Redial 7-Call Return 8-SMS (for SIP-T46G only) programablek 9-Call Pickup ey.X.type = 13-Spead Dial (SIP-T46G: X 22-XML Group DSSKey->...
  • Page 88 Yealink SIP-T4X IP Phones Auto Provisioning Guide History, this parameter is used to specify the type of call history to be displayed. 1 stands for the local call history, and 2 stands for the network history. programablek ey.X.value = It configures the value of the (SIP-T46G: X programmable key.
  • Page 89 Appendix expansion_mo dule.X.key.Y.e xtension = It configures the pickup code for BLF (X ranges from 1 to 6. feature. String DSSKey->Ext Key The default value is blank. Y ranges from 1 to 40.) (for SIP-T46G only) expansion_mo dule.X.key.Y.la bel = It configures the label displaying on (X ranges the LCD screen of the expansion...
  • Page 90 Yealink SIP-T4X IP Phones Auto Provisioning Guide It configures the display message on the LCD screen when receiving a 403 message. phone_setting If leaving the field blank, the phone .show_code40 String will display the value sent from the server when receiving the 403 message.
  • Page 91 Appendix Code It enables or disables no answer forward feature. forward.no_a Features->Forward 0-Disabled 0 or 1 nswer.enable &DND->No Answer Forward->On/Off 1-Enabled The default value is 0. forward.no_a It configures the target number the Features->Forward String nswer.target phone forwards incoming calls to after &DND->No Answer a period of ring time.
  • Page 92 Yealink SIP-T4X IP Phones Auto Provisioning Guide The default value is 60. 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 93 Appendix http://192.168.0.20/help.xml?model=$ model It configures the action URL the phone sends when off hook. action_url.off_ Example: Features->Action hook = URL->Off Hook action_url.off_hook = http://192.168.0.20/help.xml?model=$ model It configures the action URL the phone sends when on hook. action_url.on_ Example: Features->Action hook = URL->On Hook action_url.on_hook = http://192.168.0.20/help.xml?model=$...
  • Page 94 Yealink SIP-T4X IP Phones Auto Provisioning Guide It configures the action URL the phone sends when DND feature is disabled. action_url.dnd Example: Features->Action _off = URL->Close DND action_url.dnd_off = http://192.168.0.20/help.xml?model=$ model It configures the action URL the phone sends when always forward feature is enabled.
  • Page 95 Appendix http://192.168.0.20/help.xml?model=$ model It configures the action URL the phone sends when no answer forward feature is disabled. action_url.no_ Features->Action Example: answer_fwd_o URL->Close No ff = Answer Forward action_url.no_answer_fwd_off = http://192.168.0.20/help.xml?model=$ model It configures the action URL the phone sends when performing a transfer. action_url.tran Example: Features->Action...
  • Page 96 Yealink SIP-T4X IP Phones Auto Provisioning Guide http://192.168.0.20/help.xml?model=$ model It configures the action URL the phone sends when muting a call. action_url.mut Example: Features->Action URL->Mute action_url.mute = http://192.168.0.20/help.xml?model=$ model It configures the action URL the phone sends when un-muting a call.
  • Page 97 Appendix model It configures the action URL the phone sends when changing the IP address of the phone. action_url.ip_c Features->Action Example: hange = URL->IP Changed action_url.ip_change = http://192.168.0.20/help.xml?model=$ model It configures the action URL the phone sends when forwarding an incoming call.
  • Page 98 Yealink SIP-T4X IP Phones Auto Provisioning Guide action_url. transfer_failed = http://192.168.0.20/help.xml?model=$ model English, Chinese_S, It configures the language of the web Chinese_T, user interface. German, Settings-> lang.wui = French, Preference-> Note: Chinese_S and Chinese_T are Italian, Language applicable to the SIP-T46G IP phone Spanish, only.
  • Page 99 Appendix 0-Disabled 1-Enabled 2-Automatic The default value is 2. It configures the way DST works when DST feature is enabled. local_time.dst Settings ->Time & 0-DST By Date 0 or 1 _time_type = Date-> Fixed Type 1-DST By Week The default value is 0. For DST By Date: Settings ->Time &...
  • Page 100 Yealink SIP-T4X IP Phones Auto Provisioning Guide It configures the time format. 0-12 Hour local_time.tim Settings ->Time & 0 or 1 e_format = Date->Time Format 1-24 Hour The default value is 1. It configures the date format. Valid values are:...
  • Page 101 Appendix 0-Disabled 1-Enabled The default value is 1. It enables or disables the phone to show the SIP server item on the login hotdesking.st wizard during startup. artup_sip_serv 0 or 1 0-Disabled er_enable = 1-Enabled The default value is 1. It enables or disables the phone to show the outbound server item on the hotdesking.st...
  • Page 102 Yealink SIP-T4X IP Phones Auto Provisioning Guide er_enable = wizard when pressing the Hot Desking key. 0-Disabled 1-Enabled The default value is 1. It enables or disables the phone to show the outbound server item on the login wizard when pressing the Hot hotdesking.ds...
  • Page 103 Appendix during startup. Active 0-Disabled 1-Enabled The default value is 0. It configures the duration time (in seconds) of the phone displaying the Settings->Auto Integer zero_touch.wa zero-sp-touch configuration interface Provision->Wait it_time = from 0 to 100 when powered on. Time The default value is 5.
  • Page 104 Yealink SIP-T4X IP Phones Auto Provisioning Guide Settings->Dial It configures the area code. dialplan.area Number Plan->Area _code.code = The default value is blank. Code->Code Settings->Dial It configures the minimum length of the dialplan.area Integer Plan->Area number prefixed with the area code.
  • Page 105 Appendix from 1 to 100.) The default value is blank. dialplan.repla It configures the entered number to be Settings->Dial ce.prefix.X = replaced. String Plan->Replace (X ranges Rule->Prefix The default value is blank. from 1 to 100.) dialplan.repla ce.replace.X It configures the alternate number to Settings->Dial replace the entered number.
  • Page 106 Yealink SIP-T4X IP Phones Auto Provisioning Guide (|(telephoneNumber=%)(mobile=%)(i pPhone=%)) The default value is blank. It configures the IP address or domain IP address Directory->LDAP-> name of the LDAP server. ldap.host = or domain Server Address name The default value is blank.
  • Page 107 Appendix ldap.numb_attr = Mobile ipPhone The default value is blank. It configures the display name of the contact record displayed on the LCD screen. The value of this parameter must start ldap.display_ Directory->LDAP-> String with “%” symbol. name = LDAP Display Name Example: ldap.display_name =%cn The default value is blank.
  • Page 108 Yealink SIP-T4X IP Phones Auto Provisioning Guide It enables or disables call completion features.call_c feature. ompletion_en Features->General able = 0-Disabled 0 or 1 Information->Call Completion 1-Enabled (for SIP-T46G only) The default value is 0. It configures the call forward mode.
  • Page 109 Appendix feature. The default value is blank. It configures the call waiting off code to deactivate the server-side call call_waiting.of String waiting feature. f_code = The default value is blank. It enables or disables the phone to play the call waiting tone. call_waiting.to Features->Audio->...
  • Page 110 Yealink SIP-T4X IP Phones Auto Provisioning Guide 0-Disabled 1-Enabled The default value is 0. It enables or disables the phone to perform a remote phone book search Directory->Remote features.remot when receiving an incoming call. Phone Book-> e_phonebook. 0 or 1...
  • Page 111 Appendix soft key or the transfer key. 0-Disabled 1-Enabled The default value is 0. It configures DTMF sequences to be Features->General sent for transfer key. features.dtmf.t String Information->Tran ransfer = It can be consisted of 0-9, A-D, * and #. Send DTMF The default value is blank.
  • Page 112 Yealink SIP-T4X IP Phones Auto Provisioning Guide 1-# key 2-* key The default value is 1. It enables or disables the phone to play key tone when pressing the send key. features.send Features->Audio-> 0 or 1 0-Disabled _key_tone = Send Sound 1-Enabled The default value is 1.
  • Page 113 Appendix 1-Enabled The default value is 0. It configures the length of digits to be features.pass Features->General hidden. Integer word_dial.len Information-> The hidden digits are displayed as gth = PswLength asterisks on the LCD screen. It configures the prefix of the password-dial number.
  • Page 114 Yealink SIP-T4X IP Phones Auto Provisioning Guide 0-Disabled 1-Enabled The default value is 1. Features->General Integer It configures the web login timeout (in features.relog Information->Auto- minutes). from 1 to _offtime = Logout Time 1000 The default value is 5. (1~1000min) It enables or disables the phone to make an IP call directly.
  • Page 115 Appendix p_code = code. Pickup Code The default value is blank. It enables or disables the phone to display the DPickup soft key when the features.picku Features->Call phone is in the pre-dialing interface. p.direct_picku 0 or 1 Pickup->Directed 0-Disabled p_enable = Call Pickup 1-Enabled The default value is 0.
  • Page 116 Yealink SIP-T4X IP Phones Auto Provisioning Guide It enables or disables the phone to play the warning tone when receiving features.voice a voice mail. _mail_tone_en 0 or 1 0-Disabled able = 1-Enabled The default value is 1. It enables or disables the phone to...
  • Page 117 Appendix diversion feature. diversion_ena Information->Diver ble = sion/History-Info 0- Disabled 1-Enabled The default value is 1. It configures the delay time (in Integer features.hold_ milliseconds) before transferring a call. trans_delay = from 0 to 60 The default value is 0. PCMU PCMA G729...
  • Page 118 Yealink SIP-T4X IP Phones Auto Provisioning Guide It enables or disables the phone to automatically dial out the entered phone_setting Settings-> digits in the pre-dialing interface. .predial_auto 0 or 1 Preference->Live 0-Disabled dial = Dialpad 1-Enabled The default value is 0.
  • Page 119 Appendix from 1 to 10 backlight intensity. .active_backli Preference-> ght_level = Backlight On The default value is 8. Intensity (for SIP-T46G only) It configures the phone to go out or phone_setting reduce intensity of the backlight on the Settings-> .inactive_back LCD screen after a period of inactivity.
  • Page 120 Yealink SIP-T4X IP Phones Auto Provisioning Guide It enables or disables customizing the softkey layout. phone_setting Settings->Softkey 0-Disabled 0 or 1 .custom_softke Layout->Custom y_enable = Softkey 1-Enabled The default value is 0. It configures headset mode precedence during a call.
  • Page 121 Appendix It configures the access URL of firmware.url = firmware file. It configures the access URL of the ringtone.url = customized ringtone file. It deletes all customized ringtone files. ringtone.delet The valid value is: http://localhost/all. It configures the access URL of the gui_lang.url = language file.
  • Page 122 Yealink SIP-T4X IP Phones Auto Provisioning Guide It configures the access URL of the DST auto_dst.url = Time file. dialplan_dialn It configures the access URL of the ow.url = dial-now rule file. dialplan_repl It configures the access URL of the ace_rule.url =...
  • Page 123 Appendix 1 to 3.) account.X.lab el = (SIP-T46G: X It configures the label displayed on the Account->Register ranges from 1 LCD screen for account X. String to 6. ->Label The default value is blank. SIP-T42G/T41P: X ranges from 1 to 3.) account.X.dis play_name = (SIP-T46G: X...
  • Page 124 Yealink SIP-T4X IP Phones Auto Provisioning Guide 1 to 3.) account.X.sip_ server.Y.addre ss = (SIP-T46G: X ranges from 1 IP address Account->Register It configures the IP address or domain to 6. or domain ->SIP Server Y name of server Y for account X.
  • Page 125 Appendix X ranges from 1 to 3. Y ranges from 1 to 2.) It configures the transport type for account X. account.X.tran 0-UDP sport = 1-TCP 2-TLS (SIP-T46G: X 3-DNS-NAPTR Account->Register ranges from 1 0, 1, 2 or 3 to 6. ->Transport If it is set to 3 (DNS-NAPTR) and no server port is given, the phone...
  • Page 126 Yealink SIP-T4X IP Phones Auto Provisioning Guide SIP-T42G/T41P: It is only applicable to the successive X ranges from registration mode. 1 to 3.) The default value is 120. It configures the way in which the phone fails back to the primary server for call control when in the failover mode.
  • Page 127 Appendix account.x.sip_ server.y.regist er_on_enable It enables or disables the IP phone to register to the secondary server before (SIP-T46G: X sending requests to the secondary ranges from 1 server in the failover mode. 0 or 1 to 6. 0-Disabled SIP-T42G/T41P: 1-Enabled X ranges from The default value is 0.
  • Page 128 Yealink SIP-T4X IP Phones Auto Provisioning Guide ranges from 1 to 6. SIP-T42G/T41P: X ranges from 1 to 3.) account.X.pro xy_require = (SIP-T46G: X It configures the proxy server for Account->Basic-> ranges from 1 account X. String to 6. Proxy Require The default value is blank.
  • Page 129 Appendix ncode = The default value is blank. Code->On Code (SIP-T46G: X ranges from 1 to 6. SIP-T42G/T41P: X ranges from 1 to 3.) account.X.ano nymous_call_o ffcode = It configures the code for deactivating (SIP-T46G: X Account->Basic-> anonymous call feature for account X. ranges from 1 String Anonymous...
  • Page 130 Yealink SIP-T4X IP Phones Auto Provisioning Guide SIP-T42G/T41P: X ranges from 1 to 3.) account.X.dnd It enables or disables DND feature for .enable = account X when the DND mode is (SIP-T46G: X Features->Forward configured to “custom”. ranges from 1 &...
  • Page 131 Appendix ranges from 1 to 6. SIP-T42G/T41P: X ranges from 1 to 3. ) account.X.bus It enables or disables busy forward y_fwd.enable feature for account X when the call forward mode is configured to Features->Forward (SIP-T46G: X “custom”. ranges from 1 0 or 1 &...
  • Page 132 Yealink SIP-T4X IP Phones Auto Provisioning Guide 1 to 3. ) account.X.tim It configures the ring times (N) to wait eout_fwd.time before forwarding incoming calls for out = account X when the call forward mode Features->Forward (SIP-T46G: X is configured to “custom”.
  • Page 133 Appendix The default value is blank. (SIP-T46G: X ranges from 1 to 6. SIP-T42G/T41P: X ranges from 1 to 3. ) account.X.tim eout_fwd.off_c ode = It configures the no answer forward off Features->Forward code for account X when the call (SIP-T46G: X &...
  • Page 134 Yealink SIP-T4X IP Phones Auto Provisioning Guide account.X.sub It enables or disables the phone to scribe_mwi = subscribe the message waiting (SIP-T46G: X Account-> indicator for account X. ranges from 1 0 or 1 Advanced-> 0-Disabled to 6. Subscribe for MWI...
  • Page 135 Appendix account.X.cp_ It configures the source callee identity source = for presentation for account X. (SIP-T46G: X 0-RPID-FROM ranges from 1 0, 1 or 2 to 6. 1-Dialed Digits 2-RFC4916 SIP-T42G/T41P: X ranges from The default value is 0. 1 to 3. ) account.X.ses sion_timer.ena It enables or disables the session timer...
  • Page 136 Yealink SIP-T4X IP Phones Auto Provisioning Guide to 6. The default value is 0. SIP-T42G/T41P: X ranges from 1 to 3. ) account.X.srtp It configures whether to use voice _encryption = encryption service for account X. (SIP-T46G: X Account-> 0-Disabled...
  • Page 137 Appendix 0-Disabled Pickup (SIP-T46G: X ranges from 1 1-Enabled to 6. The default value is 0. SIP-T42G/T41P: X ranges from 1 to 3. ) account.X.gro up_pickup_co de = It configures the group pickup code for (SIP-T46G: X Account-> account X. String ranges from 1 Advanced->Group...
  • Page 138 Yealink SIP-T4X IP Phones Auto Provisioning Guide account.X.sub It enables or disables the phone to scribe_mwi_to subscribe to the voice mail for the _vm = Account-> message waiting indicator for account (SIP-T46G: X Advanced-> ranges from 1 0 or 1...
  • Page 139 Appendix X ranges from 1 to 3.) account.X.con f_uri = (SIP-T46G: X It configures the network conference Account-> ranges from 1 URI for account X. String Advanced-> to 6. Conference URI The default value is blank. SIP-T42G/T41P: X ranges from 1 to 3.) account.X.blf.s ubscribe_peri...
  • Page 140 Yealink SIP-T4X IP Phones Auto Provisioning Guide (120~3600s) (SIP-T46G: X ranges from 1 to 6. SIP-T42G/T41P: X ranges from 1 to 3.) account.X.sip_ It configures the SIP server type for server_type = account X. (SIP-T46G: X 0-Default Account-> ranges from 1...
  • Page 141 Appendix It configures the DTMF info type when account.X.dtm the DTMF type is configured as “SIP f.info_type = INFO” or “AUTO or SIP INFO” for (SIP-T46G: X Account-> account X. ranges from 1 1, 2 or 3 Advanced->DTMF 1-DTMF-Relay to 6. Info Type 2-DTMF SIP-T42G/T41P:...
  • Page 142 Yealink SIP-T4X IP Phones Auto Provisioning Guide X ranges from 2-Options: the phone sends SIP 1 to 3.) OPTION packets to the server. 3-Notify: the phone sends SIP NOTIFY packet to the server. The default value is 1. account.X.nat. udp_update_ti...
  • Page 143 Appendix account.X.adv anced.timer_t Account-> Float It configures the session timer T4 (in (SIP-T46G: X Advanced->SIP seconds) for account X. ranges from 1 from 2.5 to Session Timer T4 to 6. The default value is 5. (2.5~60s) SIP-T42G/T41P: X ranges from 1 to 3.) account.X.aler t_info_url_ena...
  • Page 144 Yealink SIP-T4X IP Phones Auto Provisioning Guide When Y=9, the default value is G726_24; When Y=10, the default value is G726_32; When Y=11, the default value is G726_40; For T46G: When Y=12, the default value is GSM. For T42G and T41P: When Y=14, the default value is GSM.
  • Page 145 Appendix from 1 to 12. SIP-T42G/T41P: X ranges from 1 to 3. Y ranges from 1 to 14.) account.X.unr egister_on_re It enables or disables the phone to boot = Account-> de-register account X before reboot. (SIP-T46G: X Advanced-> 0-Disabled 0 or 1 ranges from 1 Unregister When to 6.
  • Page 146 Yealink SIP-T4X IP Phones Auto Provisioning Guide 1 to 3.) account.X.acd It enables or disables the phone to .available = display the available and unavailable (SIP-T46G: X soft keys after the phone logs into the ranges from 1 ACD system.
  • Page 147 Appendix The default value is 0. ranges from 1 to 6. It is applicable to the SIP-T46G IP phone only. SIP-T42G/T41P: X ranges from 1 to 3.) account.X.init_ It enables or disables the phone to register_auth_ carry the authentication header in the enable = first REGISTER message when (SIP-T46G: X...
  • Page 148 Yealink SIP-T4X IP Phones Auto Provisioning Guide 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