HiSpark编程指南
前言¶
概述
PQ Tools图像质量调试工具使用指南主要辅助调试人员进行图像效果及差异化的调节，本文重点阐述相关的调试操作方法。
说明： 本文以SS928V100描述为例，未有特殊说明，SS927V100与SS928V100内容一致。
产品版本
与本文档相对应的产品版本如下。
产品名称 |
产品版本 |
|---|---|
SS928 |
V100 |
SS927 |
V100 |
读者对象
本文档（本指南）主要适用于以下工程师：
技术支持工程师
软件开发工程师
修改记录
文档版本 |
发布日期 |
修改说明 |
|---|---|---|
00B02 |
2025-12-25 |
第2次临时版本发布。 “Linux系统下板端软件的安装与运行”与“鱼眼镜头标定步骤”小节涉及修改 |
00B01 |
2025-09-15 |
第1次临时版本发布。 |
概 述¶
工具概述¶
PQ向客户提供一系列专业图像质量调试工具（以下简称PQTools），包括方便的在线调试工具（Tuning Tool），连接单板后可以直接进行ISP等各模块的参数调节，同时通过实时预览点播（Stream）观看设置完参数后的效果；还针对常用调试的场景提供各类数据分析等（Analysis Tool），对客户调节提供更客观的分析。
工具的架构如图1所示。
图 1 工具架构图
工具从使用场景上来分主要分为：
标定工具（Calibration Tool）：用于自动生成各个支持ISP模块的算法参数。现阶段该工具是个独立工具。
在线调试工具（Tuning Tool）：用于各类参数的精细及差异化的调节，实时生效，可以通过预览看到图像质量的效果。
分析工具（Analysis Tool）：辅助在线调试工具，提供常用的数据、图表，实时调节同时实时分析。
抓拍工具（Capture Tool）：抓拍工具，支持抓拍YUV、RAW、JPEG文件。
工具从交付上来看，分为PC端及板端两大部分，PC端包括在线调试工具、另外以插件的形式提供各种分析工具和标定工具；板端为ittb_control进程，主要负责在线参数调节。
环境准备说明¶
软硬件需求¶
硬件需求
安装有前言产品版本所列芯片，并具有网络端口的单板硬件。
台式计算机或便携式计算机。
网络连接线（若使用局域网络，则还需要路由器等网络交换设备）或者串口连接线。
用于运行PQTools工具的计算机显示器分辨率宽度不小于1024，高度不小于768。
软件需求
用于运行PQTools工具的计算机须安装Windows 10或以上版本的64位Windows操作系统。
使用ISP标定、自动对焦参数仿真、PQTools Stitching Tool前，请下载python3.9.2安装包（64位）
https://www.python.org/downloads/release/python-392/，Windows用户选择如图1红色方框所标：
图 1 下载提示
安装并配置系统路径如图2所示。
该路径仅为示例，具体请依据实际python路径配置环境变量。
图 2 系统路径配置
python安装成功后，请使用 pip install 安装numpy， scipy， csaps 三个组件。
须知： PQTools工具部分功能不支持中文路径，在使用工具及载入文件的过程中，避免使用包含中文的文件路径。目前因为算法调用工具python目录内容，对于工具路径算法内有限制：
桌面及桌面以下路径
中文路径
数字开头的路径
物理链路连接¶
PQTools工具分为客户端（即PC端软件）和服务端（即板端软件），使用网络或者串口通信进行交互。可使用以下三种连接方式中的任意一种来完成物理链路的连接。
计算机与单板直接连接
将网络连接线的两端分别接入单板和计算机的网络端口。
使用局域网络
将网络连接线的两端分别接入单板网络端口与路由器客户端口。
若计算机使用有线网络，则将另一根网络连接线的两端分别接入计算机的网络端口与路由器客户端口；若使用无线网络，则请参照当前路由器的设置（或网络管理员分配给您的网络设置）将计算机接入无线热点。
计算机与单板用串口连接
将串口连接线的两端分别接入单板串口和计算机的串口。
PQTools发布包目录说明¶
SS928V100_PQ_Vx.x.x.x.tgz¶
此版本使用请参考“Linux系统下板端软件的安装与运行”章节。解压后包的目录结构如图1所示。
图 1 解压后的目录结构
configs目录，包含ittb_stream运行各种业务场景的sensor配置文件（如果不需要运行ittb_stream，可删除该目录以节省板端空间；如果只运行个别场景，可删除该目录下其他场景的sensor配置文件以节省板端空间）
libs目录，包含ittb_control和ittb_stream运行的动态库文件（默认提供所有已支持场景的sensor库，如果只运行个别场景，可删除该目录下其他场景的sensor库以节省板端空间）
config.cfg是ittb_control和ittb_stream运行所需的配置文件
PQTools.sh是运行ittb_control和ittb_stream的脚本文件
ittb_control和ittb_stream是业务程序文件
StartControl.sh是快速重启ittb_control的脚本文件
SS928V100_ext_api_Vx.x.x.x.tgz¶
此发布包用于将PQTools工具部分功能编译到用户业务中的小型化场景。解压后包的目录结构如图1所示。
图 1 解压后的目录结构
libbin目录，包含BIN功能的头文件和库文件，以及编译sample供用户参考。
libcontrol目录，包含control功能的头文件和库文件，以及编译sample供用户参考。
编译libbin与libcontrol的sample前，需要修改对应Makefile中的SDK_DIR变量。
config.cfg，control功能运行所需的配置文件（如果将libcontrol编译到用户业务中，需要将此文件放在运行目录）。
Linux系统下板端软件的安装与运行¶
烧录芯片SDK并配置板端工具运行环境步骤，具体请参考《SSXX SDK 安装以及升级使用说明》，烧写镜像文件到单板，并配置好网络。
把发布包中的SSXX_SDK_VX.X.X.X.tgz解压，将mpp/ko目录放置到文件系统中，或者nfs mount服务器的mpp目录到单板文件系统上。
运行ko目录中的loadXXXX脚本。
把发布包中的SSXX_PQ_VX.X.X.X.tgz解压，参考readme.txt在sample目录下编译生成test_pqt后，将sample目录下的文件拷贝到文件系统中，或者nfs mount 到单板文件系统中。
板端使用./test_pqt运行支持stream和control功能的单个进程。
PC端软件的安装¶
PQTools工具PC端软件是绿色软件，直接使用解压缩工具（如WinRAR、WinZip等）将PQTools工具压缩包（zip格式）解压缩到任意的可写目录，即可使用。
快速入门¶
欢迎界面¶
用户每次运行PQTools.exe启动工具时，工具会弹出欢迎界面，引导用户快速新建调试表格与连接单板，如图1所示。
图 1 欢迎界面图例
若希望通过此界面快速展开图像质量调试，请执行以下操作：
选定正确的调试表格模板。在“Load Template”的下拉框中，选择与被调试芯片名称一致，且版本号匹配的模板。
连接单板：如果用网络连接单板，“Connection Type”下拉框选择“Network”，并在“IP Address”一栏中输入单板使用的IP地址；在“Port”一栏中输入运行板端程序时指定的端口号码（默认为4321）。
如果用串口连接单板，需要执行以下操作：
先修改板端版本包的config.cfg文件中的[Default] UartEn，从0改为1。
修改config.cfg文件中的[Default] UartDev，默认为/dev/ttyAMA0，如果改串口通信，则需要通过如下方法关闭串口控制台（注意：关闭之后无法再通过串口终端来操作单板，所以请务必保证单板的启动脚本中有媒体业务和ittb_control的启动流程）：
单Linux系统：
用该命令注释掉/etc/inittab中的控制台初始化动作，然后重启单板：
sed -i "s/^::respawn:\/sbin\/getty/#::respawn:\/sbin\/getty/g" /etc/inittab reboot
工具界面的“Connection Type”下拉框选择“Serial Port”，并选择相应的COM口来连接板端。
以上操作执行完毕后，点击“OK”按钮，工具将读取选定的模板生成调试表，并自动建立计算机与单板间的网络连接。若网络连接成功，工具还将自动从板端读取所有调试项的值。若串口打开成功，工具只会自动读取工具当前显示页面的调试项的值。
默认情况下，工具会记住用户每次输入的所有信息。若用户只是将参数用于一次临时的调试，并不希望工具记住，请将“Remember the selections”前的复选框取消勾选。
如果用户不希望每次打开工具时弹出欢迎窗口，请勾选“Do not show this dialog when start PQ Tools”。若勾选此项，则下一次用户启动工具时，欢迎窗口将不再出现，而是直接显示工具主界面。
工具主界面¶
工具主界面如图1所示。
图 1 工具主界面图例
PQTools工具的主界面按功能的不同分为以下几个区域：
(1) 工具栏：提供一些常用的操作的快捷按钮
(2) 调试表面板：显示当前打开的调试表文件所包含的所有可调试项
(3) 调试区域：点击左侧的树节点，此区域会显示选中节点对应的调试页面
(4) 高级功能区域：显示通信日志。
(5) 提示栏：显示一些操作的提示性文本。
常用操作¶
新建调试表¶
通过工具栏的“新建”（
）按钮可以创建一个调试表格，并将其用于图像质量调试。点击“新建”按钮，工具会弹出“Create a new PQ table”对话框，如图1所示。
图 1 创建调试表格对话框
在下拉框中选择对应的调试表格模板，点击“OK”按钮，工具将建立调试表格。建立后，在主界面的调试表面板区，会显示当前调试表格的树形结构（详细描述请参见"界面及功能说明"）。
保存调试数据文件¶
如果需要将当前的调试表以及板端读取到的调试数据保存到文件中，请点击工具栏上的“保存”按钮（
）。此时工具将弹出路径选择的对话框。用户选定路径后，工具即将当前调试表的数据进行保存。
保存的文件格式为*.xml。调试数据文件亦会包含所使用调试表的结构。
打开调试数据文件¶
如果需要加载保存的调试数据文件，请点击工具栏上的“打开”按钮（
），此时工具将弹出对话框，让用户选择要打开的数据文件。
工具打开调试数据文件时，会读取文件中保存的调试表结构并将其显示在调试表面板。
导入xml文件后，切换可调项界面不会自动获取板端数据，可调项界面显示导入文件的数据。
导入xml文件后，点击主界面
或
可将参数设置到板端，或者切换到可调项界面点击调试页上的
将此组数据设置到板端。
PQTools当前版本导出的数据文件格式为.xml。
打开文件时，可通过弹窗选择仅加载数据或新建调试表。仅加载数据仅刷新调试表界面的数据，新建调试表则相当于重新启动工具，会同时刷新外挂插件，并还原至初始状态。
撤销与重做¶
如果某一次调试操作需要被撤销，单击工具栏上的“撤销”按钮（
）即可完成。要重做被撤销的操作，请单击工具栏上的“重做”按钮（
）。
打开外挂插件/外挂程序¶
工具栏的下拉框（
）列出了所有当前可用的外挂插件与程序。点击下拉框，选择需要使用的插件/程序即可。
工具只加载当前芯片支持的插件。
工具退出时，被打开的插件会同时被关闭。
由于一些外挂程序依赖连接参数，因此打开外挂的应用程序时，若工具没有与单板建立网络连接，则打开操作将被阻止。
连接单板¶
点击工具栏上的“连接”（
）按钮，工具将弹出单板连接向导对话框如图1所示。
图 1 单板连接向导
用户在“IP Address”的输入框中输入单板的IP地址（也可以点击下拉按钮选择之前连接过的单板的IP地址）并在“Port”文本框中输入端口号后，点击“Connect”，工具就会尝试连接单板。
若单板连接成功，则工具栏的“连接”按钮（
）将被禁用，“断开”按钮（
）会被激活。
断开与单板的连接¶
在已经连接单板的状态下，点击工具栏的“断开”按钮（
），即可中断与计算机单板的网络连接。
工具调试表设置¶
点击工具栏的“设置”按钮（
），打开工具调试表设置对话框。
图 1 工具调试表设置对话框
工具版本号查看¶
点击工具栏的“关于”按钮（
），工具将弹出对话框如图1所示。
图 1 工具版本号显示框
对话框中显示工具的版本信息以及各标定模块算法版本号。
界面及功能说明¶
在线调试界面及功能说明¶
调试结构界面¶
新建调试表或打开调试数据文件以后，左侧的调试表面板将显示出当前调试表的结构，如图1所示。
图 1 调试表
按照被调试功能大类的不同，调试表中设立了很多的调试页面。点击这些调试页的节点，工具会在右侧的调试区域显示调试页中包含的内容，如图 图2所示。
图 2 打开调试表中的调试页
使用搜索框可以通过关键字快速定位调试项。在搜索框中输入关键字（关键字不区分大小写）以后，按下回车键（或点击放大镜按钮），工具将自动定位到下一个包含该关键字的字段，并打开其所属的调试页面，如图3所示。
图 3 使用搜索功能
图 4 曲线页面
如果搜索字段是曲线的名字，可跳转到对应的曲线页面；
该搜索框不支持搜索3DNR参数，在3DNR页面中搜索3DNR参数。
读写通路设置¶
对于支持多Sensor通路的环境，通过TOP页面的Mode Handle项来配置，如图1所示。
图 1 Sensor通路配置
多Sensor场景下：
抓取不同Sensor的YUV文件时，需要根据配置文件中Sensor使用的ViPipe来设置Top页面对应的ViPipe编号，然后使用抓拍工具抓取对应Sensor的YUV数据图像，切换YUV抓取来源的Sensor只和ViPipe有关。
通过ISP各项功能调试不同Sensor的图像质量相关参数时，也需要根据配置文件中Sensor使用的ViPipe来设置Top页面对应的ViPipe编号，然后进行参数调试，查看图像效果变化，切换不同Sensor的图像质量调试时，通过ViPipe在不同的Sensor中间切换。
新建调试表功能和切换调试页面引发的自动数据读取受此设置影响。
具备独立通道选择功能的插件，读写通道不受主界面上通道设置的影响。
不支持AVSP功能的芯片，没有AVSGrp、AVSPipe、AVSChn三个调试项。
寄存器/算法参数调整¶
在调试表树结构中以
图标表示的调试页为“寄存器/算法参数”调试页。这些页对应的调试界面如图1所示。
图 1 寄存器/算法参数调试页（以曝光参数为例）
根据每个页面的调试子功能的不同，一个调试页面中的所有算法参数还会被分成若干个分组。
部分分组由于设备接口限制会具有一些特殊属性。这些属性会在每个分组名称的右侧进行标注。目前工具提供的分组特殊属性有：
Indi-Read：当用户点击“Read Page”或“Read All”时，本组寄存器/算法参数不进行读取操作，但仍可以通过该组的“Read”按钮进行读取；
Indi-Write：当用户点击“Write Page”或“Write All”时，本组寄存器/算法参数不进行写入操作，但仍可以通过该组的“Write”按钮进行写入。
具有特殊属性的寄存器/算法参数组示例如图2所示。
图 2 具有特殊属性的寄存器/算法参数组示例（以FPN为例）
寄存器/算法参数的查看与修改¶
每个组内都包含有寄存器与算法参数，其中标有“
”的参数行代表可写参数，标有“
”的参数行代表只读参数。参数按照其内部形式与取值范围的不同，被分为以下五类，并以不同的控件呈现，如表1所示。
表 1 寄存器/算法参数的调试项类型
类型 |
说明 |
控件操作 |
|---|---|---|
数值 |
参数的形式是具有一定取值范围的实数 |
使用以下调整面板：
可通过文本框查看当前值。修改值可以通过以下三种方式：
|
比特 |
参数在0和1中间取值 |
通过复选框查看并设定值，复选框选中时取1，未选中时取0
|
布尔 |
参数的形式为二选一 |
通过单选框查看并设定值：
|
枚举 |
参数的形式是多项（一般>3）中取其一 |
通过下拉框查看并设定值：
|
矩阵 |
参数的形式是一个多字节序列 |
调试页面会显示一个打开矩阵的按钮：
点击该按钮，会弹出一个对话框，矩阵的值会显示在对话框内的表格控件中：
用户修改表格中的值，点击空白处或者关闭对话框，即可完成矩阵值的修改。 矩阵若是只读的，用户将无法修改表格内的值，且此时打开矩阵的按钮显示文本为“View this Matrix”。 Dimension用于三维矩阵选择第三维，一、二维矩阵Dimension下拉框中只有“0”。 用户可以使用Import&Export导入导出矩阵。 |
浮点形式变换¶
部分的寄存器/算法参数分组中的某些参数具有浮点形式，它们比起实际的数值形式表意更加清晰（如曝光参数中的增益值）。在这种情况下，可以通过分组的“浮点形式变换”按钮（
）使这些参数切换到增益值，如图1所示。
图 1 参数的浮点形式变换
显示浮点数的状态下，若用户再点击一次浮点形式变换按钮，则这些参数将恢复原始数值的显示。
从板端读取数据¶
在已经连接到板端工具的情况下，点击每个分组内的“Read”按钮（
），工具就会读取组内每一项参数在单板上的数值，并显示在工具上。
将数据写入到板端¶
在已经连接到板端工具的情况下，点击每个分组内的“Write”按钮（
），工具会将组内每一个可写参数项的当前显示值写到板端。
数据的暂存与恢复¶
工具对每个调试项分组提供两组数据暂存空间，用户可以利用暂存空间临时保存调整的值进行复原或比较操作。
点击“To Set”按钮（
或
），可以将分组内当前调整好的值暂存起来。点击“Load Set”按钮（
或
），可以将暂存的值恢复到分组界面上。
数据的显示方式转换¶
选择
列表的
项，Group页面上的数据将以十进制形式显示。选择
，将以十六进制形式显示。
物理/虚拟寄存器的添加与调试¶
PQTools工具的XML格式中，对于算法参数接口和寄存器采取了不同的定义格式，因此用户并不能直接通过复制XML中已有的定义来自行添加寄存器。以下介绍如何在XML中添加寄存器到界面进行调试。
用文本编辑器（如Notepad等）打开工具的XML文件，搜索字符串“ <REG_DEF>”，找到寄存器的定义单元。XML中已经包含一些预定义的寄存器定义节点（仅作为示例，不对应任何PQ参数）
图 1 寄存器定义示例
GROUP为寄存器组的定义，ID为这个寄存器组的名称（定义后，将显示在寄存器组的标题栏中）。根据需要增加寄存器组。
REGISTER为寄存器的定义，其所支持的属性如表1所示，根据需要添加：
表 1 寄存器的属性字段
属性
存在必要性
表示含义
ID
必须
寄存器的名称。定义后，将显示在寄存器的标题栏中。
ADDRTYPE
必须
寄存器的地址类型。
0：物理地址
1：虚拟地址
默认地址类型为虚拟地址，此时该项可以选择性配置，当地址类型为物理地址时，该项必须配置。
ADDRESS
必须
寄存器的地址。
地址类型为虚拟地址时：高12bit表示mod，0x00A表示AE，0x00B表示AWB，0x00C表示ISP（客户自研3A应配置为0x00C）；低20bit表示offset，即参数项在mod中的偏移（客户自研3A应配置为 VREG_AE_OFFSET/VREG_AWB_OFFSET/VREG_AF_OFFSET+参数项offset）。
VREG_AE_OFFSET、VREG_AWB_OFFSET、VREG_AF_OFFSET的值见mpp/component/isp/user/firmware/include/isp_ext_config.h
注：可参考图1 寄存器定义示例 进行设置
ACCESS
必须
寄存器的可访问性，由下列字母中的一个或多个组成：
R：表示寄存器可读
W：表示寄存器可写
H：表示寄存器须从界面隐藏
TYPE
必须
该寄存器的数据类型。目前可支持以下类型：
OSAL_BOOL：布尔类型，等同于32位有符号整型。设置为此类型时，工具界面将显示此寄存器为布尔型界面。
OSAL_S32：32位有符号整型
OSAL_U32：32位无符号整型
对于OSAL_S32类型与OSAL_U32类型，若有效比特位只有1位（LSB与MSB相同），则工具会将此寄存器显示为比特型；否则显示为数值型。
COUNT
可选
如果寄存器为多地址连续（可理解为数组），此处可以填入元素个数。需要定义为多维数组的情况，数字间用逗号隔开。
定义此项后，工具上将以矩阵型显示该寄存器。
请注意填入的数字为不带0x的十六进制数。
LSB
可选
寄存器有效位域的最低位。如不存在该定义，取默认值0
MSB
可选
寄存器有效位域的最高位。如不存在该定义，取默认值（数据类型支持的最大位数 - 1）
RANGE
可选
寄存器在数据类型和比特数的范围限制之上进一步限制的范围。
格式为[最小值, 最大值]（中括号可以用小括号替换，表示边界值不可取）。
不存在时取数据类型和比特数限制的默认范围。
RADIX
可选
寄存器默认以哪种进制显示，可取值10或16。不存在时默认取10。
COMMENT
可选
关于该寄存器的说明。鼠标悬停在寄存器界面上时，会在状态栏显示相应的提示。
找到<FUNCTIONS>的XML节点，添加以下子节点（可以从已有的FUNCTION节点复制添加）：
其中RegGroup需要替换成步骤2中定义的寄存器组名。
保存XML文件，用PQTools工具重新打开这个编辑过的XML文件。
说明：
板端添加物理/虚拟寄存器读写请参考ISP的firmware中寄存器相关代码。
调试数据的批量读写与自动写入¶
每新建一个调试表或打开一个数据文件，读写控制面板就会显示在界面上，如图1所示。
图 1 读写控制面板
读写控制面板包含以下功能入口（所有的读写操作均需要在已连接单板状态下进行）：
全部读取按钮（
）：点击此按钮时，工具会读取调试表内所有调试项在板端的当前数值。新建调试表（未打开自动读取）或导入BIN文件后，建议执行一次全部读取操作。全部写入按钮（
）：点击此按钮时，工具会将调试表内所有调试项在工具中的暂存值写入到板端。自动写入开关（关闭状态
， 打开状态
）：开关打开时，每修改一个可写的调试项，工具就会将该调试项的新值写入板端。建议打开此功能，以保证调试值能立即生效。页读取按钮（
）：点击此按钮时，工具会读取当前打开的调试页内所有调试项在板端的当前数值。若当前打开的页面为GAMMA等支持数据读取的特殊调试页面，则会触发相应调试页的数据读取动作。页写入按钮（
）：点击此按钮时，工具会将当前打开的调试页内所有调试项在工具中的暂存值写入到板端。若当前打开的页面为GAMMA等特殊调试页面，则会触发相应调试页的数据写入动作。
曲线可视化调试¶
通用曲线功能说明¶
曲线的基本调整方法¶
曲线上有一定数量的控制点，用于改变曲线的走向。
用户将鼠标指向控制点时，鼠标指针会变为垂直调整形态（
），此时按住鼠标左键并上下移动鼠标，可以改变控制点的垂直位置，并观察此时曲线的变化。
在鼠标指针处于精确选择状态（
）的情况下，在曲线上单击鼠标左键，则工具会将当前鼠标位置映射到对应曲线上的点，并将该点变为控制点。
在鼠标指针指向控制点的状态下单击鼠标右键，则指向的控制点会被重置为普通点，不再具有控制曲线的功能。
点击“
”按钮，工具会从板端读取曲线数据，并刷新曲线显示。点击“
”按钮，工具会将曲线数据写入到板端。
如果
按钮是点亮状态，调整后的参数会自动写到板端。
曲线的高级控制¶
图 1 曲线示例一
图 2 曲线示例二
Import & Export
点击“Save Data File”，可以将当前调整的曲线数据保存到本地文件中。
点击“Load Data File”，可以从文件中读取曲线数据，恢复到当前曲线的数据集中，并显示恢复后的曲线。
工具支持保存以下三种格式的数据文件：
浮点型，保存在文本文件中的是每个数据的浮点形式（当前值与最大值的比例），取小数点后六位，范围为0.0到1.0之间；
十进制整数形式，保存在文本文件中的是每个曲线数据的十进制表示形式，与界面上对应点位的值相同，取值范围为0到最大值之间；
十六进制形式，保存在文本文件中的是每个曲线数据的十六进制表示形式，数据取值和范围与十进制相同。
Adjust
在X文本框中输入数值后，可以查看曲线对应横轴坐标上的点的纵轴值。
若当前X、Y文本框内值对应的点不是控制点时，点击“Add CtrlPt”按钮，可以将这个点变为控制点。
若当前X、Y文本框内值对应的点是控制点，在Y文本框输入新值后点击“Set”按钮，可以将当前控制点的纵轴值设置为刚输入的新值。
鼠标在坐标系中移动时，“Position”字符串显示X和Y的位置，鼠标移出坐标系则显示“Out of chart”。
Control Points
通过该区域的滑动条，用户可以快速设置曲线上控制点的数量。
Reference Set
对每条曲线提供Set1~Set5 5组暂存值，点击“Save”按钮将当前界面曲线上的值存入Set，点击“Use”按钮将已存入Set的值设置到当前界面曲线上。未进行“Save”的Set的“Use”按钮不可操作。
Reset
点击“Reset All Curves”按钮可将当前界面对应的曲线设置为起始控制点Y值为0，最后一个控制点Y值为最大值的一条直线。
Switch
通过“Gain”下拉框，用户可在不同倍率之间切换坐标系纵轴最大值。
通过“Line”下拉框，用户可在多条曲线之间切换显示。
Gamma可视化调试¶
在调试表树结构中以
图标表示的调试页为“可视化Gamma”调试页。Gamma页对应的调试界面，如图1所示。
图 1 Gamma可视化调试界面
通过设置[Enable]参数项为Enable选中状态使能Gamma。
通过Gamma COEFFI的滑条，或在滑条上方的文本框中输入数值，用户可以将可见的Gamma曲线恢复为标准的Gamma曲线（受当前选定的系数影响。系数范围为0.01到20.00）
通过Slope at Zero 的滑条，或在滑条上方的文本框中输入数值，用户可以调节gamma曲线的零点斜率的值（受当前选定的系数影响。系数范围为0.001到20.000）
勾选“Force Correctness on Drag”复选框的情况下，每次拖动控制点时，控制点的纵轴取值最大不能大于右边一个控制点的纵轴值，最小不能小于左侧一个控制点的纵轴值。
其它功能参考"通用曲线功能说明"。
DRC可视化调试¶
针对某些具备DRC模块的芯片，PQTools提供了DRC可视化调试功能。在左侧的调试表树视图中找到带有
标识的页面，点击即可打开DRC模块调试界面。
DRC使能¶
在DRC寄存器修改界面设置[Enable]参数项为Enable选中状态。
图 1 DRC寄存器设置界面
DRC色调映射曲线调试¶
PQTools工具提供了DRC色调映射曲线调试功能，通过2个或更多（取决于芯片）参数来调整DRC色调映射曲线的走向。
图 1 DRC色调映射界面
调整曲线图右侧的参数，配合观察左侧曲线走势，即可完成调整。
打开DRC可视化调整页面点击“Tone Mapping”页签，首先显示的即为色调映射曲线调试，如图1所示。图中的 Export 按钮用于从板端导出Tone Mapping曲线的各个点的纵坐标值，并保存到一个txt格式的可编辑文件中，供User-defined TM页面导入。
DRC色调TM曲线调试¶
开启PQTools调试表，在DRC页面将主标签页切换到User-defined TM，即为色调TM曲线调试，已支持鼠标左键按下框选曲线图像放大，及放大状态下右键按住拖动功能（框选时从左到右为放大，从右向左为还原），如图1所示。
图 1 DRC色调TM调试界面
请参考"通用曲线功能说明"。
饱和度修正曲线调试¶
PQTools工具提供了饱和度修正曲线的调整功能。在DRC页面将主标签页切换到Correction LUT，即可看到该功能界面，如图1所示。
图 1 DRC饱和度修正曲线界面
请参考"通用曲线功能说明"。
局部细节回叠曲线¶
PQTools工具提供了局部细节回叠曲线的调整功能。在DRC页面将主标签页切换到Local Mixing，即可看到该功能界面，如图1所示。
图 1 DRC局部细节回叠曲线界面
请参考"通用曲线功能说明"。
CLUT可视化调试¶
在左侧的调试表树视图中找到
标签，点击即可打开CLUT可视化调试界面。
CLUT在线调优基本原理¶
CLUT在线调优基于捕获的Clut模块输入图像，根据用户指定的目标方向，建立输入图像和目标图像在RGB空间的3D映射表。和CLUT离线标定工具相比，在线调优工具减弱了各个颜色之间的相互干扰。
Cap Image Online功能¶
捕获Clut模块在线输入图像。在捕获过程中，工具会自动对ISP PIPE多个模块的参数进行调整，用户会观察到预览页面图像变化。捕获完成后，会自动恢复捕获前的默认配置。推荐用户在捕获图像上选择色彩源，通过拉动HSV结点或设置RGB值的方式给出色彩目标。在Clut调优过程中，需要实时观测预览输出，判断调优是否已达标。捕获图像是Clut模块输入图像，调节Clut参数，捕获图像不会发生改变。
图 1 CLUT在线调优界面
HSV可视化界面调优¶
使能Clut，将强度设置为1024 (1x)，Clut表清零。
图 1 默认强度确认
在捕获图像上通过画框或者取点方式取RGB对的输入，同时在左侧HSV色彩空间显示源的位置，在右侧的源和目标映射区域，显示源和目标的RGB值、HSV值（目标色默认值与源相同）。
图 2 取色
选择HSV色彩空间源点附近的多个点，准备对该区域进行调整。
图 3 选择调整区域
拖动HSV色彩空间源点附近的多个点到目标方向，松开鼠标，观察预览输出是否达标，如果没有，继续调整目标位置。同时观察对其他色调的影响是否可接受，如果不能接受，需要重新选择源点范围。
以红色调整到偏橙的方向为例，将源附近的多个点向90度方向拉动，红色偏橙。
图 4 拉动红色区域结点
图 5 调整前后色彩差异 (左图是调整前，右图是调整后)
观察目标图，红色效果符合预期，但肤色偏黄，需要重新选择源点范围，避免肤色被调整。如图6，保持红色方框内颜色不动，可降低对肤色的影响。
图 6 Hue 15度方向的结点不动，避免肤色调整 (左图Hue 15调整，右图Hue 15不调整)
图 7 效果对比 (左图Hue 15调整，右图Hue 15不调整)
重复步骤4，完成其他颜色的调节。建议通过Export HSV将本次调试过程导出，后续可通过Import HSV加载历史HSV调试过程，在之前基础上，继续Clut调整。
图 8 HSV导入、导出控件
Import Clut Lut支持将Clut LUT导入，在HSV页面会显示Clut Lut对颜色做了哪些调整。通过HSV页面调节Clut，同时保存HSV.txt和Clut Lut，再通过 Import HSV导入HSV.txt，和通过Import Clut Lut导入Clut LUT，在HSV页面显示会有偏差。推荐仅用Import Clut Lut功能做辅助判断，不做为后续调整的基础。
图 9 HSV导入和Clut导入差异。左图是HSV导入，右图是Clut导入。
勾选Single Move选项，支持对HSV单个结点进行调整，相邻其他结点位置固定。
图 10 Single Move示例
取消Single Move选项，Show Tab支持在Hue, Sat维度通过填表方式生成Clut表。用户手动填表需要考虑相邻结点的平滑性。
图 11 Table 操作界面
RGB对调优¶
选择Zone0，在捕获图像上通过画框或者取点方式取RGB对的输入，同时在左侧HSV色彩空间显示源的位置，在右侧的源和目标映射区域，显示源和目标的RGB值、HSV值（目标色默认值与源相同）。
图 1 RGB对调优
设置Zone0的目标值。支持通过手动输入或者上下翻键方式设定目标RGB值或HSV值。源、目标的RGB和HSV是对应的，调整目标RGB值，HSV会自动更新；调整目标HSV值，RGB会自动更新。
图 2 设置目标值
点击Use按键，左侧HSV图根据用户期望调整的方向，调整HSV结点位置。
图 3 调试生效
观察Stream输出色彩是否达标，如果没有，继续调整目标位置。
图 4 Zone0蓝色调整效果 (左图是调整前，右图是调整后)
修改目标值，继续对蓝色块进行调优。
图 5 Zone0蓝色再次调整目标值
Hue Exp参数对应RGB映射对在色调维度的范围，取值越大，色调维度被调整的结点越多；当不希望其他颜色被影响时，可调小Hue Exp取值。在调整幅度较大时，适当增大Hue Exp可避免放大噪声。
Sat Exp参数对应RGB映射对在饱和度维度的范围，取值越大，饱和度维度被调整的结点越多；在灰色区域被影响时，可调小Sat Exp取值。
Bright Exp参数对应RGB映射对在亮度维度的范围，取值越大，亮度维度被调整的结点越多。希望亮、暗区域也进行色彩调整时，可适当调大Bright Exp范围，但也会一定程度增大暗区的噪声。
图 6 RGB对调试相关参数
完成Zone0 RGB对的调节后，可选择Zone1，继续其他颜色的调优。要求按顺序选择Zone。
图 7 多个RGB对调试
完成调试目标后，通过Export HSV按钮，可保存当前的RGB对调试设置和HSV映射表，后续可通过Import HSV基于历史调优结果继续。离线Clut标定工具通过Import RGB对方式也可以导入该结果，通过离线标定工具进行Clut调优。用户可比较2个工具的标定结果做选择。
图 8 离线Clut工具导入在线RGB对，进行Clut Calibration
Sharpen可视化调试¶
PQTools提供了专用的页面，供用户以图形化的方式调整Sharpen功能中的Luma Weight矩阵。
在左侧的调试表树视图中找到
或
标签，点击即可打开Sharpen曲线的页面。
以YuvSharpen曲线为例进行说明。
Sharpen使能¶
在Sharpen寄存器修改界面设置[Enable]参数项为Enable选中状态。
图 1 Sharpen寄存器设置界面
Sharpen Luma Weight曲线调试¶
图 1 Sharpen Luma Weight调试界面
通过Data item下拉框选择曲线对应的数据。
其它功能请参考"通用曲线功能说明"。
Sharpen Texture Strength曲线调试¶
图 1 Sharpen Texture Strength调试界面
通过Data item下拉框选择曲线对应的数据。
其它功能请参考"通用曲线功能说明"。
Sharpen Edge Strength曲线调试¶
图 1 Sharpen Edge Strength调试界面
通过Data item下拉框选择曲线对应的数据。
其它功能请参考"通用曲线功能说明"。
YUVsharpen曲线调试¶
图 1 YUVsharpen曲线界面 结构体数据导出功能
只需点击按钮并设置自己想要的名称即可将sharpen数据按照isp_sharpen_attr（具体请见《ISP 开发参考》）结构体形式导出成头文件，默认文件名为sharpen_str.h。
CA可视化调试¶
PQTools提供了CA曲线调试功能。
在左侧的调试表树视图中找到带有
标识的页面，点击即可打开CA模块调试界面。
CA使能¶
在CA寄存器修改界面设置[en]参数项为Enable选中状态。
图 1 CA寄存器设置界面
CA曲线调试¶
图 1 CA曲线调试界面
请参考"通用曲线功能说明"。
Color Palette功能¶
导入*.pal格式的色板文件，以方便快速导入YUV数据。*.pal文件格式如工具包Plugins\Data\ColorPaletteSample\glowbow.pal所示。该功能页面默认不显示，由XML文件中PQTOOLS_XML\FUNCTION（ID="ChromaAdjust"）\PARAMETERS\KEY="CP"参数值控制。
图 1 Color Palette功能界面
使用步骤：
在XML文件中，将PQTOOLS_XML\FUNCTION\PARAMETERS\KEY="CP"参数值改为VALUE="TRUE";
点击Browse按钮进行文件浏览；点击delete按钮删除对应Color Palette；
点击记录项，颜色条显示对应色板，左侧页签的调试项Y,U,V数据更新，点击Write Page按钮，参数下发板端。
LDCI可视化调试¶
在左侧的调试表树视图中找到带有
标识的页面，点击即可打开LDCI模块调试界面。
LDCI使能¶
在LDCI寄存器修改界面设置[Enable]参数项为Enable选中状态。
图 1 LDCI寄存器设置界面
LDCI LPF Coef曲线调试¶
图 1 LDCI LPF Coef曲线调试界面
调节gauss_lpf_sigma参数值，LDCI LPF Coef曲线即随之变化。
如果工具栏上
是使能状态，修改后的参数会设置到板端。
LDCI HePosWgt曲线调试¶
图 1 LDCI HePosWgt曲线调试界面
通过Data Item下拉框选择手动和自动模式，手动模式和自动模式的曲线调试方法相同。
调节he_pos_wgt结构体的wgt、sigma、mean三个参数，HePosWgt曲线即随之改变。如果工具栏上
是使能状态，参数设置到板端。
LDCI HeNegWgt曲线调试¶
图 1 LDCI HeNegWgt曲线调试界面
通过Data Item下拉框选择手动和自动模式，手动模式和自动模式的曲线调试方法相同。
调节he_neg_wgt结构体的wgt、sigma、mean三个参数，HeNegWgt曲线即随之改变，如果工具栏上
是使能状态，参数设置到板端。
Dehaze可视化调试¶
在左侧的调试表树视图中找到带有
标识的页面，点击即可打开Dehaze模块调试界面。
Dehaze使能¶
图 1 Dehaze寄存器设置界面
在Dehaze寄存器设置界面设置[en]参数项为Enable选中状态
Dehaze曲线调试¶
图 1 Dehaze曲线调试界面
通过Dehaze COEFFI的滑条，或在滑条左边的文本框中输入数值，用户可以将可见的Dehaze曲线恢复为标准的Dehaze曲线（受当前选定的系数影响。系数范围为0.01到20.00）
其它功能请参考"通用曲线功能说明"。
MCF可视化调试¶
生态版本不支持MCF功能。
MCF调试必须在MCF业务时才能使用。目前仅支持SS928V100解决方案。
在左侧的调试表树视图中找到带有
标识的页面，点击即可打开MCF模块调试界面。
图 1 MCF 曲线调试界面
共有4个页签，UV曲线仅Alpha页签支持可调，其余3条曲线LF、MF、HF4个页签都支持可调。
MCF曲线无特殊使用方式，使用方法请参考 "通用曲线功能说明"。
PreGamma可视化调试¶
在左侧的调试表树视图中找到带有
标识的页面，点击即可打开PreGamma模块调试界面。
图 1 PreGamma调试界面
通过设置[Enable]参数项为Enable选中状态使能PreGamma。
拖拉控制点调整参数，PreGamma Linear及PreGamma Log 同时生效。
其它功能参考"通用曲线功能说明"。
3DNR曲线可视化调试¶
op_mode设置为OP_TYPE_MANUAL，可设置MANUAL组（“Write Page”跳过AUTO组，提示“skip auto!”）；
op_mode设置为OP_TYPE_AUTO，可设置AUTO组，（“Write Page”跳过MANUAL组，提示“skip manual”）。
在左侧的调试表树视图中找到带有标识
的页面，点击即可打开3DNR曲线调试界面。
图 1 3DNR曲线调试界面
点击“Export All”按钮把Manual和Auto所有模式的曲线的值导出到一个txt文件中。
点击“Import All”按钮从一个txt文件导入数据到Manual和Auto所有模式的曲线中。
其他参考 "通用曲线功能说明"。
BNR曲线可视化调试¶
在左侧的调试表树视图中找到带有
标识的页面，点击即可打开BNR模块调试界面。
图 1 BNR曲线调试界面
功能参考"通用曲线功能说明"。
MeshShading曲线可视化调试¶
在左侧的调试表树视图中找到带有
标识的页面，点击即可打开MeshShading模块调试界面。
图 1 MeshShading曲线调试界面
OffsetX和OffsetY是设置MeshShading分块的中心点，取值范围[0,32]，都取0时为图像左上角的分块，都取32为图像右下角分块，以此类推，默认取[16,16]。
在界面上修改OffsetX和OffsetY的值，软件计算出中心到边缘的最大值X，该值是调试曲线的横坐标Distance from center，X为一个归一化的值，X的取值范围[128,256]，X取128时，Offset取的是中心块，X取256时，Offset取的是任意四周上的块。
界面上Resolution Width和Resolution Height的值，是从PubAttr结构体中的wnd_rect.width和wnd_rect.height获取的，仅做参考用。
通过下拉框选择MeshScale，刷新对应的值到曲线上，不同的MeshScale会对应不同的默认值（1倍增益），请在选取合适的MeshScale后再调试曲线，切换MeshScale会导致增益表刷新，之前调试的结果丢失。
改变OffsetX/OffsetY后，必须调试曲线后增益值才会刷新。
点击“Save ShadingLut Data File”按钮，生成一个默认文件名为alg_lsc_calib_info的.h文件，文件中保存的数据按照结构体格式，保存了Shading Lut Attr结构体中的x_grid_width，y_grid_width和lsc_gain_lut的值。
其他功能参考"通用曲线功能说明"。
3DNR可视化调试¶
与其他寄存器和算法模块不同，3DNR功能复杂且限制较多，因此进行了单独设计。以下均以SS928V100的X接口为例说明。
在调试表中点击名称以3DNR_X起始的调试页，即可打开3DNR调试界面，如图1所示：
图 1 3DNR X_MANUAL调试界面
左侧的树形控件列出了在当前页面下可以调整的3DNR模式（一级节点），以及模式下可调整的3DNR数据集（二级节点）。每一个3DNR模式（或处于该模式下的数据集）节点被点击时，界面右侧均会显示该模式的调试界面。
对于调试界面：
数据集自上而下排列，并具备独立的标题栏：
点击数据集标题栏中的“Export”按钮，可以导出数据集中的调试数据到以.txt结尾的文件(数据格式按数据参数的界面显示)中，以明文形式保存；
点击数据集标题栏中的“Import”按钮，可以导入之前导出的txt数据。
点击“Export Auto All”按钮，可以将整个Auto模式页面的数据导出到文本文件（每组Auto数据格式按数据参数的界面显示，增加ThreeDNRCount、IsoThresh、3DnrParam_*等字段和部分注释）中，点击“Import Auto All”按钮，可将导出的整体数据导入到界面显示。
对于自动模式（左侧列表中名称以AUTO结尾的模式），每个数据集具备ISO值。在数据集标题栏的右侧可以编辑ISO值。
“To Set1”，“To Set2”和“Load Set1”，“Load Set2”两组按钮，可以保存两组设置参数，方便用户调试。点击“To Set1”按钮将界面的设置参数缓存起来，点击“Load Set1”按钮将缓存的设置参数显示在界面，“To Set2”和“Load Set2”操作相同。
多个输入框对应1个变量标记的情形，表示该变量本身为数组，或者是某个作为数组的结构体中的成员。对应数组下标从小到大的变化，文本框从左到右排列；
文本框为淡黄色背景的，表示对应的参数为可以更改的参数。这些值的各种组合，对应 3DNR的各种能力和风格；
文本框为淡紫色背景的，表示对应的参数不建议设置，这些成员通常应该取默认值，在某些极端情况下也许取其他值效果更好些；
文本框为白色背景且无法编辑的，表示对应的参数不应被设置，它们在任何情况下都应该取默认值。工具上无法修改这类参数的值。
支持键盘操作：Tab键切换文本框，支持“↑”“↓”增减参数值。
当存在有Auto页面时，Manual页面可以通过ISO下拉框选择需要拷贝的Auto页面。点击“Copy From”按钮，就可以将与ISO值对应的Auto页中的所有数据拷贝到Manual页面中。3DNR的具体调试建议请参照文档《SSXX 3DNR参数配置说明》。
在左侧的树形控件上右键点击3DNR模式节点，可以进行模式相关的操作，如图2所示：
图 2 3DNR模式右键调试界面
Add Data Set：在该模式下追加一个新的数据集（至列表末尾），若所选模式为自动模式，则新数据集的ISO值与其上一个数据集相同；
Sort：对模式下所有数据集按ISO从小到大的顺序进行排序；
Read：单独对所选模式进行板端读取操作；
Write：单独对所选模式进行板端写入操作；
Export：整体数据导出，以明文形式保存，导出格式支持按结构体(3DNRX_STRUCT_TYPE)和界面排布(3DNRX_DEBUG_TYPE)两种；
Import：整体数据导入。
在左侧的树形控件上右键点击数据集节点，可以进行数据集相关的操作，如图3所示：
图 3 3DNR数据右键调试界面
Insert Data Set：在所选数据集的下方插入一个新的数据集，若所选模式为自动式，则新数据集的ISO值与所选数据集相同；
Delete Data Set：删除所选数据集。
Search：在页面左上角的编辑框中输入要查询的字段，不区分大小写，点击“Search”按钮或按下“Enter”键，如果可调项名字中包含搜索的字段，将该可调项名字设置为橙色，并将界面滚动到该可调项所在位置如图4所示。
图 4 3DNR X搜索页面
在PQTools工具的读写工具栏上点击
按钮，可以对全部的3DNR模式执行板端读取操作；点击
按钮，可以对全部的3DNR模式执行板端写入操作。
每个模式下的数据集都有一定的数量限制（一般对于手动模式是只有1个，自动模式为多个）当一个模式下数据集数量达到其最大值时，用户将无法添加新的数据集；而当一个模式下只剩1个数据集时，该数据集无法删除；
对于自动模式，若数据集间的ISO值不为自上而下的递增状态，则将该模式下的调试数据写入板端时可能会失败。因此建议用户在将自动模式的数据写入板端前，先对该模式执行排序动作。
对于自动模式，如果工具从板端读取数据全为0，界面不显示Auto模式下的可调项，此时操作“Write”板端报错，需操作“Add Data Set”添加第一组数据集（参数默认最小有效值，自动写入板端）。
使用3DNR可视化页面前须修改NR页面的3DNR_ATTR组中的参数：OptMode设置为OPERATION_MODE_MANUAL，可设置3DNR可视化页面的MANUAL组（“Write Page”跳过AUTO组，提示“skip auto!”）；OptMode设置为OPERATION_MODE_AUTO，可设置AUTO组，（“Write Page”跳过MANUAL组，提示“skip manual”）。
设置3DNRAttr中OptMode的Auto或Manual模式后可以调试3DNR对应的参数并生效，若只选择OptMode的Auto或Manual模式3DNR对应的参数并不生效，重新Read后OptMode显示当前生效的模式。
导出的3DNR文件支持参数修改后导入，但不能改变数据解析结构。
3DNR界面排布是根据芯片特性进行排布，各芯片界面存在差异。
板端不会同时保存Auto和Manual模式的数据，因此重新打开PC端工具时，仅能读取到一种模式的数据。
FPN矫正¶
在左侧的调试表树视图中找到FPN的页面，点击即可看到FPN标定矫正页面如图1。
图 1 FPN标定矫正页面
FPN矫正功能使用前必须优先进行标定操作生成矫正用数据，工具可以通过配置板端版本路径中的config.cfg文件 bSaveFPN 来决定是否将标定产生的raw数据保存成文件。不使能时，保存在工具申请的内存中。
FPN矫正页分为三个 group 如图1。
分别为：
FPNCalibrate：设置标定参数及标定。设置好参数后点击Write即可。
FPNCorrection：使用上一步生成的标定数据结果进行FPN矫正。选择OpType，设置Strength 数值 及Enable 为Enable状态后 点击 Write按钮 进行板端业务 FPN 矫正。
FPNCorrection Attr：在使用PQTools工具或者其他方式进行过一次矫正操作后，可以通过此group 进行fpn效果细节参数的调节。
ISP标定工具¶
概述¶
由于镜头和图像传感器市场成熟度高，市场上有大量不同光学特征的镜头以及不同电气特征的传感器。ISP中某些模块无法自动对这些特征统一补偿，使得图像的效果与期望效果有一定偏差。因此本标定工具主要以目前仪器设备获得的图像、期望图像等为输入，协助仪器设备最终的输出能够更好地逼近期望效果。
PQTools工具提供了黑电平（BLC）、NR、ACS、MLSC、RGBIR、CCM、AWB、CLUT等8个ISP模块的参数标定功能。根据各自的算法原理，它们之间有如图1的顺序关系。
图 1 标定模块的流程关系
其中，AWB和CCM标定模块之间不互相依赖，在LSC(MLSC)标定结束后即可进行； NR标定模块在黑电平确认后即可进行，不受其它标定模块影响。
具体的标定操作要求和建议可参考SDK文档《ISP 图像调优指南》。
标定工具的界面与基本操作¶
从PQTools工具主界面工具栏中的附加组件下拉框中选择“PQTools ISP Calibration Tool”，即可打开标定工具。如图1所示。
图 1 标定工具界面
如图1所示，绿框区域为导入需要标定的Raw的基本信息及列表，蓝框区域为输入的Raw的基本属性及BLC参数设定，红框区域为各标定算法工作区域。
设置RAW基本属性¶
在软硬件配置相同的情况下，标定所使用的所有RAW文件，其分辨率、位宽、分量排序的参数通常都是相同的。使用标定工具时，可以通过蓝框区域的Edit Options按钮进行RAW文件的统一配置。如图1所示。
图 1 RAW文件配置对话框
用户需要设置：
RAW图像的宽度（最小120，最大8192，必须是2的倍数，标定LSC时必须是4的倍数，否则shading功能会不正常）
RAW图像的高度（最小120，最大8192，必须是2的倍数，标定LSC时必须是4的倍数，否则shading功能会不正常）
RAW图像的位宽（支持10 bits、12 bits、16bits）
分量排序（RGGB、GRBG、GBRG、BGGR）
红外分量替换（IR Pattern，仅用于标定RGBIR sensor，可选择替换常规sensor的Gr或Gb分量。如果基于常规sensor标定，请选择No IR）。
设置以后，点击“OK”按钮保存。之后导入的所有RAW文件均会按此设置来进行操作。
导入RAW文件¶
完成Raw的基本属性设置后，可通过绿框区域中的“Open RAW Files”按钮，导入标定所需的RAW文件。点击按钮后，选定需要导入的RAW文件，并点击“OK”按钮。之后，工具会弹出确认对话框，如图1所示。
图 1 导入确认对话框
该对话框会列出所有即将被导入的RAW文件的路径，并提供用户选择RAW数据场景的接口。用户可以从以下几种场景中选择一个指定给导入的RAW文件：
Color Check 24：24色卡场景，可用于NR、CLUT、RGBIR、AWB、CCM标定；
Color Check 140：140色卡场景，可用于AWB和CLUT算法标定；
Black：全黑场景，用于黑电平标定（BLC）；
Flat Field：平坦场景，用于MLSC、ACS标定。
用户指定场景后，点击“OK”按钮，即可导入文件。被导入的RAW数据将在工具主界面左边的列表中显示。
图 2 列表显示导入的RAW数据
列表除显示导入的RAW数据的基本信息，还提供了一些操作接口：
第一列可进行勾选，以被标定模块导入使用；
Tag列为RAW数据的别名，可点击进行修改（默认为导入RAW的文件名）；
PV列为预览按钮，单击可预览图像。对于Flat Field场景的RAW数据，工具显示其黑白图像，否则显示插值运算后的彩色图像；对于24或140色卡场景的RAW数据，还可以进行色卡选框，选框调节默认为“Coarse”模式，可统一调节所有选框的大小和位置。Coarse复选框未勾选时为“Fine”模式，此模式下可独立调节单个选框的大小和位置，也可多个选框一起调节大小。
Temp.列为色温值，可预先设置，并导入到AWB和CCM标定中使用；
Del列为删除按钮，可以将导入的RAW数据从列表中清除。
标定配置保存导入¶
保存导入功能支持用户保存和导入标定工具现场配置（标定配置，文件路径，间接数据，辅助数据等），原则上只保存和导入用户手动输入数据，不保存和导入标定后生成的数据。
点击“Save”按钮，将配置信息保存到文件名格式为“芯片名_ISPCalibration_时间戳.xml”的xml文件中。
点击“Load”按钮，将选择的配置文件导入工具后，工具恢复之前的配置。
保存的XML文件的格式不可修改，可以修改参数值（不建议修改）。
黑电平的标定¶
黑电平标定基本原理¶
模拟信号很微弱时，有可能不被A/D转换出来，导致光线很暗时，图像细节丢失。因此，Sensor会在A/D转换前，给模拟信号一个固定的偏移量，保证输出的数字信号保留更多的图像细节。
黑电平校正模块就是通过标定的方式，确定这个偏移量的具体值。后续的ISP处理模块，需要先减掉该偏移值，才能保证数据的线性一致性。
黑电平标定支持的模式¶
在ISP标定工具中，黑电平支持两种形式的标定：手动输入黑电平模式以及使用黑帧进行自动黑电平标定模式。
如果在进行标定之前，事先已获取了sensor的黑电平参数（通过Sensor介绍文档，或者使用其他黑电平标定工具获得），则可点击标定工具右上角的Black Level Settings按钮，在弹出的对话框中，直接输入各分量的值。之后的其他标定模块在进行标定时，工具会根据需求自动调用此数值。手动输入黑电平模式的界面如图1所示。
图 1 黑电平设置对话框
黑电平标定序列采集要求¶
如果事先未获取到sensor的黑电平参数，或者需要获得更精确的黑电平数值，本标定工具亦提供了自动标定黑电平的模式。在标定之前需要用户手动采集黑电平标定所需输入的Raw，采集步骤如下：
将设备的光圈完全关闭，或者使用镜头盖将镜头输入遮挡，确保无光线进入；
通过PQTools的ExposureAttr标签，手动设置整个系统的增益为1x。具体操作方法如下：将Exposure和Exposure Manual选框中的所有OpType设置为OP_TYPE_MANUAL，同时将Exposure Manual选框中的AGain、DGain、ISPDgain手动设置为1024；
使用PQTools Capture Tool抓取一个Raw文件。
通过以上三步，即可得到黑电平标定需要的Raw。采集到的Raw如图1所示。
图 1 黑电平输入Raw示意图
黑电平标定步骤¶
采集到标定算法所需的Raw后，用户可按照以下方法进行黑电平自动模式的标定：
按照"标定工具的界面与基本操作"节的描述，在标定工具主界面导入Raw文件，选择为Black场景，并勾选。
点击Black Level Calibration按钮，在弹出的对话框中点击确定
黑电平标定结果说明¶
完成标定步骤后，标定工具左下角的状态栏中会显示Ready字样，此时打开Black Level Settings对话框，会发现原先为0的各分量黑电平已显示有值，如图1所示。
图 1 黑电平标定结果示意图
生成的黑电平值与Raw数据位宽匹配。当前标定工具不支持自动导入黑电平，因此用户需要手动将标定结果配置到对应的sensor驱动文件以及PQTools中。
RGBIR标定工具¶
RGBIR标定原理¶
本文中所述RGBIR sensor为RGBIR4x4排列的sensor，sensor中的pattern顺序，如图1所示。
图 1 RGBIR 4x4 Pattern
RGBIR sensor由于有一个红外分量，通常使用双通滤光片，此时仍然有红外光照射在sensor表面，因此要先通过算法将R、G、B通道上的红外光去除掉，恢复出各通道正确的颜色，起到传统红外截止滤光片的作用。
ISP中的RGBIR模块使用一个矩阵来对输入颜色进行处理，以去除红外光数据。使用相同场景下带红外分量的颜色数据和不带红外分量的颜色数据计算出这组矩阵的过程，即为IR标定过程。
RAW图像采集步骤¶
采集步骤如下：
在待标定光源环境（阳光直射、或A光源）下，尽量保证色卡光照均匀，没有阴影。等待光源稳定，并保证sensor使用的是双通滤光片。
硬件上电，在工具上确认以下参数。
图 1 IR标定参数确认——RGBIR参数
图 2 IR标定参数确认——RGBIR矩阵
将AE compensation设置为0x40或者更大，要求此时图像尽可能亮而且没有色块过曝（像素值达到最大值）。
Freeze整个FW（目的是固定此时的AE参数，采用其他方式达到此目的也可以），使用抓拍工具采集一帧RAW数据，命名保存。
增加红外截止滤光片（切换IR_CUT为红外截止滤光片或者将红外截止滤光片放置在镜头前）。
使用抓拍工具采集另外一帧RAW数据，命名保存以IRCut为标注。
RGBIR标定界面与功能¶
将标定工具的主功能标签页切换到RGBIR，即可看到RGBIR标定的界面。如图1所示。
图 1 RGBIR标定界面
其中工具上方的工具按钮提供导入RAW图像、设置RAW图像、标定、导出结果和将结果发送到板端的操作接口，下方左侧的列表记录导入的RAW文件，右侧的文本框直接输出标定结果到屏幕，并支持标定结果的导出及下发板端功能。
同时提供将RGBIR 4x4格式的Raw转换为指定Pattern顺序的Bayer Raw功能。
RGBIR标定的操作流程¶
进行IR标定，请遵循以下流程（后面章节中，将进行各个操作流程的说明）：
参照"设置RAW基本属性"章节的描述，指定RAW数据的基本属性。特别是要正确的选择IR Pattern的类型，IR Pattern和Bayer是互斥的。
参照"导入RAW文件"章节的描述，在标定工具主界面导入所有所需的RAW数据（包括含红外分量的RAW数据，及对应不含红外分量的）。
在RGBIR页面导入1-4对RAW文件配对（24色卡场景限定）。
对导入的RAW数据进行24色选框。
进行标定。
导入RAW文件并选定24色区域¶
在标定工具主界面导入好所需的RAW文件后，勾选其中的一对含红外/去红外配对的RAW文件，如图1所示。
图 1 选定要进行IR标定的RAW数据
选择好文件后，回到RGBIR页面点击“Import RAW Pair”按钮，即可将这一对RAW文件导入为一个标定实例，如图2所示。
图 2 RGBIR标定实例
工具默认将顺位靠前的RAW数据指定为含IR，顺位靠后的RAW数据指定为不含IR。如果对应关系不正确，请点击SW列的按钮，将对应关系交换即可。
点击第一列的红叉按钮，可将导入的RAW配对删除。
点击ROI列的按钮，会弹出24色框选对话框，如图3所示。
图 3 RAW图像数据的24色取框
分别在两个图像上拖动四角的手柄以改变取框的排布，使其对准图像上的24色区域即可。如需要调整取框的大小，则拖动对应图像上方的Patch Size滑块即可。选框时，使色框尽可能大（但需要每个色框内所有像素颜色几乎相同），这样可以使取到的分量平均值更加精确，从而得到更准确的标定结果。注意：IR Pattern的RAW图像在工具上会显示为黑白图。
进行标定¶
当用户输入了1组或者多组RAW文件后，即可进行标定。点击上方的“Calibrate”按钮后，工具将执行标定算法，并输出结果。右侧的文本框显示的是当前选中的那组RAW的标定结果。如图1所示。
图 1 IR标定结果输出
导出IR标定结果¶
标定完成后，点击“Export IR Matrix”可将IR矩阵保存为文本文件，文件中包含每一组RAW文件的标定结果，用with IR的RAW文件名来标识每个矩阵。选取保存路径后点击确定，即可保存成功。
将标定结果发送至板端¶
标定完成后，点击“Apply IR Matrix”可将当前选中的那组RAW的标定结果发送至板端直接生效。
将RGBIR4x4 Pattern的Raw转换为Bayer格式¶
本工具也支持将任意输入的RGBIR 4x4 pattern的Raw转换为Bayer格式。以方便用户对RGBIR sensor进行AWB、CCM标定。
注意：由于RGBIR sensor本身的感光特性，导致经过转换的Bayer数据的标定结果可能无法那么准确，尤其在A光源这样的本身IR分量较大的光源下。因此推荐如果想得到相对准确的AWB、CCM标定结果，可使用和RGBIR sensor相同型号的RGB sensor进行标定，将标定结果用于RGBIR sensor可以得到较好的图像效果。
点击工具界面上方的Convert按钮，即可进入转换功能，转换界面如图1所示。
图 1 RGBIR转换功能工具界面
其中Raw Out Pattern为所需要转换出Raw文件的Bayer Pattern的格式，无论RGBIR的Raw的输入形式为何，本工具支持任意Bayer Pattern的输出。
RawOut black level的复选框表示输出的Raw是否需要带黑电平，如果是需要将Raw用来做AWB和CCM标定，建议勾选。
Raw Select (IR)为需要进行转换的带IR分量的Raw。用户需要手动从已导入ISP标定工具左侧Raw列表已经导入的Raw中进行选择。
Save Path为用户指定的转换后的Raw的所在路径，工具自动将转换后的Raw命名为Raw Select (IR)中的文件名加后缀_IRRemoved，并保存在指定路径中。
Convert Matrix为用户指定的转换矩阵，默认使用单位矩阵，推荐在对D50及以上色温的光源采集下来的Raw进行转换的时候使用该默认矩阵。本工具也支持用户将RGBIR的标定结果进行导入，用来进行数据转换。首先选中RGBIR标定页面Raw标定列表中想要使用的哪一组Raw，然后点击转换界面的CaliResult Import按钮即可。
Exp Ctrl和Gain是在转换过程中对数据进行曝光控制，具体使用方法请参考《ISP 图像调优指南》的RGBIR部分（4.25节）的内容。推荐保持默认参数不动。
具体转换步骤为：
选择Raw Out Pattern为需要输出的Bayer Pattern的格式，并选择需要进行转换的带IR分量的Raw。
通过Browse按钮设置需要保存的raw的路径，设定后再设定对应的Convert Matrix的值。
点击Convert按钮，即可完成转换。
注意： 由于RGBIR的感光特性，A光源下的转换结果可能无法准确进行AWB和CCM的标定。另外转换前和转换后的Raw数据位宽一致，均为载入Raw时设定的初始化位宽。
NR标定¶
NR标定基本原理¶
噪声是图像传感器的主要参数。对于任何一个图像传感器，每个像素都存在一定的感光模拟误差和模数转换误差，因此输出的数据也存在误差，一般意义上称为图像传感器噪声。
影响图像传感器系统的噪声主要有散粒噪声、热噪声和固定模式噪声等形式。为了使得NR运行中更加精准地区分噪声和细节，需要一个模型来描述图像传感器本身的噪声特性。
为了得到图像传感器的噪声模型，需要在灯箱环境下拍摄24色卡。 在一个ISO值下，拍摄得到的24色卡中每个色块对应一个亮度值，通过对每个色块的“亮度均值”和“亮度方差”进行分析，可以建立“亮度 — 亮度分布密集程度”这样的模型去描述图像传感器的噪声特性。若每个非过曝色块内亮度分布非常集中，则说明该图像传感器整体噪声小。当然，对于不同的ISO值，噪声强度是不一样的，所以需要进一步知道各个ISO下的噪声强度。
在NR运行时，若当处理块内“亮度方差”与“标定值(色卡块内的平坦区域)”接近，则表示当前处理块内不存在“可靠”细节，反之，则认为存在“可靠”细节。
NR标定模式介绍¶
新升级的标定算法支持适配HNR/BayerNR的简单模式simple mode。在简单模式下，采集标定数据的时候，dgain固定设为1倍，只需要采集iso100到again打满的iso档位下的raw数据进行标定即可。简单模式不仅数据采集更加方便，而且能够避免之前标定工具在高iso下受噪声截断影响带来的标定结果不准确的问题，所以我们推荐使用新的简单模式进行标定。
NR标定序列采集要求¶
NR的标定数据采集的重要点如下：
前期准备包括：D65光源下的灯箱、需要标定的镜头+sensor、标准24色卡。色卡如图1所示。
图 1 标准24色卡
将色卡固定在灯箱里面，灯箱照度保持在400lux左右，保持照度均匀。将镜头固定，调整镜头与色卡的距离，使得拍摄到的色卡覆盖整个成像屏幕的1/2左右，如图1所示。
ISO设置：
将镜头光圈调节到最大，操作人员设置所需要的ISO值，然后调节曝光时间，使拍摄的色卡左下方色块的亮度达到最大值（跟位宽有关，12bit为4095）的80%（比如，dump出一帧raw，用imageJ打开，用鼠标框出亮色块，ctrl+H快捷键查看色块的直方图分布，计算色块的最大亮度与实际的最大亮度比值）。
注意：左下方色块不能出现过曝，即所有亮度值都小于最大值。
亮帧图像采集：
当图像满足步骤2中要求时，抓取N帧raw数据（N取30帧左右），N帧raw存放在同一个文件里，名字按照filename_bright_isoxxx.raw的方式命名（filename表示原文件名，xxx为测得RAW的ISO值）。注意：拍摄过程中，请不要移动镜头和色卡 ，色卡附近不要有人、物体移动，以免影响环境光使抓取的raw数据帧与帧之间数据不一样。
暗帧图像采集：
保持ISO不变，通过下述方法降低大约4EV曝光量（任选一种）：光照强度减小为原来的1/16；曝光时间减小为原来的1/16；光圈大小减小为原来的1/4；在镜头前盖上1/16减光片。然后抓取N帧raw数据（N取30帧左右），文件命名filename_dark_isoxxx.raw，拍摄注意点与亮帧图像采集相同。
重复步骤3-5，直到获得所有需要的ISO范围。ISO取值范围为[100左右]，[200左右]，[400左右], [800左右]，[1600左右], [3200左右]，[6400左右]，[12800左右]，[25600左右]，[51200左右]，[102400左右]，[204800左右]，ISO的取值范围覆盖尽量广。
注意，新的NR标定工具推荐使用简单模式，这时只用采集到again 打满对应的ISO即可，后续ISO可不用采集（比如again max=62416，这时只需要采集到ISO=6095即可）。
黑帧图像采集：
采集完各个iso档位的亮帧和暗帧数据后，需要采集黑帧数据，将所有外界光源关闭，并完全遮挡住镜头（可以使用镜头盖），和步骤6相同的ISO采集数据。ISO档位要求从iso100采集到对应again 打满的iso档位。文件命名可参考filename_black_iso150.raw。
拍摄过程中，请不要移动镜头和色卡，色卡附近不要有人、物体移动，以免影响环境光，从而影响raw数据质量。
由于NR标定算法需求，每个ISO档下固定需要采集亮，暗，黑帧数据（simple mode），帧数分别不低于30帧，最高帧数不高于500帧，由于帧数过多会导致标定时间较长，所以标定数据的帧数建议取30帧。
同一ISO档，NR同时参考亮暗帧标定时，亮暗帧的标定结果会进行融合，最后标定结果仍是一组参数，而不是分开的两组参数。
NR标定工具界面介绍¶
采集图像后，打开ISP标定工具，并切换至NR页面，即可看到NR标定工具的界面，如图1所示。
图 1 NR标定工具界面
NR标定工具界面可以划分如下三个区域（如图1所示）
raw图像显示区域：在图中绿色框区域，对选中的raw图像进行显示。用户可以根据图像显示手动调节标定区域，使得红色标定框位于各个色卡范围内；按钮“Import Bright Raw”用于导入亮帧raw数据，按钮“Import Dark Raw”用于导入暗帧raw数据，按钮“Import Black Raw”用于导入黑帧raw数据，被导入的raw数据名称会显示在下方红色方框的对应区域内。另外，支持从文件名中解析亮帧和暗帧Raw文件，通过“Dark”，“Bright”, “Black”判断Raw属性,解析暗亮帧RAW文件支持全大写，全小写和首字母大写，如果点击导入按钮不匹配时会报错提示。Again Max值可以使用“Get Again Max”按钮从板端获取，也支持手动输入配置；
标定raw数据列表区域：在图中红色方框区域，会显示被导入进行标定的raw数据文件名称，对应的ISO值以及raw数据的帧数。导入的亮暗帧文件会分Bright和Dark显示，并会根据输入文件的ISO值对应进行配对。黑帧会在Black显示，不与亮暗帧配对；
标定结果显示区域：在图中蓝色框区域，能够进行标定的操作和标定结果的查看。按钮“Calibrate”开始进行标定，“Save NR K Curve”和“Export Header”分别用于导出标定过程量（曲线数据）和导出标定结果，标定完成后，标定过程量会以折线图的形式显示在图中。 按钮HNR Result Judge弹出标定结果评分页面。
须知：
工具界面上配置的Again Max(ISO Value)需要依据sensor最大模拟增益对应的ISO值进行配置。点击Get Again Max按钮，从板端获取的值会自动转换成iso值。
导入的RAW文件命名时，ISO值前需添加"iso"标识，Import之后才会自动识别显示出ISO值，否则Import后要手动输入ISO值。如果Import RAW文件后ISO值未能自动识别，建议先导入全部RAW数据，再设置ISO值。
NR标定步骤¶
使用标定工具进行NR标定的步骤如下：
参见"黑电平的标定"章节，确定待标定设备的黑电平值；
在工具最左侧的RAW Data列表中，导入刚抓拍好的黑帧raw图像和24色卡类型RAW图像；
勾选参与标定的RAW图像，并在NR标定界面点击“Import Bright Raw ”和“Import Dark Raw ” 和Import Black Raw”按钮分别将它们引入到标定界面；
修改每个24色卡类型RAW文件的选框、ISO值（如文件名中带有_isoxxx字样的标示，工具可自动解析其ISO值）和帧数。文件帧数可以被自动识别，也可以手动输入。
点击标定界面右上角的“Calibration”按钮。
标定结束后，工具将显示标定出的ISO/K曲线图，如图1所示。
图 1 NR标定结果
NR标定结果的显示和导出¶
标定结束后，用户可以点击“Export Header”按钮，将当前的标定结果保存为.h文件。该.h文件中的内容可以直接用于板端头文件。
标定完成后，工具会显示ISO/K曲线，客户可以进行标定结果的比对和查看，也可以点击“Save NR K Curve”导出ISO/K数据。
NR标定结果说明¶
标定结果直接影响到NR的去噪效果，以图1为例，左图没有对噪声模型参数b做标定，右图对噪声模型参数b做了标定，可以看到，右图中的颗粒噪声明显改善。
图 1 NR 标定图像效果的影响
NR标定结果验证¶
为了对噪声模型标定结果进行验证，标定工具支持在线对标定参数进行验证，具体方式为：标定工具在线连接板子，获取板端标定参数，并计算出当前iso的kb值，绘制出kb曲线，同时支持客户在线抓raw（最小2帧），并在raw上面选取相关区域进行噪声方差计算，将计算结果和标定参数理论计算值进行对比，给出相应的误差比例，当误差比例过大时，说明当前标定参数不准确，建议客户重新进行噪声模型参数标定。
使用进行NR标定结果验证的步骤如下：
NR标定结果验证是连接单板在线分析的,使用之前需要先在单板上运行业务, PQ工具连接到单板；
从PQ工具主界面工具栏的外挂插件下拉框中选择“PQ RAW YUV Analyzer”，选择右上角Online debug进入NR标定结果验证界面；
点击Online debug下方的BITS下拉框选择(8-16)bits，点击Prepare Data抓拍RAW图像,等待抓拍后的图像载入界面；
用鼠标左键点击选划定合适的平坦区域，左侧列表会显示该区域的均值和方差结果，(如果默认的图像大小划定区域困难，滑动鼠标滚轮来缩放或调整图像，Clear All ROI按钮可以清空左侧列表和图像的划定区域)；
点击左下角的Create Chart，工具将显示NR标定结果曲线和验证区域的结果图像,如 图1 显示。
图 1 NR 标定结果验证
如 图1所示，在线抓raw验证后，可以观察红色的采样点和蓝色的理论标定曲线之间的吻合程度，如果偏离较远，说明标定参数可能存在问题。客户也可以参考工具计算给出的最大相对误差比例max_err，如果max_err>50%，建议客户重新审视标定参数的正确性。
NR标定结果评分¶
为了客观评价NR的标定结果对当前的这个Sensor适用性， 工具增加了标定结果评分功能。
图 1 NR标定结果评分界面
NR标定结束后点击 HNR Result Judge按钮弹出评价窗口图1所示。
正常标定结束，默认显示当前标定结果评分。
支持导入历史导出头文件结果进行评分。通过Result From下拉菜单进行切换，点击Browse导入文件。
File Path显示导入文件路径，不可修改。
支持修改入参 Min ISO 以及 Max ISO 来重新进行评分。
评分分为三档：SUPPORT(正常可用)， RISK(有一定风险)，NOT SUPPORT(不支持)。当评分不是SUPPORT时， 请参考最下方建议进行处理。
点Browse导入文件，切换Bin Name、Mode，修改Min ISO、Max ISO会刷新评分。
K Curve To Header使用说明¶
K Curve To Header功能支持从Save NR K Curve获得的头文件转换为Export Header的头文件。 NR标定参数是由kb值计算得出，因此当无法找到NR标定结果文件时，若能提供kb值文件，则可由kb值文件计算出NR标定结果。需要注意的是，由于文件中的kb值存在精度损失，因此转换得到的NR标定结果通常会存在轻微差异，但这不会影响NR标定结果的使用。
MLSC标定¶
MLSC标定基本原理¶
通过研究发现，在Lens Shading现象中，目标点的亮度衰减趋势符合余弦四次方定律。对于同一个镜头模组，其成像亮度只会随着成像点和光轴之间的成像角度变化而变化。并且其变化趋势为：与成像角度的余弦值的四次方成正比，正比系数通过镜头的透镜直径以及焦距确定。
因此对于同一镜头模组，其标定结果需要满足以下两个条件：
标定结果可以有效反映出亮度衰减趋势；
标定结果可以用来恢复图像区域中所有目标点的亮度。因此本模块的标定结果需要使用Mesh的网格方式进行储存。
同时需要注意的是，由于不同光源或者不同色温下光的频谱不同，加上IR-cut Filter的影响，所以即使是同一镜头模组，其在不同光源下的Color Shading特征曲线亦不相同，因此为满足在不同光源或色温下的Color Shading的校正要求，需要在不同光源或色温下对MLSC进行校正。
由于Color Shading的影响，对于某些Color Shading现象比较严重的镜头或者sensor，在做AWB标定之前需要对AWB的标定采集序列进行MLSC校正，以校正结果作为AWB标定算法的输入才能得到准确的AWB标定结果。
MLSC标定序列采集要求¶
MLSC进行标定时，需要多光源的灰度图像。具体的采集要求如下：
MLSC模块的标定序列采集对象要求必须是亮度分布平坦且均匀的光源，同时采集对象必须保持平滑无纹理。理想情况下应采用辉度箱、积分球、DNP灯箱进行采集，其他可以作为MLSC标定序列采集对象的场景有：灯箱灰内壁（无明显划痕或污迹）、透过毛玻璃而达到均匀分布的光源。如果条件所限，也可以是任意能达到亮度均匀分布的灰度平面（类似白墙），但是标定的准确程度可能会受到影响。
如果采集对象为灯箱灰内壁，由于灯箱光源分布在内壁上有一定可能性分布不均匀，故最好保持镜头对准光源中心处，并尽量保证镜头捕获区域光源分布平坦。
采集序列格式为RAW格式，只需1帧即可，采集过程中，光源照度在400 lux左右，镜头中心亮度需保持为最大值（255）的70%，并且使用需要标定的镜头。
对于需要在不同光源下使用的场景，需要在不同光源下进行标定，常用的光源有TL84、CWF、A、D65、D50等，用户请根据使用需求选择光源进行标定。
对于不同镜头模组，需要进行重复标定。
具体的采集步骤如下：
将镜头对准目标区域，并保证环境不被干扰；
调节光源亮度，使得镜头中心亮度平均值为最大值的70%；
使用PQTools Capture Tool进行Raw数据的采集，只需1帧即可；
更换光源，重复上述步骤。
采集后的MLSC标定序列如图1所示。
图 1 MLSC标定序列图像
MLSC标定工具界面介绍¶
将ISP标定工具的主功能标签页切换到MLSC，即可看到MLSC标定的界面。MLSC标定的主界面如图1所示。
图 1 MLSC界面
如主界面图1所示，MLSC标定工具主要可以分为三部分：控制区（1绿色方框所示）、显示区（2蓝色方框所示）、列表区（3红色方框所示）。
控制区：工具进行标定的主要功能均由此处入口，以下将一一描述。
显示区：显示输入图像以及MLSC标定后的输出图像。
列表区：打开的输入图像均会在此处显示，并提供下发标定结果至板端的功能。
MLSC标定步骤¶
在本芯片中，MLSC标定算法增加了适配鱼眼镜头的标定功能。具体请参考"使用MLSC标定鱼眼镜头图像"节内容。
针对普通镜头的标定步骤如下：
参见"黑电平的标定"章节，确定待标定设备的黑电平值；
在工具最左侧的RAW Data列表中，导入Flat Field场景的RAW文件。图像导入后，在列表区会显示被导入图像的别名，并提供相关功能按钮（相关功能按钮请参考附件）。同时显示区将显示最后一个被导入的RAW图像，如图1所示。
图 1 导入RAW数据后的MLSC界面
输入标定参数：MeshScale的值，MeshScale的具体取值方法和含义请参考附录内容；
参数配置完成后，可勾选Show Grids on Image勾选框，确认在显示区图像上看到了均匀划分的32x32的网格；
点击“Calibrate”按钮即可进行MLSC标定。
MLSC标定结果说明¶
标定结束后，工具会生成MLSC标定参数，并且显示区会切换至Output页签，显示标定参数作用于输入图像后的输出图像，可根据输出图像大致判断校正的准确程度，然后修改参数进行调试，附录2中将介绍如何验证校正结果的准确性。
如果同时导入多张图像一次性标定，标定完成后，工具会在列表区将所有标定结果显示出来，此时点击列表区中的图像，会在显示区显示对应的输出图像。
标定后的MLSC界面如图1所示。
图 1 MLSC标定结果说明
由于MLSC标定算法在整个标定流程中的特殊位置，标定工具提供了以下标定结果的使用功能：
标定结果导出功能
使用特定标定结果矫正其他Raw文件的功能
将标定结果下发至板端的功能
标定结果导出功能¶
在对图像进行标定后，可以点击“Export Head File”和“Export Data File”按钮将标定参数导出为本地文件：
导出.h文件，生成文件包含一个结构体定义：
isp_shading_attr记录了每幅图像的增益值以及LSC校正参数（包括MeshScale和横纵方向上分区大小划分XGridWidth，YGridWidth），每幅图像有两组（4张表x2）相同的值。
导出data文件，生成若干txt文件，包含所有RAW数据各颜色通道的Mesh Shading表格。
若需将数据应用至各类sensor的xxx_cmos_ex.h文件，直接修改文件中结构体isp_cmos_lsc的定义，具体用法请参考《ISP开发参考》。
使用标定结果校正其他Raw的功能¶
本功能主要用于AWB和CCM等算法的标定。
标定完成后，可以使用任意一个RAW文件上的标定结果对标定工具导入的其他RAW文件进行Shading校正（如AWB和CCM使用的RAW，在某些Shading严重的镜头下需要先进行Shading校正）。操作步骤如下：
在MLSC标定工具的RAW文件列表中，选取一个已完成标定的RAW数据项，点击CR一栏中的按钮。后续校正将使用这个RAW文件上标定出的矩阵；
在弹出的对话框中，选择需要进行校正的RAW数据项（须提前导入标定工具）；根据需要，可以将校正生成的raw文件保存到设置的路径下；
对即将生成的校正后RAW数据命名；
点击“OK”按钮。
之后标定工具的RAW文件列表中会出现刚刚命名的RAW数据，点击PV一栏中的按钮即可看到Shading校正后的效果。
将标定结果下发板端的功能¶
标定完成后，选取一个已完成标定的RAW数据项，点击AP一栏中的按钮，即可将这个RAW文件上标定出的Shading矩阵下发到板端，板端上的两组数据都取相同图像上的值。
使用MLSC标定鱼眼镜头图像¶
MLSC标定算法在本芯片中亦增加了针对鱼眼镜头图像标定的功能。相较于普通镜头的标定流程，使用标定鱼眼镜头的功能时需要额外注意的情况如下：
标定序列采集要求：由于鱼眼镜头FOV角度极大，因此用来标定的序列图像请使用积分球等设备采集；
标定步骤要求：MLSC标定算法针对鱼眼镜头的标定序列进行了算法优化。因此在进行标定鱼眼镜头序列标定的时候需要勾选控制区中的“FishEyeEn”选择框。并设置CenterX、CenterY和Radius三个参数。
鱼眼镜头标定输入参数¶
请参考"鱼眼标定工具"鱼眼标定工具参考小节所述，获取鱼眼镜头的Center和Radius参数，并填入控制区中对应位置：
CenterX：鱼眼图像光学中心点的横坐标。
CenterY：鱼眼图像光学中心点的纵坐标。
Radius：鱼眼图像的参考半径，可不严格按照实际的半径来设置，参考半径是标定算法用来控制对鱼眼图像边缘校正的强度。当设置的半径过大时，边缘会过度校正，有白色块出现；当设置的半径过小时，边缘会存在校正不足的可能。该参数需要根据标定出来的实际结果来进行调试，取最优的半径。
鱼眼镜头标定步骤¶
以3000x3000分辨率的鱼眼图为例，如图1，未设置参数时，CenterX/Y默认取图像的几何中心点，Radius默认取宽的一半。
图 1 MLSC鱼眼标定示意图1
取鱼眼标定工具获取的标定结果Center: (1555, 1558) Radius: 1558填入，点击Calibrate进行校正，如图2所示：
图 2 MLSC鱼眼标定示意图2
如图3所示，可以看到边缘部分有过亮区域，手动调节Radius，比如改为1458，点击Calibrate，过亮区域消失，但是同时要注意，Radius设置过小，边缘会校正不足。
图 3 MLSC鱼眼标定示意图3
鱼眼镜头的标定结果使用方法与普通镜头结果一致，可参考"MLSC标定结果说明"节内容。
附录1：MLSC参数说明¶
MeshScale：为校正增益精度控制参数。
当MeshScale取值为0~3时，增益精度从高到低，同时增益的取值范围从小变大；当为4~7时，精度从高到低，增益的取值范围从小变大，与取值为0~3不同的是，此时增益最小值为1倍增益。
具体MeshScale的取值和增益精度/增益取值范围对应关系如表1所示。
表 1 MeshScale的取值和增益精度/增益取值范围对应关系
MeshScale |
增益表的数据格式 |
增益取值范围 |
1倍增益对应增益配置值 |
|---|---|---|---|
0 |
u1.9 |
[0,2) |
512 |
1 |
u2.8 |
[0,4) |
256 |
2 |
u3.7 |
[0,8) |
128 |
3 |
u4.6 |
[0,16) |
64 |
4 |
u0.10 |
[1,2) |
0 |
5 |
u1.9 |
[1,3) |
0 |
6 |
u2.8 |
[1,5) |
0 |
7 |
u3.7 |
[1,9) |
0 |
GridSizeX & GridSizeY：这两个参数无法配置，仅在界面上作为显示当前图像分区数目使用。GridSizeX和GridSizeY分别表示横向与纵向上区域的划分的大小，表示有33 x 33个标定的点。
附录2：MLSC标定结果的有效性验证¶
有两种方法可以查看MLSC标定结果是否正确，在实际操作中可根据具体条件进行选择。
Method 1
将标定结果下发板端后，可以用PQTools的点播工具查看标定的结果，可粗略观察中心区域与左右两边亮度和颜色的图像质量，将鼠标放置图像上会显示当前像素点的值（工具左下角），比较这些点的差异。
Method 2
将标定结果下发板端后，使用PQTools Capture Tool导出JPG或BMP格式的图，使用专业的图像质量测试工具进行测试，如Imatest当中的Flat Field模块可用来测试Shading的亮度与颜色偏差的指标，亮度平整度在98%以上，色度偏差ΔC最大值小于1，可认为指标达标，偏差在人眼能够察觉的范围之下。
当出现偏差较大时，请首先检查黑电平是否配置正确，BayerPattern是否配置正确，若还是有偏差，则检查MeshScale设置的增益范围是否够用，不够则需要重新进行标定。
ACS标定¶
ACS标定基本原理¶
由于不同光源或者不同色温下光源的频谱不同，同时较小的镜头模组的CRA角度较大，加上IR-cut Filter的影响，在不同光源下的Color Shading特征曲线表现不一致，导致了Color Shading的产生。这种情况下，MLSC标定无法完全解决Color Shading问题。为了校正有Color Shading的镜头和sensor组合，在不同光源下，需要进行ACS（Auto Color Shading）标定。
为了准确获取镜头和sensor在各种光源下的Color Shading特征曲线，需要在各种光源下进行raw数据采集，常用的光源类型有：H，A，D50，D65，TL84，D75，CWF，U30，U35，10k。
ACS标定序列采集要求¶
ACS进行标定时，需要各类光源的灰度图像，基本的采集要求和MLSC标定的采集要求一致，同时也有一些特定的采集要求：
请首先确认镜头模组的shading衰减曲线在RAW图上是呈左右和上下对称的，这种情况下采集的环境必须是理想的平坦光源，对于不对称的镜头模组，标定的效果会不太理想，同时影响后续的产线标定。
ACS模块的标定序列采集对象要求必须是亮度分布平坦且均匀的光源，在7到10种光源下进行标定：H，A，D50，D65，TL84，D75，CWF，U30，U35，10k，建议A，D50，D65，TL84，D75，CWF是6种必须要标定的光源，其他类型光源可以根据产品的应用场景进行选择，总共参与标定的光源必须大于等于7种。
为了保证在多种光源下采集的RAW图的平坦均匀性，有两种方式：
方法一，取一张灰卡，让光源均匀照射在灰卡上，用照度计测量镜头视场内中心与四周的照度，使其差异在5%以内，并拍摄灰卡；
方法二，让镜头正对光源，用毛玻璃扩散片（Diffuser）盖住镜头，采集数据。
具体的采集步骤如下：
将镜头对准目标区域，并保证拍摄区域光照的均匀性；
保证亮度足够并且不过曝，使用PQTools Capture Tool进行Raw数据的采集，只需1帧即可，把采集下来的RAW文件命名加上对应的光源；
更换光源，重复上述步骤，直到采集完所需的光源为止。
一个典型的Color Shading标定场景（未进行LSC校正）在点播工具下如图1所示：
图 1 ACS标定序列图像
ACS标定工具界面介绍¶
将ISP标定工具的主功能标签页切换到ACS，即可看到ACS标定的界面。ACS标定的主界面如图1所示。
图 1 ACS界面
如图1所示，ACS标定工具主要可以分为三部分：。
控制区（1绿色方框所示）：工具进行标定的主要功能均由此处入口，以下将一一描述。
显示区（2蓝色方框所示）：显示ACS标定结果。
列表区（3红色方框所示）：显示标定用的RAW文件，可显示LightType，进行选择或删除操作。
ACS标定步骤¶
在本芯片中，针对镜头的标定步骤如下：
参见"黑电平的标定"章节，确定待标定设备的黑电平值；
在工具最左侧的RAW Data列表中，导入Flat Field场景的RAW文件。可识别RAW文件名进行LightType选择。图像导入后，在列表区会显示被导入图像的别名，并提供相关功能按钮（相关功能按钮请参考附件）。同时显示区将显示最后一个被导入的RAW图像，如图1所示。
图 1 ACS标定界面区域3标定RAW列表
输入标定参数：
R_Min:[-1.0000,1.0000], 默认值-0.5000；
R_Step: [0,1.0000], 默认值0.1000；
B_Min: [-1.0000,1.0000], 默认值0.000；
B_Step: [0,1.0000], 默认值0.1500；
Color那一栏通常需要全选;
参数配置完成后，可进行ACS Color Shading标定，此时其余按钮灰显；
点击“Calibrate Color Shading”按钮即可进行ACS Color标定。
标定完成后，可以点击“Export Head Data”按钮导出头文件。
ACS标定是离线标定，不下发板端。
ACS标定调试¶
为了使ACS标定的结果更加准确，标定一次后，需要根据光源点的分布表来调整R_Min，R_Step，B_Min，B_Step四个参数，光源分布表是标定后的模型所能够校正的光源范围的集合，横坐标是B分量，纵坐标是R分量。
图 1 ACS标定后的光源分布表
光源的分布越集中，说明可校正的标定光源外的范围越大，但是校正的精度会降低；光源分布越分散，说明可校正的标定光源外的范围越小，但是校正的精度会提高。
总体的调试策略是调整这四个参数，调整标定光源的分布，达到校正范围与校正精度之间的平衡。N点表示的是最接近没有Color Shading时的情况，当在光源点坐标范围包围内，也就是不在边界线上时，表示是无Color Shading的情况。
R_Min，R_Step两个参数控制R分量上光源的平移和缩放，B_Min，B_Step两个参数控制B分量上光源的平移和缩放。当Min参数从小变大时，R纵坐标光源点整体会向下移动，B横坐标整体会向左移动；当Step参数增大时，光源点的分布就更集中，Step参数减小时，光源点的分布就更分散。
参数调整对光源点分布表的影响如图1所示。
图 2 R_Min增大
图 3 R_Step增大
图 4 R_Step减小
图 5 B_Min增大，R_Min增大
图 6 B_Step增大
ACS标定结果说明¶
标定结束后，工具会生成ACS标定参数，参数无下发板端功能，需手动配置到xxx_cmos_ex.h文件中编译并运行查看效果，可以点击“Export Head Data”按钮将标定参数导出为本地头文件：
导出.h文件，生成文件包含一个结构体定义：
ot_isp_cmos_acs，其中包含了ACS模块的开关，ACS模块的校正强度，标定参数结构体ot_isp_acs_calib_param，Y_Shading Lut表结构体ot_isp_acs_y_shading_lut，Color Shading Lut表结构体ot_isp_acs_color_shading_lut。
需将数据应用至各类sensor的xxx_cmos_ex.h文件，直接在文件中添加结构体ot_isp_cmos_acs的定义，具体用法请参考《ISP开发参考》。
AWB标定¶
AWB标定基本原理¶
AWB标定，即根据sensor在数个标准光源下的白点特征(R/G，B/G)，计算最佳普朗克拟合曲线和色温拟合曲线。采用这个办法，可以获得较为理想的AWB算法的输入。
AWB标定序列采集要求¶
AWB标定算法所需Raw可以在室内实验室环境下采集（光源类型和光照亮度需可控），具体采集时需要准备的环境如下所示：
采集设备：标准X-Rite 24色卡、照度为600Lux的多种均匀光源（左右两侧双光源，光源与色卡平面的夹角在25°- 45°），需要标定的设备、色温计等。在光源类型的选择上，请尽量满足高（6500K以上），中（5000K左右）、低（2300K左右）色温至少各有一组。推荐使用D75（7500K）、D50（5000K）和A（2856K）三组光源；
（可选）室内标定之前，可在室外自然光环境采集5000K附近的24色卡Raw，以提高标定的准确性；
采集之前需要通过设置ExposureAttr中的Compensation参数调整画面目标亮度，使得最亮灰阶(Block 19)的G分量亮度在饱和值的0.8倍左右（即使用PQStream点播工具预览时，该色块的RGB值为204左右）；
为尽量保证标定结果准确，采集Raw时请尽量使24色卡画面占据60%以上的画面内容，采集帧数1帧即可，采集时需要记录实际环境色温；
由于AWB标定结果会受到镜头Shading影响，为尽量保证标定结果准确，对能明显观察到镜头阴影的设备，请将采集下来的Raw进行Shading矫正后再进行AWB标定。具体操作方法请参考"MLSC标定"节所述内容。
确保以上条件同时满足后，采集下来的Raw即可输入给AWB标定算法进行处理。AWB标定算法输入Raw示意如图1：
图 1 AWB标定算法输入Raw示意
AWB标定工具的界面说明¶
将标定工具的主功能标签页切换到AWB，即可看到AWB标定的界面。工具的界面如图1所示。
图 1 AWB标定工具界面
工具界面主要分为4部分：
White Pixel Distribution图表（绿色区域）：位于工具左上角，显示各个导入的图像样本的白块R/G、B/G值位置；
Planckian Curve图表（蓝色区域）：位于工具右上角，显示标定完成后的普朗克曲线；
操作区域（红色区域）：位于工具中间，提供用户导入RAW文件，设置标定参数、启动标定和向单板写数据的操作接口。同时也显示标定后的色温曲线参数值和增益值。本区域中，P1、P2、Q、A、B、C六个值为标定结果输出值，用来描述普朗克曲线，R Gain、B Gain两个值为标定输入值，用来描述中心色温的RGain、BGain值，并能进行RAW标定数据的导入导出，和下发板端操作。
RAW文件配置表（黑色区域）：可以对导入的RAW文件设置权重，色温，并配置白区。标定完成后，还会显示对应光源下的色温和Shift值，对AWB的raw文件配置进行导入导出，导入导出参数有文件名、KI值、输入色温、R/G、B/G值。
AWB标定步骤¶
标定工具支持AWB的自动标定与半自动标定，自动标定和半自动标定的主要区别在于是否需要手动输入Rgain和Bgain的值。
在标定工具主界面指定黑电平，或进行一次黑电平标定。
参照"设置RAW基本属性"章节的描述，在标定工具主界面导入需要进行AWB标定的RAW数据，并进行勾选。要求输入至少3个不同光源的RAW文件。
选择Mode下拉框为Auto。（如果需要进行半自动标定，请选择Semi-Auto）
在AWB标定界面导入勾选的RAW数据，并设置各个RAW数据的权重，色温。权重默认值为1，取值范围为0~15，权重值越高，则该色温在AWB普朗克曲线拟合过程中的倾向度越高。色温即为采集RAW数据过程中记录的实际色温值。
使用工具在各个RAW数据中勾选白平衡块，具体勾选过程请参考附录内容。
选择3个RAW为关键光源 (KI)作为标定起始点。推荐选择A、D50、D75三个光源为KI。
如果选择标定模式为Semi-Auto，请在操作区域R Gain、B Gain输入框手动设置R Gain和B Gain的值。
点击“Calibrate”按钮。
CrCb参数标定步骤¶
CrCb标定主要利用最大色温和最小色温的R/G、B/G的值进行标定，得出4组CrCb数组的值。
在标定工具主界面指定黑电平，或进行一次黑电平标定。
参照“设置RAW基本属性”设置RAW基本属性章节的描述，在标定工具主界面导入需要进行AWB标定的RAW数据，并进行勾选。要求输入至少3个不同光源的RAW文件。
使用工具在各个RAW数据中勾选白平衡块并设置相应RAW数据的色温值，具体勾选过程请参考附录内容。
点击“Calibrate CrCb”按钮。
AWB标定结果说明¶
所有的RAW文件都选择好白块以后，即可进行标定。点击“Calibrate Curve”按钮后，等待一小段时间，标定即可完成。标定完成后，以下的结果会被给出：
Planckian Curve图表中输出普朗克曲线，并标出每个RAW文件在该图表中的位置；
R Gain，B Gain以及色温曲线的6个参数（P1，P2，Q，A，B，C）值也将给出（如果是半自动标定，则R Gain和B Gain的值与用户输入相同）；
基于上述标定参数，输出每个RAW文件对应的Shift值和色温期望值（Es. Temp）。|Shift|值越小，色温期望值与真实色温误差越小，表示标定参数越准确。
图 1 AWB标定结果
AWB算法支持下发板端功能，完成标定后，点击“XX Apply To Board”按钮，可以将标定结果下发至板端。发送的数据将立即生效。
附录：为RAW文件样本勾选白区¶
点击RAW文件配置表（工作区黑色区域）中对应RAW文件在WZ（White Zone）一栏中的按钮，可以打开白块框选对话框，如图1所示。
图 1 白区勾选窗口
按住鼠标右键并拖动鼠标，可以移动图像；使用鼠标滚轮可以缩放图像。
在图像显示的区域使用鼠标左键，可框选图像中的区域。对于24色卡场景，一般选择20-22色块作为白块；对于实际拍摄的自然场景，选择其中的白色部分。选框时，使色框尽可能大（但需要保证所有像素颜色几乎相同），这样可以使取到的R/G和B/G更加精确，从而得到更准确的标定结果。选定白区后的效果如图2所示。
图 2 白块勾选
选定白块后，左侧的列表会显示选定白块的R/G与B/G比值，显示的序号与右侧选框对应。若选择了不需要的选框，或选框错误，可以在列表中点击对应序号右侧的红叉按钮将其删除。
如图3所示，请注意如果不同亮度的B/G值差异明显（>0.1），需要确认黑电平设置是否合理。
选择完毕后点击“Close”按钮关闭白块勾选对话框。工具将自动计算该RAW文件的R/G和B/G的算术平均值，并显示在列表中，并在White Pixel Distribution图表中标示该RAW文件所处的位置。
图 3 白块勾选完毕
CCM标定¶
CCM标定工具原理¶
CCM标定的原理是，使用sensor抓拍到的24色卡场景下前18个色块的实际颜色信息和其期望值，计算3x3的CCM矩阵。输入颜色经CCM矩阵处理得到的颜色与其期望值差距越小，则CCM矩阵就越理想。
CCM标定序列采集需求¶
采集设备准备：标准X-Rite 24色卡，照度为600Lux均匀光源（左右两侧双光源，光源与色卡平面的夹角在25°- 45°）。
调整AE目标亮度，PQStream点播工具显示页面上查看第20色块的G值在201附近，第21色块的G值在163附近就表示曝光合适。
采集中性灰RAW图像，检查镜头阴影程度。Shading较严重时，需要先标定Shading系数，24色卡图像需要先进行Shading校正后，再进行CCM标定。
CCM标定工具的界面与功能¶
将标定工具的主功能标签页切换到CCM，即可看到CCM标定的界面。
图 1 CCM标定工具界面
CCM标定工具主要分为四部分：
标定区域：上方的标签页，包含“Calibration”与“Result”两个页面，执行CCM标定功能和CCM手动调整功能。
记录区域：暂存标定结果，并将用户选择的标定结果发送到板端。
结果区域：色调、饱和度修正值，显示校正后图像，CCM结果(浮点型和整型两种形式) 还有颜色误差分析。
图像微调区域：对CCM矩阵进行数据输入，仅能输入浮点类型数据，并对图像进行微调。
CCM标定步骤¶
进行CCM标定，请遵循以下流程（后面章节中，将进行各个操作流程的说明）：
参照"设置RAW基本属性"章节的描述，在标定工具主界面导入需要进行CCM标定的RAW数据。
导入RAW文件（24色卡限定）。
选取24色区域，操作方法请参考附录1。
配置标定参数（GAMMA，参考LAB，色块权重，差异标准，AutoGain，AutoWbGain，R Gain，B Gain，Display Gain），参数意义请参考附录2。
点击“Calibrate”按钮进行标定，获得结果CCM。
在Result页面进行手动色调/饱和度调整，直到获取的CCM满足要求，并能点击Show Color Analysis 查看图像差异结果分析。
CCM标定结果说明¶
当24色选框完成，并配置好所有的标定参数后，即可点击“Calibrate”进行标定。标定完成后，工具自动跳转到Result 页面，并显示校正后图像，CCM(浮点型和整型两种形式)和色调、饱和度修正值，如图1所示。
图 1 初步标定完成
显示颜色差异结果¶
可点击“Show Color Analysis”按钮显示当前图像和源图像的差异结果，如图1所示。
图 1 CCM图像颜色差异分析
测量的结果是显示RAW数据经过当前CCM参数，得到的源图像与LAB Customization中设定的目标图像的差异。一般来说，源图像的圆形和目标图像的方形会比较接近。用户可以不断调节方形的位置来引导CCM参数的标定。
如果需要测量源图像和标准色卡值之间的误差，请使用PQTools Color Checker工具。
手动调整¶
如果查看校正后的图像发现效果不理想，还可以进行手动调整。在“Result”页面调整色调（Hue Corr）和饱和度（Sat Corr）修正值，并点击“Manual Adjust”，可以重新计算CCM并进行图像校正。点击“Import Matrix CCM”可把Matrix CCM的值导入到Manual CCM的矩阵中，进行手动调整图像。重复上述操作，直到获得满意图像即可。
导出当前标定结果¶
点击CCM标定界面上的“Export Current Result”可将当前标定的数据导出成一系列文件。在弹出的目录选择对话框选择好输出路径后，工具将保存一系列文件，包括：
输入图像（经过Demosaic处理）
输出图像（经过Demosaic和CCM校正处理）
CCM标定结果矩阵（包含浮点，10进制和16进制3种形式），若手动进行CCM矩阵的输入，也可在结果导出中导出输入的CCM矩阵的浮点和转换后的10进制和16进制数。
导出全部标定结果¶
点击CCM标定界面上的“Export All Result”可导出当前标定数据的输入图像，输出图像，和所有记录的CCM标定结果矩阵（如果没有记录，则只有当前标定结果的矩阵），包括：
当前标定的输入图像（经过Demosaic处理）
当前标定的输出图像（经过Demosaic和CCM校正处理）
当前CCM标定结果矩阵和所有记录的CCM标定结果矩阵（包含浮点，10进制和16进制3种形式）以及手动输入的CCM矩阵值（包含浮点，10进制和16进制3种形式）
记录功能¶
当用户调整到一组合适的CCM，可将其暂存起来。点击对话框上的“Record Current Calibration”按钮，可将当前标定的所有信息在程序中暂时记录下来。记录后，下方列表会显示一条CCM信息：
图 1 记录功能
在Color Temp. 一栏，可以为该记录设置色温，一般与输入图像采集时的色温相对应。
点击Use一栏的环状箭头按钮，可以将对应的记录（包括使用的图像，标定参数等）恢复到标定界面，可以继续利用这些参数进行标定或手动调整。恢复后，工具将立即使用恢复的参数执行一次标定。
如果不需要再用到特定的记录，点击记录右侧Del一栏中的红叉按钮可将记录删除。如需要删除全部的记录，请点击“Clear Record List”按钮。
标定结果下发到板端¶
当用户标定并记录了多组参数后，可以选出其中的七组以下(含7组)数据，将这些记录中的结果CCM发送到单板。采取以下步骤：
设置TabNum，默认为3，范围[3,7]，其含义为板端生效的CCM组数。
在记录列表最左侧的复选框上，勾选1组到7组需要下发到板端的CCM标定结果。
设置Group号，Group号的意义为板端生效的CCM的第几组，Group的取值范围[0, TabNum-1]且不能有相同。例如TabNum为3时，Group号为0，1，2。
为勾选的记录设置色温值。
点击界面上的“Apply Selected CCM”按钮。
附录1：选择24色区域¶
导入RAW图像后，可在右侧的图像区域选择24色范围。拖动四角色块中央的红色手柄，即可改变24色框的排布，将24个方框对准RAW图像的24色区域即可。如图1所示。
图 1 24色选框
移动图片区域左侧的Patch Size X或Patch Size Y滑块，可以改变选框的各个方框的水平和垂直大小。调整时，使色框尽可能大（但需要每个框内，所有像素颜色几乎相同），这样可以使取到的颜色更加精确，从而得到更准确的标定结果。
附录2：配置标定参数¶
请按照以下基本步骤设置标定参数：
设置ISP Gamma：在ISP Gamma的下拉框中选择需要的Gamma预设值（目前支持sRGB和Rec709，BT.2020），也支持自定义。请用户输入ISP当前生效的Gamma表。
设置显示Gamma：在Target Gamma的下拉框中选择需要的Gamma预设值（目前支持sRGB和Rec709）。
设置LAB参考值：在LAB Reference的下拉框中选择需要的LAB预设值（目前支持D65条件下的Xrite标准值）。也支持自定义，可自定义输入色卡中的值并进行标定。
在6x4的表格中配置色块的权重。色块的位置与表格中的位置对应，取值范围为0到16.0的浮点数，保留一位小数。
选择差异衡量的标准（支持CIE2000和CIE76）以及差异矩阵（Delta Cab与Delta Eab）。推荐使用“CIE76 Delta Eab”和“CIE2000 Delta Cab”两种组合进行标定。
选择是否AutoGain，当选择AutoGain时，会对RAW的值和目标值做亮度补偿。
输入Display Gain值，对结果生成的图像进行校正。
自定义ISP Gamma的方法
在ISP Gamma的下拉框中选择Customize…，并在随后弹出的文件选择对话框中选择一个Gamma文本文件用于导入（例如可以选择：PQTools\Plugins\Data\ColorCalibrationPicture\gamma257.txt）。文本文件的格式必须是以下三种之一才可以被工具识别：
一列排列的浮点数，数据的排列必须由小到大，且最大值为1.0
一列排列的10进制正整数，数据的排列必须由小到大。工具以最大值为归一化的标准值。
一列排列的16进制数，数据的排列必须由小到大。工具以最大值为归一化的标准值。
若文件成功导入，则工具在标定时使用该文件内保存的Gamma数据。
自定义LAB参考值的方法
在 LAB Reference的下拉框中选择Customize，打开LAB自定义对话框，如图1所示。
图 1 LAB自定义对话框
图 2 LAB点击颜色弹框选择
用户可以用5种方式自定义LAB参考值：
直接在表格中输入值。
导入文本文件：点击Import From右侧的“Text File”按钮，选择一个txt文件后即可将其中的值导入至该对话框。选择的文本文件必须是一系列浮点数，并且用逗号或空格隔开，行列数可任意。
导入Imatest 3.x 的Color Check功能生成的CSV文件：点击Import From右侧的“Imatest CSV”按钮，选择一个由Imatest 3.x工具导出的csv文件后，即可导入其中的LAB数据。可选择导入ideal或meas数据。
从图片框选：点击Import From右侧的“Image”按钮，选择一张jpg或bmp图片（例如可以选择：PQTools\Plugins\Data\ColorCalibrationPicture\target_A.jpg）。之后在打开的对话框中进行24色框选即可。方法与之前CCM标定工具上的框选一致。
可点击列表中的颜色，弹出调色板，如图1所示，调色板是当前L亮度下的一定范围内的颜色，用户点击选框中颜色，画出一个矩形框，选择颜色，获得LAB值。
点击“Export LAB”按钮可以导出当前的LAB值，生成txt文件，可用于导入Txt File。
设置完成后点击“OK”。之后标定工具在标定时，会使用用户自定义的LAB数据。
标定BT.2020下的CCM的配置方法：
选择是否BT.2020，当选择BT.2020时，标定得到的CCM参数符合BT.2020的标准。
设置ISP Gamma，在ISP Gamma的下拉框中选择需要的Gamma预设值（BT.2020），也支持自定义。请用户输入ISP当前生效的Gamma表。
当目标图片或者目标值为sRGB标准时，设置显示Gamma，在Target Gamma的下拉框中选择需要的Gamma预设值（sRGB）。当目标图片或者目标值为BT.2020标准时，选择预设值（Rec709）。
设置LAB参考值，在LAB Reference的下拉框中选择需要的LAB预设值（目前支持D65条件下的Xrite标准值）。也支持自定义。
选择好所需的颜色后，可直接在该界面进行标定。
CLUT标定¶
CLUT标定基本原理¶
CLUT标定基于用户提供的24色卡、140色卡或用户自由选择的颜色对，建立输入图像和目标图像的RGB空间的3D映射表。CLUT算法基于映射表对图像进行逐像素的调节，以满足用户颜色调节的需求。标定的主要目的是通过源和目标的RGB对，确定CLUT的对于各种颜色的调节方向和调节量。
CLUT标定工具界面与功能¶
CLUT主界面如图1所示。
图 1 CLUT主界面
将标定工具的主功能标签页切换到CLUT，即可看到CLUT标定的界面。
如主界面图1所示，CLUT标定工具主要可以分为五部分：图像参数区（1）、图像预览区（2）、颜色选取区（3）、RGB对区（4）、CLUT生成区（5）。
图像参数区：待标定机器和目标机器的相关参数，这些参数用来从RAW或JPG中获得ISP中CLUT模块处的数据。
图像预览区：显示输入图像或者目标图像。
颜色选取区：提供四种从输入图像和目标图像中选取RGB对的工具。
RGB对区：显示收集到的RGB对数据。
CLUT生成区：用来生成和保存CLUT。
CLUT标定校正步骤¶
图像亮度、白平衡、CCM参数、Gamma曲线等都会影响CLUT标定的准确性。因此，CLUT标定前，确认待标定机器和目标机器的AWB设置正确，亮度、灰阶表现一致。
在D50或D65灯箱光源，600lux左右照度，对着24色卡或140色卡，拍摄待标定机器的RAW或JPG图片和目标机器的JPG图片。在室外采集2-3组不同亮度的待标定机器RAW或JPG图片和目标机器的JPG图片，这里的源和目标图片对可以同时含有色卡也可以不含有色卡。详细要求请参考"附录1：采集数据的要求"。
如果画面的Shading现象严重，可参考"MLSC标定"中介绍内容，对图像进行Shading矫正后再进行CLUT标定。
加载图片文件，请参考"附录2：加载文件"。
设置图像参数，请参考"附录3：图像参数区设置"。
使用Color Check 24和Color Check 140两个工具，可以从待标定机器的RAW和目标机器的JPG图片中获得RGB对。
这种方式的优点是可以简单快速的确定各种颜色的调节方向和调节量，包含需要调节的颜色和需要固定不调节的颜色，获得的RGB对可以看做是CLUT的基础调节。
使用Color Check Free工具，可以从待标定机器的JPG图片和目标机器的JPG图片中获得RGB对。这种方式的优点是从场景中选择感兴趣的颜色，做进一步精细的调节。使用Color Check HSL工具，可以从待标定机器的JPG图片中获得RGB对。这种方式的优点是在当前的颜色表现的基础上调节。请"附录4：RGB对生成"。
使用经过整理确认的RGB对的数据生成CLUT表。整理RGB对的具体方法可参考"附录5：整理RGB对"。
标定结果下发板端确认效果，存储标定结果用于FW。
CLUT标定结果说明¶
标定结束后，CLUT标定工具会生成基于用户选择的颜色映射矩阵。本标定工具提供了以下标定结果的使用功能：
保存标定参数
将标定结果发送至板端的功能
保存标定参数¶
点击“Save as Head”按钮，可以将工具内的标定参数保存为.h文件，可供在代码中编译使用。点击“Save as txt”按钮，可以将工具内的标定参数保存为.txt文件。可以在调试页中导入到CLUT参数矩阵中。
将标定结果发送至板端¶
点击界面上的“Apply To Device”按钮，可以将标定生成的CLUT三维矩阵直接应用至板端对应的CLUT处，并立即生效。
附录1：采集数据的要求¶
在D50或D65灯箱光源或者是室外采集RAW时，场景内放置有色卡，通过PQStream工具的图像预览界面读取色卡的第21色块的G通道的值，通过调节曝光等ISP内影响亮度的参数，观察这个值和目标机器采集的图片中的值基本接近，这时可以采集RAW数据。
在使用RAW数据作为源数据和JPG作为目标数据时，要求源和目标图像内都有色卡，RAW数据会参考JPG目标数据的白平衡结果，进行白平衡增益的处理。不需要手动设定白平衡增益。推荐采集RAW数据的步骤如下：
通过PQStream工具调节亮度
通过PQStream点播工具的图像预览界面读取色卡的第21色块的G通道的值。然后调节ISP参数，让该值和目标JPG相当。
图 1 PQStream工具预览读取值
采集RAW数据
通过PQTools工具的Capture Tool采集RAW数据。
图 2 PQTools工具采集RAW数据
在使用ISP输出端的JPG作为源数据时，需要注意采集到的JPG数据和ISP输出保持一致。因为YUV转RGB的标准的原因，容易导致采集到的JPG数据和ISP输出有偏差。比较简单的方式是使用MPV播放器播放码流并截图，取得JPG数据。也可以采用其他方法，比如抓取板端的YUV数据，然后转换成JPG数据。不推荐在Capture Tool工具中抓取JPEG图片，因为这里的YUV转RGB参数和ISP的RGB转YUV参数不对应。推荐采集JPG数据的步骤如下：
通过PQStream工具录制H.265码流
通过PQStream工具的Record按钮，录制一小段H.265码流。
图 3 PQStream工具录制码流
播放器的配置
配置MPV播放器的输出的YUV转RGB的数据格式，在MPV目录下的mpv.conf文件中写入“video-output-levels=limited”，让播放器的输出和ISP的输出保持一致。
图 4 MPV的参数配置
在播放器播放H265码流的时候，使用快捷键S或Ctrl+S截图。
附录2：加载文件¶
打开 RAW文件
参照"设置RAW基本属性"章节的叙述导入24色卡或140色卡场景的RAW文件，并在主界面列表进行选择后，点击“Get the First Selected RAW”按钮，即可导入图像。同时界面将显示第一个被导入的RAW图像。
图 1 CLUT打开输入图像
打开源jpg或bmp图像
图 2 CLUT打开源jpg或bmp图像
点击“Open Src Image”按钮，选择图片导入。
打开目标图像
图 3 CLUT打开目标图像
点击“Open Target Image”按钮，选择一幅jpg格式的图像作为目标图像打开。此时显示区的Target页签会显示目标图像。
附录3：图像参数区设置¶
“Color space”下拉框：
选择当前ISP的工作模式是sRGB或者BT2020模式。
“ISP Gamma”下拉框：
选择当前ISP使用的Gamma表，这里预置了sRGB或者BT2020的Gamma表，建议用户通过Customize加载源图像机器ISP使用的Gamma表。
“CCM Matrix”：
通过Load CCM按钮导入当前ISP使用的CCM参数，选择已保存的CCM标定数据文件，即可导入已标定的CCM 10进制定点数据到表格中。当输入图像是RAW数据的时候，会使用这里的CCM参数。ISP Calibration Tool的CCM标定结果可以直接导入。同时CLUT工具也支持标定结果的自解析，可将10进制或16进制CCM数据直接解析并显示成10进制数据（不支持Double类型数据）。也可以导入PQTools界面中，AWB Info处导出的当前板端使用的CCM参数。
“CSC Matrix”：
通过Load CSC按钮导入含YUV转RGB参数的txt文件，yuvtorgb_601_full内容举例如下：
1.0000,0.0000,1.4023,0.0000,0.0000,1.0000,-0.3438,-0.7139,-0.5000,0.0000,1.0000,1.7725,0.0000,-0.5000,0.0000
导入后界面显示为
1.0000 0.0000 1.4023 0.0000 0.0000
1.0000 -0.3438 -0.7139 -0.5000 0.0000
1.0000 1.7725 0.0000 -0.5000 0.0000
前三列是BT601标准规定的full yuvtorgb转换参数
第四列是输入yuv数据的偏移量
第五列是输出rgb数据的偏移量
yuvtorgb_709_limit内容如下：
1.1641,0.0000,1.7930,-0.0625,0.0000,1.1641,-0.2129,-0.5332,-0.5000,0.0000,1.1641,2.1123,0.0000,-0.5000,0.0000
yuvtorgb_709_full内容如下：
1.0000,0.0000,1.5752,0.0000,0.0000,1.0000,-0.1875,-0.4678,-0.5000,0.0000,1.0000,1.8555,0.0000,-0.5000,0.0000
yuvtorgb_601_limit内容如下：
1.1641,0.0000,1.5957,-0.0625,0.0000,1.1641,-0.3916,-0.8125,-0.5000,0.0000,1.1641,2.0176,0.0000,-0.5000,0.0000
须知：
如果修改了CCM Matrix，需要保证修改后满秩矩阵，否则标定会有错误提示。
附录4：RGB对生成¶
根据输入图片的场景，点击不同按钮。
如果是待标定机器的RAW和目标机器的JPG图片，图片中含有24色卡的场景，则点击“Color Check 24”按钮；
如果是待标定机器的RAW和目标机器的JPG图片，图片中含有140色卡的场景，则点击“Color Check 140”按钮。
如果是待标定机器的JPG和目标机器的JPG图片，在源图像和目标图像自由选择的场景，则点击“Color Check Free”按钮。这里的图片可以含有色卡，也可以不含有色卡。
如果是待标定机器的JPG，在源图像自由选择颜色后配置HSL的场景，则点击“Color Check HSL”按钮。这里的图片可以含有色卡，也可以不含有色卡。
在使用“Color Check Free”或“Color Check HSL”调节某些颜色前，建议使用“Color Check 24”或“Color Check 140”产生比较全面的颜色RGB对。用户在新增需要调节的颜色RGB对的同时，也需要提供不需要调节的颜色RGB对，即RGB对中的源和目标值相同或接近。通过这种方式可以控制某些单一的颜色调节对相邻颜色的影响范围，即通过增加相邻颜色RGB对的方式来将相邻的颜色符合基本不变的需求。前两个场景，在弹出的对话框中，进行颜色框选。
左键按住四个角的色框中的红点，可以拖动色框，调整选择的颜色。如图1所示。
图像上方的两个滑动条可以调节色框的宽高长度。色框越大，获取的色块像素数越多，标定结果越准确，同时耗时会增长。
Color Check Free场景，可以在源图像与目标图像上通过拖动鼠标选择矩形区域，选择的区域最大数量为8。如图2所示。
Color Check HSL场景，可以在源图像通过拖动鼠标选择矩形区域，选择的区域最大数量为8。可通过编辑框和滑动条设置Hue、Saturation与Lightness的值。Hue范围+-20，Saturation范围0.4-1.6倍，Lightness范围0.6-1.4倍。如图3所示。
点击“OK”按钮。
图 1 24色区域框选
图 2 Color Check Free场景框选
图 3 Color Check HSL场景框选
附录5：整理RGB对¶
生成的RGB对添加到RGB对列表后，可在列表中对生成RGB对进行选择或取消选择或删除。使用Export RGB可导出列表中的RGB数据到文件中。使用Import RGB可以从文件导入RGB对到列表中进行标定。每次生成的RGB对会添加到当前RGB对的后面，Clear RGB可以清除当前列表中的所有RGB对。
图 1 RGB对列表
图 2 CLUT标定生成
可以修改“LUT Operations”栏目下的“Mode”下拉框选择工作模式，SDR模式下选择Linear，HDR模式下选择CLUT HDR。填写Smoothness参数，Smoothness参数范围为1-100，平滑度逐渐提高，建议值在15-30范围，值越小会尽量让各种颜色的调节准确，但容易把图像噪声放大；值越大会让相邻颜色平滑调节，减少由于颜色增强导致的噪声过大。点击“Calibrate LUT”按钮，对RGB列表中的RGB对进行标定。
点击“Calibrate LUT”按钮，约40秒后，工具内部生成了CLUT标定参数。推荐用户将CLUT参数下发板端后，灌RAW观察颜色调节效果。
点击”Cube to 3Dlut" 按钮，支持将Cube格式3D Lut表转换为SS928V100 3D Lut表（需要配置正确的gamma）。
DynaBLC标定¶
标定基本原理¶
Sensor的ob区黑电平和可见光区黑电平的差值会随iso的改变而改变。此工具用于标定不同iso情况下ob区黑电平和可见光区黑电平的差值。
DynaBLC 采集要求¶
需要采集黑帧（遮住镜头抓取的数据）
至少采集16帧
确保当前通路已经输入ob区。ob区的获取方式需要在pub_attr里将裁剪起始点都设置为0。
图 1 ob区裁剪起始点
抓raw数据时，Again、Dgain成倍数增加。先增加Again，再增加dgain。不调节ISPDgain。从iso100开始，每增加一倍Again或Dgain值，采集一个该增益下对应iso的raw数据。直到Again，Dgain都为最大值。此增益下的iso为最后一档iso。如图2所示
图 2 iso增益表
DynaBLC 工具界面介绍¶
图 1 工具界面图
1区域是标定参数， 2 区域是控制按钮，3区域为导入标定的源 raw文件列表。
DynaBLC 标定步骤¶
针对sensor的标定步骤如下：
在工具最左侧的RAW Data列表中，导入采集的特殊 BLC 场景的RAW（带ob区）文件。可识别RAW文件名进行ISO设置。图像导入后，在列表区会显示被导入图像的别名，并提供相关功能按钮。显示相关信息。如图1。
图 1 Raw列表导入演示
根据实际情况输入标定参数，Width和Height不能为0，否则标定结果异常。(OB_X, OB_Y)为OB区的起始坐标点。Width和Height为OB区的宽高。ThrLow和ThrHigh为统计像素点的阈值。
点击Calibration按钮进行标定 等待下方标定进行中状态条消失后，即可点击Export Result导出标定结果或者直接点击Offset Apply to board 按钮，将标定结果直接下发板端。点击ObBlc Apply to board 将OB区黑电平标定结果下发板端。
高级功能¶
寄存器修改器¶
如果用户需要修改某一特定寄存器地址上的值，可以直接使用寄存器修改器来完成。该修改器支持32位物理/虚拟寄存器的读取和修改。
点击工具栏的“寄存器修改器”按钮（
）打开寄存器修改器，如图1。
图 1 寄存器修改器
读取一个特定地址上的寄存器值，请遵循下列步骤进行：
在“Address”输入框中输入地址值
选择寄存器类别“Physical”或“Virtual”
点击“Read”按钮
若读取成功，工具会在“Value”输入框中显示读取到的值，同时右侧的按位修改区域会匹配读取到的值。
向一个特定地址上的寄存器写入值，请按照以下步骤进行：
在“Address”输入框中输入地址值
选择寄存器类别“Physical”或“Virtual”
在“Value”输入框中输入要写入的值，或通过右侧的按位修改区域修改单个位上的数值，也可以通过下方设置最低位LSB、最高位MSB、有无符号型Signed来确保输入的数值Value不会超范围。
点击“Write”按钮。
寄存器地址值必须为4的整数倍，否则无法进行读写。
Virtual类型寄存器地址需按照模块标记地址+偏移的方式填写。AE模块标记地址为0x00A00000，AWB模块标记地址为0x00B00000，ISP（外部）虚拟寄存器标记地址为0x00C00000。例如：地址0x00A00004代表的是AE库虚拟寄存器偏移为0x4的地址。其中Virtual偏移范围请参考《ISP 开发参考》中isp_reg_attr接口的对应部分。
使用原则为：对于出现或定义过的地址可进行相应的读和写操作，如果该地址在相应的寄存器类型上未定义或不明用途，请慎重选择填写和使用。因此填写寄存器地址后必须选择对应的寄存器类型，即Physical或Virtual。例如，地址0x00A00004是表格中对应的虚拟寄存器地址，而该地址也是合法的物理地址值（但在物理寄存器范畴内此寄存器无效，或是有更重要的用途）。若此时将此地址选择物理寄存器类型进行读写，可能引起程序崩溃或其他异常，请务必小心使用。
参数的导出导入¶
请参考"使用工具导入导出参数"。
通信日志¶
与单板连接后，所有与板端的数据交互都会记载日志并显示在通信日志窗口，如图1所示。
图 1 通信日志窗口
与板端进行数据交互时，记载的日志包含以下信息：
日志生成的时间；
通信方式与参数；
通信内容（如当前读取或写入的调试项）；
交互情况（包含会话启动，会话应答等）；
如果通信出错，则显示错误信息。
点击“Clear All”，可以清除当前所打印的通信日志。
点击“Scroll to bottom when the logs refreshed”日志栏显示最新打印信息，取消勾选后显示当前打印信息。
支持鼠标右键或者Ctrl A 、Ctrl C复制日志栏全部信息。
日志最大支持显示2万行。
I2C读写工具¶
用户可以使用I2C读写工具对通过I2C总线连接的Sensor或其他器件的寄存器进行读写。
在工具栏的“附加组件”下拉框中，选择“PQTools I2C Editor”即可打开I2C编辑窗口。
图 1 I2C读写工具
其中I2C Device Information用于配置I2C设备的信息。
读取一个特定地址段上的I2C值，请遵循下列步骤进行：
分别在Device ID和Device Address中输入I2C设备的ID和地址。
分别在Address Bytes和Data Bytes中选择地址位宽和数据位宽。
在Start和Length框中输入起始地址和长度。
点击“Show”按钮，此时符合地址范围的寄存器编辑框出现在下方。
点击“Read”按钮。
若读取成功，工具会在各个编辑框中显示对应地址的值。
写入一个特定地址段上的I2C值，请按照以下步骤进行：
分别在Device ID和Device Address中输入I2C设备的ID和地址。
分别在Address Bytes和Data Bytes中选择地址位宽和数据位宽。
在Start和Length框中输入起始地址和长度。
点击“Show”按钮，此时符合地址范围的寄存器编辑框出现在下方。
编辑写入的I2C地址，修改其值。
点击“Write”按钮。
此外，通过Load和Save按钮，可以保存或导入I2C的器件配置。
SPI读写工具¶
用户可以使用SPI读写工具对一些基于SPI的外围器件上的寄存器进行读写。
在工具栏的“附加组件”下拉框中，选择“PQTools SPI Editor”即可打开SPI编辑窗口。
图 1 SPI读写工具
其中SPI Device Information用于配置SPI设备的信息。
读取一个特定地址段上的SPI值，请遵循下列步骤进行：
在Device一栏配置SPI Number、CSN和SPI模式（标准或非标准）。
在Device Address一栏配置设备地址：在Read后的输入框中填入读取数据用的设备地址，并在Width下拉框中选择设备地址位宽。
在Registers一栏配置寄存器地址和数据的属性：分别在Address Width和Data Width中选择寄存器地址位宽和数据位宽；再分别在Address Order和Data Order中选择地址和值的大小端排序。
在右侧SPI Registers的Start和Length框中输入起始地址和长度。
点击“Show”按钮，此时符合地址范围的寄存器编辑框出现在下方。
点击“Read”按钮。
写入一个特定地址段上的SPI值，请按照以下步骤进行：
在Device一栏配置SPI Number、CSN和SPI模式（标准或非标准）。
在Device Address一栏配置设备地址：在Write后的输入框中填入写入数据用的设备地址（如果SPI器件的读写设备地址相同，亦可在保留下方Use the same address on reading and writing勾选的情况下，填写Read后的输入框），并在Width下拉框中选择设备地址位宽。
在Registers一栏配置寄存器地址和数据的属性：分别在Address Width和Data Width中选择寄存器地址位宽和数据位宽；再分别在Address Order和Data Order中选择地址和值的大小端排序。
在右侧SPI Registers的Start和Length框中输入起始地址和长度。
点击“Show”按钮，此时符合地址范围的寄存器编辑框出现在下方。
编辑写入的SPI地址，修改其值。
点击“Write”按钮。
若SPI项读写成功，对应值的单元格会变成绿色背景；若读写失败，单元格会变成红色背景，如图2所示。
图 2 SPI读写工具的结果提示
通过Load和Save按钮，可以保存或导入SPI的器件配置。
点击“Clear”按钮，可以将下方编辑区域内的寄存器项清空。
用户点击了“Show”按钮后，将不能更改地址位宽和数据位宽，也无法读取器件配置文件。如需进行上述操作，请点击“Clear”按钮清空编辑项。
3线SPI sensor寄存器的读写，Device Number、CSN、设备地址不需要，可以不设置，直接设置好地址位宽与数据位宽、起始地址与所要读写数据的长度. 如果用户采用了私有标准的SPI，则根据读写驱动的需要，设置所需的信息。
分析工具界面及功能说明¶
颜色分析工具¶
工具界面¶
从PQTools工具主界面工具栏的外挂插件下拉框中选择“PQ Color Checker”，可以打开颜色分析工具，如图1所示。
图 1 颜色分析工具
颜色分析功能可以显示以下分析数据：
标准色与取样色在L*a*b*矩阵下坐标点的位置距离对比图
CIE1976算法得出的不考虑亮度的L*a*b*色彩空间距离值ΔC*ab（含修正饱和度后的值），以及考虑亮度的L*a*b*色彩空间距离值ΔE*ab（图像是sRGB色彩空间时，选择CIE1976；图像是Rec.2020 Full色彩空间时，选择CIE1976_BT2020）。
CIE2000算法得出的不考虑亮度的L*a*b*色彩空间距离值ΔC00（含修正饱和度后的值），以及考虑亮度的L*a*b*色彩空间距离值ΔE00（图像是sRGB色彩空间时，选择CIE2000；图像是Rec.2020 Full色彩空间时，选择CIE2000_BT2020）。
白平衡误差分析
取样颜色的RGB平均值
RGB分量统计直方图，包含融合直方图与各分量直方图
选择数据来源¶
颜色分析工具既支持连接单板进行在线分析，又支持读取本地图片文件进行分析。
若连接在线分析，请按以下步骤进行操作：
将摄像机对准标准的PANTONE 24色色卡。
在PQTools工具主界面上，打开一个调试表文件（芯片型号与版本均与板端匹配）。
在板端运行ISP/VI/VPSS业务。
将PQTools工具连接到单板
通过主界面TOP->Mode Handle选择抓YUV通道（参考"读写通路设置"）。
在颜色分析工具的主界面上，点击“Online Real-Time Checking”单选框。
从“Stream Source”下拉框中选择图像数据源来自的模块（VI/VPSS/VO）。
若分析本地图片，请按照以下步骤进行操作：
在颜色分析工具的主界面上，点击“Local Image File”单选框。
选择一个PANTONE 24色色卡的照片。
使用24色颜色对比功能¶
在线模式下从板端获取到第一帧图片数据，或离线模式下打开了图片文件后，工具的状态栏会提示图像已经就绪（The image is ready）。此时可使用24色颜色对比功能。
图 1 24色颜色对比功能界面
在“Comparison”页签上，点击“Select Check Area”按钮，可以打开24色取样对话框：
图 2 颜色分析工具24色取样界面
拖动红色方框的边角，使得红色方框准确落在24色色块范围内，可达到最佳的颜色取样效果。使用对话框下方的Color Block Size选项，可以调整红色方框的水平和垂直大小。红色方框应尽量多地覆盖色块中的像素（但需要保证每个红色方框落在单独的色块内，同一方框内所有像素颜色相同），这样可以更精确的取色。
调整完毕后点击“OK”，这时界面上就会显示出颜色分析结果了，如图3所示。
图 3 显示颜色分析结果
通过Compare Color Space可以切换比较分量（仅限右边表格）。目前支持在CIE1976、CIE2000、RGB、CIE1976_BT2020与CIE2000_BT2020颜色空间之间进行切换。这里需要注意的是先通过Compare Color Space切换比较分量后再加载图片，才能得到正确的颜色分析结果。
若需要重新调整24色的取样范围，请在颜色分析工具主界面上点击“Select Check Area”按钮。
自定义标准色¶
颜色工具提供了一组默认的标准色卡值（以L*a*b*色彩空间的数值表示）。这组色卡值与D65光源，2度观察者角度下的X-Rite标准值近似。
用户还可以自行定义标准色卡值。点击“Comparison”页签下的Customize按钮，可以打开色卡配置的对话框：
图 1 标准色卡配置对话框
需要更改标准色卡值时，直接在表格对应的单元格中输入值即可。
点击Import From右侧的“Image File”按钮，用户可以自选一张标准色卡的图片，框定24色范围后，将其用作标准色卡。这时工具将根据用户框定的24色卡区域自动求取色卡的L*a*b*值。
点击Import From右侧的“Text Data File”按钮，用户可以选择一种包含标准色卡值的数据文件，并将其中的值导入作为工具的标准色卡值。目前支持导入Imatest3.4工具生成的csv文件，可选择导入ideal（标准值）或meas（输入值）的值。
从对话框右上角的Load Preset下拉框中，用户可以选择一组预设值作为标准色卡值。目前仅可选X-Rite D65近似值作为预设值。
查看RGB统计直方图¶
同样，在线模式下从板端获取到第一帧图片数据，或离线模式下打开了图片文件后，还可以选择使用RGB统计直方图功能。
图 1 统计直方图功能界面
查看统计直方图前，需要划定一块统计区域。激活“RGB Histograms”页签界面，点击位于页签内的“Select Analysis Area”，可以打开划定统计区域的对话框，如图2所示。
图 2 选择统计信息分析区域
拖动红色方框的边角可以选定分析区域。选择完毕后，单击“OK”按钮，工具就会显示该选定区域的分量统计数据，如图3所示。
图 3 显示统计直方图
其中在每个统计图内，横轴代表分量值（从左到右0-255），纵轴代表对应该分量上某个特定值的点数（对于某些最大分量点数过多的情况，工具对图像做了一定裁剪）。图片下方黑色的文字显示了该分量上的一些特殊值：
最大值（Max）：对应点数最多的分量值；
中值（Mid）：以该值为分界，大于等于（和小于等于）该值的分量值对应点数占到大约一半；
平均值（Avr）：该分量上所有点的分量值的算术平均值。
测算图片任意区域的信噪比SNR¶
在线模式下从板端获取到第一帧图片数据，或离线模式下打开了图片文件后，还可以选择使用信噪比SNR测算功能。在工具上方选择Noise页签即可开启该功能。
图 1 SNR测算工具
被打开的图片显示在工具中央。按住鼠标右键并移动鼠标，可以移动图片的位置；使用鼠标滚轮可以将图片进行等比缩放。
找到需要测算SNR的区域后，使用鼠标左键将该区域框出，工具即会在界面上方的文本框里给出SNR的测算结果。
本工具中计算SNR的公式为：-20*log(区域均方差/255)。
图 2 显示SNR计算结果
原始数据（RAW）和YUV分析工具¶
工具界面¶
从PQTools工具主界面工具栏的外挂插件下拉框中选择“PQ RAW YUV Analyzer”，可以打开RAW/YUV分析工具，如图1所示。
图 1 RAW/YUV分析工具主界面
RAW/YUV分析工具可以查看用户所打开的图像上每一个点的分量和具体亮度值，以及亮度分布的直方图。变换图像显示区域上方的选项卡设置，可以选择查看整体图像和每一个分量的图像。
另外，RAW/YUV分析工具在OnlineDebug页面中集成了在线验证NR标定参数的功能（参考"NR标定结果验证"）。
选择数据来源¶
RAW/YUV分析工具支持连接单板在线分析，支持打开本地的RAW格式文件进行分析，也支持打开本地的YUV格式文件进行显示。对于本地RAW/YUV数据，工具在支持专有格式RAW/YUV文件的同时，也支持通用RAW/YUV数据格式。
若连接在线分析，请按以下步骤进行操作：
在PQTools工具主界面上，打开一个调试表文件（芯片型号与版本均与板端匹配）。
在单板上运行ISP/VI/VPSS的业务。
将PQTools工具连接到单板。
通过主界面TOP->Mode Handle选择抓RAW通道（参考"读写通路设置"）。
在原始数据分析工具的主界面上，点击“Online Analyzing”单选框。设置获取图像的深度（Depth）。（在线分析过程中亦可以修改设置）
勾选上Dump RAW的复选框。
若要打开本地的RAW数据文件，请按以下步骤进行操作：
在RAW/YUV分析工具的主界面上，点击左边的“Local File”单选框。
选择一个.raw为后缀名的文件。
如果工具能检测到所打开文件的文件名中包含的图像信息，则会自动解析，否则会弹出详细设定对话框。在弹出的详细设定对话框中，用户需指定该数据文件的分辨率，深度，类型，分量模型，IR分量替换位置与文件头偏移值，紧凑raw选项。
图 1 通用RAW数据文件详细设定
单击“OK”按钮。
选定数据来源后，工具将显示原始数据的图像，如图2所示。
图 2 显示原始数据图像
多帧RAW文件查看
在原始数据分析工具的主界面上，在Frame文本框中输入要跳转到帧页面，按回车键即可跳转，也可使用Up/Down按钮在当前帧的上下页面之间跳转。
若要打开本地的YUV文件，请按以下步骤进行操作：
在原始数据分析工具的主界面上，点击右边的“Local File”单选框，并点击“Open YUV File”。
选择一个.yuv为后缀名的文件。
如果工具能检测到所打开文件的文件名中包含的图像信息，则会自动解析，否则会弹出详细设定对话框。在弹出的详细设定对话框中，用户需指定该数据文件的分辨率，位宽，像素格式，视频格式。
图 3 通用YUV数据文件详细设定
单击OK，图像数据显示参照图2所示，多帧文件的操作也参照上述的多帧RAW文件的操作。
在YUV Merge界面下，YUV Parameter中的“Color Gamut”，用于选择当前显示的YUV的色域空间；“Nominal Range”用于选择YUV显示的标称范围。
获取合并后的原始图像数据¶
在RAW Merge界面下，原始数据图像显示出来以后，将鼠标指针移到图像中，即可观察到鼠标指针指向的点（称为目标点）及其周围的点的分量和亮度值。
如果默认的图像大小取点困难，可以采用以下几种方式来缩放或调整图像：
按住鼠标右键并移动鼠标可以拖拽图像。
鼠标滚轮向前，可以将图像放大，且放大后的图像会聚焦到鼠标点击的点。鼠标滚轮向后，可以将图像缩小。
在Zoom框内，点击“+”或“-”按钮，可以按照预置的比例放大缩小。
在Zoom框内的输入框中，直接输入缩放比例。
分析数据显示在左侧的“Raw Data Graph”（分析数据图）框里，如图1所示。
图 1 分析数据图
其中，被黑色粗边框包围的方格表示目标点，其它的方格为目标点周围的图像点。
每个方格的背景颜色表示图像点属于哪个分量（在分析数据图下方有图例），方格内的数值表示图像点具体的亮度值。
可以通过“Pixels Around Mouse Point”设置分析数据图显示目标点周围图像点的范围（可选3x3、5x5、7x7）。
显示亮度统计直方图¶
如需查看特定区域的亮度分布统计直方图，用户可使用鼠标左键，在显示的图像上用鼠标画出一个方框，作为分析区域，如图1所示。
图 1 划定亮度分析区域
选定分析区域以后，工具将弹出对话框，显示亮度统计直方图以及具体的统计数据，如图2所示。
图 2 显示亮度直方图和详细统计数据
在统计图内，横轴代表有效分量值的范围，纵轴代表对应某个特定亮度的点数。图片下方带颜色的文字显示了该分量上的一些特殊值：
最大值（Max）：对应点数最多的分量值；
中值（Mid）：以该值为分界，大于等于（和小于等于）该值的亮度值对应点数占到大约一半；
平均值（Avr）：所有点的亮度值的算术平均值。
右侧的列表显示了每一个亮度值对应点的点数。
通过窗口右上角的下拉框，可选择查看整体直方图和单分量直方图。
查看分量图像¶
将工具界面的选项卡切换到“RAW Components”标签，可以查看分量图像。如图1所示。
图 1 查看分量图像
3A 分析工具¶
PQTools工具提供了3A分析工具插件，供用户方便地查看3A统计数据。
工具界面¶
从PQTools工具主界面工具栏的外挂插件下拉框中选择“PQ 3A Analyser”，可以打开3A分析工具，如图1所示。
图 1 3A分析工具界面
获取图像与统计数据¶
3A分析工具当前仅支持连接单板进行分析。打开工具界面后，用户需通过以下操作从单板获取图像，以及对应的统计数据：
在PQTools工具的主程序上，进行与板端的连接。
在3A分析工具的主界面上，在Capture Image From 之后的下拉框中，选择图像数据源。目前工具支持从VI、VPSS或VO上获取图像数据。
勾选Capture Image from之前的复选框。
之后工具将自动从板端抓取数据，直到用户取消对Capture Image 复选框的勾选。成功从板端抓取数据后，工具会在下方的灰色区域显示图像效果如图1所示。
图 1 3A分析工具显示图像数据
点击“+”或“-”按钮，可以按照预置的比例放大缩小。
输入框中，直接输入缩放比例。
鼠标右键可以拖动图像
点击Reset可以复位图像的大小和位置
查看AE统计数据¶
点击3A分析工具右上角的AE按钮，可以打开AE统计信息对话框如图1所示。
图 1 AE统计信息对话框
界面上的Stitch复选框，支持拼接功能。且FE Histogram有多组，且为1024。
Pipe id用于选择不同pipe的拼接分块统计信息，只有在勾选了Stitch的情况下才有效。用户需要保证Pipe id与主界面TOP页面的 ViPipe一致才能使图和统计信息对应。
Select Item下拉框用于选择某个分块统计信息的分量显示在图像中的每个分块格子内，当选择None时，图像上不显示任何值。
同时，3A分析工具的主界面图像区域也会被黄线分割成一个个区间，用户可以使用鼠标左键进行区间选择，如图2所示。
图 2 AE区间选择
AE功能页面各区域功能如下（对应图1）：
统计信息：可以查看全局和分区间的分量平均值。在3A分析工具主界面切换选区时，选择区间的统计信息数据会变化。
保存统计信息：点击“Export AE Statistics”按钮，可将从板端获取的AE统计信息数据保存为明文的txt文件；
直方图：可查看AE统计直方图。可使用上方的下拉框或标签页选择来切换想要查看的直方图。After DRC Histogram 1024是工具板端程序自动将AE统计信息切换到After DRC之后，重新获取上来的BE直方图，切换到After DRC Histogram 1024后，全局统计信息和分块统计信息也会是After DRC的。All Histogram是将所有的直方图合并到一个页签内，该页内的某个直方图(背景色变成白色)，则当前的分块统计信息和全局统计信息也会与之对应。
拼接模式下，若图像是多路拼接的，则导出的统计信息也是多路的，并且与图像是相对应的。以SS928V100为例，VI、VPSS导出Pipe的统计信息，VO导出拼接后的统计信息。
当Histogram Quick Jump下拉框切到MG时，是没有直方图信息的，只有全局统计信息和分块统计信息，线性模式下，MG统计信息默认是bypass的（获取上来全是0），需要将工具主界面Top-> Bypass Setting中 bit_bypass_mg_stat去勾选才能获取到正常的MG统计信息。
在获取After DRC位置的BE统计信息前，需要将ExposureAttr中的op_type和hist_stat_adjust分别设置Manual和False，并且要将DRC的开关打开，否则After DRC统计信息可能会有异常。
当选择从VI或VPSS获取图像时，板端工具会创建一个venc通道用于将VI和VPSS通道的YUV送入进行编码生成JPEG图像，再发送给3A分析工具。创建的VENC通道的通道号默认为最后一个通道，可以通过修改板端版本包里面的config.cfg中的“JpegChn”来配置。选择从VO获取图像则是由板端将VO通道的YUV图像直接发送给PC端。
查看AF统计数据¶
点击3A分析工具右上角的AF按钮，可以打开AF统计信息对话框如图1所示。还可以选择在3A主界面上显示某通道某成员的值。
图 1 AF统计信息对话框
同时，3A分析工具的主界面图像区域也会被黄线分割成一个个区间，用户可以使用鼠标左键进行区间选择，如图2所示。
图 2 AF区间选择
在统计信息对话框中，可以查看所选区间的AF统计信息。在3A分析工具主界面切换选区时，统计信息数据会变化。
点击AF统计信息对话框下方的“Export AF Statistics”按钮，可将从板端获取的统计信息保存为明文的txt文件。
查看AWB统计数据¶
点击3A分析工具右上角的AWB按钮，可以打开AWB统计信息对话框如图1所示。AWB界面上有Stitch复选框，支持拼接操作。
图 1 AWB统计信息对话框
同时，3A分析工具的主界面图像区域也会被黄线分割成一个个区间，用户可以使用鼠标左键进行区间选择，如图2所示。
图 2 AWB区间选择
在统计图上显示的内容有：
红色曲线：普朗克曲线。
绿色点：全局统计信息在普朗克坐标系上对应的点。
紫色点：AWB计算结果在普朗克坐标系上对应的点。
蓝色点：分区间统计信息在普朗克坐标系上对应的点。
绿色曲线：基础白区区间。其中中间线基本等同于普朗克曲线，与ActiveShift值相关。
蓝色点段线：Rgain和Bgain的取值范围。在手动模式下，这两个值固定；在自动模式下，会和当前板端设定的高低色温相关。
右上和左下的红色直线围成的区域：分别为排除紫色和绿色干扰而从白区中剔除的区间。与AWB参数中的CurveLLimit和CurveRLimit相关。
十字型标记：表示独立光源点。周围的红色或绿色圆圈表示独立光源点的影响范围。其中绿色圆圈表示增加的白区表现，红色圆圈表示因排除干扰而剔除的白区表现。
紫色的Result Coordinate字样：显示AWB在普朗克曲线上的坐标值。
通过图像上方的Show Statistics、Show Planckian Curve、Show White Zone可分别控制坐标图上统计信息、色温曲线和白区区间（包含独立光源点）的显示与隐藏。
从左侧图像上选定区间，可以将右侧坐标图上对应该区间的统计信息点高亮显示。用鼠标左键点选分区间统计信息的点，可在3A工具主界面的图像上自动选择对应的区间。
BIN 0用于显示不同亮度范围下的统计图。BIN的个数取决于主界面上的StatisticsConfig -> WBConfig -> ZoneBin，亮度范围取决于同一页面下的HistBinThresh。
点击“Export AWB Statistics”按钮，可以将从板端获取到的统计信息数据保存为明文的txt文本文件。
拼接模式下，若图像是多路拼接的，则导出的统计信息也是多路的，并且与图像是相对应的。以SS928V100为例，VI、VPSS导出Pipe的统计信息，VO导出拼接后的统计信息。
拼接模式下，每一路的参数是独立配置的，每一路的分块个数都需要配置，而且需要相同。即每一路的stitch_enable，zone_col，zone_bin需要相同。
3A分析工具获取的AWB统计信息是统计模块直接输出结果。
配置AWB统计模块位置为Expander后时，3A分析工具的统计信息和AWB算法的统计信息不一致。此时，AWB分析工具不可用。
AWB独立光源点编辑¶
3A分析工具中的AWB页面独立光源点编辑。在工具上点击“Extra Light Source Setting”按钮，可以打开白区编辑对话框，如图1所示。
图 1 独立光源点编辑示意图
用户可以编辑最多4组独立光源点设置。按照以下的步骤即可进行：
选择编辑的独立光源点组（左侧Source 1至Source 4）；
选定独立光源点类型：Idle——无白区设置；Add light source——添加独立光源点；Delete sensitive color——剔除干扰区域；
指定光源点的红色和蓝色增益值，以及作用半径；
视需要重复步骤1-3后，点击“OK”按钮。
设置完成后，再抓取一次3A分析信息，普朗克坐标图即会刷新并显示用户的独立光源点及其引入的白区范围。
此外，用户可以通过图像区域上选取区间来快速添加独立光源点。在区间上点击右键，工具即会弹出选项菜单，如图2所示。
图 2 添加独立光源点选项菜单
用户可以在Add Light Source菜单项中选取独立光源点组添加独立光源点，在Delete Light Source中选取独立光源点组剔除干扰区域。选取后，在弹出的对话框中输入半径，即可完成添加。
应用局部AWB结果至全局AWB¶
工具支持将某一区间上的AWB结果应用至全局。在区间上点击右键并选择Apply Result to Global（见图2），即可完成设置。
使用该功能后，AWB将强制变更为手动模式。如需切换回自动模式，请调节PQTools工具主界面的相关寄存器参数。
如果所选分区间的统计信息存在CountAll=0、R=0、B=0三种情况中的任意一种，则无法应用此区间的AWB结果至板端。此时工具会提示错误。
自动对焦参数仿真工具使用说明¶
PQTools工具提供了自动对焦参数仿真插件，使图像质量调试人员可以：
根据截止频率自动获取较适合的AF参数，并查看对应的频率响应曲线；
自行配置AF参数，并查看对应的频率响应曲线。
工具界面¶
从PQTools工具主界面工具栏的外挂插件下拉框中选择“PQAuto Focus Simulator”，可以打开自动对焦参数仿真工具，如图1所示。
图 1 自动对焦参数仿真工具
工具分为For Horizontal filters 和For Vertical filters两个页签，相互独立，分别对应水平和垂直方向的滤波器参数仿真。下面叙述的内容对两个页签均有效。
AF水平滤波器具备以下两种模式：
窄带模式（Narrow Band）：此种模式下，AF水平滤波器将在一个较小的频率范围内进行对焦。当用户设置的截止频率的低频小于0.04时，工具将推荐用户使用窄带模式。这个模式下，截止频率高频最大值为0.25。
宽带模式（Wide Band）：此种模式下，AF水平滤波器将在一个较大的频率范围内进行对焦。当截止频率的低频大于或等于0.04时，工具将推荐用户使用宽带模式。这个模式下，截止频率高频最大值为0.5。
用户可以使用Apply To Board按钮将参考组表中任意的一组数值下发到板端对应的寄存器分组来对模式和滤波系数进行设置。
通过截止频率获取AF滤波系数¶
在每个页签中，用户均可以用截止频率来生成滤波系数。在Generate from Frequencies处输入截止频率的低频和高频后，点击“Generate AF Parameters”，即可生成截止频率对应的滤波系数，显示在Parameters adjustment下方的各个文本框中，并在右侧的坐标图上显示对应该组滤波系数的频率响应曲线，曲线以红色表示，如图1和图2所示。
图 1 通过截止频率获取滤波系数（窄带）
图 2 通过截止频率获取滤波系数（宽带）
手动配置滤波系数¶
除了通过截止频率获取对应的滤波系数，用户还可以手动设置每个滤波系数项。在Parameters adjustment处，找到对应的参数并进行修改后，工具将自动计算这组参数的频率响应曲线并绘制在右侧。曲线以红色表示。但是“IIRShift”参数为只读参数，不能进行手动配置。
设置参考组¶
如果用户想要在不同组的滤波系数间对比，可以使用参考组功能。当用户需要将某一组滤波系数列为参考组时，点击“Add to Reference List”按钮，工具即会在右下角的列表中添加一行，列出该参考组的参数项，如图1所示。
图 1 参考组列表
对于每一个参考组，工具还将在上方的坐标图上生成一条曲线，以灰色表示，如图2所示：
图 2 参考组的曲线显示
用户还可以将某一参考组的曲线高亮显示出来。在列表中点击需要高亮显示的参考组，此时对应的曲线会在上方的坐标图中变成蓝色，如图3所示：
图 3 选中参考组曲线高亮显示
通过这样的方式，用户可以在不同的参考组间进行频率响应曲线对比，从而发现更优的方案。
在坐标图上，红色的当前参数曲线和蓝色的参考组高亮曲线相对其他的灰色参考组曲线处于更上方的位置。因此，会出现刚刚添加参考组时看不到灰色曲线的状况。此时只要修改滤波系数，使红色曲线重新绘制，就能看到灰色的参考曲线。
每个页签上最多只能添加6组参考组。如果需要添加新的参考组，请先点击Clear Reference List删除所有参考组。
其他辅助工具使用说明¶
抓拍工具使用说明¶
PQTools工具提供了易于使用的抓拍工具，可以抓取板端的图像数据（RAW、YUV、JPEG），也可以抓拍AE、AWB和Dehaze的Debug信息并保存为本地文件。
工具界面¶
从PQTools工具主界面工具栏的外挂插件下拉框中选择“PQ Capture Tool”，可以打开抓拍工具，如图1所示。主界面分为五部分：
raw图像抓拍
yuv图像抓拍
jpeg 图像抓拍
debug信息抓拍
抓拍后续处理
图 1 抓拍工具界面
抓取YUV图像数据¶
抓取YUV图像数据步骤如下：
通过主界面TOP->Mode Handle选择抓YUV通道（参考"读写通路设置"）；
在“YUV Image”分组框中选择抓取YUV数据的位置（VI/VPSS/VO/MCF）；
如果板端运行AVS拼接业务时，若需要从拼接的各路同时抓取YUV图像，则勾选“StitchFlag”，抓拍成功后得到的YUV文件的帧数是界面上输入的帧数*拼接路数，帧顺序为AVS pipe的顺序；
输入抓取的帧数；
点击Capture按钮，若抓取成功，且板端的config.cfg中配置Dump_Method/Method值为0（默认为0），YUV数据将保存到工具已选择的路径下；
当勾选了“Change file directory”，每次抓拍工具将弹出选择保存YUV文件路径的对话框，否则只有首次抓拍会弹出。若抓取成功，则保存在已选择的目录下。
须知：SS928V100解决方案最大支持帧数为5000帧。
勾选StitchFlag后，从AVS前端绑定模块抓取数据，与YUV Image Capture选取的YUV数据抓取位置无关。
若抓取的帧数较大，超出了板端当前分配的vb块数，需要修改ini文件，增加分配给业务的vb块数。板端可供抓取的帧数为业务第一次启动时的所有可用Pool下的Minfree之和（通过cat /proc/umap/vb查看），如果大于这个数，会占用业务正常运行时使用的vb，导致抓取的帧是不连续的。
若通道开启压缩模式，抓取YUV会进行解压缩再发送给PC端，解压缩的操作会占用一块vb。
拼接模式下YUV文件保存顺序：四路拼接，勾选StitchFlag，Frames为2，抓取的YUV文件帧顺序按AVS pipe顺序保存（pipe0-pipe1-pipe2-pipe3-pipe0-pipe1-pipe2-pipe3）。
抓取RAW图像数据¶
抓取RAW图像数据步骤如下：
单通路：
在“RAW Image”分组框中选择抓取RAW数据的位宽。
在Mode下拉框处选择设备模式：
若设备运行在线性模式下，请选择“Linear”；
若设备运行在WDR模式下，请根据设备实际运行情况，选择VC通路（VCNum）或多VC结合（2in1等）选项。
在pipe下拉菜单 选择要抓取的pipe。
设置抓取的次数 Captimes。
如果需要在抓拍成功后的文件名中体现帧数量等信息，则勾选“Custom File Name”，可以自定义文件的名称前缀，并在抓拍后的文件名中体现帧数量（实际抓拍到的帧数）；
如果板端运行AVS拼接业务时，若需要从拼接的各路同时抓取RAW图像，则勾选“StitchFlag”，抓拍成功后得到的RAW文件的帧数是界面上输入的次数*拼接路数，帧顺序为AVS pipe的顺序；
如果需要在抓拍RAW数据的同时保存ISP相关信息，请勾选“Raw Info”（勾选此选项并进行抓拍后，工具会在保存通常RAW数据文件的同时，还会生成一个带有ISP信息的文本文件）
如果需要在抓拍RAW数据的同时保存编码信息，请配置config.cfg 文件中[Other]的RawExtraInfo=1，板端重启业务，然后抓拍RAW数据，就会生成一个带有编码信息的文本文件。编码信息为板端抓完所有RAW数据后，从/proc/umap/rc获取的文本信息。
如果需要连续不断地抓拍RAW数据，请勾选“Auto Capture”。勾选后，点击“Capture”按钮，工具就会抓拍一组连续帧保存到文件中（帧数在界面上配置），然后又继续发送命令抓拍，直到用户点击 “Cancel”按钮才停止。每组RAW数据之间是非连续的。
点击“Capture”按钮。若勾选了“Change file directory”，每次点击“ Capture ”，抓拍工具都会弹出选择保存RAW文件路径的对话框，否则只有首次抓拍会弹出。若抓取成功，则保存在已选择的目录下。
若抓取成功，且板端的config.cfg中配置Dump_Method/Method值为0（默认为0），RAW数据将保存到工具已选择的路径下。
在抓取YUV或RAW图像数据时，用户可随时取消抓取。点击“Cancel”按钮，工具会在抓取到下一帧数据后停止进行抓取，并恢复界面可操作状态。但是若工具已经抓取到最后一帧图像数据，则暂停会无效，工具还将弹出图像数据保存对话框。
多通路：
在“RAW Image”分组框中选择抓取RAW数据的位宽。
在Mode下拉框处选择设备模式：
若设备运行在线性模式下，请选择“Linear”；
若设备运行在WDR模式下，请根据设备实际运行情况，选择VC通路（VCNum）或多VC结合（2in1等）选项。
点击多通路功能复选框 Multiple 在弹出的多个复选框中选择和板端业务匹配的通路
设置抓取的次数 Captimes .
点击“Capture”按钮。若勾选了“Change file directory”，每次点击“ Capture ”，抓拍工具都会弹出选择保存RAW文件路径的对话框，否则只有首次抓拍会弹出。若抓取成功，则保存在已选择的目录下。
须知：多通路抓拍不支持单通路下的拼接复选框功能.但是可以单独抓取多个拼接通路的RAW文件。同时多通路抓拍功能最少需要选择一个pipe。多通路模式下 按照选择的pipe个数保存文件。一个文件对应一个pipe。
新增特殊抓拍场景，使用Bas 复选框 和FE复选框进行选择。
抓取的图像数据均为纯数据，不包含任何头数据。
抓取RAW数据时需要common vb配置为图像的像素数乘以2，否则抓取可能会失败。
抓取数据的bit数不应该小于sensor数据的bit数。
SS928V100解决方案最大支持帧数为5000帧。
若抓取的帧数较大，超出了板端当前分配的vb块数，需要修改ini文件，增加分配给业务的vb块数。板端可供抓取的帧数为业务第一次启动时的所有可用Pool下的Minfree之和（通过cat /proc/umap/vb查看），如果大于这个数，会占用业务正常运行时使用的vb，导致抓取的帧是不连续的。
拼接模式下RAW文件保存顺序：四路拼接，勾选StitchFlag，Frames为2，抓取的RAW文件帧顺序按AVS pipe顺序保存（pipe0-pipe1-pipe2-pipe3-pipe0-pipe1-pipe2-pipe3）。
抓取JPEG图像数据¶
以SS928V100为例，抓取JPEG图像数据步骤如下：
在“JPEG Image”分组中，在“Capture from”下拉框处选择抓取数据的位置（AVS\VI\VPSS\VENC）；选择AVS时，如果是单镜头抓拍，选择镜头对应的Pipe，勾选Pipe0或Pipe1，如果是双镜头抓拍，Pipe0和Pipe1都勾选，如果需要抓拍AVS拼接的所有镜头，则勾选All Pipe。Source Seq用于指定AVS前端模块（例如VPSS）的镜头顺序（例如4路场景的两路非融合拼接，Source Seq指定为3 2 1 0，表示用户定义VPSS Grp3为镜头0，VPSS Grp2为镜头1，VPSS Grp1为镜头2，VPSS Grp0为镜头3），镜头号会体现在JPEG文件命名上。
根据不同位置显示的不同UI，在Group、Pipe、Chn等编辑框输入相应的值，选择Check控件是否使能。（Trigger复选框勾选时是在snap通路抓图像数据，不勾选时抓的是视频通路数据）
点击“Capture”按钮，抓取JPEG图像。如果勾选了“Change file directory”复选框，每次点击“Capture”都会让用户选择保存目录，否则就使用上次选择的目录。
须知：“Capture from”选择AVS\VI\VPSS时，出JPEG的编码通道在板端的config.cfg文件中设置。JpegChn =63表示这个JPEG编码通道的通道号，不能与业务中使用的编码通道号重复。
“Capture from”选择VENC时，需要保证该编码通道为JPEG编码通道，否则抓拍失败。
如果业务中没有JPEG编码通道，从H.264\H.265编码通道绑定的前端模块（比如VPSS）抓拍JPEG，即可得到对应的JPEG图像。
“Capture from”选择AVS时，需要在Stream工具上配置AVS的通道绑定关系，具体请参考章节"Stitch数据源切换"。
不支持压缩通路抓jpeg。
抓取调试信息¶
PQTools工具提供了抓取AE/AWB/Dehaze模块调试信息的功能。可以在“Debug Information”分组框内找到操作接口。
抓取AE的调试信息步骤如下：
通过主界面TOP->Mode Handle选择通道（参考"读写通路设置"）。
在“AE/AWB/Dehaze Max Frame Count”文本框里输入抓取调试信息的帧数。
点击AE右侧“Start”按钮。
点击AE右侧“Stop”按钮。若抓取成功，工具将弹出保存文件对话框，此时选择保存位置。
抓取AWB的调试信息步骤如下：
通过主界面TOP->Mode Handle选择通道（参考"读写通路设置"）。
在“AE/AWB/Dehaze Max Frame Count”文本框里输入抓取调试信息的帧数。
点击“AWB”按钮右侧“Start”按钮。
点击“AWB”按钮右侧“Stop”按钮。若抓取成功，工具将弹出保存文件对话框，此时选择保存位置。
抓取Dehaze的调试信息步骤如下：
通过主界面TOP->Mode Handle选择通道（参考"读写通路设置"）。
勾选主界面Dehaze->Enable使能Dehaze。
在“AE/AWB/Dehaze Max Frame Count”文本框里输入抓取调试信息的帧数。
点击Dehaze右侧“Start”按钮。
点击Dehaze右侧“Stop”按钮。若抓取成功，工具将弹出保存文件对话框，此时选择保存位置。
若界面上对应的抓取功能被禁用，则表示当前的芯片无法支持。
抓取的AE、AWB和Dehaze调试信息为转换后的明文数据。
抓取的AWB调试信息中的统计信息，支持最大32*32分块* 4bin工作模式，或者最大32*32分块* 1bin * 4路拼接工作模式。
RAW实用工具使用说明¶
PQTools工具提供了RAW实用工具，可供用户将抓取的RAW图像数据倒灌回板端。
工具界面¶
从PQTools工具主界面工具栏的外挂插件下拉框中选择“PQ RAW Utilities”，可以打开RAW实用工具，如图1所示。
界面的“StitchFlag”复选框用于选择是否为拼接模式，“RawSource”选择列表用于选择“FE”和“USER”。
图 1 RAW实用工具界面
导入RAW数据¶
在进行倒灌和转换操作之前，用户需要将RAW数据导入到工具左侧的列表中，点击工具右上角的Add RAW File按钮即可添加RAW文件，支持同时导入多个文件。
如果导入的RAW文件是在抓拍工具抓拍到，且以默认文件名保存的（格式形如RAW_1920x1080_12bits_RGGB_Linear_XXXXXX），则RAW实用工具可以直接解析这个RAW文件的大小、位宽、模式、分量排序。
工具会对每一个无法直接解析文件名的RAW文件弹出图1所示的RAW属性输入框，此时用户需要手动填写RAW数据的属性。
图 1 RAW属性输入
按如下步骤填写：
在Resolution (W x H)处填写RAW图像的分辨率。如果RAW图像实际的分辨率为常用分辨率，可在右边的Quick Select下拉框快速选择；
选择RAW数据是在哪个stream模式下被抓拍出来的（线性/WDR VCNum0~3/WDR结合2~4 in1）；
在Bit Depth下拉框处选择RAW数据的位宽（8bits/10bits/12bits/16bits）；
在Bayer Format处选择RAW数据对应的分量排序模式（RGGB/GRBG/GBRG/BGGR）。
若导入的所有文件中，所有尚未设置属性的RAW数据与当前设置属性的RAW数据具备完全一致的分辨率、模式、位宽、分量排序值，则用户可以勾选Apply to all unresolved RAW files复选框，指示工具对所有尚未设置属性的RAW数据统一设置属性。
点击“OK”按钮。
导入RAW数据完成后的界面如 图2所示。
图 2 导入RAW数据后的RAW实用工具界面
导入RAW文件后可以进行以下列表编辑操作：
选中：可以直接在列表上点击一行以选中改行指定的RAW文件。可以使用Ctrl或Shift按钮进行多选；
上移/下移：选中RAW文件后，可以点击Move Up将选中的文件上移一个位次，或是点击Move Down下移一个位次；（多选RAW文件时，仅对选中的第一个RAW文件生效）
删除：选中RAW数据后，可以点击Delete按钮删除所有选中的RAW文件项；
清空：点击Delete All按钮，可以清空RAW文件列表。
全选/反选：点击Deselect All取消全部，点击Select all选中全部。
可以修改 pipe 列的数值来指定要灌入的 VIpipe通道 [0,7]。修改一个同时可以修改列表内的所有RAW文件对应的pipe。
勾选Multiple功能复选框后，可以单独修改每个RAW文件对应的pipe列数值。此功能只有在板端具有多个pipe的业务场景下才可以使用。
RAW数据的ISPInfo信息¶
用户在导入RAW数据时，工具会先获取RAW文件的ISPInfo信息。
ISPInfo信息获取来源优先级：
RAW的同名txt。
RAW的文件名。
用户输入。
具体每种方式如下：
RAW的同名txt: 信息完整时，正常导入；信息不完整时，参数默认值为0，提示用户信息不全的参数。
无txt，文件名符合新规范：
文件名信息完整时，正常导入；基础信息不完整时，弹框输入基础信息；ISPInfo信息不全或没有时，解析不到的参数值默认值为0。例如：RAW_3840x2160_16bits_RGGB_WDR(2in1)_iso105_ag1024_dg1024_ispdg1080_exp456_cnt30.raw_cvt.raw
无txt，文件名符合目前工具抓出来的规范：
文件名信息完整时，正常导入，ISPInfo默认值为0。例如：RAW_3840x2160_16bits_RGGB_WDR(VCNum1)_20190110142508.raw
无txt，文件名不符合任意规范：
弹框输入基础信息，ISPInfo默认值为0。
点击RAW工具界面的Info列的按钮，弹出ISPInfo编辑界面，可以修改和保存选择的RAW文件的Info信息。
图 1 ISPInfo信息编辑界面
界面功能如下:
Frame Number编辑框：显示索引号为编辑框中的frame的ISPInfo信息。
“<<” 和“>> ”按钮：切换显示RAW头尾frame的ISPInfo信息。
“< ”和“>”按钮：切换显示RAW前后frame的ISPInfo信息。
通过修改滚动条的值切换到对应frame的ISPInfo信息的显示。
Set to all frames按钮：将当前界面上的ISPInfo信息设置到RAW的所有帧。
Refresh按钮：将板端的BlackLevel的值刷新到界面上。
Save Raw Information按钮：会把编辑后的Raw的所有frame(主pipe和非主pipe)的ISPInfo按照索引号保存到文件中，默认文件名和RAW相同，文件格式为txt，文件名字和路径可编辑。
编辑框内输入的值，超出范围时，均按照取值范围做剪切并生效。
向板端倒灌RAW图像数据¶
向板端倒灌RAW图像数据步骤如下：
导入RAW文件后 默认的灌入通路为pipe 0，可以手动修改RAW文件列表的Pipe属性来选择灌入的板端通路；
按"导入RAW数据"章节的说明，导入需要灌入的RAW文件。可以同时灌入多个文件。导入后，在列表第一列勾选需要灌入的RAW文件。
使用右侧的Move Up和Move Down按钮调整RAW文件的次序。工具组合RAW文件数据时，按照从上到下的顺序排列。
指定发送到板端的RAW帧的起始帧(F.Start, 从1开始计数)，结束帧(F.End, 必须大于等于起始帧)，以及帧发送间隔（F.Gop,默认值为1，即逐帧发送，若大于1，则跳帧发送）。
设置灌入方式：选择Route Combine方式时，工具会将勾选的相同通路的RAW数据组合在一起后，按通路号从小到大的次序依次将RAW文件灌入设备。
使用Route Combine方式倒灌RAW数据时，如果需要使用循环倒灌功能，请将Loop单选框勾选。
如果需要灌RAW时同时发送IspInfo到板端，需要勾选IspInfo复选框，工具就会解析与RAW文件同一路径下同名的txt文件，并将参数发送到板端。板端灌RAW过程中会将IspInfo中的“Exposure_Time”、“A_Gain”、“D_Gain”、“ISP_D_Gain”这几个参数的值通过OT_MPI_ISP_SetExposureAttr生效；“Ratio_0”、“Ratio_1”、“Ratio_2” 这几个参数通过OT_MPI_ISP_SetWDRExposureAttr生效；“BlackLevel_R”，“BlackLevel_Gr”，“BlackLevel_Gb”，“BlackLevel_B”通过OT_MPI_ISP_SetBlackLevelAttr生效；“Bayer”则通过OT_MPI_ISP_SetPubAttr生效。并且会将对应Auto/Manual设置为Manual。当点击“Flush”停止灌RAW时，参数会被恢复到灌RAW之前的值。
SS928V100支持灌RAW到FE。灌RAW到FE前，需要开启自产生时序。开启方法是：勾选主界面可调项的TimingAttr页面的Enable。
注意：
FE灌wdr格式RAW文件时，必须在业务初始化时开启自产生时序属性，设置方法是在对应场景的ini文件的业务相关[vi_timing.x] 属性中配置TimingEnable = TRUE, TimingFrmRate = 合适的帧率。点击“Send”将图像数据发送到板端。
如果发送结束，点击“Flush”按钮通知板端结束发送。如果取消灌RAW，点击“Cancel”按钮通知板端终止灌入。
如果板端运行的是拍照业务，需要灌RAW来调试拍照效果，可以参考下面操作：
将Top页面的ViPipe改为拍照的pipe，配置SnapAttr页使拍照帧数大于0；
单pipe拍照模式可以灌RAW到BE（勾选SnapMode和Loop），然后用抓拍工具抓取JPEG（不勾选Trigger）。也可以灌RAW到FE（不勾选SnapMode），然后用抓拍工具抓取JPEG（勾选Trigger）。
双pipe拍照模式需要勾选SnapMode和Loop灌RAW到BE，灌入的帧数需要与SnapMode中的帧数保持一致，然后勾选抓拍工具的Trigger，从抓拍通路抓取JPEG。当抓取JPEG时，正在循环灌到视频通路的RAW会被灌到抓拍通路，抓取的JPEG与灌入的RAW是一一对应的关系。
如果是线性多通路场景或者WDR及拼接场景。在不使用默认的WDR或者拼接RAW文件灌入时，可以勾选界面的Multiple 复选框然后导入想要灌入不同通路的RAW文件。修改各自的Pipe属性。点击“Send”即可灌入板端不同通路，此功能不限制不同通路之间的分辨率差异（需要各个通路的灌入帧数保持一致）。
.F.Gop和F.Start配合使用，可用于发送RAW文件中的部分帧：比如导入帧顺序按AVS pipe顺序保存RAW文件（pipe0-pipe1-pipe2-pipe3-pipe0-pipe1-pipe2-pipe3），如果F.Start设置为3（即从第三帧开始）、F.Gop设置为4，则可将pipe2的RAW数据灌入板端。
未勾选Multiple时，列表中所有相同通路的RAW文件必须具备相同的分辨率，位域，Bayer序列和模式，且必须与所灌入通路的设置一致。否则灌入操作会失败。
若灌入的帧数较大，超出了板端当前剩余的MMZ内存，可以在保证板端业务正常运行的前提下，将分配给业务的vb的块数尽可能地减少。
若要将WDR(VCNum1~3)格式的RAW灌到线性场景下，需要手动将文件名中的“WDR(VCNum1~3)”更改为“Linear”，如果有对应的isp info的txt文件，则需要将文件里的WDR_Mode值改为0。
若没接sensor时需要灌RAW进行调试，可以打开自产生时序后进行灌RAW（将ini文件中的TimingEnable设置为TRUE后重启业务），以这种方式灌RAW时WDR模式下的帧率可能会不达标。
YUV实用工具使用说明¶
PQTools工具提供了YUV实用工具，可供用户将抓取的YUV图像数据倒灌回板端。
工具界面¶
从PQTools工具主界面工具栏的外挂插件下拉框中选择“PQ YUV Utilities”，可以打开YUV实用工具，如图1所示。
图 1 YUV实用工具界面
向板端倒灌YUV图像数据¶
向板端倒灌YUV图像数据步骤如下：
图 1 YUV属性输入
通过主界面TOP->Mode Handle选择灌YUV通道（参考"读写通路设置"）；
点击“Add YUV File”按钮，选择YUV文件添加到左侧列表中。
在弹出的对话框中指定YUV文件的各项参数（如果YUV文件来源于抓拍工具，则此步骤可以省略，配置对话框不会弹出）。
F.Start和 F.End用于指定发送到板端的YUV帧数的范围（以1起始，起始帧不能大于结束帧）。
在Send to下拉框中设置灌入位置。
可勾选“StitchFlag”复选框进行拼接灌包，选择“Loop”复选框循环灌包。
点击“Send”将图像数据发送到板端。
点击“Flush”按钮，停止循环灌包；点击“Cancel”按钮，取消灌YUV。
须知：F.Gop和F.Start配合使用，可用于发送YUV文件中的部分帧：比如按照AVS pipe顺序（pipe0-pipe1-pipe2-pipe3-pipe0-pipe1-pipe2-pipe3）保存YUV文件，如果F.Start设置为3（即从第三帧开始）、F.Gop设置为4，则可将pipe2的YUV数据灌入板端。
默认提供的ini不支持从vi灌YUV，如需要请参考ini文件适配"说明9："配置ini并重新启动业务。
“Cancel”功能暂不支持。
当前支持从VI/VPSS/AVS/VENC模块灌入。
当前支持两种格式 YUV_planar420，YUV_semiplanar420
对mcf 模块灌入YUV时，要自行确认好对应通路的YUV格式。保证黑白和彩色YUV灌入正确的mcf chn。同时和其他模块不同，mcf 灌YUV需要注意，group/pip通路默认一般为0，需要根据chn号来设置区分黑白和彩色通路。
外接存储设备抓灌说明¶
PQTools工具提供了抓拍RAW或YUV存储至外接存储设备和从外接存储设备读取RAW文件倒灌的功能。
使能该功能需要配置板端的config.cfg。
抓取图像存储到外接设备¶
Config.cfg的[Dump_Method]是抓拍存外接存储设备的控制参数。[Yuv_Image]和[Raw_Image]中的参数等同于PC端工具界面上的参数。[Dump_Method]中的各参数作用如下：
[Method]
0：关闭抓拍存外接存储设备功能；
1：可通过PC端来触发抓RAW/YUV存储到设备；
2：重启板端业务会自动抓取RAW/YUV存储；
3：重启板端业务会自动读取文件灌RAW。
4：重启板端业务会自动读取文件灌YUV。
[Path]
保存图像文件的路径，可设置为挂载的外界存储设备的路径。
[Option]
0：表示边抓图像边存文件，该方式不受限于板端的内存，但受限于存文件的速度，若速度不够快时，可能会导致丢帧。文件需要以O_DIRECT的方式打开，文件系统需要使用CMA方案（请见“使用CMA方案保存RAW文件到SSD”描述）；
1：表示先抓完图像存到vb中，再将vb中的图像数据一起写到文件中，该方式受限于板端内存的大小。
[SplitSize]
当抓拍的图像文件长度超过该值（单位为MBytes），程序会自动切分文件。
[DelayTime]
若Dump_Method配置为2或3，启动板端工具后，程序会延迟DelayTime分钟的时间再进行自动抓灌。
[Image]
0：表示抓YUV；
1：表示抓RAW。
[SaveIspInfo]
当设置为1时，抓RAW或YUV会生成对应的IspInfo信息的txt文件。
板端保存文件是紧凑型的，而工具端保存的文件则是非紧凑型的，板端保存的10bit和12bit的图像文件不能直接给工具端使用。
若开启Dump_Method/Method，3A分析工具、鱼眼标定工具、辅助对焦工具等需要抓拍的工具将无法抓拍，图像已被存在板端。
对于USB3.0接口，使用高写入性能的固态硬盘，能够满足抓拍3840*2160@30fps 8bit、10bit RAW的连续帧。抓取3840*2160@30fps 12bit 16bit不丢帧请选用更高写性能的固态硬盘。
首次触发抓拍弹出文件路径保存对话框，配置抓到pc端的数据保存路径。
Option为0类型时保存文件数据512对齐，部分场景下抓取数据不能被图像宽高整除，因此无法通过板端灌入此文件。
使用CMA方案保存RAW文件到SSD¶
使用CMA方案配置uboot启动参数和加载相关ko的参数，以SS928V100为例：
修改u-boot的参数：
setenv bootargs 'mem=4032M mmz_allocator=cma mmz=anonymous,0,0x64000000,3520M console=ttyAMA0,115200 root=/dev/mtdblock2 rw rootfstype=yaffs2 mtdparts=nand:1M(boot),9M(kernel),16M(rootfs)'修改load_ss928v100：将该脚本中的mmz_allocator=ot改为mmz_allocator=cma
图 1 配置自动灌RAW参数
图 2 抓raw的帧数
从存储设备中读取文件灌RAW及YUV¶
需要将[Method]中的【Method】配置为3为灌RAW功能，开启功能；【Method】配置为4为灌YUV功能。
灌RAW时需要适配[Module]中【vipipe】，根据业务进行配置；灌YUV时需要适配[Module]中【vipipe】、【vichn】、【vpssgrp】、【vpsschn】等参数，根据业务进行配置。
适配[Auto_Load]模块：
【Loop】
当配置为1且【SrcRawPath】为文件名时，可以开启循环灌RAW的功能。
【StitchFlag】
0：PC单通路灌RAW或YUV；
1：灌拼接RAW或YUV；
2：PC多通路灌 RAW 或 YUV；
3：保留功能项；
4：保留功能项；
5：Board 灌 RAW 或 YUV.
【SrcPath】
当配置为RAW文件的路径名时，程序会读取该目录下所有的RAW或YUV文件并灌入(一次配置只支持灌一种文件，RAW或者YUV)；
当配置为路径+RAW或YUV文件名时，程序只会读取该文件并灌入。
【SaveType】
0：只进行灌入RAW或YUV，不抓取数据
1：灌入RAW或YUV，抓取并保存YUV数据
2：灌入RAW或YUV，抓取并保存为h264/h265码流
【DestImagePath】
生成YUV或码流的路径。
适配[Raw_Load]模块：
【RawSource】
0：灌RAW到FE；
1：灌RAW到 USER。
当配置为1时进行灌RAW，通路会循环处理同一帧RAW数据以保证帧率达标直到下一帧RAW数据灌入。由于读文件灌RAW的速度赶不上业务配置的帧率，通路上就会出现重复帧。所以不建议配置为1时，进行灌RAW存YUV和灌RAW存H264/H265码流。
【ReadyFrames】
该参数控制灌RAW的准备帧数，用于使ISP稳定。程序会取RAW文件的前15帧（若不足15帧，则取所有帧），先正序灌到第15帧（不足15帧的则灌到最后一帧）再倒序灌到第1帧，该步骤反复进行，直到灌入的帧数等于该参数配置的值。之后程序便可以从第一帧开始灌并抓YUV。
【WithIspInfo】
当配置为1时，程序会解析RAW文件的ISP Info信息并设置到ISP中。解析ISP Info有两种方式，
方式1：是通过文件名解析，该文件名必须符合这种格式：xxxx_xxxx_xxxx_1920x1080_12bits_RGGB_ag1024_dg1024_ispdg1024_exp2061_iso100_Ratio98_xxxx_xxxx.raw；
方式2：读取与RAW文件同路径下并且同名的txt文件，程序优先解析txt文件；
ISP Info的配置方法如下：程序会将Isp Info中的“Exposure_Time”、“A_Gain”、“D_Gain”、“ISP_D_Gain”这几个参数的值通过OT_MPI_ISP_SetExposureAttr生效；“Ratio_0”、“Ratio_1”、“Ratio_2” 这几个参数通过OT_MPI_ISP_SetWDRExposureAttr生效；“BlackLevel_R”，“BlackLevel_Gr”，“BlackLevel_Gb”，“BlackLevel_B”通过OT_MPI_ISP_SetBlackLevelAttr生效；“Bayer”则通过OT_MPI_ISP_SetPubAttr生效。并且会将对应Auto/Manual设置为Manual；
【NonCompact】
0：紧凑RAW；
1：非紧凑RAW。
【WaitFeIntCnt】
每帧RAW在灌之前都会先配置ISP Info然后等待WaitFeIntCnt个FE的中断以确保ISP Info生效于这帧RAW。
【WithBlackLevel】
当ISP Info采用方式1来解析时，BlackLevel由该参数来使能。当配置为1，则【BlackLevel_R】、【BlackLevel_Gr】、【BlackLevel_Gb】和【BlackLevel_B】的值将通过ss_mpi_isp_set_black_level_attr生效。
【BlackDataFrom】
0：BlackLevel参数值来自config.cfg配置中参数【BlackLevel_R】、【BlackLevel_Gr】、【BlackLevel_Gb】、【BlackLevel_B】；
1：BlackLevel参数值来自IspInfo文件。
【WdrLongfirst】
0：按RAW文件顺序读帧；
1：按RAW文件逆序读帧。
板端自动读文件灌RAW并没有帧数限制，业务流程上是读取一组灌入一组，所以灌RAW的速率受文件读取速率的限制。
当某个RAW文件灌入失败，则该文件将被跳过，程序会继续读取下一个文件。
灌RAW过程中可以通过连接PQTools，点击RAW Utilities页面的“Flush”来停止灌RAW。
适配[Yuv_Load]模块：
【YuvSource】
0：灌YUV到VI
1：灌YUV到VPSS
2：灌YUV到Stitch
3：灌YUV到VENC
【enPixelType】
0：灌planar420格式
1：灌semi-planar420格式
起业务后自动抓取码流数据¶
需要将[Method]中的Method配置为2：auto save to disk；
将Image 配置为2：Stream Image；
将Path 配置为想要保存抓取文件的路径。
配置[Stream_Image]：
Frames=xxx 为想要抓取的码流帧数。
设置想要抓取的venc通道 [Module] vencchn=0 （默认为0）
然后将对应的起业务ini配置文件中的 venc.x 通道属性Transfer 设置为 FALSE
非DIS码流场景，确认 bDisStream 参数配置为 0.
使用脚本启动业务或者重启业务，看到串口输出抓取结束即可到指定路径找到码流文件。
鱼眼标定工具¶
PQTools工具提供了鱼眼标定工具，可以根据鱼眼镜头抓拍的图像自动确定鱼眼镜头的位置特性（偏移、半径），使GDC模块能正确还原图像。该工具需要配合鱼眼镜头使用。
为了使工具能更准确的确定鱼眼轮廓，用户抓拍时需要尽量使鱼眼图像区域和黑边区域的边角清晰可辨。抓拍前请先设置最低ISO，降低噪声影响。
推荐抓拍步骤为：
首先用一般的白色纸巾（或者其他相似物品，如白色打印纸等）均匀覆盖鱼眼镜头；
然后设置较长曝光时间（可以通过降低帧率来增大曝光时间），使鱼眼图像基本曝光过度（可以适当提高AE的目标亮度Compensation），并且四周黑色区域不泛白；
最后调节镜头对焦至镜头光圈位置或者纸巾表面，使鱼眼图像边缘清晰，完成抓拍。
抓拍完毕后，打开PQTools工具，在插件下拉框中选择“PQ Fish Eye Calibration Tool”，即可打开鱼眼标定工具，如图1所示。
图 1 鱼眼标定工具界面
标定前，用户须根据实际需求，在界面左上角的下拉框中选择标定级别（Level 0~2）。标定级别越高（Level 2），算法对图像进行预处理的强度就越高，从而得到标定结果的稳定性就越高。用户可以使用两种方式导入用户标定的图像：
在线抓取：点击“Capture Image”可从板端抓取一张YUV图像。可通过右侧的下拉框选择图像来源（From VI/From VPSS/From VO）；（请按照上文推荐的方式进行抓拍）
选择本地文件：点击“Open Image File”，选择YUV图像导入。如果图像文件名符合抓拍工具的默认文件名格式，则工具自动解析其分辨率和格式信息，否则，用户需要在弹出的对话框中自行输入这些参数。
鱼眼标定工具仅支持8bit、420sp两种格式的YUV数据，请勿导入其他格式的YUV数据文件（例如P444，P400等，PQ Capture Tools抓出的sp420 YUV格式可以使用）。
鱼眼标定工具对于非鱼眼高亮抓拍的YUV数据也能进行标定，但结果没有意义。请用户自行保证输入鱼眼YUV的正确性。
文件输入完毕后，工具自动运行标定，并在上方的文本框中显示结果：
图 2 鱼眼标定工具输出参数结果
其中Center表示鱼眼中心在图像中的位置（以图像左上角为坐标原点，第一个数值为横坐标，第二个数值为纵坐标），Radius表示鱼眼的半径，Offset表示鱼眼圆心位置与图像中心的偏移值（第一个数值为水平方向偏移，第二个数值为垂直方向偏移）。
同时，下方的图像显示区域会显示打开的图像，并绘制一些辅助图元：
图 3 鱼眼标定工具输出参数结果
工具会显示以下几种辅助图元：
边缘圆周：工具会根据计算出的鱼眼圆心坐标和半径将鱼眼的圆周用红色线条绘制出来。
鱼眼中心点：工具标定时会将鱼眼中心以蓝色点标出。
图像中心点：工具标定时会将图像中心以紫色点标注，并以紫线与鱼眼中心点连线（在鱼眼偏移较大的场景下显示会较明显）。
标定完成后，若用户需要切换标定级别并重新标定，可采取以下操作：
抓拍标定的场合：切换级别后，重新点击“Capture Image”进行抓拍标定。
本地文件标定的场合：切换级别后，点击“Calibrate”按钮。
点击“Save Sample Image”按钮，可将画了辅助线的标定输出图像保存到本地。
点击“Save Mask Image”按钮，可获取AVSP矩阵转换用的遮罩图像。
点击“Apply To Board”按钮，可以将标定出的鱼眼参数设置到板端。需要注意的是，在单板上的VI和VPSS模块上各存在一套鱼眼参数，用户需要在设置参数到板端之前，使用工具右上角的下拉框选择参数的下发位置。
LMF转换工具使用说明¶
PQTools工具提供了LMF参数转换工具，使得用户可以将镜头厂商提供的镜头参数转换为LMF矩阵。从PQTools工具主界面的下拉框中选择“PQ LMF Converter”即可启动该工具，其界面如图1所示。
图 1 LMF转换工具界面
将镜头参数转换为LMF矩阵，请遵循以下步骤进行：
通过主界面TOP->Mode Handle设置VI Pipe（参考"读写通路设置"）；
输入由一系列浮点数组成的镜头角度数据（Lens Angle），输入数字间以逗号进行分隔，最大支持2000个浮点数组成的序列。点击“Import”按钮，可以直接导入文本文件中记录的数据。
输入由一系列浮点数组成的镜头映射表（Lens Mapping Table），输入数字间以逗号进行分隔，最大支持2000个浮点数组成的序列。点击“Import”按钮，可以直接导入文本文件中记录的数据。畸变数据中包含的浮点数个数必须与角度数据中浮点数的个数相同。
输入视野值（Lens Fov），取值范围为[90, 360 )；
输入表项类型。表项类型分两种，1）Distortion；2）LensMappingCurve。缺省值是Distortion。若Lens Mapping Table是镜头模型与理想Equidistance模型之间的差异，则在此处选择Distortion模式。若Lens Mapping Table是镜头映射曲线，即镜头入射角与真实像高的对应关系，则在此处选择LensMappingCurve模式。
点击“Convert”按钮，执行转换。转换结束后，工具会生成一个由128个整数组成的LMF矩阵序列，并显示在右侧的文本框中。
点击“Export Result”，以明文方式保存转换后的数据。
点击“Apply to Board”，将转换后的数据下发板端。
镜头提供的表项： LensAngle = {0.1,0.2,0.3,0.4, ... }, Lens Mapping Table= {0.002,0.0041,0.0061,0.0082, ... }
配置给工具的表项如下: LensAngle = {0, 0.1,0.2,0.3,0.4, ... }, Lens Mapping Table= {0, 0.002,0.0041,0.0061,0.0082, ... } 升级后的LMF转换工具，理论上通过像高LensMappingCurve转换LMF矩阵的方法对各种镜头都是通用的，但实际我们只验证过等距离投影和立体投影模型的鱼眼镜头是支持的，其他复杂的镜头或者投影模型没有验证过，并不能保证一定支持LMF转换。如遇到不支持的可根据实际情况另提需求。
辅助对焦工具使用说明¶
PQTools工具提供了辅助对焦工具，可以辅助用户在手动调焦的时候使焦距更快的达到最佳状态。从PQTools工具主界面的下拉框中选择“PQ Focus Assistant”即可启动该工具，辅助对焦工具的界面如图1所示。
图 1 辅助对焦工具界面
工具界面主要分三大部分：
(1) 操作区：进行各种工具操作
(2) 图像和区间显示区：显示抓拍到的图像，区间分布和各个区间的FV值（其中黄色值为区间当前的FV值，蓝色的值为区间历史FV最大值）
(3) FV变化曲线：显示全局FV值的变化曲线。其中横坐标为1的点为最近取到的FV值所表示的点。每次FV值刷新时，之前取到的值会右移。
利用辅助对焦工具进行调焦¶
使用辅助对焦工具调焦的步骤如下：
将镜头焦距调整为最模糊状态。
通过主界面TOP->Mode Handle选择VPSS的YUV通道（参考"读写通路设置"）。
确定当前设备的AF区间配置状态：勾选Grab AF Statistics，并在图像显示区的区间数量变化时取消勾选。
选择FV组别：在FV Set下拉框下选择FV1组（对应低频，峰值较缓达到）和FV2组（对应高频，峰值较快达到）。
在图像和区间显示区域点击确定调焦时需要关注哪些区间。其中关注的区间左上角会显示一个绿色圆点。可以点击工具左侧的Select All Zones选定所有区间，Deselect All Zones取消所有区间选定，方便操作。
再次勾选Grab AF Statistics。此时图像显示区和下方的曲线图开始不断刷新。
调整镜头焦距。此时FV值曲线最大值红线稳步升高。
当发现FV值曲线上位置1的点开始出现平稳下降时，最大值红线的位置应该不再变化（可视为红线FV为理论最优对焦FV）。此时反方向调焦至位置1上的点无限接近红线位置即可。
对焦辅助操作¶
如果用户在调焦过程中，需要确定点播图像上的区域属于哪个区间，可以点击Capture Image来抓拍一帧图像。图像显示在图像区域后，即可进行确认。
工具上Grab AF Statistics勾选后，工具将以一个固定的时间间隔从板端获取AF统计信息。用户可以修改Interval值来改变这个间隔。改变范围为50~1000毫秒。
如果用户不需要查看分区间FV值的当前值和峰值，可以将左侧的Show Zone FV复选框取消勾选。取消勾选后再次勾选，区间FV值会再次显示。
如果用户改变了区间配置，此时的理论FV最大值会发生变化。建议用户此时点击“Reset FV Chart”按钮。点击后，右下方图表中的历史全局FV值将被清空，最大FV值的红线也将归零。
导入AF配置文件¶
通过修改AF的配置，可以使设备的AF模块更好地适应运行环境，并进行更有效的对焦。除了直接调整PQTools工具主界面StatisticsConfig页面下的AF参数，从辅助对焦工具中亦可直接导入ini配置文件，实现对AF参数的导入。
步骤如下：
在PQTools工具目录下找到FOCUS.ini文件，将其复制到任意可写目录，并打开进行修改（修改为对应场景的参数）
在辅助对焦工具上点击Import AF Config按钮，选择刚刚修改的配置文件
PQ Stitching Tool使用说明¶
PQTools工具针对芯片的多路拼接功能提供了一系列工具，用以满足不同场景下的拼接需求。目前主要包含了：
多路拼接参数标定功能（Stitch Calibration）：本工具主要用来根据用户所抓拍到的多路标定图，计算得到芯片所需的拼接标定参数。详细内容请参考"多路拼接标定功能（Stitch Calibration）"中所述内容；
查找表转换功能（Stitch Conversion）：本工具主要用于将PTGui或者Hugin等第三方标定结果转换为所需的查找表。详细内容请参考"查找表转换功能（Stitch Conversion）"中所述内容；
拼接颜色差异标定功能（Stitch Color Correction）：本工具主要用于针对多路拼接时的Sensor个体间成像存在亮度、颜色差异的标定。详细内容请参考"拼接颜色差异标定功能（Stitch Color Correction）"中所述内容；
PNG Mask文件转换功能（Stitch Mask Converter）：本工具主要用于将PNG格式的Mask文件转换为YUV格式的Mask文件并保存。详细内容请参考"PNG Mask文件转换功能（Stitch Mask Converter）"中所述内容。
多路离线拼接功能（Stitch Preview）：本工具主要用来进行多路拼接时输入参数的拼接结果预览。详细内容请参考"多路离线拼接功能（Stitch Preview）"中所述内容。
多路自动精调功能（Stitch Auto Fine Tuning）：本工具提供了多路自动精调功能。详细内容请参考"多路自动精调功能"中所述内容。
图 1 PQTools Stitching Tool界面示意
多路拼接标定功能（Stitch Calibration）¶
Stitch Calibration工具在PQ Stitching Tool中。该工具提供了多路拼接标定功能，可以根据用户所抓拍的多路标定图计算得到拼接标定参数。目前仅支持.jpg格式的图像。工具界面如图1所示。
图 1 AVSP标定功能界面（已完成配置）
在使用标定工具之前，用户需要进行图像抓拍。拼接标定要求，抓拍可分为两种类型：
标定单镜头的畸变矫正的图片，可将棋盘格放置镜头前方，并不断变换棋盘格方向及位置，每个镜头至少抓取10张图像。保存时以<固定前缀名><镜头号>_<帧序号>.jpg来对图像进行命名。
标定相邻镜头相对位置的图片。此时需先确定相邻镜头，每组相邻镜头同时拍取标定图片，抓拍时将棋盘格放置于重叠区内，相邻镜头都要看到完整的棋盘格，不断变换棋盘格在重叠区的位置或距离或小幅度旋转，每个重叠区至少抓拍10对（即20张）图片。保存时以<固定前缀名><镜头号>_<较小镜头号><较大镜头号>_<帧序号>.jpg来对图像进行命名。
具体抓拍要求及注意事项可参考《拼接 FAQ》第2章“模型标定方法”。
图像抓拍完毕后，按以下的流程使用标定工具进行标定：
点击“Browse”按钮，并选择抓拍图像的保存路径；
在“Route Count”下拉框选择通路数量。这个数量必须和抓拍图像的环境所启用的通路数量一致；
设置每个通路的分辨率、镜头Fov值、Lens Type镜头类型与文件名前缀。如果所有通路采用一样的设置，可以勾选Use the same option复选框，这样每改变一个通路的设置时其他通路也会同步设置为相同值；
在Chess Board字样右侧设置棋盘格的X方向角点数量（Count X），Y方向的角点数量（Count Y）及单个格子的物理边长（Size）；
点击“Calibrate”开始标定；
点击“Export Cal”导出标定生成的拼接标定参数（格式为.cal）。
标定过程中，标定工具所在目录下的tmp文件夹中将输出棋盘格检测结果图像，可用于判断所拍摄的棋盘格标定图是否能够准确的检测出棋盘格角点。如图2(a)中有彩色的角点示意，表示该标定图中的棋盘格角点检测成功，即该标定图有效，将参与标定计算；图2(b)中由于棋盘格反光较为严重，导致棋盘格角点检测失败，则没有彩色的角点示意，故该标定图无效，不参与标定计算。
图 2 棋盘格检测结果示意图
标定成功时，工具会弹出一个保存文件对话框，使用户可以保存所生成的拼接标定参数（格式为.cal）。这份拼接参数为未经处理的原始参数，用户还需要运行查找表转换功能将参数转换为二进制查找表后才能将其应用于设备。用户可以点击“>>”字样的按钮直接将标定结果输入到转换工具界面，之后请参照"查找表转换功能（Stitch Conversion）"章节进行查找表转换操作。
标定完成后，界面底部将输出标定误差，用于评估标定效果，分别为：
Maximum Re-projection Error：指最大标定误差，可以判断标定过程中是否有棋盘格内角点匹配错误情况，若该值大于20则需要评估标定图中是否出现多个棋盘格，或者命名错误；
Average Re-projection Error：指平均误差，若该值小于3，则标定效果是比较满意的；
Total Matched Point：指匹配成功的角点对，与图像数量及棋盘格内角点数相关。
Total Distance Ratio：指所有图片中的棋盘格距离覆盖率，即抓拍标定图时，棋盘格所覆盖的范围。当棋盘格的距离覆盖率越大时，拼接效果越好，如按照标定图像抓拍要求进行，该值一般大于1.0。
Minimum Distance Ratio：指多组内参或者外参标定图对应的棋盘格距离覆盖率最小值。
查找表转换功能（Stitch Conversion）¶
Stitch Conversion提供了查找表转换功能，可以将PTGuiPro或者Hugin工具生成的多路拼接标定参数转换为AVSP查找表，工具界面如图1所示。
图 1 AVSP查找表转换界面（已导入数据）
进行数据转换的步骤为：
点击“Open Data File”按钮，并选择一个标定参数文件。工具支持自研算法生成的参数文件（.cal）或PTGui Pro/Hugin工具生成的参数文件（.pto或.pts）。选择文件后，工具会将该参数文件内包含的通路信息显示在下面表格中。
为每个通路选择一张黑白模板图。在表格中每个通路行的Mask Image找到浏览按钮（文本显示为省略号），点击以选择图片。用户也可以在Mask Image中直接输入遮罩图的路径。
在Accuracy处设置查找表精度（HIGH或LOW）。
设置最佳拼接距离（Sphere Distance）。
点击“Convert”转换按钮。
标定结束后，工具将对每个通路生成两个二进制文件，其中文件名中标注mesh的文件为拼接坐标查找表数据文件，而标注poly的文件为拼接有效区域边界坐标的数据文件。点击“Apply to Device”按钮，可以直接将生成的查找表发送到设备上并即时生效。
拼接颜色差异标定功能（Stitch Color Correction）¶
Stitch Color Correction 提供了颜色差异标定功能。由于物理器件及模组公差上的区别，Sensor个体间成像存在亮度、颜色差异，拼接颜色差异标定工具支持对其中两个sensor所采集的Raw数据进行亮度、颜色差异标定。标定完成后，用户将参数配置到板端，可提升不同sensor成像的亮度、颜色一致性。
点击“Stitch Color Correction”页签即可打开拼接颜色校正页面。如图1所示。
图 1 拼接颜色校正页面
用户可以在该页面内完成两个Sensor通路的亮度差异（拟合曲线）标定和CCM差异标定。标定步骤如下：
采集设备准备：标准X-Rite 24色卡、照度为600Lux、色温为5000K上下的均匀光源（左右两侧双光源，光源与色卡平面的夹角在25°- 45°）。调整AE目标，保证最亮灰阶(Block 19)的G分量亮度在饱和值的0.8倍左右。RAW数据抓图过程中需要保证不同sensor采集时的曝光量相同（曝光时间、模拟增益、sensor数字增益完全相同）。
点击“Load Left Image”，并选择对应基准sensor所抓拍的RAW图像，选取24色区域；
点击“Load Right Image”，并选择对应矫正sensor所抓拍的RAW图像，选取24色区域；还可以进行色卡选框，选框调节默认为“Coarse”模式，可统一调节所有选框的大小和位置。Coarse复选框未勾选时为“Fine”模式，此模式下可独立调节单个选框的大小和位置，也可多个选框一起调节大小。需要进行亮度差异（拟合曲线）标定时，请勾选“Fitline Calibration”；
继续进行CCM标定时，请勾选“CCM Calibration”；用户仅需要进行CCM标定时，标定工具默认左右两侧sensor不存在亮度差异，会自动Bypass亮度差异标定。
点击“Calibrate”按钮，执行标定。
标定后，工具将依据用户选择的标定项来显示标定结果，如图2所示。
若用户标定了亮度拟合曲线，则工具会在拟合曲线参数表中显示拟合参数；
若用户标定了CCM，则工具会显示浮点形式的CCM矩阵表格和16进制模式下的CCM矩阵表格。
图 2 拼接颜色校正页面
在Apply Pipe右侧的下拉框选定当前右侧sensor（即矫正sensor）对应的通道号，并点击“Apply to Board”按钮，可以将标定出来的亮度差异拟合参数及CCM矩阵发送到板端，并使其立即生效。
工具使用的标定算法目前是以左侧sensor为基准，右侧sensor为标定目标来编写的，因此在选择下发板端的sensor通道号时，请务必选择右侧sensor的通道号，否则将造成颜色校正不正确。
颜色差异标定时，需保证色卡的正确方向，正常是以6x4分布，且白色格子处于左下角。若RAW图像有旋转或者翻转，则需移动红色24色卡选框，使之匹配。
PNG Mask文件转换功能（Stitch Mask Converter）¶
Stitch Mask Converter工具提供了Mask文件转换功能，可以将Png Mask文件转换成Yuv Mask文件并保存。该Yuv Mask模板可应用于板端LUT生成工具，简化板端LUT生成过程中的内部计算，以最高效率完成LUT文件的生成。工具界面如图1所示。
图 1 Mask文件转换界面
进行数据转换的步骤为：
点击“Import File”按钮导入Png格式的Mask文件，最大支持导入8个。
点击“Browse”按钮选择导出Yuv文件的路径。
点击“Convert”按钮进行转换。
转换成功后，列表中当前所选择的项对应的Yuv图像显示在右侧图像控件中。
点击鼠标左键在列表中选择不同的文件，图像区域显示的图像随之切换。
可以在列表点击删除按钮删除已导入的文件，再导入新文件进行转换。
多路离线拼接功能（Stitch Preview）¶
Stitch Preview工具提供了多路图像离线拼接功能，可以将最多6张图像拼接，并支持拼接输出图像预览。可以不依赖单板进行拼接，不受限于单板特定分辨率，方便查看效果。该工具仅作为标定后拼接效果的预览与参考之用，实际效果请到板端上确认，Stitch Preview在拼缝处的效果可能会与板端有一点差异。
图 1 多路离线拼接界面
进行多路离线拼接的步骤为：
如果界面左侧的参数默认值不符合用户拼接场景，首先进行调整。SrcWidth、SrcHeight、ImageType不需要设置，以Image 0显示位置的图像数据进行自动刷新。
点击“Load Images”按钮选择多张图像导入。
点击“Load LUTs”按钮选择多个LUT文件导入。
如果需要导入单张图像，点击“<Load Image>”下拉框选择单张图像导入。
如果需要导入单个LUT文件，点击“<Load LUT>”下拉框选择单个LUT文件导入。
点击“Stitch”按钮进行拼接。
如果需要保存输出图像，拼接完成后点击“Save”按钮选择保存文件路径进行保存。
多路自动精调功能¶
Stitch Auto Fine Tuning 工具提供了多路自动精调功能。支持在线抓取图片和本地导入图片进行精调，精调结果可下发板端，方便测试、用户现场调试和演示。
图 1 多路精调界面
进行多路精调的步骤如下：
设置参数。如果参数的默认值不符合用户的场景，设置Parameter Section 1和Parameter Section 2的参数。用户可以点击“Read Parameters”按钮或者编辑修改，其中“Stitch Distance”、“MaxOffset”、“Scale Ratio”和Parameter Section 2的参数不支持从板端获取。
加载图像。有两种方式加载图像，设置Source Seq（参考抓拍工具使用说明），点击“Capture Images Online”按钮从板端获取图像；点击“Load Images Offline ”按钮从本地加载图像。图像加载完后会在tmp目录下生成临时图像。
导入标定文件。点击“Open Calib Data File”按钮，导入拼接标定文件，显示拼接文件路径 (标定文件所需求的拼接源数目和实际加载或者抓取的图片路数必须一致)。
调整图像顺序和图像的旋转角度。如果图像显示顺序不是从左到右按空间方位显示，可以编辑Camera Order控件，调整图片的位置。如果图片显示角度不对，可以编辑Camera Rotate调整图像角度。
启动自动精调。点击“Auto Fine Tuning”按钮，进行自动精调。
下发LUT表到板端。点击“Apply to Device”按钮，下发精调生成的LUT表到板端。
OSD转换工具使用说明¶
若客户需要在等距柱面投影(Equirectangular)全景图底部或顶部加入特定Logo，遮挡全景摄像机支架，可使用OSD转换工具将圆形Logo图片转换为全景细长型的Logo图片。一般情况下，全景Logo图片的宽度与全景拼接图的宽度相同，全景Logo图片的高度则决定了Logo在全景画面中的遮挡范围，可根据实际情况配置。
在PQTools工具主界面的插件下拉框中找到“PQ OSD Converter”并点击，即可打开OSD转换工具。其界面如图1所示。
图 1 OSD转换工具界面（已打开输入图像）
转换步骤如下：
点击“Browse”按钮并选择一个Bmp/Jpg格式的图像。选择图像后，工具将在Input页签中显示选中的图像，用户可以改变输出图形的宽高，范围为100~8192。
点击“Convert”按钮进行转换。
成功转换的情况下，工具会在 Output页签显示转换后的图像，如图2所示。用户可以点击“Save Result”将输出图像导出到本地磁盘进行保存。
图 2 OSD转换输出
输入的是圆形logo，故输入图片的宽高必须相等（正方形图片），否则无法读入。输出图像的显示有拉伸，以最终保存图像为准。
仅SS928V100解决方案支持此功能。
DIS标定工具使用说明¶
DIS标定基本原理¶
在DIS（数字视频防抖）应用中，使用陀螺仪感应器，配合localDIS对图像进行精细稳像校准，由于镜头畸变的存在，为确定空间物体表面某点的三维几何位置与其在图像中对应点之间的相互关系，必须建立摄像机成像的几何模型，这些几何模型参数就是摄像机参数。在大多数条件下这些参数必须通过实验与计算才能得到，这个求解参数的过程就称之为摄像机标定。
在应用中，摄像机参数的标定是非常关键的环节，其标定结果的精度及算法的稳定性直接影响防抖效果结果的准确性。因此，做好摄像机标定是做好后续工作的前提，是提升防抖效果的重点所在。其标定的目的是为了获取摄像机内参、外参、畸变参数。将摄像机参数的标定过程集成在DIS镜头标定中。
DIS镜头标定提供模型及产线标定，并提供算法参数下发板端接口，标定结果可以直接应用在板端生效，提升评估、开发的效率。
DIS标定序列采集要求¶
标定环境应该光照充足且尽量均匀，否则较大的噪声可能会对标定算法的检测造成影响；
棋盘格图卡不能有明显反光/阴影 等导致亮暗不均的地方；否则需要调整摄像机、图卡和光源的相对位置；
棋盘格图卡不能过小，一般来说图卡中的每个方格应不低于10个像素；如果棋盘格在画面中占据的像素太少，可以考虑将棋盘格图卡靠近摄像机或者更换更大尺寸的图卡（必要时减少棋盘格格子的数量，最少的棋盘格角点数目是4*3）；
画面中不能出现多个不同规格的棋盘格或者类似棋盘格式样的道具；如果出现该现象，请提前将该道具移走或者遮挡住，也可以手工在图片编辑工具中将该部分涂掉；但若是相同规格（棋盘格大小和角点数目相同）的棋盘格且不重叠是允许的，并且可以提升效率；
每个棋盘格图卡在画面中必须完整，否则无法检测；
不同标定图片中所有的棋盘格叠加起来要覆盖整个有效画面，并且重点覆盖四个角落；
棋盘格需要覆盖至少3种不同的距离，并且这个距离最好是包含最常使用的一个距离；
棋盘格需要覆盖不同的角度；
每张抓拍图片中的棋盘格必须要清晰，不能有模糊现象；如果不够清晰，请先确认对焦清晰且景深较好；
图卡应该满足一定程度的覆盖，该覆盖应该包括实际标定的距离、图像有效区域、不同的角度等，同一位置的多张相同图片没有意义。
表 1 建议的镜头模型标定方法（以广角镜头的产品为例、其它视场角的距离参考调整）
步骤 |
目标 |
标定方式 |
数量 |
图片编号 |
参考距离 |
备注 |
|---|---|---|---|---|---|---|
1 |
近距离大画面覆盖 |
保证棋盘格居中正放，最大程度覆盖最多的画面；要注意若棋盘格畸变过于明显或棋盘格显示不完整，请增大图卡和摄像机的距离。 |
2 |
1-2 |
0.5m |
- |
2 |
中距离多角度覆盖 |
保证棋盘格在画面中，每次将图卡旋转约30°，确保每个棋盘格在画面中完整。 |
4 |
3-6 |
0.6m |
- |
3 |
中距离画面全覆盖 |
覆盖全屏(4角+4边)：每张图卡占据画面约1/4，紧贴4角抓取4张图片，并靠近4边图卡以边为轴倾斜30°抓取4张。 |
8 |
7-14 |
0.6m |
- |
4 |
远距离四角覆盖 |
增大图卡和摄像机的距离一倍，让图卡紧贴镜头四个角落（尽可能靠近，并保持完整），每个角落至少抓取2张（抓取时均需重新调整位置）。 |
8 |
15-22 |
1.0m |
- |
5 |
不同距离覆盖 |
图卡在图像的不同距离和位置，并每次变换一次角度抓取若干图片，距离和位置根据前面步骤中覆盖不充分的地方进行适当增补。 |
8 |
23-30 |
- |
- |
参考以上步骤，共计需要抓取符合采集要求的图片约30张（如图1所示），实际可根据抓取图片的质量可以适当增补图片，但不宜过多。
图 1 建议的镜头模型标定方法抓取的标定图片示例
DIS标定工具界面介绍¶
图片采集好后，打开DIS标定工具界面，即可看到DIS标定界面由模型标定“Design Calibration”和 产线标定“Product Calibration”、Ldcv3标定“Ldcv3 Calibration”三个子页面组成；如图1所示。
需要配置棋盘格角点的数目CbDimWidth和CbDimHeight，注意不是棋盘格方格的数目，一般来说角点的数目是对应方格数目-1，当棋盘格数目配置错误时，可能出现标定失败或结果异常；
DistCoeffType是畸变系数的个数，一般默认为3个，当输出畸变参数超出芯片支持的范围时，按照3->2->1->0 的顺序逐个尝试减少数量；
DistRatio是相对输入源图像畸变的比例，默认配置为1，即不做畸变校正，畸变保持和源图像一致；配置为0时，畸变最小；DistRatio在参数转换（Convert Calibration Data）时起作用，转换的系数下发板端（Apply To Board）时只有在GYRO DIS 开启且LDCV2 disable后生效；SS928V100中 DistRatio配置无效。
图 1 DIS标定模型标定页面
对于DIS标定页面中的模型标定来说：
标定参数预设区域(红色区域)：用于进行标定所需的参数设置。
Load Image：点击导入DIS标定图片的所在文件夹目录；
Up/Down：点击切换目录中图片的显示；
CbDimWidth/CbDimHeight：导入棋盘格的宽高，取值范围[3，1024]；
DistCoeffType：下拉框畸变类型有四种模式。
DistRatio：输入畸变百分比，取值范围为[0,1]；
0，输出图像无畸变（视场角损失较大）；
1=100%，输出图像畸变程度和输入源一致（但视场角损失最小）。
图片显示区域(蓝色区域)：用于显示图片文件夹里的jpg棋盘格图，默认显示第一张；
结果显示区域(绿色区域)：用于显示标定完成后生成的标定结果参数(Calibration Results)和度量参数(Measurement Results)。
点击“Move”可把模型标定结果导入产线标定，作为产线标定的输入参数。
图 2 DIS标定产线标定页面
对于DIS标定页面中的产线标定来说：
标定参数预设区域(红色区域)：用于进行标定所需的参数设置；
Load Image：点击导入DIS产线标定jpg图片；
CbDimWidth/CbDimHeight：导入棋盘格的宽高，取值范围[3，1024]；
DistCoeffType下拉框畸变类型有四种模式。
DistRatio：输入畸变百分比，取值范围为[0, 1]。
0, 输出图像无畸变（视场角损失较大）；
1=100%，输出图像畸变程度和输入源一致（但视场角损失最小）。
DistRatio参数需要在 LDCV2 ATTR 配置为 disable时才能生效。
FocalLengthX、FocalLengthY表示焦距，取值范围[64, 23420]
PrincipalPtX、PrincipalPtY表示光心[0，8192]，但具体生效范围：PrincipalPtX，[W*0.35, W*0.65]；PrincipalPtY，[H*0.35, H*0.65](W、H表示输入图片宽高)。DistCoeff0~2表示畸变系数。
图片显示区域(蓝色区域)：用于显示图片文件夹里的jpg棋盘格图，默认显示第一张；
结果显示区域(绿色区域)：用于显示标定完成后生成的标定结果参数(Calibration Results)和度量参数(Measurement Results)。与DIS模型标定一致。
DIS标定步骤¶
标定工具支持DIS的模型标定和产线标定，并且模型标定和产线标定步骤相同：
点击“Load Image”，模型标定中导入一个含有.jpg图片的文件夹目录，产线标定中导入一张标准的.jpg图片，显示在图片显示区域，可点击“Up” “Down”按钮切换图片显示。
进行参数设置，在界面输入合理的参数，产线标定可通过模型标定Move过来的参数作为参数值，也可手动输入。
点击“Calibrate”进行标定。
点击“Convert Calibration Data”可以把标定结果参数转换成下发板端需要的参数，不进行Convert 就无法进行下发板端。
模型标定可在标定后生成标定结果参数，通过点击“Move”按钮传到产线标定作为输入参数值。
可点击“Export Calibration Data”对转换后的参数进行导出到txt文件。
点击“Apply To Board”按钮下发板端。
模型、产线标定下发板端前需将VI LDC页面的VI LDC Base项中的LDC base.ldc_version设置成LDC_V2并下发板端，下发成功后数据更新至VI LDC页面的VI LDC V2项。
Ldcv3标定下发板端前需将VI LDC页面的VI LDC Base项中的LDC base.ldc_version设置成LDC_V3并下发板端，下发成功后数据更新至VI LDC页面的VI LDC V3项。
DIS标定结果说明¶
图 1 DIS标定结果
进行模型标定和产线标定后，都会生成如图1所示的标定结果。
标定结果参数：FocalLengthX、FocalLengthY表示焦距，PrincipalPtX、PrincipalPtY表示光心，DistCoeff0~2表示畸变系数，ImageWidth、ImageHeight表示导入图片的像素宽高。如果畸变系数不符合表1所示的畸变系数范围，按下"Convert Calibration Data”按钮会弹出报错框"Unsupported dist coeffs”。此时需要检查标定图片是否满足DIS标定序列采集要求。
表 1 镜头标定算法内参
参数名称 |
CAMERA_CALIB_SS928 |
备注 |
|---|---|---|
FocalLengthX |
[64,1173417] |
- |
FocalLengthY |
[64,1173417] |
- |
PrincipalPtX |
[W*0.35,W*0.65] |
W为图像宽度 |
PrincipalPtY |
[H*0.35,H*0.65] |
H为图像高度 |
DistCoeff0 |
[-0.7,1] |
- |
DistCoeff1 |
[-0.5,0.5] |
- |
DistCoeff2 |
[-0.1,0.1] |
- |
ImageWidth |
[1280,8192] |
- |
ImageHeight |
[720,8192] |
- |
度量参数：MaxReprojError表示最大标定误差，AvrReprojError表示平均误差，TotalMatchPts表示成功匹配的角对点。
表 2 镜头标定误差评估
参数名称 |
描述 |
|---|---|
dMaxReprojErr |
最大标定反投影误差(以像素为单位)，用于判断标定过程中是否有棋盘格内角点的最差匹配情况，值越小，表示标定效果越好；<=20。 |
dAvrReprojErr |
这是平均反投影错误 (以像素为单位)，用于判断标定过程中是否有棋盘格内角点的平均匹配情况，值越小，表示标定效果越好；<=4。 |
u32TotalMatchedPoints |
指成功的检测出来的角点总数目，与图像数量及棋盘格内角点数相关。 |
标定结果可通过下发板端按钮将结果发送到板端，发送的数据立即生效。
此外得到标定结果的同时，工具有时还会返回当前标定过程中相应的Warning提示，如图2所示的例子。
图 2 DIS标定结果提示举例
常见Warning解释：
"Warning: chessboards not fully found in image: 图片路径"，表示该图片的棋盘格没有找全，没有加入当前标定结果的计算。
"Warning: The large chessboards do not occupy the entire image: xxx"，表示标定图片中近距离大画面覆盖的图片四周的覆盖情况，目前这个结果仅作为参考值，还不能直接来判断标定的准确性。
"Warning: Missing image containing large chessboard(chessboardW/imgW > 60 % or chessboardH/imgH > 60 %)"，表示在标定图片中没有找到近距离大画面覆盖的图片，这个情况得考虑补充相应的图片。
LDCV3镜头标定工具界面介绍¶
通过仪器测量出待矫正镜头的物体角度（Object Angle）与图像高度（Image Height）关系表，将图像高度以毫米（mm）为单位，作为一列放在txt文件中，物体角度以度（°）为单位，作为第二列放在txt文件中，用逗号隔开。数据格式如下所示：
3.95386,-65.00008,
3.40029,-62.40004,
最少需要包含4组测量数据，测量结果准备好后，打开Ldcv3标定工具界面，导入txt文件；如Figure 1所示。
需要配置使用的sensor的像素大小（PixelSize），例如2.9000。图像的宽度（Image Width），图像的高度（Image Height）。
图 1 LDCV3镜头标定页面
对于LDCV3镜头标定页面来说：
结果显示区域：用于显示标定完成后生成的标定结果参数(Calibration Result)；
FocalLenX、FocalLenY表示焦距，取值范围[64, 23420]
CoorShiftX、CoorShiftY表示光心[0，8192]，但具体生效范围：CoorShiftX，[W*0.35, W*0.65]；CoorShiftY，[H*0.35, H*0.65](W、H表示输入图片宽高)。
CaliRatio0~3表示畸变系数。
Sensor和镜头装配时要尽量保证sensor中心和镜头光心对齐，没有偏差。如果光心偏差会导致LDCV3矫正效果变差。有条件的情况下，可以拍摄多组棋盘格图片，在DIS标定界面使用模型标定“Design Calibration”，得到PrincipalPtX和PrincipalPtY标定结果，将该值替换CoorShiftX、CoorShiftY值。以获得更好的矫正效果。
镜头测试数据中的视场角范围需要尽量大，能覆盖sensor的视场角要求。镜头测量数据的角度间隔需要尽量小，比如间隔一度测量一次。这样的镜头数据才能让LDCV3的矫正效果更好。
PixelSize，分辨率值，镜头测量数据，这几个数据需要都填正确，生成的LDCV3参数才能写入板端接口。如果PixelSize不正确，或者镜头测量数据不准确，都有可能导致生成的LDCV3参数报错。这时需要重新检查PixelSize，分辨率值，或者重新测量镜头数据。
须知：模型、产线标定下发板端前需将VI LDC页面的VI LDC Base项中的LDC base.ldc_version设置成LDC_V2并下发板端，下发成功后数据更新至VI LDC页面的VI LDC V2项。
Ldcv3标定下发板端前需将VI LDC页面的VI LDC Base项中的LDC base.ldc_version设置成LDC_V3并下发板端，下发成功后数据更新至VI LDC页面的VI LDC V3项。
Dis Debug陀螺仪工具使用说明¶
使用要求¶
需要sensor支持DIS功能。启动板端业务前需要加载陀螺仪相关ko，启动业务的ini文件中需要有[motionfusion]相关配置。
界面介绍¶
图 1 陀螺仪界面
使用步骤¶
打开工具后设置RefreshTime后，点击Start按钮开始获取。
需要停止时点击Stop按钮。
获取到数据后，在统计图上左键框选可以放大该区域图像，右键点击可以缩小。
结果说明¶
图 1 显示陀螺仪获取的数据
结果分为两部分，左半部分为gyro data，右半部分为acc data。以左半部分为例，图中有x、y、z、pts四种数据，横坐标为数据顺序数，用颜色来区分在图中是哪些点，其中pts为pts的间隔（由于pts的单位是微秒，间隔值较大，为了放入一幅图中，已将其除以100），表中average为平均值，standard deviation为标准差，cumulative average为累计均值，cumulative number为累计数据条数。右上角Temperature为温度。
工具参数联动使用说明¶
参数联动规则¶
当有约束的参数被用户修改时，满足联动条件约束的一个或多个参数值会被自动修改为最接近的有效值，并下发数据到板端。
参数联动列表¶
目前已支持的参数列表和限制条件，如表1所示。
表 1 参数联动列表
联动参数所属功能模块 |
联动参数 |
联动规则 |
||
|---|---|---|---|---|
AE Route |
AE Route. TotalNum |
要小于等于RouteNode的节点个数 |
||
AE RouteEx. TotalNum |
要小于等于RouteExNode的节点个数 |
|||
WBAttr |
AWBAttr |
stCTLimit.HighRgLimit |
手动模式下用户设定高色温下的最大R增益，8bit小数精度，取值范围：[0x0, 0xFFF] |
|
stCTLimit.HighBgLimit |
手动模式下用户设定高色温下的最小B增益，8bit小数精度，取值范围：[0x0, 0xFFF] |
|||
stCTLimit.LowRgLimit |
手动模式下用户设定低色温下的最小R增益，8bit小数精度，取值范围：[0x0, u16HighRgLimit) |
|||
stCTLimit.LowBgLimit |
手动模式下用户设定低色温下的最大B增益，8bit小数精度，取值范围：(u16HighBgLimit, 0xFFF] |
|||
AWBAttrEx |
stInOrOut.LowStart |
将位于低色温范围内的像素权重调低，低色温区起始值，建议5000K |
||
stInOrOut.LowStop |
将位于低色温范围内的像素权重调低，低色温区终止值，建议4500K。 取值范围：(0, u16LowStart) |
|||
stInOrOut.HighStart |
将位于高色温范围内的像素权重调低，高色温区起始值，建议6500K。 取值范围：(u16LowStart, 0xFFFF] |
|||
stInOrOut.HighStop |
将位于高色温范围内的像素权重调低，高色温区终止值，建议8000K。 取值范围：(u16HighStart, 0xFFFF] |
|||
Shading Lut Attr |
XGridWidth |
取值范围：[4, 255] |
||
YGridWidth |
||||
DefectPixel |
DP Static Calibrate. CountMax |
图像分辨率小于等于4K时，STATIC_DP_COUNT_MAX = 4096 图像分辨率大于4K时，STATIC_DP_COUNT_MAX = 8192 |
||
RadialCROP |
RadialCROP |
stCenterCoor.X |
取值范围：[0,u32Width -1]，默认为：u32Width/2 |
|
stCenterCoor.Y |
取值范围：[0,u32Height -1]，默认为：u32Height/2 |
|||
FPN |
FPNCalibrate |
FrameNum |
标定的帧数，取值范围为{1，2，4，8，16}，即为2的整数次幂，FPN不支持在离线模式下进行标定，向下剪切。 |
|
Fisheye |
FisheyeAttr |
MountMode |
360校正模式下不支持壁装，MountMode切换为地装 |
|
ViewMode |
180校正模式下不支持顶装和地装，MountMode切换为壁装 |
|||
VencEx |
ROI Attributes |
Qp |
当QP模式为FALSE时，s32Qp为QP偏移，s32Qp范围[-51,51]； 当QP模式为TRUE时，s32Qp为宏块QP值，s32Qp范围[0,51] |
|
stRect.X/Y/Width/Height |
s32X、s32Y、u32Width、u32Height必须是16对齐，向下剪切 |
|||
FSWDR |
FSWDR |
LongThr |
取值范围：[0, u16ShortThr] |
|
ForceLongLowThr |
取值范围：[0, ForceLongHigThr] |
|||
u8MdThrLowGain |
取值范围：[0, u8MdThrHigGain] |
|||
DRC |
Common Params |
Auto.StrengthMin |
取值范围：[0,StrengthMax] |
|
3DNR X |
VI_3DNRAttr |
sth/sthd |
sth大等于sthd |
|
math/mathd |
math大等于mathd |
|||
Dert |
Dert[0]等于0时,SelRt[0]和SelRt[1]值为16 |
|||
Dert |
Dert[0]不等于0时, nXsfn[0~2]取值范围[3,max] |
|||
ref |
ref[1]等于0时, ref[0]等于0，en[3]等于0 |
|||
en |
en[2]等于0时, en[3]等于0 |
|||
VPSS_3DNRAttr |
NrMotionMode 等于COMPENSATE |
1. biPath[0]、biPath[1]都为0 2. AdvMath值为1 |
||
NrMotionMode等于NORMAL |
rftIdx[0]值为2 |
|||
NrMotionMode等于NORMAL 并且AdvMath等于1 |
mXmabw[0]值为4 |
|||
NrMotionMode等于NORMAL 并且 biPath[0]等于0 |
1. AdvMath值为0 2. mXmabw[0]取值[5,9] |
|||
NrMotionMode等于NORMAL 并且 biPath[1]等于0 |
mXmabw[2]取值[5,9] |
|||
参数详细说明¶
下面将详细列出界面上各模块参数对应SDK的API函数参考，这些参数说明请参考表1~表54。
SS928V100参数¶
表 1 TOP设置对应API
功能模块 |
对应SDK API |
|---|---|
Mode Handle |
无 |
Bypass Setting |
ot_mpi_isp_set_module_ctrl ot_mpi_isp_get_module_ctrl |
Fmw State |
ot_mpi_isp_set_fmw_state ot_mpi_isp_get_fmw_state |
CTRL Param |
ot_mpi_isp_set_ctrl_param ot_mpi_isp_get_ctrl_param |
MOD Param |
ot_mpi_isp_set_mod_param ot_mpi_isp_get_mod_param |
表 2 PubAttr设置对应API
功能模块 |
对应SDK API |
|---|---|
PubAttr |
ot_mpi_isp_set_pub_attr ot_mpi_isp_get_pub_attr |
表 3 ISPInfo设置对应API
功能模块 |
对应SDK API |
|---|---|
ISPInfo |
ot_mpi_isp_query_inner_state_info |
表 4 ExposureAttr设置对应API
功能模块 |
对应SDK API |
|---|---|
ExposureAttr |
ot_mpi_isp_set_exposure_attr ot_mpi_isp_get_exposure_attr |
表 5 WDRExposureAttr设置对应API
功能模块 |
对应SDK API |
|---|---|
WDRExposureAttr |
ot_mpi_isp_set_wdr_exposure_attr ot_mpi_isp_get_wdr_exposure_attr |
表 6 SmartExposureAttr设置对应API
功能模块 |
对应SDK API |
|---|---|
SmartExposureAttr |
ot_mpi_isp_set_smart_exposure_attr ot_mpi_isp_set_smart_exposure_attr |
表 7 Exp Convert Param设置对应API
功能模块 |
对应SDK API |
|---|---|
Exp Convert Param |
ot_mpi_isp_set_exp_convert ot_mpi_isp_get_exp_convert |
表 8 AERoute设置对应API
功能模块 |
对应SDK API |
|---|---|
AE Route |
ot_mpi_isp_set_ae_route_attr ot_mpi_isp_get_ae_route_attr |
AE Route EX |
ot_mpi_isp_set_ae_route_attr_ex ot_mpi_isp_get_ae_route_attr_ex |
AE Route SF |
ot_mpi_isp_set_ae_route_sf_attr ot_mpi_isp_get_ae_route_sf_attr |
AE Route SF EX |
ot_mpi_isp_set_ae_route_sf_attr_ex ot_mpi_isp_get_ae_route_sf_attr_ex |
表 9 AutoIris设置对应API
功能模块 |
对应SDK API |
|---|---|
AIAttr |
ot_mpi_isp_set_iris_attr ot_mpi_isp_get_iris_attr |
DcirisAttr |
ot_mpi_isp_set_dciris_attr ot_mpi_isp_get_dciris_attr |
PirisAttr |
ot_mpi_isp_set_piris_attr ot_mpi_isp_get_piris_attr |
表 10 ExposureInfo设置对应API
功能模块 |
对应SDK API |
|---|---|
ExposureInfo |
ot_mpi_isp_query_exposure_info |
表 11 WBAttr设置对应API
功能模块 |
对应SDK API |
|---|---|
White Balance |
ot_mpi_isp_set_wb_attr ot_mpi_isp_get_wb_attr |
AWBAttr |
ot_mpi_isp_set_wb_attr ot_mpi_isp_get_wb_attr |
MWBAttr |
ot_mpi_isp_set_wb_attr ot_mpi_isp_get_wb_attr |
AWBAttrEx |
ot_mpi_isp_set_awb_attr_ex ot_mpi_isp_get_awb_attr_ex |
BlackLevel |
ot_mpi_isp_set_black_level_attr ot_mpi_isp_get_black_level_attr |
表 12 WBInfo设置对应API
功能模块 |
对应SDK API |
|---|---|
WBInfo |
ot_mpi_isp_query_wb_info |
CalGainByTemp |
ot_mpi_isp_cal_gain_by_temp |
表 13 CCM设置对应API
功能模块 |
对应SDK API |
|---|---|
CCM |
ot_mpi_isp_set_ccm_attr ot_mpi_isp_get_ccm_attr |
ColorToneAttr |
ot_mpi_isp_set_color_tone_attr ot_mpi_isp_get_color_tone_attr |
表 14 Saturation设置对应API
功能模块 |
对应SDK API |
|---|---|
Saturation |
ot_mpi_isp_set_saturation_attr ot_mpi_isp_get_saturation_attr |
表 15 CLUT设置对应API
功能模块 |
对应SDK API |
|---|---|
CLUT Attr |
ot_mpi_isp_set_clut_attr ot_mpi_isp_get_clut_attr |
CLUT Lut |
ot_mpi_isp_set_clut_coeff ot_mpi_isp_get_clut_coeff |
表 16 CSC设置对应API
功能模块 |
对应SDK API |
|---|---|
CSC |
ot_mpi_isp_set_csc_attr ot_mpi_isp_get_csc_attr |
表 17 ChromaAdjust设置对应API
功能模块 |
对应SDK API |
|---|---|
CA Attr |
ot_mpi_isp_set_ca_attr ot_mpi_isp_get_ca_attr |
表 18 BNR设置对应API
功能模块 |
对应SDK API |
|---|---|
NR Attr |
ot_mpi_isp_set_nr_attr ot_mpi_isp_get_nr_attr |
表 19 RGBIR设置对应API
功能模块 |
对应SDK API |
|---|---|
RGBIR Attr |
ot_mpi_isp_set_rgbir_attr ot_mpi_isp_get_rgbir_attr |
表 20 Demosaic设置对应API
功能模块 |
对应SDK API |
|---|---|
Demosaic |
ot_mpi_isp_set_demosaic_attr ot_mpi_isp_get_demosaic_attr |
表 21 3DNR_X/3DNR Curve设置对应API
功能模块 |
对应SDK API |
|---|---|
3DNR_X |
ot_mpi_vpss_set_grp_param ot_mpi_vpss_get_grp_param |
表 22 YuvSharpen设置对应API
功能模块 |
对应SDK API |
|---|---|
YUV Sharpen |
ot_mpi_isp_set_sharpen_attr ot_mpi_isp_get_sharpen_attr |
表 23 BayerShpAttr设置对应API
功能模块 |
对应SDK API |
|---|---|
BayerSharpen Attr |
ot_mpi_isp_set_bayershp_attr ot_mpi_isp_get_bayershp_attr |
表 24 MCF Attr/MCF ALG设置对应API
功能模块 |
对应SDK API |
|---|---|
MCFGrp Attr |
ot_mpi_mcf_set_grp_attr ot_mpi_mcf_get_grp_attr |
MCF ALG 参数及曲线 |
ot_mpi_mcf_set_alg_param ot_mpi_mcf_get_alg_param |
表 25 FSWDR设置对应API
功能模块 |
对应SDK API |
|---|---|
FSWDR |
ot_mpi_isp_set_fswdr_attr ot_mpi_isp_get_fswdr_attr |
表 26 CRB设置对应API
功能模块 |
对应SDK API |
|---|---|
CRB Attr |
ot_mpi_isp_set_crb_attr ot_mpi_isp_get_crb_attr |
表 27 DRC设置对应API
功能模块 |
对应SDK API |
|---|---|
DRC |
ot_mpi_isp_set_drc_attr ot_mpi_isp_get_drc_attr |
表 28 Gamma设置对应API
功能模块 |
对应SDK API |
|---|---|
Gamma |
ot_mpi_isp_set_gamma_attr ot_mpi_isp_get_gamma_attr |
表 29 PreGamma设置对应API
功能模块 |
对应SDK API |
|---|---|
PreGamma |
ot_mpi_isp_set_pregamma_attr ot_mpi_isp_get_pregamma_attr |
表 30 LDCI设置对应API
功能模块 |
对应SDK API |
|---|---|
LDCI Attr |
ot_mpi_isp_set_ldci_attr ot_mpi_isp_get_ldci_attr |
表 31 Dehaze设置对应API
功能模块 |
对应SDK API |
|---|---|
Dehaze |
ot_mpi_isp_set_dehaze_attr ot_mpi_isp_get_dehaze_attr |
表 32 AntiFalseColor设置对应API
功能模块 |
对应SDK API |
|---|---|
AntiFalse |
ot_mpi_isp_set_anti_false_color_attr ot_mpi_isp_get_anti_false_color_attr |
表 33 Crosstalk设置对应API
功能模块 |
对应SDK API |
|---|---|
Crosstalk |
ot_mpi_isp_set_crosstalk_attr ot_mpi_isp_get_crosstalk_attr |
表 34 MeshShading设置对应API
功能模块 |
对应SDK API |
|---|---|
Shading Attr |
ot_mpi_isp_set_mesh_shading_attr ot_mpi_isp_get_mesh_shading_attr |
Shading Lut Attr |
ot_mpi_isp_set_mesh_shading_gain_lut_attr ot_mpi_isp_get_mesh_shading_gain_lut_attr |
表 35 DefectPixel设置对应API
功能模块 |
对应SDK API |
|---|---|
DP Auto Calibrate |
ot_mpi_isp_set_dp_dynamic_attr ot_mpi_isp_get_dp_dynamic_attr |
DP Static Calibrate |
ot_mpi_isp_get_dp_calibrate ot_mpi_isp_get_dp_calibrate |
DPAttr |
ot_mpi_isp_set_dp_static_attr ot_mpi_isp_get_dp_static_attr |
表 36 CAC设置对应API
功能模块 |
对应SDK API |
|---|---|
LocalATTR |
ot_mpi_isp_set_local_cac_attr ot_mpi_isp_get_local_cac_attr |
Acac Attr |
ot_mpi_isp_set_acac_attr ot_mpi_isp_get_acac_attr |
表 37 LDC设置对应API
功能模块 |
对应SDK API |
|---|---|
LDC |
ot_mpi_vi_set_chn_ldc_attr ot_mpi_vi_get_chn_ldc_attr |
表 38 LDCV2设置对应API
功能模块 |
对应SDK API |
|---|---|
LDCV2 |
ot_mpi_vi_set_chn_ldc_attr ot_mpi_vi_get_chn_ldc_attr |
表 39 FPN设置对应API
功能模块 |
对应SDK API |
|---|---|
FPNCalibrate |
ot_mpi_isp_fpn_calibrate |
FPNCorrection |
ot_mpi_isp_set_fpn_attr ot_mpi_isp_get_fpn_attr |
表 40 RC Attr设置对应API
功能模块 |
对应SDK API |
|---|---|
RC Attr |
ot_mpi_venc_set_chn_attr ot_mpi_venc_get_chn_attr |
表 41 RC Param设置对应API
功能模块 |
对应SDK API |
|---|---|
RC Param |
ot_mpi_venc_set_rc_param ot_mpi_venc_get_rc_param |
表 42 GopMode设置对应API
功能模块 |
对应SDK API |
|---|---|
GopMode |
ot_mpi_venc_set_chn_attr ot_mpi_venc_get_chn_attr |
表 43 VencEx设置对应API
功能模块 |
对应SDK API |
|---|---|
Intra Refresh |
ot_mpi_venc_set_intra_refresh ot_mpi_venc_get_intra_refresh |
ROI Attributes |
ot_mpi_venc_set_roi_attr ot_mpi_venc_get_roi_attr |
ROICfgIndex |
无 |
ROIBG_Frame_Rate |
ot_mpi_venc_set_roi_bg_frame_rate ot_mpi_venc_get_roi_bg_frame_rate |
Color2Grey |
ot_mpi_venc_set_chn_param ot_mpi_venc_get_chn_param |
REF Parameters |
ot_mpi_venc_set_ref_param ot_mpi_venc_get_ref_param |
Frame Lost |
ot_mpi_venc_set_frame_lost_strategy ot_mpi_venc_get_frame_lost_strategy |
Super Frame |
ot_mpi_venc_set_super_frame_strategy ot_mpi_venc_get_super_frame_strategy |
表 44 VencEx2设置对应API
功能模块 |
对应SDK API |
|---|---|
Scene |
ot_mpi_venc_set_scene_mode ot_mpi_venc_get_scene_mode |
ForeGroundProtect |
ot_mpi_venc_set_fg_protect ot_mpi_venc_get_fg_protect |
表 45 DeBreathEffect设置对应API
功能模块 |
对应SDK API |
|---|---|
DeBreathEffect |
ot_mpi_venc_set_debreath_effect ot_mpi_venc_get_debreath_effect |
表 46 RadialCROP设置对应API
功能模块 |
对应SDK API |
|---|---|
RadialCROP |
ot_mpi_isp_set_rc_attr ot_mpi_isp_get_rc_attr |
表 47 VpssCROP设置对应API
功能模块 |
对应SDK API |
|---|---|
CROP_INFO |
ot_mpi_vpss_set_grp_crop ot_mpi_vpss_get_grp_crop |
表 48 DNG设置对应API
功能模块 |
对应SDK API |
|---|---|
DngColorParam |
ot_mpi_isp_set_dng_color_param ot_mpi_isp_get_dng_color_param |
DngImageStaticInfo |
ot_mpi_isp_get_dng_image_static_info |
表 49 StatisticsConfig设置对应API
功能模块 |
对应SDK API |
|---|---|
StatisticsConfig |
ot_mpi_isp_set_stats_cfg ot_mpi_isp_get_stats_cfg |
表 50 SpreadCoef设置对应API
功能模块 |
对应SDK API |
|---|---|
VI_Spread |
ot_mpi_vi_set_chn_spread_attr ot_mpi_vi_get_chn_spread_attr |
VPSS_Spread |
ot_mpi_vpss_set_chn_spread_attr ot_mpi_vpss_get_chn_spread_attr |
表 51 RotateEX设置对应API
功能模块 |
对应SDK API |
|---|---|
RotateEX |
ot_mpi_vi_set_chn_rotation ot_mpi_vi_get_chn_rotation |
表 52 TimingAttr设置对应API
功能模块 |
对应SDK API |
|---|---|
TimingAttr |
ot_mpi_vi_set_dev_timing_attr ot_mpi_vi_get_dev_timing_attr |
表 53 DIS设置对应API
功能模块 |
对应SDK API |
|---|---|
VI_DISATTR |
ot_mpi_vi_set_chn_dis_attr ot_mpi_vi_get_chn_dis_attr |
VI_DISConfig |
ot_mpi_vi_set_chn_dis_cfg ot_mpi_vi_get_chn_dis_cfg |
VI_DISParam |
ot_mpi_vi_set_chn_dis_param ot_mpi_vi_get_chn_dis_param |
表 54 Fisheye设置对应API
功能模块 |
对应SDK API |
|---|---|
FisheyeAttr |
ot_mpi_vi_set_chn_fisheye ot_mpi_vi_get_chn_fisheye |
FisheyeDevConfig |
ot_mpi_vi_set_pipe_fisheye_cfg ot_mpi_vi_get_pipe_fisheye_cfg |
工具应用参考¶
工具的参数如何导入导出？¶
使用工具导入导出参数¶
工具的参数既可以支持PC端的配置文件导入和导出，同时支持工具的参数固化到单板。
若用户希望导入或导出PQTools工具主程序使用的参数文件，请按照"保存调试数据文件"和"打开调试数据文件"章节的说明，进行保存.xml数据文件，以及打开.xml数据文件的操作。
若用户希望将参数导入到单板，或从单板导出参数数据进行备份，则请使用工具提供的“二进制数据处理”功能。请按以下说明进行操作：
导入导出板端参数BIN文件
在连接到单板，并已经打开调试表的状态下，点击工具栏上的“二进制数据处理”按钮（
），打开对话框：导入导出参数配置
当前导入导出BIN文件，支持两种类型的BIN：
演进型：开发阶段使用，保存图像质量AE/AWB/ISP参数，可保证在版本更迭过程中，图像质量结构体发生变动时，上一版本保存的BIN在当前版本使用；
稳定型：支持导入ISP参数以及3DNR参数，如果选择导入3DNR参数到BIN文件，需要在Top页面设置当前3DNR参数业务的pipe或者group号。
图 1 二进制数据处理对话框 （演进型）
图 2 二进制数据处理对话框（稳定型）
通过图1和图2中“BIN Import Export”组可完成以下操作：
导出板端参数BIN文件：点击“Export BIN File”按钮，并在弹出的文件保存对话框中选择一个保存路径。工具会将板端当前的参数保存到指定的保存路径。
导入板端参数BIN文件：点击“Import BIN File”按钮，并在弹出的文件选择对话框中选择一个正确的板端参数BIN文件。工具会将选择的文件发送到板端。发送完成后，数据会即时生效。
通过本功能导出的参数BIN文件为板端专用，只能通过BIN对话框的导入功能导入，无法直接在PQTools工具主程序中打开。
BIN保存的ISP模块参数，是ISP模块中非统计信息的数据。
导入的BIN文件需要符合当前业务的场景（VI的分辨率、WDR模式、ISP路数、ViPipe和VpssGrp等基本参数需要相同）才能正常运行。
每次导出的ISP模块参数，地址等信息相较于上一次会有变化。
下章节使用库导入导出图像质量参数不支持演进型BIN导入导出。
BIN中ISP保存模块¶
isp_ext_config.h头文件中部分功能宏对应的寄存器地址及长度值，具体模块：
VREG_BLC_OFFSET + 0x8, /* ot_ext_system_black_level_change_write */
VREG_RC_OFFSET + 0x1, /* ot_ext_system_rc_coef_update_en_write */
VREG_CLUT_OFFSET + 0x1, /* ot_ext_system_clut_lut_update_en_write */
VREG_CLUT_OFFSET + 0x8, /* ot_ext_system_clut_ctrl_update_en_write */
VREG_GE_OFFSET + 0x67, /* ot_ext_system_ge_coef_update_en_write */
VREG_CSC_OFFSET + 0x58, /* ot_ext_system_csc_attr_update_write */
VREG_WDR_OFFSET + 0x1, /* ot_ext_system_wdr_coef_update_en_write */
VREG_DM_OFFSET + 0x12, /* ot_ext_system_demosaic_attr_update_en_write */
VREG_AWB_OFFSET + 0x28, /* ot_ext_system_wb_statistics_mpi_update_en_write */
VREG_DEHAZE_OFFSET + 0x142, /* ot_ext_system_user_dehaze_lut_update_write */
VREG_DRC_OFFSET + 0x1, /* ot_ext_system_drc_param_updated_write *//
VREG_PREGAMMA_OFFSET + 0x1, /* ot_ext_system_pregamma_lut_update_write */
VREG_CA_OFFSET + 0x446, /* ot_ext_system_ca_coef_update_en_write */
VREG_GAMMA_OFFSET + 0x1, /* ot_ext_system_gamma_lut_update_write */
VREG_SHARPEN_OFFSET + 0x3, /* ot_ext_system_sharpen_mpi_update_en_write */
VREG_LSC_OFFSET + 0x1, /* ot_ext_system_isp_mesh_shading_lut_attr_updata_write */
VREG_LSC_OFFSET + 0x2, /* ot_ext_system_isp_mesh_shading_attr_updata_write */
VREG_LSC_OFFSET + 0x4460, /* ot_ext_system_isp_mesh_shading_fe_lut_attr_updata_write */
VREG_LSC_OFFSET + 0x4461, /* ot_ext_system_isp_mesh_shading_fe_attr_updata_write */
VREG_DPC_OFFSET + 0x5e, /* ot_ext_system_dpc_static_attr_update_write */
VREG_DPC_OFFSET + 0x5f /* ot_ext_system_dpc_dynamic_attr_update_write */
ot_mpi_isp.h头文件中clut功能参数，对应set接口ot_mpi_isp_set_clut_coeff（方便理解将ISP虚拟寄存器clut读写数据段映射为接口来描述）；
ot_mpi_ae.h头文件中get/set接口对应的功能参数；
ot_mpi_awb.h头文件中get/set接口对应的功能参数。
使用库导入导出图像质量参数¶
板端工具提供导入导出参数库文件，可根据自己的需要选择功能。
开放参数¶
typedef struct otPQ_BIN_ISP_S {
int enable;
} PQ_BIN_ISP_S;
typedef struct otPQ_BIN_NRX_S{
int enable;
int viPipe;
int vpssGrp;
} PQ_BIN_NRX_S;
typedef struct otPQ_BIN_ISP_EVO_S {
int enable;
int viPipe;
} PQ_BIN_ISP_EVO_S;
typedef struct otPQ_BIN_MODULE_S{
PQ_BIN_ISP_S stISP;
PQ_BIN_NRX_S st3DNR;
PQ_BIN_ISP_EVO_S stIspEvo;
} PQ_BIN_MODULE_S;
开放接口¶
OT_PQ_GetISPDataTotalLen：获取isp参数BIN数据的长度。
OT_PQ_GetStructParamLen：获取Struct BIN数据的长度。
OT_PQ_BIN_ExportBinData：导出BIN文件。
OT_PQ_BIN_ImportBinData：导入BIN文件。
可参考推荐使用流程，如图1所示。
图 1 BIN推荐使用流程
数据类型¶
PQ_BIN_ISP_S¶
【说明】
设置ISP BIN参数。
【定义】
typedef struct otPQ_BIN_ISP_S {
int enable;
} PQ_BIN_ISP_S;
【成员】
成员名称 |
描述 |
|---|---|
enable |
ISP参数保存的使能开关 |
【注意事项】
无
【相关数据类型及接口】
无
PQ_BIN_NRX_S¶
【说明】
设置NRX结构体保存 BIN参数。
【定义】
typedef struct otPQ_BIN_NRX_S {
int enable;
int viPipe;
int vpssGrp;
} PQ_BIN_NRX_S;
【成员】
成员名称 |
描述 |
|---|---|
enable |
ISP参数保存的使能开关 |
viPipe |
viPipe通道号 |
vpssGrp |
vpssGrp的通道号 |
【注意事项】
enable使能之后，需要设置对应场景的viPipe号或者是vpssGrp号。
【相关数据类型及接口】
无
PQ_BIN_ISP_EVO_S¶
【说明】
设置演进版本BIN结构体参数。
【定义】
typedef struct otPQ_BIN_ISP_EVO_S {
int enable;
int viPipe;
} PQ_BIN_ISP_EVO_S;
【成员】
成员名称 |
描述 |
|---|---|
enable |
是否使用演进版本的BIN，默认置为false |
viPipe |
演进版本BIN viPipe通道号 |
【注意事项】
演进版本是指还未开发完成的版本，即isp未开发完，BIN结构可能会变化.在这个过程中上个版本导出的BIN，在下个版本导入可能就会错位，所以用演进版本BIN，导入时只导入未变化的部分
【相关数据类型及接口】
无
PQ_BIN_MODULE_S¶
【说明】
设置保存BIN数据的参数。
【定义】
typedef struct otPQ_BIN_MODULE_S {
PQ_BIN_ISP_S stISP;
PQ_BIN_NRX_S st3DNR;
PQ_BIN_ISP_EVO_S stIspEvo;
} PQ_BIN_MODULE_S;
【成员】
成员名称 |
描述 |
|---|---|
stISP |
保存ISP参数的相关设置参数 |
st3DNR |
保存3dnr参数的相关设置参数 |
stIspEvo |
保存演进版本BIN的相关设置参数， |
【注意事项】
无
【相关数据类型及接口】
无
API参考¶
OT_PQ_GetISPDataTotalLen¶
【描述】
获取isp 参数BIN数据的长度。
【语法】
unsigned int OT_PQ_GetISPDataTotalLen();
【参数】
无
【返回值】
返回值 |
描述 |
|---|---|
长度 |
BIN数据的总长度。 |
【错误码】
无
【需求】
头文件：ot_pq_bin.h
库文件：libbin.a
【注意】
此函数必须在调用OT_PQ_BIN_ExportBinData接口前调用。
OT_PQ_GetStructParamLen¶
【描述】
获取struct BIN数据的长度。
【语法】
unsigned int OT_PQ_GetStructParamLen (PQ_BIN_MODULE_S *pstBinParam);
【参数】
参数名称 |
描述 |
输入/输出 |
|---|---|---|
pstBinParam |
设置BIN文件保存内存和相关通道参数。 |
输入 |
【返回值】
返回值 |
描述 |
|---|---|
长度 |
Struct参数的实际长度。 |
【错误码】
无
【需求】
头文件：ot_pq_bin.h
库文件：libbin.a
【注意】
此函数必须在调用OT_PQ_BIN_ExportBinData接口前调用。
OT_PQ_BIN_ExportBinData¶
【描述】
导出BIN数据。
【语法】
int OT_PQ_BIN_ExportBinData(PQ_BIN_MODULE_S *pstBinParam, unsigned char* pu8Buffer, unsigned int u32DataLength);
【参数】
参数名称 |
描述 |
输入/输出 |
|---|---|---|
pstBinParam |
设置BIN文件保存内存和相关通道参数 |
输入 |
pu8Buffer |
存放BIN的内存空间 |
输出 |
u32DataLength |
BIN数据的长度 |
输入 |
【返回值】
返回值 |
描述 |
|---|---|
0 |
成功 |
非0 |
失败，其值为错误码 |
【错误码】
接口返回值 |
含义 |
|---|---|
0xCB000001 |
入参指针为空 |
0xCB000003 |
未分配到内存空间 |
0xCB000005 |
数据不完整 |
0xCB000008 |
数据损坏 |
0xCB000009 |
Mpi接口读写错误 |
0xCB00000A |
数据受保护 |
【需求】
头文件：ot_pq_bin.h
库文件：libbin.a
【注意】
调用此函数必须先调用OT_PQ_GetISPDataTotalLen或者OT_PQ_GetStructParamLen函数，获取数据的大小，否则可能出现内存问题。
OT_PQ_BIN_ImportBinData¶
【描述】
导入BIN数据。
【语法】
int OT_PQ_BIN_ImportBinData(PQ_BIN_MODULE_S *pstBinParam，unsigned char* pu8Buffer, unsigned int u32DataLength);
【参数】
参数名称 |
描述 |
输入/输出 |
|---|---|---|
pstBinParam |
设置BIN文件保存内存和相关通道参数 |
输入 |
pu8Buffer |
BIN的内存空间 |
输入 |
u32DataLength |
BIN大小 |
输入 |
【返回值】
返回值 |
描述 |
|---|---|
0 |
成功 |
非0 |
失败，其值为错误码 |
【错误码】
接口返回值 |
含义 |
|---|---|
0xCB000001 |
入参指针为空 |
0xCB000003 |
申请空间失败 |
0xCB000008 |
数据错误 |
0xCB000009 |
Mpi接口读写错误 |
0xCB00000A |
数据被保护 |
【需求】
头文件：ot_pq_bin.h
库文件：libbin.a
【注意】
无
工具如何替换3A算法？¶
工具可通过配置XML指定修改某一地址对应的值。若要替换3A算法首先更新XML文件中3A算法的地址和格式等配置选项，具体更改配置方法请看“物理/虚拟寄存器的添加与调试”，最后用图像调节工具导入配置好的xml文件即可。
点播工具使用¶
点播软件的安装与运行¶
板端软件执行¶
直接运行可执行程序，根据实际sensor情况运行PQTools.sh。步骤如下：
把位于发布包中的SSXX_PQ_VX.X.X.X.tgz解压到单板上或者服务器上。如果解压到服务器上运行，需先将单板mount到服务器目录下。
板端的工具是根据./PQTools.sh脚本里的配置启动的，需运行脚本即可。启动脚本后需输入启动参数，如下：
./ PQTools.sh -a sensor目录 ini序列 如 ./ PQTools.sh -a XXX 0
sensor目录：应用程序默认在SSXX_PQ_VX.X.X.X目录下configs目录下读取config_entry.ini
ini序列在config_entry.ini中可以查看；也可以配置config_entry.ini，而不输入ini序列。
PC端软件执行¶
点播软件的PC端软件是绿色软件，直接使用解压缩工具（如WinRAR、WinZip等）将PQStream（zip格式）解压缩到任意的可写目录，即可使用。
如果需要支持4K30fps，推荐显卡性能如下：
显卡内存：2GB
显存位宽：128bit
核心频率：900MHz
显存频率：5000MHz
如果需要支持10bit图像显示，显卡和显示器必须支持10bit。
快速入门¶
运行PQStream软件后，出现登录画面，输入相应的IP地址，点击“确定”按钮，即可进去主界面，如图1和图2所示。
图 1 登录界面
图 2 主界面
主界面各功能按钮和区域的介绍如下：
录像后的抓JPEG功能已经移到了 control 界面上，stream 上不支持抓JPEG。
当帧率为120时，由于工具当前不支持过高帧率，所以板端会进行帧率控制；建议控制作为30~60帧。
预览¶
(1)预览通道选择：控制预览画面来源于哪一个通道。
(2)预览与停止：控制视频预览与停止。点播一路编码预览时，下拉菜单包括Enc、YUV两种预览模式以及停止预览控制，如图1所示。
图 1 预览下拉菜单
当程序启动时，会自动链接主程序设置IP地址的设备。可以在左下角查看当前链接状态“(9) 当前信息”，链接成功后可视频预览页面“(8)视频预览主页面”观察当前视频。
点播编码格式可由板端的配置文件配置，修改对应sensor的配置文件中RcMode字段的值即可。
支持多路编码点播工具中，默认启动的是第一路编码点播。若是想要预览其他路，使用预览通道选择。
如需修改编码格式需要在对应sensor配置文件中的venc字段RcMode为所需要的编码格式。支持多路编码预览的工具，修改编码格式需要在对应sensor配置文件中的venc_X字段RcMode为所需要的编码格式，X为编码通道编号。
配置文件路径为板端发布包中configs文件夹。
点播工具暂不支持YUV预览。
视频窗口可以通过下拉框“(6)预览窗口比例”选择缩放比例。目前支持30%、50%、80%或100%的比例缩放。当视频窗口过大时，可以拖动预览窗口的滚动条查看。也可以鼠标拖动应用程序右下角改变其大小。
录像¶
(3)录像：控制录像的开始与停止。下拉菜单包括录像的开始、停止和设置，如图2所示。当视频正常链接的时候，点击下拉菜单录像按钮进行录像。开始录像时录像按钮变为
且下拉菜单变为
。在“(5)录像时长”处显示已录像时长。此时当点击下拉列表的停止按钮，停止录像。同时按钮恢复先前状态，“(5)录像时长”消失。
右键功能菜单¶
显示方式¶
在可视频预览页面“(8)视频预览主页面”，点击鼠标右键出现右键菜单，第1个VO Type，有2个选项，默认使用BT709。
图 1 右键菜单（显示方式）
解码方式¶
在可视频预览页面“(8)视频预览主页面”，点击鼠标右键出现右键菜单，第2个Stream Type，有2个选项，默认使用Rate First，Data First一般使用超大I帧的场景。
图 1 右键菜单（解码方式）
区域平均亮度统计¶
图 1 亮度统计开关
打开后在工具的最下方状态栏出现亮度统计显示项。
鼠标左键在图像上按住不放，拖动框选想要的区域后，松开鼠标左键。数值就会显示。
此功能比较适合静态场景测试，当图像为高速运动场景时。获取的数据可能和实际鼠标点击时的图像相差较大。
输出图层¶
在可视频预览页面“(8)视频预览主页面”，点击鼠标右键出现右键菜单，第4个OutLayer，有2个选项，默认使用Normal，Original用于隐私保护等特殊使用场景。
图 1 输出图层选项
WDR模式切换¶
WDR模式切换，可获取当前设备支持的WDR模式，并可快速切换所有支持的WDR模式，画面快速生效，如图1所示。
图 1 WDR模式切换
ViDev选择VI设备，WDR下拉选择要切换的WDR模式，选择即生效。
Stitch数据源切换¶
Stitch数据源切换功能实现输入到AVSP模块的数据来源快速设置，点播画面立即生效，如图1所示。
图 1 Config-Stitch数据源设置
Pipe0 From Source Seq表示pipe0图像数据从镜头x获取，Pipe1 From Source Seq表示pipe1图像数据从镜头y获取，默认设置0,1下发板端，点播画面无变化。设置其他不同值下发板端，点播图像会切换到设置的镜头画面。
录像设置¶
录像保存路径设置，如图1所示。
图 1 录像设置
Browse功能
支持手动选择录像文件储存在PC中的路径。
OK
点击保存设置，可选择退出参数设置窗口。
Sensor参数设置¶
Sensor参数设置功能“(4)参数设置”实现动态切换配置sensor参数。如图1所示。
图 1 Config功能主界面
Browse功能
支持手动选择PC中的配置文件。
选择发送格式
全部重启和切换wdr格式。
Send功能
把browse选中的配置文件下发到板端并配置到板端。
ini文件适配¶
表 1 ini文件参数一览表
Key字段 |
字段 |
对应接口 |
说明 |
|---|---|---|---|
isp |
IspNum |
工具内部参数 |
isp数目，与isp.x配置项的数目匹配 |
IntBotHalf |
ot_mpi_isp_set_mod_param |
参考《ISP开发参考》 |
|
isp.0 |
DevId |
ot_mpi_isp_mem_init ot_mpi_isp_init ot_mpi_isp_run |
启动isp的设备号 |
SensorType |
无 |
ISP_SNS_OBJ_S结构体对象 |
|
SensorLibFile |
工具内部参数 |
Sensor动态库文件 |
|
WdrModeNum UseWdrMode WdrMode0 UseMipiMode0 |
工具内部参数 |
WDR模式配置项，详见表下说明1 |
|
Isp_x Isp_y Isp_w Isp_h SensorWidth SensorHeight Isp_FrameRate Isp_Bayer SnsMode |
ot_mpi_isp_set_pub_attr |
参考《ISP开发参考》 |
|
SnsType I2cDev SspDev SspCs |
pfnSetBusInfo |
BusInfo配置项，详见表下说明2 |
|
ProcParam StatIntvl UpdatePos IntTimeOut PwmNumber PortIntDelay |
ot_mpi_isp_set_ctrl_param |
参考《ISP开发参考》 |
|
mipi |
lane_divide_mode |
OT_MIPI_SET_HS_MODE |
mipi hs_mode配置项 |
MipiModeNum |
工具内部参数 |
mipi数目，与mipi_mode.x配置项的数目匹配 |
|
mipi_mode.0 |
{所有字段} |
OTMIPI_SET_DEV_ATTR |
对应combo_dev_attr_t结构，参考《MIPI使用指南》 |
vi |
StitchGrpNum |
工具内部参数 |
拼接组数目，与stitch_grp.x配置项的数目匹配 |
DevNum |
工具内部参数 |
VI Dev数目，与vi_dev.x、vi_timing.x配置项的数目匹配 |
|
PipeNum |
工具内部参数 |
VI Pipe数目，与vi_pipe.x、vi_snap.x、vi_fisheye.x配置项的数目匹配 |
|
stitch_grp.0 |
{所有字段} |
ot_mpi_vi_set_stitch_grp_attr |
参考《MPP 媒体处理软件 V5.0 开发参考》的“视频输入”章节 |
vi_dev.0 |
{所有字段} |
ot_mpi_vi_set_dev_attr |
参考《MPP 媒体处理软件 V5.0 开发参考》的“视频输入”章节 |
vi_timing.0 |
{所有字段} |
ot_mpi_vi_set_dev_timing_attr |
参考《MPP 媒体处理软件 V5.0 开发参考》的“视频输入”章节 |
vi_pipe.0 |
{所有字段} （除RepeatMode、ChnNum外） |
ot_mpi_vi_create_pipe |
参考《MPP 媒体处理软件 V5.0 开发参考》的“视频输入”章节 |
ChnNum |
工具内部参数 |
VI Chn数目，与vi_chn.x.x、vi_gdc.x.x、vi_dis.x.x、vi_spread.x.x、vi_ldc.x.x配置项的数目匹配 |
|
vi_fisheye.0 |
Fisheye |
工具内部参数 |
鱼眼使能标志，详见表下说明3 |
LMFCoef |
ot_mpi_vi_set_pipe_fisheye_cfg |
参考《MPP 媒体处理软件 V5.0 开发参考》的“视频输入”章节 |
|
vi_chn.0.0 |
{所有字段} |
ot_mpi_vi_set_chn_attr或ot_mpi_vi_set_ext_chn_attr |
参考《MPP 媒体处理软件 V5.0 开发参考》的“视频输入”章节 |
vi_gdc.0.1 |
{所有字段} |
ot_mpi_vi_set_chn_fisheye |
参考《MPP 媒体处理软件 V5.0 开发参考》的“视频输入”章节 |
vi_dis.0.0 |
{所有字段} |
ot_mpi_vi_set_chn_dis_cfg ot_mpi_vi_set_chn_dis_attr |
参考《MPP 媒体处理软件 V5.0 开发参考》的“视频输入”章节 |
vi_spread.0.0 |
{所有字段} |
ot_mpi_vi_set_chn_spread_attr |
参考《MPP 媒体处理软件 V5.0 开发参考》的“视频输入”章节 |
vi_ldc.0.0 |
{所有字段} |
ot_mpi_vi_set_chn_ldc_attr |
参考《MPP 媒体处理软件 V5.0 开发参考》的“视频输入”章节 |
vpss_group |
VpssGrpNum |
工具内部参数 |
VPSS Grp数目，与vpss_group.x配置项的数目匹配 |
vpss_group.0 |
{所有字段} （除VpssChnNum外） |
ot_mpi_vpss_create_grp |
参考《MPP 媒体处理软件 V5.0 开发参考》的“视频处理子系统”章节 |
VpssChnNum |
工具内部参数 |
VPSS Chn数目，与vpss_chn.x.x配置项的数目匹配 |
|
vpss_chn.0.0 |
{所有字段} |
ot_mpi_vpss_set_chn_attr或ot_mpi_vpss_set_ext_chn_attr |
参考《MPP 媒体处理软件 V5.0 开发参考》的“视频处理子系统”章节 |
vpss_rotation.0.0 |
Rotation |
ot_mpi_vpss_set_chn_rotation |
参考《MPP 媒体处理软件 V5.0 开发参考》的“视频处理子系统”章节 |
avs |
AvsGrpNum |
工具内部参数 |
AVS Grp数目，与avs_grp.x配置项的数目匹配 |
WorkingSetSize |
ot_mpi_avs_set_mod_param |
参考《MPP 媒体处理软件 V5.0 开发参考》的“全景拼接”章节 |
|
avs_grp.0 |
{所有字段} （除ChnNum外） |
ot_mpi_avs_create_grp |
参考《MPP 媒体处理软件 V5.0 开发参考》的“全景拼接”章节 |
ChnNum |
工具内部参数 |
AVS Chn数目，与avs_chn.x.x配置项的数目匹配 |
|
avs_chn.0.0 |
{所有字段} |
ot_mpi_avs_set_chn_attr |
参考《MPP 媒体处理软件 V5.0 开发参考》的“全景拼接”章节 |
venc |
VencNum |
工具内部参数 |
VENC数目，与venc.x配置项的数目匹配 |
venc.0 |
{所有字段} |
ot_mpi_venc_create_chn |
参考《MPP 媒体处理软件 V5.0 开发参考》的“视频编码”章节 |
vo |
DevNum |
工具内部参数 |
VO Dev数目，与vo_dev.x配置项的数目匹配 |
LayerNum |
工具内部参数 |
VO Layer数目，与vo_layer.x配置项的数目匹配 |
|
vo_dev.0 |
{所有字段} |
ot_mpi_vo_set_pub_attr |
参考《MPP 媒体处理软件 V5.0 开发参考》的“视频输出”章节 |
vo_layer.0 |
{所有字段} （除ChnNum外） |
ot_mpi_vo_set_video_layer_attr |
参考《MPP 媒体处理软件 V5.0 开发参考》的“视频输出”章节 |
ChnNum |
工具内部参数 |
VO Chn数目，与vo_chn.x.x配置项的数目匹配 |
|
vo_chn |
{所有字段} |
ot_mpi_vo_set_chn_attr |
参考《MPP 媒体处理软件 V5.0 开发参考》的“视频输出”章节 |
bind |
BindNum |
工具内部参数 |
模块间绑定关系数目，详见表下说明5 |
bind_attr |
{所有字段} |
工具内部参数 |
模块间绑定关系，详见表下说明5 |
vb |
VbNum |
工具内部参数 |
vb数目，与vbblk.x配置项的数目匹配 |
vbblk.0 |
{所有字段} |
ot_mpi_vb_set_cfg |
参考《MPP 媒体处理软件 V5.0 开发参考》的“系统控制”章节 详见表下说明6 |
sys |
ViVpssMode |
ot_mpi_sys_set_vi_vpss_mode |
参考《MPP 媒体处理软件 V5.0 开发参考》的“系统控制”章节 |
CompRatio_10Bit CompRatio_12Bit CompRatio_14Bit |
ot_mpi_sys_set_raw_frame_compress_param |
参考《MPP 媒体处理软件 V5.0 开发参考》的“系统控制”章节 |
说明1：此ini文件支持在多种WDR模式之间切换。WdrModeNum表示可切换的数目；UseWdrMode表示生效的WDR模式，即以该WDR模式启动业务；WdrModex表示可切换的WDR模式的种类，如果WdrModeNum配置为2，则应当配置WdrMode0和WdrMode1；UseMipiModex与WdrModex对应，表示该WDR模式使用的mipimode配置为后面的[mipi_mode.x]。
说明2：SnsType、I2cDev、SspDev、SspCs用于配置此isp对应的i2c或ssp设备。SnsType配置为0（ISP_SNS_I2C_TYPE）表示此isp对应i2c设备，此时需配置I2cDev；SnsType配置为1（ISP_SNS_SSP_TYPE）表示此isp对应ssp设备，此时需配置SspDev、SspCs；SnsType配置为2（ISP_SNS_TYPE_BUTT）表示使用默认配置，此时无需配置I2cDev、SspDev、SspCs。
说明3：此ini文件支持配置为鱼眼模式。如果[vi_fisheye.x]中的Fisheye配置为FALSE，表示此Pipe不使用鱼眼模式，[vi_fisheye.x]中的其他项目无需配置，[vi_gdc.x.x]也无需配置。
说明4：[bind]和[bind_attr]用于配置各模块间的绑定关系。如果[bind]中的BindNum配置为5，则应当在[bind_attr]配置bind0、bind1、bind2、bind3和bind4。每一项bindx有6个属性，分别对应SrcMod、SrcDev、SrcChn、DstMod、DstDev、DstChn。例如bind0 = 16|0|0|15|0|0表示将VI Pipe0的Chn0作为前端与VO Layer0的Chn0作为后端绑定起来。
说明5：[vb]和[vbblk.x]用于配置系统vb。为方便用户修改width、height时查找替换，[vbblk.x]中VbSize使用VbSize = width|height的格式进行配置。最终生效的vb大小为Width x Height x VbCoef / 10，例如VbSize = 3840|2160，VbCoef = 20，则生效的vb大小为3840 x 2160 x 20 / 10 = 16588800
说明6：如果配置的场景不需要某个模块，将此模块的数目配置为0即可。例如配置的场景不需要AVS模块，将AvsGrpNum配置为0，此时[avs_grp.x]和[avs_chn.x.x]无需配置。
说明7：VENC模块的属性BufSize，在ini中体现如BufCoef的注释：BufSize = PicWidth*PicHeight*BufCoef，设置宽、高、系数即可计算BufSize。
说明8：同系列芯片ini配置默认为可支持性能最低一款芯片。
说明9：修改ini配置，实现从vi灌YUV；
如用pipe1起业务从VI灌YUV参考如下配置修改ini：
{"[isp.0]", "DevId", "1"}, {"[vi]", "WdrGrpNum", "0"}, {"[vi_dev.0]", "BindPipeId", "1"}, {"[vi_pipe.0]", "pipe_id", "1"}, {"[vi_pipe.0]", "IspBypass", "TRUE"}, {"[vi_pipe.0]", "PixFmt", "28"}, {"[vi_pipe.0]", "BitWidth", "0"}, {"[vi_pipe.0]", "CompressMode", "0"}, {"[vpss_group.0]", "NrEn", "TRUE"}, {"[bind_attr]", "bind0", "16|1|0|7|0|0"},
注意：PixFmt要设置为OT_PIXEL_FORMAT_YVU_SEMIPLANAR_420 格式，不同版本之间可能枚举值不同，需适配。
从VI灌YUV指定的pipe号是否支持需要与芯片保持一致。
说明10：一般来说ini里面默认设置可支持PQTools PC软件所有调试、抓灌等功能，但经济型芯片因为DDR非常小，需要通过修改ini多处实现部分功能。
新sensor对接，如何支持？¶
利用发布包中的配置文件，修改对应参数后设置到板端使其生效。
使参数生效有两种方式：
板端启动指定的配置文件。
启动脚本PQTools.sh，启动方式为：
./PQTools.sh 启动业务 业务启动方式 配置文件夹
启动stream
./PQTools.sh -s filepath
帮助
./PQTools.sh -h
配置文件中包含修改的config_entry.ini、指定的配置文件
PC端下发配置文件。
启动单板工具。
按"板端软件执行"启动。
启动PC端工具。
打开主程序的点播工具插件，点击“config”按钮，点击“Browser”按钮选择配置好的sensor配置文件，点击“send”即可。
第三方播放工具使用¶
支持第三方开源软件VLC进行在线点播。
使用VLC硬解ittb_stream¶
VLC是一款开源的播放软件，通过https://www.videolan.org 网站可以下载到Windows版本的vlc安装程序，以版本2.2.6为例，双击安装程序，根据提示进行安装。
安装完成之后，使用VLC进行大分辨率大码率的码流点播步骤如下：
打开VLC，在工具->首选项，将硬件加速打开，以及网络默认缓存策略改为最低延迟，如图1所示，点击“保存”按钮并重启VLC。
图 1 VLC参数设置
在板端正常启动ittb_stream业务。
VLC中点Ctrl+N，输入如下URL：rtsp://10.67.20.64:554/0，其中10.67.20.64为单板IP地址，0表示VENC通道号（当前已初始化且有码流的VENC通道），如图2所示。
图 2 VLC设置播放数据源
勾选“显示更多选项”，把“正在缓冲”改成100ms，点击播放，如图3所示。
图 3 设置播放参数
须知：
因为默认跑SmartP，刚开始缺少I帧画面会发绿，且长时间刷不回来，过1~2分钟后图像就正常了。
FAQ¶
为什么工具连接单板会提示版本不匹配？¶
【现象】
正确启动单板对应的图像调节工具且图像调节工具能够正确打开，打开xml文件之后连接单板，工具提示版本不匹配。
【分析】
图像调节工具板端版本与xml版本不匹配。
【解决】
察看当前使用的SDK 版本，更新xml至当前SDK版本对应图像调节工具版本。
PQTools工具文本文件导入导出异常如何处理¶
【现象】
PQTools工具部分支持导入导出文本文件的功能界面，如矩阵式寄存器对话框、PreGamma调试界面、Gamma调试界面、LMF转换工具等。
现象一：将记事本中能打开且格式正常的文本文件导入PC端工具时，出现“格式不正确”的提示或者乱码；
现象二：从工具导出的文本文件使用记事本打开，显示乱码。
【分析】
PQTools工具目前仅支持ANSI编码的文本文件，如果导入其他编码格式的文件则无法识别。
【解决】
现象一：导入PQTools工具文本文件前，使用记事本或Notepad++等文本编辑器将原始文件以ANSI编码重新保存。
现象二：使用记事本打开PQTools工具导出的文本文件时需要选择文件的编码格式为ANSI类型。
如何处理低照度场景编码I帧过大无法点播¶
【现象】
灌入低照度场景抓取的RAW后点播画面黑屏，再次连接提示成功但画面仍然黑屏。
【分析】
低照度场景的RAW经过编码后的I帧远大于正常场景，网传buffer和PC端接收码流的buffer受限，不能传输和存储该I帧。
【解决】
用户可在板端配置文件config_mt.ini通过修改bufcoef配置网传buffer的大小；在PC端点播画面右键选择StreamType为Data First，可保证PC端接收码流的buffer足够存储该I帧。
如何读取到RC属性或者GopMode属性¶
【现象】
在PQTools工具调试界面中，读取RC属性或者GopMode属性都失败。
【分析】
读取RC属性或者GopMode属性时，只能读取对应模式下的属性。如果模式错误，则会读取失败。
【解决】
查看当前RC或者GopMode处于什么模式，读取对应模式下的属性。如果需要读取其他模式下的属性，需要设置RC或者GopMode到对应的模式，并同时对该模式属性进行写操作。
如何解决因内存不够导致的抓/灌RAW/YUV等操作失败¶
【现象】
在control界面上，执行抓多帧RAW/YUV、会出现因vb块数不够而导致失败。
【分析】
板端缓存RAW和YUV数据，是从媒体业务创建的vb pool中获取上来的，当vb块数不够时，抓RAW或YUV的MPI接口就会失败返回，导致抓RAW/YUV失败。
【解决】
当抓RAW/YUV时，剩余的可用vb块数要大于所抓的帧数。
在使用CLUT标定时，出现文件路径解析错误¶
【现象】
工具的存放路径包含中文时，使用CLUT标定，工具报路径解析错误。如图1所示。
图 1 错误告警信息
【分析】
CLUT工具标定时，会在PQTools工具目录下自动生成临时文件。如果PQTools工具目录在中文目录下，会因为CLUT标定算法库不支持中文路径，无法解析到生成的临时文件而报错。
【解决】
将PQTools工具放在英文路径下运行。
使用非SDK提供的 3A库，如何配置XML可调项¶
【现象】
媒体业务启用的是非SDK提供的3A库，无法使用PQTools工具进行3A参数的调试。
【分析】
PQTools工具提供的XML可调项均为SDK接口，非SDK提供的3A无法与SDK接口一一对应。
【解决】
可在XML中自行添加自定义寄存器调试非SDK提供的 3A参数，参考"物理/虚拟寄存器的添加与调试"。
用户的媒体业务起来后，PQTools工具界面不能调节AE、AWB等参数¶
【现象】
媒体业务起来后，使用PQTools工具进行AE、AWB等参数的调试失败。
【分析】
可能的两个原因：
媒体业务IspRun没有运行起来；
媒体业务加载非SDK提供的3A库；
【解决】
在板端命令查看业务线程，是否存在IspRun线程。
在XML中自行添加自定义寄存器调试非SDK提供的3A参数，参考"物理/虚拟寄存器的添加与调试"。
PQTools工具4K分辨率下部分界面显示异常¶
【现象】
Win7系统下，PQTools工具运行后，打开“PQ RAW YUV Analyzer”界面显示异常，如图：
【分析】
高DPI显示设置（125%、150%，甚至更高）下发生显示异常问题；
原因：Win7系统增加了高DPI适配功能，默认支持自动进行高DPI适配，使得界面窗口和控件可以自动放大显示。DPI适配不兼容代码设置的控件位置和大小。
【解决】
方案一：修改显示器屏幕文本缩放比例，比如：100%。注销后生效；
方案二：修改DPI配置：找到“自定义DPI设置”->“使用Windows XP风格DPI缩放比例”，修改显示状态，点击确定->点击应用。注销后生效。
PQTools工具灌RAW之后，图像显示异常¶
【现象】
SS928V100、使用PQ RAW Utilities工具将RAW文件倒灌到板端，图像显示异常，如图1所示。
图 1 使用RAW Utilities工具后图像异常示意图
【分析】
灌RAW到FE需要开启自产生时序。
【解决】
灌RAW之前将PQTools主界面的TimingAttr的Enable勾选上。注意：勾选之后不灌RAW，图像异常。
FPN标定无法存raw文件¶
【现象】
FPN标定和校正功能，但是FPN标定时无法存Raw文件，并且芯片支持文件系统。
【分析】
为了适配无文件系统的芯片，FPN标定结果默认写到内存中。
【解决】
FPN标定支持写内存和写Raw文件两种方案，当需要存Raw文件时，可以修改config.cfg文件中[FPNSaveRaw]节点下的enable值：
enable=0时，表示将FPN标定结果写入内存中；
enable=1时，表示存Raw文件。
8k分辨率ISP工具导入RAW个数受限¶
【现象】
ISP标定工具，进行AWB标定时导入8k分辨率的RAW数据最多导入13张，继续导入时弹框提示“File to import RAW file‘xxx.raw’:Memory allocation failed.”。
【分析】
所有32位应用程序都有4G的进程地址空间，操作系统保留部分空间（1G，操作系统的内核模式地址空间限定），应用程序拥有的用户模式虚拟地址空间（3G）。
PQTools工具为32位应用程序，ISP标定工具导入RAW数据时内存申请：RAW内存和RGB内存（RAW转成RGB显示）。如：7680x4320分辨率，需要的连续内存为190M：64M(RAW)+126M(RGB)。
【解决】
根据场景导入合适张数的RAW文件。
AWB标定只和光学器件（镜头、Sensor）相关，使用相同光学套件，采集小分辨率的图像进行数据标定。
关闭板端业务命令¶
LiteOS系统端pq_control业务命令选项添加“stop”字段可关闭 LiteOS系统下的control业务。
举例：pq_control stop
Linux系统端PQTools.sh业务启动脚本命令选项添加“-as”字段可关闭Linux系统下的板端PQTools业务。
举例：PQTools.sh –as
PQTools DIS标定工具convert或apply失败的解决方法¶
DIS标定工具需要先calibration，再Convert Calibration Data，然后才可以Apply To Board。若未经过Convert Calibration Data会报错误，如图1所示。
图 1 若未经过Convert Calibration Data报错误图
在Convert Calibration Data这一步，可能出现类似上面的报错，这时可能是标定参数超出范围，参考镜头标定算法内参，标定出的算法参数超出范围有2种解决方法：
重新添加标定图片，重点添加：棋盘格在画面居中、且占用画面比例较大的图片（需要靠近些镜头）若干张；
减少畸变系数DistCoeffType的个数，默认为3，进行递减，直到输出参数在芯片支持的范围内，这时不需要减少图片。
其中第一种方法同时对标定效果有些改进，为首选方法。但第二种方法更快捷。
关于隐私保护PQTools工具使用及限制说明¶
PQStream工具由于缺少相应的解码库，暂时不支持点播隐私保护的码流；
隐私保护的码流被点播时会导致pc端点播工具卡住，以及板端网络层异常，需要重启板端业务方可继续使用正常点播业务。
板端支持业务起来时自动录制隐私保护的码流，在配置对应的隐私保护媒体之后，打开板端码流录制功能，可保存隐私保护的码流。
关于Stitch Preview拼接仿真限制说明¶
Stitch Preview拼接仿真功能对内存消耗较大。分辨率过大时就会造成当前32位工具内存不足。（32位工具最大可用内存是2G，超过时会提示内存不足如图1所示）。如果使用出现内存不足的情况，请适当调小分辨率。
图 1 拼接仿真内存不足报错
关于使用工具抓JPEG图像异常¶
如果VENC前端绑定模块输出的YUV格式为Tile，会导致VENC 通道抓出的图像如下所示。需要将前端chn 属性中video_format修改为 OT_VIDEO_FORMAT_LINEAR。
此问题涉及到工具模块：PQ Stitching Tool中Stitch Auto Fine Tuning；Capture Tool中JPEG Image；PQ 3A Analyser；
