# PQ

**Repository Path**: e-hi3519dv500/PQ

## Basic Information

- **Project Name**: PQ
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-29
- **Last Updated**: 2026-01-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# PQ 概述

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

> 运行ko前需要设置ko目录下的load3519dv500脚本mem_process_isolation参数为0,关闭进程隔离，PQ的板端业务才能正常使用，不然起业务会报错permission failed。

**Sensor0 I2C 差异说明**

​	由于不同板型的硬件设计差异，**Sensor0 所连接的 I2C 总线在各板型上并不一致**。

| 板卡类型     | Sensor0 I2C 总线 |
| ------------ | ---------------- |
| HongouPI_38C | i2c3             |
| Board_38E    | i2c5             |
| Board_45E    | i2c3             |

## 使用方法

### Hi3519DV500_PQ_V2.0.2.0目录说明

```
├── 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 的脚本文件
```

### 板端软件执行

​	拷贝 `Hi3519DV500_PQ_V2.0.2.0 ` 到开发板上。板端的工具是根据 `./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目录**：应用程序默认在 `Hi3519DV500_PQ_V2.0.2.0/configs/` 目录下读取 `config_entry.ini`。
- **ini序列**：可以在 `config_entry.ini` 中查看；也可以直接配置 `config_entry.ini`，此时不需要输入 ini 序列。

以SC450AI为例：
```bash
./PQTools.sh -a sc450ai 0	#数字0对应config_entry.ini里mode.0

./PQTools.sh -a sc450ai 4	#Board_38E的配置
```
![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. 点播工具使用**