| Table of Contents |
|---|
...
HPT可以按照关键词替换的方式进行配置文件的批量生成。“关键词替换”替换是指，可以将配置项（即P值）配置成独一无二的字符串，如“$$userid_1”，若CSV文件中包含列头为此字符串的列，则在生成配置文件时，软件会将文件中的该字符串替换成CSV文件该列中某一行的内容（具体行由MAC列决定）。
...
| Info |
|---|
在MAC模式中，第一列必须为“MAC”列，该列为形如“001fc1aabbcc”（小写）格式的mac地址 |
在以下示例中，我们希望为每一个话机设置静态IPv4地址，因而我们将IPv4地址的四位分别设置了变量$$ip1, $$ip2, $$ip3, $$ip4，并将这四个变量对应填写在HPT工具的可视化编辑页面，以及将要导入的csv文件中。
...
该页的主要功能如下：
（1）文件导入和编辑
...
在该页可以对导入的CSV文件进行添加行（可以自定义添加的行数）、信息编辑和修改以文件另存为等操作。
...
“Reboot”：该命令让话机重启，此时需要填写CMD的name和password，如下图所示：
...
3.3.1 扫描DSP信息功能介绍
此功能可以实现DSP版本信息显示。
示例:
DSP列显示信息对照
...
操作说明
DSP功能在使用前请先点击Discover Devices进行设备扫描，设备扫描完毕后，再点击DSP ANALYING进行设备DSP信息获取。
用户名和密码如果在该网段下有修改，请填写修改后的，扫描分析程序会在运行后分别使用用户输入用户名和密码，默认用户名密码（admin-admin,user-1234)进行尝试获取。
因为用户名密码错误或者设备不支持原因可能会出现获取失败的情况，扫描后会显示NA，请仔细检查用户名密码是否输入错误。
注意：
每次使用Discover Devices 后，Dsp列都会刷新，需要点击DSP ANALYING重新获取，在获取过程中，按钮样式会变为[DSP ANALYING...] 在获取成功并显示之后会恢复原状。
本功能基于HTTP请求，使用前，请开启话机网页设置Network->Advanced→Web Server →Type 选择要有HTTP项，否则会造成访问失败导致的不能获取DSP信息。
| Anchor | ||||
|---|---|---|---|---|
|
在该页可以简易同步设备状态（ONLINE、ACCOUNT、DND等）以及对设备进行指派、升级、配置文件下载等操作。
...
3.4.1 前置条件
HPT工具的设备管理功能需要话机版本大于2.42.6.4.43R11(2021-10-30)
...
请确保话机配置了DM (Devices Manage) 服务器地址
需要配置的P值代码为P25107，P值为DM服务器地址:端口号，例如P25107=10.3.0.70:8080
| Info |
|---|
可以通过HPT的指派配置功能，批量为要部署的话机设置这一P值 |
...
如果DM服务不运行（即未点击“Start”），则DM刷新设备状态的功能以及图中的“Refresh”将不能工作。
...
成功开启后，DM服务器将显示运行中
...
Refresh（主动刷新）：开启此功能后，可以设置话机状态主动刷新时间X分钟，DM将每隔X分钟（如图中为3分钟）对设备状态进行更新，即主动要求话机上报信息。该刷新是对上次数据更新已经超过X分钟的设备进行，若超过3次话机依然没有上报信息，该话机将会变成下线状态，即ONLINE变为“OFF”；
...
设备信息可以通过csv文件编辑、导入（请注意使用UTF-8编码格式）。在HPT工具的samples目录，你可以一份名为8编码格式）。
| Info |
|---|
在HPT工具的samples目录，你可以一份名为devices.csv的模板文件 |
设备信息的csv文件需要包含的信息如下：
MAC：必填项且必须唯一，用于存储mac地址，如：001FC1112233；
DEV_NAME：必填项，用于存储该设备名称，如：stephen；
STATION：必填项，用于存储站点名称，如：南京分公司；
SEC_ACC：选填项，用于存储话机网页登录账号；
SEC_PW：选填项，用于存储话机网页登录密码；
| Info |
|---|
SEC_ACC和SEC_PW两项若不填会导致一些功能，如下载配置无法使用 |
完整的csv文件可以参考下图示例：
...
HPT支持分段多次导入，即如第一次导入“南京分公司.csv”，第二次导入“北京分公司.csv”等。
...
在设备列表界面，可以通过按“<”键或“>”键进行上下翻页，也可以直接输入具体页码，按回车键跳转到相应页码，“Total”表示当前列表总记录数。
...
（3）站点导航与过滤站点导航与过滤
可以在站点导航界面直接点击站点进行导航，当站点数据过多时，可以在站点导航下方搜索框内输入关键字进行过滤。
...
升级：要求话机升级，使用此功能需提前开启存有话机配置文件的HTTP服务器（服务器/程序设置页进行设置），话机配置文件中的P192值需提前填写好存放了升级固件的服务器路径。
...
刷新：要求设备立即上报信息，刷新设备状态。
下载配置文件：下载bin格式的cfg文件，此功能需要数据库中有账号密码并且设备在线的情况下才可使用，若设备信息导入前输入了PIN码加密，则此时需要输入PIN码。
...
需要在Browser中填入有效的浏览器执行程序路径（推荐chrome或firefox等），按住Ctrl键，点击设备的IP地址，可直接访问话机的网页。若设备信息导入前输入了PIN码加密，则输入PIN码可直接通过https访问话机网页，无需填写用户名和密码进行登录认证；若不填写PIN码，则通过http访问话机网页并且需要填写用户名和密码进行登录认证。
...
4 服务器/程序设置页
在该页可以开启HTTP服务器，用作配置文件服务器和固件服务器。另可开启PNP服务器，用于话机自动指派。同时，在该页还可以修改HPT显示语言。
...
在此模块可以设置工具语言（目前版本仅支持中文和英文两种语言），也可以在此模块选择保留的日志文件数量。
...
5 小工具
该页提供了一种加密工具来加密BIN和XML格式的可读Cfg文件。
...
可以在此页面设置加密密钥、加密文件存储路径、是否覆盖已存在的文件以及观察文件状态等。
6 其他
6.1 服务器运行状态
在工具顶部能够试试观测内建HTTP服务器、PNP服务器以及DM服务运行状态。“Stop”表示服务器停止运行，“Running”表示服务器正在运行。
...
6.2 模板导入与保存
点击“载入模板”可以加载一个bin格式的配置文件模板，其会自动改写“可视化编辑”页中的信息。点击“载入模板”加载一个bin格式的配置文件，以使用自定义的配置模板。
...
当编辑了“可视化编辑”页中内容后，“保存”按钮将可用，若点击该按钮，将会直接修改已加载的配置文件模板。点击“另存为”，会弹出另存为对话框，可以将当前的修改另存，而不会修改已加载的模板。
...
| Anchor | ||||
|---|---|---|---|---|
|
...
| Info |
|---|
以下所有操作都是指派模式在“Mac模式”下进行的。“PIN模式”在当前版本中不支持 |
| Anchor | ||||
|---|---|---|---|---|
|
...
（2）选择正确的网络，即在本局域网中其他设备能访问到网络；
...
（3）选择并开启HTTP服务器，若选择开启内建HTTP服务器，需填写合适的端口，然后点击“启动”运行。若选择外部服务器，需要填写真实有效的配置文件服务器地址（Cfg服务器地址），如“http://192.168.0.198:8080/cfgDir”（末尾不带“/”）。
（4）启动PNP服务器。对于HTEK话机，“监听”栏中填写“224.0.1.75”，“端口”栏中填写“5060”（若该端口被占用，需要关闭占用该端口的进程，确保端口可用）。
...
| Anchor | ||||
|---|---|---|---|---|
|
...
步骤2：选择设备模板
点击所示红框，选择可视化编辑时所用的设备。点击所示红框，选择可视化编辑时所用的设备模板。
...
| Anchor | ||||
|---|---|---|---|---|
|
...
步骤3（可选）：使用配置文件模板
默认地，软件会自动选择当前设备的配置文件。点击“载入模板”可以加载一个bin格式的明文配置文件模板，其会自动改写“可视化编辑”页中的信息。选择设备模板后，软件将使用该模板默认配置。点击“载入模板”加载一个bin格式的配置文件，以使用自定义的配置模板。
...
当编辑了“可视化编辑”页中内容后，“保存”按钮将可用，若点击该按钮，将会直接修改已加载的配置文件模板。
当编辑了“可视化编辑”页中内容后，“保存”按钮将可用，若点击该按钮，将会直接修改已加载的配置文件模板。点击“另存为”，会弹出另存为对话框，可以将当前的修改另存，而不会修改已加载的模板。点击“另存为”，可以将当前的修改另存，而不会修改已加载的模板。
...
| Anchor | ||||
|---|---|---|---|---|
|
...
| Anchor | ||||
|---|---|---|---|---|
|
切换页面到“批量制作”。
（1）准备好CSV文件，该文件可用文本编辑器或者Excel打开和制作（模板路径： \samples\MacModeSample.csv ），文件中至少需要两行；
（2）确保填写了正确的关键词（在步骤4中进行设置）；
（3）点击“载入CSV文件”载入CSV文件。成功载入的文件内容将显示在页面左侧；
...
（4）如果需要，可以在此修改CSV文件。可以添加、编辑和保存文件；
（5）选择是否加密生成的文件；
（6）如果内建HTTP服务器已经启动，则可以勾选“自动填写服务器地址”自动填写配置文件服务器和固件服务器地址；
（7）点击“批量生成”或“生成到内建服务器”保存生成的配置文件。（1）准备好CSV文件，该文件可用文本编辑器或者Excel打开和制作（模板在HPT工具的samples文件夹中）；
...
（2）点击“载入CSV文件”载入CSV文件。成功载入的文件内容将显示在页面左侧；
...
（3）如果需要，可以在此修改CSV文件。可以添加、编辑和保存文件；
（4）选择是否加密生成的文件，如果选择“加密”，将对生成的bin格式配置文件进行加密处理，避免文件泄露被其他人直接读取（默认为不加密）；
（5）如果内建HTTP服务器已经启动，并且对话机的配置文件和固件服务器地址没有特别设置，则可以勾选“自动填写服务器地址”自动填写配置文件服务器和固件服务器地址；
（6）点击“批量生成”或“生成到内建服务器”保存生成的配置文件。
| Anchor | ||||
|---|---|---|---|---|
|
...
（3）配置好后，点击“查找设备”便可开始搜索。当搜索到想要的内容后，可以点击该按钮结束搜索，或者等待其自行结束。
...
搜索结果会显示到如上图中，表头可用于设备筛选。
点击左侧的编号栏可以选择设备，再次点击可以取消选择。也可以通过按住左键拖拽实现多选。表格左上角可以全选，再次点击可以取消选择。
点击右键，会弹出功能菜单，支持指派、升级、刷新状态以及Reboot四个功能。
步骤7：使用DM服务
切换页面到“Devices Mananage”页面。切换页面到“设备管理”页面。
填写可用端口，点击“开启”打开DM服务；
选择开启Refresh，并设置话机上报状态信息的间隔时间，单位：分钟；选择开启“刷新”，并设置话机上报状态信息的间隔时间，单位：分钟；
导入CSV文件，建议用户导入文件前输入PIN码以保证一定程度上的数据安全；导入CSV文件，建议用户导入文件前输入PIN码以增加数据安全性；
在Browser内填入有效的浏览器执行程序路径，用以访问话机网页、抓包等；
点击页面最左侧不同站点，可看到不同站点内的话机状态；在“浏览器”内填入有效的浏览器执行程序路径，用以访问话机网页、抓包等；
选中某一话机，鼠标右键，可执行指派、升级、刷新状态、下载bin格式的配置文件、下载xml格式的配置文件、下载话机log、话机网页抓包、话机重启以及话机信息编辑的功能（ONLINE为“OFF”的话机只能执行重启和编辑的功能）。
| Anchor | ||||
|---|---|---|---|---|
|
...
工具目录结构
工具的文件结构如下图所示：
...
根目录下有“cache”、“DB”、“default”、“ini”、“log”、“models”、“samples”和“server”文件夹。
...
2020-10-27:1.4.0beta
1.新增Devices Mananage页面；Manage功能和说明；
2020-10-15:1.3.5beta
1.新增扫描超时调控;
...