当前位置：首页 > news >正文

保姆级教程：在Hi3519DV500开发板上从零跑通PQTools调参（含Python环境、板端配置全流程）

news 2026/6/3 6:28:00

Hi3519DV500开发板全流程调参指南：从Python环境搭建到PQTools实战

拿到一块Hi3519DV500开发板和新传感器时，很多开发者会卡在环境配置和调参环节。本文将用最详细的步骤，带你完成从零开始的完整流程——包括PC端Python环境搭建、板端文件部署、参数修改，直到最终用PQTools调整图像效果。

在开始调参前，PC端需要搭建稳定的Python环境。推荐使用Python 3.9.2版本，这是经过验证与PQTools兼容的稳定版本。

安装Python时的关键步骤：

python --version pip --version

安装完成后，需要以下关键包：

pip install numpy==1.21.6 pip install scipy==1.7.3 pip install csaps==0.11.0

注意：避免使用最新版本的库，某些新版本可能与PQTools存在兼容性问题。如果遇到SSL证书错误，可以尝试添加--trusted-host pypi.org --trusted-host files.pythonhosted.org参数。

将Hi3519DV500_PQ_V2.0.1.0工具包解压后，需要重点关注以下目录结构：

板端部署步骤：

chmod +x /root/Hi3519DV500_PQ_V2.0.1.0/PQTools.sh chmod +x /root/Hi3519DV500_PQ_V2.0.1.0/StartControl.sh

对于新传感器（如IMX385），需要特别注意以下配置项的修改：

config_entry.ini关键参数：

启动传感器前，先确保I2C通信正常：

./load3519dv500 -a -sensor0 imx385 -vo_intf mipitx -board dmeb

然后设置环境变量并启动服务：

export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/root/Hi3519DV500_PQ_V2.0.1.0/libs ./PQTools.sh -a imx385

提示：使用ps命令检查ittb_control和ittb_stream进程是否正常运行。如果80端口被占用，可以修改config.cfg中的HttpPort参数。

当板端服务正常运行后，PC端可以通过以下步骤进行调参：

PQStream连接视频流：
- 输入开发板IP地址
- 确保网络通畅（建议使用直连方式）
- 视频流正常显示后，记下当前的图像问题（如过曝、偏色等）
PQTools登录配置：
- 选择正确的板级类型（Hi3519DV500）
- 匹配传感器型号（如IMX385）
- 首次连接时，系统可能会提示导入配置文件
核心调参区域：
- ISP基础参数：曝光、白平衡、gamma校正
- 图像增强：锐化、降噪、边缘增强
- 3A控制：AE、AWB、AF算法参数

典型调参流程示例：

注意：每次调整后，参数不会立即生效，需要点击"保存"并等待约3秒才能在PQStream上看到效果变化。大幅调整参数时建议分多次小步调整。

当使用海思官方未预置的传感器时，需要额外注意：

库文件准备：
- 确保有对应的sensor驱动库（如libsns_custom.so）
- 库文件需放置在libs/目录下
配置文件修改：
- 复制最接近的现有传感器配置目录（如从imx385复制）
- 修改config.ini中的关键参数：
```
[Sensor] SensorName = custom_sensor SensorType = custom_sensor SensorLibFile = libsns_custom.so I2CBusNum = 1
```
MIPI配置验证：
- 使用i2c-tools验证传感器ID是否正确读取
- 通过cat /proc/umap/mipi检查MIPI链路状态