Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents

1 Brief Intro


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.

2 Operating Environment

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

3 Pages Introduction

3.1 Visual edit (Phone Configuration page)

The configuration of the phone can be specifically edited in this page. Most of the configurable items can be found in this page.
Image Modified

3.2 Configuration files batching (Cfg Batch page)

On this page you can batch generating cfg files by importing an appropriate CSV file.
Image Modified

3.3 Device discovery and manual provision (Devices Online page)

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.
Image Removed

...

3.3.1 Discover Devices

Before starting to discover the devices, you should set the target network.

...

But you could set a subnet you want to scan through "Subnet Mode".

...

3.3.1.1 Introduction to the function of scanning DSP information.

...

On this page, you can view the status of your phones and execute commands like provision, download configuration files, etc.Image Removed

...


3.4.1 Precondition

...

DM Server needs a port to run. You should set it before you run it.Image Removed

...

If DM Server starts successfully, it will show green Running on the top of HPT.Image Removed

...

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.

...

3.4.3 Import Devices

Before using the Devices Manage feature, it is needed to import devices information.

...

In the CSV file, you will see these columns.

  • MAC: MAC address of phones, and they should be all capital like 001FC112D0FE

  • DEV_NAME: A name that helps remember the phone, such as the name of the person who uses it.

  • STATION: Which station the phone belongs to, such as the London branch office.

  • SEC_ACC: The username of the phone's web (OPTIONAL).

  • SEC_PW: The password of the phone's web (OPTIONAL).

Info

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.Image Removed

...


And before importing the device's information, it is better to set a PIN for protecting the SEC_ACC and SEC_PW data.

...

After the below steps, click the Import button to import the devices' information.Image Removed

...

3.4.4 View Devices Information

...

And you could search a station through the left sidebarImage Removed

...

3.4.5 Station Status

The Station area will show the status of the current selected station.

...

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:Image Removed

...


3.4.7 Right-click Menu

Select a device and right-click, then you will see a menu below:Image Removed

...

If the device is OFFLINE, most of the items in the menu are grayed out and that means it is unavailable. 

...

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.Image Removed

...

Reboot: Reboot the phone.

Edit: Edit the device information.Image Removed

...


3.4.8 Shortcut for Access Phone Webpage

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.Image Removed

...

3.5 HTTP and PNP servers (Servers/Setting page)

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.
Image Modified

3.5.1 HTTP Server

3.5.1.1 Built-in Server  

  • Select Built-in Server and Click Start to start the built-in HTTP Server

         

    Image Removed

    Image Added

3.5.1.2 External Server

  • Select External Server and Cfg Server Path fill in the server path where the configuration is stored

    Image RemovedImage Added


4. Quick Use 

4.1How to provision the phone through HPT?

...

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

  • Switch pages to "Servers".

  • Select the right network interface, which can be accessed by other devices on the same network segment.

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.

  • To start build-in HTTP server, you need to fill in the port edit area with appropriate port, and then click "Start" to run. If the port is not available, it needs to be modified.

  • While choosing external Server, you need to fill in a configuration file server address (  ), such as "http://192.168.0.150:80/cfg" (without "/" at the end). Make sure that this path is accessible.

  • Start PNP server. For the Htek phones, fill "Listen to" box with "224.0.1.75" and fill "Port" box with "5060". Do Not Change These Two Parameters If You Do Not Know What These Mean.


Image Modified 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.
Image Modified

Step 3(Optional). Load the configuration file template

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.
Image Modified 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.
Image Modified

Step 4. Visual edit

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.
Image Modified
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.

...

(1) Prepare a CSV file, which can be opened and made with a text editor or Excel (the template is in the samples folder of the HPT tool);

...

(2)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).

  • Prepare a CSV file (Sample path: \samples\MacModeSample.csv. Two rows at least needed. ).

  • Make sure you have fill the right items with the right keywords in step 4.

  • Click "Load CSV File" to load CSV file. All the content will be shown on the table.

NOTE: For many CSV editor, opened file is exclusively occupied. You need to close this file first, than load it with HPT.
Image Modified

  • Modified csv file if need. You can add rows, edit content or save this table as another file.

  • Choose to encrypt the generate files or not.

  • If built-in HTTP server started, you can check "Autofill Server Path" to autofill the cfg server path and firmware server path.

  • Click "Batch" to generate cfg files and save them in the desired directory, or click "Batch to Buit-in Server" to generate and store them in the built-in HTTP server file directory (\server\htdocs\cfg and \server\htdocs\fw).

In the following example, we want to change the value of the LineKey_value and LineKey_label, so we set them to the variables $$userId_1, $$authenId_1 respectively, and fill in these two variables in the visual editing page of the HPT tool and the csv file to be imported.

...

Anchor
Step6-Search-and-provision
Step6-Search-and-provision
Step 6.Search and provision online devices

Switch pages to "Devices Online".
On this page, you can search for devices on the same network segment within the LAN and provision them.

  • Select the right network interface, which can be accessed by other devices on the same network segment.

  • Select a Mac address filter or input one (Input filter format: 00-1f, 00-1f -, 00-1f - c, 00-1f - c1-11-22 - , etc.).

  • Click "Discover Devices" to start search. When the desired content has been found, click this button to end search, or wait for it to end on its own.

Image Modified Image Modified The  

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:

  • "Provision": This command ask phones to fetch cfg file from the HTTP server where you defined on Page "Servers".

  • "Upgrade": Same as "Provision" on current HPT version.

  • "Refresh" : Check if the phones selected are still online.

All the selected phones will execute the command.

...

(1)You must fill in the FW Server Path, such as ", if you are using a built-in server, you can fill in such as "http://10.6.0.111:60008088/fw" (without "/" at the end), replace the underlined part with your own FW Server.Image Removed

...

(2)You need  to put ROM Firmware under the fw folder.

...

Secondly,  switch pages to "Devices Online".

Same as in in Step 6. Search and provision , first scan and search for phones, and then select them to upgrade.


Files Hierarchy

Image Modified 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.

Q&A

  1. Why cannot PNP server be started?
    Usually this is because of port occupied. For example, 3CX server exclusively occupies port 5060. You should not use HPT on this PC, or shut down 3CX services.

  2. Provision command make phone reboot, but why doesn't phone configuration change?
    This can be caused by many reasons. 1. Check if the cfg file name is right (Just like "cfg001fc1112233"). 2. Check if the cfg server path is right. 3. Check if there is any router in the LAN has DHCP OPTION-66 defined. 4. Check if there is any other PNP server in the LAN.

  3. Why the table is empty when I load a CSV file?
    For many CSV editor, opened file is exclusively occupied. You need to close this file first, than load it with HPT.

  4. Why doesn't Provision command work on 926E in WIFI environment?
    Sorry, current version of HPT doesn't work well when phones in WIFI environment. We are working on this issue. 

Upgrade Note

2021-12-08: 1.4.2beta

...

Add Devices Manage module.

2020-10-12: 1.3.5beta

  1. Add Scan Timeout for discovering devices

  2. Add Subnet Mode for scanning the specific subnet

  3. Add a shortcut for accessing webpage of device: Ctrl + Click on the IP Address in the Scan Result page.

         

2018-01-17: 1.2beta

  1. Fix the bug that provisioning phones with built-in HTTP server failed;

  2. Fix the bug that "Discover Devices" failed to reset;

  3. Add log mechanism;

  4. Other fixes and changes.

2017-09-26: 1.1beta

  1. Support multi-language user interface;

  2. Improve stability of built-in HTTP server.

2017-09-07: 1.0betaHPT first release.


HPT_Quick_Guide 1.3.5beta.pdf