Htek Provision Tool (HPT) is a software used on windows os to manage HTEK phones. It is well designed to make provision Htek phones conveniently and easily by providing many useful functions, such as configuration file (cfg file) visual edit, cfg files batching, online devices discovery, manual provision, PNP, cfg file server, firmware server, etc. It is a complete tool to provision Htek phone in the same network segment in the LAN.
System | Windows 7 and later versions |
Display | Minimum: 1280 X 800 pixels |
Network | The computer running the software needs to be in the same network segment of the same area as the phone to be provisioned |
The configuration of the phone can be specifically edited in this page. Most of the configurable items can be found in this page. 
On this page you can batch generating cfg files by importing an appropriate CSV file.
HPT will list all the online Htek Phones in the selected network segment after scanning on this page. By right click, you can provision more than one phone at the same time.
Before starting to discover the devices, you should set the target network.
Normally the target network is the same LAN as the computer that the HPT running in, so you could select the IP address of the computer from the "Network" drop-list.
But you could set a subnet you want to scan through "Subnet Mode".
This function is to scan out the DSP version of the phone to distinguish which hardware platform the phone belongs to.
Example:
DSP column display information comparison:
Instructions:
Before using the DSP function, please click Discover Devices to scan the device. After scanning the device, click DSP ANALYING to obtain the device DSP information.
If the phone's username and password are modified under this network segment (that is, not the default admin:admin), please fill in the modified ones, and the scan analysis program will use the username and password entered by the user to try to obtain it after running.
Because the user name and password are incorrect or the device does not support the acquisition, the acquisition may fail. After scanning, NA will be displayed. Please carefully check whether the user name and password are entered incorrectly.
Note:
After each use of Discover Devices, the Dsp column will be refreshed, and you need to click DSP ANALYING to re-acquire. During the acquisition process, the button style will change to [DSP ANALYING...]. After the acquisition is successful and displayed, it will return to its original state.
This function is based on HTTP request. Before using it, please open the phone web page to set Network->Advanced→Web Server→Type and select the HTTP item, otherwise it will cause access failure and the DSP information cannot be obtained.
On this page, you can view the status of your phones and execute commands like provision, download configuration files, etc.
1. The version of the phone should be later than 2.42.6.4.43R11(2021-10-30)
2. The phone should be configured DM (Devices Manage) Server Address
P-code is P25107, the value should be the DM Server Address, like P25107=10.3.0.70:8080
You could configure this P-code for your phones by HPT. When generating configuration files, select Autofill DM Server Path to generate it into configuration files automatically. |
DM Server needs a port to run. You should set it before you run it.
If DM Server starts successfully, it will show green Running on the top of HPT.
And it is recommended to enable Refresh(min) to let the HPT refresh status of phones automatically.
If a phone has not reported its status 3 times, HPT will mark it as offline and you will see the ONLINE status is OFF.
Before using the Devices Manage feature, it is needed to import devices information.
You could import it through a CSV file in UTF-8 format.
You will find a sample file named devices.csv in the folder samples of the HPT file tree. |
In the CSV file, you will see these columns.
If you left the SEC_ACC and SEC_PW empty, those features like download configuration files will not work. |
There is a screenshot of the sample CSV file for a fast view.
And before importing the device's information, it is better to set a PIN for protecting the SEC_ACC and SEC_PW data.
If someone gets your database file, they can't send a command to your phones if they don't know the PIN.
After the below steps, click the Import button to import the devices' information.
After devices' information is imported, these phones will display by the STATION.
MAC: MAC address of the phone, it is unique and can't be changed.
DEV_NAME: A name that helps remember the phone, right-click and select Edit to modify it.
IP: IP address of the phone, it is reported by the phone.
ONLINE: ON when the phone connects to the DM server and OFF when the phone has not reported its status three times.
ACCOUNT: Number of account 1 of the phone, it is reported by the phone.
REG: Registration of Account 1, it is reported by the phone.
DND: DND status, it is reported by the phone.
FWD: Forward status, it is reported by the phone.
MODEL: Phone model, it is reported by the phone.
VERSION: Firmware version, it is reported by the phone.
On Devices Information page, you could turn pages by clicking the < or > button. Or you could input a page number to jump to.
And you could search a station through the left sidebar
The Station area will show the status of the current selected station.
The green number shows the number of phones that are online and have registered account.
The red number shows the number of phones that are online but don't have registered account.
The gray number shows the number of phones that are offline.
Click the Provision button to provision the phones that belong to the Station.
You could search device through the Search area.
These entries need exact match to search: MAC, DEVICE_NAME, IP, ACCOUNT, MODEL, VERSION
And these entries need yes/no, on/off, 1/0 to search: ONLINE, REG, DND
FWD is a special one, it uses forward number and forward method to search. And it has three status: ALL_CF → Always Forward, BUSY_CF → Busy Forward, DELAY_CF → No Answer Forward. Below image is an example:
Select a device and right-click, then you will see a menu below:
If the device is OFFLINE, most of the items in the menu are grayed out and that means it is unavailable.
Provision: Provision configurations. The phone should enable PnP and the HTTP server of HPT should be set.
Upgrade: Upgrade firmware. The phone should enable PnP and the HTTP server of HPT should be set.
If the HTTP server of HPT has not set, it will prompt the following notification. |
Refresh: Refresh the ONLINE status of the selected phone.
Download CFG: Download bin format configuration file of the phone. You should set the user name and password of the phone when you import it.
Download CFG (XML): Download bin format configuration file of the phone. You should set the user name and password of the phone when you import it.
Download LOG: Download syslog of the phone. You should set the user name and password of the phone when you import it. And it will take a few seconds to done it.
Pcap: This option will try to jump to the webpage of the phone to start capture the network packages. It needs set the full Web Browser exe file path.
Reboot: Reboot the phone.
Edit: Edit the device information.
If you have set the Web Browser exe file path, then when you press Ctrl and click the IP address of the device, the HPT will help you open the web browser to login to the phone.
On this page, you can turn on an HTTP server and use it as a configuration file server and/or firmware server. Also you can turn on the PNP server to automatically provision phones.
You can also change HPT user interface language and log setting on this page.
NOTE: All operations shown below are proceed in "Mac Mode". "Pin Mode" is not supported right now.
In general, to fully use all of the capabilities of this tool, you need to configure and start relevant servers first (Skip this step only when you just want to edit cfg files ).
NOTE: For HTTP servers, you can choose build-in or external one.PNP server cannot be turned on until you selected the external HTTP server or started built-in HTTP server.
NOTE: Step 2 ~Step 5 can be skipped if cfg files already generated.
Click the drop-down box to select the device for visual editing.
By default, the software automatically selects the default cfg file of the current device (Default cfg file of a device is in the device directory, named as "$devCfg.bin").
You can also click "Load a Template" button to load a bin format cfg file as template. After loading, loaded cfg file will automatically rewrite the information in the Phone Configuration page.
After edit the contents of the Phone Configuration page, the "Save" button will be available. By clicking "Save" button, loaded cfg file will be modified. By clicking "Save as" button, you can save the current modification as another file without modifying the loaded file. Or just let them alone.
Switch to "Phone Configuration" page.
This page is divided to 3 areas. Left area shows the phone image, keys that can be set can be clicked. Middle area is the outline of all the configurable items. Right area shows details where you edit the exact configuration here.
In the process of editing, the software will automatically remember changes, so you can switch directly among the outline items. All the changes are kept temporally. You can click "Save" or "Save as" button to save these changes. Or let them alone.
Switch pages to "Cfg Batch" page.
HPT can batch generate cfg files in a Keyword-replace manner.
In MAC mode, the first column must be "MAC" column, where only MAC addresses allowed in the form like "001fc1aabbcc" (lowercase).
"Keyword-replace" means to replace the item content (P value) by the exact keyword . To do this, the item to be replaced need to set its content (P value) to a unique string, such as "$$userId_1". If the CSV file contained a column whose head is just "$$userId_1", then all cfg files generated will substitute "$$userId_1" with the string in the cell of the column (specific row is determined by the MAC column).
NOTE: For many CSV editor, opened file is exclusively occupied. You need to close this file first, than load it with HPT.
Switch pages to "Devices Online".
On this page, you can search for devices on the same network segment within the LAN and provision them.
The results of the search are presented as shown in the table above.The head can be used for the screening of device model and version number.
Click the most left num column, you can select a device, or you can select multiple devices by hold pressing left mouse key and dragging. Click the top left corner of the form to select all the devices of the current table. Left-click on the selected device, which will cancel the selection.
Right click, quick menu will pop up. There are three commands:
All the selected phones will execute the command.
The files hierarchy of the software is shown in the figure (only the folder type is displayed).
The root directory of the software folder has "default", "ini", "log","models", "samples" and "server".
The "log" folder shows once you run this app. It stores log files.
The "default" folder contains the "$json" folder and the "$cfg.bin" file. When the "models" folder is empty, the software reads the files in that folder. Do not delete.
There is currently "$default.ini" configuration file in the "ini" folder, which holds the default configuration of the software. After the software is turned off for the first time, the "setting.ini" file will be generated in this folder. If the user does not modify the configuration, the file will be consistent with the "$default.ini" file, otherwise changes will be stored in this file. The "$default.ini" file cannot be deleted. Deleting "setting.ini" will restore the software to the default configuration.
The "models" folder contains information about different devices. By adding and subtracting and updating this folder, you can add or subtract or update device information. You can't rename the folder at will, which will cause the image to be invalid.
The samples folder currently has a CSV template for batch generation configuration files. This folder is not required.
The "server" folder contains the "htdocs" folder, which contains the "cfg" (for cfg files store) and "fw"(for firmware files store) folders. Built-in HTTP server need these folders.
2021-12-08: 1.4.2beta
Support sorting in Devices Manage page.
2021-10-29: 1.4.0beta
Add Devices Manage module.
2020-10-12: 1.3.5beta
2018-01-17: 1.2beta
2017-09-26: 1.1beta
2017-09-07: 1.0betaHPT first release.