...

Htek UC900 Series including all models:

This guide provides instructions on how to provision Htek IP Phone with the minimum settings.

...

Note: The auto provision just applies to FW 1.0.3.70 or FW after 1.0.3.70. For the latest FW, please download from our website www.htek.com.

Back to Top

2. Manage Configuration

2.1 Htek IP Phone Provision Process

...

The file "cfgMAC" is also unique for every phone. But it is proprietary binary format and is usually be used for backup the configurations because it is encrypted when you download it. Thus we don't recommend you use it to provision the phone.

Provisioning Flow Chart:

Note:

...

The supported algorithm is AES-128-CBC.

The parameter iv is fixed 0B1E1D000F0B07091D1F04071F1E0407, and the and may not be changed, other wise configuration files cannot be encrypted by the phone and settings are not made.

The valid key (parameter K) could contain 16 characters in length is from 1-16, and may only contain [0-9, A-F].

Here is an example.

...

You could find this setting on webpage → Management → Auto Provision → Set Common AES Key. (P-Code is P8631)

...

Back to Top

4. Customize Resource Files

...

Htek IP Phone has several factory-default ring tones (Ring1, Ring2, Ring3). You can customize Ring4, Ring5, Ring6, Ring7 and Ring8 tone and upload them to the phone via auto provisioning.
You can change the ring tone configuration parameter to personalize ring tone:
For example: P8721 = 8
For more information on customizing ring tone file, please refer to <<Making Ringtone Notes>> in page 60.

4.2 Customize LCD language

Htek IP Phone supports multiple language,you can modify the language and add a new language to the phone. The following table lists all available languages, associated language files and language template file:

Below picture shows a portion of LCD_English_Template.xml file:
English is the default language, you can change configuration parameter to other languages:
For more information on customizing an LCD language, please refer to <<LCD Language custom guide>> in page 62.

4.3 Customize web language

Htek IP Phone supports multiple language,you can modify the language and add a new language to the phone's webpage. The following table lists all available languages, associated language files and language template file:

Below picture shows a portion of Web_English_Template.js file:
English is the default language,you can change configuration parameter to other languages:
For more information on customizing web language file, please refer to << Web Language custom guide>> in page 64.

4.4 Customizing wallpaper

You can customize Htek UC923/UC924/UC926 IP phones' wallpaper.
Below table shows wallpaper's format and resolution for UC923/UC924/UC926 IP phones:

Wallpaper2 is default wallpaper, you can change configuration parameter to other wallpaper:
For more information on customizing wallpaper, please refer to <<LCD and Web GUI custom Guide >> in page 68.

4.5 Customizing screensaver

You can customize Htek UC923/UC924/UC926 IP phones' screensaver.
Below table shows screensaver's format and resolution for UC923/UC924/UC926 IP phones:

Screensaver default is Off, you can change configuration parameter to activate the Screensaver :
For more information on customizing screensaver, please refer to <<LCD and Web GUI custom Guide >> in page 68.

4.6 Customizing weblogo

You can customize Htek all phone models' weblogo on webpage.

For more information on customizing weblogo, please refer to << LCD and Web GUI custom Guide >> in page 68.

Back to Top

5. Upgrade resource files

...

You can change the Wallpaper server configuration to locate the file:
P20052=http(s)://192.168.0.254/wallpaper.jpg
Note: 1. Wallpaper file phone gets from server will cover the wallpaper6.
2. Only support format .jpg, .bmp.

Back to Top

6. Upgrade Firmware

Version number and support files list:

Note:
When the phone which version is 1.0.3.71 or older upgrade to 1.0.3.73, phone will upgrade img_9xx.bin then automatically upgrade fw9xx.rom. fw9xx.rom is all-in-one firmware file. After upgrading to the 1.0.3.73 firmware, in the next time, phone will only need upgrade one file fw9xx.rom.

...

Htek IP Phone supports using FTP, TFTP, HTTP and HTTPS protocols to obtain the address of provision server. Default way is HTTP. For how to configure a HTTP server, as follows:
You can download a free HTTP server from http://httpd.apache.org/ or use Microsoft IIS web server. Then setup HTTP server.
For more information on how to configure TFTP, FTP and HTTPS servers, please refer to Upgrade through TFTP in page 71, Upgrade through FTP in page 74 and Upgrade through HTTPS in page 75.

6.2 How to Configuring HTTP Server

Login webpage, "Management" -> "Auto Provision" -> "Firmware Upgrade" -> "Upgrade Mode" needs to be set to HTTP. "Firmware Server Path" needs to be set to be a valid URL of a HTTP server, and server name can be in either FQDN or IP address format. Below are examples of some valid URLs.
e.g. firmware.mycompany.com:5688/Htek
e.g. www.mycompany.com:5688/fm/Htek
e.g. 218.2.83.110
Below are Instructions for FW upgrade via HTTP:
(1) You can download a free HTTP server from http://httpd.apache.org/ or use Microsoft IIS web server. Then setup HTTP server.
(2) Unzip the firmware file and put the files under the root/fm directory of the HTTP server.
(3) Visiting "http://192.168.0.254/fm/fw924.rom on localhost by browser" to verify the HTTP Server. If visiting "http://192.168.0.254/fm/fw924.rom on another computer is no prompt to download fw924.rom file, please check the firewall (Suggest to close the firewall).
(4) Change the setting of UC9xx (192.168.0.254 is HTTP server):
                                                                        
Click "SaveSet".
(5) Restart the UC9xx, IP Phone will restart and automatically get firmware files from HTTP server.
NOTES:
(1) We recommend you to use Htek HTTP server, or you can also use your own TFTP/HTTP/FTP/HTTPS server for upgrade and provisioning procedures.
(2) You need to update the settings and restart the IP Phone after "Firmware Server Path" is set. If the configured firmware server is found and a new code image is available, UC9xx IP Phone will attempt to retrieve the new image files by downloading them into the UC9xx's SDRAM. During this stage, the phones LEDs will blink more frequently until the checking/downloading process is finished. Upon verification of checksum, the new code image will be saved into the Flash. If TFTP/HTTP/FTP/HTTPS fails for any reason (e.g. TFTP/HTTP/FTP/HTTPS server is not responding, there are no code image files available for upgrade, or checksum test fails, etc.), the phone will stop the TFTP/HTTP/FTP/HTTPS process and simply boot using the existing code image in the flash.
(3) Firmware upgrade takes 3 to 8 minutes over Internet, or just 1 minute on a LAN. We recommend you to upgrade the FW in a controlled LAN environment.

Back to Top

7. Obtain Provisioning Server's Address

...

The priority of obtaining the provisioning server address: PNP Server (SIP PnP MCAST) --> DHCP Option 128 or 150 or 66 --> Configuration in Flash.
1) The PNP Server feature is enable default.
Webpage --> Management --> Auto Provision --> PnP Active: No/Yes
If you set "Yes", the Phone will obtain the provisioning server address from the PnP Server.
2) Setting of "DHCP Option 128 or 150 or 66":
If you set "PnP Active" to "No", login Webpage --> Management --> Auto Provision --> Allow DHCP Option (128 or 150 or 66) To Override Server: No/Yes
If you set "To Override Server" to "Yes", the Phone will obtain the provisioning server address from the DHCP Option (128). For examples:
DHCP option 128 is tftp://192.168.1.240/cfg, the phone will get the configuration file from 192.168.1.240/cfg through TFTP protocol.
If the default setting is:
DHCP option 66 is http://192.168.1.240/cfg, the phone will get the configuration file from 192.168.1.240/cfg through HTTP protocol.
3) Configuration in Flash.
If you set both "PnP Active" and "To Override Server" to "No", or don't set DHCP option 128/66/150 in your DHCP server, the phone will obtain the provisioning server address from the setting "Config Server Path".
For examples, when the setting is:
The phone will get the configuration file from 192.168.0.254/cfg through HTTP protocol.
Note: You can set the phone to automatically upgrade every certain time:
For examples:
The phone will check the configuration file and the firmware every 10080 minutes (7 days). If there are the new cfg files or the new firmware, the phone will upgrade automatically.

Back to Top

8. Update mode

Update mode sets the desired time frames for phone to perform the auto provisioning process.
Below is the introduction of the 3 updating modes in detail:

...

Power On
Power On mode is set as default. The phone will perform auto provisioning process when it is power on.
Repeatedly
The phone performs auto provisioning process at a regular interval. You can configure the interval for the Repeatedly mode. The default interval is 10080 minutes.
To activate the Repeatedly mode via web user interface:
1. Click the Management->Auto Provision:
2. AUTO Upgrade set Yes:
3. Click the "SaveSet" button to save the change.
SIP NOTIFY Message
The phone will perform 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. For this update mode, it requires the server supports.
Below picture shows the message flow:

Back to Top

9. Download and Verify Configurations

...

You can verify the update via phone user interface after auto provisioning, or you can verify it via web user interface
During the auto provisioning process, you can monitor the downloading requests and response messages by a wireshark tool.
Some examples show as follows:
Example1: Htek UC924 IP Phone downloads configuration files from TFTP server.
Example2: Htek UC924 IP Phone downloads configuration files from FTP server .
Example3: Htek UC924 IP Phone downloads configuration files from HTTP server .

Back to Top

10. Firmware and Configuration File Prefix and Postfix

...

In this way, all of the firmware with different version could be stored in one single directory, and they could be differentiated by using prefix or postfix, i.e., all files with a postfix of "_1.0.3.73" belong to the firmware version 1.0.3.73.
Same rule applies to configuration files, i.e., for configuration file named "cfg001fc1001708", there could be 3 versions: "hl_ cfg001fc1001708_cfg001", "hl_ cfg001fc1001708_cfg002", and "hl_ cfg001fc1001708_cfg003". The BASIC NAME of the configuration file is "cfg001fc1001708", but there are 3 different versions, the one that will be accepted is the one with matching prefix and postfix specified in the current configuration.

Back to Top

11. Firmware Server and Configuration File Server

Beside the Prefix and Postfix for firmware and configuration files, different server paths for firmware upgrade or Configuration File Server can be specified in different FQDN, i.e.:
The parameters are P192 and P237 for Firmware and Config Server

Back to Top

12. Manage Firmware and Download Configuration File

When parameter P194 (Auto Upgrade) is set to 1, Service Provider can use P193 (Auto Check Interval) to have the devices periodically check with either Firmware Server or Config Server, whenever they are defined. This allows the device periodically check if there are any new changes need to be taken on a scheduled time. By defining different intervals in P193 for different devices, Service Provider can distribute the Firmware or Configuration File download schedule to reduce the Firmware or Provisioning Server load at any given time.

Back to Top

13. Pre_Configuration and Configuration Redirection

...

1. Create configuration files for all the devices and put them on your TFTP/HTTP server.

2. Download the latest official release from www.htek.com/support/Document_And_Firmware and put them on your TFTP/FTP/HTTP/HTTPS server (same directory as above)

3. After we inform you that the devices have been entered into our central provisioning database, please take out a few devices to test. Upon powering up, they should contact our provisioning server https://rps.htek.com/index.php/fn/g first, and then get redirected to your TFTP/FTP/HTTP/HTTPS server and pull out the configuration files and the firmware files. They will be upgraded to the latest firmware with your configurations.

Back to Top

14. Automatic Provisioning Within LAN

Htek products support DHCP Option 66 or 128 or 150 for automatic provisioning within a Local Area Network. The provisioning server URL is embedded inside standard option 66 or 128 or 150 of DHCP responses.
Htek IP Phones send DHCP DISCOVER with the following information:
DHCP Server can be configured to send the following information in its DHCP OFFER. Please notice that in this example, an HTTP://URL is provided in the Option 66 "TFTP Server Name" field or Option 128 "TFTP server IP address" or Option 150 "TFTP server address". Device will then issue HTTP requests instead of the traditional TFTP requests to the server. This design makes more flexible in device provisioning.

Back to Top

15. Troubleshooting

This part provides guidance to help you solve problems you might encounter when deploying phones.
If you require additional information or assistance with the deployment, please contact your system administrator.
Why does the phone fail to download configuration files?

...

• 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.

Back to Top

16. 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.
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.

Back to Top

17. How to Edit xml format configuration file

You can customize configuration parameters by editing XML configuration file "cfg000x.xml", and different device would use different file name.

For example, if you have a Htek device UC924 and you want to configure its Line key 1 as BLF to monitor extension 1002, you can realize this by following two methods.
1.Create a new XML file and add configuration parameters.
Step 1: Create a new XML file entitle it as cfg0000.xml. If your Htek device is UC924, you should entitle it as cfg0012.xml
Step 2: Login webpage, find out Web Setting Path of line key1. Function Keys-Line Key-Key1
Step 3: Refer to UC900 Series IP Phones Provisioning#23. Parameter List, you can get detailed description of this parameter.
According to description of parameter, we know parameter P41200 should be 3, parameter P41300 should be 1002 and parameter P41600 should be 20.
Step 4: Edit cfg0012.xml as follow
Step 5: Put this XML configuration file in your config server path.
Step 6: Restart phone to apply to the settings.
2.Edit relevant parameter in the template file(template.xml)
Step 1: Login webpage, enter Function Keys -> Memory Key
Step 2 : Configure options you want, for example
Step 3: click "saveset" button to save the configuration.
Step 4: Enter Management -> Configuration
Click "Download Xml File" button to download the configuration Xml file. This file includes all parameters of this phone.
Step 5: Open the Xml file that you downloaded, you can find that the parameter has been changed.
Step 6: Change the xml file's name to cfg0012.xml.
Step 7: Put this XML configuration file in your config server path.
Step 8: Restart phone to apply to the settings.

Back to Top

19. Making Ringtone Notes

Prepare:
Tool: ringtool.exe
Ring file format: pcm
1. To make ring tone for UC9xx
1.1 Double click ringtool.exe
1.2 Select the Maximum Length and Output Filename:
For example, 16 seconds, ring 2.bin
1.3 Click Select to Input the desired ring tone file, and then click Generate Ringfile.
Then, you will get Ringfile Created.
1.4 Now, you get the ring2.bin, also you can rename it as ring5.bin, or other the one you want to replace.
1.5 Upload the ring file by TFTP or HTTP, the ringtone is replaced successfully.

Back to Top

20. LCD and Web Language Custom Guide

...

1. You need to contact us about how to obtain the Language.tar file.
2. Unzip the Language.tar using 7-zip tool. 
3. Open the Language folder:
Note: The file name must be " digital_" at the beginning,the format of the file name is the order of the on the LCD.
4. For example, custom Chinese Language
If your country's language is not existing in the language folder, you can new a xml file with correct naming format. [e.g. 13_xxx(xxx).xml]
If your country's language in the folder, you can custom directly your language.
Open the LCD_English_Template.xml with UltraEdit→ Translate English into Chinese (Can't leave out any items, otherwise the upgrade failed) →save as 10_简体中文(ChineseSimplified).xml in Language folder (Coding format is UTF-8)
→ Select the Language folder→ Compress Language.tar package using 7-zip tool and Cover the original→Delete the Language folder

If you want to put your language on the front of other languages, you can also rename the file, for example: 

...

1. You need to contact us about how to obtain the Language.tar file
2. Unzip the Language.tar using 7-zip tool. 
3. Open the Language folder:
Note: The file name must be " digital_letter" at the beginning. The format of the file name is the order of that on the Web.
4. For example, custom Chinese Language
If your country's language is not existing in the language folder, you can new a xml file with correct naming format. [e.g. 13_xxx.js]
If your country's language in the folder, you can custom directly your language reference Web_English_Template.js.
Open the Web_English_Template.js with UltraEdit→ Translate English into Chinese (Can't leave out any items, otherwise the upgrade failed) →save as 10_ChineseSimplified.js in Language folder (Coding format is UTF-8)
→ Select the Language folder→ Compress Language.tar package using 7-zip tool and Cover the original→Delete the Language folder

If you want to put your language on the front of other languages, you can also rename the file, for example: 
When you finish the Language.tar, you must send the Language.tar package to us, then we provide the firmware to you.

Back to Top

21. LCD and Web GUI custom Guide

...

This logo is only applicable to UC601, UC901, UC902, UC903, UC912/G/GM.
Open hlpres folder→you can custom the lcdlogo_bw.png (dimension:100*11 size: through Photoshop tools make the size smaller) →Select the hlpres folder→Compress hlpres.tar package.
Enter Menu→Display->Screensaver Time-out:1min; Scrrensaver Type:Time & Logo→Save, this logo display correctly.
The lcdlogo_bw.png's property must be the following standard:
Note:
The photo's name and format must be the same as before;
The size of hlpres file is not more than 2M.
When you finish the hlpres.tar, you must send the hlpres.tar package to us, then we provide the firmware to you.

Back to Top

22. Firmware Upgrade

Please note: When the phone whose firmware version is 1.0.3.62 or earlier upgrades to 1.0.3.73, you must put the upgrade files(include fw8xx.rom/ fw9xx.rom and img_8xx.bin/ img_9xx.bin ) into the server path and the phone will upgrade img_8xx.bin/ img_9xx.bin then automatically upgrade fw8xx.rom/ fw9xx.rom.
After upgrading to the new firmware, in the next time, you will only need to put one file fw8xx.rom/ fw9xx.rom into the server path. Upgrade steps of later than 1.0.3.73 version and earlier than 1.0.3.73 version is the same.

...

(1) Install and configure an Apache HTTPS Server in local computer.
(2) Unzip the firmware file and put all of them under the root/phone directory of the HTTPS Server.
(3) Visit "https://192.168.0.106/phone/fw924.rom" on localhost by browser to verify the HTTPS Server. If visiting "https://192.168.0.106/phone/fw924.rom" on other computer is no prompt to download fw924.rom file, please check the firewall (Suggest close the firewall).
(4) Configure the Firmware Server Path in the IP Phone's web configuration page. (192.168.0.106 is HTTPS server)
(5) Click the "SaveSet" and then click "Restart" in the webpage.

Back to Top