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

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

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.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.............. v Changes for Release 71, Guide Version 71.90 ...............
  • Page 4 Yealink SIP-T4X IP Phones Auto Provisioning Guide Zero Touch ........................24 Plug and Play (PnP) Server .................... 25 DHCP Options ........................ 26 Phone Flash ........................27 Update Mode ..............30 Power On ........................30 Repeatedly ........................31 Weekly ..........................31 Auto Provision Now ......................
  • 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 Yealink SIP-T4X IP Phones Auto Provisioning Guide 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 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 .txt format language files. The names of the .txt language files for SIP-T46G IP phones are the same as that of the SIP-T42G/T41P IP phones.
  • Page 20 Yealink SIP-T4X IP Phones Auto Provisioning Guide “Name=” in the language file for SIP-T46G IP phones. For example, edit the value of the parameter “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”.
  • Page 21 Getting Started...

  • Page 22: 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 23 Getting Started #################################################### 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 =” field. During the auto provisioning process, the phone connects to the provisioning server “192.168.1.100”, and downloads the wallpaper image “wallpaper.jpg”. To use the custom wallpaper, you also need to configure the following parameter.
  • Page 24 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 25 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 26 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 27 Getting Started <Data DialNowRule="xxxxxx" LineID=""/> </dialnow> #################################################### Upload dial-now file #################################################### dialplan_dialnow.url = For example, enter “tftp://192.168.1.100/DialNow.xml” in the “dialplan_dialnow.url =” field. During the auto provisioning process, the phone connects to the provisioning server “192.168.1.100”, and downloads the dial-now file “DialNow.xml”. The IP Phones allow you to update firmware manually via web user interface, or update firmware in batch via auto provisioning.
  • Page 28 Yealink SIP-T4X IP Phones Auto Provisioning Guide 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 29: Configuring A Tftp Server

    Configuring a TFTP Server 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 30: Obtaining The Provisioning Server Address

    Yealink SIP-T4X IP Phones Auto Provisioning Guide 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 31 Obtaining the Provisioning Server Address 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. Configure the provisioning server address, authentication user name (optional) and password (optional) in the Auto Provision screen.
  • Page 32 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 33 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 34 Yealink SIP-T4X IP Phones Auto Provisioning Guide Enter the URL, user name and password of the provisioning server in the Server URL, User Name and Password fields (the user name and password are optional). Click Confirm to accept the change.
  • Page 35 Obtaining the Provisioning Server Address...

  • Page 36: Update Mode

    Yealink SIP-T4X IP Phones Auto Provisioning Guide 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 ...
  • Page 37 Update Mode 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. Mark the On radio box in the Repeatedly field.
  • Page 38 Yealink SIP-T4X IP Phones Auto Provisioning 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 39 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 performs the auto provisioning process when it is powered on and at a specified interval.
  • Page 40 Yealink SIP-T4X IP Phones Auto Provisioning Guide The following figure shows the message flow:...
  • Page 41 Update Mode...

  • Page 42: 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 43 Downloading Configurations Files 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 44: Troubleshooting

    Yealink SIP-T4X IP Phones Auto Provisioning Guide 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 45 Troubleshooting 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 46 Yealink SIP-T4X IP Phones Auto Provisioning Guide 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.

  • Page 47: Appendix

    Appendix...
  • Page 48 Yealink SIP-T4X IP Phones Auto Provisioning Guide 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.
  • Page 49 Appendix 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. A configuration page shows as below: Select Configure FTP Server.
  • Page 50 Yealink SIP-T4X IP Phones Auto Provisioning Guide 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.
  • Page 51 Appendix 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. Place the configuration files to this root directory. Set the security permissions for the HTTP directory folder.
  • Page 52 Yealink SIP-T4X IP Phones Auto Provisioning Guide 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 53 Appendix 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 add the HTTP Server root directory.

  • Page 54: 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 encr ypted communication and secure identification.
  • Page 55 Appendix 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 56 Yealink SIP-T4X IP Phones Auto Provisioning Guide 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...
  • Page 57 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 58 Yealink SIP-T4X IP Phones Auto Provisioning Guide 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...
  • Page 59 Appendix 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. Select TFTP Options from the pull-down list of Filter. Scroll down and double click MS option 66.
  • Page 60 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. You also can add the option 43. The following shows the detailed processes.

  • Page 61: Customizing Ringtone Using Cool Edit Pro

    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. 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.
  • Page 62 Yealink SIP-T4X IP Phones Auto Provisioning Guide 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.
  • Page 63 Appendix 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 64 Yealink SIP-T4X IP Phones Auto Provisioning Guide 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”.
  • Page 65 Appendix 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 defined as IPv4 or IPv4&IPv6, and the network.prima...
  • Page 66 Yealink SIP-T4X IP Phones Auto Provisioning Guide 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...
  • Page 67 Appendix 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 68 Yealink SIP-T4X IP Phones Auto Provisioning Guide 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.
  • Page 69 Appendix 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. It takes effect after reboot. It configures the HTTP port for web Network->...
  • Page 70 Yealink SIP-T4X IP Phones Auto Provisioning Guide 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.
  • Page 71 Appendix .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. Advanced->SNMP from 1 to (for SIP-T46G ->Port (1~65535) 65535 It takes effect after reboot.
  • Page 72 Yealink SIP-T4X IP Phones Auto Provisioning Guide It configures the phone to export log files to a syslog server or the local Settings-> system. syslog.mode 1 or 2 Configuration->Exp 1-Local ort System Log 2-Server The default value is 1. It configures the IP address or domain name of the syslog server when the Settings->...
  • Page 73 Appendix 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) Integer auto_provision Settings->Auto for the phone to check the new .repeat.minut Provision->Interval from 1 to...
  • Page 74 Yealink SIP-T4X IP Phones Auto Provisioning Guide The default value is blank. It configures the password for auto_provision Settings->Auto authentication during auto String .server.passw Provision-> provisioning. ord = Password The default value is blank. It enables or disables the phone to...
  • Page 75 Appendix (X ranges The maximum length of the code is 100 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.
  • Page 76 Yealink SIP-T4X IP Phones Auto Provisioning Guide out. Reserve # in User 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...
  • Page 77 Appendix managements erver.usernam It configures the user name for the Settings->TR069-> phone to authenticate with the ACS. String ACS Username 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 78 Yealink SIP-T4X IP Phones Auto Provisioning Guide 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 0-Disabled nable = Transfer 1-Enabled The default value is 1.
  • Page 79 Appendix It enables or disables the comfortable noise generator. Settings->Voice-> 0-Disabled voice.cng = 0 or 1 Echo Cancellation ->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...
  • Page 80 Yealink SIP-T4X IP Phones Auto Provisioning Guide India, Italy, 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]…...
  • Page 81 Appendix 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" is configured as Custom. voice.tone.bus The value format is F/D or !F/D.
  • Page 82 Yealink SIP-T4X IP Phones Auto Provisioning Guide 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 83 Appendix “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 handset. .spk_vol = from 0 to 15 The default value is 8.
  • Page 84 Yealink SIP-T4X IP Phones Auto Provisioning Guide 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...
  • Page 85 Appendix 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., admin:admin123). It enables or disables the 3-level permissions (admin, var, user).
  • Page 86 Yealink SIP-T4X IP Phones Auto Provisioning Guide 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...
  • Page 87 Appendix 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: 1-Line 1 2-Line 2 3-Line 3 4-Line 4 5-Line 5 6-Line 6...
  • Page 88 Yealink SIP-T4X IP Phones Auto Provisioning Guide 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 =...
  • Page 89 Appendix 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 90 Yealink SIP-T4X IP Phones Auto Provisioning Guide 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...
  • Page 91 Appendix message. The default value is blank. It enables or disables always forward feature. Features->Forward forward.alwa 0-Disabled 0 or 1 &DND->Always ys.enable = Forward->On/Off 1-Enabled The default value is 0. Features->Forward forward.alwa It configures the target number the String &DND->Always ys.target = phone forwards all incoming calls to.
  • Page 92 Yealink SIP-T4X IP Phones Auto Provisioning Guide 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. Forward->Target Features->Forward It configures the waiting ring time forward.no_a...
  • Page 93 Appendix  $model  $firmware  $active_url  $active_user  $active_host  $local  $remote  $display_local  $display_remote  $call_id  Example: action_url. setup_completed = http://192.168.0.20/help.xml?model=$ model It configures the action URL the phone sends after account register. action_url.log_ Features->Action Example: on =...
  • Page 94 Yealink SIP-T4X IP Phones Auto Provisioning Guide 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=$ model It configures the action URL the phone sends when receiving an incoming call.
  • Page 95 Appendix enabled. Forward Example: action_url.always_fwd_on = http://192.168.0.20/help.xml?model=$ model It configures the action URL the phone sends when always forward feature is disabled. Features->Action action_url.alw Example: URL->Close Always ays_fwd_off = Forward action_url.always_fwd_off = http://192.168.0.20/help.xml?model=$ model It configures the action URL the phone sends when busy forward feature is enabled.
  • Page 96 Yealink SIP-T4X IP Phones Auto Provisioning Guide model It configures the action URL the phone sends when performing a transfer. action_url.tran Example: Features->Action sfer_call = URL->Transfer Call action_url.transfer_call = http://192.168.0.20/help.xml?model=$ model It configures the action URL the phone sends when performing a blind transfer.
  • Page 97 Appendix It configures the action URL the phone sends when un-muting a call. action_url.unm Example: Features->Action ute = URL->UnMute action_url.unmute = http://192.168.0.20/help.xml?model=$ model It configures the action URL the phone sends when missing a call. action_url.miss Example: Features->Action ed_call = URL->Missed Call action_url.missed_call = http://192.168.0.20/help.xml?model=$...
  • Page 98 Yealink SIP-T4X IP Phones Auto Provisioning Guide It configures the action URL the phone sends when forwarding an incoming call. action_url.for Features->Action Example: ward_incomin URL->Forward g_call = Incoming Call action_url.forward_incoming_call = http://192.168.0.20/help.xml?model=$ model It configures the action URL the phone sends when rejecting an incoming call.
  • Page 99 Appendix Spanish, Turkish or Portuguese English, Chinese_S, It configures the language of the Chinese_T, phone user interface. Deutsch, The default value is English. French, lang.gui = Turkish, Note: Chinese_S and Chinese_T are Italian, applicable to the SIP-T46G IP phone Polish, only.
  • Page 100 Yealink SIP-T4X IP Phones Auto Provisioning Guide The default value is 0. For DST By Date: Settings ->Time & It configures the time to start DST. Date-> Start Date Value formats are: For DST By Week: Month/Day/Hour (for By Date) ...
  • Page 101 Appendix 2-YYYY-MM-DD 3-DD/MM/YYYY 4-MM/DD/YY 5-DD MMM YYYY 6-WWW DD MMM 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. 0 or 1 p_time = Date->...
  • Page 102 Yealink SIP-T4X IP Phones Auto Provisioning Guide It enables or disables the phone to show the outbound server item on the hotdesking.st login wizard during startup. artup_outboun 0 or 1 0-Disabled d_enable = 1-Enabled The default value is 0. It enables or disables the phone to show the register name item on the hotdesking.ds...
  • Page 103 Appendix 0-Disabled 1-Enabled The default value is 0. distinctive_rin g_tones.alert_i It configures the internal ringer text for Settings->Ring-> nfo.X.text = String distinctive ringtone. Internal Ringer Text (X ranges from 1 to 10.) distinctive_rin It configures the desired ring tone for g_tones.alert_i each text.
  • Page 104 Yealink SIP-T4X IP Phones Auto Provisioning Guide Features->Remote push_xml.serv It configures the URL of the push XML Control-> Push XML er = server. Server IP Address It enables or disables the phone to block displaying the push XML Features->Remote interface when in calling status.
  • Page 105 Appendix (1-15) The value must be larger than the minimum length. The default value is 15. dialplan.area _code.line_id It configures lines applying the area (SIP-T46G: X Settings->Dial code. Line IDs are separated by Number ranges from 1 Plan->Area commas. to 6. Code->Account The default value is blank.
  • Page 106 Yealink SIP-T4X IP Phones Auto Provisioning Guide It configures lines applying the replace Settings->Dial rule. Line IDs are separated by dialplan.repla Number Plan->Replace commas. ce.line_id.X = Rule->Account The default value is blank. remote_phone It configures the access URL of the book.data.X.u...
  • Page 107 Appendix Base which corresponds to the location of the LDAP phone book. Example: ldap.base = dc=yealink,dc=cn The default value is blank. It configures the user name for Directory->LDAP-> accessing the LDAP server. ldap.user = String User Name The default value is blank.
  • Page 108 Yealink SIP-T4X IP Phones Auto Provisioning Guide It configures the LDAP version. ldap.version Directory->LDAP-> 2 or 3 Protocol The default value is 3. It enables or disables the phone to perform an LDAP search when Directory->LDAP-> receiving an incoming call.
  • Page 109 Appendix 0-Phone Mode 1-Custom The default value is 0. Features->Forward features.dnd.o It configures the DND on code when String & DND->DND-> n_code = the DND mode is configured as Phone. DND On Code Features->Forward features.dnd.o It configures the DND off code when String &...
  • Page 110 Yealink SIP-T4X IP Phones Auto Provisioning Guide It enables or disables the phone to automatically answer an incoming intercom call. features.interc Features->Intercom 0 or 1 0-Disabled om.allow = ->Accept Intercom 1-Enabled The default value is 1. It enables or disables the phone to mute the speaker when answering an intercom call.
  • Page 111 Appendix flash_time = 2592000 remote phone book from the remote Search Flash Time phone book server. (Seconds) The default value is 21600. Features->General It configures the hotline number. features.hotlin number Information-> e_number = The default value is blank. Hotline Number It configures the delay time (in Features->General Integer...
  • Page 112 Yealink SIP-T4X IP Phones Auto Provisioning Guide 1-Enabled The default value is 1. It enables or disables headset prior feature. Features->General features.head 0-Disabled 0 or 1 Information-> set_prior = Headset Prior 1-Enabled The default value is 0. It enables or disables dual headset feature.
  • Page 113 Appendix 0-Disabled 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 call on hold. hold_tone.ena 0 or 1 Information->Play 0-Disabled ble = Hold Tone 1-Enabled The default value is 1. It configures the interval (in seconds) features.play_ Features->General...
  • Page 114 Yealink SIP-T4X IP Phones Auto Provisioning Guide the LCD screen. It enables or disables the phone to save the call history. Features->General features.save_ 0-Disabled 0 or 1 Information->Save call_history = Call log 1-Enabled The default value is 1. It enables or disables the IP phone to display the Save Call Log option on features.histo...
  • Page 115 Appendix _mute = mute an active call. Mute 0-Disabled 1-Enabled The default value is 1. It configures the ringer device when the phone receiving an incoming call. features.ringer Features->Audio-> 0-Use Speaker 0, 1 or 2 _device.is_use Ringer Device for 1-Use Headset _headset = Headset 2-Use Headset &...
  • Page 116 Yealink SIP-T4X IP Phones Auto Provisioning Guide nable = call. Alert for BLF Pickup 0-Disabled 1-Enabled The default value is 0. It enables or disables the phone to play an audio alert when the monitored user receives an incoming features.picku Features->Call...
  • Page 117 Appendix key. 0-Disabled 1-Enabled The default value is 0. 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. It enables or disables the server to release the BLA line automatically.
  • Page 118 Yealink SIP-T4X IP Phones Auto Provisioning Guide G726_32 G726_40 It enables or disables the phone to handle the incoming multicast paging Directory-> calls when there is a multicast paging multicast.recei Multicast IP-> call on the phone. ve_priority.en 0 or 1...
  • Page 119 Appendix 1-Enabled The default value is 0. It configures the keypad lock type. phone_setting 0- All Keys Features->Phone .phone_lock .l 0, 1 or 2 1-Function Key Lock-> Keypad ock_key_type Lock Type 2- Menu Key The default value is 0. Features->Phone It configures the password for phone_setting Lock->Phone...
  • Page 120 Yealink SIP-T4X IP Phones Auto Provisioning Guide 120-2min 300-5min 600-10min 1800-30min The default value is 0. Ring1.wav It configures the ringtone when the phone_setting Ring2.wav phone fails to transfer a call. .ring_for_tranf ..Note: Ring 6-8 are applicable to the ailed = Ring8.wav...
  • Page 121 Appendix It configures emergency numbers. phone_setting Phone Features->Phone Emergency numbers are separated by .emergency.n number commas. Lock->Emergency umber = The default value is 120, 911 and 110. It enables or disables T9 predictive phone_setting text in the dialing screen. .search_when 0-Disabled 0 or 1 _dialing_enab...
  • Page 122 Yealink SIP-T4X IP Phones Auto Provisioning Guide lcd_logo.url = It configures the access URL of (for customized logo file. SIP-T42G/T41P only) lcd_logo.dele te = It deletes all customized logo files. (for The valid value is: http://localhost/all. SIP-T42G/T41P only) wallpaper_upl oad.url = It configures the access URL of the wallpaper image.
  • Page 123 Appendix It configures the access URL of the call list. call_list.url = It takes effect after reboot. It configures the access URL of the openvpn.url = openVPN *.tar file. custom_mac_ It configures the access URL of the cfg.url = custom MAC-Oriented CFG file. local_contact.
  • Page 124 Yealink SIP-T4X IP Phones Auto Provisioning Guide The default value is blank. ranges from 1 to 6. SIP-T42G/T41P: X ranges from 1 to 3.) account.X.aut h_name = (SIP-T46G: X It configures the user name for register Account->Register ranges from 1 authentication for account X.
  • Page 125 Appendix account.X.sip_ server.Y.port = (SIP-T46G: X ranges from 1 Integer It configures the port of server Y for Account->Register to 6. account X. ->SIP Server Y from 1 to SIP-T42G/T41P: ->Port 65535 The default value is 5060. X ranges from 1 to 3.
  • Page 126 Yealink SIP-T4X IP Phones Auto Provisioning Guide queries for the transport protocol, port and IP address. The default value is 0. account.X.nap I t specifies the transport protocol the tr_build = phone constructs the SRV query for (SIP-T46G: X when no NAPTR records are returned.
  • Page 127 Appendix 1 to 2.) the DNSTTL configured for the SIP server. 2-registration: the phone will retry to use the primary server when the SIP server’s registration requires renewal. 3-duration: the phone will retry to use the primary server after the timeout defined by the parameter “account.x.failback_timeout”.
  • Page 128 Yealink SIP-T4X IP Phones Auto Provisioning Guide enable = Outbound Proxy Server 0-Disabled (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.out bound_host = It configures the domain name or IP...
  • Page 129 Appendix trust_ctrl = only accept the message from the trusted server for account X. (SIP-T46G: X 0-Disabled ranges from 1 to 6. 1-Enabled SIP-T42G/T41P: The default value is 0. X ranges from 1 to 3.) account.X.ano nymous_call = It enables or disables anonymous call (SIP-T46G: X feature for account X.
  • Page 130 Yealink SIP-T4X IP Phones Auto Provisioning Guide X ranges from 1 to 3.) account.X.reje ct_anonymous It enables or disables anonymous call _call = rejection feature for account X. (SIP-T46G: X Account->Basic-> 0-Disabled ranges from 1 0 or 1 Anonymous Call to 6.
  • Page 131 Appendix The default value is blank. ranges from 1 to 6. SIP-T42G/T41P: X ranges from 1 to 3.) account.X.dnd .off_code = It configures the DND off code for (SIP-T46G: X Features->Forward account X when the DND mode is ranges from 1 String &...
  • Page 132 Yealink SIP-T4X IP Phones Auto Provisioning Guide account.X.bus y_fwd.target It configures the target number the phone forwards incoming calls to Features->Forward (SIP-T46G: X when busy for account X when the call ranges from 1 String & DND->Busy forward mode is configured to to 6.
  • Page 133 Appendix The default value is blank. ranges from 1 to 6. SIP-T42G/T41P: X ranges from 1 to 3. ) account.X.alw ays_fwd.on_c ode = It configures the always forward on Features->Forward code for account X when the call (SIP-T46G: X & DND->Always forward mode is configured to ranges from 1 String...
  • Page 134 Yealink SIP-T4X IP Phones Auto Provisioning Guide 1 to 3. ) account.X.tim eout_fwd.on_c ode = It configures the no answer forward on Features->Forward code for account X when the call (SIP-T46G: X & DND->No forward mode is configured to ranges from 1...
  • Page 135 Appendix SIP-T42G/T41P: X ranges from 1 to 3. ) It configures the source caller identity for presentation when receiving an account.X.cid_ incoming call for account X. source = 0-FROM (SIP-T46G: X Account-> 1-PAI ranges from 1 0, 1, 2, 3, 4 or Advanced->Caller 2-PAI-FROM to 6.
  • Page 136 Yealink SIP-T4X IP Phones Auto Provisioning Guide SIP-T42G/T41P: X ranges from 1 to 3. ) account.X.ses sion_timer.exp ires = It configures the interval (in seconds) Account-> Integer (SIP-T46G: X for refreshing the SIP session for Advanced-> ranges from 1 from 30 to account X.
  • Page 137 Appendix 40, 50 or 60. The default value is 20. (ms) (SIP-T46G: X ranges from 1 to 6. SIP-T42G/T41P: X ranges from 1 to 3. ) account.X.bla _number = (SIP-T46G: X It configures the BLA number for Account-> ranges from 1 account X.
  • Page 138 Yealink SIP-T4X IP Phones Auto Provisioning Guide 1 to 3. ) account.X.dire ct_pickup_cod Account-> It configures the directed pickup code (SIP-T46G: X Advanced-> for account X. ranges from 1 String Directed Call to 6. The default value is blank. Pickup Code...
  • Page 139 Appendix The default value is 0. SIP-T42G/T41P: X ranges from 1 to 3.) account.X.regi It enables or disables the phone to ster_line = carry the line number in the REGISTER (SIP-T46G: X Account-> message for account X. ranges from 1 0 or 1 Advanced->SIP 0-Disabled...
  • Page 140 Yealink SIP-T4X IP Phones Auto Provisioning Guide ranges from 1 to 6. SIP-T42G/T41P: X ranges from 1 to 3.) account.X.blf.s ubscribe_even It specifies the BLF subscription type. (SIP-T46G: X 0-Dialog ranges from 1 0 or 1 1-Presence to 6. The default value is 0.
  • Page 141 Appendix account.X.mus ic_server_uri Account-> (SIP-T46G: X It configures the URI of the Music On ranges from 1 String Advanced->Music Hold server for account X. to 6. Server URI SIP-T42G/T41P: X ranges from 1 to 3.) account.X.dtm It configures the DTMF type for account f.type = (SIP-T46G: X 0-INBAND...
  • Page 142 Yealink SIP-T4X IP Phones Auto Provisioning Guide SIP-T42G/T41P: X ranges from 1 to 3. ) account.X.nat. stun_server = It configures the domain name or IP (SIP-T46G: X IP address address of the STUN server for account ranges from 1 Account->Register or domain to 6.
  • Page 143 Appendix account.X.nat. rport = It enables or disables NAT Rport (SIP-T46G: X feature for account X. Account-> ranges from 1 0-Disabled 0 or 1 to 6. Advanced->Rport 1-Enabled SIP-T42G/T41P: The default value is 0. X ranges from 1 to 3. ) account.X.adv anced.timer_t Account->...
  • Page 144 Yealink SIP-T4X IP Phones Auto Provisioning Guide to 6. SIP-T42G/T41P: X ranges from 1 to 3.) account.X.ring It configures a ringtone for account X. tone.ring_type Example (configure Ring3.wav for Common, account 1): Ring1.wav, (SIP-T46G: X account.1.ringtone.ring_type = Account->Basic-> Ring2.wav, ranges from 1 Ring3.wav...
  • Page 145 Appendix account.X.cod ec.Y.enable = It enables or disables the specified (SIP-T46G: X codec for account X. ranges from 1 0-Disabled to 6. Y ranges 1-Enabled from 1 to 12. 0 or 1 Account->Codecs Example: SIP-T42G/T41P: account.1.codec.2.enable = 1 X ranges from This means that the codec PCMA is 1 to 3.
  • Page 146 Yealink SIP-T4X IP Phones Auto Provisioning Guide 1 to 3.) account.X.co mpact_heade r_enable = It enables or disables the phone to (SIP-T46G: X support compact SIP header for 0 or 1 ranges from 1 account X. to 6. The default value is 0.
  • Page 147 Appendix ranges from 1 to 6. SIP-T42G/T41P: X ranges from 1 to 3.) account.X.acd .initial_state = It specifies the initial call center agent (SIP-T46G: X state. ranges from 1 1-Avaliable 1 or 2 to 6. 2-Unavailable SIP-T42G/T41P: The default value is 1. X ranges from 1 to 3.) account.X.stat...
  • 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