Yealink_SIP T4X_IP_Phones_Auto_Provisioning_Guide_V71_171 Yealink SIP T4X IP Phones Auto Provisioning Guide V71 171
User Manual: Yealink_SIP-T4X_IP_Phones_Auto_Provisioning_Guide_V71_171 Alloy Computer Products - Australia - s
Open the PDF directly: View PDF .
Page Count: 149
Download | |
Open PDF In Browser | View PDF |
Table of Contents i Table of Contents Table of Contents.................................................................. iii Summary of Changes ............................................................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 ............................................................... v Changes for Release 71, Guide Version 71.80 ............................................................... v Introduction ...........................................................................1 Getting Started .....................................................................3 Obtaining Configuration Information ............................................................................. 3 Obtaining Configuration Files ...................................................................................... 3 Obtaining Phone Information ....................................................................................... 3 Managing Configuration Files ........................................................................................ 4 Editing Common CFG File ............................................................................................ 4 Editing MAC-Oriented CFG File .................................................................................. 7 Encrypting Configuration Files ................................................................................... 11 Customizing Resource Files ........................................................................................ 11 Customizing a Ringtone .......................................................................................... 12 Customizing an LCD Language .............................................................................. 12 Customizing an LCD Logo ....................................................................................... 15 Customizing a Wallpaper ........................................................................................ 15 Customizing a Local Contact File ............................................................................ 16 Customizing a Replace Rule File ............................................................................. 18 Customizing a Dial-now File .................................................................................... 19 Updating Firmware ................................................................................................. 20 Configuring a TFTP Server ................................................... 21 Preparing a Root Directory ............................................................................................ 21 Configuring a TFTP Server ............................................................................................. 22 Obtaining the Provisioning Server Address ......................... 23 Zero Touch ...................................................................................................................... 23 iii Yealink SIP-T4X IP Phones Auto Provisioning Guide Plug and Play (PnP) Server ............................................................................................ 24 DHCP Options ................................................................................................................ 25 Phone Flash .................................................................................................................... 26 Update Mode ..................................................................... 29 Power On ........................................................................................................................ 29 Repeatedly ..................................................................................................................... 30 Weekly ............................................................................................................................ 30 Auto Provision Now ........................................................................................................ 31 Multi-mode Mixed ......................................................................................................... 32 SIP NOTIFY Message ..................................................................................................... 32 Downloading Configuration Files......................................... 35 Troubleshooting ................................................................... 37 Glossary .............................................................................. 39 Appendix ............................................................................ 41 Configuring an FTP Server ............................................................................................. 41 Preparing a Root Directory ......................................................................................... 41 Configuring an FTP Server.......................................................................................... 42 Configuring an HTTP Server .......................................................................................... 44 Preparing a Root Directory ......................................................................................... 44 Configuring an HTTP Server ....................................................................................... 44 Configuring a DHCP Server........................................................................................... 47 Customizing a Ringtone Using Cool Edit Pro ................................................................ 54 Customizing a Logo File Using PictureExDemo ............................................................ 55 Description of Configuration Parameters in CFG Files ................................................. 57 iv Summary of Changes This section describes the changes to this guide for each release and guide version. Major updates have occurred to the following section: Customizing an LCD Language on page 12 Customizing an LCD Logo on page 15 Description of Configuration Parameters in CFG Files on page 57 Major updates have occurred to the following section: Customizing an LCD Language on page 12 Description of Configuration Parameters in CFG Files on page 57 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 15 Customizing a Logo File Using PictureExDemo on page 55 Major updates have occurred to the following section: Description of Configuration Parameters in CFG Files on page 57 Major updates have occurred to the following section: Description of Configuration Parameters in CFG Files on page 57 This version is updated to incorporate SIP-T42G as one of the SIP-T4X device models. Major updates have occurred to the following sections: v Yealink SIP-T4X IP Phones Auto Provisioning Guide vi Obtaining Configuration Files on page 3 Customizing Resource Files on page 11 Description of Configuration Parameters in CFG Files on page 57 Summary of Changes vii Introduction Yealink SIP-T4X IP phones are full-featured telephones that can be plugged directly into an IP network and can be used easily without manual configuration. 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. The purpose of this guide is to serve as a basic guidance for provisioning Yealink SIP-T4X IP phones, including: SIP-T46G SIP-T42G SIP-T41P The auto provisioning process outlined in this guide applies to Yealink SIP-T4X IP phones running firmware version 71 or later. 1 Yealink SIP-T4X IP Phones Auto Provisioning Guide 2 Getting Started This section provides instructions on how to get ready for auto provisioning. The auto provisioning process discussed in this guide uses the TFTP server as the provisioning server. To begin the auto provisioning process, the following steps are required: Obtaining Configuration Information Managing Configuration Files Before beginning provisioning, you need to obtain configuration files. There are 2 configuration files both of which are CFG-formatted. We call these two files Common CFG file and MAC-Oriented CFG file. The phone tries to download these CFG files from the server during provisioning. The MAC-Oriented CFG file is only effectual for the specific phone. It uses the 12-digit MAC address of the phone as the file name. For example, if the MAC address of the phone is 0015651130F9, the MAC-Oriented CFG file name must be 0015651130F9.cfg. However, the Common CFG file is effectual for all the phones of the same model. It uses a fixed name “y0000000000XX.cfg” as the file name, where "XX" equals to the hardware version of the phone model. The names of the Common CFG file for SIP-T4X IP phones are: Phone Model Common Configuration File SIP-T46G y000000000028.cfg SIP-T42G y000000000029.cfg 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. 3 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. Ask your system administrator for SIP account information. Auto provisioning enables IP phones to update themselves automatically via downloading Common CFG and MAC-Oriented CFG files. Before beginning provisioning, you may need to edit and customize your configuration files. For more information on configuration parameters in configuration files, refer to Description of Configuration Parameters in CFG Files on page 57. Common CFG file contains configuration parameters which apply to phones with the same model, such as language, time and date. The line beginning with “#” is considered to be a comment. The file header “#!version:1.0.0.1” is not a comment and must be placed in the first line. It cannot be edited or deleted. 4 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. #Configure the transmission mode and the speed of the WAN port. #0-Auto negotiate (default), 1-Full duplex 10Mbps, 2-Full duplex 100Mbps, 3-Half duplex 10Mbps, 4-Half duplex 100Mbps, 5-Full duplex 1000Mbps (not applicable to SIP-T41P); network.internet_port.speed_duplex = #Enable or disable Plug and Play feature; 0-Disabled, 1-Enabled (default) auto_provision.pnp_enable = #Configure the domain name of the PnP server. auto_provision.pnp_domain_name = #Configure the value (manufacturer of the device) of the PnP subscribe message. auto_provision.pnp_event_vendor = #Enable or disable the Power On mode for auto provisioning; #0-Disabled, 1-Enabled (default); auto_provision.mode = #Enable or disable the IP phone to check the new configuration repeatedly. auto_provision.repeat.enable = #Configure the interval (in minutes) for the phone to check new configuration files. It ranges from 1 to 43200, the default value is 1440. auto_provision.repeat.minutes = # Enable or disable the IP phone to check the new configuration weekly. #0-Disabled (default), 1-Enabled; auto_provision.weekly.enable = #Configure the start time of the day for the phone to check new configuration files. The default value is 00:00. #If the desired start time of the day is seven forty-five a.m., the value format is 07:45. auto_provision.weekly.begin_time = #Configure the end time of the day for the phone to check new configuration files. The 5 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. #0-Sunday,1-Monday,2-Tuesday,3-Wednesday,4-Thursday,5-Friday,6-Saturday; #If the desired week is Monday, Tuesday and Wednesday, the value format is 012. auto_provision.weekly.mask = #Configure the URL of the auto provisioning server. auto_provision.server.url = #Configure the user name and password for authentication. auto_provision.server.username = auto_provision.server.password = #Enable or disable DHCP option mode; 0-Disabled, 1-Enabled (default); auto_provision.dhcp_option.enable = #Configure the value (manufacturer of the device) of DHCP option 60. auto_provision.dhcp_option.option60_value = #Configure the custom DHCP option value. It ranges from 128 to 254. auto_provision.dhcp_option.list_user_options = #Set the AES key used for decrypting the Common CFG file auto_provision.aes_key_16.com = #Set the AES key used for decrypting MAC-Oriented CFG file auto_provision.aes_key_16.mac = #Set the language used on the web user interface #The valid values are: English, Chinese_S, Chinese_T, German, Turkish, Portuguese, Spanish, Italian, and French. Chinese_S and Chinese_T are applicable to the SIP-T46G IP phone only. lang.wui = #Set the language used on the LCD screen #The valid values are: English (default), Chinese_S, Chinese_T, Deutsch, French, Turkish, #Italian, Polish, Spanish and Portuguese. Chinese_S and Chinese_T are applicable to the SIP-T46G IP phone only. lang.gui = English # Enable or disable the web server access for HTTPS; 0-Disabled, 1-Enabled (default); 6 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 updated per phone, such as the registration information. 7 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. It cannot be edited or deleted. #Account 1 settings #Enable or disable the account1, 0-Disabled (Default), 1-Enabled account.1.enable = #Configure the label displayed on the LCD screen for account1 account.1.label = #Configure the display name of account 1 account.1.display_name = #Configure the user name and password for register authentication account.1.auth_name = account.1.password = #Configure the register user name account.1.user_name = #Configure the SIP server 1 address and port (5060 by default) account.1.sip_server.1.address = account.1.sip_server.1.port = #Configure the SIP server 2 address and port (5060 by default) account.1.sip_server.2.address = account.1.sip_server.2.port = # Account 2 settings #Enable or disable the account2, 0-Disabled (Default), 1-Enabled account.2.enable = #Configure the label displayed on the LCD screen for account 2 account.2.label = #Configure the display name of account2 account.2.display_name = #Configure the user name and password for register authentication account.2.auth_name = account.2.password = #Configure the register user name 8 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 = #Configure the display name of account3 account.3.display_name = #Configure the user name and password for register authentication account.3.auth_name = account.3.password = #Configure the register user name account.3.user_name = #Configure the SIP server 1 address and port (5060 by default) account.3.sip_server.1.address = account.3.sip_server.1.port = #Configure the SIP server 2 address and port (5060 by default) account.3.sip_server.2.address = account.3.sip_server.2.port = #Account 4-6 is for the SIP-T46G IP phone only. # Account 4 settings #Enable or disable the account4, 0-Disabled (Default), 1-Enabled account.4.enable = #Configure the label displayed on the LCD screen for account 4 account.4.label = #Configure the display name of account4 account.4.display_name = #Configure the user name and password for register authentication account.4.auth_name = account.4.password = 9 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 = account.4.sip_server.2.port = # Account 5 settings #Enable or disable the account5, 0-Disabled (Default) 1-Enabled account.5.enable = # Configure the label displayed on the LCD screen for account 5 account.5.label = #Configure the display name of account5 account.5.display_name = #Configure the user name and password for register authentication account.5.auth_name = account.5.password = #Configure the register user name account.5.user_name = #Configure the SIP server 1 address and port (5060 by default) account.5.sip_server.1.address = account.5.sip_server.1.port = #Configure the SIP server 2 address and port (5060 by default) account.5.sip_server.2.address = account.5.sip_server.2.port = # Account 6 settings #Enable or disable the account6, 0-Disabled (Default), 1-Enabled account.6.enable = #Configure the label displayed on the LCD screen for account 6 account.6.label = #Configure the display name of account6 account.6.display_name = #Configure the user name and password for register authentication account.6.auth_name = account.6.password = 10 Getting Started #Configure the register user name account.6.user_name = #Configure the SIP server 1 address and port (5060 by default) account.6.sip_server.1.address = account.6.sip_server.1.port = #Configure the SIP server 2 address and port (5060 by default) account.6.sip_server.2.address = account.6.sip_server.2.port = #Configure the WAN port type; 0-DHCP (default), 1-PPPoE (for SIP-T46G only), 2-Static IP Address #Require reboot network.internet_port.type = 0 #Configure the static IP address, submask, gateway address and DNS server address. #Require reboot network.internet_port.ip = 192.168.1.10 network.internet_port.mask = 255.255.255.0 network.internet_port.gateway =192.168.1.1 network.primary_ dns= 202.101.103.55 network.secondary_dns = 202.101.103.54 To protect against unauthorized access and tampering of sensitive information (e.g., login passwords, registration information), you can encrypt configuration files using Yealink Configuration Conversion Tool. AES keys must be 16 characters and the supported characters contain: 0 ~ 9, A ~ Z, a ~ z, and the special characters # $ % * +, - . : = ? @ [ ] ^ _ { } ~. For more information on how to encrypt configuration files, refer to Yealink Configuration Conversion Tool User Guide. AES keys must be configured on the phone before the auto provisioning process. AES keys are configurable via web user interface at the path: Settings->Auto Provision->Common AES Key (and MAC-Oriented AES Key). 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 resource files and specify the access URL for the resource files. 11 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. The ringtone file format must be *.wav. The ringtone file uploaded must be within 100KB. #################################################### ## Configure the access URL of the customized ringtone ## #################################################### ringtone.url = #Delete all the custom ringtones uploaded through auto provisioning ringtone.delete = http://localhost/all For example, enter “tftp://192.168.1.100/Ring9.wav” in the “ringtone.url =” field. During the auto provisioning process, the phone connects to the provisioning server “192.168.1.100”, and downloads the ringtone file “Ring9.wav”. For more information on customizing a ringtone file, refer to Customizing a Ringtone Using Cool Edit Pro on page 54. You can modify the language translation for the phone user interface, and add a new language to the phone. To modify or add a language, you need to edit the language file, upload it to the provisioning server, and then specify the access URL in the configuration file. The following table lists available languages and the associated language files for the phone user interface: Available Associated Language Pack Associated Language Pack Language for SIP-T42G/T41P for SIP-T46G English 0.GUI.English.lang Chinese_S / 1.GUI.Chinese_S.lang Chinese_T / 2.GUI.Chinese_T.lang Deutsch 12 lang+English.txt lang-Deutsch.txt 3.GUI.Deutsch.lang French lang-French.txt 4.GUI.French.lang Italian lang-Italian.txt 5.GUI.Italian.lang Polish lang-Polish.txt 6.GUI.Polish.lang Getting Started Available Associated Language Pack Associated Language Pack Language for SIP-T42G/T41P for SIP-T46G Portuguese Spanish Turkish lang-Portuguese.txt 7.GUI.Portuguese.lang lang-Spanish.txt 8.GUI.Spanish.lang lang-Turkish.txt 9.GUI.Turkish.lang To update translation of a built-in language, you should modify translation items in the language file, upload the file to the root directory of the provisioning server, and trigger an auto provisioning process for update. The file name of the language file cannot be changed. To add a new translation language, you should add and edit a new language file named as “X.GUI.Y.lang” for SIP-T46G IP phones or “lang-Y.txt” for SIP-T42G/T41P IP phones, upload the file to the directory of the provisioning server, and trigger an auto provisioning process for update. “X” in the language file name is an integer which starts from 10. “Y” in the language file name means the name of the new added language. For example, you want to add a new translation language “Korean” for SIP-T46G IP phones. The file name of the new added language file is “10.GUI.Korean.lang”. After update, you will find a new language selection named as “Korean” on the phone user interface: Menu->Basic->Language. The following figure shows a portion of the SIP-T46G English language file: You can also define the name of the new added language by editing the parameter “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”. 13 Yealink SIP-T4X IP Phones Auto Provisioning Guide The following figure shows a portion of the SIP-T42G English language file: #################################################### ## Configure the access URL of the LCD language file ## #################################################### gui_lang.url = #Delete all custom languages through auto provision gui_lang.delete = http://localhost/all If you want to add a new language Russian to the phone, configure the parameter “gui_lang.url =” in the configuration file, for example: gui_lang.url = tftp://192.168.1.100/10.GUI.Russian.lang gui_lang.url = tftp://192.168.1.100/lang-Russian.txt ## For SIP-T46G## ##For SIP-T42G/T41P## During the auto provisioning process, the phone connects to the provisioning server “192.168.1.100”, and downloads the language file. After update, you will find a new language selection “Russian” on the phone user interface. Available languages may vary between different firmware versions. Do not rename the language file. 14 Getting Started Logo customization allows unifying the IP phone appearance or displaying a custom image on the idle screen such as a company logo, instead of the default system logo. Logo is applicable to SIP-T42G and SIP-T41P IP phones only. The logo file format must be .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 configuration file: #################################################### ## Configure the access URL of the Logo File ## #################################################### #(For SIP-T42G and SIP-T41P IP phones only) lcd_logo.url = #lcd_logo.delete = =http://localhost/all #Delete all custom logo files lcd_logo.delete = For example, enter “tftp://192.168.1.100/logo.dob” in the “lcd_logo.url =” field. During the auto provisioning process, the phone connects to the provisioning server “192.168.1.100”, and downloads the logo file “logo.dob”. To use the custom logo, you also need to configure the following parameter: #Configure the logo mode (For SIP-T42G and SIP-T41P IP phones only). #0-Disabled, 1-System logo (default), 2-Custom logo phone_setting.lcd_logo.mode = 2 After auto provisioning, you will find that the custom logo appears on the LCD screen. For more information on customizing a logo file, refer to Customizing a Logo File Using PictureExDemo on page 55. Yealink SIP-T46G IP phones allow you to customize the wallpaper displayed on the LCD screen. Wallpaper feature is applicable to the SIP-T46G IP phone only. The following table lists the wallpaper image format and resolution for the SIP-T46G IP phone: Phone Model Wallpaper Image Format Resolution Size SIP-T46G .jpg/.png/.bmp <=480*272 <=5Mbs Upload the wallpaper image to the provisioning server and then specify the access URL in the configuration file: 15 Yealink SIP-T4X IP Phones Auto Provisioning Guide #################################################### ## 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. #Configure the custom image (e.g., wallpaper.jpg) as phone wallpaper. phone_setting.backgrounds = Config:wallpaper.jpg The IP phones allow you to upload contact data in batch via auto provisioning. You can create multiple contacts using the supplied local contact template file. When editing the local contact template file, learn the following: Add groups betweenand . Add local contacts betweenand . When specifying the desired line for the contact, valid values are -1 and 0~5, -1 stands for Auto, and 0~5 stand for line1~line6. When specifying a ringtone for the contact and the group, valid values are Auto, Resource:RingN.wav (system ringtone, integer N ranges from 1 to 8) and Custom:Name.wav (customized ringtone). When specifying the group for the contact, valid values are the group names (existing or added groups). To customize a local contact file: 1. Open the template file using an ASCII editor. 2. For each group that you wish to add, add the following string to the file. Each starts on a separate line:Where: display_name=”” specifies the name of the group. ring=”” specifies the ringtone for this group. 3. For each contact that you wish to add, add the following string to the file. Each starts on a separate line: 16 Getting Started Where: display_name=”” specifies the name of the contact (This value cannot be blank or duplicated). office_number=”” specifies the office number of the contact. mobile_number=”” specifies the mobile number of the contact. other_number=”” specifies the other number of the contact. line=”” specifies the line for the contact. ring=”” specifies the ringtone for the contact. group_id_name=”” specifies the group you want to add the contact to. default_photo=”” specifies the photo for the contact (for SIP-T46G IP phone). 4. Specify the values within double quotes. 5. Save the change. 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: #################################################### ## Upload local contact file ## #################################################### local_contact.data.url = 17 Yealink SIP-T4X IP Phones Auto Provisioning Guide For example, enter “tftp://192.168.1.100/contact.xml” in the “local_contact.data.url =” field. During the auto provisioning process, the phone connects to the provisioning server “192.168.1.100”, and downloads the contact file “contact.xml”. Yealink IP phones support both *.xml and *.csv formats. You can create replace rules directly in the configuration files, or create multiple replace rules using the supplied replace rule template file. The existing replace rules on the phones will be overwritten by the downloaded replace rules. When editing the replace rule template file, learn the following: indicates the start of the template file and indicates the end of the template file. Create replace rules betweenand . When specifying the desired line(s) to apply the replace rule, valid values are 0 and line ID. The digit 0 stands for all lines. Multiple line IDs are separated by comma. At most 100 replace rules can be added to the IP phone. For the basic expression syntax of the replace rule, refer to Yealink phone-specific user guide. To customize a replace rule file: 1. Open the template file using an ASCII editor. 2. For each replace rule you wish to add, add the following string to the file. Each starts on a separate line: Where: Prefix=”” specifies the numbers to be replaced. Replace=”” specifies the alternate string. LineID=”” specifies the desired line(s) for this rule. When you leave it blank or enter 0, this replace rule will apply to all lines. 3. Specify the values within double quotes. 4. Save the change. The following shows an example of the replace rule file:18 Getting Started #################################################### ## Upload replace rule file ## #################################################### dialplan_replace_rule.url = For example, enter “tftp://192.168.1.100/DialPlan.xml” in the “dialplan_replace_rule.url =” field. During the auto provisioning process, the phone connects to the provisioning server “192.168.1.100”, and downloads the replace rule file “DialPlan.xml”. You can create multiple dial-now rules using the supplied dial-now template file. After customizing the dial-now rules, place the dial-now file to the provisioning server and specify the access URL in the configuration files. When editing a dial-now file, learn the following: indicates the start of the template file and indicates the end of the template file. Create dial-now rules betweenand . When specifying the desired line(s) for the dial-now rule, valid values are 0 and line ID. The digit 0 stands for all lines. Multiple line IDs are separated by comma. At most 100 dial-now rules can be added to the IP phone. For the basic expression syntax of the dial-now rule, refer to Yealink phone-specific user guide. To customize a dial-now file: 1. Open the template file using an ASCII editor. 2. For each dial-now rule you wish to add, add the following string to the file. Each starts on a separate line: Where: DialNowRule=””/ rule=”” specifies the dial-now rule. LineID=””/ lines=”” specifies the desired line(s) for this rule. When you leave it blank or enter 0, this dial-now rule will apply to all lines. 3. Specify the values within double quotes. 4. Save the change. The following shows an example of a dial-now file:19 Yealink SIP-T4X IP Phones Auto Provisioning Guide #################################################### ## 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. The firmware names of the SIP-T46G, SIP-T42G and SIP-T41P IP phones are 28.x.x.x.rom, 29.x.x.x.rom and 36.x.x.x.rom (x is replaced by the actual firmware version). To update the phones’ firmware in batch via auto provisioning, ask the distributor for the firmware file, upload it to the provisioning server, and then specify the access URL in the configuration files. #################################################### ## Configure the access URL of the firmware file ## #################################################### firmware.url = For example, enter “tftp://admin:password@192.168.1.100/28.71.0.50.rom” in the “firmware.url =” field. During the auto provisioning process, the phone connects to the provisioning server “192.168.1.100” (“admin” is replaced by the authentication user name and “password” is replaced by the authentication password), and downloads the firmware file “28.71.0.50.rom”. 20 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. We recommend that you use 3CDaemon or TFTPD32 as a TFTP server. 3CDaemo and TFTPD32 are free applications for Windows. You can download 3CDaemon online: http://www.oldversion.com/3Com-Daemon.html and TFTPD32 online: http://tftpd32.jounin.net/. For more instructions on how to configure FTP and HTTP servers, refer to Configuring an FTP Server on page 41 and Configuring an HTTP Server on page 44. To prepare a root directory: 1. Create a TFTP root directory on the local system. 2. Place configuration files to this root directory. 3. Set security permissions for the TFTP directory folder. You need to define a user or a group name, and set the permissions: read, write or modify. Security permissions vary by organizations. An example of configuration on the Windows platform is shown as below: 21 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: 1. Double click 3CDaemon.exe to start the application. A configuration page is shown as below: 2. Select Configure TFTP Server. Click the button to locate the TFTP root directory from the local system: 3. Click the Confirm button to finish configuring the TFTP server. The server URL “tftp://IP/” (Here “IP” means the IP address of the provisioning server, for example, ”tftp://192.168.1.100/”) is where the phone downloads configuration files from. 22 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. The following sections detail the process of each way (take the SIP-T46G IP phone as an example). Zero Touch allows you to configure the network parameters and provisioning server address via phone user interface during startup. This feature is helpful when there is a system failure on the phone. To use Zero Touch, make sure this feature is enabled. To enable the Zero Touch via web user interface: 1. Click on Settings->Auto Provision. 2. Select Enabled from the pull-down list of Zero Active. 3. Configure the waiting time (in seconds) in the Wait Time field. 4. Click Confirm to accept the change. 23 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. Configure the provisioning server address, authentication user name (optional) and password (optional) in the Auto Provision screen. An example of screenshot is shown as below: The IP phones support to obtain the provisioning server address from the PnP server. The phone broadcasts the PnP SUBCRIBE message to obtain the provisioning server address during startup. To use Plug and Play, make sure this feature is enabled. 24 Obtaining the Provisioning Server Address To enable PnP via web user interface: 1. Click on Settings->Auto Provision. 2. Mark the On radio box in the PNP Active field. 3. Click Confirm to accept the change. Any PnP server activated in the network responses with a SIP NOTIFY message, and an address of the provisioning server is contained in the message body. 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. The Option 66 is used to identify the TFTP server. To obtain the provisioning server by a 25 Yealink SIP-T4X IP Phones Auto Provisioning Guide custom DHCP option, make sure the DHCP option is set properly. The custom option must be in accordance with the one defined in the DHCP server. For more information on configuring a DHCP server, refer to Configuring an HTTP Server on page 44. To configure the DHCP option via web user interface: 1. Click on Settings->Auto Provision. 2. Mark the On radio box in the DHCP Active field. 3. Enter the desired value in the Custom Option (128~254) field. 4. Enter the desired value in the DHCP Option Value field. The default value is yealink. 5. 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. To configure the Phone Flash via web user interface: 1. 26 Click on Settings->Auto Provision. Obtaining the Provisioning Server Address 2. 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). 3. Click Confirm to accept the change. 27 Yealink SIP-T4X IP Phones Auto Provisioning Guide 28 Update Mode The update mode is used to set the desired time for the IP phone to perform the auto provisioning process. This chapter introduces the following update modes in detail: Power On Repeatedly Weekly Auto Provision Now Multi-mode Mixed SIP NOTIFY Message When there is an active call on the phone during provisioning, the auto provisioning process will detect the call status in every 30 seconds. If the call is released within 2 hours, the auto provisioning process will be performed normally. Otherwise, the process will be completed, due to timeout. The phone performs the auto provisioning process when the phone is powered on. To activate the power on mode via web user interface: 1. Click on Settings->Auto Provision. 2. Mark the On radio box in the Power On field. 3. Click Confirm to accept the change. 29 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: 1. Click on Settings->Auto Provision. 2. Mark the On radio box in the Repeatedly field. 3. Enter the interval time in the Interval (Minutes) field. 4. Click Confirm to accept the change. The phone performs the auto provisioning process at the fixed time every week. You can configure what time of the day and which day of the week to trigger the phone to perform the auto provisioning process. For example, you can configure the phone to check and update new configuration between 2 to 3 o’clock every Friday and Sunday. To activate the Weekly mode via web user interface: 30 1. Click on Settings->Auto Provision. 2. Mark the On radio box in the Weekly field. 3. Enter the desired time in the Time field. Update Mode 4. Mark one or more radio boxes in the Day of Week field. 5. 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: 1. Click on Settings->Auto Provision. 31 Yealink SIP-T4X IP Phones Auto Provisioning Guide 2. 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. The phone will perform the auto provisioning process when receiving a SIP NOTIFY message which contains the header “Event:check-sync”. If the header of the SIP NOTIFY message contains an additional string “reboot=true”, the phone will reboot immediately and then perform the auto provisioning process. This update mode requires server support. 32 Update Mode The following figure shows the message flow: 33 Yealink SIP-T4X IP Phones Auto Provisioning Guide 34 Downloading Configurations Files Downloading Configuration Files from the Provisioning Server Once obtaining a provisioning server address in one of the ways introduced above, the phone will connect to the provisioning server and download the configuration files. The phone will try to download the Common CFG file first from the provisioning server, and then download the MAC-Oriented CFG file. If resource files need to be updated and the access URLs has been specified in the configuration files, the phone will then try to download and update the resource files. Resolving and Updating the Configurations After downloading, the phone resolves the configuration files, updates the configurations and resource files to the phone flash. Generally, updated configurations will automatically take effect after the auto provisioning process is completed. For update of some specific configurations which require reboot before taking effect, for example, network configurations, the phone will reboot to make the configurations effective after the auto provisioning process is completed. The phone calculates the MD5 values of the downloaded files. If the MD5 values of the Common and MAC-Oriented configuration files are the same as those of the last downloaded configuration files, this means these two configuration files on the provisioning server are not changed. The phone will complete the auto provisioning process without repeated update. This is used to avoid unnecessary restart and impact of phone use. If the configuration files have been AES-encrypted, the phone uses the Common AES key to decrypt the Common CFG file and the MAC-Oriented AES key to decrypt the CFG file after downloading the configuration files. The phone only reboots when there is at least a specific configuration requiring reboot need to be updated during auto provisioning. For more information on the specific configurations which require reboot during provisioning, refer to the section Description of Configuration Parameters in CFG Files on page 57. 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 following shows some examples. 35 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 server. 36 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. Ensure that the provisioning server and network are reachable. Ensure that authentication credentials configured on the phone are correct. Ensure that configuration files exist on the provisioning server. Why does the provisioning server return HTTP 404? Ensure that the provisioning server is properly set up. Ensure that the access URL is correct. Ensure that requested files exist on the provisioning server. Why does the phone display "Network Unavailable"? Ensure that the Ethernet cable is plugged into the Internet port on the phone and the Ethernet cable is not loose. Ensure that the switch or hub in your network is operational. Ensure that the configurations of network are properly set in the configuration files. Why is the permission denied when uploading files to an FTP server? Ensure that the complete path to the root directory of the FTP server is authorized. On the provisioning server, check the file permissions, if necessary, change the file permissions. Why doesn’t the phone obtain the IP address from the DHCP server? Ensure that settings are correct on the DHCP server. Ensure that the phone is configured to obtain the IP address from the DHCP server. Why doesn’t the phone download the ringtone? Ensure that the file format of the ringtone is *.wav 37 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. Ensure that the ringtone file exists on the provisioning server. Why doesn’t the phone update configurations? 38 Ensure that the configuration files are different from the last ones. Ensure that the phone has downloaded the configuration files. Ensure that the parameters are correctly set in the configuration files. 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. Computers that are connected to IP networks must be configured before they can communicate with other hosts. FTP: File Transfer Protocol (FTP) is a standard network protocol used to transfer files from one host to another host over a TCP-based network, such as the Internet. It is often used to upload web pages and other documents from a private development machine to a public web-hosting server. HTTP: The Hypertext Transfer Protocol (HTTP) is an application protocol for distributed, collaborative, hypermedia information systems. HTTP is the foundation of data communication for the World Wide Web. HTTPS: Hypertext Transfer Protocol Secure (HTTPS) is a combination of Hypertext Transfer Protocol (HTTP) with SSL/TLS protocol. It provides encrypted communication and secure identification of a network web server. TFTP: Trivial File Transfer Protocol (TFTP) is a simple protocol to transfer files. It has been implemented on top of the User Datagram Protocol (UDP) using port number 69. AES: Advanced Encryption Standard (AES) is a specification for the encryption of electronic data. URL: A uniform resource locator or universal resource locator (URL) is a specific character string that constitutes a reference to an Internet resource. XML: Extensible Markup Language (XML) is a markup language that defines a set of rules for encoding documents in a format that is both human-readable and machine-readable. 39 Yealink SIP-T4X IP Phones Auto Provisioning Guide 40 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: 1. Create an FTP root directory on the local system. 2. Place the configuration files to this root directory. 3. Set the security permissions for the FTP directory folder. You need to define a user or group name, and set the permissions: read, write, and modify. Security permissions vary by organizations. An example of configuration on the Windows platform is shown as below: 41 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: 1. Double click the 3CDaemon.exe to start the application. 2. Click the FTP Server button on the left of the main page. A configuration page shows as below: 42 3. Select Configure FTP Server. 4. Click the 5. Enter the new authentication user name in the Profile field. 6. Click the Set/Change user’s password button to set the password in the pop-up button to locate the FTP root directory from the local system: Appendix dialogue box. 7. Click the OK button to save. 8. Mark the check boxes of Login, Download and Upload to make sure the FTP user has the login, download and upload permission. 9. Click the Save Profile button to save the settings and finish the configurations. 10. Click the Confirm button to finish configuring the FTP server. The server URL “ftp://username:password@IP/” (Here “IP” means the IP address of the provisioning server, “username” and “password” are the authentication for FTP download. For example, “ftp://admin:123456@192.168.1.100/”) is where the phone downloads configuration files from. 43 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: 1. Create an HTTP root directory on the local system. 2. Place the configuration files to this root directory. 3. Set the security permissions for the HTTP directory folder. You need to define a user or group name and set the permissions: read, write, and modify. Security permissions vary by organizations. An example of configuration on the Windows platform is shown as below: HFS tool is an executable application, so you don’t need to install it. To configure an HTTP server: 1. 44 Download the application file to your local directory, double click the hfs.exe. Appendix The main configuration page is shown as below: 2. Click Menu in the main page and select the IP address of the PC from IP address. 45 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). 3. Right click the icon on the left of the main page, select Add folder from disk to add the HTTP Server root directory. 46 Appendix 4. Locate the root directory from the local system. Select the kind of folder which you want. 5. Check the server URL “http:// IP:Port/” in the “Open in browser” address bar (For example, the server URL ”http:// 10.2.11.101:8088/” is shown on the screenshot) . We recommend that you can fill the server URL in the address bar of the web browser and then presskey 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. For more information on installing and configuring an Apache HTTPS Server, refer to the network resource. This section provides instructions on how to configure a DHCP server for windows using DHCP Turbo. You can download this software online: http://www.tucows.com/preview/265297 and install it following the setup wizard. Before configuring the DHCP Turbo, make sure that: The firewall on the PC is disabled. There is no DHCP server in your local system. To configure the DHCP Turbo: 1. To start the DHCP Turbo application, double click localhost. 47 Yealink SIP-T4X IP Phones Auto Provisioning Guide 2. Click the Login button (the login password is blank) to log in. 3. You can then edit the existing DHCP server, or you can right click localhost and select New Server to add a new DHCP server. 48 Appendix 4. Right click Scopes and select New Scope. 5. Configure the DHCP server name, the DHCP IP range and the subnet mask. 6. Click OK to accept the change. 7. 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. 49 Yealink SIP-T4X IP Phones Auto Provisioning Guide 8. 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 to save the change. 9. Click Named Policies-->Global, right click the blank area on the right of the main page and then select New Option. 50 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. 51 Yealink SIP-T4X IP Phones Auto Provisioning Guide You can add the option 66 via DHCP Turbo. The following shows the detailed processes. 1. Click Named Policies-->Global, right click the blank area on the right of the main page and then select New Option. 52 2. Select TFTP Options from the pull-down list of Filter. 3. Scroll down and double click MS option 66. Appendix 4. Fill the provisioning server address in the input field. 5. Click the OK button to finish setting a custom option. 6. Click to save the change. You also can add the option 43. The following shows the detailed processes. 1. Click Named Policies-->Global, right click the blank area on the right of the main page and then select New Option. 2. Select Standard Options from the pull-down list of Filter. 3. Scroll down and double click 43. 53 Yealink SIP-T4X IP Phones Auto Provisioning Guide 4. Fill the provisioning server address in the input field. 5. Click the OK button to finish setting a custom option. 6. 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. To customize a ringtone using Cool Edit Pro: 54 1. Open the Cool Edit Pro application. 2. Click File to open an audio file. 3. Locate the ringtone file, click Open, the file is uploaded as follows. Appendix A sample audio file loaded is shown as below: 4. Select and copy the audio waveform. 5. Select File->New to create a new file, set the channels as Mono, the sample rate as 8000 and the resolution as 16-bit. 6. Paste the audio waveform to the new file. 7. Select File->Save as to save the new audio file. On the Save waveform page, select the file format as A/mu-law wave. The original picture format must be *.bmp or *.gif. We recommend placing all files and the PictureExDemo application to the root directory of the PC. 55 Yealink SIP-T4X IP Phones Auto Provisioning Guide 1. Double click the PictureExDemo.exe. 2. Click Add button to open a *.bmp or *.gif file. You can repeat the second step to add multiple original picture files. 3. Click the Convert button. Then you can find the DOB logo files in the adv directory. 56 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”. Parameter Permitted Descriptions Values Web Setting Path It configures the IP address mode. 0-IPv4 network.ip_ad dress_mode = 0, 1 or 2 1-IPv6 2-IPv4&IPv6 Network->Internet Port->Mode(IPv4/IP v6) The default value is 0. It takes effect after reboot. It configures the internet port type for IPv4 when the IP address mode is configured as IPv4 or IPv4&IPv6. network.intern et_port.type = 0-DHCP 0, 1 or 2 1-PPPoE Network->IPv4 Config 2-Static IP Address The default value is 0. It takes effect after reboot. It configures the IPv4 address when the IP address mode is defined as IPv4 or network.intern et_port.ip = IPv4&IPv6, and the Internet (WAN) port IP address type for IPv4 is configured as Static IP Address. The default value is blank. Network->IPv4 Config->Static IP Address->IP Address It takes effect after reboot. It configures the IPv4 subnet mask when the IP address mode is defined as IPv4 or IPv4&IPv6, and the Internet network.intern et_port.mask IP address (WAN) port type for IPv4 is configured as Static IP Address. = The default value is blank. Network->IPv4 Config->Static IP Address->Subnet Mask It takes effect after reboot. network.intern et_port.gatew IP address It configures the IPv4 default gateway Network->IPv4 when the IP address mode is Config->Static IP configured as IPv4 or IPv4&IPv6, and Address-> 57 Yealink SIP-T4X IP Phones Auto Provisioning Guide ay = the Internet (WAN) port type for IPv4 is Gateway 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.prima ry_dns = defined as IPv4 or IPv4&IPv6, and the IP address Internet (WAN) port type for IPv4 is configured as Static IP Address. The default value is blank. Network->IPv4 Config->Static IP Address->Primary DNS It takes effect after reboot. It configures the secondary IPv4 DNS server when the IP address mode is network.secon dary_dns = configured as IPv4 or IPv4&IPv6, and IP address the Internet (WAN) port type for IPv4 is configured as Static IP Address. The default value is blank. Network->IPv4 Config->Static IP Address-> Secondary DNS It takes effect after reboot. network.pppo It configures the user name for PPPoE e.user = connection. (for SIP-T46G String The default value is blank. only) It takes effect after reboot. network.pppo It configures the password for PPPoE e.password = connection. (for SIP-T46G String only) The default value is blank. It takes effect after reboot. Network->IPv4 Config->PPPoE-> User Name Network->IPv4 Config->PPPoE-> Password It configures the Internet (WAN) port type for IPv6 when the IP address mode is configured as IPv6 or network.ipv6_i nternet_port.ty IPv4&IPv6. 0 or 1 pe = 0-DHCP Network->IPv6 Config 1-Static IP Address The default value is 0. It takes effect after reboot. It configures the IPv6 prefix when the IP network.ipv6_ prefix = Integer from 0 to 128 address mode is configured as IPv6 or IPv4&IPv6, and the Internet (WAN) port type for IPv6 is configured as Static IP Address. 58 Network->IPv6 Config->Static IP Address->IPv6 Prefix (0~128) 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 or IPv4&IPv6, and the Internet (WAN) network.ipv6_i nternet_port.i IP address port type for IPv6 is configured as Static IP Address. p= The default value is blank. Network->IPv6 Config->Static IP Address->IP Address It takes effect after reboot. It configures the IPv6 default gateway when the IP address mode is configured as IPv6 or IPv4&IPv6, and network.ipv6_i nternet_port.g IP address the Internet (WAN) port type for IPv6 is configured as Static IP Address. ateway = The default value is blank. Network->IPv6 Config->Static IP Address-> Gateway It takes effect after reboot. It configures the primary IPv6 DNS server when the IP address mode is configured as IPv6 or IPv4&IPv6, and network.ipv6_ primary_dns IP address the Internet (WAN) port type for IPv6 is configured as Static IP Address. = The default value is blank. Network->IPv6 Config->Static IP Address->Primary DNS It takes effect after reboot. It configures the secondary IPv6 DNS server when the IP address mode is configured as IPv6 or IPv4&IPv6, and network.ipv6_ secondary_dn IP address the Internet (WAN) port type for IPv6 is configured as Static IP Address. s= The default value is blank. Network->IPv6 Config->Static IP Address-> Secondary DNS It takes effect after reboot. It enables or disables the phone to obtain the IPv6 network settings from network.ipv6_i cmp_v6.enabl the ICMPv6. 0 or 1 e= 0-Disabled 1-Enabled Network->Advanc ed->ICMPv6 Status->Active The default value is 1. network.dhcp _host_name = String It specifies the host name the phone Features->General sends via the DHCP option 12. Information->DHCP The default value is: Hostname 59 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. network.pc_p ort.enable = 0 or 1 0-Disabled 1-Enabled The default value is 1. It configures the transmission mode and transmission speed of the Internet (WAN) port. 0-Auto negotiate network.intern et_port.speed _duplex = 1-Full duplex 10Mbps 0, 1, 2, 3, 4 or 5 Network->Advanc 2-Full duplex 100Mbps ed->Port Link-> 3-Half duplex 10Mbps WAN Port Link 4-Half duplex 100Mbps 5-Full duplex 1000Mbps (not applicable to SIP-T41P) The default value is 0. It configures the transmission mode and transmission speed of the PC (LAN) port when configured as Router. 0-Auto negotiate network.pc_p ort.speed_dup lex = 1-Full duplex 10Mbps 0, 1, 2, 3, 4 or 5 Network-> 2-Full duplex 100Mbps Advanced->Port 3-Half duplex 10Mbps Link->PC Port Link 4-Half duplex 100Mbps 5-Full duplex 1000Mbps (not applicable to SIP-T41P) The default value is 0. It enables or disables VLAN of the Internet (WAN) port. network.vlan.i nternet_port_e 0 or 1 nable = Network-> 0-Disabled Advanced->VLAN 1-Enabled ->WAN Port The default value is 0. ->Active It takes effect after reboot. network.vlan.i nternet_port_v 60 Integer from 1 to It configures VLAN ID of the Internet Network-> (WAN) port. Advanced->VLAN Appendix id = network.vlan.i nternet_port_p riority = 4094 Integer from 0 to 7 The default value is 1. ->WAN Port->VID It takes effect after reboot. (1-4094) It configures VLAN priority of the Network-> Internet (WAN) port. Advanced->VLAN The default value is 0. ->WAN Port-> It takes effect after reboot. Priority It enables or disables VLAN of the PC (LAN) port. network.vlan. pc_port_enabl 0 or 1 e= 0-Disabled 1-Enabled Network-> Advanced->VLAN ->PC Port->Active The default value is 0. It takes effect after reboot. network.vlan. pc_port_vid = network.vlan. pc_port_priorit y= Integer from 1 to 4094 It configures VLAN ID of the PC (LAN) Network-> port. Advanced->VLAN The default value is 1. ->PC Port->VID It takes effect after reboot. (1-4094) It configures VLAN priority of the PC Integer from 0 to 7 (LAN) port. The default value is 0. It takes effect after reboot. Network-> Advanced->VLAN ->PC Port-> Priority It enables or disables the phone to obtain VLAN settings from the DHCP network.vlan. dhcp_enable 0 or 1 = server. Network-> 0-Disabled Advanced->VLAN 1-Enabled The default value is 1. ->DHCP VLAN-> Active It takes effect after reboot. It configures the DHCP option from which the phone will obtain the VLAN network.vlan. Integer dhcp_option from 128 to = 254 settings. You can configure at most five DHCP options, and separate options by comma. The default value is 132. Network-> Advanced->VLAN ->DHCP VLAN-> Option It takes effect after reboot. wui.http_enab le = 0 or 1 It enables or disables the HTTP Network-> protocol for web server access. Advanced->Web 0-Disabled Server->HTTP 61 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. wui.https_ena ble = 0-Disabled 0 or 1 1-Enabled The default value is 1. Network-> Advanced->Web Server->HTTPS It takes effect after reboot. network.port.h ttp = network.port.h ttps = network.port. max_rtpport = network.port. min_rtpport = network.qos.rt ptos = network.qos.si gnaltos = Integer from 1 to 65535 Integer from 1 to 65535 Integer from 1024 to 65535 Integer from 1024 to 65535 Integer from 0 to 63 Integer from 0 to 63 It configures the HTTP port for web Network-> server access. Advanced->Web The default value is 80. Server->HTTP Port It takes effect after reboot. (1~65535) It configures the HTTPS port for web Network-> server access. Advanced->Web The default value is 443. Server->HTTPS Port It takes effect after reboot. (1~65535) It configures the maximum local RTP Network-> port. Advanced->Local The default value is 11800. RTP Port-> Max RTP It takes effect after reboot. Port (1~65535) It configures the minimum local RTP Network-> port. Advanced->Local The default value is 11780. RTP Port->Min RTP It takes effect after reboot. Port (1~65535) It configures the voice QoS. The default value is 46. It takes effect after reboot. It configures the SIP message QoS. The default value is 26. It takes effect after reboot. Network-> Advanced->Voice QoS->Voice QoS (0~63) Network-> Advanced->Voice QoS->SIP Qos (0~63) It configures the 802.1x mode. network.802_1 x.mode = 0, 1, 2, 3 or 4 0-Disabled 1-EAP-MD5 2-EAP-TLS 62 Network-> Advanced->802.1x ->Mode 802.1x 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.802_1 x.identity = authentication. String The default value is blank. It takes effect after reboot. It configures the password for 802.1x network.802_1 x.md5_passw String ord = authentication. The default value is blank. Network-> Advanced->802.1x ->Identity Network-> Advanced->802.1x ->MD5 Password It takes effect after reboot. It configures the access URL of the root network.802_1 x.root_cert_url URL = certificates when the 802.1x mode is Network-> configured as EAP-TLS, Advanced->802.1x PEAP-MSCHAPV2 or ->CA Certificates EAP-TTLS/EAP-MSCHAPV2. network.802_1 x.client_cert_u It configures the access URL of the URL rl = client certificates when the 802.1x mode is configured as EAP-TLS. Network-> Advanced->802.1x ->Device Certificates It enables or disables VPN feature. 0-Disabled network.vpn_ enable = 0 or 1 Network-> 1-Enabled Advanced->VPN-> The default value is 0. Active It takes effect after reboot. It enables or disables LLDP feature. network.lldp.e nable = 0 or 1 0-Disabled Network-> 1-Enabled Advanced->LLDP-> The default value is 1. Active It takes effect after reboot. It configures the interval (in seconds) network.lldp.p Integer acket_interval from 1 to = 3600 for the phone to broadcast the LLDP request. The default value is 60. It takes effect after reboot. network.snmp 0 or 1 It enables or disables SNMP feature. Network-> Advanced->LLDP-> Packet Interval (1~3600s) Network-> Advanced->SNMP 63 Yealink SIP-T4X IP Phones Auto Provisioning Guide .enable = 0-Disabled ->Active 1-Enabled The default value is 1. It takes effect after reboot. network.snmp .port = Integer from 1 to 65535 It configures the SNMP port. Network-> The default value is 161. Advanced->SNMP It takes effect after reboot. ->Port (0~65535) It configures the IP address(es) of the trusted SNMP server. Multiple IP addresses are separated network.snmp .trust_ip = IP address by space. Network-> The default value is 0.0.0.0. Advanced->SNMP If the value is set to “0.0.0.0”, the ->Trusted Address phone can accept and handle GET requests from any IP address. It takes effect after reboot. It enables or disables the phone to span data packets received in the WAN port to the PC port. If it is network.span_ to_pc_port = 0 or 1 enabled, all packets from WAN port Network-> can be received by PC port. Advanced->Span 0-Disabled to PC->Span to PC 1-Enabled Port The default value is 0. It takes effect after reboot. Network-> sip.reg_surge_ prevention = Integer from 0 to 60 It configures the maximum duration (in Advanced-> seconds) for account register after Registration startup. Random-> The default value is 0. Registration Random (0~60s) It enables or disables the phone to add the MAC address to the User-Agent header. network.sip.ta g_mac_to_ua. enable = 0 or 1 0-Disabled 1-Enabled The default value is 0. It takes effect after reboot. 64 Appendix It configures the phone to export log files to a syslog server or the local system. syslog.mode 1 or 2 1-Local 2-Server Settings-> Configuration->Exp ort System Log The default value is 1. It configures the IP address or domain syslog.server = IP address name of the syslog server when the Settings-> syslog mode is configured as server. Configuration-> The default value is blank. Server Name It takes effect after reboot. It configures the syslog level used to specify the type of syslog information syslog.log_lev el = Integer from 0 to 6 to be exported. Settings-> 0 means no syslog information, and 6 Configuration->Sys means all. tem Log Level The default value is 3. It takes effect after reboot. It enables or disables the power on mode for triggering the auto auto_provision .mode = provisioning process. 0 or 1 0-Disabled 1-Enabled Settings->Auto Provision->Power On The default value is 1. It enables or disables Plug and Play feature. If it is enabled, the phone will broadcast PnP SUBSCRIBE messages auto_provision .pnp_enable 0 or 1 = to obtain a provisioning server Settings->Auto address after startup. Provision->PNP 0-Disabled Active 1-Enabled The default value is 1. It configures the domain name of the auto_provision .pnp_domain_ String PnP server. name = The default value is 224.0.1.75. auto_provision It configures the vendor name of the .pnp_event_v endor = String device. The default value is yealink. 65 Yealink SIP-T4X IP Phones Auto Provisioning Guide It enables or disables the phone to check the new configuration auto_provision .repeat.enabl repeatedly. 0 or 1 e= 0-Disabled 1-Enabled Settings->Auto Provision-> Repeatedly The default value is 0. auto_provision .repeat.minut es = Integer from 1 to 43200 It configures the interval (in minutes) for the phone to check the new configuration repeatedly. The default value is 1440. Settings->Auto Provision->Interval (Minutes) It enables or disables the phone to check the new configuration weekly. auto_provision .weekly.enabl 0 or 1 e= 0-Disabled 1-Enabled Settings->Auto Provision->Weekly The default value is 0. It configures the begin time of the day auto_provision .weekly.begin Time Format _time = Settings->Auto configuration weekly. Provision->Time The default value is 00:00. It configures the end time of day for auto_provision .weekly.end_ti for the phone to check the new Time Format me = the phone to check the new Settings->Auto configuration weekly. Provision->Time The default value is 00:00. It configures the days of the week for the phone to check new configuration 0,1,2,3,4,5,6 auto_provision .weekly.mask = weekly. Example: Settings->Auto auto_provision.weekly.mask = 01 Provision->Day of of these This means that the phone will check Week digits new configuration every Sunday and or a combination Monday. The default value is 0123456. auto_provision .server.url = URL auto_provision .server.userna me = 66 String It configures the URL of the auto Settings->Auto provisioning server. Provision->Server The default value is blank. URL It configures the user name for Settings->Auto authentication during auto Provision->User provisioning. Name Appendix The default value is blank. It configures the password for auto_provision .server.passw String ord = authentication during auto provisioning. The default value is blank. Settings->Auto Provision-> Password It enables or disables the phone to obtain the provisioning server address auto_provision .dhcp_option. by detecting DHCP options. 0 or 1 enable = 0-Disabled 1-Enabled Settings->Auto Provision->DHCP Active The default value is 1. auto_provision .dhcp_option. option60_valu String e= auto_provision .dhcp_option.l ist_user_optio ns = Integer from 128 to 254 It configures the value (vendor name Settings->Auto of the device) of DHCP option 60. Provision->DHCP The default value is yealink. Option Value It configures the custom DHCP option Settings->Auto for the provisioning server address. Provision->Custom The default value is blank. Option (128~254) It configures the AES key (16 characters) for decrypting the auto_provision .aes_key_16.c Common CFG file. String om = The valid characters contain: 0 ~ 9, A ~ Z, a ~ z,#$%*+,-.:=?@[]^_{}~. Settings->Auto Provision-> Common AES Key The default value is blank. It configures the AES key (16 auto_provision .aes_key_16.m String ac = characters) for decrypting the Settings->Auto MAC-Oriented CFG file. The valid Provision-> characters contain: 0 ~ 9, A ~ Z, a ~ MAC-Oriented AES z,#$%*+,-.:=?@[]^_{}~. Key The default value is blank. autoprovision. It configures the name for the auto X.name = provisioning. (X ranges from 1 to 50.) String The maximum length of the name is 100 characters. (for SIP-T46G The default value is blank. only) It takes effect after reboot. autoprovision. X.code = String It configures the code to trigger auto provisioning. 67 Yealink SIP-T4X IP Phones Auto Provisioning Guide (X ranges The maximum length of the code is 100 from 1 to 50.) characters. Valid characters are digits, (for SIP-T46G # and *. only) Example: autoprovision.1.code = *99 The default value is blank. It takes effect after reboot. autoprovision. X.url = (X ranges from 1 to 50.) It configures the URL of auto provisioning server. URL The default value is blank. It takes effect after reboot. (for SIP-T46G only) autoprovision. It configures the user name for X.user = (X ranges from 1 to 50.) authentication during auto String The default value is blank. (for SIP-T46G It takes effect after reboot. only) autoprovision. It configures the password for X.password = (X ranges from 1 to 50.) authentication during auto String It takes effect after reboot. only) autoprovision. It configures the AES key (16 X.com_aes = from 1 to 50.) characters) for decrypting the String It takes effect after reboot. only) autoprovision. It configures the AES key (16 X.mac_aes = from 1 to 50.) characters) for decrypting the String It takes effect after reboot. only) _pound = 68 MAC-Oriented CFG file. The default value is blank. (for SIP-T46G sip.use_23_as Common CFG file. The default value is blank. (for SIP-T46G (X ranges provisioning. The default value is blank. (for SIP-T46G (X ranges provisioning. 0 or 1 It enables or disables the phone to Features->General reserve the pound sign when dialing Information-> Appendix out. Reserve # in User 0-Disabled (convert the pound sign Name 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). sip.rfc2543_ho ld = 0 or 1 Features->General 0-Disabled Information->RFC 1-Enabled 2543 Hold The default value is 0. It enables or disables the phone to keep sending SIP messages to the sip.use_out_b ound_in_dialo outbound server in a dialog. 0 or 1 g= Features->General Information->Use 0-Disabled Outbound Proxy In 1-Enabled Dialog The default value is 1. It enables or disables Watch Dog feature. If it is enabled, the phone will reboot watch_dog.en able = 0 or 1 automatically when the system is broken down. 0-Disabled Settings-> Preference->Watch Dog 1-Enabled The default value is 1. It enables or disables redirection feature. If it is enabled, the IP phone will be redirect.enabl e= redirected to the pre-assigned server 0 or 1 for configuration updating during initial bootup. 0-Disabled 1-Enabled The default value is 0. managements It enables or disables TR069 feature. erver.enable 0-Disabled = 0 or 1 1-Enabled (for SIP-T46G The default value is 0. only) It takes effect after reboot. Settings->TR069-> Enable TR069 69 Yealink SIP-T4X IP Phones Auto Provisioning Guide managements erver.usernam e= It configures the user name for the String phone to authenticate with the ACS. It takes effect after reboot. (for SIP-T46G Settings->TR069-> ACS Username only) managements erver.passwor d= It configures the password for the String phone to authenticate with the ACS. It takes effect after reboot. (for SIP-T46G Settings->TR069-> ACS Password only) managements erver.url = (for SIP-T46G It configures the access URL of the URL ACS. It takes effect after reboot. only) Settings->TR069-> ACS URL managements erver.connecti It configures the user name for the on_request_us phone to authenticate the connection ername = String requests. It takes effect after reboot. (for SIP-T46G Settings->TR069-> Connection Request Username only) managements erver.connecti on_request_p assword = String (for SIP-T46G It configures the password for the Settings->TR069-> phone to authenticate the connection Connection requests. Request Password only) managements It enables or disables the phone to erver.periodic report its configuration to the ACS. _inform_enabl 0-Disabled e= 0 or 1 (for SIP-T46G The default value is 1. only) It takes effect after reboot. managements erver.periodic _inform_interv al = (for SIP-T46G only) 70 1-Enabled Settings->TR069-> Enable Periodic Inform It configures the interval (in seconds) Integer from 5 to 42946967295 for the phone to report its configuration Settings->TR069-> to the ACS. Periodic Inform The default value is 60. Interval (seconds) It takes effect after reboot. Appendix It enables or disables the transferee party’s phone to prompt a missed call on the LCD screen before displaying transfer.semi_ attend_tran_e 0 or 1 the caller ID. 0-Disabled nable = Features->Transfer ->Semi-Attend Transfer 1-Enabled The default value is 1. It enables or disables the phone to complete the blind transfer through transfer.blind_ tran_on_hook_ on-hook. 0 or 1 enable = 0-Disabled 1-Enabled Features->Transfer ->Blind Transfer On Hook The default value is 1. It enables or disables the phone to complete the attended transfer transfer.on_ho ok_trans_ena through on-hook. 0 or 1 ble = 0-Disabled 1-Enabled Features->Transfer ->Semi Attend Transfer On Hook The default value is 1. It defines the line key behavior during an active call when user presses the line key and the line key is configured transfer.dsske y_deal_type = 0,1 or 2 as a transfer or BLF key. Features->Transfer 0-New Call ->Transfer Mode 1-Attended Transfer Via Dsskey 2-Blind Transfer The default value is 2. It enables or disables the phone to transfer call to the two parties after a transfer.tran_o thers_after_co local conference call hangup. 0 or 1 nf_enable = Features->Transfer ->Transfer on 0-Disabled Conference Hang 1-Enabled up The default value is 0. It enables or disables the voice activity detection. voice.vad = 0 or 1 Settings->Voice-> 0-Disbaled Echo Cancellation 1-Enabled ->VAD The default value is 0. 71 Yealink SIP-T4X IP Phones Auto Provisioning Guide It enables or disables the comfortable noise generator. voice.cng = 0 or 1 Settings->Voice-> 0-Disabled Echo Cancellation 1-Enabled ->CNG The default value is 1. It enables or disables the echo voice.echo_ca ncellation = 0 or 1 canceller. Settings->Voice-> 0-Disabled Echo Cancellation 1-Enabled ->ECHO The default value is 1. It configures the type of jitter buffer. voice.jib.adap tive = 0 or 1 0-Fixed 1-Adaptive Settings->Voice-> JITTER BUFFER ->Type The default value is 1. voice.jib.min = voice.jib.max = voice.jib.norm al = Integer from 60 to 300 Integer from 60 to 300 Integer from 60 to 300 It configures the minimum delay (in Settings->Voice-> milliseconds) of jitter buffer. JITTER BUFFER -> The default value is 60. Min Delay It configures the maximum delay (in Settings->Voice-> milliseconds) of jitter buffer. JITTER BUFFER The default value is 300. ->Max Delay It configures the normal delay (in Settings->Voice-> milliseconds) of jitter buffer. JITTER BUFFER -> The default value is 120. Normal Custom, Australia, Austria, Brazil, Belgium, China, Czech, voice.tone.cou ntry = Denmark, Finland, France, Germany, Great Britain, Greece, Hungary, Lithuania, 72 It configures the tone type for the phone. The default value is Custom. Settings->Tones-> Select Country Appendix India, Italy, Japan, Mexico, New 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). If the frequency is voice.tone.dia l= String set to 0Hz, it means silence. A tone can Settings->Tones-> be composited at most four different Dial frequencies. Duration: the duration (in milliseconds) of the ring tone, ranges from 0 to 30000ms. The exclamation point (!) can be added optionally, which means the custom tone will be only played once. You can configure at most eight different tones for one condition. Tones are separated by comma (e.g., 250/200, !0/1000, 200+300/500, 600+700+800+1000/2000). voice.tone.rin g= String It customizes the ring-back tone when Settings->Tones-> the parameter "voice.tone.country" is Ring Back 73 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" is configured as Custom. voice.tone.bus y= String The value format is F/D or !F/D. For Settings->Tones-> more information on the value format, Busy refer to the parameter “voice.tone.dial”. The default value is blank. It customizes the tone for network congestion when the parameter "voice.tone.country" is configured as voice.tone.con gestion = Custom. String The value format is F/D or !F/D. For more information on the value format, Settings->Tones-> Congestion refer to the parameter “voice.tone.dial”. The default value is blank. It customizes the call waiting tone when the parameter "voice.tone.country" is configured as voice.tone.call waiting = Custom. String The value format is F/D or !F/D. For more information on the value format, Settings->Tones-> Call Waiting refer to the parameter “voice.tone.dial”. The default value is blank. It customizes the redial tone when the parameter "voice.tone.country" is configured as Custom. voice.tone.dia lrecall = String The value format is F/D or !F/D. For Settings->Tones-> more information on the value format, Dial Recall refer to the parameter “voice.tone.dial”. The default value is blank. 74 Appendix It customizes the tone for call recording when the parameter “voice.tone.country” is configured as Custom. voice.tone.rec ord = String The value format is F/D or !F/D. For more information on the value format, Settings->Tones-> Record refer to the parameter “voice.tone.dial”. The default value is blank. It customizes the info tone when the parameter “voice.tone.country” is configured as Custom. voice.tone.inf o= String The value format is F/D or !F/D. For Settings->Tones-> more information on the value format, Info refer to the parameter “voice.tone.dial”. The default value is blank. It customizes the stutter tone when the parameter “voice.tone.country” is configured as Custom. voice.tone.stut ter = String The value format is F/D or !F/D. For Settings->Tones-> more information on the value format, Stutter refer to the parameter “voice.tone.dial”. The default value is blank. It customizes the message tone when the parameter “voice.tone.country” is configured as Custom. voice.tone.me ssage = (for SIP-T46G String The value format is F/D or !F/D. For Settings->Tones-> more information on the value format, Message refer to the parameter only) “voice.tone.dial”. The default value is blank. It customizes the auto answer tone when the parameter voice.tone.aut oanswer = “voice.tone.country” is configured as String Custom. Settings->Tones-> Auto Answer The value format is F/D or !F/D. For more information on the value format, refer to the parameter 75 Yealink SIP-T4X IP Phones Auto Provisioning Guide “voice.tone.dial”. The default value is blank. voice.handfre e.spk_vol = voice.handset .spk_vol = voice.headset .spk_vol = Integer from 0 to 15 Integer from 0 to 15 Integer from 0 to 15 voice.handfre Integer e.tone_vol = from 0 to 15 voice.handset .tone_vol = voice.headset .tone_vol = voice.side_ton e= voice.ring_vol = voice.group_s pk_vol = Integer from 0 to 15 Integer from 0 to 15 Integer from -48 to 0 Integer from 0 to 15 Integer from 0 to 15 It configures the receiving volume of speaker. The default value is 8. It configures the receiving volume of handset. The default value is 8. It configures the receiving volume of headset. The default value is 8. It configures the dial tone volume of speaker. The default value is 8. It configures the dial tone volume of handset. The default value is 8. It configures the dial tone volume of headset. The default value is 8. It configures the volume of the side tone. The default value is -3. It configures the volume of ringer. The default value is 8. It configures the receiving volume of the group listening mode. The default value is 8. It configures the strategy for ring-back tone. 1-Ignore: the phone plays the mix of voice.call_pre view_mode = defined tone and received RTP for 1, 2 or 3 ring-back tone 2-Force: the phone discards the received RTP and plays the defined tone for ring-back tone. 3-Skip: the phone skips the defined 76 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.trust_c ertificates = connection. 0 or 1 Security->Trusted Certificates->Only 0-Disabled Accept Trusted 1-Enabled Certificates The default value is 1. It specifies the type of certificates the phone used to authenticate the connecting server. security.ca_ce rt = 0, 1 or 2 0-Default certificates 1-Custom certificates 2-All certificates Security->Trusted Certificates->CA Certificates The default value is 0. It takes effect after reboot. It enables or disables the phone to mandatorily validate the CommonName or SubjectAltName of security.cn_val idation = 0 or 1 the certificate received from the Security->Trusted connecting server. Certificates-> 0-Disabled Common Name 1-Enabled Validation The default value is 0. It takes effect after reboot. It specifies the type of certificates for the phone to send for TLS authentication. security.dev_c ert = 0 or 1 Security->Server 0-Default certificates Certificates-> 1-Custom certificates Device Certificates The default value is 0. It takes effect after reboot. security.user_n ame.user = security.user_n ame.admin = String String It configures the user name for web server access. It configures the administrator name for web server access. 77 Yealink SIP-T4X IP Phones Auto Provisioning Guide security.user_n ame.var = String It configures the var name for web server access. It configures the password of the user, security.user_ password = var and administrator. String The valid value format is user Security->Password name:password (e.g., admin:admin123). It enables or disables the 3-level permissions (admin, var, user). security.var_e nable = 0-Disabled 0 or 1 1-Enabled The default value is 0. It takes effect after reboot. custom_softke y_call_failed.u It configures the access URL of the file URL rl = custom_softke y_call_in.url = on the LCD screen when Call failed. It configures the access URL of the file URL It configures the access URL of the file URL url = custom_softke y_dialing.url = for custom soft key layout presented on the LCD screen when Connecting. It configures the access URL of the file URL for custom soft key layout presented on the LCD screen when Dialing. custom_softke y_ring_back.ur for custom soft key layout presented on the LCD screen when Call in. custom_softke y_connecting. for custom soft key layout presented It configures the access URL of the file URL l= for custom soft key layout presented on the LCD screen when Ringback. Settings->Softkey Layout Settings->Softkey Layout Settings->Softkey Layout Settings->Softkey Layout Settings->Softkey Layout It configures the access URL of the custom_softke y_talking.url = URL customized file for the soft key Settings->Softkey presented on the LCD screen when Layout Talking. linekey.X.type It configures the desired feature for = line key X. (SIP-T46G: X ranges from 1 to 27. SIP-T42G/T41P: X ranges from 78 Integer Valid values are: DSSKey->Line 0-N/A (defaults to line key 7-27 for Key->Type SIP-T46G and line key 4-15 for SIP-T42G/T41P) 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 23-Group Pickup 24-Paging 25-Record 27-XML Browser 34-Hot Desking 35-URL Record 38-LDAP 40-Prefix 41-Zero Touch 42-ACD 45-Local Group 50-Keyboard Lock 61-Directory It configures the desired line to apply linekey.X.line = (SIP-T46G: X ranges from 1 Integer from 1 to 6 the key feature. When the key feature is configured to DSSKey->Line Key->Line Local Group or XML Group, this parameter is used to specify the 79 Yealink SIP-T4X IP Phones Auto Provisioning Guide to 27. desired phone book (or group) when SIP-T42G/T41P: multiple phone books (or groups) are X ranges from configured on the IP phone. 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 Line 4-6 are applicable to the SIP-T46G IP phone only. For local group and XML group, valid values are: 1 stands for the first phone book (or group), 2 stands for the second phone book (or group) and so on. linekey.X.valu e= It configures the value of the key (SIP-T46G: X ranges from 1 to 27. feature. String For example, when configuring the key feature to be BLF, it configures the SIP-T42G/T41P: DSSKey->Line Key->Value number of the monitored user. X ranges from 1 to 15.) linekey.X.exte nsion = (SIP-T46G: X ranges from 1 to 27. It configures the pickup code for BLF String feature. The default value is blank. SIP-T42G/T41P: DSSKey->Line Key->Extension X ranges from 1 to 15.) linekey.X.label = (SIP-T46G: X ranges from 1 to 27. SIP-T42G/T41P: 80 It configures the label displaying on String the LCD screen for each line key. The default value is blank. DSSKey->Line Key->Label 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 ranges from 1 to 13. Integer SIP-T42G/T41P: DSSKey-> 23-Group Pickup Programmable 27-XML Browser Key->Type 28-History X ranges from 29-Directory 1 to 11.) 30-Menu 31-Switch Account 32-New SMS (for SIP-T46G only) 33-Status 34-Hot Desking 40-PTT 43-Local Phone Book 45-Local Group 47-XML Directory It configures the desired line to apply the programmable key feature. programablek When the key feature is configured to ey.X.line = Local Group or XML Group, this (SIP-T46G: X ranges from 1 to 13. SIP-T42G/T41P: X ranges from 1 to 11.) Integer from 1 to 6 parameter is used to specify the DSSKey-> desired phone book (or group) when Programmable multiple phone books (or groups) are Key->Line configured on the IP phone. For more information on valid values, refer to the parameter “linekey.X.line”. When the key feature is configured to 81 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 ranges from 1 to 13. String SIP-T42G/T41P: programmable key. DSSKey-> For example, when configuring the key Programmable feature to be Speed Dial, it configures Key->Value the number. X ranges from 1 to 11.) programablek ey.X.label = (X ranges String from 1 to 4.) It configures the label displaying on DSSKey-> the LCD screen for the soft key. Programmable The default value is blank. Key->Label expansion_mo dule.X.key.Y.ty pe = (X ranges Number from 1 to 6. It configures the key feature of the expansion module X key Y. DSSKey-> Ext Key Y ranges from 1 to 40.) expansion_mo dule.X.key.Y.lin e= (X ranges from 1 to 6. It configures the desired line to apply Integer from 1 to 6 the expansion module key feature. Valid values are the same as those of DSSKey->Ext Key the parameter “linekey.X.line”. Y ranges from 1 to 40.) expansion_mo dule.X.key.Y.v alue = (X ranges from 1 to 6. Y ranges from 1 to 40.) (for SIP-T46G only) 82 String It configures the value of the expansion module key. DSSKey->Ext Key Appendix expansion_mo dule.X.key.Y.e xtension = It configures the pickup code for BLF (X ranges from 1 to 6. String feature. 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 from 1 to 6. String Y ranges from the LCD screen of the expansion module for each key. DSSKey->Ext Key The default value is blank. 1 to 40.) (for SIP-T46G only) It enables or disables the page icon and page switch key LED to indicate phone_setting .page_tip = different states of line keys. 0 or 1 0-Disabled 1-Enabled DSSKey->Line key->Enable Page Tips The default value is 0. Default.jpg, 1.png, 2.png, phone_setting .backgrounds = 3.png, It configures the wallpaper displayed on the phone. Example: 4.png, phone_setting.backgrounds = 1.png Settings->Preferenc 5.png, To configure a custom picture (e.g., e->Wallpaper 6.png, custom1.png) to be wallpaper, the 7.png, value format is: Resource:custom1.png 8.png, or The default value is Default.jpg. 9.png It configures the display message on the LCD screen when receiving a 403 phone_setting .show_code40 3= String message. If leaving the field blank, the phone will display the value sent from the server when receiving the 403 83 Yealink SIP-T4X IP Phones Auto Provisioning Guide message. The default value is blank. It enables or disables always forward feature. forward.alwa ys.enable = 0 or 1 Features->Forward 0-Disabled &DND->Always 1-Enabled Forward->On/Off The default value is 0. forward.alwa ys.target = String It configures the target number the phone forwards all incoming calls to. Features->Forward &DND->Always Forward->Target Features->Forward forward.alwa ys.on_code = String It configures the always forward on &DND->Always code. Forward->On Code Features->Forward forward.alwa ys.off_code = String It configures the always forward off &DND->Always code. Forward->Off Code It enables or disables busy forward feature. forward.busy. enable = 0 or 1 Features->Forward 0-Disabled &DND->Busy 1-Enabled Forward->On/Off The default value is 0. forward.busy.t arget = String It configures the target number the Features->Forward phone forwards incoming calls to &DND->Busy when busy. Forward->Target Features->Forward forward.busy. on_code = String It configures the busy forward on code. &DND->Busy Forward->On Code Features->Forward forward.busy. off_code = String It configures the busy forward off code. &DND->Busy Forward->Off Code It enables or disables no answer forward.no_a nswer.enable = 0 or 1 forward feature. 0-Disabled 1-Enabled 84 Features->Forward &DND->No Answer Forward->On/Off Appendix The default value is 0. forward.no_a It configures the target number the Features->Forward phone forwards incoming calls to after &DND->No Answer = a period of ring time. Forward->Target forward.no_a It configures the waiting ring time nswer.target nswer.timeout = String Integer from 0 to 20 String e= Forward->After Ring Times It configures the no answer forward on &DND->No Answer code. Forward->On Code Features->Forward forward.no_a nswer.off_cod The default value is 2. &DND->No Answer Features->Forward forward.no_a nswer.on_cod before forwarding. Features->Forward String e= It configures the no answer forward off &DND->No Answer code. Forward->Off Code It enables or disables the phone to forward incoming calls to the forward.intern ational.enable international number. 0 or 1 = 0-Disabled 1-Enabled Features->General Information->Fwd International The default value is 1. It enables or disables the phone to automatically change the status of the acd.auto_avai lable = ACD agent to available. 0 or 1 0-Disabled Features->ACD-> ACD Auto Available 1-Enabled The default value is 0. It configures the interval (in seconds) acd.auto_avai Integer lable_timer = from 0 to 120 to automatically change the status of the ACD agent to available. The default value is 60. Features->ACD-> ACD Auto Available Timer (0~120s) It configures the action URL the phone sends after startup. action_url.setu p_completed = URL The value format is: http(s)://IP address Features->Action of server/help.xml? variable URL->Setup name=variable value. Completed Valid variable values are: $mac 85 Yealink SIP-T4X IP Phones Auto Provisioning Guide $ip $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 action_url.log_ on = sends after account register. URL Example: Features->Action URL->Registered action_url.log_on = http://192.168.0.20/help.xml?ip=$ip It configures the action URL the phone sends after account unregister. action_url.log_ off = URL Example: Features->Action action_url.log_off = URL->Unregistered http://192.168.0.20/help.xml?model=$ model It configures the action URL the phone sends after register failed. action_url.regi ster_failed = URL Example: action_url.register_failed = Features->Action URL->Register Failed http://192.168.0.20/help.xml?model=$ model It configures the action URL the phone sends when off hook. action_url.off_ hook = URL Example: Features->Action action_url.off_hook = URL->Off Hook http://192.168.0.20/help.xml?model=$ model 86 Appendix It configures the action URL the phone sends when on hook. action_url.on_ hook = URL Example: Features->Action action_url.on_hook = URL->On Hook http://192.168.0.20/help.xml?model=$ model It configures the action URL the phone sends when receiving an incoming action_url.inco ming_call = URL call. Features->Action Example: URL->Incoming action_url.incoming_call = Call http://192.168.0.20/help.xml?model=$ model It configures the action URL the phone sends when placing a call. action_url.out going_call = URL Example: action_url.outgoing_call = Features->Action URL->Outgoing Call http://192.168.0.20/help.xml?model=$ model It configures the action URL the phone sends when establishing a call. action_url.call _established URL = Example: Features->Action action_url.call_established = URL->Established http://192.168.0.20/help.xml?model=$ model It configures the action URL the phone sends when DND feature is enabled. action_url.dnd _on = URL Example: Features->Action action_url.dnd_on = URL->Open DND http://192.168.0.20/help.xml?model=$ model It configures the action URL the phone sends when DND feature is disabled. action_url.dnd _off = URL Example: Features->Action action_url.dnd_off = URL->Close DND http://192.168.0.20/help.xml?model=$ model action_url.alw ays_fwd_on = URL It configures the action URL the phone Features->Action sends when always forward feature is URL->Open Always 87 Yealink SIP-T4X IP Phones Auto Provisioning Guide 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 action_url.alw ays_fwd_off = URL disabled. Features->Action Example: URL->Close Always action_url.always_fwd_off = Forward http://192.168.0.20/help.xml?model=$ model It configures the action URL the phone sends when busy forward feature is action_url.bus y_fwd_on = URL enabled. Features->Action Example: URL->Open Busy action_url.busy_fwd_on = Forward http://192.168.0.20/help.xml?model=$ model It configures the action URL the phone sends when busy forward feature is action_url.bus y_fwd_off = URL disabled. Features->Action Example: URL->Close Busy action_url.busy_fwd_off = Forward http://192.168.0.20/help.xml?model=$ model It configures the action URL the phone sends when no answer forward action_url.no_ answer_fwd_o URL n= feature is enabled. Features->Action Example: URL->Open No action_url.no_answer_fwd_on = Answer Forward http://192.168.0.20/help.xml?model=$ model It configures the action URL the phone sends when no answer forward action_url.no_ answer_fwd_o ff = URL feature is disabled. Example: action_url.no_answer_fwd_off = http://192.168.0.20/help.xml?model=$ 88 Features->Action URL->Close No Answer Forward Appendix model It configures the action URL the phone sends when performing a transfer. action_url.tran sfer_call = URL Example: Features->Action action_url.transfer_call = 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. action_url.blin d_transfer_call URL = Example: Features->Action URL->Blind Transfer action_url.blind_transfer_call = http://192.168.0.20/help.xml?model=$ model It configures the action URL the phone sends when performing an attended action_url.atte nded_transfer URL _call = or a semi-attended transfer. Features->Action Example: URL->Attended action_url.attended_transfer_call = Transfer http://192.168.0.20/help.xml?model=$ model It configures the action URL the phone sends when placing a call on hold. action_url.hol d= URL Example: Features->Action action_url.hold = URL->Hold http://192.168.0.20/help.xml?model=$ model It configures the action URL the phone sends when resuming a held call. action_url.unh old = URL Example: Features->Action action_url.unhold = URL->UnHold http://192.168.0.20/help.xml?model=$ model It configures the action URL the phone sends when muting a call. action_url.mut e= URL Example: Features->Action action_url.mute = URL->Mute http://192.168.0.20/help.xml?model=$ model 89 Yealink SIP-T4X IP Phones Auto Provisioning Guide It configures the action URL the phone sends when un-muting a call. action_url.unm ute = URL Example: Features->Action action_url.unmute = 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 ed_call = URL Example: Features->Action action_url.missed_call = URL->Missed Call http://192.168.0.20/help.xml?model=$ model It configures the action URL the phone sends when terminating a call. action_url.call _terminated = URL Example: Features->Action action_url.call_terminated = URL->Terminated http://192.168.0.20/help.xml?model=$ model It configures the action URL the phone sends when changing the state of the phone from busy to idle. action_url.bus y_to_idle = URL Example: Features->Action URL->Busy to Idle action_url.busy_to_idle = http://192.168.0.20/help.xml?model=$ model It configures the action URL the phone sends when changing the state of the phone from idle to busy. action_url.idle _to_busy = URL Example: Features->Action URL->Idle to Busy action_url.idle_to_busy = http://192.168.0.20/help.xml?model=$ model It configures the action URL the phone sends when changing the IP address of the phone. action_url.ip_c hange = URL Example: action_url.ip_change = http://192.168.0.20/help.xml?model=$ model 90 Features->Action URL->IP Changed Appendix It configures the action URL the phone sends when forwarding an incoming action_url.for ward_incomin URL g_call = call. Features->Action Example: URL->Forward action_url.forward_incoming_call = Incoming Call http://192.168.0.20/help.xml?model=$ model It configures the action URL the phone sends when rejecting an incoming call. action_url.reje ct_incoming_c URL Example: action_url.reject_incoming_call = all = Features->Action URL->Reject Incoming Call http://192.168.0.20/help.xml?model=$ model It configures the action URL the phone sends when answering a new incoming call. action_url.ans wer_new_inco URL Example: action_url.answer_new_incoming_call ming_call = Features->Action URL->Answer New-In Call = http://192.168.0.20/help.xml?model=$ model It configures the action URL the phone sends when finishing transferring a action_url.tran sfer_finished URL = call. Features->Action Example: URL->Transfer action_url.transfer_finished = Finished http://192.168.0.20/help.xml?model=$ model It configures the action URL the phone sends when failing to transfer a call. action_url.tran sfer_failed = URL Example: action_url. transfer_failed = Features->Action URL->Transfer Failed http://192.168.0.20/help.xml?model=$ model English, Chinese_S, lang.wui = Chinese_T, German, French, Italian, It configures the language of the web user interface. Settings-> Note: Chinese_S and Chinese_T are Preference-> applicable to the SIP-T46G IP phone Language only. 91 Yealink SIP-T4X IP Phones Auto Provisioning Guide Spanish, Turkish or Portuguese English, Chinese_S, Chinese_T, lang.gui = It configures the language of the Deutsch, phone user interface. French, The default value is English. Turkish, Note: Chinese_S and Chinese_T are Italian, applicable to the SIP-T46G IP phone Polish, only. Spanish or Portuguese local_time.tim e_zone = String String = local_time.ntp _server1 = local_time.ntp _server2 = local_time.inte rval = Settings-> Time & The default value is +8. Date-> Time Zone It configures the time zone name. local_time.tim e_zone_name It configures the time zone. The default time value is China(Beijing). Settings ->Time & Date-> Time Zone IP address It configures the domain name or IP Settings ->Time & or domain address of the NTP server 1. Date-> Primary name The default value is cn.pool.ntp.org. Server IP address It configures the domain name or IP Settings ->Time & or domain address of the NTP server 2. Date-> Secondary The default value is cn.pool.ntp.org. Server It configures the interval (in seconds) Settings ->Time & for the phone to synchronize local time Date-> with the NTP server. Synchronism The default value is 1000. (1~86400s) name Integer from 15 to 86400 It enables or disables daylight saving time (DST) feature. local_time.su mmer_time = 0-Disabled 0, 1 or 2 1-Enabled 2-Automatic Settings ->Time & Date-> Daylight Saving Time The default value is 2. It configures the way DST works when local_time.dst _time_type = 0 or 1 DST feature is enabled. Settings ->Time & 0-DST By Date Date-> Fixed Type 1-DST By Week 92 Appendix The default value is 0. For DST By Date: Settings ->Time & local_time.star t_time = Time It configures the time to start DST. Date-> Start Date Value formats are: For DST By Week: Month/Day/Hour (for By Date) Settings ->Time & Month/ Day of Week/ Day of Date-> DST Start Week Last in Month/ Hour of Day Month/DST Start (for By Week) Day of Week/ DST The default value is 1/1/0. Start Day of Week Last in Month/ Start Hour of Day Settings ->Time & It configures the time to end DST. Value formats are: local_time.en d_time = Time Date-> End Date (for DST By Date) Settings ->Time & Month/Day/Hour (for By Date) Date-> DST Stop Month/ Day of Week/ Day of Month/DST Stop Week Last in Month/ Hour of Day Day of Week/DST (for By Week) Stop Day of Week The default value is 12/31/23. Last in Month/Stop Hour of Day (for DST By Week) local_time.offs et_time = Integer from -300 to 300 It configures the offset time (in Settings ->Time & minutes). Date->Offset The default value is blank. (minutes) It configures the phone to obtain time from NTP server or manual settings. local_time.ma nual_time_en 0 or 1 able = Settings ->Time & 0- NTP Date->Manual 1- Manual Time The default value is 0. It configures the time format. local_time.tim e_format = 0 or 1 0-12 Hour Settings ->Time & 1-24 Hour Date->Time Format The default value is 1. It configures the date format. local_time.dat e_format = 0, 1, 2, 3, 4, 5 or 6 Valid values are: 0-WWW MMM DD Settings ->Time & Date-> Date Format 1-DD-MMM-YY 93 Yealink SIP-T4X IP Phones Auto Provisioning Guide 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 p_time = 0 or 1 It is only available to the time zone 0. 0-Disabled 1-Enabled The default value is 0. It enables or disables the phone to provide input field of register name on hotdesking.st artup_register _name_enabl the hot desking login wizard during 0 or 1 startup. 0-Disabled e= 1-Enabled The default value is 1. It enables or disables the phone to show the user name item on the login hotdesking.st artup_userna wizard during startup. 0 or 1 me_enable = 0-Disabled 1-Enabled The default value is 1. It enables or disables the phone to show the password item on the login hotdesking.st artup_passwo wizard during startup. 0 or 1 rd_enable = 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 artup_sip_serv er_enable = wizard during startup. 0 or 1 0-Disabled 1-Enabled The default value is 1. 94 Settings ->Time & Date-> DHCP Time Appendix It enables or disables the phone to show the outbound server item on the hotdesking.st artup_outboun login wizard during startup. 0 or 1 d_enable = 0-Disabled 1-Enabled The default value is 0. It enables or disables the phone to show the register name item on the hotdesking.ds skey_register_ name_enable login wizard when pressing the Hot 0 or 1 Desking key. 0-Disabled = 1-Enabled The default value is 0. It enables or disables the phone to show the user name item on the login wizard when pressing the Hot Desking hotdesking.ds skey_usernam 0 or 1 key. 0-Disabled e_enable = 1-Enabled The default value is 1. It enables or disables the phone to show the password item on the login wizard when pressing the Hot Desking hotdesking.ds skey_passwor 0 or 1 key. 0-Disabled d_enable = 1-Enabled The default value is 1. It enables or disables the phone to show the SIP server item on the login wizard when pressing the Hot Desking hotdesking.ds skey_sip_serv 0 or 1 key. 0-Disabled er_enable = 1-Enabled The default value is 1. It enables or disables the phone to hotdesking.ds skey_outboun d_enable = 0 or 1 show the outbound server item on the login wizard when pressing the Hot Desking key. 95 Yealink SIP-T4X IP Phones Auto Provisioning Guide 0-Disabled 1-Enabled The default value is 0. distinctive_rin g_tones.alert_i nfo.X.text = String (X ranges It configures the internal ringer text for Settings->Ring-> distinctive ringtone. Internal Ringer Text from 1 to 10.) distinctive_rin g_tones.alert_i nfo.X.ringer = (X ranges It configures the desired ring tone for Integer from 1 to 8 from 1 to 10.) each text. The value ranges from 1 to 8, each Settings->Ring-> Internal Ringer File digit stands for an appropriate ringtone. It enables or disables the phone to automatically redial the called number when the called party is temporarily auto_redial.en able = 0 or 1 unavailable. 0-Disabled Features->General Information->Auto Redial 1-Enabled The default value is 0. auto_redial.int erval = auto_redial.ti mes = Integer from 1 to 300 Integer from 1 to 300 It configures the interval (in seconds) for the phone to wait before redial. The default value is 10. Features->General Information->Auto Redial Interval (1~300s) It configures the auto redial times Features->General when the called party is temporarily Information->Auto unavailable. Redial Times The default value is 10. (1~300) It enables or disables the zero touch for the phone to perform provisioning zero_touch.en able = during startup. 0 or 1 0-Disabled 1-Enabled Settings->Auto Provision->Zero Active The default value is 0. It configures the duration time (in zero_touch.wa it_time = Integer from 0 to 100 seconds) of the phone displaying the Settings->Auto zero-sp-touch configuration interface Provision->Wait when powered on. Time The default value is 5. 96 Appendix push_xml.serv er = URL It configures the URL of the push XML server. Features->Remote Control-> Push XML Server IP Address It enables or disables the phone to block displaying the push XML push_xml.bloc k_in_calling = interface when in calling status. 0 or 1 0-Disabled 1-Enabled Features->Remote Control->Block XML In Calling The default value is 0. It enables or disables the phone to use the push XML via SIP NOTIFY message. push_xml.sip_ notify = 0 or 1 0-Disabled 1-Enabled Features-> Remote Control->SIP Notify The default value is 0. It configures the IP address of server from which the phone receives the features.actio n_uri_limit_ip = action URI requests. Multiple IP IP addresses or any addresses are separated by comma. If the value of this parameter is configured as “any”, the phone will Features-> Remote Control->Action URI allow IP List receive action URI requests from any IP server. It enables or disables the phone to perform reboot during a call when receiving a specific action URI request features.actio n_uri_reboot_ 0 or 1 about reboot. 0-Disabled now = 1-Enabled The default value is 0. dialplan.area _code.code = dialplan.area _code.min_len = dialplan.area _code.max_le n= Number Integer from 1 to 15 Integer from 1 to 15 It configures the area code. The default value is blank. It configures the minimum length of the number prefixed with the area code. The default value is 1. Settings->Dial Plan->Area Code->Code Settings->Dial Plan->Area Code->Min Length (1-15) It configures the maximum length of Settings->Dial the number prefixed with the area Plan->Area code. Code->Max Length 97 Yealink SIP-T4X IP Phones Auto Provisioning Guide The value must be larger than the (1-15) minimum length. The default value is 15. dialplan.area _code.line_id = It configures lines applying the area (SIP-T46G: X ranges from 1 Number to 6. code. Line IDs are separated by comma. The default value is blank. SIP-T42G/T41P: Settings->Dial Plan->Area Code->Account X ranges from 1 to 3.) dialplan.block Settings->Dial _out.number.X = String (X ranges It configures the block out number. Plan->Block The default value is blank. Out->BlockOut Number X from 1 to 10.) dialplan.block It configures lines applying the block _out.line_id.X = Number (X ranges out rule. Line IDs are separated by comma. The default value is blank. from 1 to 10.) dialplan.dialn ow.rule.X = (X ranges String It configures the dial now rule. The default value is blank. from 1 to 100.) dialplan.dialn It configures lines applying the dial ow.line_id.X = now rule. Line IDs are separated by (X ranges Number from 1 to 100.) The default value is blank. dialplan.repla ce.prefix.X = (X ranges comma. String from 1 to 100.) Settings->Dial Plan->Block Out->Account Settings->Dial Plan->Dial-now-> Rule Settings->Dial Plan->Dial-now-> Account It configures the entered number to be Settings->Dial replaced. Plan->Replace The default value is blank. Rule->Prefix It configures the alternate number to Settings->Dial replace the entered number. Plan->Replace The default value is blank. Rule->Replace dialplan.repla ce.replace.X = (X ranges from 1 to 100.) 98 String Appendix It configures lines applying the replace dialplan.repla ce.line_id.X = Number rule. Line IDs are separated by comma. The default value is blank. remote_phone It configures the access URL of the book.data.X.u rl = URL (X ranges remote phone book. The URL cannot contain the character <>'" \. from 1 to 5.) Settings->Dial Plan->Replace Rule->Account Directory->Remote Phone Book-> Remote URL remote_phone book.data.X.n ame = String (X ranges It configures the display name of the remote phone book item. Directory->Remote Phone Book-> Display Name from 1 to 5.) It enables or disables LDAP feature for the phone. ldap.enable 0 or 1 0-Disabled 1-Enabled Directory->LDAP-> Enable LDAP The default value is 0. It configures the criteria for searching the contact name attributes. ldap.name_filt er = String Example: ldap.name_filter = (|(cn=%)(sn=%)) Directory->LDAP-> LDAP Name Filter The default value is blank. It configures the criteria for searching the contact number attributes. ldap.number_f ilter = Example: String ldap.number_filter = (|(telephoneNumber=%)(mobile=%)(i Directory->LDAP-> LDAP Number Filter pPhone=%)) The default value is blank. ldap.host = IP address It configures the IP address or domain or domain name of the LDAP server. name The default value is blank. Integer ldap.port = ldap.base = from 1 to It configures the port of the LDAP server. 65535 The default value is 389. String It configures the LDAP search base Directory->LDAP-> Server Address Directory->LDAP-> Port Directory->LDAP-> 99 Yealink SIP-T4X IP Phones Auto Provisioning Guide which corresponds to the location of Base the LDAP phone book. Example: ldap.base = dc=yealink,dc=cn The default value is blank. It configures the user name for ldap.user = String accessing the LDAP server. The default value is blank. ldap.passwor d= ldap.max_hits = It configures the password for String accessing the LDAP server. The default value is blank. Integer from 1 to 32000 Directory->LDAP-> User Name Directory->LDAP-> Password It configures the maximum of the search results returned by the LDAP Directory->LDAP-> server. Max Hits (1~32000) The default value is 50. It configures the name attributes of each record to be returned by the LDAP server. ldap.name_at tr = String Directory->LDAP-> Attributes are separated by space. LDAP Name Example: Attributes ldap.name_attr =sn cn The default value is blank. It configures the number attributes of each record to be returned by the LDAP server. ldap.numb_at tr = String Directory->LDAP-> Attributes are separated by space. LDAP Number Example: Attributes ldap.numb_attr = Mobile ipPhone The default value is blank. It configures the display name of the contact record displayed on the LCD screen. ldap.display_ name = String The value of this parameter must start Directory->LDAP-> with “%” symbol. LDAP Display Name Example: ldap.display_name =%cn The default value is blank. 100 Appendix ldap.version = 2 or 3 It configures the LDAP version. Directory->LDAP-> The default value is 3. Protocol It enables or disables the phone to perform an LDAP search when ldap.call_in_lo okup = receiving an incoming call. 0 or 1 0-Disabled 1-Enabled Directory->LDAP-> LDAP Lookup For Incoming Call The default value is 0. It enables or disables the phone to sort the search results in alphabetical order ldap.ldap_sort = or numerical order. 0 or 1 0-Disabled 1-Enabled Directory->LDAP-> LDAP Sorting Results The default value is 0. It configures the return code when DND mode is activated. features.dnd_r 404, 480 or efuse_code = 486 Features->General 404-Not Found Information-> 480-Temporarily Not Available Return Code When 486-Busy Here DND The default value is 480. It configures the return code when refusing a call. features.norm al_refuse_cod e= 404, 480 or 486 Features->General 404-Not Found Information-> 480-Temporarily Not Available Return Code When 486-Busy Here Refuse The default value is 486. features.call_c It enables or disables call completion ompletion_en feature. able = 0-Disabled Information->Call (for SIP-T46G 1-Enabled Completion only) The default value is 0. 0 or 1 Features->General It configures the call forward mode. features.fwd_ mode = 0 or 1 0-Phone 1-Custom Features->Forward & DND->Forward ->Mode The default value is 0. features.dnd_ mode = 0 or 1 It configures the DND mode. Features->Forward & DND->DND-> 101 Yealink SIP-T4X IP Phones Auto Provisioning Guide 0-Phone Mode 1-Custom The default value is 0. features.dnd.o n_code = features.dnd.o ff_code = String String It configures the DND on code when the DND mode is configured as Phone. It configures the DND off code when the DND mode is configured as Phone. Features->Forward & DND->DND-> DND On Code Features->Forward & DND->DND-> DND Off Code It enables or disables the phone to receive the calls from the authorized features.dnd.e mergency_en number when the DND is enabled. 0 or 1 able = 0-Disabled 1-Enabled Features->Forward & DND->DND-> DND Emergency The default value is 0. It configures the authorized number features.dnd.e mergency_aut horized_numb when the DND is enabled. String Multiple numbers are separated by comma. er = The default value is blank. Features->Forward &DND->DND-> DND Authorized Number It enables or disables call waiting feature. call_waiting.e nable = 0 or 1 Features->General 0-Disabled Information->Call 1-Enabled Waiting The default value is 1. It configures the call waiting on code call_waiting.o n_code = String to activate the server-side call waiting feature. The default value is blank. It configures the call waiting off code call_waiting.of f_code = String to deactivate the server-side call waiting feature. The default value is blank. It enables or disables the phone to play the call waiting tone. call_waiting.to ne = 0 or 1 0-Disabled 1-Enabled The default value is 1. 102 Features->Audio-> Call Waiting Tone Appendix It enables or disables the phone to automatically answer an incoming features.interc om.allow = intercom call. 0 or 1 0-Disabled Features->Intercom ->Accept Intercom 1-Enabled The default value is 1. It enables or disables the phone to mute the speaker when answering an features.interc om.mute = intercom call. 0 or 1 0-Disabled Features->Intercom ->Intercom Mute 1-Enabled The default value is 0. It enables or disables the phone to play a warning tone when answering features.interc om.tone = an intercom call. 0 or 1 0-Disabled Features->Intercom ->Intercom Tone 1-Enabled The default value is 1. It enables or disables the phone to barge in an intercom call. features.interc om.barge = 0 or 1 0-Disabled 1-Enabled Features->Intercom ->Intercom Barge The default value is 1. It enables and disables the IP phone to map the keywords in the Alert-info header to the specified Bellcore ring features.alert_ info_tone = 0 or 1 tones. 0-Disabled 1-Enabled The default value is 0. It enables or disables the phone to perform a remote phone book search features.remot e_phonebook. when receiving an incoming call. 0 or 1 enable = Directory->Remote Phone Book-> 0-Disabled Search Remote 1-Enabled Phonebook Name The default value is 0. features.remot Integer e_phonebook. from 120 to It configures the interval (in seconds) Directory->Remote for the phone to update the data of the Phone Book-> 103 Yealink SIP-T4X IP Phones Auto Provisioning Guide flash_time = 2592000 remote phone book from the remote Search Flash Time phone book server. (Seconds) The default value is 21600. features.hotlin e_number = features.hotlin e_delay = number Integer from 0 to 10 It configures the hotline number. The default value is blank. Features->General Information-> Hotline Number It configures the delay time (in Features->General seconds) for the phone to dial out the Information-> hotline number automatically. Hotline Delay The default value of delay time is 4. (0~10s) It enables or disables the phone to suppress the display of DTMF digits. features.dtmf. hide = 0 or 1 0-Disabled 1-Enabled Features->General Information-> Suppress DTMF Display The default value is 0. It enables or disables the IP phone to features.dtmf. hide_delay = 0 or 1 display the DTMF digits for a short Features->General period before displaying as asterisks. Information-> 0-Disabled Suppress DTMF 1-Enabled Display Delay The default value is 0. features.dtmf.r epetition = Integer from 1 to 3 It configures the repetition times for Features->General sending the DTMF packets. Information->DTMF The default value is 3. Repetition It enables or disables the phone to send DTMF sequences for transfer function when pressing the transfer features.dtmf.r eplace_tran = 0 or 1 soft key or the transfer key. 0-Disabled Features->General Information->DTMF Replace Tran 1-Enabled The default value is 0. It configures DTMF sequences to be features.dtmf.t ransfer = sent for transfer key. String It can be consisted of 0-9, A-D, * and #. The default value is blank. Information->Tran Send DTMF features.play_ It enables or disables the phone to Features->General local_dtmf_ton play a local DTMF tone. Information->Play 0-Disabled Local DTMF Tone e_enable= 104 Features->General 0 or 1 Appendix 1-Enabled The default value is 1. It enables or disables headset prior feature. features.head set_prior = 0 or 1 Features->General 0-Disabled Information-> 1-Enabled Headset Prior The default value is 0. It enables or disables dual headset feature. features.head set_training = 0 or 1 Features->General 0-Disabled Information-> 1-Enabled Dual-Headset The default value is 0. features.busy_ tone_delay = It configures the duration time (in 0, 3 or 5 seconds) for the busy tone. The default value is 0. Features->General Information->Busy Tone Delay (Seconds) It enables or disables the phone to send double pound keys by pressing the pound key twice when the pound features.send _pound_key = 0 or 1 key is configured as a send key. 0-Disabled Features->General Information->Send Pound Key 1-Enabled The default value is 0. It configures the "#" or "*" key as a send key. features.poun d_key.mode = 0-Disabled 0, 1 or 2 1-# key 2-* key Features->General Information->Key As Send The default value is 1. It enables or disables the phone to play key tone when pressing the send features.send _key_tone = key. 0 or 1 0-Disabled Features->Audio-> Send Sound 1-Enabled The default value is 1. features.key_t one = 0 or 1 It enables or disables the phone to Features->Audio-> play key tone when pressing any key. Key Tone 105 Yealink SIP-T4X IP Phones Auto Provisioning Guide 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_ hold_tone.ena call on hold. 0 or 1 ble = 0-Disabled 1-Enabled Features->General Information->Play Hold Tone The default value is 1. features.play_ hold_tone.del ay = Integer from 1 to 60 It configures the interval (in seconds) Features->General for playing a hold warning tone. Information->Play The default value is 30. Hold Tone Delay It configures the phone to continue to play the dial tone after inputting the preset numbers in the dialing interface. Example: features.redial _tone = Integer features.redial_tone =125 Features->Audio-> The phone will continue to play dial Redial Tone tone after you enter “125” in the dialing interface. If you leave it blank, the phone will not play dial tone after you enter numbers in the dialing interface. It enables or disables password dial feature for the IP phone. features.pass word_dial.ena 0 or 1 ble = Features->General 0-Disabled Information-> 1-Enabled PswDial The default value is 0. It configures the length of digits to be features.pass word_dial.len Integer gth = hidden. The hidden digits are displayed as asterisks on the LCD screen. Features->General Information-> PswLength It configures the prefix of the password-dial number. features.pass word_dial.pref ix = String For example, configure the prefix to be 12 and the length to be 3, when you want to dial the number 123456, the entered number displays as 12***6 on 106 Features->General Information-> PswPrefix Appendix the LCD screen. It enables or disables the phone to save the call history. features.save_ call_history = 0 or 1 Features->General 0-Disabled Information->Save 1-Enabled Call log The default value is 1. It enables or disables the IP phone to display the Save Call Log option on features.histo ry_save_displ the web user interface. 0 or 1 ay = 0-Disabled 1-Enabled The default value is 1. It enable or disables the IP phone to turn off the power Indicator LED when features.powe r_led_on = it is idle. 0 or 1 0-Disabled 1-Enabled Features->General Information->Close Power Light The default value is 1. features.auto_ answer_delay = Integer from 1 to 4 It configures the delay time (in seconds) of auto answer. The default value is 3. It enables or disables the phone to perform a blind transfer by pressing features.dsske y_blind_tran = the predefined transfer DSS key. 0 or 1 0-Disabled 1-Enabled The default value is 1. features.relog _offtime = Integer from 1 to 1000 It configures the web login timeout (in minutes). The default value is 5. Features->General Information->AutoLogout Time (1~1000min) It enables or disables the phone to make an IP call directly. features.direct _ip_call_enabl 0 or 1 e= Features->General 0-Disabled Information->Allow 1-Enabled IP Call The default value is 1. features.allow 0 or 1 It enables or disables the phone to Features->General Information->Allow 107 Yealink SIP-T4X IP Phones Auto Provisioning Guide _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 _device.is_use 0-Use Speaker 0, 1 or 2 _headset = 1-Use Headset 2-Use Headset & Speaker Features->Audio-> Ringer Device for Headset The default value is 0. It enables or disables the phone to prompt for the administrator password when you long press the OK key to features.factor y_pwd_enabl 0 or 1 reset the phone to factory defaults. 0-Disabled e= 1-Enabled The default value is 0. It enables or disables the phone to display the GPickup soft key when the features.picku p.group_picku phone is in the pre-dialing interface. 0 or 1 p_enable = 0-Disabled 1-Enabled Features->Call Pickup->Group Call Pickup The default value is 0. features.picku p.group_picku String p_code = It configures the group call pickup Features->Call code. Pickup->Group Call The default value is blank. Pickup Code It enables or disables the phone to display the DPickup soft key when the features.picku p.direct_picku phone is in the pre-dialing interface. 0 or 1 p_enable = 0-Disabled 1-Enabled Features->Call Pickup->Directed Call Pickup The default value is 0. features.picku It configures the directed call pickup Features->Call p.direct_picku code. Pickup->Directed The default value is blank. Call Pickup Code String p_code = features.picku p.blf_visual_e 108 It enables or disables the phone to 0 or 1 display a visual alert when the monitored user receives an incoming Features->Call Pickup->Visual Appendix 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 p.blf_audio_e 0 or 1 call. 0-Disabled nable = Features->Call Pickup->Audio Alert for BLF Pickup 1-Enabled The default value is 0. It enables or disables the phone to turn off the BLF key LED when the features.blf_a nd_callpark_i dle_led_enabl monitored user is idle. 0 or 1 e= 0-Disabled 1-Enabled Features->General Information->LED Off in Idle The default value is 0. It enables or disables the power LED indicator when the phone is idle, in the features.idle_t alk_power_le d_flash_enabl pre-dialing screen or during a call. 0 or 1 e= 0-Disabled 1-Enabled The default value is 0. It enables or disables the phone to play the warning tone when receiving features.voice _mail_tone_en a voice mail. 0 or 1 able = 0-Disabled 1-Enabled The default value is 1. It enables or disables the phone to enter into the group listening mode by pressing the speakerphone key when features.grou p_listen_in_tal 0 or 1 it is in talking using the handset. 0-Disabled king_enable = 1-Enabled The default value is 1. features.blf_fil ter_value = 0 or 1 It enables or disables the phone to filter the value configured for the BLF 109 Yealink SIP-T4X IP Phones Auto Provisioning Guide 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 features.blf_lis t_version = NOTIFY message sent by the server. 0 or 1 0-Disabled 1-Enabled The default value is 0. It enables or disables the server to release the BLA line automatically. features.auto_ release_bla_li 0 or 1 ne = 0-Disabled 1-Enabled The default value is 0. It enables or disables the phone with active accounts to play tones in the dialing interface differently from the features.partiti on_tone = 0 or 1 phone with no active accounts. 0-Disabled 1-Enbaled The default value is 0. It enables or disables forward diversion feature. features.fwd_ diversion_ena 0 or 1 ble = Features->General 0- Disabled Information->Diver 1-Enabled sion/History-Info The default value is 1. features.hold_ Integer trans_delay = from 0 to 60 It configures the delay time (in milliseconds) before transferring a call. The default value is 0. PCMU PCMA multicast.code c= G729 It configures the codec of multicast Features->General G722 paging. Information-> The default value is G722. Multicast Codec G723_53 G726_16 G726_24 110 Appendix G726_32 G726_40 It enables or disables the phone to handle the incoming multicast paging multicast.recei ve_priority.en 0 or 1 calls when there is a multicast paging Directory-> call on the phone. Multicast IP-> 0-Disabled able = 1-Enabled Paging Priority Active The default value is 1. multicast.recei ve_priority.pri ority = Integer from 0 to 10 It configures the priority of multicast Directory-> paging calls. Multicast IP-> The default value is 10. Paging Barge It configures the listening multicast IP multicast.listen address and port number for the _address.X.ip_ phone. address = Directory-> The default value is blank. Multicast IP-> (X ranges Example: Listening Address from 1 to 10.) multicast.listen_address.1.ip_address String = 224.5.6.20:10008 multicast.listen It configures the label displayed on the _address.X.la bel = String (X ranges LCD screen when receiving the Directory-> multicast paging. Multicast IP->Label The default value is blank. from 1 to 10) It enables or disables the phone to automatically dial out the entered phone_setting .predial_auto digits in the pre-dialing interface. 0 or 1 dial = 0-Disabled 1-Enabled Settings-> Preference->Live Dialpad The default value is 0. It configures the time (in seconds) for phone_setting .inter_digit_tim e= Integer from 1 to 14 the phone to automatically dial out the Settings-> entered digits without pressing the Preference->Inter send key. Digit Time (1~14s) The default value is 4. phone_setting .lock = 0 or 1 It enables or disables keypad lock Features->Phone feature. Lock->Keypad Lock 0-Disabled Enable 111 Yealink SIP-T4X IP Phones Auto Provisioning Guide 1-Enabled The default value is 0. It configures the keypad lock type. phone_setting .phone_lock .l ock_key_type 0, 1 or 2 = 0- All Keys Features->Phone 1-Function Key Lock-> Keypad 2- Menu Key Lock Type The default value is 0. It configures the password for phone_setting .phone_lock.u Integer nlock_pin = unlocking the keypad. The default value is 123. Features->Phone Lock->Phone Unlock PIN (0~15 Digital) It configures the interval (in seconds) to automatically lock the keypad. Features->Phone from 0 to The default value is 0 (the keypad can Lock->Phone Lock 3600 be locked only by pressing the keypad Time Out (0~3600s) phone_setting Integer .phone_lock.lo ck_time_out = lock key). It configures the ringtone for the phone. Ring1.wav, phone_setting .ring_type = Ring2.wav, …… Ring8.wav Example: Settings-> phone_setting.ring_type = Ring1.wav Preference->Ring The default value is Ring1.wav. Type Note: Ring 6-8 are applicable to the SIP-T46G IP phone only. phone_setting .active_backli ght_level = (for SIP-T46G Integer from 1 to 10 It configures the level of the active backlight intensity. The default value is 8. only) Settings-> Preference-> Backlight On Intensity It configures the phone to go out or phone_setting reduce intensity of the backlight on the .inactive_back light_level = LCD screen after a period of inactivity. 0 or 1 (for SIP-T46G only) Settings-> Preference-> 0-Off Backlight Idle 1-Low Intensity The default value is 1. phone_setting 0, 60, 120, .backlight_tim 300, 600 or e= 1800 It configures the backlight time (in seconds). 0-Always on 60-1min 112 Settings-> Preference-> Backlight Time Appendix 120-2min 300-5min 600-10min 1800-30min The default value is 0. phone_setting .ring_for_tranf ailed = Ring1.wav It configures the ringtone when the Ring2.wav phone fails to transfer a call. .... Ring8.wav Note: Ring 6-8 are applicable to the SIP-T46G IP phone only. It enables or disables the phone to show the logon wizard during startup. phone_setting .logon_wizard 0 or 1 = Features->General 0-Disabled Information-> 1-Enabled Logon Wizard The default value is 0. It enables or disables the phone to deal with the 180 SIP message phone_setting .is_deal180 = received after the 183 SIP message. 0 or 1 0-Disabled 1-Enabled Features->General Information->180 Ring Workaround The default value is 1. phone_setting .dialnow_dela y= Integer from 1 to 14 It configures the delay time (in seconds) for the dial-now rule. The default value is 1. Features->General Information-> Time-Out For Dial-Now Rule. It enables or disables customizing the softkey layout. phone_setting .custom_softke 0 or 1 y_enable = Settings->Softkey 0-Disabled Layout->Custom 1-Enabled Softkey The default value is 0. It configures headset mode precedence during a call. 0-Always use (pressing the phone_setting .headsetkey_ mode = 0 or 1 speakerphone key and picking up the handset are not effective when the headset mode is activated) 1-Use as normal The default value is 1. 113 Yealink SIP-T4X IP Phones Auto Provisioning Guide It configures emergency numbers. phone_setting .emergency.n umber = Phone number Emergency numbers are separated by Features->Phone comma. Lock->Emergency The default value is 120, 911 and 110. It enables or disables T9 predictive phone_setting .search_when _dialing_enab text in the dialing screen. 0 or 1 0-Disabled 1-Enabled le = The default value is 0. It enables or disables recent call in dialing feature. If it is enabled, you can view the super_search. recent_call = 0 or 1 placed calls list when the phone is in the pre-dialing screen. 0-Disabled 1-Enabled The default value is 0. Enables or disables the downgrade of phone firmware from provisioning server. auto_provision .downgrade_ 0 or 1 enable = 0-Disabled 1-Enabled If it is enabled, you can downgrade phone firmware from the provisioning server. firmware.url = URL ringtone.url = URL ringtone.delet e= gui_lang.url = gui_lang.delet e= 114 URL URL It configures the access URL of firmware file. It configures the access URL of the customized ringtone file. It deletes all customized ringtone files. The valid value is: http://localhost/all. It configures the access URL of the language file. It deletes all customized language URL files. The valid value is: http://localhost/all. Directory-> Setting->Recent Call In Dialing Appendix lcd_logo.url = (for SIP-T42G/T41P URL It configures the access URL of customized logo file. only) lcd_logo.dele te = (for URL SIP-T42G/T41P It deletes all customized logo files. The valid value is: http://localhost/all. only) wallpaper_upl oad.url = (for SIP-T46G URL It configures the access URL of the wallpaper image. only) trusted_certific ates.url = trusted_certific ates.delete = server_certific ates.url = server_certific ates.delete = local_contact. data.url = auto_dst.url = dialplan_dialn ow.url = dialplan_repl ace_rule.url = URL URL url = certificate files. The valid value is: http://localhost/all. URL It configures the access URL of the server certificate file. It deletes all uploaded server URL certificate files. The valid value is: http://localhost/all. URL URL URL URL URL n.url = configuration. trusted certificate file. It deletes all uploaded trusted custom_factor y_configuratio It configures the access URL of the URL It configures the access URL of the local contact file. It configures the access URL of the DST Time file. It configures the access URL of the dial-now rule file. It configures the access URL of the replace rule file. It configures the access URL of the customized factory configuration file. It configures the access URL of the customized configuration file. 115 Yealink SIP-T4X IP Phones Auto Provisioning Guide It configures the access URL of the call call_list.url = URL list. It takes effect after reboot. openvpn.url = custom_mac_ cfg.url = URL URL It configures the access URL of the openVPN *.tar file. It configures the access URL of the custom MAC-Oriented CFG file. local_contact. data_photo_t ar.url = URL (for SIP-T46G It configures the access URL of the local contact photo. only) It configures the access URL of the file, web_item_lev el.url = URL which defines 3-level access permissions for web user interface. It takes effect after reboot. directory_setti ng.url = super_search. url = URL URL It configures the access URL of the directory setting file. It configures the access URL of the Search Source List setting file. account.X.ena ble = It enables or disables the account X. (SIP-T46G: X ranges from 1 to 6. 0 or 1 SIP-T42G/T41P: 0-Disabled Account->Register 1-Enabled ->Line Active The default value is 0. X ranges from 1 to 3.) account.X.lab el = (SIP-T46G: X ranges from 1 to 6. It configures the label displayed on the String LCD screen for account X. The default value is blank. SIP-T42G/T41P: Account->Register ->Label X ranges from 1 to 3.) account.X.dis play_name = (SIP-T46G: X 116 String It configures the display name for Account->Register account X. ->Display Name Appendix 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 ranges from 1 to 6. It configures the user name for register String authentication for account X. The default value is blank. SIP-T42G/T41P: Account->Register -> Register Name X ranges from 1 to 3.) account.X.pas sword = (SIP-T46G: X ranges from 1 to 6. It configures the password for register String authentication for account X. The default value is blank. SIP-T42G/T41P: Account->Register ->Password X ranges from 1 to 3.) account.X.use r_name = (SIP-T46G: X ranges from 1 to 6. It configures the register user name for String account X. The default value is blank. SIP-T42G/T41P: Account->Register -> User Name X ranges from 1 to 3.) account.X.sip_ server.Y.addre ss = (SIP-T46G: X ranges from 1 IP address to 6. or domain SIP-T42G/T41P: name It configures the IP address or domain name of server Y for account X. Account->Register ->SIP Server Y ->Server Host X ranges from 1 to 3. Y ranges from 1 to 2.) 117 Yealink SIP-T4X IP Phones Auto Provisioning Guide account.X.sip_ server.Y.port = (SIP-T46G: X ranges from 1 to 6. SIP-T42G/T41P: X ranges from Integer from 1 to 65535 It configures the port of server Y for Account->Register account X. ->SIP Server Y The default value is 5060. ->Port 1 to 3. Y ranges from 1 to 2.) account.X.sip_ server.Y.expire s= (SIP-T46G: X ranges from 1 to 6. SIP-T42G/T41P: Integer from 30 to 2147483647 X ranges from It configures the registration expiration time (in seconds) to SIP server Y for account X. The default value is 3600. Account->Register ->SIP Server Y ->Server Expires 1 to 3. Y ranges from 1 to 2.) account.X.sip_ server.Y.retry_ counts = It configures the times for the phone to (SIP-T46G: X ranges from 1 to 6. SIP-T42G/T41P: Integer from 0 to 20 X ranges from retransmit the request when the SIP Account->Register server Y is unavailable or there is no ->SIP Server Y respond from the SIP server Y for ->Server Retry account X. Counts The default value is 3. 1 to 3. Y ranges from 1 to 2.) It configures the transport type for account.X.tran account X. sport = 0-UDP (SIP-T46G: X ranges from 1 to 6. SIP-T42G/T41P: X ranges from 1 to 3.) 118 1-TCP 0, 1, 2 or 3 2-TLS 3-DNS-NAPTR If it is set to 3 (DNS-NAPTR) and no server port is given, the phone performs the DNS NAPTR and SRV Account->Register ->Transport Appendix 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 ranges from 1 to 6. when no NAPTR records are returned. 0 or 1 0-UDP SIP-T42G/T41P: 1-Multiple Types X ranges from The default value is 0. 1 to 3.) It configures the registration mode for account.X.fall the phone in fallback mode. back.redunda 0-Concurrent registration: the phone ncy_type = registers to the working server and (SIP-T46G: X ranges from 1 0 or 1 to 6. fallback server at the same time. 1-Successive registration: the phone registers to the working server first. SIP-T42G/T41P: When the working server fails, the X ranges from phone registers to the fallback server. 1 to 3.) The default value is 0. account.X.fall It configures the time interval (in back.timeout seconds) for the phone to detect = whether the working server is (SIP-T46G: X ranges from 1 to 6. Integer from 10 to 2147483647 available by sending the registration request after the fallback server takes over the call control. SIP-T42G/T41P: It is only applicable to the successive X ranges from registration mode. 1 to 3.) The default value is 120. account.X.sip_ It configures the way in which the server.Y.failba phone fails back to the primary server ck_mode = for call control when in the failover (SIP-T46G: X mode. ranges from 1 to 6. 0, 1, 2, or 3 0-newRequests: all requests are forwarded to the primary server first, SIP-T42G/T41P: regardless of the secondary server X ranges from that was used. 1 to 3. 1-DNSTTL: the phone will retry to use Y ranges from the primary server after the timeout of 119 Yealink SIP-T4X IP Phones Auto Provisioning Guide 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”. The default value is 0. It configures the time interval (in seconds) for the phone to detect whether the primary server is account.X.sip_ available by sending the registration server.Y.failba request after the secondary server ck_timeout = takes over the call control. (SIP-T46G: X If the value is configured to 0, the IP ranges from 1 Integer to 6. from 0 to SIP-T42G/T41P: 65535 phone does not detect the primary server until a failover occurs. When the value is configured between X ranges from 1 and 59, the phone automatically sets 1 to 3. the time interval to 60. Y ranges from Note: This parameter is only valid 1 to 2.) when the parameter “account.X.sip_server.Y.failback_mode ” is configured to 3. The default value is 3600. 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 ranges from 1 to 6. sending requests to the secondary 0 or 1 server in the failover mode. 0-Disabled SIP-T42G/T41P: 1-Enabled X ranges from The default value is 0. 1 to 3. Y ranges from 1 to 2.) account.X.out bound_proxy_ 120 0 or 1 It enables or disables the phone to use Account->Register the outbound proxy server for account ->Enable Appendix enable = X. Outbound Proxy (SIP-T46G: X 0-Disabled Server 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 = (SIP-T46G: X ranges from 1 to 6. IP address or domain name SIP-T42G/T41P: It configures the domain name or IP address of the outbound proxy server for account X. The default value is blank. Account->Register ->Outbound Proxy Server X ranges from 1 to 3.) account.X.out bound_port = (SIP-T46G: X ranges from 1 to 6. SIP-T42G/T41P: Integer from 1 to 65535 It configures the port of the outbound Account->Register proxy server for account X. ->Outbound Proxy The default value is 5060. Server->Port It configures the voice mail number for Account-> account X. Advanced->Voice The default value is blank. Mail X ranges from 1 to 3.) voice_mail.nu mber.X = (SIP-T46G: X ranges from 1 to 6. String SIP-T42G/T41P: X ranges from 1 to 3.) account.X.pro xy_require = (SIP-T46G: X ranges from 1 to 6. It configures the proxy server for String account X. The default value is blank. SIP-T42G/T41P: Account->Basic-> Proxy Require X ranges from 1 to 3.) account.X.sip_ 0 or 1 It enables or disables the phone to 121 Yealink SIP-T4X IP Phones Auto Provisioning Guide trust_ctrl = only accept the message from the (SIP-T46G: X trusted server for account X. ranges from 1 0-Disabled 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 ranges from 1 to 6. feature for account X. 0 or 1 0-Disabled 1-Enabled SIP-T42G/T41P: Account->Basic-> Anonymous Call The default value is 0. X ranges from 1 to 3.) account.X.sen d_anonymous Enables or disables anonymous _code = code feature for account x. (SIP-T46G: X ranges from 1 0 or 1 to 6. If set to 1 (Enabled), the IP phone Account->Basic-> sends anonymous code to Anonymous Code activate/deactivate the server-side SIP-T42G/T41P: anonymous call feature. X ranges from 1 to 3.) account.X.ano nymous_call_o ncode = (SIP-T46G: X ranges from 1 String to 6. It configures the code for activating Account->Basic-> anonymous call feature for account X. Anonymous The default value is blank. Call->On Code It configures the code for deactivating Account->Basic-> anonymous call feature for account X. Anonymous The default value is blank. Call->Off Code SIP-T42G/T41P: X ranges from 1 to 3.) account.X.ano nymous_call_o ffcode = (SIP-T46G: X ranges from 1 to 6. SIP-T42G/T41P: 122 String Appendix 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 Anonymous Call to 6. 1-Enabled Rejection SIP-T42G/T41P: The default value is 0. ranges from 1 0 or 1 X ranges from 1 to 3.) account.X.ano nymous_reject _oncode = (SIP-T46G: X ranges from 1 String to 6. SIP-T42G/T41P: It configures the code for activating Account->Basic-> anonymous call rejection feature for Anonymous Call account X. Rejection->On The default value is blank. Code It configures the code for deactivating Account->Basic-> anonymous call rejection feature for Anonymous Call account X. Rejection->Off The default value is blank. Code X ranges from 1 to 3.) account.X.ano nymous_reject _offcode = (SIP-T46G: X ranges from 1 String to 6. SIP-T42G/T41P: X ranges from 1 to 3.) account.X.dnd .enable = It enables or disables DND feature for (SIP-T46G: X account X when the DND mode is ranges from 1 configured to “custom”. 0 or 1 Features->Forward & DND->DND 0-Enabled ->Account->DND SIP-T42G/T41P: 1-Disabled Status X ranges from The default value is 0. to 6. 1 to 3.) account.X.dnd .on_code = (SIP-T46G: X String It configures the DND on code for Features->Forward account X when the DND mode is & DND->DND-> configured to “custom”. DND On Code 123 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.dnd .off_code = (SIP-T46G: X It configures the DND off code for ranges from 1 account X when the DND mode is to 6. String configured to “custom”. The default value is blank. SIP-T42G/T41P: Features->Forward & DND->DND ->DND Off Code X ranges from 1 to 3. account.X.alw ays_fwd.enab It enables or disables always forward le = feature for account X when the call forward mode is configured to (SIP-T46G: X ranges from 1 0 or 1 “custom”. to 6. 0-Enabled SIP-T42G/T41P: 1-Disabled X ranges from The default value is 0. Features->Forward & DND->Always Forward->On/Off 1 to 3. ) account.X.alw ays_fwd.targe t= It configures the target number the (SIP-T46G: X ranges from 1 String to 6. phone forwards all incoming calls to for account X. The default value is blank. SIP-T42G/T41P: Features->Forward & DND->Always Forward->Target X ranges from 1 to 3. ) account.X.bus y_fwd.enable It enables or disables busy forward = feature for account X when the call forward mode is configured to (SIP-T46G: X ranges from 1 to 6. 0-Disabled SIP-T42G/T41P: 1-Enabled X ranges from The default value is 0. 1 to 3. ) 124 0 or 1 “custom”. Features->Forward & DND->Busy Forward->On/Off Appendix account.X.bus y_fwd.target It configures the target number the = phone forwards incoming calls to (SIP-T46G: X ranges from 1 String to 6. when busy for account X when the call forward mode is configured to “custom”. SIP-T42G/T41P: Features->Forward & DND->Busy Forward->Target The default value is blank. X ranges from 1 to 3. ) account.X.tim eout_fwd.ena It enables or disables no answer ble = forward feature for account X when (SIP-T46G: X the call forward mode is configured to Features->Forward “custom”. & DND->No ranges from 1 0 or 1 to 6. 0-Disabled SIP-T42G/T41P: 1-Enabled X ranges from The default value is 0. Answer Forward-> On/Off 1 to 3. ) account.X.tim eout_fwd.targ It configures the target number the et = (SIP-T46G: X ranges from 1 String to 6. SIP-T42G/T41P: phone forwards incoming calls to after Features->Forward a period of ring time for account X & DND->No when the call forward mode is Answer Forward-> configured to “custom”. Target The default value is blank. X ranges from 1 to 3. ) account.X.tim eout_fwd.time out = (SIP-T46G: X ranges from 1 to 6. It configures the waiting ring time Integer from 0 to 20 before forwarding for account X when the call forward mode is configured to “custom”. The default value is 2. SIP-T42G/T41P: Features->Forward & DND->No Answer Forward-> After Ring Times X ranges from 1 to 3. ) account.X.alw It configures the always forward off Features->Forward ays_fwd.off_c code for account X when the call & DND->Always forward mode is configured to Forward ->Off “custom”. Code ode = (SIP-T46G: X String 125 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.alw ays_fwd.on_c ode = It configures the always forward on (SIP-T46G: X code for account X when the call ranges from 1 String forward mode is configured to to 6. “custom”. SIP-T42G/T41P: The default value is blank. Features->Forward & DND->Always Forward->On Code X ranges from 1 to 3. ) account.X.bus y_fwd.off_cod e= (SIP-T46G: X ranges from 1 String to 6. SIP-T42G/T41P: It configures the busy forward off code Features->Forward for account X when the call forward & DND->Busy mode is configured to “custom”. Forward ->Off The default value is blank. Code X ranges from 1 to 3. ) account.X.bus y_fwd.on_cod e= It configures the busy forward on code (SIP-T46G: X ranges from 1 String to 6. for account X when the call forward mode is configured to “custom”. The default value is blank. SIP-T42G/T41P: Features->Forward & DND->Busy Forward->On Call X ranges from 1 to 3. ) account.X.tim eout_fwd.off_c It configures the no answer forward off ode = (SIP-T46G: X ranges from 1 to 6. SIP-T42G/T41P: X ranges from 126 code for account X when the call String forward mode is configured to “custom”. The default value is blank. Features->Forward & DND->No Answer Forward ->Off Code Appendix 1 to 3. ) account.X.tim eout_fwd.on_c ode = It configures the no answer forward on (SIP-T46G: X code for account X when the call ranges from 1 String forward mode is configured to to 6. “custom”. SIP-T42G/T41P: The default value is blank. Features->Forward & DND->No Answer Forward ->On Code X ranges from 1 to 3. ) account.X.sip_ listen_port = (SIP-T46G: X ranges from 1 to 6. SIP-T42G/T41P: Integer from 1024 to 65535 It configures the local SIP port for Account-> account X. Advanced->Local The default value is 5060. SIP Port X ranges from 1 to 3. ) account.X.100 rel_enable = It enables or disables 100 reliable (SIP-T46G: X ranges from 1 to 6. retransmission feature for account X. 0 or 1 SIP-T42G/T41P: Account-> 0-Disabled Advanced-> 1-Enabled Retransmission The default value is 0. X ranges from 1 to 3.) account.X.sub scribe_mwi = It enables or disables the phone to (SIP-T46G: X subscribe the message waiting ranges from 1 to 6. indicator for account X. 0 or 1 0-Disabled SIP-T42G/T41P: 1-Enabled X ranges from The default value is 0. Account-> Advanced-> Subscribe for MWI 1 to 3.) account.X.sub scribe_mwi_e xpires = (SIP-T46G: X ranges from 1 Integer from 0 to 84600 It configures the interval (in seconds) of MWI subscription for account X. The default value is 3600. Account-> Advanced->MWI Subscription Period (Seconds) to 6. 127 Yealink SIP-T4X IP Phones Auto Provisioning Guide 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 ranges from 1 to 6. 0, 1, 2, 3, 4 or 5 1-PAI 2-PAI-FROM SIP-T42G/T41P: 3-PRID-PAI-FROM X ranges from 4-PAI-RPID-FROM 1 to 3. ) Account-> Advanced->Caller ID Source 5-RPID-FROM The default value is 0. It enables or disables the phone to process the Privacy header in the 180 account.X.cid_ source_privac or 200 OK message. 0 or 1 y= 0-Disabled 1-Enabled The default value is 1. It enables or disables the phone to process the P-Preferred-Identity account.X.cid_ source_ppi = header. 0 or 1 0-Disabled 1-Enabled The default value is 1. account.X.cp_ It configures the source callee identity source = for presentation for account X. (SIP-T46G: X ranges from 1 to 6. 0-RPID-FROM 0, 1 or 2 1-Dialed Digits SIP-T42G/T41P: 2-RFC4916 X ranges from The default value is 1. 1 to 3. ) account.X.ses It enables or disables the session timer sion_timer.ena ble = (SIP-T46G: X ranges from 1 to 6. 128 for account X. 0 or 1 Account-> 0-Disabled Advanced-> 1-Enabled Session Timer The default value is 0. Appendix SIP-T42G/T41P: X ranges from 1 to 3. ) account.X.ses sion_timer.exp ires = (SIP-T46G: X ranges from 1 to 6. Integer from 30 to 7200 SIP-T42G/T41P: It configures the interval (in seconds) Account-> for refreshing the SIP session for Advanced-> account X. Session Expires The default value is 1800. (30~7200s) X ranges from 1 to 3. ) account.X.ses sion_timer.refr It configures the refresher of the esher = session timer for account X. (SIP-T46G: X Account-> 0-Uac Advanced-> to 6. 1-Uas Session Refresher SIP-T42G/T41P: The default value is 0. ranges from 1 0 or 1 X ranges from 1 to 3. ) account.X.ena ble_user_equ It enables or disables the al_phone = "user=phone" carried in the INVITE (SIP-T46G: X ranges from 1 message for account X. 0 or 1 to 6. 0-Disabled 1-Enabled SIP-T42G/T41P: Account-> Advanced->Send user=phone The default value is 0. X ranges from 1 to 3. ) account.X.srtp It configures whether to use voice _encryption = encryption service for account X. (SIP-T46G: X ranges from 1 to 6. 0-Disabled 0, 1 or 2 1-Optional SIP-T42G/T41P: 2-Compulsory X ranges from The default value is 0. Account-> Advanced->RTP Encryption (SRTP) 1 to 3. ) account.X.pti me = 0 (Disabled), 10, 20, 30, It configures the RTP packet time (in Account-> milliseconds) for account X. Advanced->PTime 129 Yealink SIP-T4X IP Phones Auto Provisioning Guide (SIP-T46G: X 40, 50 or 60. The default value is 20. (ms) It configures the BLA number for Account-> account X. Advanced->BLA The default value is blank. Number It configures the period (in seconds) of Account-> BLA subscription for account X. Advanced->BLA The default value is 300. Subscription Period ranges from 1 to 6. SIP-T42G/T41P: X ranges from 1 to 3. ) account.X.bla _number = (SIP-T46G: X ranges from 1 to 6. String SIP-T42G/T41P: X ranges from 1 to 3. ) account.X.bla _subscribe_pe riod = (SIP-T46G: X ranges from 1 to 6. Integer from 60 to 7200 SIP-T42G/T41P: X ranges from 1 to 3. ) account.X.dial oginfo_callpic It enables or disables the phone to kup = pick up a call according to the SIP (SIP-T46G: X ranges from 1 header of dialog-info for account X. 0 or 1 to 6. SIP-T42G/T41P: Account-> Advanced-> 0-Disabled Dialog Info Call 1-Enabled Pickup The default value is 0. X ranges from 1 to 3. ) account.X.gro up_pickup_co de = (SIP-T46G: X ranges from 1 to 6. SIP-T42G/T41P: X ranges from 130 String It configures the group pickup code for Account-> account X. Advanced->Group The default value is blank. Call Pickup Code Appendix 1 to 3. ) account.X.dire ct_pickup_cod e= It configures the directed pickup code (SIP-T46G: X ranges from 1 String to 6. for account X. The default value is blank. Account-> Advanced-> Directed Call Pickup Code SIP-T42G/T41P: X ranges from 1 to 3.) account.X.aut o_answer = It enables or disables auto answer (SIP-T46G: X ranges from 1 to 6. feature for account X. 0 or 1 0-Disabled 1-Enabled SIP-T42G/T41P: Account->Basic-> Auto Answer The default value is 0. X ranges from 1 to 3.) account.X.mis sed_calllog = It enables or disables the phone to (SIP-T46G: X ranges from 1 to 6. record the missed calls of account X. 0 or 1 0-Disabled 1-Enabled SIP-T42G/T41P: Account->Basic-> Missed Call Log The default value is 1. X ranges from 1 to 3.) account.X.sub scribe_mwi_to It enables or disables the phone to _vm = subscribe to the voice mail for the (SIP-T46G: X ranges from 1 0 or 1 message waiting indicator for account Account-> X. Advanced-> to 6. 0-Disabled SIP-T42G/T41P: 1-Enabled X ranges from The default value is 0. Subscribe MWI To Voice Mail 1 to 3.) account.X.regi It enables or disables the phone to ster_mac = carry the MAC address in the Account-> REGISTER message for account X. Advanced->SIP ranges from 1 0-Disabled Send MAC to 6. 1-Enabled (SIP-T46G: X 0 or 1 131 Yealink SIP-T4X IP Phones Auto Provisioning Guide 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 ranges from 1 to 6. message for account X. 0 or 1 0-Disabled SIP-T42G/T41P: 1-Enabled X ranges from The default value is 0. Account-> Advanced->SIP Send Line 1 to 3.) account.X.reg _fail_retry_inte rval = (SIP-T46G: X ranges from 1 to 6. Integer from 0 to 1800 SIP-T42G/T41P: It configures the interval (in seconds) Account-> for the phone to retry to register Advanced->SIP account X when registration fails. Registration Retry The default value is 30. Timer (0~1800s) X ranges from 1 to 3.) account.X.con f_type = It configures the conference type for (SIP-T46G: X ranges from 1 to 6. account X. 0 or 2 SIP-T42G/T41P: Account-> 0-Local Conference Advanced-> 2-Network Conference Conference Type The default value is 0. X ranges from 1 to 3.) account.X.con f_uri = (SIP-T46G: X ranges from 1 to 6. String SIP-T42G/T41P: It configures the network conference Account-> URI for account X. Advanced-> The default value is blank. Conference URI X ranges from 1 to 3.) account.X.blf.s ubscribe_peri od = (SIP-T46G: X 132 Integer from 30 to 2147483647 It configures the period (in seconds) of the BLF subscription for account X. The default value is 1800. Appendix ranges from 1 to 6. SIP-T42G/T41P: X ranges from 1 to 3.) account.X.blf.s ubscribe_even t= It specifies the BLF subscription type. (SIP-T46G: X ranges from 1 0 or 1 to 6. 0-Dialog 1-Presence The default value is 0. SIP-T42G/T41P: X ranges from 1 to 3.) account.X.out _dialog_blf_en It enables or disables the phone to able = handle NOTIFY messages outside the (SIP-T46G: X ranges from 1 BLF dialog. 0 or 1 to 6. 0-Disabled 1-Enabled SIP-T42G/T41P: The default value is 0. X ranges from 1 to 3.) account.X.sub scribe_acd_ex pires = (SIP-T46G: X ranges from 1 to 6. Integer from 12 to 3600 It configures the period (in seconds) of ACD subscription for account X. The default value is 3600. Account-> Advanced->ACD Subscrip Period (120~3600s) 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 ranges from 1 to 6. SIP-T42G/T41P: X ranges from 1 to 3.) 0, 2, 4 or 6 Account-> 2-BroadSoft Advanced->SIP 4-Cosmocom Server Type 6-UCAP The default value is 0. 133 Yealink SIP-T4X IP Phones Auto Provisioning Guide account.X.mus ic_server_uri = (SIP-T46G: X ranges from 1 String to 6. It configures the URI of the Music On Hold server for account X. Account-> Advanced->Music Server URI SIP-T42G/T41P: X ranges from 1 to 3.) account.X.dtm It configures the DTMF type for account f.type = X. (SIP-T46G: X 0-INBAND ranges from 1 to 6. 0, 1, 2 or 3 SIP-T42G/T41P: Account-> 1-RFC2833 Advanced->DTMF 2-SIP INFO Type 3-AUTO or SIP INFO X ranges from The default value is 1. 1 to 3.) account.X.dtm f.dtmf_payloa d= (SIP-T46G: X ranges from 1 to 6. Integer from 96 to 127 It configures the RFC2833 payload for account X. The default value is 101. Account-> Advanced->DTMF Payload Type (96~127) SIP-T42G/T41P: X ranges from 1 to 3.) account.X.dtm It configures the DTMF info type when f.info_type = the DTMF type is configured as “SIP INFO” or “AUTO or SIP INFO” for (SIP-T46G: X ranges from 1 to 6. 1, 2 or 3 Account-> 1-DTMF-Relay Advanced->DTMF SIP-T42G/T41P: 2-DTMF X ranges from 3-Telephone-Event 1 to 3.) The default value is 1. account.X.nat. = (SIP-T46G: X ranges from 1 to 6. Info Type It enables or disables the NAT nat_traversal 134 account X. traversal for account X. 0 or 1 0-Disabled 1-STUN The default value is 0. Account->Register ->NAT Appendix SIP-T42G/T41P: X ranges from 1 to 3. ) account.X.nat. stun_server = (SIP-T46G: X ranges from 1 to 6. IP address or domain name SIP-T42G/T41P: It configures the domain name or IP address of the STUN server for account Account->Register X. ->STUN Server The default value is blank. X ranges from 1 to 3.) account.X.nat. stun_port = (SIP-T46G: X ranges from 1 to 6. SIP-T42G/T41P: Integer from 1 to 65535 It configures the port of the STUN Account->Register server for account X. ->STUN Server The default value is 3478. ->Port X ranges from 1 to 3.) account.X.nat. It enables or disables NAT keep-alive udp_update_e for account X. nable = 0-Disabled (SIP-T46G: X Account-> 1-Default Advanced->Keep to 6. 2-Options Alive Type SIP-T42G/T41P: 3-Notify X ranges from The default value is 1. ranges from 1 0, 1, 2 or 3 1 to 3.) account.X.nat. udp_update_ti me = (SIP-T46G: X ranges from 1 to 6. Integer It configures the keep-alive interval (in from 15 to seconds) for account X. 2147483647 The default value is 30. Account-> Advanced->Keep Alive Interval (Seconds) SIP-T42G/T41P: X ranges from 1 to 3.) It enables or disables NAT Rport account.X.nat. rport = (SIP-T46G: X 0 or 1 feature for account X. 0-Disabled Account-> Advanced->Rport 135 Yealink SIP-T4X IP Phones Auto Provisioning Guide ranges from 1 1-Enabled to 6. The default value is 0. SIP-T42G/T41P: X ranges from 1 to 3. ) account.X.adv anced.timer_t 1= It configures the session timer T1 (in (SIP-T46G: X ranges from 1 Float to 6. seconds) for account X. The default value is 0.5. Account-> Advanced->SIP Session Timer T1 (0.5~10s) SIP-T42G/T41P: X ranges from 1 to 3. ) account.X.adv anced.timer_t 2= It configures the session timer T2 (in (SIP-T46G: X ranges from 1 Float to 6. seconds) for account X. The default value is 4. Account-> Advanced->SIP Session Timer T2 (2~40s) SIP-T42G/T41P: X ranges from 1 to 3. ) account.X.adv anced.timer_t 4= It configures the session timer T4 (in (SIP-T46G: X ranges from 1 Float to 6. seconds) for account X. The default value is 5. Account-> Advanced->SIP Session Timer T4 (2.5~60s) SIP-T42G/T41P: X ranges from 1 to 3.) account.X.aler t_info_url_ena It enables or disables the distinctive ble = (SIP-T46G: X ranges from 1 to 6. SIP-T42G/T41P: X ranges from 136 ring tones by the Alert-Info SIP header. 0 or 1 0-Disabled 1-Enabled The default value is 1. Account-> Advanced-> Distinctive Ring Tones Appendix 1 to 3.) account.X.ring It configures a ringtone for account X. tone.ring_type = Common, (SIP-T46G: X Ring1.wav, ranges from 1 Ring2.wav, to 6. SIP-T42G/T41P: … Ring8.wav Example (configure Ring3.wav for account 1): account.1.ringtone.ring_type = Account->Basic-> Ring3.wav Ring Type The default value is common. Note: Ring 6-8 are applicable to the X ranges from SIP-T46G IP phone only. 1 to 3.) It configures the codec for account X. The default value is: When Y=1, the default value is PCMU; When Y=2, the default value is PCMA; When Y=3, the default value is G723_53; PCMU account.X.cod ec.Y.payload_ type = (SIP-T46G: X ranges from 1 PCMA G729 G722 G723_53 When Y=4, the default value is G723_63; When Y=5, the default value is G729; When Y=6, the default value is G722; When Y=7, the default value is iLBC; When Y=8, the default value is to 6. Y ranges G723_63 G726_16; from 1 to 12. G726_16 When Y=9, the default value is SIP-T42G/T41P: G726_24 G726_24; X ranges from G726_32 When Y=10, the default value is 1 to 3. Y ranges from 1 to 14.) G726_40 iLBC GSM Account->Codecs 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. Example: account.1.codec.2.payload_type = PCMA It enables or disables the specified account.X.cod ec.Y.enable = (SIP-T46G: X 0 or 1 codec for account X. Account->Codecs 0-Disabled 137 Yealink SIP-T4X IP Phones Auto Provisioning Guide ranges from 1 1-Enabled to 6. Y ranges Example: from 1 to 12. account.1.codec.2.enable = 1 SIP-T42G/T41P: This means that the codec PCMA is X ranges from enabled on the phone. 1 to 3. Y ranges from 1 to 14.) account.X.cod ec.Y.priority = (SIP-T46G: X It configures the priority of the enabled ranges from 1 codec for account X. to 6. Y ranges from 1 to 12. SIP-T42G/T41P: Integer from 0 to 13 Example: account.1.codec.2.priority = 2 Account->Codecs This means that the priority of the X ranges from codec PCMA is 2. 1 to 3. Y ranges from 1 to 14.) account.X.cod ec.Y.rtpmap = (SIP-T46G: X ranges from 1 to 6. Y ranges from 1 to 12. SIP-T42G/T41P: Integer from 0 to 127 It configures rtpmap of the audio codec for account X. 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 = de-register account X before reboot. (SIP-T46G: X ranges from 1 0 or 1 0-Disabled to 6. 1-Enabled SIP-T42G/T41P: The default value is 0. X ranges from 1 to 3.) account.X.co mpact_heade 138 0 or 1 It enables or disables the phone to support compact SIP header for Account-> Advanced-> Unregister When Reboot Appendix r_enable = account X. (SIP-T46G: X The default value is 0. ranges from 1 to 6. SIP-T42G/T41P: X ranges from 1 to 3.) account.X.mus It configures the way on how the ic_on_hold_ty phone processes Music On Hold when pe = placing an active call on hold. (SIP-T46G: X ranges from 1 0 or 1 to 6. 0-Calling the music server before holding 1- Calling the music server after SIP-T42G/T41P: holding X ranges from The default value is 1. 1 to 3.) account.X.acd .enable = It enables or disables ACD feature for (SIP-T46G: X ranges from 1 to 6. account X. 0 or 1 0-Disabled 1-Enabled SIP-T42G/T41P: The default value is 0. X ranges from 1 to 3.) account.X.acd It enables or disables the phone to .available = display the available and unavailable (SIP-T46G: X ranges from 1 to 6. soft keys after the phone logs into the 0 or 1 ACD system. 0-Disabled SIP-T42G/T41P: 1-Enabled X ranges from The default value is 0. 1 to 3.) account.X.acd .unavailable_r It enables or disables the call center eason_enable = (SIP-T46G: X ranges from 1 to 6. unavailable reason code feature. 0 or 1 0-Disabled 1-Enabled The default value is 0. SIP-T42G/T41P: 139 Yealink SIP-T4X IP Phones Auto Provisioning Guide X ranges from 1 to 3.) account.X.acd .initial_state = It specifies the initial call center agent (SIP-T46G: X ranges from 1 to 6. state. 1 or 2 1-Avaliable 2-Unavailable SIP-T42G/T41P: The default value is 1. X ranges from 1 to 3.) account.X.stat ic_cache_pri It configures whether preferentially to = use the DNS cache for domain name resolution of the SIP server. (SIP-T46G: X ranges from 1 0 or 1 0-Use Domain name server to 6. preferentially SIP-T42G/T41P: 1-Use DNS cache preferentially X ranges from The default value is 1. 1 to 3.) account.X.pict ure_info_enab It enables or disables the phone to le = download the picture information. (SIP-T46G: X 0-Disabled ranges from 1 0 or 1 1-Enabled to 6. The default value is 0. SIP-T42G/T41P: It is applicable to the SIP-T46G IP X ranges from phone only. 1 to 3.) account.X.init_ register_auth_ It enables or disables the phone to enable = carry the authentication header in the (SIP-T46G: X first REGISTER message when ranges from 1 registering an account. to 6. 0-Disabled SIP-T42G/T41P: 1-Enabled X ranges from The default value is 0. 1 to 3.) 140 0 or 1 Appendix We are striving to improve our documentation quality and we appreciate your feedback. Email your opinions and comments to DocsFeedback@yealink.com. 141
Source Exif Data:
File Type : PDF File Type Extension : pdf MIME Type : application/pdf PDF Version : 1.5 Linearized : No Page Count : 149 Language : zh-CN Tagged PDF : Yes Author : 微软用户 Creator : Microsoft® Office Word 2007 Create Date : 2013:10:14 10:08:10+08:00 Modify Date : 2013:10:14 10:08:10+08:00 Producer : Microsoft® Office Word 2007EXIF Metadata provided by EXIF.tools