# PQ

**Repository Path**: maxf110415/PQ

## Basic Information

- **Project Name**: PQ
- **Description**: Hi3516CV610平台图像质量调试工具集，提供在线调试与数据分析功能，支持ISP参数实时调节及视频流预览。
- **Primary Language**: Shell
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 2
- **Created**: 2026-05-22
- **Last Updated**: 2026-05-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# PQ 概述

​	PQ（以下简称 PQTools）向客户提供一系列专业图像质量调试工具，包括方便的在线调试工具（Tuning Tool），连接单板后可以直接进行 ISP 等各模块的参数调节，同时通过实时预览点播（Stream）观看设置完参数后的效果；还针对常用调试的场景提供各类数据分析等（Analysis Tool），对客户调节提供更客观的分析。

## 使用方法

### Hi3516CV610_PQ_V1.0.2.1目录说明

```
├── configs ->包含 ittb_stream 运行各种业务场景的 sensor 配置文件（如果不需要运行 ittb_stream，可删除该目录以节省板端空间；如果只运行个别场景，可删除该目录下其他场景的 sensor 配置文件以节省板端空间）
├── libs ->包含 ittb_control 和 ittb_stream 运行的动态库文件（默认提供所有已支持场景的 sensor 库，如果只运行个别场景，可删除该目录下其他场景的 sensor库以节省板端空间）
├── config.cfg ->ittb_control 和 ittb_stream 运行所需的配置文件
├── ittb_control
├── ittb_stream
├── PQTools.sh ->运行 ittb_control 和 ittb_stream 的脚本文件
└── StartControl.sh ->快速重启 ittb_control 的脚本文件
```

### 板端软件执行

​	拷贝 `Hi3516CV610_PQ_V1.0.2.1` 到开发板上。板端的工具是根据 `./PQTools.sh` 脚本里的配置启动的，需运行该脚本并输入启动参数，格式如下：

```bash
./PQTools.sh -s sensor目录 ini序列          //运行 stream 进程  (PC端 PQStream可连接)
./PQTools.sh -c sensor目录 ini序列          //运行 control 进程 (PC端 PQTools可连接)
./PQTools.sh -a sensor目录 ini序列          //运行 stream 和 control 进程 (PC端 PQTools和PQTools都可连接)
./PQTools.sh -as                          //停止运行 stream 和 control
```
参数说明：
- **sensor目录**：应用程序默认在 `Hi3516CV610_PQ_V1.0.2.1/configs/` 目录下读取 `config_entry.ini`。
- **ini序列**：可以在 `config_entry.ini` 中查看；也可以直接配置 `config_entry.ini`，此时不需要输入 ini 序列。

以SC4336P为例：
```bash
./PQTools.sh -a sc4336p 0	#数字0对应config_entry.ini里mode.0
```
![config支持模式](./README.assets/config支持模式.png)

![PQTools板端执行信息](./README.assets/PQTools板端执行信息.png)


### PC端软件执行

#### PQTools 连接
​	运行 PQTools.exe 启动工具时，工具会弹出欢迎界面，引导用户快速新建调试表格与连接单板。

![PQTools PC端欢迎界面](./README.assets/PQTools%20PC端欢迎界面.png)

​	填选相应配置点击“OK”按钮，即可进入主界面，如图所示。

![PQTools PC端主界面](./README.assets/PQTools%20PC端主界面.png)

**注意**： 如果板端使用mpp下sample程序出图，板端只需运行`./StartControl.sh`，PC端即可使用PQTools 连接。

#### PQStream 连接

​	运行 `PQStream` 软件后，出现登录画面。输入相应的 IP 地址，点击“OK”按钮，即可进入主界面，如图所示。

![PQStream登录界面](./README.assets/PQStream登录界面.png)

![PQStream主界面](./README.assets/PQStream主界面.png)


---

更多说明请参考文档：

```
ReleaseDoc\zh\01.software\pc\PQTools\图像质量调试工具使用指南.pdf
```

参见章节：**1. 概述** **4. 点播工具使用**